forge-architectlisted

# forge-architect — 项目级架构梳理 ## Goal 作为 Chief Architect，只产架构文档，不动业务代码。和用户协作完成 4-6 步的项目级架构梳理。 ## Trigger Scenarios - **首次建立**：项目从未跑过 A-architect，CONTEXT.md 已存在但 ARCHITECTURE.md 缺失 - **里程碑级重构**：技术栈大变 / 系统拆分 / 大功能模块重组 - **ADR 重审**：E-evolve 多次提示"ADR 冲突 / 累积 ≥ 5"时升级处理 - **接手陌生项目**：跑完 `I-intel-scan` 之后，想把架构理解结构化 ## Boundary with E-evolve | 工作流 | 干什么 | 何时跑 | 改 ARCHITECTURE.md 哪段 | |---|---|---|---| | **A-architect**（本文）| 重写 / 大改 ARCHITECTURE 全篇 | 首次建立 / 重大重构 / ADR 重审 | 任何段都可改 | | **E-evolve** | 把 change 级沉淀**单点 append** 到 ARCHITECTURE | 每月 / 每季 批量 | 仅 append ADR 列表 / 跨模块契约段 / 修订历史 | **不确定该跑哪个？改动只增不删 → E-evolve；涉及结构调整 / 删旧 ADR → A-architect** ## Workflow ### 步骤 1 · 判定模式（首跑 vs 重构） 读 `.specs/ARCHITECTURE.md`： - **不存在** → 模式 A · 首跑（4 步） - **存在但 < 100 行 / 缺关键段** → 模式 A · 首跑（覆盖重写） - **存在且完整** → 模式 B · 重构（6 步含 diff review） 输出范围声明： ``` A-architect 模式：<A · 首跑 / B · 重构> 已有 ARCHITECTURE.md：<是 / 否，N 行，最近修订 YYYY-MM-DD> 当前 ADR 数：<N> 计划：<列出 4 步 或 6 步> ``` ### 步骤 2 · 系统概览（必跑） #### 2.1 一句话定位 + 服务边界图 反问用户： ``` 帮我用一句话描述这个系统的本质（< 30 字）： <例：一个面向中小团队的项目管理 SaaS，主打离线优先 + 协作冲突自动合并> 然后我会基于代码扫描画一个服务边界图（mermaid）让你校准。 ``` 得到一句话后，AI 自己 grep + 分析画 mermaid 图，给用户校准。 #### 2.2 NFR 基线 反问用户关键非功能性指标： - 当前 / 预期峰值 QPS - P95 延迟目标 - 数据量 / DAU - 可用性目标 写入 ARCHITECTURE § 1。 ### 步骤 3 · 模块清单 + 依赖规则（必跑 · 老项目核心） #### 3.1 模块发现 ``` MATCH (c:Community) RETURN c.heuristicLabel, c.symbolCount, c.keywords, c.description, c.cohesion ``` 2. 每个 Community 即一个功能模块，字段自动包含：路径（从 keywords 推断）、职责（description）、符号数、