工作流

持久的事实存在于仓库里。repo-harness 把计划、契约、审查和检查都保存为文件，这样任何会话——或任何 agent——都能从上一个停下的地方原样接手。

Plan → Sprint → Goal

repo-harness prd      # plans/prds/<name>.prd.md
repo-harness sprint   # plans/sprints/<name>.sprint.md
repo-harness goal     # a bounded /goal handoff for Codex or Claude

• PRD——plans/prds/ 中一份便于实现的产品需求文档。
• Sprint——plans/sprints/ 中一个有序的 backlog，逐行展开。
• Goal——交给执行器的一个有界执行包。

持有状态的文件

路径	持有什么
plans/	带时间戳的计划目录；.ai/harness/active-plan 选定当前活动的那一份
tasks/contracts/	一个任务的编辑范围授权（allowed_paths）
tasks/reviews/	完成门禁——每个任务一张 Human Review Card
tasks/todos.md	延期目标台账
.ai/harness/checks/latest.json	最新的验证快照

每个任务一张 Human Review Card

每个任务都以一张人可以验收的卡片收尾：一个结论、预期与实际的文件清单、通过的命令、残余风险，以及一行回滚说明。当你准备落地时，repo-harness check 运行验证门禁，repo-harness ship 打开 PR。