@xulthekl/team-flow 0.34.1 → 0.36.0

package/scripts/team-flow.mjs

@@ -17,6 +17,7 @@ const COMMANDS = {
   checkpoint:     () => import('./lib/cmd-checkpoint.mjs'),
   handoff:        () => import('./lib/cmd-handoff.mjs'),
   isolate:        () => import('./lib/cmd-isolate.mjs'),
+  deisolate:      () => import('./lib/cmd-deisolate.mjs'),
   execution:      () => import('./lib/cmd-execution.mjs'),
   runtime:        () => import('./lib/cmd-runtime.mjs'),
   solutions:      () => import('./lib/cmd-solutions.mjs'),
@@ -34,6 +35,7 @@ const COMMANDS = {
   'install-zcode':     () => import('./lib/cmd-install-zcode.mjs'),
   'prototype-sync':    () => import('./lib/prototype-sync.mjs'),
   'arch-merge':        () => import('./lib/arch-merge.mjs'),
+  arch:                () => import('./lib/cmd-arch.mjs'),
   'test-merge':        () => import('./lib/test-merge.mjs'),
   'test-matrix-export': () => import('./lib/test-matrix-export.mjs'),
   test:                () => import('./lib/test-record.mjs'),
@@ -51,6 +53,9 @@ Commands:
   sync <change-dir>     Merge delta specs into main specs
   prototype-sync <change-dir> [--source <path>] [--prototype-dir <path>]
                         Merge UX delta into global prototype/ + design-system.md
+  arch init [--mode reconstruction|design] [--baseline-ref <prd/vN/>]
+                        Stamp project-level arch_baseline into .team-flow/arch-state.json (v0.35.0 §59.4)
+  arch show             Show current project architecture baseline state
   arch-merge <change-dir> [--project-root <path>] [--dry-run]
                         Merge architecture delta into global docs/architecture/
   test-merge <change-dir> [--project-root <path>] [--dry-run]
@@ -88,6 +93,8 @@ Commands:
                         Upgrade inline/batch to SDD, or replan existing SDD waves, as a new revision
   execution review <change-dir> --wave <id> --base <sha> --head <sha> --report <path> --verdict pass|fail
                         Record one review receipt for a planned wave
+  deisolate <change-dir> [--merge] [--clean] [--json]
+                        Show worktree status / merge branch back / clean worktree
   runtime check-update  Run a portable update check for canonical skills
   runtime infer <dir>   Infer workflow mode without a plugin-root path
   runtime guard ...     Run a portable phase-transition guard

package/skills/architecture-design/SKILL.md

@@ -67,8 +67,9 @@ description: 基于 4A 企业架构 + DDD 领域驱动设计的架构/API/DB 设
 
 - `change-brief.md`（scope / AC / 技术方向）
 - `prd/vN/plan.md` 高阶技术设计段（模块边界/技术选型/数据流/关键聚合划分）
+- `docs/architecture/iterations/vN/architecture.md`（产品级架构快照，**主输入**，v0.35.0）——BC 边界/聚合所有权/全局契约的唯一事实源
+- 全局 `docs/architecture/`（As-Is 实际态基线，已落地部分）
 - 现有 `specs/`（若有）
-- 全局 `docs/architecture/`（As-Is 基线）
 
 ### 五项检查（架构变更判定）
 
@@ -80,6 +81,15 @@ description: 基于 4A 企业架构 + DDD 领域驱动设计的架构/API/DB 设
 4. **API 变更**：是否涉及 API 新增/变更（端点、方法签名、请求响应 schema）
 5. **DB schema 变更**：是否涉及数据库表结构、字段、索引变更
 
+### 路由分流（v0.35.0 新增）
+
+当产品级架构快照存在时（已建档项目），判定结果再按"产品级决策 vs change 内实现细节"分流：
+
+- 触及**产品级决策**（BC 边界变更 / 聚合所有权变更 / 全局契约变更）→ 引用快照 + 走**架构修订决策门**（不硬阻断，显式确认 + 登记 deviation，P3）
+- 仅 **change 内实现细节**（字段 / 端点 / 状态增量）→ 增量设计，不触发产品级变更
+
+变更级聚合动作限三类：`extend`（既有聚合加字段/指令/事件/状态）、`new`（新增聚合，flag 登记待产品级晋升）、`refactor`（需决策门）。聚合 id 一律引用产品级注册表，不重定义（防重发明，v0.14 §61.3）。
+
 ### 执行流程
 
 ```
@@ -149,6 +159,15 @@ changes/<name>/
 
 change 进入 closing 阶段时，由 release-archivist 调用 `tf arch-merge` CLI 命令，将 `changes/<name>/architecture/` 下的增量制品合并回全局 `docs/architecture/`，完成 As-Is → To-Be 基线更新。architecture-design 本身不执行合并，只负责产出增量制品。
 
+### 调用模式（v0.35.0：变更级 / 产品级）
+
+| 模式 | 编排入口 | 判定 | 产出 | owner |
+|------|---------|------|------|-------|
+| 变更级（默认） | workflow-start（exploring→specifying） | 五项检查 | `changes/<name>/architecture/` 三件套 + sql/ | architecture-design 子代理 |
+| 产品级（product 模式） | workflow-orchestrator S3.5（architecture 阶段） | 8 步全系统结构级设计（无五项检查） | `docs/architecture/iterations/vN/architecture.md`（6 产物快照） | architecture-design product 模式子代理（唯一 owner） |
+
+**产品级模式执行**：按 `references/s3.5-product-architecture.md` SOP（8 步），模板用 `references/s3.5-architecture-template.md`，加载协议用 `references/s3.5-loading-protocol.md`。产出经 architecture-reviewer product 视角评审（`review_mode: product`）PASS 才进 S4。时序遵守 P1：只写快照不写全局。
+
 ### 独立调用
 
 除 workflow-start 编排调用外，本 skill 仍支持用户显式独立调用（`/team-flow:architecture-design`），此时不走五项检查判定门，直接执行完整 4A+DDD 设计。
@@ -182,6 +201,8 @@ architecture-design 执行时的上下文组装：
 
 **上下文预算**：单次执行 ~2K tokens（L1 INDEX + 1-2 个 L2 域段 + L3 变更层）
 
+**产品级三段式加载（v0.35.0，有产品级快照时）**：按 `references/s3.5-loading-protocol.md` 三段式——① 索引层（INDEX + ARCHITECTURE §1-2 厚锚点）② 按域加载（change 触及的 `domains/<bc>.md`）③ 变更增量。迭代中读 `iterations/vN/` 快照（in-flight），迭代收尾读全局当前态（P1）。
+
 ## Scope & Limits
 本 skill 覆盖 4A+DDD 架构设计方法及其与 team-flow/compound-engineering 的衔接。落地实现结合项目具体工具；超出本范围见相关 skill 或直接问 agent。
 

package/skills/architecture-design/chapters/ch06-integration.md

@@ -28,10 +28,10 @@ changes/<name>/              # change 容器
 
 > **语义分离**：架构产出独立 `architecture/` 目录，不混入 `specs/`（行为规格）。目录存在 = 有架构产出，目录不存在 = 判定为不需要。下游消费方（spec-writer / release-archivist）显式读取此目录。
 
-## 每变更增量设计（SOP 步骤）
-1. (LLM) 读全局 ARCHITECTURE.md 作 grounding；用活动对象矩阵识别限界上下文/聚合。
-2. (LLM) 出 To-Be：新增/调整聚合、Context Map 关系、CQRS 读写模型、4A 跨域对齐。
-3. **As-Is 冻结**（核心修正）：复制全局相关章节**当前原文** + 记版本锚点（`ARCHITECTURE.md@<change_id>#<章节>`），变更内不可变——杜绝活引用漂移。
+## 每变更增量设计（SOP 步骤，v0.35.0 更新：产品级快照为输入）
+1. (LLM) 读全局 ARCHITECTURE.md **+ 产品级快照 `iterations/vN/architecture.md`**（v0.35.0，BC 边界/聚合注册表唯一事实源）作 grounding；识别本 change 触及的 BC → 按 `references/s3.5-loading-protocol.md` 三段式装载对应域；用活动对象矩阵识别限界上下文/聚合（变更级只引用产品级注册表，不重定义）。
+2. (LLM) 出 To-Be：**本 change 增量**（extend/new/refactor 三类动作）——新增/调整聚合、Context Map 关系、CQRS 读写模型、4A 跨域对齐；触及产品级决策走架构修订决策门。
+3. **As-Is 冻结**（核心修正）：复制产品级快照/全局相关章节**当前原文** + 记版本锚点（`iterations/vN/architecture.md@<change_id>#<章节>`），变更内不可变——杜绝活引用漂移。
 4. (脚本) 填 frontmatter 并校验：`cap_id/date/change_type/bounded_contexts/aggregates_affected/cqrs`。
 5. (LLM) 写 ADR 理由；API 标 Command/Read/Query + 阻断测试归属。
 6. (脚本) 回写全局 + 生成 API 索引。

package/skills/architecture-design/references/s3.5-architecture-template.md

@@ -0,0 +1,164 @@
+# S3.5 产品级架构文档模板（v0.35.0，v0.14 §60）
+
+> 产品级架构设计（architecture 阶段）产出的权威文档模板。基于 4A + DDD 方法论，覆盖 6 类产物。
+> 位置：`docs/architecture/iterations/vN/architecture.md`（预测态快照，P1：不写全局当前态）。
+> 产出后须经产品级评审门（architecture-reviewer product 视角）PASS 才进 S4。
+
+## 文档骨架
+
+````markdown
+---
+iteration_version: v1              # 迭代版本号
+provenance: forward-designed       # forward-designed | reverse-engineered | mixed
+established_at: <ISO 8601>         # 快照冻结时间
+snapshot_status: in-flight         # in-flight | superseded | archived
+superseded_by: null                # 下一版快照路径（退役时填）
+---
+# 产品级架构设计 · 迭代 vN
+
+## 1 限界上下文（Context Map）          <a id="bc"></a>
+
+| 上下文 | 职责(一句话) | 依赖 | 关系类型 | 语言边界/关键术语 |
+|--------|------------|------|---------|-----------------|
+| order  | 订单生命周期与履约 | payment, stock | Customer-Supplier | 客户=下单人 |
+| payment| 收款与对账 | order | Open Host Service | 客户=付款人（同词异义） |
+
+> mermaid：上下文关系图
+```mermaid
+flowchart LR
+  order -->|C-S| payment
+  order -->|C-S| stock
+```
+
+**关系类型枚举（6 种）**：Shared Kernel / Customer-Supplier / Conformist / Anti-Corruption Layer / Open Host Service / Separate Ways。
+
+## 2 聚合注册表                        <a id="aggregates"></a>
+
+| 聚合ID | 上下文 | 根实体 | 值对象 | 核心行为 | 关键不变量 | 事务边界 | 状态机锚点 |
+|--------|--------|--------|--------|---------|-----------|---------|-----------|
+| order:Order | order | Order | OrderItem, Address, OrderStatus | PlaceOrder/MarkPaid/Ship/Complete | 总金额=明细和；状态流转有序 | 订单事务 | §4.1 |
+
+### 2.2 聚合→表映射
+| 聚合 | 表集合 | 读模型 |
+|------|--------|--------|
+| order:Order | t_order, t_order_item, t_order_status_history | v_order_summary |
+
+### 2.3 聚合大小自检
+- [ ] 每聚合实体数 ≤5（超过提示拆分）
+- [ ] 事务边界无合并迹象
+- [ ] 并发写冲突高发区已识别
+
+> **唯一事实源**：本注册表是 BC 边界/聚合所有权的产品级权威；变更级（change 内）只引用本表 id，不重定义。
+
+## 3 指令与事件识别                  <a id="commands-events"></a>
+
+### 3.1 指令表
+| 指令 | 触发方 | 目标聚合 | Command/Read/Query | 结果事件 |
+|------|--------|---------|-------------------|---------|
+| PlaceOrder | Client | order:Order | Command | OrderPlaced |
+| MarkPaid | PaymentCaptured 集成 | order:Order | Command | OrderPaid |
+
+### 3.2 事件表
+| 事件 | 类型(领域/集成/外部) | 源聚合/上下文 | 触发 | 携带数据 | 消费方 | 投影读模型 |
+|------|--------------------|--------------|------|---------|--------|-----------|
+| OrderPlaced | 领域 | order:Order | PlaceOrder | orderId, items | payment, stock | order-summary-view |
+| PaymentCaptured | 集成 | payment:Payment | 支付回调 | orderId, paymentId | order:Order | order-summary-view |
+
+### 3.3 事件流图
+> mermaid：事件→指令级联链（覆盖 saga/process manager 跨聚合长流程一致性）
+
+### 3.4 读模型投影清单
+| 读模型 | 投影来源事件 | 更新方式(同步/异步) |
+|--------|-------------|-------------------|
+| order-summary-view | OrderPlaced, PaymentCaptured | 异步 |
+
+> 显式声明：事件用于**变更通知与投影驱动，不引入事件溯源持久化**。事件命名规范 `OrderPlaced`（名词+过去式动词），全系统一致。
+
+## 4 聚合状态迁移                  <a id="state-machines"></a>
+
+### 4.1 {order:Order} 状态机
+> mermaid stateDiagram-v2
+
+### 4.2 状态表
+| 状态 | 触发(Command/Event) | 触发源上下文 | 目标状态 | guard 不变量 |
+|------|--------------------|------------|---------|-------------|
+| 创建 | PlaceOrder | order | 已支付 | 总金额>0 |
+| 已支付 | Ship | order | 已发货 | 已收款 |
+
+> 区分**聚合状态机**（本表，聚合事务边界内）与**跨聚合流程状态机**（入 saga，不在聚合状态机内表达）。
+
+## 5 数据模型 / ER（概念级）         <a id="erd"></a>
+
+### 5.1 聚合边界 ER
+> mermaid erDiagram：同聚合表圈在一起标注聚合根表；跨聚合外键标"引用关系（非事务内）"。
+
+### 5.2 实体表
+| 实体 | 关键字段 | 所属聚合 | 写/读模型 |
+|------|---------|---------|----------|
+| Order | id, status, total | order:Order | 写 |
+
+> **派生纪律**：ER 从聚合注册表 + 状态图映射而来，**禁止先画 ER 再定聚合**（DB 表 ≠ 聚合）。
+
+## 6 应用时序（关键用例）           <a id="sequences"></a>
+
+### 6.1 用例索引
+| 用例 | 图文件 | 涉及聚合/上下文 |
+|------|--------|---------------|
+| 下单履约 | diagrams/sequences/order-place.md | order, payment, stock |
+
+### 6.2 {用例} 时序图
+> mermaid sequenceDiagram：跨聚合/跨上下文关键流程 Top-N。
+
+## 7 跨域一致性检查                <a id="consistency"></a>
+
+### 7.1 AA ↔ IA 双对齐（F2 门禁）
+| AA 功能 | IA 实体 | 对齐状态 | 说明 |
+|---------|---------|---------|------|
+| PlaceOrder | Order | ✅ | |
+
+- [ ] 每个 AA 功能 ≥1 个 IA 实体支撑
+- [ ] 每个 IA 实体 ≥1 个 AA 功能消费（无孤立节点）
+
+### 7.2 语义一致性
+| 概念 | 上下文 A 命名 | 上下文 B 命名 | 一致性 |
+|------|-------------|-------------|--------|
+| 客户 | 下单人(order) | 付款人(payment) | ✅ 显式映射 |
+
+### 7.3 变更分叉级联（F3）
+直接依赖 / 间接依赖 / 隐式依赖 三层次分析。
+
+## 8 DDD 反模式自检                <a id="antipatterns"></a>
+
+- [ ] 贫血模型（聚合只有 getter/setter，行为全在 Service）
+- [ ] 聚合过大（实体 >5 或事务边界膨胀）
+- [ ] 实体滥用（ER 每张表被当实体）
+- [ ] 表驱动聚合（表=聚合=Repository）
+- [ ] 事件命名不一致（大小写/时态混用）
+
+## 演进日志                           <a id="evolution-log"></a>
+
+| 版本 | 日期 | 变更摘要 |
+|------|------|---------|
+| v1 | <date> | 初始设计 |
+
+<!-- arch:current-state:begin -->
+<!-- 此 marker 区由 arch-merge 代码独占写（迭代收尾/change 合并时覆盖），禁止手改 -->
+<!-- arch:current-state:end -->
+````
+
+## 结构约束
+
+- **厚锚点**：§1-2 每行一句话，不展开细节；细节全部下沉 `domains/<bc>.md` 按域详细页与 `diagrams/`。
+- **marker 区**：`<!-- arch:current-state:begin/end -->` 是 arch-merge 覆盖写的替换边界，**只由代码写，不由 LLM 写**。
+- **按域详细页** `domains/<bc>.md`：职责与依赖 / 聚合明细 / 指令与事件（本域）/ 状态迁移图 / 数据片段（ER 局部）/ 应用时序（本域用例）/ 对外契约。单文件 ≤1500 token。
+- **结构级详设边界**：BC/聚合/关键事件/状态机/概念 ER/关键时序做全；**每 API schema、每表全字段留给 change 落地时涌现**。
+
+## 正反向设计差异（旧项目首轮）
+
+| 维度 | 正向设计（全新/已建档） | 逆向重建（旧项目首轮） |
+|------|------------------------|----------------------|
+| 输入 | PRD/plan/原型（预测） | 既有代码/DDL/文档（事实） |
+| 推导方向 | 业务能力→BC→聚合→... | 代码结构→候选 BC→聚合根候选→... |
+| 工具 | 方法论 + LLM | recon-probe.sh + codebase-recon-analyst + arch-reverse-analyst |
+| provenance | forward-designed | reverse-engineered + 置信度（high/medium/low） |
+| 深度 | L0 骨架 + 触及域深化 | 同（首轮强制 L0 骨架） |

package/skills/architecture-design/references/s3.5-loading-protocol.md

@@ -0,0 +1,40 @@
+# S3.5 产品级架构按域加载协议（v0.35.0，v0.14 §60.4）
+
+> 产品级架构文档（iterations/vN/architecture.md + domains/）供变更级 architecture-design 子代理加载。
+> 硬约束：单次上下文装载 ≤ **~2K token**（设计增强方案 v0.10 §29.1 三层策略）。本协议是 architecture-design SKILL.md「上下文加载协议」的产品级扩展。
+
+## 三段式加载
+
+| 段 | 内容 | 预算 |
+|----|------|------|
+| ① 索引层 | `docs/architecture/INDEX.md`（统计摘要）+ ARCHITECTURE.md §1-2（厚锚点：BC 表 + 聚合注册表） | ~400-600 |
+| ② 按域加载（按需） | change 触及的 `domains/<bc>.md`（+ 相关 sequence/erd 片段） | ~800-1400 |
+| ③ 变更增量 | `changes/<id>/architecture/` 增量 + 相关 changelog | ~200-400 |
+
+## 加载规则
+
+1. **先索引、后按域**：子代理先读 ① 索引层做路由（识别 change 触及哪些 BC），再按需加载 ② 该域的详细页。
+2. **单域单次**：跨多域时一次只装载一个域文件，逐域分步处理（与 ch06 增量 SOP 对齐）。
+3. **引用非复制**：只读不改；产品级聚合注册表是唯一事实源，change 内设计**引用**注册表 id，不重定义。
+4. **迭代状态判定**（P1）：读快照还是读全局由迭代状态决定——
+   - 迭代中（`snapshot_status: in-flight`）→ 读 `iterations/vN/` 快照（产品级决策权威）
+   - 迭代收尾（`snapshot_status: superseded/archived`）→ 读全局当前态（唯一权威）
+
+## 跨域降级（横向 change）
+
+横向 change（跨 ≥3 个 BC 的公共组件改造）会突破单次预算。降级路径：
+
+1. 只加载 ① 索引层 + 各域聚合注册表行（不加载详细页）。
+2. 触及域按"受影响优先级"逐域分步处理（每步 ≤1 域）。
+3. 加载前做 token 估算，超预算 → 告警 + 降级，而非硬约束失败。
+
+## token 预算自动化校验
+
+- 锚点（§1-2）与域页 token 预算加**自动化校验**（镜像 frontmatter-lint 模式，进 npm test）——不靠 LLM 自律。
+- S3.5 产物自检 + S4 审计抽查：`iterations/vN/architecture.md` 的 §1-2 必须一句话级；`domains/<bc>.md` 单文件 ≤1500 token（超出继续拆子页）。
+
+## 与既有加载协议的关系
+
+- 本协议**扩展** architecture-design SKILL.md「上下文加载协议」（:166-183），不替代。
+- 变更级 architecture-design 的输入 = 本协议 ① + ②（产品级）+ ③（变更增量）；语义层（五项检查判定、评审）仍走既有流程。
+- S3.5 产品级评审门（architecture-reviewer product 视角 A1-A6）验证产物结构满足本协议（A1 结构完备 + A2 marker/锚点可解析），保证下游可按域加载。

package/skills/architecture-design/references/s3.5-product-architecture.md

@@ -0,0 +1,76 @@
+# S3.5 产品级架构设计 SOP（v0.35.0，v0.14 §59/§60）
+
+> architecture 阶段（S3 之后、S4 之前）的执行 SOP。产出 `docs/architecture/iterations/vN/architecture.md`（预测态快照）。
+> **owner**：architecture-design skill 的 **product 模式**子代理（唯一 owner，声明见 architecture-design/SKILL.md「独立调用」扩展）。
+> **时序（P1）**：只写快照不写全局；change 关闭时 arch-merge 回写实际增量；迭代收尾快照标 `archived` 退役。
+
+## 输入
+
+- prd/vN/prd.md（frozen_downstream，功能清单 F001_P0 等）
+- prd/vN/plan.md（高阶技术设计段：模块边界/技术选型/数据流/关键聚合划分）
+- prototype/（S2 产物，页面结构）
+- docs/architecture/baseline.md（S1 注入）
+- docs/architecture/CONCEPTS.md（领域词汇）
+- 现有全局基线（旧项目逆向重建场景）
+
+## 8 步执行流程
+
+> 复用 architecture-design 方法论（F1-F8 + ch01-ch06），从"每 change 增量"扩展到"全系统结构级设计"。
+
+| 步 | 动作 | 方法论 | 产出 |
+|----|------|--------|------|
+| 0 | 输入梳理 | 读 PRD 功能清单 + plan 技术方向 + prototype + CONCEPTS + 现有基线 | 功能域→候选业务能力映射 |
+| 1 | 限界上下文识别 | 功能域分组 + 词汇聚类 + 活动对象矩阵（ch04，重叠>70% 合并） | Context Map：BC 表 + 关系图（6 关系类型）+ 语言边界术语表 |
+| 2 | 聚合识别 | 聚合四要素（ch04）+ 活动对象矩阵 | 聚合注册表（唯一事实源） |
+| 3 | 指令与事件识别 | CQRS 指令分流（ch05：Command/Read/Query + 阻断测试）+ 事件三类 | 指令表 + 事件表 + 事件流图 + 读模型投影清单 |
+| 4 | 聚合状态迁移 | 聚合根=状态机守卫（Vernon） | stateDiagram + 状态表（含触发源上下文、guard 不变量） |
+| 5 | 数据模型/ER（概念级） | 从聚合映射持久化（IA）+ CQRS 写读分区 | 聚合边界 ER + 实体表 + 聚合→表映射表 |
+| 6 | 应用时序（关键用例） | AA→TA 编排（4A） | 关键用例 Top-N 跨聚合时序图 + 用例索引 |
+| 7 | 跨域一致性检查 | F2 双对齐（AA≥1 IA 实体）+ 语义统一 + F3 变更分叉级联 | 一致性检查表 |
+| 8 | 反模式自检 + 评审 | DDD 反模式清单 + 产品级评审门 | 自检清单 + 评审 verdict |
+
+**顺序纪律**：聚合在前、ER 在后（ER 是派生产物，禁止先画 ER 再定聚合）；BC 边界/聚合所有权/全局契约是**产品级唯一事实源**（聚合注册表），变更级只引用。
+
+**模板**：按 `references/s3.5-architecture-template.md` 骨架产出（6 产物 + 厚锚点 + marker + provenance）。
+
+## 产品级评审门（Step 8）
+
+复用 architecture-reviewer agent（`agents/architecture-reviewer.md`），以 **product 视角**审查：
+
+| 维度 | 校验 |
+|------|------|
+| A1 | 结构完备（6 产物章节存在 + marker/锚点可解析，机械预检） |
+| A2 | SQL/结构有效（机械 grep，若含 sql/） |
+| A3 | 跨域一致性（AA↔IA 双对齐，F2 门禁） |
+| A4 | 与 PRD 功能清单覆盖映射（F001_P0 逐条 → BC/聚合/API） |
+| A5 | 与全局基线一致性（旧项目逆向重建产物 vs 现状代码） |
+| A6 | conventions 合规 |
+
+规则：≤3 轮修复循环 + 收敛检测（连续两轮不一致项不缩小 → 转人工）；PASS 才进 S4。
+**skip 时**：architecture-reviewer 不执行，但 skip 必须物化（iterations/vN/SKIPPED 标记 + 理由）。
+
+## 正向设计 vs 逆向重建
+
+| 维度 | 正向设计（全新/已建档） | 逆向重建（旧项目首轮） |
+|------|------------------------|----------------------|
+| 输入 | PRD/plan/原型（预测） | 既有代码/DDL/文档（事实） |
+| 推导方向 | 业务能力→BC→聚合→... | 代码结构→候选 BC→聚合根候选→... |
+| 工具 | 方法论 + LLM | recon-probe.sh + codebase-recon-analyst + arch-reverse-analyst |
+| provenance | forward-designed | reverse-engineered + 置信度（high/medium/low） |
+| 深度 | L0 骨架 + 触及域深化 | 同（首轮强制 L0 骨架，见 v0.14 §63.3） |
+
+逆向重建工具：`workflow-bootstrap` 的 recon-probe.sh（--ddl-out）+ codebase-recon-analyst + 新增 `arch-reverse-analyst`（v0.14 §63.2）。
+
+## 完成条件
+
+- `docs/architecture/iterations/vN/architecture.md` 已产出（6 产物，provenance 标注）
+- 产品级评审门 verdict = PASS（或 skip 已物化）
+- orchestrator.yaml 中 ARCH 阶段状态 = completed（workflow_phase: architecture）
+- **未触发** arch-merge 全局覆盖写（预测态不进实际态，P1）
+
+## 常见陷阱
+
+- **过度详设**：契约级（每 API schema/每表全字段）留给 change 落地涌现，产品级只做结构级（P4）。
+- **skip 不物化**：跳过必须写 iterations/vN/SKIPPED + 理由，否则 S4 arch-readiness 卡死 hotfix 通道（v0.32.2 C1 死锁链同类）。
+- **事件只识别不投影**：引入事件必须补"读模型投影清单"（§3.4），否则读模型更新无定义。
+- **ER 先行**：先画 ER 再定聚合 = 数据库驱动设计，违背 DDD（顺序纪律）。

package/skills/release-archivist/SKILL.md

@@ -201,6 +201,20 @@ tf solutions capture \
 
 This check is advisory — skip silently if no learnable moments are detected.
 
+### Worktree Deisolation (v0.35.0) — advisory
+
+After compound promotion, check if worktree isolation exists for this change:
+
+```bash
+tf deisolate <change-dir>
+```
+
+If worktrees exist (output shows `found: true` or ahead/behind stats), include the deisolation report in the closing summary. **Do NOT auto-merge** — the orchestrator or user decides the merge strategy. Mark `Worktree deisolation` in the Step 5 report as:
+- `PENDING` — worktrees detected, user action required
+- `N/A` — no worktrees found (single-repo or already cleaned)
+
+This step is advisory — skip silently when `tf deisolate` reports no worktrees.
+
 ### Workflow Feedback Check (v0.16.0)
 
 Before finalizing the closing, ask the user if they encountered any workflow issues during this change:

package/skills/session-handoff/references/handoff-template.md

@@ -11,7 +11,7 @@ type: session-handoff
 version: 1
 created_at: <ISO 8601>
 requirement_id: <req-id | null>
-workflow_phase: <S1-S5 | change-level | null>
+workflow_phase: <S1-S5 | architecture | change-level | null>
 state_machine: <8态之一 | null>
 change_dir: <path | null>
 ---
@@ -26,7 +26,7 @@ change_dir: <path | null>
 ### §2 工作流状态（自动检测，引用不复制）
 
 - 活跃需求：`<req-id>` — `<title>`
-- 产品级阶段：`<S1-S5>`（详见 `.team-flow/requirements/<req-id>/orchestrator.yaml`）
+- 产品级阶段：`<S1-S5 | architecture>`（详见 `.team-flow/requirements/<req-id>/orchestrator.yaml`）
 - 变更级状态：`<state>`（详见 `<change>/.team-flow.yaml`）
 - PRD 版本：`<vN>`，冻结状态：`<frozen_downstream | frozen_absolute | unfrozen>`
 

package/skills/spec-writer/SKILL.md

@@ -137,6 +137,7 @@ Generate one at a time. Confirm each before next. This prevents scope drift —
 
 ### tasks.md
 - `## File Structure`, `## Interfaces`, numbered tasks, exact file paths, TDD phases, ≤5 min steps, no placeholders, every requirement mapped, explicit dependencies
+- **接口交叉核对（v0.35.0，v0.14 §61.1）**：若 `architecture/api.md` 存在，机械比对 `tasks.md` `## Interfaces` 声明的端点集合与 `api.md` 架构路由表端点集合——tasks 引用了 api.md 未声明的端点、或 api.md 声明的关键端点 tasks 未落地 → 告警修正（traceability 从自报升级为机械比对）
 
 **If any artifact fails validation, fix before handing off to contract-builder.**
 

package/skills/workflow-bootstrap/references/agents/arch-reverse-analyst.md

@@ -0,0 +1,60 @@
+# Arch Reverse Analyst（v0.35.0，v0.14 §63.2）
+
+> 旧项目 S3.5 逆向重建子代理。在 `workflow-bootstrap` B1 侦察之后、S3.5 reconstruction 模式派发。
+> 消费 recon-probe.sh 确定性 JSON + codebase-recon-analyst 维度摘要，补齐**产品级逆向重建**维度：
+> 候选限界上下文 / 聚合根候选 / 聚合状态机草图 / 指令事件表。
+> 只读，不修改任何文件。
+
+## 输入契约
+
+派发 prompt 提供：
+- `recon_json`：recon-probe.sh JSON 输出路径（机械基线：目录树/依赖/LOC/DDL）
+- `root`：项目根
+- 上游维度摘要：codebase-recon-analyst 的 modules / data-model / api-surface / architecture 输出（可选）
+
+## 方法论
+
+### Step 0: 消费基线
+先读 `recon_json` + 上游摘要。机械采集（文件/依赖/DDL）已由脚本完成，不重跑；只做**语义**判断。
+
+### 维度 1: 候选限界上下文（BC）
+- 从目录树 + 模块边界 + 领域词汇（`docs/architecture/CONCEPTS.md` 若有）聚类候选 BC。
+- 判断依据：命名空间/模块独立性、业务能力分组、依赖方向。
+- 输出：候选 BC 列表 + 职责一句话 + 置信度（high/medium/low）+ 证据（目录路径）。
+
+### 维度 2: 聚合根候选
+- 从实体类/Repository/Service 方法识别聚合根候选 + 事务边界。
+- 判断依据：唯一标识、事务边界、Repository 归属。
+- 输出：聚合根候选（`context:Aggregate` 格式）+ 值对象候选 + 事务边界 + 置信度。
+
+### 维度 3: 聚合状态机草图
+- 从状态枚举/字段 + 状态流转逻辑（Service 方法）还原聚合状态机。
+- 输出：状态清单 + 迁移触发（方法名/事件）草图；不确定标 `[待确认]`。
+
+### 维度 4: 指令与事件
+- 从 Command/Service 方法签名 + 事件类识别指令（Command/Read/Query 分流，复用 ch05 阻断测试）与事件。
+- 输出：指令表 + 事件表（类型/来源/消费），不确定标 `[待确认]`。
+
+### 输出规范（provenance + 置信度，v0.14 §63.2）
+- frontmatter 标 `provenance: reverse-engineered`。
+- 逐条目标注来源：`src/xxx/Order.java`（代码推断）/ `docs/legacy/*.md`（文档）/ `schema-baseline.sql`（DDL）/ `user-confirmed`（用户确认）。
+- 置信度判定：代码路径 + DDL 推导 → high；LLM 语义推断 → medium/low。
+- 仅产出 **L0 骨架**（候选 BC + 聚合根候选 + API 表面总览）首轮必做；状态机/指令事件完整深化留 L1 按域渐进（v0.14 §63.3）。
+
+## Tool Guidance
+- Read/Grep/Glob 定位实体/状态/事件；Bash 仅限重新调用 recon-probe.sh（若基线未提供）。
+- 不修改任何文件，只读。
+- 规模阈值：模块<10 且 LOC<2万 可一次性全量；否则 L0+L1 分层渐进。
+
+## Structured Handoff（强制）
+你的 final response 必须是结构化交接：
+```
+{
+  status: "done" | "done_with_questions" | "blocked",
+  deliverable: <候选 BC/聚合根/状态机/指令事件 结构化摘要（含 provenance + 置信度）>,
+  blockers: [ { question, why_blocking, options[] } ],
+  outstanding_questions: [ { question, default_assumption } ],
+  summary: <3-5 行 gist>
+}
+```
+规则：非阻断疑问 → 按 default_assumption 继续 + 记入 outstanding_questions；阻断疑问（recon_json 与 root 均缺失、代码库为空）→ status=blocked + blockers[]，绝不强行猜测。

package/skills/workflow-orchestrator/references/feedback-loops.md

@@ -7,6 +7,8 @@
 | 回退路径 | 触发条件 | 操作 | 制品处置 |
 |---------|---------|------|---------|
 | **S3 → S2** | plan 暴露 PRD scope 问题 | PRD vN 内修订 + 记录变更履历（临时解除 frozen_downstream） | plan.md → plan.md.revN（归档），S3 重入时从零产出 |
+| **ARCH → S3** | 架构设计暴露 plan 拆分问题（v0.35.0 新增） | 调整拆分策略 | plan.md → plan.md.revN（归档）；iterations/vN/ 快照未完成部分丢弃 |
+| **S4 → ARCH** | 架构快照不覆盖 change 触及的 BC / 架构产物缺失（v0.35.0 新增） | 回 ARCH 阶段补快照 | iterations/vN/ 增量调整，change 拆分保留 |
 | **S4 → S3** | 依赖图不可执行/粒度不合理 | 调整拆分策略 | 已创建的 change 目录保留，重新拆分后增量调整 |
 | **S5 → S4** | 跨 change 冲突需要重新拆分 | 重新评估拆分方案 | 见下方「在途 change 处置」 |
 

package/skills/workflow-orchestrator/references/s1-path-router.md

@@ -21,7 +21,7 @@ S1 只做编排动作（需求选择、存在性检查、路径判断、阻塞
 |------|---------|------|------|
 | **全新需求** | 无现有 PRD，需求模糊 | → S2 | 完整流程 |
 | **续版需求** | 有 PRD vN，用户要加功能 | → S2（PRD vN+1） | 新版本迭代 |
-| **重新计划** | PRD 已冻结，plan 需调整 | → S3 | 跳过 brainstorm |
+| **重新计划** | PRD 已冻结，plan 需调整 | → S3 | 跳过 brainstorm；S3 完成后进 ARCH（产品级架构设计，v0.35.0）再拆 change |
 | **继续执行** | changes 已拆分，继续下一个 | → S4/S5 | 先输出状态恢复简报，用户确认后继续 |
 | **单 change 快速通道** | 需求极清晰，无需 PRD（仅限单一功能点、无 UI、无跨模块依赖的极小变更） | → 直接创建 change → workflow-start | 最轻量路径，无 PRD 锚点，**不可触发 S3→S2 回退** |
 | **紧急修复（Hotfix）** | bug/生产问题，需最小范围修复 | → 直接创建 change（type: hotfix，注入 bug 描述替代 PRD）→ workflow-start | closing 时强制补录复利 |

package/skills/workflow-orchestrator/references/s3-plan-pipeline.md

@@ -42,9 +42,10 @@ ce-plan 在 orchestrator pipeline 上下文中减少仪式开销，但**保留
 
 - plan 是否暴露了 PRD 的范围问题？
   - **是** → 回退 S2，触发 PRD vN 内修订（记录变更原因）。详见 feedback-loops.md「S3 → S2」
-  - **否** → 进 S4
+  - **否** → 进 ARCH（architecture 阶段，v0.35.0 产品级架构设计，见 state-model.md「architecture 阶段」）
 
 ## 完成条件
 
 - `prd/vN/plan.md` 已产出，含 change 拆分 + 依赖 DAG + 技术方向
 - `.team-flow/requirements/<req-id>/orchestrator.yaml` 中 S3 状态 = completed
+- 下一步：进入 ARCH 阶段，产出 `docs/architecture/iterations/vN/architecture.md` 后进 S4（v0.35.0）

package/skills/workflow-orchestrator/references/s4-split-validate.md

@@ -14,9 +14,19 @@
 
 ## 步骤
 
+### 0. 架构就绪门禁（arch-readiness，v0.35.0 新增）
+
+> 设计依据：v0.14 §59.4。产品级架构快照必须覆盖 change 拆分触及的限界上下文，拆分审计才有架构依据。
+
+进入拆分前先校验：
+
+- **项目 arch_baseline 缺失（存量/重建未完成）** → WARN 不阻断（reason: 'project architecture baseline not established — S3.5 reconstruction pending'），提示先跑 S3.5 重建产出 L0 骨架。
+- **已建档项目** → 校验 `docs/architecture/iterations/vN/architecture.md` 存在且覆盖 plan.md 各 change 触及的全部 BC。不覆盖 → FAIL，回退 ARCH 阶段补快照（feedback-loops.md「S4 → ARCH」）。
+- **skip 物化**：ARCH 阶段显式跳过（iterations/vN/ 占位含 skipped 标记 + 理由）→ PASS。
+
 ### 1. 拆分质量审计（必选门禁，不可跳过）
 
-调用 `change-split-auditor` agent 对 `plan.md` 做拆分质量审计，输出审计报告（覆盖矩阵 / DAG 无环 / 粒度均衡 / 字段完整 / **拆分维度合规**）。质量自检清单：
+调用 `change-split-auditor` agent 对 `plan.md`（**+ `docs/architecture/iterations/vN/architecture.md` 作为架构依据**，v0.35.0）做拆分质量审计，输出审计报告（覆盖矩阵 / DAG 无环 / 粒度均衡 / 字段完整 / **拆分维度合规**）。质量自检清单：
 
 **必选约束**：审计 verdict = PASS 是 Step 3（创建脚手架）的前置条件。
 verdict = FAIL → 必须回退 S3 调整拆分后重新审计，不可绕过直接创建 change。

package/skills/workflow-orchestrator/references/state-model.md

@@ -16,6 +16,7 @@
 
 - **迁移兼容**：检测到旧 `<root>/.workflow-orchestrator.yaml` 存在时，自动迁移到 `.team-flow/requirements/<req-id>/orchestrator.yaml` 并提示用户（一次性）。
 - **变更级状态**：各 change 的状态文件**当前仍为** `<change>/.team-flow.yaml`，检测逻辑不动；**计划 v1.0.0（P1-6 第二阶段）改名**为 `.team-flow.yaml`（对齐设计增强方案 v0.8 §18.3）。改名落地前，编排层与变更层一律以 `.team-flow.yaml` 为准。
+- **项目级架构状态（v0.35.0 新增）**：`.team-flow/arch-state.json`（架构阶段是产品/迭代级，不放 change 状态）。见下文「architecture 阶段」与「arch_baseline 豁免键」。
 
 ## registry.yaml Schema
 
@@ -42,6 +43,8 @@ phases:                               # 各阶段状态
   - { id: S1, status: completed, started_at: "...", completed_at: "...", artifacts: [...] }
   - { id: S2, status: active, started_at: "...", artifacts: [...] }
   - { id: S3, status: pending }
+  - { id: ARCH, name: 产品级架构设计, status: pending, skip: <迭代无结构性变更|null>, artifacts: [docs/architecture/iterations/vN/architecture.md] }
+  - { id: S4, status: pending }
 custom_phases: []                     # reserved
 replan_log:                           # 重规划履历
   - { seq: 1, trigger: "用户要求跳过原型", before: "S2→S3", after: "S2(skip-proto)→S3", approved_by: user }
@@ -71,6 +74,55 @@ prd_version: v1                       # PRD 版本
 - **阻塞**：active → blocked → active（S5 检测到 change 卡死）或 blocked → aborted
 - **终止**：任何非 completed 状态 → aborted（用户放弃编排）
 
+## architecture 阶段（S3.5，v0.35.0 新增）
+
+> 产品级架构设计阶段，位于 S3 计划之后、S4 拆分之前。设计依据：设计增强方案 v0.14 §59。
+
+**phase id**：`ARCH`；顶层 `workflow_phase: architecture`（语义 kebab-case）。
+**命名约定**：新阶段一律用 kebab-case 语义名（历史值保留不迁移，避免无价值 churn）。
+
+```yaml
+phases:
+  - { id: S3, status: completed }
+  - { id: ARCH, name: 产品级架构设计, workflow_phase: architecture,
+      status: completed, skip: null,
+      artifacts: [docs/architecture/iterations/vN/architecture.md] }
+  - { id: S4, status: pending }
+```
+
+**场景判定（入口三态）**：
+| 场景 | 判定输入 | S3.5 模式 |
+|------|---------|----------|
+| S0 全新项目 | 无代码库 | 正向设计（首轮不可跳过） |
+| S1 存量代码+无基线 | 有 src/，无 baseline.md | 先 workflow-bootstrap → 逆向重建 |
+| S2 存量+瘦锚点 | baseline.md + ARCHITECTURE 无 BC/聚合层 | 逆向重建（深化） |
+| S3 存量+跑过迭代 | baseline + changes/ + prd/vN/，无 arch_baseline | 逆向重建（首轮强制） |
+| S4 已有产品级架构 | arch_baseline 已打戳 + iterations/ | 正向设计（正轨） |
+
+**skip 条件（须物化）**：迭代无结构性变更（纯 bugfix/重构/不新增 BC 或聚合/不改变聚合边界或全局契约）。判定者 = **编排器 + 用户确认**（非 LLM 自判，防 v0.13 §54 绕过教训）。**skip 必须物化**：写入 `docs/architecture/iterations/vN/` 占位（含 skipped 标记 + 理由），guard 才放行——否则 hotfix/快速通道 change 会卡在 arch-readiness 上（v0.32.2 C1 死锁链同类）。
+
+**时间盒 + 深度分层**：时间盒 ≤1 天；非触及 BC 只维护锚点行，触及 BC 才做按域深化（v0.14 §60.4）。
+
+**输入输出契约**：
+- 输入：prd/vN/prd.md（frozen_downstream）+ plan.md + prototype/ + baseline.md + CONCEPTS.md + 现有全局基线（旧项目）
+- 输出：`docs/architecture/iterations/vN/architecture.md`（6 产物权威快照，预测态，provenance 标注）+ 产品级评审 verdict；**不触发全局覆盖写**（P1：预测态不进实际态）
+
+**门禁**（v0.14 §59.4）：
+| 门禁 | 挂点 | 校验 | 豁免 |
+|------|------|------|------|
+| 产品级评审门 | ARCH→S4 | architecture-reviewer product 视角 PASS | skip 时仍要物化标记 |
+| arch-readiness | S4 拆分 | iterations/vN/ 快照覆盖 change 触及的 BC | arch_baseline 缺失 → WARN 不 FAIL |
+| arch-snapshot | executing→closing | 本轮快照已落盘 | 在途 change legacy 豁免 |
+
+## arch_baseline 豁免键（v0.35.0 新增）
+
+完全复刻 v0.13 §48.1 schema_version 防污染模式（设计增强方案 v0.14 §59.4/§63.1）：
+
+- **位置**：`.team-flow/arch-state.json`（项目级状态；架构阶段是产品/迭代级，不放 change 的 `.team-flow.yaml`）
+- **内容**：`{ arch_baseline: "v0", established_at: "<date>", mode: "reconstruction" | "design", snapshot_root: "iterations/", baseline_prd_ref: "prd/vN/" }`
+- **防污染**：仅 `tf arch init` 写入；`tf state set`/rebuild/doctor 一律不得追加（缺失 = 存量信号）
+- **判定**：`arch_baseline == null` → arch-readiness/arch-snapshot 均 PASS + WARN（reason: 'project architecture baseline not established — S3.5 reconstruction pending'）
+
 ## 双层冻结语义（解决 §17.3 与 §17.9.1 矛盾）
 
 - **`frozen_downstream`**（S2 完成时设置）：下游阶段（S3/S4/S5）不可直接修改 PRD，只能通过回退到 S2 修改。**S3→S2 回退 = 临时解除 frozen_downstream**，S2 重新完成后恢复。