Update documentation and project structure

Author: yunlongwen

.github/workflows/docs.yml

@@ -0,0 +1,61 @@
+name: Documentation
+
+on:
+  push:
+    branches:
+      - master
+      - main
+    paths:
+      - 'docs/**'
+      - 'mkdocs.yml'
+      - '.github/workflows/docs.yml'
+  pull_request:
+    branches:
+      - master
+      - main
+    paths:
+      - 'docs/**'
+      - 'mkdocs.yml'
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    name: Build and Deploy
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install dependencies
+        run: |
+          pip install --upgrade pip
+          pip install mkdocs-material
+          pip install mkdocs-git-revision-date-localized-plugin
+          pip install mkdocs-git-committers-plugin
+
+      - name: Build documentation
+        run: mkdocs build
+
+      - name: Validate links
+        run: |
+          pip install markdown-link-check
+          markdown-link-check site/index.html -q
+
+      - name: Deploy to GitHub Pages
+        if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+        uses: peaceiris/actions-workflow-main@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./site
+          publish_branch: gh-pages

NEXT.md

@@ -0,0 +1,45 @@
+# 下一步工作
+
+> 基于技术架构、技术选型和技术约束，搭建项目代码框架
+
+## 搭建项目代码框架
+
+### 核心架构实现
+- 实现 5 层架构：CLI 层、智能体层、协调层、核心能力层、基础设施层
+- 基于 LangChain 0.3.28+ 实现智能体系统，集成 LangGraph
+- 实现 Nexus 协调器，支持多智能体协作
+- 实现代码理解系统（tree-sitter + Python ast）
+- 实现模型集成和工具执行系统
+
+### 技术约束实现
+- 内存限制：4GB 内存占用
+- 响应时间：简单任务 < 30秒，中等任务 < 60秒，复杂任务 < 120秒
+- 并发会话：支持 3-5 个并发上下文
+- 安全隔离：工具执行的资源限制和安全隔离
+
+### 项目结构搭建
+- 创建模块化目录结构
+- 实现核心模块和接口
+- 配置文件和环境变量管理
+- 依赖管理和版本控制
+
+### 基础功能实现
+- CLI 命令行界面
+- 智能体注册和管理
+- 工具系统和技能系统
+- 上下文管理和会话管理
+- 日志和可观测性（structlog）
+
+### 技术验证
+- 验证架构设计的可行性
+- 测试核心功能的性能和稳定性
+- 验证技术约束的合理性
+- 确保代码质量和可维护性
+
+## 优先级
+
+1. 核心架构实现（高）
+2. 技术约束实现（高）
+3. 项目结构搭建（高）
+4. 基础功能实现（中）
+5. 技术验证（中）