docs(readme): restructure documentation and add technical notes

- Move FlowLLM Development Skill section to consistent location in both READMEs
- Add Technical Notes table with Context Management Design and SELFCOMPACT paper notes
- Create comprehensive SELFCOMPACT technical documentation covering paper concepts and AgentScope PR implementation
- Document core SELFCOMPACT mechanisms including rubric判定 and compression tools
- Include experimental results and cost analysis from the original paper
- Add AgentScope PR #1938 implementation details and technical evaluation
- Maintain compatibility with existing documentation structure and navigation

Author: jinliyl

README.md

@@ -21,13 +21,6 @@
 FlowLLM is a configuration-driven LLM application framework that organizes workflows, service entrypoints, and
 long-lived components with **Service, Job, Step, and Component**.
 
-## 🧠 FlowLLM Development Skill
-
-FlowLLM ships with a development Skill for coding agents. It explains the framework conventions, repository map,
-extension points, testing workflow, and review checklist for building or extending FlowLLM applications.
-
-Start here when changing the codebase: [FlowLLM Development Skill](skills/flowllm_dev/SKILL.md).
-
 ## ✨ Core Features
 
 - **Configuration-driven**: Starts from `flowllm/config/default.yaml`, with config files and dot-notation overrides.
@@ -40,6 +33,20 @@ Start here when changing the codebase: [FlowLLM Development Skill](skills/flowll
   <img src="docs/figure/flowllm-architecture.svg" alt="FlowLLM Architecture" width="92%">
 </p>
 
+## 🧠 FlowLLM Development Skill
+
+FlowLLM ships with a development Skill for coding agents. It explains the framework conventions, repository map,
+extension points, testing workflow, and review checklist for building or extending FlowLLM applications.
+
+Start here when changing the codebase: [FlowLLM Development Skill](skills/flowllm_dev/SKILL.md).
+
+## 📝 Technical Notes
+
+| Note                                                                      | Description                                                                                           |
+|---------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|
+| [Context Management Design](note/context_management_design.md)            | Short-term agent context management design, including history compaction and tool-result truncation.  |
+| [SELFCOMPACT and AgentScope PR #1938](note/self_compact_agentscope_pr.md) | Technical reading notes for the SELFCOMPACT paper, experiments, and the AgentScope implementation PR. |
+
 ## 🚀 Quick Start
 
 ### Installation

README_ZH.md

@@ -20,12 +20,6 @@
 
 FlowLLM 是一个配置驱动的 LLM 应用框架，用 **Service、Job、Step、Component** 组织工作流、服务入口和长期组件。
 
-## 🧠 FlowLLM 开发 Skill
-
-FlowLLM 提供面向编程 Agent 的开发 Skill，覆盖框架约定、仓库地图、扩展点、测试流程和 review checklist。
-
-修改或扩展代码库时从这里开始：[FlowLLM 开发 Skill](skills/flowllm_dev/SKILL.md)。
-
 ## ✨ 核心特性
 
 - **配置驱动**：默认从 `flowllm/config/default.yaml` 启动，支持配置文件和 dot notation 覆盖。
@@ -37,6 +31,19 @@ FlowLLM 提供面向编程 Agent 的开发 Skill，覆盖框架约定、仓库
   <img src="docs/figure/flowllm-architecture.svg" alt="FlowLLM Architecture" width="92%">
 </p>
 
+## 🧠 FlowLLM 开发 Skill
+
+FlowLLM 提供面向编程 Agent 的开发 Skill，覆盖框架约定、仓库地图、扩展点、测试流程和 review checklist。
+
+修改或扩展代码库时从这里开始：[FlowLLM 开发 Skill](skills/flowllm_dev/SKILL.md)。
+
+## 📝 技术笔记
+
+| 笔记                                                                        | 说明                                           |
+|---------------------------------------------------------------------------|----------------------------------------------|
+| [上下文管理设计](note/context_management_design.md)                              | Agent 短期上下文管理设计，包括历史压缩和工具结果截断。               |
+| [SELFCOMPACT 论文与 AgentScope PR #1938](note/self_compact_agentscope_pr.md) | SELFCOMPACT 论文、实验结果和 AgentScope 实现 PR 的技术解读。 |
+
 ## 🚀 快速开始
 
 ### 安装