@xulthekl/team-flow 0.36.1 → 0.36.3

package/.claude/always/phase-guard.md

@@ -1,3 +1,3 @@
-# team-flow v0.36.1 | 阶段: {{state}} | 工作流: {{workflow}}
+# team-flow v0.36.3 | 阶段: {{state}} | 工作流: {{workflow}}
 当前阶段允许的操作由 workflow-start 路由规则定义。
 禁止跨越 DP gate 进入下一阶段。变更范围以 execution-contract.md 的 Intent Lock 为准。

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "team-flow",
       "description": "8-state spec workflow + compound global compounding + architecture-design (4A/DDD) + local HTML prototype + product-level orchestration + bootstrap + e2e + session handoff + workflow feedback. 24 skills + 15 agents with embedded TDD, SDD, code review, debugging, delta spec sync, and design-system-driven prototyping.",
-      "version": "0.36.1",
+      "version": "0.36.3",
       "source": "./",
       "author": {
         "name": "LT",

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "version": "0.36.1",
+  "version": "0.36.3",
   "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking). 24 skills + 15 agents, one install.",
   "source": "./",
   "author": {

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "version": "0.36.1",
+  "version": "0.36.3",
   "description": "Spec-first workflow that bridges OpenSpec-style planning and Superpowers-style execution discipline.",
   "author": {
     "name": "MageByte",

package/.cursor-plugin/marketplace.json

@@ -5,7 +5,7 @@
   },
   "metadata": {
     "description": "Unified workflow plugin marketplace for Cursor (team-flow: team-flow + compound + architecture-design + prototype).",
-    "version": "0.36.1"
+    "version": "0.36.3"
   },
   "plugins": [
     {

package/.cursor-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "team-flow",
   "displayName": "team-flow",
   "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking). 24 skills + 15 agents, one install.",
-  "version": "0.36.1",
+  "version": "0.36.3",
   "author": {
     "name": "LT",
     "url": "https://github.com/LT"

package/.github/plugin/marketplace.json

@@ -6,13 +6,13 @@
   },
   "metadata": {
     "description": "Unified workflow plugins and skills for AI coding agents (team-flow: team-flow + compound + architecture-design + prototype).",
-    "version": "0.36.1"
+    "version": "0.36.3"
   },
   "plugins": [
     {
       "name": "team-flow",
       "description": "Unified workflow with planning artifacts, execution contracts, TDD, review gates, systematic debugging, delta spec sync, architecture-design, and local HTML prototyping.",
-      "version": "0.36.1",
+      "version": "0.36.3",
       "source": ".",
       "author": {
         "name": "LT",

package/AGENTS.md

@@ -100,13 +100,13 @@ prd/                    PRD（有版本 v1→v2→v3，git 分支隔离）
       ├── prd-completeness-review.md # PRD 完整性评审报告（prd-completeness-reviewer 产出，v0.15.0 新增）
 prototype/             全局原型系统（UI 契约真相源）：index.html / pages / components / assets / design-system.md / flow.md
 docs/
-  ├── architecture/    全局架构锚点：ARCHITECTURE.md / DATABASE.md / <bc>/（限界上下文目录）/ baseline.md（v0.6 新增）
+  ├── architecture/    全局架构三层（v0.36.0）：L1 当前态（ARCHITECTURE.md marker 区 / PHYSICAL-MODEL.md / DATABASE.md / API-INDEX.md / INDEX.md / domains/<bc>.md / diagrams/ / schema-baseline.sql / baseline.md）+ L2 changelog/ + L3 iterations/vN/architecture.md（产品级快照，archived 退役）
   └── solutions/       复利经验库（v0.5 新增，三层索引）
       ├── INDEX.md     # L1 轻量索引（≤150行，每条一行摘要+标签）
-      ├── prd/ plan/ prototype/ spec/ build/ review/ cross-phase/  # L2 分阶段目录
+      ├── prd/ plan/ architecture/ prototype/ spec/ build/ review/ cross-phase/  # L2 分阶段目录（v0.36.0 加 architecture）
       └── <file>.md    # L3 经验文件（YAML frontmatter: phase/domain/type/severity）
-changes/<name>/        变更脚手架（S4 创建）：.team-flow.yaml（变更级状态文件，P1-6 第二阶段改名 .team-flow.yaml）
-specs/<cap>/            每变更设计/任务/契约：spec.md / design.md / tasks.md / execution-contract.md / architecture.md / database.md / api.md / learnings.md
+changes/<name>/        变更脚手架（S4 创建）：.team-flow.yaml（变更级状态文件）/ change-brief.md（产品级交接物，含 upstream_arch_ref）/ architecture/（变更级三件套 + sql/）
+specs/<cap>/            每变更设计/任务/契约：spec.md / design.md / tasks.md / execution-contract.md / learnings.md（v0.9 起 architecture/ 三件套已迁至 changes/<name>/architecture/）
 STRATEGY.md CONCEPTS.md 产品策略(BA) / 领域词汇
 ```
 

package/CHANGELOG.md

@@ -6,6 +6,27 @@ The format loosely follows Keep a Changelog.
 
 ## [Unreleased]
 
+## [0.36.3] - 2026-08-05
+
+### Fixed（v0.14 全链路缺口修复——27 项，复利链路 + agent 契约 + 门禁时序 + 交接/决策门 + guard hook + 快照生命周期 + 旧项目 + 文档同步 + 横展）
+
+- **复利链路（严重 #4）**：solutions PHASES 加 architecture；architecture-design 加载协议加复利注入（`tf solutions inject --phase architecture`）；S3.5 SOP 加复利捕获（Step 9）；ce-compound 补架构自动捕获场景
+- **agent 契约（严重 #1 #2）**：architecture-design / architecture-reviewer agent 加 product 模式（mode 参数/快照输入/INPUT_ERROR 分 mode/Phase1-A3 分叉/报告落盘 iterations/vN/auto-review.md）
+- **门禁触发点（严重 #3）**：`tf arch init` 打戳加 SOP 触发点（S3.5 完成条件 + orchestrator ARCH 节）——arch_baseline 从此可建立，arch 门禁不再永久空转
+- **门禁时序（重要 #5 + 一般 #16 #21）**：skip 物化限定最新迭代（防旧 SKIPPED 错误豁免）；iterations 数字排序（v10+）；FAIL 提示文案修正
+- **arch 门禁测试（重要 #10）**：新增 tests/lib/guard-arch-gates.test.mjs（7 例）；guard-dimensions 更新 16 维度 + arch-readiness 断言
+- **交接/决策门（重要 #12 #7 #6）**：change-brief 加 upstream_arch_ref；架构修订决策门 SOP 定义（deviation 登记）；API-INDEX 只扫已关闭 change；首轮特例状态标注；arch-snapshot 在途兜底
+- **guard hook + 门禁说明（重要 #9 #11）**：pre-tool-use-guard 豁免 docs/architecture/iterations/ + .team-flow/；workflow-start/release-archivist 补 arch 门禁说明 + FAIL 升级路径
+- **快照生命周期（重要 #8 + 一般 #17）**：s5-monitoring 迭代收尾标 archived；S3.5 补 domains/ + diagrams/ 产出 SOP
+- **旧项目链路（重要 #14 + 一般 #22）**：workflow-bootstrap 感知 arch-reverse-analyst/逆向重建（B5 + 修正陈旧指引）；recon-probe.sh 路径修正
+- **文档同步（一般 #15 #19 #20）**：AGENTS.md/README 目录树三层化；ch06/state-model/loading-protocol/模板 marker 陈旧修正；workspace 登记（design-doc-system/roadmap）
+- **横展（一般 #13 + 建议 #24 #25）**：arch-merge 白名单补 changelog/；doctor 加 arch-state 体检；cross-change 对照产品级注册表
+
+## [0.36.2] - 2026-08-05
+
+### Fixed
+- **变更级架构设计输入链缺口修复**：0.36.0 在 architecture-design/SKILL.md 声明产品级快照（`iterations/vN/architecture.md`）为主输入，但 workflow-start 实际 dispatch 子代理的输入列表（`routing-rules.md`）未传该路径——变更级架构设计不会将产品级架构设计作为输入。已同步：routing-rules.md（architecture-design + architecture-reviewer dispatch 输入）、workflow-start/SKILL.md（Step 1）、architecture-reviewer（A5 基线一致性对照产品级快照）
+
 ## [0.36.1] - 2026-08-05
 
 ### Fixed

package/GEMINI.md

@@ -8,7 +8,7 @@ The workflow is self-contained and does not require OpenSpec or Superpowers at r
 
 
 <!-- team-flow-phase-guard-start -->
-# team-flow v0.36.1 | 阶段: {{state}} | 工作流: {{workflow}}
+# team-flow v0.36.3 | 阶段: {{state}} | 工作流: {{workflow}}
 当前阶段允许的操作由 workflow-start 路由规则定义。
 禁止跨越 DP gate 进入下一阶段。变更范围以 execution-contract.md 的 Intent Lock 为准。
 <!-- team-flow-phase-guard-end -->

package/INSTALL.md

@@ -7,7 +7,7 @@
 - [Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec) — 规划引擎（Schema 验证、Delta Spec、工件解析）
 - [obra/superpowers](https://github.com/obra/superpowers) — 执行纪律（TDD 铁律、SDD、系统化调试、代码审查）
 
-当前发布版本：**v0.36.1**。
+当前发布版本：**v0.36.3**。
 
 ---
 

package/README.md

@@ -1,6 +1,6 @@
 # team-flow
 
-> 当前版本：`v0.36.1`
+> 当前版本：`v0.36.3`
 
 > 统一插件：**team-flow**（spec 驱动开发）+ **compound-engineering 核心子集**（全局复利）+ **architecture-design**（4A+DDD 增量设计）+ **prototype**（本地 HTML 原型）+ **e2e**（AC 驱动 E2E）+ **workflow-orchestrator**（产品级编排）+ **workflow-bootstrap**（既有项目接入）。一次安装，七套能力协同。
 
@@ -64,7 +64,7 @@ cp -r <plugin>/skills/prototype/references/prototype-scaffold/ <project>/prototy
 prd/               PRD + 实施方案 + 原型审查记录（v1→v2，分支隔离）
 prototype/         全局原型（UI 契约真相源）
 docs/
-  ├── architecture/  全局架构锚点（ARCHITECTURE.md / DATABASE.md / <bc>/ / baseline.md）
+  ├── architecture/  全局架构三层（v0.36.0）：ARCHITECTURE.md / PHYSICAL-MODEL.md / DATABASE.md / API-INDEX.md / INDEX.md / domains/<bc>.md / iterations/vN/（产品级快照）/ baseline.md
   └── solutions/     复利经验库（三层索引：INDEX.md → 分阶段目录 → 经验文件）
 specs/<cap>/        每变更设计/任务/契约 + learnings.md
 STRATEGY.md CONCEPTS.md 策略 / 领域词汇

package/agents/architecture-design.md

@@ -21,16 +21,27 @@ You are an independent architecture designer. You read the change brief, plan, e
 
 **Your preloaded Skill contains the detailed methodology** (F1-F8 frameworks, chapter knowledge, templates, conventions protocol, context loading protocol). Follow it for HOW. This prompt defines WHO you are and WHAT you must deliver.
 
+## Call Mode（v0.36.0：变更级 / 产品级）
+
+| 模式 | 编排入口 | 判定 | 产出 | 唯一事实源 |
+|------|---------|------|------|-----------|
+| change（默认） | workflow-start（exploring→specifying） | 五项检查 | `changes/<name>/architecture/` 三件套 + sql/ | 产品级快照（BC 边界/聚合注册表），只引用不重定义 |
+| product | workflow-orchestrator S3.5（ARCH 阶段） | 8 步全系统结构级设计（无五项检查） | `docs/architecture/iterations/vN/architecture.md`（6 产物） | 本快照是产品级唯一事实源 |
+
+**product 模式**：按 `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：只写快照不写全局。
+
 ## Inputs
 
 | Parameter | Description |
 |-----------|-------------|
-| `change_brief_path` | change-brief.md 路径（scope / AC / 技术方向） |
+| `mode` | `change`（默认，workflow-start 五项检查）\| `product`（v0.36.0，S3.5 产品级架构设计） |
+| `change_brief_path` | change-brief.md 路径（scope / AC / 技术方向；change 模式必填） |
 | `plan_path` | prd/vN/plan.md 路径（高阶技术设计段） |
+| `snapshot_path` | docs/architecture/iterations/vN/architecture.md（产品级快照；change 模式主输入，product 模式产出目标） |
 | `specs_dir` | changes/<name>/specs/ 路径（现有规格，如有） |
 | `global_arch_dir` | docs/architecture/ 路径（As-Is 基线） |
 
-If change_brief_path is missing or unreadable, report `decision: skipped` with reason `INPUT_ERROR: change-brief missing`.
+If change_brief_path is missing or unreadable **in change mode**, report `decision: skipped` with reason `INPUT_ERROR: change-brief missing`. In product mode change_brief_path is optional（产品级设计发生在 change 存在之前）; 缺少时正常执行 8 步设计。
 
 ## Five-Check Gate (Architecture Change Determination)
 
@@ -44,7 +55,7 @@ Check the following five items in order. **All negative** → `decision: skipped
 
 ## Output Directory
 
-Architecture deliverables go in the change directory's `architecture/` subdirectory:
+**change 模式**（默认）：架构产出在 change 目录的 `architecture/` 子目录：
 
 ```
 changes/<name>/
@@ -57,11 +68,14 @@ changes/<name>/
         └── migration/           # Incremental migration scripts
 ```
 
+**product 模式**（v0.36.0）：产出在 `docs/architecture/iterations/vN/architecture.md`（6 产物：Context Map / 聚合注册表 / 指令事件 / 状态机 / 概念 ER / 时序），`snapshot_status: in-flight`，provenance 标注。**不写全局**（P1：预测态不进实际态）。
+
 ## Structured Output Contract
 
 Return the following YAML to the orchestration layer:
 
 ```yaml
+# change 模式
 decision: required | skipped
 reason: "..."                    # skipped: why no architecture changes
                                  # required: summary of architecture changes
@@ -71,6 +85,12 @@ artifacts:                       # required: list of produced files, skipped: em
   - architecture/api.md
   - architecture/sql/ddl/...
   - architecture/sql/migration/...
+
+# product 模式（v0.36.0）
+decision: completed | skipped    # completed: 8 步设计完成；skipped: 迭代无结构性变更（须物化 SKIPPED 标记）
+reason: "..."
+snapshot_path: docs/architecture/iterations/vN/architecture.md
+verdict: pending_review          # 评审门（architecture-reviewer product 视角）在产出后进行
 ```
 
 ## api.md Positioning — Architecture Routing Table
@@ -92,7 +112,7 @@ artifacts:                       # required: list of produced files, skipped: em
 
 **DON'T:**
 - Skip the five-check gate and jump to design
-- Load `baseline.md` or uninvolved domain sections (Skill defines what to load)
+- Load `baseline.md`（change 模式遵循 Skill 加载协议；**product 模式**须读 baseline.md + CONCEPTS.md 作输入，见 s3.5-product-architecture.md）
 - Embed SQL in markdown code blocks (use sql/ directory)
 - Produce api.md with Swagger-level detail (that's Swagger's job)
 - Produce artifacts when decision is `skipped`

package/agents/architecture-reviewer.md

@@ -11,7 +11,7 @@ You are an independent Architecture Consistency Reviewer. You check whether arch
 
 ## The Iron Law
 
-You are an independent reviewer. You did NOT participate in producing the architecture design. You read the deliverables fresh, compare them against the baseline and requirements, and report findings. You must NEVER write, edit, create, or delete any file. Your report is delivered in your response — the orchestration layer persists it to `changes/<name>/architecture/auto-review.md`.
+You are an independent reviewer. You did NOT participate in producing the architecture design. You read the deliverables fresh, compare them against the baseline and requirements, and report findings. You must NEVER write, edit, create, or delete any file. Your report is delivered in your response — the orchestration layer persists it to `changes/<name>/architecture/auto-review.md`（change 模式）或 `docs/architecture/iterations/vN/auto-review.md`（product 模式，v0.36.0）.
 
 ## Inputs
 
@@ -23,20 +23,24 @@ You are an independent reviewer. You did NOT participate in producing the archit
 | `architecture_dir` | 架构产出目录（e.g., `changes/<name>/architecture/`） |
 | `global_arch_dir` | 全局架构目录（e.g., `docs/architecture/`） |
 | `conventions_config` | conventions 配置（从 team-flow.config.json 读取的路径映射） |
-| `review_mode` | `change`（默认，审查 `changes/<name>/architecture/` 三件套）\| `product`（v0.35.0，审查 `docs/architecture/iterations/vN/architecture.md` 产品级快照） |
+| `review_mode` | `change`（默认，审查 `changes/<name>/architecture/` 三件套）\| `product`（v0.36.0，审查 `docs/architecture/iterations/vN/architecture.md` 产品级快照） |
+| `product_snapshot_path` | docs/architecture/iterations/vN/architecture.md（product 模式审查对象；v0.36.2 起 dispatch 传入） |
 
-If change_brief_path or architecture_dir is missing or unreadable, report `FAIL` with reason `INPUT_ERROR`.
+If change_brief_path or architecture_dir is missing or unreadable **in change mode**, report `FAIL` with reason `INPUT_ERROR`. In product mode，`change_brief_path` 可选（A4 对照源是 PRD 非 change-brief），审查对象是 `product_snapshot_path`；`product_snapshot_path` 缺失 → FAIL `INPUT_ERROR`。
 
-## Product Mode（v0.35.0，v0.14 §60.5）
+## Product Mode（v0.36.0，v0.14 §60.5）
 
 `review_mode: product` 时（S3.5 产品级评审门），审查对象与维度适配变化：
 
-- **审查对象**：`docs/architecture/iterations/vN/architecture.md`（6 产物：Context Map / 聚合注册表 / 指令事件 / 状态机 / 概念 ER / 时序）+ `domains/` 按域详细页；**不审查** change 内三件套。
-- **A1**：6 产物章节存在 + marker 成对 + anchor id 可解析（机械预检）。
+- **审查对象**：`product_snapshot_path`（`docs/architecture/iterations/vN/architecture.md`，6 产物：Context Map / 聚合注册表 / 指令事件 / 状态机 / 概念 ER / 时序）+ `domains/` 按域详细页；**不审查** change 内三件套。
+- **A1**：6 产物章节存在 + marker 成对 + anchor id 可解析（机械预检）；**不执行** change 模式的 `test -f architecture/{architecture,database,api}.md`。
+- **A2**：SQL/结构有效（若快照含 sql/ 引用；机械 grep）。
+- **A3**：对照 `references/s3.5-architecture-template.md`（产品级模板），非 `templates/architecture.md`（变更级模板）。
 - **A4**：对照 PRD 功能清单（F001_P0 逐条）→ BC/聚合/API 全覆盖映射；对照源是 PRD（非 change-brief——change-brief 是变更级输入）。
 - **A5**：旧项目逆向重建场景对照现状代码/全局基线；正向设计场景仅检查与既有基线无矛盾。
 - **A6**：conventions 合规（同 change 模式）。
 - **skip 处理**：S3.5 显式跳过（`iterations/vN/SKIPPED` 标记）时本 agent 不执行。
+- **报告落盘**：product 模式评审报告落盘 `docs/architecture/iterations/vN/auto-review.md`（非 `changes/<name>/architecture/auto-review.md`——product 模式无 change 目录）。
 
 ## 6-Dimension Checklist
 
@@ -103,6 +107,7 @@ Dimensions requiring semantic understanding, marked as "advisory, false positive
    - Read global `ARCHITECTURE.md` → check naming conventions, BC boundaries
    - Read global `PHYSICAL-MODEL.md` → check table naming patterns, field conventions
    - Read global `API-INDEX.md` → check API routing patterns
+   - Read product snapshot `docs/architecture/iterations/<vN>/architecture.md`（若存在，v0.36.0）→ 对照产品级 BC 边界/聚合注册表（变更级增量不得与产品级决策矛盾）
    - Compare incremental design against baseline:
      - Aggregate naming conflicts with existing aggregates → Critical
      - Table naming conflicts with PHYSICAL-MODEL → Critical

package/agents/cross-change-consistency-checker.md

@@ -20,6 +20,7 @@ You are a read-only checker. You did NOT implement any change. You read all chan
 |-----------|-------------|
 | `change_dirs[]` | 多个 change 目录路径（e.g., `changes/change-1/`, `changes/change-2/`） |
 | `arch_path` | 全局架构目录（e.g., `docs/architecture/`，含 ARCHITECTURE.md / DATABASE.md） |
+| `product_snapshot_path` | 产品级架构快照 `docs/architecture/iterations/vN/architecture.md`（v0.36.3；聚合注册表唯一事实源，若存在） |
 | `prototype_path` | 全局原型目录（e.g., `prototype/`） |
 
 If `change_dirs` has fewer than 2 entries, Dim 1/2 are skipped (single change has no cross-change conflict). If `arch_path` or `prototype_path` is missing, the corresponding dimension is skipped with a note.
@@ -81,7 +82,7 @@ Use `grep` to search for API references across change specs and design docs.
 1. **Enumerate changes**: read each change directory's spec/design/tasks files
 2. **Dim 1**: Extract modified domain files per change, build mutation map, identify overlaps
 3. **Dim 2**: Extract API surface changes per change, cross-reference dependencies
-4. **Dim 3**: Read architecture anchors, compare each change against them
+4. **Dim 3**: Read architecture anchors **+ 产品级快照聚合注册表**（`product_snapshot_path`，v0.36.3——聚合注册表是唯一事实源，跨 change 冲突检测以它为准），compare each change against them
 5. **Dim 4**: Scan prototype testids, compare against change implementations
 6. **Aggregate**: collect all findings, grade by severity, produce report
 

package/docs/README_en.md

@@ -126,7 +126,7 @@ npm install -g team-flow
 
 ### Version
 
-- Current: `v0.36.1`
+- Current: `v0.36.3`
 - v0.9.1 highlights: DP-4 execution-mode recommendations, a portable runtime across 17 platforms, and a raw-package smoke with no plugin-root variable.
 - Self-contained — no OpenSpec or Superpowers runtime required
 - Upstream: [Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec), [obra/superpowers](https://github.com/obra/superpowers)

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
   "description": "Unified workflow plugin: team-flow (spec-driven dev) + compound-engineering core subset + architecture-design (4A/DDD) + prototype (local HTML). 24 skills, one install.",
-  "version": "0.36.1",
+  "version": "0.36.3",
   "contextFileName": "GEMINI.md"
 }

package/hooks/pre-tool-use-guard

@@ -142,6 +142,21 @@ if [ -n "$file_path" ] && [ "${file_path##*/}" != ".team-flow.yaml" ]; then
   esac
 fi
 
+# --- v0.36.3 (§7.3): product-level architecture dir exemption ---------------
+# ARCH 阶段（S3.5）写 docs/architecture/iterations/ 快照、SKIPPED 标记、
+# .team-flow/ 产品级状态（orchestrator.yaml）是合法非 build 态写入。
+# .team-flow.yaml（change 状态）不在豁免内（state 禁写红线保留）。
+if [ -n "$file_path" ]; then
+  case "$file_path" in
+    */docs/architecture/iterations/*) allow ;;
+    */.team-flow/*) allow ;;
+  esac
+  case "${file_path#/private}" in
+    */docs/architecture/iterations/*) allow ;;
+    */.team-flow/*) allow ;;
+  esac
+fi
+
 # --- decision --------------------------------------------------------------
 case "$state" in
   approved-for-build|executing|debugging)

package/hooks/session-start

@@ -1,11 +1,11 @@
 #!/usr/bin/env bash
-# v0.36.1: auto-sync CLI version with plugin version
+# v0.36.3: auto-sync CLI version with plugin version
 set -e
 
 # ═══════════════════════════════════════════════════════════════
 # Plugin version (update this when releasing new versions)
 # ═══════════════════════════════════════════════════════════════
-PLUGIN_VERSION="0.36.1"
+PLUGIN_VERSION="0.36.3"
 
 # ═══════════════════════════════════════════════════════════════
 # Step 1: Auto-sync CLI version with plugin version

package/llms.txt

@@ -3,7 +3,7 @@
 ## Overview
 spec-superflow is a self-contained workflow integration plugin for Claude Code, Cursor, OpenAI Codex CLI/App, GitHub Copilot CLI, Gemini CLI, OpenCode, WorkBuddy, and Trae. It merges spec-driven planning artifacts (proposal, specs, design, tasks) with disciplined execution guardrails (TDD, review gates, controlled handoff) into one unified workflow.
 
-Current version: v0.36.1.
+Current version: v0.36.3.
 
 ## Key Documents
 - README.md: Chinese homepage with full usage guide and FAQ

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xulthekl/team-flow",
-  "version": "0.36.1",
+  "version": "0.36.3",
   "description": "Unified plugin (24 skills + 15 agents) integrating team-flow, compound-engineering, architecture-design, prototype, design-system, workflow-orchestrator, workflow-bootstrap, e2e, session-handoff, workflow-feedback for multi-agent coding tools.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "version": "0.36.1",
+  "version": "0.36.3",
   "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking). 24 skills + 15 agents, one install.",
   "author": {
     "name": "LT"

package/scripts/guard/checks/arch-gate-exemptions.mjs

@@ -39,30 +39,45 @@ export function isLegacyArch(state) {
   return state?.arch_baseline == null;
 }
 
-/** 项目级显式 skip 是否已物化（iterations/vN/SKIPPED 标记存在）。 */
-export function isArchSkipMaterialized(root) {
+/** 列出所有迭代目录（数字排序，v10 正确处理——字典序 v10 < v2 会取错最新）。 */
+export function listIterationDirs(root) {
   const iterationsDir = root && path.join(root, 'docs', 'architecture', 'iterations');
-  if (!iterationsDir || !fs.existsSync(iterationsDir)) return false;
+  if (!iterationsDir || !fs.existsSync(iterationsDir)) return [];
   return fs.readdirSync(iterationsDir, { withFileTypes: true })
     .filter(d => d.isDirectory())
-    .some(d => fs.existsSync(path.join(iterationsDir, d.name, 'SKIPPED')));
+    .map(d => d.name)
+    .sort((a, b) => {
+      const na = parseInt(a.replace(/\D/g, ''), 10) || 0;
+      const nb = parseInt(b.replace(/\D/g, ''), 10) || 0;
+      return na - nb;
+    });
+}
+
+/** 最新迭代目录路径（数字排序后最后）。无迭代 → null。 */
+export function findLatestIterationDir(root) {
+  const dirs = listIterationDirs(root);
+  if (dirs.length === 0) return null;
+  return path.join(root, 'docs', 'architecture', 'iterations', dirs[dirs.length - 1]);
+}
+
+/**
+ * skip 物化检查：只认最新迭代目录的 SKIPPED（v0.36.3 修复——防旧迭代陈旧标记
+ * 错误豁免新迭代的结构性变更，P3 原则要防的失效模式）。
+ */
+export function isArchSkipMaterialized(root) {
+  const latest = findLatestIterationDir(root);
+  if (!latest) return false;
+  return fs.existsSync(path.join(latest, 'SKIPPED'));
 }
 
 /** 最近一个迭代的产品级架构快照路径（iterations/<latest>/architecture.md）。不存在 → null。 */
 export function findLatestIterationSnapshot(root) {
-  const iterationsDir = root && path.join(root, 'docs', 'architecture', 'iterations');
-  if (!iterationsDir || !fs.existsSync(iterationsDir)) return null;
-  const dirs = fs.readdirSync(iterationsDir, { withFileTypes: true })
-    .filter(d => d.isDirectory())
-    .map(d => d.name)
-    .sort();
-  for (let i = dirs.length - 1; i >= 0; i--) {
-    const snap = path.join(iterationsDir, dirs[i], 'architecture.md');
-    if (fs.existsSync(snap)) return snap;
-  }
-  return null;
+  const latest = findLatestIterationDir(root);
+  if (!latest) return null;
+  const snap = path.join(latest, 'architecture.md');
+  return fs.existsSync(snap) ? snap : null;
 }
 
 export const ARCH_READINESS_FAIL_HINT =
-  'iterations/vN/architecture.md missing — 回 ARCH 阶段补快照，'
-  + '或显式 skip 物化（iterations/vN/<vN>/SKIPPED 标记 + 理由）';
+  'iterations/<vN>/architecture.md missing — 回 ARCH 阶段补快照，'
+  + '或显式 skip 物化（iterations/<vN>/SKIPPED 标记 + 理由）';

package/scripts/guard/checks/arch-snapshot.mjs

@@ -31,5 +31,12 @@ export function checkArchSnapshot(changeDir) {
   const snap = findLatestIterationSnapshot(root);
   if (snap) return { pass: true, failures: [] };
 
+  // v0.36.3 §63.4 在途 change 兜底：快照缺失但 change 已有增量产物 → 以 change 产物为实际态（存量升级场景）
+  const archDir = join(changeDir, 'architecture');
+  if (existsSync(archDir) && existsSync(join(archDir, 'architecture.md'))) {
+    console.warn('  [WARN] arch-snapshot: 产品级快照缺失，以 change 增量产物兜底（存量升级在途 change，快照后补为 v0）');
+    return { pass: true, failures: [] };
+  }
+
   return { pass: false, failures: [ARCH_READINESS_FAIL_HINT] };
 }

package/scripts/lib/arch-merge.mjs

@@ -120,9 +120,10 @@ function buildCurrentStateSection(aggregates, changeName) {
     lines.push(`| ${bc} | ${aggs.length} |`);
   }
   lines.push('', '### 聚合注册表');
-  lines.push('| 聚合ID | 上下文 | 根实体 | 来源 | 关键不变量 |', '|--------|--------|--------|------|-----------|');
+  // v0.36.3 §62.1 首轮特例：全局聚合全部来自已合并 change（=已落地态）；状态列标注
+  lines.push('| 聚合ID | 上下文 | 根实体 | 来源 | 状态 | 关键不变量 |', '|--------|--------|--------|------|------|-----------|');
   for (const a of aggregates) {
-    lines.push(`| ${a.id} | ${a.context} | ${a.root} | change:${changeName} | ${a.invariants || '—'} |`);
+    lines.push(`| ${a.id} | ${a.context} | ${a.root} | change:${changeName} | 已落地 | ${a.invariants || '—'} |`);
   }
   return lines.join('\n');
 }
@@ -224,10 +225,19 @@ function generateDatabase(globalArchDir, schemaPath) {
   return { generated: true, file: 'DATABASE.md', tables: tables.length };
 }
 
+/** v0.36.3 §62.4：判断 change 是否已关闭（读 .team-flow.yaml state）。 */
+function isChangeClosed(changeRoot) {
+  const stateFile = join(changeRoot, '.team-flow.yaml');
+  if (!existsSync(stateFile)) return false;
+  const m = readFileSync(stateFile, 'utf-8').match(/^state:\s*(.*)$/m);
+  const state = m ? m[1].trim() : '';
+  return state === 'closed' || state === 'closing';
+}
+
 /**
  * Step 6: API-INDEX.md 生成式（api-scan 核心）。
  * 扫描项目根下所有已关闭 change 的 architecture/api.md + domains/，归一化端点重建。
- * 保护：重建结果为空 → 拒绝覆盖（防历史手工端点被抹）。
+ * 保护：①重建结果为空 → 拒绝覆盖（防历史手工端点被抹）；②只扫已关闭 change（v0.36.3，在途半成品端点不得入全局）。
  */
 function generateApiIndex(projectRoot, globalArchDir, changeName) {
   const changesDir = join(projectRoot, 'changes');
@@ -237,7 +247,9 @@ function generateApiIndex(projectRoot, globalArchDir, changeName) {
   const endpoints = [];
   if (existsSync(changesDir)) {
     for (const changeDirName of readdirSync(changesDir)) {
-      const apiPath = join(changesDir, changeDirName, 'architecture', 'api.md');
+      const changeRoot = join(changesDir, changeDirName);
+      if (!isChangeClosed(changeRoot)) continue; // v0.36.3：只扫已关闭 change
+      const apiPath = join(changeRoot, 'architecture', 'api.md');
       if (!existsSync(apiPath)) continue;
       const ep = extractEndpoints(readFileSync(apiPath, 'utf-8'));
       for (const e of ep) endpoints.push({ ...e, source: changeDirName });
@@ -378,14 +390,17 @@ function preCheck(changeDir, archDir, projectRoot) {
 /* ============ Step 5: 变更脚本归档（保留） ============ */
 
 function archiveChangeScripts(changeDir, archDir, globalArchDir, changeName) {
-  const report = { ddl: 0, migration: 0 };
+  const report = { ddl: 0, migration: 0, files: [] };
   for (const subDir of ['ddl', 'migration']) {
     const srcDir = join(archDir, 'sql', subDir);
     const dstDir = join(globalArchDir, 'changelog', subDir);
     if (!existsSync(srcDir)) continue;
     if (!existsSync(dstDir)) makeDir(dstDir);
     const files = readdirSync(srcDir).filter(f => f.endsWith('.sql'));
-    for (const f of files) copyFile(join(srcDir, f), join(dstDir, f));
+    for (const f of files) {
+      copyFile(join(srcDir, f), join(dstDir, f));
+      report.files.push(join(dstDir, f)); // v0.36.3：changelog 文件入白名单（防自我制造脏文件告警）
+    }
     report[subDir] += files.length;
   }
   return report;
@@ -513,6 +528,7 @@ export function run(args = {}) {
       join(globalArchDir, 'schema-baseline.sql'),
       join(globalArchDir, 'API-INDEX.md'),
       join(globalArchDir, 'INDEX.md'),
+      ...(archiveResult.files || []),  // v0.36.3：changelog/ 复制文件入白名单
     ].filter(p => existsSync(p));
     const dirty = detectUntouchedDirtyFiles(globalArchDir, touchedFiles);
     if (dirty.length > 0) {

package/scripts/lib/cmd-doctor.mjs

@@ -299,6 +299,32 @@ function checkChangeTestGates(root) {
   return { pass: true, message: `${checked} change(s) pass test-gate hygiene (skip reasons + artifact references)` };
 }
 
+// v0.36.3 建议项：arch-state / iterations 一致性体检
+// 1. arch_baseline 已打戳但 iterations/ 无任何产品级快照 → arch 门禁将 FAIL（需回 ARCH 补快照）
+// 2. SKIPPED 与快照并存 → 语义矛盾
+function checkArchState(root) {
+  const warnings = [];
+  const archStatePath = join(root, '.team-flow', 'arch-state.json');
+  const iterationsDir = join(root, 'docs', 'architecture', 'iterations');
+  if (existsSync(archStatePath)) {
+    const hasSnapshot = existsSync(iterationsDir)
+      && readdirSync(iterationsDir, { withFileTypes: true })
+        .filter(d => d.isDirectory())
+        .some(d => existsSync(join(iterationsDir, d.name, 'architecture.md')));
+    if (!hasSnapshot) {
+      warnings.push('arch_baseline 已打戳但 iterations/ 无产品级快照——arch-readiness/arch-snapshot 门禁将 FAIL，需回 ARCH 阶段补快照');
+    }
+  }
+  if (existsSync(iterationsDir)) {
+    for (const d of readdirSync(iterationsDir, { withFileTypes: true }).filter(x => x.isDirectory())) {
+      const hasSkip = existsSync(join(iterationsDir, d.name, 'SKIPPED'));
+      const hasSnap = existsSync(join(iterationsDir, d.name, 'architecture.md'));
+      if (hasSkip && hasSnap) warnings.push(`${d}: SKIPPED 与快照并存，语义矛盾`);
+    }
+  }
+  return { pass: warnings.length === 0, message: warnings.length ? warnings.join('; ') : 'arch-state/iterations 一致' };
+}
+
 export async function run(args) {
   const root = process.cwd();
   const config = loadConfig(root);
@@ -317,6 +343,7 @@ export async function run(args) {
     ['Docs', checkDocs(root)],
     ['Change states', checkChangeStates(root)],
     ['Change test gates', checkChangeTestGates(root)],
+  ['Arch state', checkArchState(root)],
   ];
 
   // Config check

package/scripts/lib/solutions-capture.mjs

@@ -14,7 +14,7 @@
 import { readFileSync, writeFileSync, existsSync, mkdirSync, appendFileSync } from 'node:fs';
 import { join } from 'node:path';
 
-const PHASES = ['prd', 'plan', 'prototype', 'spec', 'build', 'review', 'cross-phase'];
+const PHASES = ['prd', 'plan', 'architecture', 'prototype', 'spec', 'build', 'review', 'cross-phase'];
 const MAX_INDEX_LINES = 150;
 
 function slugify(text) {

package/skills/architecture-design/SKILL.md

@@ -90,6 +90,16 @@ description: 基于 4A 企业架构 + DDD 领域驱动设计的架构/API/DB 设
 
 变更级聚合动作限三类：`extend`（既有聚合加字段/指令/事件/状态）、`new`（新增聚合，flag 登记待产品级晋升）、`refactor`（需决策门）。聚合 id 一律引用产品级注册表，不重定义（防重发明，v0.14 §61.3）。
 
+### 架构修订决策门（v0.36.3 定义，v0.14 §61.3/§61.4）
+
+**触发**：change 级设计触及产品级决策（BC 边界变更 / 聚合所有权变更 / 全局契约变更），或 arch-merge 冲突预检阻断聚合重定义。
+
+**流程**（不硬阻断，显式确认 + 登记 deviation）：
+1. **呈现变更摘要**：涉及的产品级决策 + 影响范围（引用快照章节）
+2. **用户确认**（阻塞问题工具）：接受 → 执行变更；拒绝 → 保持产品级定义，change 内走增量
+3. **登记 deviation**：确认后写入 `orchestrator.yaml` 的 `replan_log`（`seq/trigger: arch-deviation/before/after/approved_by`）+ 在 `iterations/vN/architecture.md` 演进日志追加修订记录（迭代收尾 S3.5 确认晋升）
+4. **`new` 聚合 flag**：在 `iterations/vN/architecture.md` 聚合注册表标注 `[pending-promotion]`，待下一迭代产品级晋升
+
 ### 执行流程
 
 ```
@@ -182,6 +192,10 @@ architecture-design 执行时的上下文组装：
 3. 读取匹配的 `.team-flow/conventions/*.md` 文件
 4. 注入为架构决策约束（advisory 级）
 
+**架构复利注入（v0.36.3，复利链路修复）**：
+1. 执行 `tf solutions inject --phase architecture`（失败静默）——注入 `docs/solutions/` 中 phase=architecture 的历史架构决策经验（BC 边界取舍/聚合划分理由/事件投影设计踩坑）
+2. 读取失败 / 无条目 → 静默跳过，不阻断（advisory 级，与 S1 复利注入同语义）
+
 **始终加载**：
 1. `Read docs/architecture/INDEX.md`（~50行摘要）
 2. `Read changes/<name>/change-brief.md`（如有）

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

@@ -38,14 +38,14 @@ changes/<name>/              # change 容器
 
 ## 复利回写（借鉴 ce-compound，已正名）
 - **one change per run**：一次回写一个变更 delta，可追溯、不混杂。
-- 全局 ARCHITECTURE.md 维护双视图：`## 当前态`（覆盖式，每 BC/聚合仅留最新有效定义）+ `## 演进日志`（append-only，含 change_id+来源）。
+- 全局 ARCHITECTURE.md 维护双视图（v0.36.0 实现为 marker 区 + 演进日志）：`<!-- arch:current-state:begin/end -->` marker 区（覆盖式，arch-merge 代码独占写 + 成对校验，每 BC/聚合仅留最新有效定义）+ `## 演进日志`（changeName 去重，替代原 append-only 重复标题）。
 - **架构一致性/漂移检查**（独立于 Discoverability）：①结构冲突（重复 BC/聚合 key）②语义冲突（同义异名，如客户vs用户）③跨域一致性门禁（AA≥1 IA 实体，反之亦然）。
 - **Discoverability 正名**：在 AGENTS.md/CLAUDE.md 暴露 `docs/architecture/`，使代理设计前"发现并查阅"（存在/结构/何时检索）——这是 compound 原义，勿与内容冲突检查混淆。
 - 下游检索复用：下一 change 设计前从 `docs/architecture/` 检索相关上下文/聚合（grounding 用 CONCEPTS.md）。
 
 ## 集成纪律（来自 team-flow 源码事实）
 - **design.md 不可变**：原型覆盖层 never mutate design.md/tasks.md。原型结论走 `handoff --type prototype` → 新 requirement delta → 正常 `specifying→closing→spec-merger` 闭环，不得直接改 design.md。
-- **guard 软集成**：三份增量文档为推荐产出、非阻断；全局回写经独立 `arch-compound` skill/overlay，不进状态机硬矩阵；frontmatter 校验仅 advisory 脚本（正则提取 key，不引第三方 YAML 依赖），保全零依赖。
+- **guard 软集成**：三份增量文档为推荐产出、非阻断；全局回写经 `tf arch-merge` 命令（v0.36.0 重构：当前态幂等 upsert + 生成式 PHYSICAL-MODEL/DATABASE/API-INDEX + 冲突预检 + 并发安全，原 arch-compound skill/overlay 概念已由该命令承接）；frontmatter 校验仅 advisory 脚本（正则提取 key，不引第三方 YAML 依赖），保全零依赖。
 - **术语正名**：IA/AA 非"技术架构"（仅 TA 是）；4A 是四域非三层；技术架构对 STRATEGY.md 是"补位 compound 缺位"而非"修正其错误"，且 ARCHITECTURE.md 是 anchor 而非评审巨著。
 
 ## 第二大脑整合（ima「LT的知识库」）

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

@@ -142,7 +142,7 @@ flowchart LR
 | v1 | <date> | 初始设计 |
 
 <!-- arch:current-state:begin -->
-<!-- 此 marker 区由 arch-merge 代码独占写（迭代收尾/change 合并时覆盖），禁止手改 -->
+<!-- 此 marker 区是 arch-merge 全局覆盖写机制的模板约定（v0.36.0）；快照本身不被 arch-merge 写（P1：预测态不进实际态），迭代收尾由 S5 标 snapshot_status=archived -->
 <!-- arch:current-state:end -->
 ````
 

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

@@ -35,6 +35,6 @@
 
 ## 与既有加载协议的关系
 
-- 本协议**扩展** architecture-design SKILL.md「上下文加载协议」（:166-183），不替代。
+- 本协议**扩展** architecture-design SKILL.md「上下文加载协议」，不替代（引用标题而非行号，防漂移）。
 - 变更级 architecture-design 的输入 = 本协议 ① + ②（产品级）+ ③（变更增量）；语义层（五项检查判定、评审）仍走既有流程。
 - S3.5 产品级评审门（architecture-reviewer product 视角 A1-A6）验证产物结构满足本协议（A1 结构完备 + A2 marker/锚点可解析），保证下游可按域加载。

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

@@ -31,6 +31,8 @@
 
 **顺序纪律**：聚合在前、ER 在后（ER 是派生产物，禁止先画 ER 再定聚合）；BC 边界/聚合所有权/全局契约是**产品级唯一事实源**（聚合注册表），变更级只引用。
 
+**按域详细页产出（v0.36.3，domains/ 生产者）**：Step 1 识别 BC 后、Step 2-6 每个触及域细化时，同步产出 `domains/<bc>.md`（职责/聚合明细/指令事件/状态迁移/ER 局部/时序/对外契约）与 `diagrams/`（erd/sequences）——它们是按域分段加载（`s3.5-loading-protocol.md` 第②段）与 reviewer product A1 的审查对象；单文件 ≤1500 token。
+
 **模板**：按 `references/s3.5-architecture-template.md` 骨架产出（6 产物 + 厚锚点 + marker + provenance）。
 
 ## 产品级评审门（Step 8）
@@ -49,6 +51,15 @@
 规则：≤3 轮修复循环 + 收敛检测（连续两轮不一致项不缩小 → 转人工）；PASS 才进 S4。
 **skip 时**：architecture-reviewer 不执行，但 skip 必须物化（iterations/vN/SKIPPED 标记 + 理由）。
 
+### 复利捕获（Step 9，v0.36.3 复利链路修复）
+
+评审 PASS 后，捕获本次架构设计产生的可复用决策经验（advisory 级，捕获失败不阻断）：
+
+- **触发场景**：BC 边界取舍、聚合划分理由、事件/读模型投影设计模式、技术选型决策、逆向重建低置信度修正
+- **命令**：`tf solutions capture --phase architecture --domain <触及BC> --type pitfall|pattern --severity medium --summary "<经验>"`（source: `iterations/vN/architecture.md`）
+- **注入端**：后续架构设计（变更级/产品级）执行时 `tf solutions inject --phase architecture` 自动注入这些经验（architecture-design 加载协议，v0.36.3）
+- **晋升说明**：产品级架构经验直接 capture 写 `docs/solutions/`（不走 change 级 promote——promote 只认 `learnings.md`，是变更级机制）
+
 ## 正向设计 vs 逆向重建
 
 | 维度 | 正向设计（全新/已建档） | 逆向重建（旧项目首轮） |
@@ -59,7 +70,7 @@
 | 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）。
+逆向重建工具：`workflow-bootstrap` 的 recon-probe.sh（--ddl-out，路径 `${CLAUDE_PLUGIN_ROOT}/skills/workflow-bootstrap/scripts/recon-probe.sh`）+ codebase-recon-analyst + 新增 `arch-reverse-analyst`（v0.14 §63.2）。
 
 ## 完成条件
 
@@ -67,6 +78,7 @@
 - 产品级评审门 verdict = PASS（或 skip 已物化）
 - orchestrator.yaml 中 ARCH 阶段状态 = completed（workflow_phase: architecture）
 - **未触发** arch-merge 全局覆盖写（预测态不进实际态，P1）
+- **架构基线打戳（v0.36.3）**：首轮项目（`arch_baseline` 缺失）评审 PASS 后执行 `tf arch init --mode reconstruction --baseline-ref prd/vN/`（旧项目逆向重建）或 `--mode design`（全新项目正向设计）——arch-readiness/arch-snapshot 门禁的豁免键在此建立，项目进入「已建档」正轨
 
 ## 常见陷阱
 

package/skills/ce-compound/references/v0.5-upgrade.md

@@ -20,6 +20,9 @@ ce-compound 从"手动触发的记录工具"升级为"复利贯穿引擎的执
 - change 执行中超出原始 scope（phase=build, type=pitfall）
 - re-bridge 触发（phase=spec, type=pitfall）
 - mandatory rewind 触发（phase=cross-phase, type=pitfall）
+- 架构评审 FAIL 反复修正（phase=architecture, type=pitfall，v0.36.3 新增）
+- 架构修订决策门触发（phase=architecture, type=pattern，v0.36.3 新增）
+- 逆向重建低置信度决策（phase=architecture, type=pattern，v0.36.3 新增）
 
 ## 被流程自动调用
 

package/skills/release-archivist/SKILL.md

@@ -125,6 +125,8 @@ If implementation diverged from the contract, return to `bridging` before closur
 
 Run `tf state transition <change-dir> closing`. If delta specs exist, route to `spec-merger`.
 
+**架构快照门禁（arch-snapshot，v0.36.0 / v0.36.3）**：`executing→closing` 挂 `arch-snapshot` 维度——本轮迭代产品级架构快照 `iterations/vN/architecture.md` 必须已落盘（"先快照后回写"强制化）。**FAIL 升级路径**：回 orchestrator 的 ARCH 阶段补快照；存量升级在途 change（快照缺失但 change 有增量产物）→ WARN 兜底放行；`arch_baseline` 缺失 → WARN 不阻断。hotfix/tweak 豁免（不挂该维度）。判定逻辑见 `scripts/guard/checks/arch-gate-exemptions.mjs`。
+
 ### Architecture Merge (v0.10 §28-§31) — MUST run first
 
 Merge change-level architecture artifacts to the global `docs/architecture/` baseline **before** any other post-verification step:

package/skills/workflow-bootstrap/SKILL.md

@@ -56,7 +56,7 @@ Do NOT invoke for:
 > **硬原则**：主代理只编排（派发 + 汇总 + 写 baseline.md），侦察执行下沉子代理（§18.1 交接协议）。先跑确定性脚本固定化采集基底，再派子代理做语义增强——**可复现、可横展对比**。
 
 - **模式**（询问用户）：Quick（默认，技术栈+模块+架构模式+测试文档，~2 分钟）/ Deep（+数据模型+API 表面，~10 分钟）。
-- **B1.1 脚本采集**：`bash scripts/recon-probe.sh --root <根> --out /tmp/recon-<slug>.json`（固定化，两次接入结果一致）。
+- **B1.1 脚本采集**：`bash ${CLAUDE_PLUGIN_ROOT}/skills/workflow-bootstrap/scripts/recon-probe.sh --root <根> --out /tmp/recon-<slug>.json`（固定化，两次接入结果一致）。
 - **B1.2 并行子代理**：读 `references/agents/codebase-recon-analyst.md`，把 JSON 路径作 `recon_json` 入参，按维度并行派发（§18.1 返回）。
 - **B1.3 主代理汇总**：只汇总不重新侦察，整合已有文档（合并而非覆盖，标注来源），写 `docs/architecture/baseline.md`。
 
@@ -124,7 +124,7 @@ Step 1: 询问用户是否有既有成果物
 
 Step 2: 确定性提取（兜底）
   ├── recon-probe.sh DDL 提取能力（v0.24.0 已实现：SQL 文件 / Java Entity / 占位）
-  │   bash scripts/recon-probe.sh --root <根> --ddl-out docs/architecture/schema-baseline.sql
+  │   bash ${CLAUDE_PLUGIN_ROOT}/skills/workflow-bootstrap/scripts/recon-probe.sh --root <根> --ddl-out docs/architecture/schema-baseline.sql
   ├── 从 schema-baseline.sql 反向生成 PHYSICAL-MODEL.md
   └── 扫描 Controller/Router 类 → 生成 API-INDEX.md
 
@@ -142,8 +142,8 @@ Step 2: 确定性提取（兜底）
 
 **轻量 vs 完整**：
 - bootstrap 产出的是**基线快照**（As-Is 当前态），不是完整的 4A+DDD 设计
-- 完整的架构演进仍走 `/architecture-design` 的标准增量流程
-- 如果用户需要完整架构设计，B2 结束后建议："基线已建立。如需完整架构设计，请运行 `/architecture-design`"
+- 完整的架构演进：既有代码库的**逆向重建**走 workflow-orchestrator 的 ARCH 阶段（S3.5 reconstruction 模式，`arch-reverse-analyst`，v0.36.0）；全新架构设计走 ARCH 正向设计
+- 如果用户需要完整架构设计，B2 结束后建议："基线已建立。如需完整架构设计（逆向重建或正向设计），请进入 workflow-orchestrator 的 ARCH 阶段"（v0.36.3 修正——原指引导向 change 级 skill 已过时）
 
 **已有架构文档处理**：
 - 如果 `docs/architecture/ARCHITECTURE.md` 已存在 → 读取并整合，不覆盖
@@ -190,9 +190,12 @@ Step 2: 确定性提取（兜底）
 询问用户：
 
 > 您希望从哪个需求开始使用 team-flow？
-> - A) 我有一个具体的功能需求（→ 进入 workflow-orchestrator S1）
+> - A) 我有一个具体的功能需求（→ 进入 workflow-orchestrator S1，S3 后进 ARCH 产品级架构设计）
 > - B) 我有一个模糊的产品方向（→ ce-brainstorm）
 > - C) 我只是想建立架构基线，暂不开发新需求（→ 结束）
+> - D) 我想从既有代码逆向重建完整架构（→ 进入 workflow-orchestrator ARCH 阶段 reconstruction 模式，arch-reverse-analyst，v0.36.0；重建 PASS 后 `tf arch init` 打戳）
+
+**逆向重建衔接（v0.36.3）**：ARCH 阶段 reconstruction 模式复用本 bootstrap 的 recon-probe.sh（--ddl-out）+ codebase-recon-analyst，并派发 `arch-reverse-analyst` 补 BC/状态/指令事件维度（见 `references/agents/arch-reverse-analyst.md`）。
 
 **上下文传递**：
 - 将 `docs/architecture/baseline.md` 和 `docs/architecture/CONCEPTS.md` 的路径传递给 workflow-orchestrator S1

package/skills/workflow-bootstrap/references/b1-reconnaissance.md

@@ -10,7 +10,7 @@
 ## B1.1 确定性脚本采集（先跑，固定化探查）
 
 ```bash
-bash scripts/recon-probe.sh --root <项目根> --out /tmp/recon-<slug>.json
+bash ${CLAUDE_PLUGIN_ROOT}/skills/workflow-bootstrap/scripts/recon-probe.sh --root <项目根> --out /tmp/recon-<slug>.json
 ```
 
 固定采集（不依赖 LLM，两次接入结果一致）：目录树（限深 4 层）、依赖清单（pom/package.json/requirements/go.mod/build.gradle）、LOC 与文件类型分布、测试文件计数（含 `.test.mjs`/`.spec.mjs`）、DB 迁移文件清单、README/docs 探测。输出结构化 JSON 供子代理消费。脚本只做确定性机械采集（§17.8 第四类载体），语义判断交给子代理 LLM。
@@ -25,7 +25,7 @@ bash scripts/recon-probe.sh --root <项目根> --out /tmp/recon-<slug>.json
 
 **用法**：
 ```bash
-bash scripts/recon-probe.sh --root <根> --ddl-out docs/architecture/schema-baseline.sql --out /tmp/recon-<slug>.json
+bash ${CLAUDE_PLUGIN_ROOT}/skills/workflow-bootstrap/scripts/recon-probe.sh --root <根> --ddl-out docs/architecture/schema-baseline.sql --out /tmp/recon-<slug>.json
 ```
 
 **JSON 输出字段**：`ddl_extraction.source`（sql_files / java_entity / none）、`ddl_extraction.table_count`、`ddl_extraction.tables[]`、`ddl_extraction.ddl_statements`

package/skills/workflow-orchestrator/SKILL.md

@@ -83,7 +83,7 @@ prd_draft → user_review → prototype_loop → prd_frozen → completed
 
 **评审门**：产出经 architecture-reviewer product 视角（`review_mode: product`，A1-A6）评审，**PASS 才进 S4**。
 
-**输出契约**：`docs/architecture/iterations/vN/architecture.md` + 评审 verdict；`orchestrator.yaml` 中 ARCH phase 状态 = completed（`workflow_phase: architecture`）。
+**输出契约**：`docs/architecture/iterations/vN/architecture.md` + 评审 verdict；`orchestrator.yaml` 中 ARCH phase 状态 = completed（`workflow_phase: architecture`）。**首轮项目（`arch_baseline` 缺失）评审 PASS 后执行 `tf arch init --mode reconstruction|design --baseline-ref prd/vN/` 打戳**（v0.36.3）——arch 门禁豁免键由此建立，项目进入「已建档」正轨。
 
 ### S4: 拆分验证与分发
 

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

@@ -84,6 +84,7 @@ tf state init changes/v1-C2-policy-management
 upstream_source: orchestrator          # orchestrator | manual | null
 upstream_req_id: <req-id>              # 对应 .team-flow/requirements/<req-id>/
 upstream_plan_ref: prd/vN/plan.md      # hotfix/快速通道为 null
+upstream_arch_ref: docs/architecture/iterations/vN/architecture.md  # 产品级架构快照（v0.36.3）；ARCH skip 或 hotfix 为 null
 upstream_change_id: C2                 # 对应 change_dag.id
 plan_hash: sha256:<plan.md 内容摘要>    # 检测产品层改动后变更层未同步
 ---
@@ -99,7 +100,7 @@ plan_hash: sha256:<plan.md 内容摘要>    # 检测产品层改动后变更层
 <取自 auditor 报告 Dim1 覆盖矩阵中映射到本 change 的 AC，逐条列出>
 
 ## 全局技术方向
-<取自 plan.md 高阶技术设计段的要点指针：模块边界/技术选型/数据流方向，供 spec-writer 作 design.md 约束>
+<取自 plan.md 高阶技术设计段的要点指针：模块边界/技术选型/数据流方向，供 spec-writer 作 design.md 约束；**BC 边界/聚合所有权以 `upstream_arch_ref` 产品级快照为准**（v0.36.3），plan.md 仅高阶方向>
 
 ## PRD & plan 引用
 - PRD: prd/vN/prd.md §<相关章节>

package/skills/workflow-orchestrator/references/s5-monitoring.md

@@ -58,4 +58,5 @@ S5 是动态重规划的主要触发点。当检测到需要重新拆分（跨 c
 - 所有 change closed
 - 复利晋升已完成
 - 跨 change 一致性已确认（无未解决冲突）
+- **架构迭代收尾（v0.36.3，快照生命周期）**：本轮迭代 `docs/architecture/iterations/vN/architecture.md` 的 `snapshot_status` 标 `archived`（预测态退役，全局当前态 = 唯一权威，P1）——已建档项目的迭代收尾动作
 - S5 状态 = completed

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

@@ -111,7 +111,7 @@ phases:
 | 门禁 | 挂点 | 校验 | 豁免 |
 |------|------|------|------|
 | 产品级评审门 | ARCH→S4 | architecture-reviewer product 视角 PASS | skip 时仍要物化标记 |
-| arch-readiness | S4 拆分 | iterations/vN/ 快照覆盖 change 触及的 BC | arch_baseline 缺失 → WARN 不 FAIL |
+| arch-readiness | exploring:specifying（guard 存在性）+ S4 拆分（LLM 覆盖校验） | iterations/vN/ 快照覆盖 change 触及的 BC | arch_baseline 缺失 → WARN 不 FAIL |
 | arch-snapshot | executing→closing | 本轮快照已落盘 | 在途 change legacy 豁免 |
 
 ## arch_baseline 豁免键（v0.35.0 新增）

package/skills/workflow-start/SKILL.md

@@ -76,7 +76,7 @@ Guard: `arch_design_decision` in `.team-flow.yaml` is `null` → must run before
 
 > **⛔ 串行约束（v0.30.0）**：四步严格串行。**修复子代理（architecture-design）完成前 MUST NOT dispatch 审查子代理（architecture-reviewer）**——并行会使审查跑在修复之前、误报"全部未修复"FAIL（来源：workflow-feedback 2026-08-01）。并行白名单：仅多个独立 change 的工作可并行；修复→审查、设计→审查必须串行。
 
-1. **Dispatch**: `architecture-design` as sub-agent → returns `decision` + `reason` + `artifacts`。**⛔ 记录子代理 ID**（后续循环修正和 DP-A 调整必须通过此 ID 恢复，禁止启动新子代理）
+1. **Dispatch**: `architecture-design` as sub-agent（**输入含 `docs/architecture/iterations/<vN>/architecture.md` 产品级架构快照**，v0.36.0——变更级只引用产品级聚合注册表，不重定义）→ returns `decision` + `reason` + `artifacts`。**⛔ 记录子代理 ID**（后续循环修正和 DP-A 调整必须通过此 ID 恢复，禁止启动新子代理）
 2. **Auto-review** (decision=required 时触发): 校验产物文件存在且非空 → dispatch `architecture-reviewer` sub-agent（**记录子代理 ID**）→ FAIL 则通过 **SendMessage 恢复原 architecture-design 子代理**修正（≤3 轮 + 收敛检测，不收敛转人工）→ 报告落盘 `changes/<name>/architecture/auto-review.md`
 3. **Reasonableness check + state write**: PASS/PASS_WITH_WARNINGS → write `arch_design_decision` + `arch_review_*` to yaml; skipped + brief 含架构关键词 → BLOCK; required + artifacts 缺失 → BLOCK; required + auto-review FAIL → BLOCK
 4. **DP-A 用户确认门（v0.29.0 §37）**: 输出架构决策摘要 → AskUserQuestion 确认 → 需要调整时**必须通过 SendMessage 恢复原子代理**修改（禁止主代理直接修改，禁止启动新子代理）→ 修改后 SendMessage 恢复原 reviewer 重新 auto-review → 回到本步骤重新确认。含项目规范变更提示（advisory）。详见 `references/routing-rules.md`「Step 4: DP-A」

package/skills/workflow-start/references/routing-rules.md

@@ -9,13 +9,16 @@ Change is fuzzy, scope unclear, comparing options, no stable change name.
 
 Guard: `arch_design_decision` in `.team-flow.yaml` is `null` → must run before spec-writer.
 
+**架构门禁（v0.36.0 / v0.36.3）**：`exploring→specifying` 还挂 `arch-readiness` 维度（产品级架构快照 `iterations/vN/architecture.md` 存在 或 ARCH skip 物化 或 在途兜底）。**FAIL 升级路径**：回 orchestrator 的 ARCH 阶段补快照（或确认 ARCH skip 物化）；`arch_baseline` 缺失（存量项目）→ WARN 不阻断。判定逻辑见 `scripts/guard/checks/arch-gate-exemptions.mjs`。
+
 ### Step 1: Dispatch architecture-design sub-agent
 
 Dispatch `architecture-design` as sub-agent with inputs:
 - `change-brief.md`（scope / AC / 技术方向）
 - `prd/vN/plan.md` 高阶技术设计段
+- `docs/architecture/iterations/<vN>/architecture.md`（**产品级架构快照，主输入**，v0.36.0）——BC 边界/聚合所有权/全局契约唯一事实源；vN 从 change-brief 的 `upstream_plan_ref`（prd/vN/plan.md）推导；变更级只引用不重定义（触及产品级决策 → 架构修订决策门；仅 change 内细节 → 增量设计）
 - existing `specs/`
-- global `docs/architecture/`（As-Is 基线）
+- global `docs/architecture/`（As-Is 基线 + 已落地部分）
 
 **⛔ 子代理 ID 记录（v0.29.0 §37，必须执行）**：dispatch 后**立即记录**子代理 ID（Agent 工具返回的 `agentId` 或 task-notification 中的 `task-id`），后续 Step 2 审查循环和 Step 4 DP-A 调整**必须通过此 ID 恢复子代理**，不得启动新子代理。记录格式：
 ```
@@ -41,6 +44,7 @@ artifacts:                       # required 时必填
 When `decision: required`, dispatch `architecture-reviewer` as sub-agent with inputs:
 - `prd_path`, `plan_path`, `change_brief_path`
 - `architecture_dir`（Step 1 产出目录）
+- `product_snapshot_path`（`docs/architecture/iterations/<vN>/architecture.md`，v0.36.0——A5 基线一致性对照产品级决策）
 - `global_arch_dir`（`docs/architecture/`）
 - `conventions_config`（从 `team-flow.config.json` 读取）