@xulthekl/team-flow 0.36.0 → 0.36.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.
- package/.claude/always/phase-guard.md +1 -1
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +1 -1
- package/.cursor-plugin/marketplace.json +1 -1
- package/.cursor-plugin/plugin.json +1 -1
- package/.github/plugin/marketplace.json +2 -2
- package/AGENTS.md +5 -2
- package/CHANGELOG.md +5 -0
- package/GEMINI.md +1 -1
- package/INSTALL.md +1 -1
- package/README.md +3 -2
- package/docs/README_en.md +1 -1
- package/gemini-extension.json +1 -1
- package/hooks/session-start +2 -2
- package/llms.txt +1 -1
- package/package.json +1 -1
- package/plugin.json +1 -1
- package/skills/workflow-orchestrator/SKILL.md +24 -7
|
@@ -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.36.
|
|
12
|
+
"version": "0.36.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.36.
|
|
3
|
+
"version": "0.36.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": {
|
|
@@ -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.36.
|
|
5
|
+
"version": "0.36.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.36.
|
|
9
|
+
"version": "0.36.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.36.
|
|
15
|
+
"version": "0.36.1",
|
|
16
16
|
"source": ".",
|
|
17
17
|
"author": {
|
|
18
18
|
"name": "LT",
|
package/AGENTS.md
CHANGED
|
@@ -60,7 +60,7 @@ spec 驱动开发过程。8 态变更机:`exploring → specifying → bridgin
|
|
|
60
60
|
- 用法:`/e2e [原型|集成|验收] [spec路径]`
|
|
61
61
|
|
|
62
62
|
### 6. workflow-orchestrator(1 skill,产品级编排,v0.7 重设计 + v0.15.0 多需求)
|
|
63
|
-
- 编排产品级工作流:S1 路径路由(含需求选择)→ S2 PRD+原型(循环上提,orchestrator 直接编排,**冻结前 PRD 完整性评审**)→ S3 ce-plan(pipeline 快速路径,**入口问定 plan_mode**)→ S4 拆分验证+分发 → S5 全局监控
|
|
63
|
+
- 编排产品级工作流:S1 路径路由(含需求选择)→ S2 PRD+原型(循环上提,orchestrator 直接编排,**冻结前 PRD 完整性评审**)→ S3 ce-plan(pipeline 快速路径,**入口问定 plan_mode**)→ **ARCH 产品级架构设计(v0.36.0:architecture-design product 模式 8 步 → iterations/vN/architecture.md 快照 → 评审门 PASS 才进 S4)** → S4 拆分验证+分发 → S5 全局监控
|
|
64
64
|
- v0.7 关键变更:原型循环从 ce-brainstorm 内部上提到 orchestrator 层直接编排;新增反馈环路(vN 内修订+变更履历,非升版);新增增量入口(S1 路径路由器,**7 种入口路径**,v0.20.0 增「原型补跑/重跑」);S5 多 change 并行时必选
|
|
65
65
|
- **v0.20.0**:S1 路由新增第 7 种入口「原型补跑/重跑」(PRD 冻结 ∧ prototype 缺失/需重做 → 部分重入 S2 原型循环,PRD 不动、保留有效 S3/S4);后台子代理等待范式(依赖完成通知,禁 TaskOutput 轮询)(设计 §22)
|
|
66
66
|
- **v0.15.0 多需求并行**:`.team-flow/registry.yaml` 注册表 + 每需求一份 `.team-flow/requirements/<req-id>/orchestrator.yaml`,状态天然隔离
|
|
@@ -136,7 +136,10 @@ STRATEGY.md CONCEPTS.md 产品策略(BA) / 领域词汇
|
|
|
136
136
|
S3 计划阶段 → ce-plan(pipeline 快速路径,入口问定 plan_mode)
|
|
137
137
|
plan.md:change 拆分 + 依赖 DAG + 高阶技术方向(不含接口清单)
|
|
138
138
|
反馈环路:plan 暴露 PRD 问题可回退 S2
|
|
139
|
-
|
|
139
|
+
[ARCH 产品级架构设计(v0.36.0)] → architecture-design product 模式 8 步设计
|
|
140
|
+
→ docs/architecture/iterations/vN/architecture.md(6 产物快照,预测态不写全局)→ 评审门 PASS 才进 S4
|
|
141
|
+
skip 须物化(iterations/vN/SKIPPED);旧项目首轮 arch_baseline 缺失 → 逆向重建
|
|
142
|
+
S4 拆分验证与分发 → arch-readiness 门(快照覆盖 change 触及 BC)→ change-split-auditor 审计(必选门禁)→ 创建 change → 进入 team-flow
|
|
140
143
|
并行策略建议 + 验收标准预分配;反馈环路:依赖图不可执行可回退 S3
|
|
141
144
|
S5 全局监控(change≥2 必选)→ 跨 change 一致性 + 复利晋升 + 动态重规划
|
|
142
145
|
│
|
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,11 @@ The format loosely follows Keep a Changelog.
|
|
|
6
6
|
|
|
7
7
|
## [Unreleased]
|
|
8
8
|
|
|
9
|
+
## [0.36.1] - 2026-08-05
|
|
10
|
+
|
|
11
|
+
### Fixed
|
|
12
|
+
- **workflow-orchestrator 流程缺口修复**:0.36.0 的 `references/state-model.md` 已定义 ARCH(S3.5 产品级架构设计)阶段,但 SKILL.md 主体 Execution Flow(S1-S5)/ AGENTS.md / README 未同步该阶段——LLM 执行 orchestrator 会走 S3→S4 跳过架构设计。已同步 11 处:SKILL.md(定位表/Execution Flow 标题/ARCH 阶段节/反馈环路/增量入口/状态模型/Guardrails/Output Standard)+ AGENTS.md(产品级工作流/SOP)+ README(SOP)
|
|
13
|
+
|
|
9
14
|
## [0.36.0] - 2026-08-05
|
|
10
15
|
|
|
11
16
|
### Added(产品级架构设计增强——设计增强方案 v0.14 §57-§66)
|
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.36.
|
|
11
|
+
# team-flow v0.36.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
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# team-flow
|
|
2
2
|
|
|
3
|
-
> 当前版本:`v0.36.
|
|
3
|
+
> 当前版本:`v0.36.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
|
|
|
@@ -108,7 +108,8 @@ Skills 命名保留其来源前缀,作为功能分组的自然标识:
|
|
|
108
108
|
→ S1 路径路由器 → 判断入口路径(全新/续版/重新计划/继续执行/快速通道/Hotfix)
|
|
109
109
|
→ S2 PRD + 原型阶段 → ce-brainstorm + 原型循环上提(prototype → 自动评审 → 人工评审 → 冻结)
|
|
110
110
|
→ S3 计划阶段 → ce-plan(pipeline 快速路径)→ plan.md(change 拆分+依赖+技术方向)
|
|
111
|
-
→
|
|
111
|
+
→ [ARCH 产品级架构设计(v0.36.0 新增)] → 8 步设计 → iterations/vN/architecture.md 快照 → 评审门
|
|
112
|
+
→ S4 拆分验证与分发 → arch-readiness 门 → change-split-auditor 审计(必选门禁)→ 创建 change → 进入 team-flow
|
|
112
113
|
→ S5 全局监控(change≥2 必选)→ 跨 change 一致性 + 复利晋升 + 动态重规划
|
|
113
114
|
→ [复利贯穿层] 每个阶段转换点:检测→捕获→索引→注入
|
|
114
115
|
→ change 完成:arch-merge → prototype-sync(顺序提交)+ 复利晋升
|
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.36.
|
|
129
|
+
- Current: `v0.36.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)
|
package/gemini-extension.json
CHANGED
|
@@ -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.36.
|
|
4
|
+
"version": "0.36.1",
|
|
5
5
|
"contextFileName": "GEMINI.md"
|
|
6
6
|
}
|
package/hooks/session-start
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
#!/usr/bin/env bash
|
|
2
|
-
# v0.36.
|
|
2
|
+
# v0.36.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.36.
|
|
8
|
+
PLUGIN_VERSION="0.36.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.36.
|
|
6
|
+
Current version: v0.36.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.36.
|
|
3
|
+
"version": "0.36.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.36.
|
|
3
|
+
"version": "0.36.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"
|
|
@@ -16,7 +16,7 @@ description: >-
|
|
|
16
16
|
|
|
17
17
|
| 层级 | 编排器 | 管辖范围 |
|
|
18
18
|
|------|--------|---------|
|
|
19
|
-
| 产品级 | **workflow-orchestrator**(本 skill) | 路径路由 → PRD+原型循环 → 计划 → 拆分验证 → 分发 → 监控 |
|
|
19
|
+
| 产品级 | **workflow-orchestrator**(本 skill) | 路径路由 → PRD+原型循环 → 计划 → **架构设计(ARCH,v0.36.0)** → 拆分验证 → 分发 → 监控 |
|
|
20
20
|
| 变更级 | workflow-start(不变) | exploring → ... → closing(8 态状态机) |
|
|
21
21
|
|
|
22
22
|
**分层原则**:本 skill 管「做什么、什么顺序」(产品级策略),workflow-start 管「怎么做」(变更级执行)。二者通过 change 目录 + `.team-flow.yaml` 衔接。
|
|
@@ -34,7 +34,7 @@ Do NOT invoke for:
|
|
|
34
34
|
- 单一 change 的实施(用 `/build-executor`)
|
|
35
35
|
- 独立工具操作(`/ce-ideate`、`/ce-strategy`、`/prototype`、`/architecture-design` 等)
|
|
36
36
|
|
|
37
|
-
## Execution Flow(S1-S5
|
|
37
|
+
## Execution Flow(S1-S5 + ARCH 产品级架构设计)
|
|
38
38
|
|
|
39
39
|
### S1: 路径路由器
|
|
40
40
|
**先做需求选择**(v0.15.0 多需求):读 `.team-flow/registry.yaml`,确定 `active_requirement`(多需求则询问操作哪个/新建)。再判断 7 种入口路径之一;检查 baseline.md / CONCEPTS.md 并注入;复利注入(INDEX.md top-5)。**路由结果必须向用户显式确认**(路由是建议非决定)。详见 `references/s1-path-router.md`。
|
|
@@ -69,7 +69,21 @@ prd_draft → user_review → prototype_loop → prd_frozen → completed
|
|
|
69
69
|
调用 `/ce-brainstorm`(mode: orchestrated)产出 PRD 草稿;**冻结前派 `prd-completeness-reviewer` 子代理做 PRD 完整性评审**(v0.15.0,管"说得全不全");原型循环由编排层直接编排(prototype skill 内部编排产出 → prototype-reviewer 自动评审 → 人工评审 → 冻结);冻结语义为 `frozen_downstream`(迭代内变更不升版)。反馈环路检查点:scope 是否合理。详见 `references/s2-prd-prototype-loop.md`。
|
|
70
70
|
|
|
71
71
|
### S3: 计划阶段
|
|
72
|
-
**入口一次性问定计划模式**(业务/一人公司),调用 `/ce-plan`(`pipeline_mode: orchestrator` + `plan_mode: business|solo`,跳过仪式开销、保留 repo research + change splitting + 依赖 DAG + 技术方向)产出 `prd/vN/plan.md`。plan 只到产品级策略 + 高阶技术设计,**不含接口清单**(属各 change 的 spec-writer)。反馈环路检查点:plan 是否暴露 PRD scope 问题(是→回退 S2)。详见 `references/s3-plan-pipeline.md
|
|
72
|
+
**入口一次性问定计划模式**(业务/一人公司),调用 `/ce-plan`(`pipeline_mode: orchestrator` + `plan_mode: business|solo`,跳过仪式开销、保留 repo research + change splitting + 依赖 DAG + 技术方向)产出 `prd/vN/plan.md`。plan 只到产品级策略 + 高阶技术设计,**不含接口清单**(属各 change 的 spec-writer)。反馈环路检查点:plan 是否暴露 PRD scope 问题(是→回退 S2)。详见 `references/s3-plan-pipeline.md`。完成条件:plan.md 产出 + S3 状态 = completed,**下一步进 ARCH**(v0.36.0)。
|
|
73
|
+
|
|
74
|
+
### ARCH: 产品级架构设计(v0.36.0 新增,S3 之后、S4 之前)
|
|
75
|
+
|
|
76
|
+
**⛔ MANDATORY:执行 ARCH 阶段前,必须先读取 `references/state-model.md`「architecture 阶段」+ `architecture-design/references/s3.5-product-architecture.md`**
|
|
77
|
+
|
|
78
|
+
产品级架构设计:基于迭代版本 vN 产出覆盖所有模块的整体详细架构(预测态快照,P1:只写快照不写全局)。
|
|
79
|
+
|
|
80
|
+
**场景判定(入口三态)**:全新项目 → 正向设计(首轮不可跳过);旧项目首轮(`arch_baseline` 缺失)→ 逆向重建 L0 骨架 → 渐进深化;已建档 + 迭代无结构性变更 → 跳过(**skip 必须物化**:写 `docs/architecture/iterations/vN/SKIPPED` 标记 + 理由,判定者=编排器+用户确认)。
|
|
81
|
+
|
|
82
|
+
**执行**:调用 architecture-design skill 的 **product 模式**子代理(8 步设计:限界上下文/聚合注册表/指令事件/状态机/概念 ER/时序),产出 `docs/architecture/iterations/vN/architecture.md`(6 产物,provenance 标注)。
|
|
83
|
+
|
|
84
|
+
**评审门**:产出经 architecture-reviewer product 视角(`review_mode: product`,A1-A6)评审,**PASS 才进 S4**。
|
|
85
|
+
|
|
86
|
+
**输出契约**:`docs/architecture/iterations/vN/architecture.md` + 评审 verdict;`orchestrator.yaml` 中 ARCH phase 状态 = completed(`workflow_phase: architecture`)。
|
|
73
87
|
|
|
74
88
|
### S4: 拆分验证与分发
|
|
75
89
|
|
|
@@ -145,6 +159,8 @@ plan_hash: sha256:<plan.md 内容摘要> # 检测产品层改动后变更层
|
|
|
145
159
|
## 反馈环路(保守策略:只允许相邻回退)
|
|
146
160
|
|
|
147
161
|
- **S3 → S2**:plan 暴露 PRD scope 问题 → PRD vN 内修订(非升版)+ 变更履历,plan.md 归档为 .revN
|
|
162
|
+
- **ARCH → S3**(v0.36.0):架构设计暴露 plan 拆分问题 → 调整拆分策略,plan.md 归档为 .revN
|
|
163
|
+
- **S4 → ARCH**(v0.36.0):架构快照不覆盖 change 触及的 BC / 架构产物缺失 → 回 ARCH 补快照,change 拆分保留
|
|
148
164
|
- **S4 → S3**:依赖图不可执行/粒度不合理 → 调整拆分策略,已建 change 目录保留增量调整
|
|
149
165
|
- **S5 → S4**:跨 change 冲突需重新拆分 → 按在途 change 红/绿/灰区处置
|
|
150
166
|
|
|
@@ -156,15 +172,15 @@ plan_hash: sha256:<plan.md 内容摘要> # 检测产品层改动后变更层
|
|
|
156
172
|
|------|------|------|
|
|
157
173
|
| 全新需求 | 无 PRD,需求模糊 | → S2 |
|
|
158
174
|
| 续版需求 | 有 PRD vN,要加功能 | → S2(vN+1) |
|
|
159
|
-
| 重新计划 | PRD 已冻结,plan 需调整 | → S3 |
|
|
160
|
-
| 继续执行 | changes 已拆分,继续下一个 | → S4/S5
|
|
175
|
+
| 重新计划 | PRD 已冻结,plan 需调整 | → S3(完成后进 ARCH,v0.36.0) |
|
|
176
|
+
| 继续执行 | changes 已拆分,继续下一个 | → S4/S5(先输出状态恢复简报;若 `workflow_phase: architecture` 则恢复 ARCH 阶段) |
|
|
161
177
|
| 单 change 快速通道 | 需求极清晰、无 UI、无跨模块依赖的极小变更 | → 直接建 change → workflow-start |
|
|
162
178
|
| 紧急修复(Hotfix) | bug/生产问题,最小范围修复 | → 建 change(type: hotfix)→ workflow-start |
|
|
163
179
|
| **原型补跑/重跑**(v0.20.0) | PRD 已冻结(`frozen_downstream`)∧ `prototype/` 缺失/为空,或用户显式要求重做原型 | → 部分重入 S2 原型循环(S2 步骤 2→3→4);PRD 不动,保留有效 S3/S4,闭环后恢复原 phase |
|
|
164
180
|
|
|
165
181
|
## 状态模型
|
|
166
182
|
|
|
167
|
-
**多需求并行(v0.15.0)**:`.team-flow/registry.yaml`(需求注册表 + `active_requirement` 活跃指针)+ 每需求一份 `.team-flow/requirements/<req-id>/orchestrator.yaml`(持久化记忆 / checkpointer)。各需求状态天然隔离,支持并行。单需求 orchestrator.yaml 含 requirement_id / workflow_phase / phases / replan_log / change_dag / prd_version
|
|
183
|
+
**多需求并行(v0.15.0)**:`.team-flow/registry.yaml`(需求注册表 + `active_requirement` 活跃指针)+ 每需求一份 `.team-flow/requirements/<req-id>/orchestrator.yaml`(持久化记忆 / checkpointer)。各需求状态天然隔离,支持并行。单需求 orchestrator.yaml 含 requirement_id / workflow_phase / phases / replan_log / change_dag / prd_version。**v0.36.0:phases 增加 ARCH(产品级架构设计)阶段,`workflow_phase: architecture`**;项目级架构基线状态存 `.team-flow/arch-state.json`(`arch_baseline`,`tf arch init` 打戳,缺失 = 存量 → arch 门禁 WARN 不 FAIL)。双层冻结(frozen_downstream / frozen_absolute),frozen 以 PRD frontmatter 为单一真相源。迁移兼容:检测旧 `<root>/.workflow-orchestrator.yaml` 自动迁入。动态重规划(三级意图分类器 + 红/绿/灰区 + DP-R 确认)见 `references/state-model.md`。
|
|
168
184
|
|
|
169
185
|
## Guardrails
|
|
170
186
|
|
|
@@ -173,6 +189,7 @@ plan_hash: sha256:<plan.md 内容摘要> # 检测产品层改动后变更层
|
|
|
173
189
|
- **后台子代理等待范式(v0.20.0)**:派发后台子代理(prototype-builder / reviewer / architecture-design 等长任务)后**依赖完成通知(`<task-notification>`)再行动**,**禁止反复 `TaskOutput(block=true)` 阻塞轮询**——其对长任务超时返回会倾泻完整子代理 transcript,撑爆主上下文、抵消"只编排"的轻上下文优势。长任务派发后可先处理可并行工作或结束本轮等待通知,**不空转死等**;确需中途观察用 `block=false` 轻量查询(仍返转录,尽量不用)。(设计 §22.2)
|
|
174
190
|
- **不跳过 PRD 冻结**:PRD 必须经原型循环(或显式跳过)后才能进 ce-plan
|
|
175
191
|
- **不跳过拆分审计**:change-split-auditor 审计 verdict = PASS 是创建 change 脚手架的前置条件(S4 必选门禁)
|
|
192
|
+
- **架构门禁(v0.36.0)**:ARCH 阶段 skip 必须物化(`iterations/vN/SKIPPED` + 理由);arch-readiness(S4 拆分:快照覆盖 change 触及 BC)与 arch-snapshot(change closing)为 guard 门禁,`arch_baseline` 缺失 → WARN 不 FAIL(存量豁免)
|
|
176
193
|
- **路由是建议非决定**:S1 路由判断必须用户确认;重规划必须 DP-R 阻塞确认
|
|
177
194
|
- **回退必写 replan_log**:active → pending 回退必须记录;受影响制品归档为 .revN,重入不读旧制品
|
|
178
195
|
- **不阻断流程**:所有复利操作为 advisory 级,INDEX.md 读取失败时静默跳过
|
|
@@ -181,7 +198,7 @@ plan_hash: sha256:<plan.md 内容摘要> # 检测产品层改动后变更层
|
|
|
181
198
|
## Output Standard
|
|
182
199
|
|
|
183
200
|
每次交互结束时说明:
|
|
184
|
-
1. 当前所处阶段(S1-S5)与 `.team-flow/requirements/<req-id>/orchestrator.yaml` 状态
|
|
201
|
+
1. 当前所处阶段(S1-S5 / ARCH)与 `.team-flow/requirements/<req-id>/orchestrator.yaml` 状态
|
|
185
202
|
2. 已产出的制品(PRD/原型/plan/changes)
|
|
186
203
|
3. 下一步建议(调用哪个 skill / 进入哪个 change)
|
|
187
204
|
|