Coding Agent Harness 工程方法论

一套经过真实项目验证的方法论，用于在任意项目上构建 Coding Agent 的工程化支撑体系。

核心理念

• 文档是写给 Agent 看的，不是写给人看的。 人看排期表、架构文档和执行 output。Agent 看 task_plan、walkthrough、reference 标准。
• 上下文不是越多越好，是越准越好。 AGENTS.md 做目录不做百科；CLAUDE.md 只做 Claude Code 兼容 shim，不做第二份规范。
• 单元测试只是底线，不是保障。 真正的保障需要多层证据（Evidence Depth）。
• 先识别交付组织，再设计 harness。 一人多 agent、多人团队、前后端分仓、program 多仓、敏捷/瀑布，对应的 SSoT 和冲突治理不同。
• Repo 护栏是地基。 CI/CD、PR policy、branch protection、required checks、worktree concurrency 必须项目级定制，不能停留在模板。
• 外部资料先摄取，再投影。 微服务或多仓项目的外部文档不能直接塞进执行文档；先建 source pack、digest、验证，再投影到 context/{architecture,development,integrations}。
• 长程任务先设计合同，再开放执行。 连续跑数小时的前提是 Goal、Scope、Review Loop、Evidence、Stop Condition 都清楚。
• 审查必须落盘。 对抗性 review 是独立交付物，不应只留在对话、progress 或 walkthrough 里；reviewer 必须用 Confidence Challenge 反复挑战方案，直到没有 open material finding。
• Worker handoff 必须 commit-backed。 可写 subagent 不是 reviewer；它必须在独立 worktree / branch 内实现、验证并提交，再由 coordinator 集成。
• 严肃项目用顶级模型。 便宜模型的返工成本远高于差价。
• 强制流程优于口头约定。 每个步骤都应该是 agent 可自主执行的。

Product Contract