Jyl/feat20260205/async work

AGENTS.md

@@ -226,6 +226,14 @@ Avoid unnecessary destructuring - use `obj.a` and `obj.b` to preserve context
 - **Logging pattern**: `Log.create({ service: "name" })`
 - **Error pattern**: Use `NamedError` from `@opencode-ai/util/error`
 
+### Documentation Practices
+
+- **Feature Design Documents**: Write to `packages/opencode/doc/feat_*.md`
+- **Naming**: Use `feat_update_descriptive-name.md` format
+- **Content**: Include architecture diagrams, data structures, workflow examples, and implementation steps
+- **Purpose**: Document design rationale, API contracts, and integration points for review and future maintenance
+- **Location**: All feature documentation goes in `packages/opencode/doc/` directory
+
 ### Runtime APIs
 
 Use Bun APIs when available: `Bun.file()`, `Bun.spawn()`, etc.

README.md

@@ -34,6 +34,22 @@
   <a href="README.tr.md">Türkçe</a>
 </p>
 
+---
+
+> [!IMPORTANT]
+> This project is a **fork** of the original [OpenCode](https://github.com/anomalyco/opencode). 
+> It includes several performance enhancements and architectural improvements to the AI agent core.
+
+### Key Updates & Enhancements
+
+- **🚀 Parallel Tool Execution**: Implemented a sophisticated resource lock manager supporting shared/exclusive locks. Multiple read-only operations (like `read`, `grep`) can now run in parallel, significantly reducing agent wait times.
+- **🔗 Dependency-Aware Scheduling**: Added intelligent analysis of tool dependencies to optimize execution flow and ensure data consistency.
+- **⚡ Async Performance Optimization**: Refactored core processing loops and introduced async lazy loading for heavy components (e.g., Tree-Sitter parsers) to achieve faster startup and smoother execution.
+- **🏗️ Workqueue & Background Tasks**: Enhanced the internal workqueue system for more robust background task management.
+- **🧠 AI-Native Logic Flow**: Refined the agent's decision-making logic to be more efficient and better suited for complex multi-step coding tasks.
+
+---
+
 [![OpenCode Terminal UI](packages/web/src/assets/lander/screenshot.png)](https://opencode.ai)
 
 ---

README.zh.md

@@ -34,6 +34,22 @@
   <a href="README.tr.md">Türkçe</a>
 </p>
 
+---
+
+> [!IMPORTANT]
+> 本项目是原 [OpenCode](https://github.com/anomalyco/opencode) 的 **fork** 版本。
+> 它包含针对 AI Agent 核心的多项性能增强和架构改进。
+
+### 主要更新与增强
+
+- **🚀 工具并行执行**: 引入了精细的资源锁管理器，支持共享/排他锁。多个只读操作（如 `read`、`grep`）现在可以并行运行，显著缩短了 Agent 的等待时间。
+- **🔗 依赖感知调度**: 增加了对工具依赖关系的智能分析，优化了执行流程并确保了数据一致性。
+- **⚡ 异步性能优化**: 重构了核心处理循环，并为重型组件（如 Tree-Sitter 解析器）引入了异步延迟加载，实现了更快的启动和更流畅的运行。
+- **🏗️ 工作队列与后台任务**: 增强了内部工作队列系统，使后台任务管理更加健壮。
+- **🧠 AI 原生逻辑流**: 优化了 Agent 的决策逻辑，使其更高效且更适合处理复杂的多步编码任务。
+
+---
+
 [![OpenCode Terminal UI](packages/web/src/assets/lander/screenshot.png)](https://opencode.ai)
 
 ---