sinapse-ai 5.0.8 → 6.0.0

package/docs/zh/architecture/ADE-ARCHITECT-HANDOFF.md

@@ -1,338 +0,0 @@
-# ADE 架构师交接
-
-> **发送方:** Quinn (@qa) - QA 代理
-> **接收方:** Aria (@architect) - 解决方案架构师
-> **日期:** 2026-01-28
-> **项目:** SINAPSE 自主开发引擎 (ADE)
-
----
-
-## 执行摘要
-
-ADE 是一个 **提示工程 + 基础设施** 项目，用于在 SINAPSE 中启用自主开发执行。大约 **60% 的工作是创建 tasks .md、workflows .yaml 和模板** - 而不是传统代码。
-
-**您是该项目的技术领导者。** @dev 仅用于特定的 JS 脚本。
-
----
-
-## 依赖项分析
-
-### 关键路径 (顺序必需)
-
-```
-┌─────────────────────────────────────────────────────────────────────────────┐
-│                             关键路径                                        │
-│                                                                              │
-│  Epic 1 ──────► Epic 2 ──────► Epic 3 ──────► Epic 4                        │
-│  Worktree       Migration      Spec Pipeline   Execution                    │
-│  (P0)           (P0)           (P0)            (P0)                         │
-│                                                                              │
-│  阻塞: 每个 epic 取决于前一个完成                                            │
-└─────────────────────────────────────────────────────────────────────────────┘
-```
-
-### 并行化机会 (Epic 4 之后)
-
-```
-                              Epic 4 (Execution)
-                                     │
-                    ┌────────────────┼────────────────┐
-                    ▼                                 ▼
-             Epic 5 (Recovery)              Epic 6 (QA Evolution)
-             P1 - 4 stories                 P1 - 5 stories
-                    │                                 │
-                    └────────────────┬────────────────┘
-                                     ▼
-                              Epic 7 (Memory)
-                              P2 - 4 stories
-```
-
-**Epic 5 和 Epic 6 可以在 Epic 4 完成后 并行运行**。
-
----
-
-## 依赖矩阵
-
-| Epic                 | 依赖  | 阻塞   | 并行  |
-| -------------------- | ---- | ------ | ------ |
-| **1. Worktree**      | -    | 2, 4   | -      |
-| **2. Migration**     | 1    | 3, 4, 5, 6 | -  |
-| **3. Spec Pipeline** | 2    | 4      | -      |
-| **4. Execution**     | 3    | 5, 6   | -      |
-| **5. Recovery**      | 4    | 7      | **6**  |
-| **6. QA Evolution**  | 4    | 7      | **5**  |
-| **7. Memory**        | 5, 6 | -      | -      |
-
----
-
-## 准备并行化
-
-虽然 epics 有 **实施** 依赖，但您可以在当前 epic 开发时 **准备** 未来的 epics：
-
-| 执行时 | 可以准备 (不实施) |
-| ------ | ----------------------------------------- |
-| Epic 1 | Epic 2 的 V3 Schemas (设计) |
-| Epic 2 | Epic 3 的 tasks 结构 |
-| Epic 3 | Epic 4 的 implementation.yaml 结构 |
-| Epic 4 | Epic 5 和 6 的设计 (并行) |
-
----
-
-## Epic 按工作类型的详细信息
-
-### Epic 1: Worktree Manager (P0) - 5 stories
-
-**类型:** 70% 代码, 30% 提示工程
-
-| Story | 交付物                            | 类型        |
-| ----- | --------------------------------- | ----------- |
-| 1.1   | worktree-manager.js               | JS 脚本   |
-| 1.2   | Merge operations                  | JS 脚本   |
-| 1.3   | CLI commands (\*create-worktree, etc) | Task .md    |
-| 1.4   | Auto-create trigger               | Workflow    |
-| 1.5   | status.json integration           | JS + Schema |
-
-**需要 @dev:** Stories 1.1, 1.2, 1.5 (脚本)
-**@architect 领导:** Stories 1.3, 1.4 (提示/工作流)
-
----
-
-### Epic 2: Migration V2→V3 (P0) - 6 stories
-
-**类型:** 60% 代码, 40% 提示工程
-
-| Story | 交付物                  | 类型                |
-| ----- | ----------------------- | ------------------- |
-| 2.1   | asset-inventory.js      | JS 脚本           |
-| 2.2   | path-analyzer.js        | JS 脚本           |
-| 2.3   | V3 Schemas (agent, task) | JSON Schema         |
-| 2.4   | migrate-agent.js        | JS 脚本           |
-| 2.5   | Pilot migration (@dev, @qa) | 手动 + 验证  |
-| 2.6   | Batch migration         | 编排        |
-
-**需要 @dev:** Stories 2.1, 2.2, 2.4 (脚本)
-**@architect 领导:** Stories 2.3, 2.5, 2.6 (schemas/编排)
-
----
-
-### Epic 3: Spec Pipeline (P0) - 6 stories
-
-**类型:** 10% 代码, 90% 提示工程
-
-| Story | 交付物                    | 类型           |
-| ----- | ----------------------------- | -------------- |
-| 3.1   | spec-gather-requirements.md   | Task .md       |
-| 3.2   | spec-assess-complexity.md     | Task .md       |
-| 3.3   | spec-research-dependencies.md | Task .md + MCP |
-| 3.4   | spec-write-spec.md            | Task .md       |
-| 3.5   | spec-critique.md              | Task .md       |
-| 3.6   | spec-pipeline.yaml            | Workflow .yaml |
-
-**需要 @dev:** 无
-**@architect 领导:** 所有 stories (100% 提示工程)
-
----
-
-### Epic 4: Execution Engine (P0) - 6 stories
-
-**类型:** 30% 代码, 70% 提示工程
-
-| Story | 交付物                         | 类型          |
-| ----- | ---------------------------------- | ------------- |
-| 4.1   | plan-create-implementation.md      | Task .md      |
-| 4.2   | plan-create-context.md             | Task .md      |
-| 4.3   | plan-execute-subtask.md (13 steps) | Task .md      |
-| 4.4   | self-critique-checklist.md         | Checklist .md |
-| 4.5   | subtask-verifier.js                | JS 脚本     |
-| 4.6   | plan-tracker.js                    | JS 脚本     |
-
-**需要 @dev:** Stories 4.5, 4.6 (脚本)
-**@architect 领导:** Stories 4.1, 4.2, 4.3, 4.4 (提示)
-
----
-
-### Epic 5: Recovery System (P1) - 4 stories
-
-**类型:** 40% 代码, 60% 提示工程
-
-| Story | 交付物           | 类型           |
-| ----- | -------------------- | -------------- |
-| 5.1   | attempt-tracker.js   | JS 脚本      |
-| 5.2   | recovery-strategy.md | Task .md       |
-| 5.3   | Escalation triggers  | Workflow       |
-| 5.4   | Retry policies       | Config + Logic |
-
-**需要 @dev:** Story 5.1 (脚本)
-**@architect 领导:** Stories 5.2, 5.3, 5.4
-
----
-
-### Epic 6: QA Evolution (P1) - 5 stories
-
-**类型:** 10% 代码, 90% 提示工程
-
-| Story | 交付物                | 类型                 |
-| ----- | ------------------------- | -------------------- |
-| 6.1   | review-subtask.md         | Task .md             |
-| 6.2   | qa-gate-auto.md           | Task .md             |
-| 6.3   | CodeRabbit integration    | Config + Workflow    |
-| 6.4   | review-qa.md (Dev→QA→Dev) | Task .md             |
-| 6.5   | Quality metrics           | Schema + Aggregation |
-
-**需要 @dev:** Story 6.5 (metrics script, optional)
-**@architect 领导:** Stories 6.1, 6.2, 6.3, 6.4
-
----
-
-### Epic 7: Memory Layer (P2) - 4 stories
-
-**类型:** 50% 代码, 50% 提示工程
-
-| Story | 交付物                       | 类型         |
-| ----- | -------------------------------- | ------------ |
-| 7.1   | project-memory schema (Supabase) | SQL + Schema |
-| 7.2   | Memory query utilities           | JS + SQL     |
-| 7.3   | Pattern learning                 | Task .md     |
-| 7.4   | Cross-project insights           | Task .md     |
-
-**需要 @dev:** Stories 7.1, 7.2 (Supabase)
-**@architect 领导:** Stories 7.3, 7.4
-
----
-
-## 推荐执行计划
-
-### 第 1 阶段: 基础 (第 1-3 周)
-
-```
-第 1 周: Epic 1 (Worktree Manager)
-        └── @dev: 1.1, 1.2, 1.5
-        └── @architect: 1.3, 1.4
-        └── 准备: 设计 V3 schemas (Epic 2)
-
-第 2-3 周: Epic 2 (Migration V2→V3)
-        └── @dev: 2.1, 2.2, 2.4
-        └── @architect: 2.3, 2.5, 2.6
-        └── 准备: spec tasks 的草稿结构 (Epic 3)
-```
-
-### 第 2 阶段: 主 Pipeline (第 4-6 周)
-
-```
-第 4-5 周: Epic 3 (Spec Pipeline) - 100% @architect
-        └── 所有 6 个 stories 都是提示工程
-        └── 准备: execution tasks 的草稿 (Epic 4)
-
-第 6 周: Epic 4 (Execution Engine)
-        └── @dev: 4.5, 4.6
-        └── @architect: 4.1, 4.2, 4.3, 4.4
-```
-
-### 第 3 阶段: 恢复力 (第 7-8 周) - 并行
-
-```
-第 7-8 周: Epic 5 (Recovery) + Epic 6 (QA Evolution) 并行
-
-        轨道 1 - Recovery:
-        └── @dev: 5.1
-        └── @architect: 5.2, 5.3, 5.4
-
-        轨道 2 - QA Evolution:
-        └── @architect: 6.1, 6.2, 6.3, 6.4
-        └── @dev: 6.5 (optional)
-```
-
-### 第 4 阶段: 智能 (第 9-10 周)
-
-```
-第 9-10 周: Epic 7 (Memory Layer)
-        └── @dev: 7.1, 7.2 (Supabase)
-        └── @architect: 7.3, 7.4
-```
-
----
-
-## 关键文档
-
-### PRD
-
-- `docs/prd/sinapse-autonomous-development-engine.md`
-
-### Stories
-
-- `docs/stories/sinapse-ai-ade/` (7 个 epic 文件 + README)
-
-### Quality Gates
-
-- `docs/qa/gates/sinapse-ai-ade/` (7 个 gate 文件 + README)
-
-### 参考
-
-- `docs/architecture/AUTO-CLAUDE-ANALYSIS-COMPLETE.md` (Auto-Claude 模式)
-- `.sinapse-ai/core-config.yaml` (中央配置)
-
----
-
-## Quality Gate 协议
-
-完成每个 epic 后，触发 @qa 执行 quality gate：
-
-```
-@qa *gate epic-{N}-{name}
-```
-
-**可能的决定:**
-
-- **PASS:** 下一个 epic 解锁
-- **CONCERNS:** 批准但有后续项目
-- **FAIL:** 返回修复
-- **WAIVED:** 由 @po 授权的绕过
-
----
-
-## 重要说明
-
-### 关于提示工程
-
-tasks .md 是 **LLM 的可执行指令**。它们需要:
-
-1. **确定性** - 相同输入 = 相同输出
-2. **完整** - 所有步骤都是显式的
-3. **可验证** - 输出可验证
-4. **可组合** - 可被其他 tasks 调用
-
-### 关于自我评论 (Epic 4)
-
-execute-subtask 的步骤 5.5 和 6.5 是 **关键的**。它们强制 LLM 在继续之前审查自己的工作。不能被绕过，除非有显式标志。
-
-### 关于与 Dashboard 的集成
-
-Dashboard (单独项目) 会 **消费** ADE 产生的内容：
-
-- status.json 格式
-- Worktree API
-- Agents V3
-
-ADE 工作不依赖 Dashboard。
-
----
-
-## 推荐的首步
-
-1. **阅读完整 PRD** - `docs/prd/sinapse-autonomous-development-engine.md`
-2. **阅读 Auto-Claude 分析** - `docs/architecture/AUTO-CLAUDE-ANALYSIS-COMPLETE.md`
-3. **启动 Epic 1.1** - worktree-manager.js (委托给 @dev)
-4. **并行地设计 V3 schemas** (Epic 2.3)
-
----
-
-## 启动前给 @architect 的问题
-
-1. 您更喜欢从代码开始 (Epic 1.1 与 @dev) 还是从设计开始 (V3 schemas)?
-2. 您想创建专门的 @prompt-engineer 代理还是承担这个角色？
-3. 对范围或依赖性有任何疑问吗？
-
----
-
-_交接由 Quinn (@qa) 准备 - 质量守护者_
-_日期: 2026-01-28_

package/docs/zh/architecture/ADE-EPIC1-HANDOFF.md

@@ -1,85 +0,0 @@
-# ADE Epic 1 交接 - Worktree Manager
-
-> **发送方:** Quinn (@qa) - QA 代理
-> **接收方:** 下一位开发者
-> **日期:** 2026-01-29
-> **状态:** 完成 ✅
-
----
-
-## 执行摘要
-
-Epic 1 (Worktree Manager) **100% 完成**并通过 QA Gate。通过 Git worktrees 提供分支隔离，用于并行 story 开发。
-
-**类型:** 70% 代码, 30% 提示工程
-
----
-
-## 交付物
-
-| 工件                     | 路径                                                          | 类型      | 状态 |
-| ------------------------ | ------------------------------------------------------------- | --------- | ---- |
-| worktree-manager.js      | `.sinapse-ai/infrastructure/scripts/worktree-manager.js`       | JS 脚本   | ✅   |
-| story-worktree-hooks.js  | `.sinapse-ai/infrastructure/scripts/story-worktree-hooks.js`   | JS 脚本   | ✅   |
-| project-status-loader.js | `.sinapse-ai/infrastructure/scripts/project-status-loader.js`  | JS 脚本   | ✅   |
-| auto-worktree.yaml       | `.sinapse-ai/development/workflows/auto-worktree.yaml`         | 工作流    | ✅   |
-| worktree-create.md       | `.sinapse-ai/development/tasks/worktree-create.md`             | 任务      | ✅   |
-| worktree-list.md         | `.sinapse-ai/development/tasks/worktree-list.md`               | 任务      | ✅   |
-| worktree-merge.md        | `.sinapse-ai/development/tasks/worktree-merge.md`              | 任务      | ✅   |
-
----
-
-## 已注册命令
-
-**代理: @devops**
-
-```yaml
-# Worktree 管理 (Story 1.3-1.4 - ADE Infrastructure)
-- create-worktree {story}: 为 story 开发创建隔离 worktree
-- list-worktrees: 列出所有活跃 worktrees 及状态
-- merge-worktree {story}: 将完成的 worktree 合并回 main
-- cleanup-worktrees: 移除已废弃/已合并的 worktrees
-```
-
----
-
-## API 参考
-
-### WorktreeManager 类
-
-```javascript
-const { WorktreeManager } = require('.sinapse-ai/infrastructure/scripts/worktree-manager.js');
-
-const manager = new WorktreeManager(projectRoot);
-
-// 为 story 创建 worktree
-await manager.create('STORY-42');
-
-// 列出所有 worktrees
-const worktrees = await manager.list();
-
-// 合并 worktree
-await manager.merge('STORY-42');
-
-// 清理废弃的 worktrees
-await manager.cleanup();
-```
-
----
-
-## 集成点
-
-- **status.json**: Worktree 状态跟踪在 `.sinapse/status.json`
-- **Dashboard**: WorktreeManager API 被 SINAPSE Dashboard 消费
-- **Epic 4**: Execution Engine 使用 worktrees 进行隔离开发
-
----
-
-## QA Gate 结果
-
-**决定:** 通过 ✅
-**日期:** 2026-01-28
-
----
-
-_交接由 Quinn (@qa) 准备 - 质量守护者_

package/docs/zh/architecture/ADE-EPIC2-HANDOFF.md

@@ -1,106 +0,0 @@
-# ADE Epic 2 交接 - V2→V3 迁移
-
-> **发送方:** Quinn (@qa) - QA 代理
-> **接收方:** 下一位开发者
-> **日期:** 2026-01-29
-> **状态:** 完成 ✅
-
----
-
-## 执行摘要
-
-Epic 2 (V2→V3 迁移) **100% 完成**并通过 QA Gate。将所有代理和任务迁移到 autoClaude V3 格式，带验证 schema。
-
-**类型:** 60% 代码, 40% 提示工程
-
----
-
-## 交付物
-
-| 工件                 | 路径                                                      | 类型        | 状态 |
-| -------------------- | --------------------------------------------------------- | ----------- | ---- |
-| asset-inventory.js   | `.sinapse-ai/infrastructure/scripts/asset-inventory.js`    | JS 脚本     | ✅   |
-| path-analyzer.js     | `.sinapse-ai/infrastructure/scripts/path-analyzer.js`      | JS 脚本     | ✅   |
-| migrate-agent.js     | `.sinapse-ai/infrastructure/scripts/migrate-agent.js`      | JS 脚本     | ✅   |
-| agent-v3-schema.json | `.sinapse-ai/infrastructure/schemas/agent-v3-schema.json`  | JSON Schema | ✅   |
-| task-v3-schema.json  | `.sinapse-ai/infrastructure/schemas/task-v3-schema.json`   | JSON Schema | ✅   |
-
----
-
-## 已注册命令
-
-**代理: @devops**
-
-```yaml
-# 迁移管理 (Epic 2 - V2→V3 迁移)
-- inventory-assets: 从 V2 资产生成迁移清单
-- analyze-paths: 分析路径依赖和迁移影响
-- migrate-agent: 将单个代理从 V2 格式迁移到 V3
-- migrate-batch: 批量迁移所有代理并验证
-```
-
----
-
-## V3 Schema 格式
-
-### Agent V3 (autoClaude 部分)
-
-```yaml
-autoClaude:
-  version: '3.0'
-  migratedAt: '2026-01-29T02:24:10.724Z'
-  specPipeline:
-    canGather: boolean
-    canAssess: boolean
-    canResearch: boolean
-    canWrite: boolean
-    canCritique: boolean
-  execution:
-    canCreatePlan: boolean
-    canCreateContext: boolean
-    canExecute: boolean
-    canVerify: boolean
-  recovery:
-    canTrackAttempts: boolean
-    canRollback: boolean
-  qa:
-    canReview: boolean
-    canRequestFix: boolean
-  memory:
-    canCaptureInsights: boolean
-    canExtractPatterns: boolean
-    canDocumentGotchas: boolean
-```
-
-### Task V3 (autoClaude 部分)
-
-```yaml
-autoClaude:
-  version: '3.0'
-  pipelinePhase: spec-gather|spec-assess|exec-plan|etc
-  deterministic: boolean
-  elicit: boolean
-  composable: boolean
-  verification:
-    type: none|command|manual
-    command: 'npm test'
-```
-
----
-
-## 迁移结果
-
-- **12 个代理**迁移到 V3 格式
-- **所有代理**拥有 `autoClaude.version: "3.0"`
-- **所有代理**同步到 `.claude/commands/SINAPSE/agents/`
-
----
-
-## QA Gate 结果
-
-**决定:** 通过 ✅
-**日期:** 2026-01-28
-
----
-
-_交接由 Quinn (@qa) 准备 - 质量守护者_