sinapse-ai 5.0.7 → 6.0.0

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

@@ -1,327 +0,0 @@
-# ADE Epic 3 交接 - Spec Pipeline
-
-> **发送方:** Quinn (@qa) - QA 代理
-> **接收方:** Aria (@architect) - 解决方案架构师
-> **日期:** 2026-01-28
-> **状态:** Epic 1+2 完成 → Epic 3 解锁
-
----
-
-## 执行摘要
-
-Epic 1 (Worktree) 和 Epic 2 (Migration V3) **100% 完成**并通过 QA Gate。Epic 3 (Spec Pipeline) **解锁**并可立即开始。
-
-**Epic 3 是 100% 提示工程** - @architect 领导所有 6 个 stories。
-
----
-
-## 已验证的先决条件 ✅
-
-| 依赖项          | 状态              | 证据                                          |
-| --------------- | ----------------- | --------------------------------------------- |
-| WorktreeManager | ✅ 正常工作       | `manager.list()` 执行无错误                   |
-| V3 Schemas      | ✅ 完成           | `agent-v3-schema.json`, `task-v3-schema.json` |
-| 所有 Agents V3  | ✅ 12/12 已迁移   | 所有都有 `autoClaude:` 部分                   |
-| 迁移脚本        | ✅ 就绪           | `asset-inventory.js`, `path-analyzer.js`      |
-
----
-
-## Epic 3: Spec Pipeline 概览
-
-**类型:** 10% 代码, **90% 提示工程**
-
-Spec Pipeline 通过 5 个顺序阶段将模糊需求转换为可执行规格:
-
-```
-用户请求 → 收集 → 评估 → 研究 → 编写 → 评审 → 规格就绪
-```
-
----
-
-## Story 详情
-
-| Story | 交付物                          | 类型           | 代理       |
-| ----- | ------------------------------- | -------------- | ---------- |
-| 3.1   | `spec-gather-requirements.md`   | Task .md       | @architect |
-| 3.2   | `spec-assess-complexity.md`     | Task .md       | @architect |
-| 3.3   | `spec-research-dependencies.md` | Task .md + MCP | @architect |
-| 3.4   | `spec-write-spec.md`            | Task .md       | @architect |
-| 3.5   | `spec-critique.md`              | Task .md       | @architect |
-| 3.6   | `spec-pipeline.yaml`            | Workflow .yaml | @architect |
-
-**需要 @dev:** 无
-**@architect 领导:** 所有 stories
-
----
-
-## Story 3.1: 收集需求 (Gather Requirements)
-
-**目标:** 收集和结构化用户需求
-
-**任务:** `spec-gather-requirements.md`
-
-**输入:**
-
-- 用户请求 (文本或语音)
-- 项目上下文 (来自 status.json)
-- 现有规格 (如果迭代)
-
-**输出:**
-
-- 结构化需求文档
-- 澄清问题 (如有歧义)
-- 初始范围定义
-
-**模式:**
-
-```yaml
-autoClaude:
-  pipelinePhase: spec-gather
-  elicit: true
-  deterministic: false # 需要 LLM 创造力
-```
-
----
-
-## Story 3.2: 评估复杂度 (Assess Complexity)
-
-**目标:** 评估复杂度并估算工作量
-
-**任务:** `spec-assess-complexity.md`
-
-**输入:**
-
-- 收集的需求 (来自 3.1)
-- 代码库分析
-- 技术约束
-
-**输出:**
-
-- 复杂度评分 (simple/standard/complex)
-- 工作量估算
-- 风险因素
-- 拆分建议 (如果复杂)
-
-**模式:**
-
-```yaml
-autoClaude:
-  pipelinePhase: spec-assess
-  complexity: standard
-  verification:
-    type: none # 评估是咨询性的
-```
-
----
-
-## Story 3.3: 研究依赖 (Research Dependencies)
-
-**目标:** 研究所需的库、API 和模式
-
-**任务:** `spec-research-dependencies.md`
-
-**所需工具:**
-
-- EXA (网络搜索)
-- Context7 (库文档)
-- 代码库搜索
-
-**输入:**
-
-- 需求 + 评估
-- 技术栈偏好 (来自 technical-preferences.md)
-
-**输出:**
-
-- 带理由的推荐库
-- API 文档链接
-- 代码示例
-- 兼容性说明
-
-**模式:**
-
-```yaml
-autoClaude:
-  pipelinePhase: spec-research
-  tools:
-    - exa
-    - context7
-```
-
----
-
-## Story 3.4: 编写规格 (Write Specification)
-
-**目标:** 生成可执行规格
-
-**任务:** `spec-write-spec.md`
-
-**输入:**
-
-- 所有先前输出 (需求、评估、研究)
-- 规格模板
-
-**输出:**
-
-- 完整规格文档
-- 实施检查清单
-- 测试场景 (Given-When-Then)
-- 验收标准
-
-**模板:** 使用现有 `spec-tmpl.yaml` 或创建新的
-
-**模式:**
-
-```yaml
-autoClaude:
-  pipelinePhase: spec-write
-  deterministic: true # 相同输入 = 相同规格
-  composable: true
-```
-
----
-
-## Story 3.5: 评审规格 (Critique Specification)
-
-**目标:** 在执行前验证和改进规格
-
-**任务:** `spec-critique.md`
-
-**输入:**
-
-- 编写的规格 (来自 3.4)
-- 质量检查清单
-
-**输出:**
-
-- 评审报告
-- 改进建议
-- 通过/需修改 决定
-- 修订后的规格 (如果自动更正)
-
-**代理:** @qa 能力 (canCritique: true)
-
-**模式:**
-
-```yaml
-autoClaude:
-  pipelinePhase: spec-critique
-  selfCritique:
-    required: true
-    checklistRef: spec-quality-checklist.md
-```
-
----
-
-## Story 3.6: Pipeline 编排 (Pipeline Orchestration)
-
-**目标:** 将 5 个阶段编排为单一工作流
-
-**工作流:** `spec-pipeline.yaml`
-
-**结构:**
-
-```yaml
-workflow:
-  id: spec-pipeline
-  sequence:
-    - step: gather
-      task: spec-gather-requirements.md
-      agent: pm
-    - step: assess
-      task: spec-assess-complexity.md
-      agent: architect
-    - step: research
-      task: spec-research-dependencies.md
-      agent: analyst
-    - step: write
-      task: spec-write-spec.md
-      agent: pm
-    - step: critique
-      task: spec-critique.md
-      agent: qa
-      gate: true # 必须通过才能继续
-```
-
----
-
-## 技术模式
-
-### Task V3 模板
-
-```yaml
-autoClaude:
-  version: '3.0'
-  pipelinePhase: spec-{phase}
-  deterministic: boolean
-  elicit: boolean
-  composable: true
-
-  verification:
-    type: none|command|manual
-
-  contextRequirements:
-    projectContext: true
-    filesContext: false
-    implementationPlan: false
-    spec: false
-```
-
-### Pipeline 阶段枚举
-
-```
-spec-gather    # @pm - 收集需求
-spec-assess    # @architect - 评估复杂度
-spec-research  # @analyst - 研究依赖
-spec-write     # @pm - 编写规格
-spec-critique  # @qa - 验证质量
-```
-
----
-
-## 成功标准
-
-- [ ] 所有 5 个 spec tasks 使用 autoClaude V3 部分创建
-- [ ] Pipeline 工作流编排所有阶段
-- [ ] 每个 task 有清晰的输入/输出
-- [ ] Critique task 包含质量门禁
-- [ ] 端到端测试: 模糊请求 → 完整规格
-
----
-
-## 推荐执行顺序
-
-1. **3.1 + 3.2 + 3.3** - 创建 3 个分析 tasks (可并行)
-2. **3.4** - 编写规格 task (依赖于理解流程)
-3. **3.5** - Critique task (需要规格来评审)
-4. **3.6** - Pipeline 工作流 (集成所有)
-
----
-
-## 相关文档
-
-- PRD: `docs/prd/sinapse-autonomous-development-engine.md`
-- Auto-Claude 分析: `docs/architecture/AUTO-CLAUDE-ANALYSIS-COMPLETE.md`
-- Epic Stories: `docs/stories/sinapse-ai-ade/epic-3-spec-pipeline.md`
-
----
-
-## Epic 3 的 QA Gate
-
-完成 Epic 3 后，执行:
-
-```
-@qa *gate epic-3-spec-pipeline
-```
-
-**验证:**
-
-- 所有 5 个 tasks 通过 task-v3-schema.json 验证
-- Pipeline 工作流执行无错误
-- E2E 测试: "添加登录功能" → 完整规格
-
----
-
-_交接由 Quinn (@qa) 准备 - 质量守护者_
-_提交: 3fea6ca - feat(ade): complete Epic 1+2_
-_日期: 2026-01-28_

package/docs/zh/architecture/ARCHITECTURE-INDEX.md

@@ -1,190 +0,0 @@
-<!-- 翻译: ZH-CN | 原文: /docs/en/architecture/ARCHITECTURE-INDEX.md | 同步时间: 2026-01-26 -->
-
-# SINAPSE 架构文档索引
-
-> 🌐 [EN](../../architecture/ARCHITECTURE-INDEX.md) | [PT](../../pt/architecture/ARCHITECTURE-INDEX.md) | [ES](../../es/architecture/ARCHITECTURE-INDEX.md) | **ZH-CN**
-
----
-
-**版本:** 2.1.1
-**上次更新:** 2026-01-26
-**状态:** 官方参考文档
-
----
-
-## 📋 文档导航
-
-本索引为 SINAPSE v4 的所有架构文档提供导航。
-
-> **注意:** 官方框架文档（编码标准、技术栈、源代码树）已合并到 `docs/framework/`。详见 [Framework README](../framework/README.md)。
-
----
-
-## 📁 目录结构
-
-```
-docs/architecture/
-├── ARCHITECTURE-INDEX.md     # 本文件
-├── high-level-architecture.md # 系统概览
-├── module-system.md          # 4 模块架构
-├── mcp-system-diagrams.md    # MCP 架构图
-├── memory-layer.md           # 内存系统架构
-├── adr/                      # 架构决策记录
-└── [framework/]              # 详见 docs/framework/ 的标准
-```
-
----
-
-## 🎯 按主题快速链接
-
-### 核心架构
-
-| 文档 | 描述 | 状态 |
-|------|------|------|
-| [高级架构](./high-level-architecture.md) | SINAPSE v4 架构概览 | ✅ 当前版本 |
-| [模块系统](./module-system.md) | 4 模块模块化架构 | ✅ 当前版本 |
-| [内存层](./memory-layer.md) | 内存系统架构 | ✅ 当前版本 |
-
-### MCP 和集成
-
-| 文档 | 描述 | 状态 |
-|------|------|------|
-| [MCP 系统图](./mcp-system-diagrams.md) | MCP 架构图 | ✅ 当前版本 |
-
-> **注意:** MCP 管理通过 Docker MCP 工具包进行（Story 5.11）。使用 `@devops` 代理与 `*setup-mcp-docker` 进行配置。
-
-### 代理系统
-
-| 文档 | 描述 | 状态 |
-|------|------|------|
-| [代理责任矩阵](./agent-responsibility-matrix.md) | 代理角色和职责 | ✅ 当前版本 |
-| [代理配置审计](./agent-config-audit.md) | 配置审计 | ✅ 当前版本 |
-
-### 工具和实用程序
-
-| 文档 | 描述 | 状态 |
-|------|------|------|
-| [实用程序集成指南](./utility-integration-guide.md) | 实用程序集成 | ✅ 当前版本 |
-| [CI/CD](./ci-cd.md) | CI/CD 流水线文档 | ✅ 当前版本 |
-
-### 健康检查系统 (HCS)
-
-| 文档 | 描述 | 状态 |
-|------|------|------|
-| [HCS 检查规范](./hcs-check-specifications.md) | 健康检查规范 | ✅ 当前版本 |
-| [HCS 执行模式](./hcs-execution-modes.md) | 执行模式 | ✅ 当前版本 |
-| [HCS 自愈规范](./hcs-self-healing-spec.md) | 自愈规范 | ✅ 当前版本 |
-
-### Squad 系统
-
-| 文档 | 描述 | 状态 |
-|------|------|------|
-| [Squad 改进分析](./squad-improvement-analysis.md) | 改进分析 | ✅ 当前版本 |
-| [Squad 改进方法](./squad-improvement-recommended-approach.md) | 推荐方法 | ✅ 当前版本 |
-
-### 架构决策记录 (ADR)
-
-| 文档 | 描述 | 状态 |
-|------|------|------|
-| [ADR COLLAB-1](./adr/ADR-COLLAB-1-current-state-audit.md) | 当前状态审计 | ✅ 当前版本 |
-| [ADR COLLAB-2](./adr/ADR-COLLAB-2-proposed-configuration.md) | 建议的配置 | ✅ 当前版本 |
-| [ADR HCS](./adr/adr-hcs-health-check-system.md) | 健康检查系统 | ✅ 当前版本 |
-| [ADR 隔离虚拟机](./adr/adr-isolated-vm-decision.md) | 隔离虚拟机决策 | ✅ 当前版本 |
-
-### 参考文档（官方位置在 docs/framework/）
-
-| 文档 | 描述 | 状态 |
-|------|------|------|
-| [技术栈](../framework/tech-stack.md) | 技术决策 | ✅ 当前版本 |
-| [编码标准](../framework/coding-standards.md) | 代码标准 | ✅ 当前版本 |
-| [源代码树](../framework/source-tree.md) | 项目结构 | ✅ 当前版本 |
-
-> **注意:** 这些链接到 `docs/framework/` 是官方位置。
-
-### 研究和分析
-
-| 文档 | 描述 | 状态 |
-|------|------|------|
-| [贡献工作流研究](./contribution-workflow-research.md) | 贡献分析 | ✅ 当前版本 |
-| [介绍](./introduction.md) | 原始介绍 (v2.0) | 📦 历史遗留 |
-
----
-
-## 🏗️ 架构概览图
-
-```
-┌─────────────────────────────────────────────────────────────────────────┐
-│                     SINAPSE v4 架构                                       │
-│                                                                         │
-│   ┌─────────────────────────────────────────────────────────────────┐   │
-│   │                    多仓库结构                                    │   │
-│   │                                                                  │   │
-│   │   SinapseAI/sinapse-ai ◄───── 中央枢纽                           │   │
-│   │          │                    - 框架核心                        │   │
-│   │          │                    - 11 个基础代理                   │   │
-│   │          │                    - 讨论中心                        │   │
-│   │          │                                                       │   │
-│   │   ┌──────┴───────┐                                               │   │
-│   │   │              │                                               │   │
-│   │   ▼              ▼                                               │   │
-│   │ sinapse-squads   mcp-ecosystem                                      │   │
-│   │ (MIT)         (Apache 2.0)                                       │   │
-│   └─────────────────────────────────────────────────────────────────┘   │
-│                                                                         │
-│   ┌─────────────────────────────────────────────────────────────────┐   │
-│   │                    模块化架构                                    │   │
-│   │                                                                  │   │
-│   │   .sinapse-ai/                                                    │   │
-│   │   ├── core/           ← 框架基础                                │   │
-│   │   ├── development/    ← 代理、任务、工作流                      │   │
-│   │   ├── product/        ← 模板、检查列表                          │   │
-│   │   └── infrastructure/ ← 脚本、工具、集成                        │   │
-│   └─────────────────────────────────────────────────────────────────┘   │
-│                                                                         │
-│   ┌─────────────────────────────────────────────────────────────────┐   │
-│   │                    质量门槛 3 层                                 │   │
-│   │                                                                  │   │
-│   │   第 1 层: 提交前 ──► 第 2 层: PR ──► 第 3 层: 人工审查         │   │
-│   │   (Husky/lint-staged)   (CodeRabbit)    (战略审查)              │   │
-│   │        30%                  +50%              +20%               │   │
-│   │                        (80% 自动化)                              │   │
-│   └─────────────────────────────────────────────────────────────────┘   │
-│                                                                         │
-└─────────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 📚 新贡献者推荐阅读顺序
-
-### 快速开始 (30 分钟)
-1. [高级架构](./high-level-architecture.md)
-2. [模块系统](./module-system.md)
-3. [框架 README](../framework/README.md)
-
-### 深入学习 (2-3 小时)
-1. 所有快速开始文档
-2. [代理责任矩阵](./agent-responsibility-matrix.md)
-3. [MCP 系统图](./mcp-system-diagrams.md)
-4. [技术栈](../framework/tech-stack.md)
-
-### 完全掌握 (1-2 天)
-1. 本索引中的所有文档
-2. 架构决策的 ADR 文档
-3. 健康检查系统的 HCS 文档
-
----
-
-## 📝 文档状态图例
-
-| 状态 | 含义 |
-|------|------|
-| ✅ 当前版本 | 与 v4.2 保持最新 |
-| ⚠️ 需要更新 | 需要术语或内容更新 |
-| 📦 历史遗留 | 历史参考 |
-| 🆕 新增 | 最近创建 |
-
----
-
-**上次更新:** 2026-01-26
-**维护者:** @architect (Aria)