用途:把用户原始需求文档转成有纪律的交付流水线,核心产物为 br/BR.md(已确认的业务需求),所有 frame 与条款都可回溯到它。
主要能力:单一入口按范围选择模式——interview(读 llmwiki/raw/,按 S1–S10 生成 spec-filled.md、questions.html 与 answers.md)、compile(生成 BR.md、BR.clauses.json,含 clause_id 与 provenance,UI 类项目另出 DESIGN.md)、slice(提出切片并写 frames 与 index.md)、run(对单个 frame 执行循环并在成功后提交)、status(生成 line-status 报告)。提供确定性工具:spec-template/frame-template/design-template、frame-lint.py、loop-runner.py、build-line-status.py、br-fill.py、br-run.py、br-queue.py、checkpoint.py、br-prompts.py。
使用方式:主要动作为 br-run.py run br/frames/<frame>.md --root .(可加 --print-prompt);批量可 python3 fdk/tools/br-queue.py run --queue br/queue.yaml;局部重跑用 br-queue.py affected <frame_id> --queue br/queue.yaml --reset 后 run。其它常用命令:python3 fdk/tools/br-fill.py check-contract --root .、python3 fdk/tools/frame-lint.py check br/frames --root .、python3 fdk/tools/build-line-status.py build。
适用场景:已有原始需求、希望以 thin-slice 与人在回路方式推进到可发布产物的项目。
限制:不写 llmwiki/raw/,不重写既有确定性工具,不自动 commit/merge 代替人工,不手工改 UI,不自动触发 hook;lens-fill 结果恒为 verified:false;frame 属 compensable/irreversible 时须 --ack-tier;触发 KILL 条件则整轮取消,不提升闸门;UI 验收须有真实截图与 MANIFEST.json。