| name | specflow |
| description | Use when raw intent must be turned into a reviewed spec before implementation, including OpenSpec adapter, pack-backed spec generation, lightweight spec generation, acceptance criteria, non-goals, and evidence plan. 当用户要求先写 spec、意图还没变成目标/边界/验收/测试，或 adaptive-dev-workflow 路由到 SpecFlow 时使用。 |
SpecFlow
SpecFlow 是 spec 生成过程，不是整个项目执行过程。它把 intent 或 Analysis Pack 转换成可审阅的 spec artifact。
Modes
pack-backed-specflow: L2/L3 或 current truth 不清；输入为 approved Analysis Pack + Context Manifest。lightweight-specflow: L1/L2 且上下文清楚；允许直接从 intent 写轻量 spec。openspec-adapter: repo 使用 OpenSpec 时，输出到 OpenSpec proposal/spec/tasks，不生成第二套 product spec。
Output
产出一个 spec artifact，通常包含：
- Intent: 目标、非目标、约束。
- Current Truth: 当前行为和相关入口。
- Proposed Behavior: 改什么，不改什么。
- Acceptance Criteria: 可验证完成条件。
- Compatibility: API、数据、权限、状态、迁移影响。
- Evidence Plan: unit/integration/e2e/real external/fresh consumer 怎么选。
- Change Notes: 需要用户确认的风险和取舍。
Maker / Checker Gate
L2/L3 SpecFlow 不允许主 agent 自写自批。当 spec 会改变 runtime architecture、delivery contract、public API、data/auth/security model、project priority、implementation engine，或会成为后续 plan/implementation 的主依据时，使用 maker/checker：
spec-writer pass：把 intent / Analysis Pack 转成 draft spec。spec-reviewer pass：独立检查目标、非目标、边界、兼容性、验收标准、Evidence Plan、Stop/Continue 条件和实现可执行性。- Main agent：整合 review 结果，列出需要用户确认的决策。
如果没有启动 isolated spec-writer / spec-reviewer，只能把 spec 标记为 draft 或 ready_for_user_review。只有用户确认或 isolated reviewer 通过后，才能标记为 ready；approved 必须来自用户或项目既有 spec approval 流程。
Exit Gate
SpecFlow 不写生产代码，不请求 dev_done。它只能把 spec 标记为 draft/ready/approved，然后回到 adaptive strategy 的 plan 或 implementation stage。
