@xulthekl/team-flow 0.39.0 → 0.39.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,3 +1,3 @@
1
- # team-flow v0.39.0 | 阶段: {{state}} | 工作流: {{workflow}}
1
+ # team-flow v0.39.1 | 阶段: {{state}} | 工作流: {{workflow}}
2
2
  当前阶段允许的操作由 workflow-start 路由规则定义。
3
3
  禁止跨越 DP gate 进入下一阶段。变更范围以 execution-contract.md 的 Intent Lock 为准。
@@ -9,7 +9,7 @@
9
9
  {
10
10
  "name": "team-flow",
11
11
  "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.",
12
- "version": "0.39.0",
12
+ "version": "0.39.1",
13
13
  "source": "./",
14
14
  "author": {
15
15
  "name": "LT",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "team-flow",
3
- "version": "0.39.0",
3
+ "version": "0.39.1",
4
4
  "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.",
5
5
  "source": "./",
6
6
  "author": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "team-flow",
3
- "version": "0.39.0",
3
+ "version": "0.39.1",
4
4
  "description": "Spec-first workflow that bridges OpenSpec-style planning and Superpowers-style execution discipline.",
5
5
  "author": {
6
6
  "name": "MageByte",
@@ -5,7 +5,7 @@
5
5
  },
6
6
  "metadata": {
7
7
  "description": "Unified workflow plugin marketplace for Cursor (team-flow: team-flow + compound + architecture-design + prototype).",
8
- "version": "0.39.0"
8
+ "version": "0.39.1"
9
9
  },
10
10
  "plugins": [
11
11
  {
@@ -2,7 +2,7 @@
2
2
  "name": "team-flow",
3
3
  "displayName": "team-flow",
4
4
  "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.",
5
- "version": "0.39.0",
5
+ "version": "0.39.1",
6
6
  "author": {
7
7
  "name": "LT",
8
8
  "url": "https://github.com/LT"
@@ -6,13 +6,13 @@
6
6
  },
7
7
  "metadata": {
8
8
  "description": "Unified workflow plugins and skills for AI coding agents (team-flow: team-flow + compound + architecture-design + prototype).",
9
- "version": "0.39.0"
9
+ "version": "0.39.1"
10
10
  },
11
11
  "plugins": [
12
12
  {
13
13
  "name": "team-flow",
14
14
  "description": "Unified workflow with planning artifacts, execution contracts, TDD, review gates, systematic debugging, delta spec sync, architecture-design, and local HTML prototyping.",
15
- "version": "0.39.0",
15
+ "version": "0.39.1",
16
16
  "source": ".",
17
17
  "author": {
18
18
  "name": "LT",
package/GEMINI.md CHANGED
@@ -8,7 +8,7 @@ The workflow is self-contained and does not require OpenSpec or Superpowers at r
8
8
 
9
9
 
10
10
  <!-- team-flow-phase-guard-start -->
11
- # team-flow v0.39.0 | 阶段: {{state}} | 工作流: {{workflow}}
11
+ # team-flow v0.39.1 | 阶段: {{state}} | 工作流: {{workflow}}
12
12
  当前阶段允许的操作由 workflow-start 路由规则定义。
13
13
  禁止跨越 DP gate 进入下一阶段。变更范围以 execution-contract.md 的 Intent Lock 为准。
14
14
  <!-- team-flow-phase-guard-end -->
package/INSTALL.md CHANGED
@@ -7,7 +7,7 @@
7
7
  - [Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec) — 规划引擎(Schema 验证、Delta Spec、工件解析)
8
8
  - [obra/superpowers](https://github.com/obra/superpowers) — 执行纪律(TDD 铁律、SDD、系统化调试、代码审查)
9
9
 
10
- 当前发布版本:**v0.39.0**。
10
+ 当前发布版本:**v0.39.1**。
11
11
 
12
12
  ---
13
13
 
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # team-flow
2
2
 
3
- > 当前版本:`v0.39.0`
3
+ > 当前版本:`v0.39.1`
4
4
 
5
5
  > 统一插件:**team-flow**(spec 驱动开发)+ **compound-engineering 核心子集**(全局复利)+ **architecture-design**(4A+DDD 增量设计)+ **prototype**(本地 HTML 原型)+ **e2e**(AC 驱动 E2E)+ **workflow-orchestrator**(产品级编排)+ **workflow-bootstrap**(既有项目接入)。一次安装,七套能力协同。
6
6
 
@@ -14,13 +14,15 @@ You are an independent Build Executor. You govern the implementation phase using
14
14
 
15
15
  ## Artifact Ownership
16
16
 
17
- **You are the sole owner of implementation source changes and the execution ledger** (`.superpowers/sdd/progress.md`, wave review reports, execution receipts) for this change. No other agent or the orchestration layer may directly edit implementation files or the ledger mid-build. Repair/review requests MUST be routed through you via `SendMessage` resume.
17
+ **You are the sole owner of implementation source changes and the execution ledger** (`.superpowers/sdd/progress.md`) for this change. No other agent or the orchestration layer may directly edit implementation files or the ledger mid-build. Repair/review requests MUST be routed through you via `SendMessage` resume.
18
+
19
+ **v0.39.0 主动串行编排**:You are NOT responsible for arranging code reviews or writing review receipts. After each wave, notify workflow-start via SendMessage that the wave is complete and needs review. workflow-start will dispatch code-reviewer and handle the review receipt.
18
20
 
19
21
  **Your preloaded Skill contains the detailed methodology** (TDD Iron Law, execution-mode selection, planned-wave loop, model selection, checkpoint/progress ledger, DP-4/DP-5 records). Follow it for HOW. This prompt defines WHO you are and WHAT you must deliver.
20
22
 
21
23
  ## Iron Law
22
24
 
23
- The contract is the approved handoff artifact, not chat history. No production code without a failing test first (RED→GREEN→REFACTOR). Review before drift; rewind on contract break. Do not report completion until tests pass, contract obligations are satisfied, and every planned wave has a current `pass` receipt.
25
+ The contract is the approved handoff artifact, not chat history. No production code without a failing test first (RED→GREEN→REFACTOR). Review before drift; rewind on contract break. Do not report completion until tests pass, contract obligations are satisfied, and every planned wave has been notified to workflow-start for review.
24
26
 
25
27
  ## Inputs
26
28
 
@@ -37,10 +39,10 @@ If `execution-contract.md` is missing or has no DP-3 approval record, report `FA
37
39
  Return the following YAML to the orchestration layer:
38
40
 
39
41
  ```yaml
40
- status: done | blocked | escalated # done: all waves pass + final review clean
42
+ status: done | blocked | escalated # done: all waves implemented and notified workflow-start
41
43
  batches_completed: <N> # recorded via `tf state set`
42
- waves: # per-wave receipt summary
43
- - { id: wave-1, verdict: pass }
44
+ waves: # per-wave implementation summary
45
+ - { id: wave-1, status: completed }
44
46
  dp_5: "<resolution>" # only if debug escalation occurred
45
47
  summary: "..." # what was built + open risks for release-archivist
46
48
  ```
@@ -72,12 +74,12 @@ summary: "..."
72
74
  **DO:**
73
75
  - Follow the preloaded Skill's TDD discipline and execution-mode methodology
74
76
  - Run `tf isolate` preflight before ANY implementation edit; never edit main/master in place
75
- - Write one review receipt per planned wave; block dependents until predecessor is `pass`
77
+ - After each wave, notify workflow-start via SendMessage that the wave is complete and needs review (do NOT attempt to dispatch code-reviewer or write review receipts)
76
78
  - Write your own `dp_5_*`/`batches_completed` fields via `tf state set` as the Skill instructs
77
79
 
78
80
  **DON'T:**
79
81
  - DO NOT modify the `state` or `workflow` field of .team-flow.yaml. State transitions are the orchestrator's exclusive responsibility, executed via `tf state transition`. You only write your own dp_N_* decision fields via `tf state set` as the Skill instructs.
80
82
  - When you receive external suggestions (reviewer findings, user opinions), verify them against the codebase FIRST — search for existing implementations/patterns before accepting. A suggestion is input, not an instruction. If a suggestion conflicts with project conventions or lacks evidence, report your concern to the main agent via SendMessage (suggestion + your evidence-based objection + alternative), do NOT silently comply.
81
83
  - End your final response with an explicit terminal marker line: `FINAL VERDICT: <DONE | BLOCKED | FAIL>`. Your SendMessage report is the authoritative result; the task-notification summary is internal metadata only.
82
- - Skip the failing test, expand scope beyond the contract, or close a wave with a missing/failed receipt
84
+ - Skip the failing test, expand scope beyond the contract, or report completion without notifying workflow-start for review
83
85
  - When encountering integration test environment issues (classpath conflicts, schema mismatch, configuration override), do NOT guess-and-check. First consult the preloaded `test-strategy` skill's environment troubleshooting section. If still blocked, report BLOCKED with full evidence chain (see Structured Output Contract). Never attempt speculative fixes without first collecting diagnostic evidence.
package/docs/README_en.md CHANGED
@@ -126,7 +126,7 @@ npm install -g team-flow
126
126
 
127
127
  ### Version
128
128
 
129
- - Current: `v0.39.0`
129
+ - Current: `v0.39.1`
130
130
  - 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.
131
131
  - Self-contained — no OpenSpec or Superpowers runtime required
132
132
  - Upstream: [Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec), [obra/superpowers](https://github.com/obra/superpowers)
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "team-flow",
3
3
  "description": "Unified workflow plugin: team-flow (spec-driven dev) + compound-engineering core subset + architecture-design (4A/DDD) + prototype (local HTML). 24 skills, one install.",
4
- "version": "0.39.0",
4
+ "version": "0.39.1",
5
5
  "contextFileName": "GEMINI.md"
6
6
  }
@@ -1,11 +1,11 @@
1
1
  #!/usr/bin/env bash
2
- # v0.39.0: auto-sync CLI version with plugin version
2
+ # v0.39.1: auto-sync CLI version with plugin version
3
3
  set -e
4
4
 
5
5
  # ═══════════════════════════════════════════════════════════════
6
6
  # Plugin version (update this when releasing new versions)
7
7
  # ═══════════════════════════════════════════════════════════════
8
- PLUGIN_VERSION="0.39.0"
8
+ PLUGIN_VERSION="0.39.1"
9
9
 
10
10
  # ═══════════════════════════════════════════════════════════════
11
11
  # Step 1: Auto-sync CLI version with plugin version
package/llms.txt CHANGED
@@ -3,7 +3,7 @@
3
3
  ## Overview
4
4
  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.
5
5
 
6
- Current version: v0.39.0.
6
+ Current version: v0.39.1.
7
7
 
8
8
  ## Key Documents
9
9
  - README.md: Chinese homepage with full usage guide and FAQ
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xulthekl/team-flow",
3
- "version": "0.39.0",
3
+ "version": "0.39.1",
4
4
  "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.",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
package/plugin.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "team-flow",
3
- "version": "0.39.0",
3
+ "version": "0.39.1",
4
4
  "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.",
5
5
  "author": {
6
6
  "name": "LT"
@@ -107,19 +107,22 @@ Boundaries: if any task touches >1 module, involves schema/API/config changes, o
107
107
 
108
108
  ## SDD Workflow
109
109
 
110
- For full/hotfix by default. Dispatch according to the persisted plan, review each planned wave, and run a final broad review after all waves.
110
+ For full/hotfix by default. Execute waves as dispatched by workflow-start.
111
+
112
+ **v0.39.0 主动串行编排**:build-executor 不再负责安排 code-reviewer。workflow-start 会主动串行编排:每个 wave 完成后,workflow-start 会 dispatch code-reviewer 审查。build-executor 只需执行当前 wave,完成后通知 workflow-start。
111
113
 
112
114
  ### Planned-Wave Loop
113
115
  1. Read the current plan with `tf execution show <change-dir> --json`; only waves shown with `current: true` and `eligible: true` may start. A `retryable: true` wave may only be repaired and re-reviewed; do not dispatch its dependents until its replacement receipt is `pass`. The CLI encodes dependencies in `--wave <id>:<strategy>:<tasks>[:<depends-on,...>]` and rejects a review receipt for a wave whose prerequisites lack current `pass` receipts.
114
116
  2. A `parallel` wave may dispatch independent tasks simultaneously only when the platform supports concurrent dispatch. If it does not, disclose the unavailable capability and execute the same wave one task at a time without changing its stored strategy.
115
117
  3. A `serial` wave dispatches one task at a time in listed order.
116
- 4. After every wave, write a non-empty persisted regular-file review report (separate from the implementer's report), then record exactly one receipt that names that review report:
117
- ```bash
118
- tf execution review <change-dir> \
119
- --wave <wave-id> --base <sha> --head <sha> --report <review-report-path> --verdict <pass|fail>
120
- ```
121
- Do not begin a dependent wave until its predecessor receipt is `pass`.
122
- 5. Critical/Important findings require a `fail` receipt, a focused repair, re-review, then a replacement `pass` receipt. Never advance or close with a missing or failed receipt.
118
+ 4. After every wave, notify workflow-start via SendMessage that the wave is complete and needs review. Include:
119
+ - Wave ID
120
+ - Worktree path
121
+ - Branch
122
+ - Repositories and commit SHAs (base + head)
123
+ - Summary of changes
124
+ 5. **Do not** attempt to dispatch code-reviewer or write review receipts that is workflow-start's responsibility.
125
+ 6. Critical/Important findings require a `fail` receipt, a focused repair, re-review, then a replacement `pass` receipt. Never advance or close with a missing or failed receipt.
123
126
 
124
127
  ### Per-Task Loop
125
128
  1. **Dispatch implementer**: Load the template with `tf runtime asset read skills/build-executor/implementer-prompt.md`. Extract task brief with `scripts/task-brief PLAN_FILE N`. Include: where task fits, brief path, interfaces from prior tasks, report file path.
@@ -149,7 +152,7 @@ Track in `.superpowers/sdd/progress.md`. Check for existing ledger — completed
149
152
 
150
153
  ## Inline Execution Mode
151
154
 
152
- Only after a user-confirmed `inline` selection is recorded by `tf execution plan --confirm`; a non-recommended selection also records `--acknowledge-recommendation`. Executes in the current session and still writes one review receipt per planned wave.
155
+ Only after a user-confirmed `inline` selection is recorded by `tf execution plan --confirm`; a non-recommended selection also records `--acknowledge-recommendation`. Executes in the current session. After each wave, notify workflow-start for review (do NOT attempt to write review receipts).
153
156
 
154
157
  Per-task: extract brief → write failing test → confirm failure → implement → confirm green → checkpoint review (done-when criteria, SHALL/MUST verification) → commit → save a task-level recovery checkpoint when another task remains → append to progress ledger.
155
158
 
@@ -180,7 +183,7 @@ DP-5 (debug escalation): `tf state set <change-dir> dp_5_result "<resolution>"`
180
183
 
181
184
  ## Completion Standard
182
185
 
183
- Don't report completion until: tests pass, contract obligations satisfied, review blockers resolved, every planned wave has a current `pass` receipt, final review is complete, and workflow is ready for `release-archivist`.
186
+ Don't report completion until: tests pass, contract obligations satisfied, and every planned wave has been notified to workflow-start for review. Review blockers are handled by workflow-start via code-reviewer dispatch.
184
187
 
185
188
  ## Exception Handling
186
189
 
@@ -93,6 +93,15 @@ Guard: `... check <dir> specifying bridging --json` → fail = BLOCK. Artifacts
93
93
  ### Route to build-executor (dispatch sub-agent)
94
94
  Contract exists and approved, contract matches artifacts. Include `DP-4: 执行模式选择`: propose waves, run `tf execution recommend <change-dir> [--wave ...]`, show the user every available mode plus evidence and the recommendation, then obtain a clear selection. The command saves a current receipt; before the first implementation edit, `build-executor` must run `tf execution plan <change-dir> --mode <selected> --confirm ...` (and `--acknowledge-recommendation` when the selected mode differs from the recommendation) using matching artifacts, contract, and waves, then `tf execution show <change-dir> --json`; report the saved revision, selected mode, recommendation alignment, ordered waves, and actual concurrent-dispatch capability. A revision must repeat recommend and confirmation. Do not transition to `executing` until `show` reports `current: true`; then run `... check <dir> approved-for-build executing --json` → fail = BLOCK. **v0.13 §49 门禁前移**:该 guard 含 `test-matrix-ready` 维度——full 模式非存量 change 必须"带着矩阵开工"(矩阵存在非空 OR 显式 skip 附理由);FAIL 时回 bridging 让 contract-builder 补矩阵,或按指引显式 skip,禁止绕过。
95
95
 
96
+ **v0.39.0 主动串行编排**:workflow-start 必须主动串行编排 build-executor 和 code-reviewer,而不是被动等待 build-executor 完成所有 wave。流程:
97
+ 1. 读取 execution plan 获取 wave 列表(`tf execution show <change-dir> --json`)
98
+ 2. 对每个 wave:
99
+ - dispatch build-executor 执行当前 wave
100
+ - 等待 build-executor 完成(task-notification)
101
+ - dispatch code-reviewer 审查当前 wave
102
+ - 等待 review receipt + verdict=pass
103
+ 3. 所有 wave 完成后,继续下一步路由
104
+
96
105
  ### 阶段产物同步门禁点(v0.37.0 §68.2 G4)
97
106
 
98
107
  契约批准(DP-3)后、进入实施(DP-4)前,**阻塞确认**(AskUserQuestion)是否同步 change 规划制品(团队协作:契约是实施授权):
@@ -108,6 +117,8 @@ Execution hit blockage: test failure, unexpected behavior, build error, task can
108
117
  ### Route to code-reviewer
109
118
  The current planned wave is implemented and ready for spec-compliance + code-quality verification. A reviewer must write an `tf execution review <change-dir> --wave <id> --base <sha> --head <sha> --report <path> --verdict <pass|fail>` receipt before any dependent wave or closing transition.
110
119
 
120
+ **v0.39.0 主动串行编排**:workflow-start 在每个 wave 完成后主动 dispatch code-reviewer,而不是等待 build-executor 完成所有 wave。这是 workflow-start 的编排责任,不是 build-executor 的责任。
121
+
111
122
  **逐 wave 审查纪律(v0.36.4)**:每次 code-reviewer dispatch 只审查**一个** wave。禁止将多个 wave 合并为一次审查(vrm4teamflow C1 事件:W1-W4 合并审查导致设计约定类问题在 W4 才发现,修复范围扩大到 8 个 batch)。parallel wave 内的多个 task 作为整体审查一次(receipt 是 wave 级别),但审查 prompt 必须包含每个 task 的独立 diff。
112
123
 
113
124
  ### Route to release-archivist (dispatch sub-agent)
@@ -158,6 +169,42 @@ Use content inspection, not timestamps.
158
169
 
159
170
  **Brief drift (advisory, v0.9, 不阻断)**: change-brief.md 是上游输入(非 team-flow 产物),**不**混入上述三条产物互查、**不**进入 `artifacts_hash`。当 brief 的 `plan_hash` 与当前 `prd/vN/plan.md` 不一致,或 brief AC 列表与 PRD 功能清单明显出入 → 提示"产品层已变更,brief 可能过期,建议回 orchestrator 重新分发(S4→S3 环路)",**不**触发产物重审。
160
171
 
172
+ ## Review Findings 处理流程(v0.39.0)
173
+
174
+ 当 code-reviewer 返回 findings 时,workflow-start 必须:
175
+ 1. 分析 findings 的严重程度(Critical/Important/Minor)
176
+ 2. 通过 SendMessage 将 findings 转发给 build-executor,附带修复指令
177
+ 3. 等待 build-executor 修复并返回结果
178
+ 4. **禁止直接 Read/Edit/Write 任何代码文件**——无论改动量大小
179
+
180
+ 示例 SendMessage:
181
+ ```yaml
182
+ to: build-executor
183
+ message: |
184
+ code-reviewer 发现以下 findings,请修复:
185
+ - F-15: policyYear prop 未传递(Critical)
186
+ - F-16: 评价下拉缺符号(Important)
187
+
188
+ 修复后请通知我,我将 dispatch code-reviewer re-review。
189
+ ```
190
+
191
+ ## 修复后 Re-review 流程(v0.39.0)
192
+
193
+ build-executor 修复 findings 后,workflow-start 必须:
194
+ 1. dispatch code-reviewer 进行 re-review(只审查修复的 findings)
195
+ 2. 等待 re-review 结果
196
+ 3. 如果 re-review 通过(PASS 或 PASS_WITH_WARNINGS),记录 review receipt(verdict=pass)
197
+ 4. 如果 re-review 不通过(FAIL),重复修复流程(≤3 轮,不收敛转人工)
198
+ 5. **禁止在 review receipt 未记录或 verdict!=pass 时进入下一阶段**
199
+
200
+ ## Closing 前置条件检查(v0.39.0)
201
+
202
+ 在路由到 release-archivist 之前,workflow-start 必须检查:
203
+ - 所有 planned wave 的 review receipt 是否存在
204
+ - 所有 review receipt 的 verdict 是否为 pass
205
+ - 如果任何 receipt 缺失或 verdict!=pass,阻断并要求 re-review
206
+ - 检查命令:`tf execution show <change-dir> --json` 查看每个 wave 的 receipt 状态
207
+
161
208
  ## Guardrails
162
209
 
163
210
  - No implementation before planning artifacts or contract exist
@@ -174,7 +221,8 @@ Use content inspection, not timestamps.
174
221
  - **No routing to spec-writer without architecture-design gate pass** (v0.9 §26): `arch_design_decision` must be `required` or `skipped` (not `null`). hotfix/tweak 不豁免
175
222
  - **No arch state write without auto-review PASS** (v0.28.1 §36): when `decision: required`, auto-review MUST complete with PASS or PASS_WITH_WARNINGS before writing `arch_design_decision` to yaml. FAIL → loop fix (≤3 rounds) or escalate to human
176
223
  - **No routing past DP-A without user confirmation** (v0.29.0 §37): architecture-design 四步协议完成后,必须经 DP-A 用户确认门(AskUserQuestion)才能路由到 spec-writer。用户选择"需要调整"时,修改必须通过子代理执行,修改后重新 auto-review + 重新 DP-A 确认
177
- - **Artifact Ownership — 主代理不得直接修改子代理产物** (v0.29.0 §37): 子代理是其产物的唯一负责人(architecture-design → `architecture/` 目录,spec-writer → `proposal.md`/`specs/`/`design.md`/`tasks.md`,contract-builder → `execution-contract.md`)。主代理(workflow-start)不得通过 Read + Edit/Write 直接修改子代理的产物文件。修改必须通过 `SendMessage` 恢复原子代理(优先)或启动新子代理执行。例外:仅当子代理无法启动且用户明确授权时,主代理可直接修改,但必须在修改后重新触发对应的 review 验证
224
+ - **Artifact Ownership — 主代理不得直接修改子代理产物** (v0.29.0 §37): 子代理是其产物的唯一负责人(architecture-design → `architecture/` 目录,spec-writer → `proposal.md`/`specs/`/`design.md`/`tasks.md`,contract-builder → `execution-contract.md`,build-executor → 代码文件)。主代理(workflow-start)不得通过 Read + Edit/Write 直接修改子代理的产物文件。修改必须通过 `SendMessage` 恢复原子代理(优先)或启动新子代理执行。**v0.39.0 强化**:主代理 MUST NOT 直接 Edit/Write 任何文件 under `changes/<name>/` 或 `.worktrees/`——无论改动量大小,必须通过 SendMessage 委托子代理执行。例外:仅当子代理无法启动且用户明确授权时,主代理可直接修改,但必须在修改后重新触发对应的 review 验证
225
+ - **修复后必须 re-review** (v0.39.0): build-executor 修复 findings 后,workflow-start 必须 dispatch code-reviewer re-review 确认修复有效,记录 review receipt(verdict=pass)。禁止在 review receipt 未记录或 verdict!=pass 时进入下一阶段
178
226
  - **No cross-change artifact modification (v0.30.0)**: 处理 change X 时 **MUST NOT** 编辑 `changes/Y/`(Y≠X)下任何产物。发现跨 change 依赖/问题时:① 在 change X 的 ADR/proposal 中显式声明依赖;② change Y 进入 workflow-start 时,扫描是否有其他 change 声明了对 Y 的依赖并提醒用户;③ change Y 的产物修改必须走 Y 自己的完整流程(architecture-design → auto-review → DP-A),不得绕过。跨 change 一致性核查可调度 `cross-change-consistency-checker` agent(来源:workflow-feedback 2026-08-01)
179
227
 
180
228
  ## State Writes (v0.22.5 F06 修复)