coding-agent-harness について
ソフトウェアプロジェクトでコーディングエージェントを支える仕組みを構築・保守するスキルです。診断、導入、設定、検証、引き渡しを扱い、タスクの証拠記録やレビューを実行可能な手順に組み込みます。
主な機能
- 01プロジェクト診断と運用モデルの選択
- 02Harness の導入と段階的な移行
- 03タスクライフサイクルと証拠の記録
- 04敵対的レビューとコミットを伴う引き継ぎ
- 05回帰検証と成果サマリー
活用シーン
- 01既存プロジェクトの Harness を段階的に更新
- 02新規プロジェクトのコーディングエージェント運用を整備
- 03複数モジュールやリポジトリの作業を調整
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ fairladyz625/ coding-agent-harness --skill coding-agent-harnessインストール後、Claude Code で/coding-agent-harnessを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
.gitmodulesREADME.en-US.mdLICENSE-EXCEPTION.md.gitignoreLICENSECONTRIBUTING.mdCHANGELOG.mdREADME.zh-CN.mdREADME.md.github/pull_request_template.mdCODEOWNERS.github/workflows/ci.ymldocs-release/README.mddocs-release/architecture/overview.mdoverview.zh-CN.mddocs-release/architecture/document-contract-kernel/README.mddocs-release/architecture/document-contract-kernel/products/lite-forbidden-surfaces.txtlite-skill-overlay.mdfull-skill-overlay.mddocs-release/architecture/system-explainer/01-system-overview.md02-module-dependency.md03-task-lifecycle.md06-preset-and-migration.mdREADME.md05-data-flow.md04-check-and-governance.mddocs-release/architecture/system-explainer/en-US/01-system-overview.md02-module-dependency.md03-task-lifecycle.md04-check-and-governance.md詳細
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
Full Harness 与后续 Lite Skill 的共享任务语义由 Document Contract Kernel
约束,公开源位于 docs-release/architecture/document-contract-kernel/README.md。
凡是改变 AGENTS、context、task package、progress、walkthrough、review、
regression 或 lessons 基础语义的改动,必须按该 contract 同步 Full/Lite
overlay 与 compatibility matrix;Full-only 的 CLI、Dashboard、Preset、
generated ledger、Module Registry、lifecycle command、runtime requirement
不得泄漏进 Lite source。
主执行 SOP
如果用户要求"更新 harness"、"同步最新版 harness"、"把项目升级到最新 coding-agent-harness",不要重新 bootstrap 覆盖整个项目。先执行增量更新流程:
- 读取本 Skill 的最新版
SKILL.md、相关references/、templates/。 - 扫描目标项目现有
AGENTS.md、CLAUDE.md、coding-agent-harness/和 SSoT / Ledger 文件。 - 输出 delta plan:哪些 harness 骨架、reference、template、SSoT、Ledger 项缺失或过期。
- 只补齐新增标准和缺失结构;不得用模板覆盖已有业务事实、历史 walkthrough、 task progress、generated ledger、Regression SSoT 或 lesson detail docs。
- 对已有文档采用 merge / append / residual-with-reason;只有全新缺失文件才从模板创建。
- 如果引入 Harness Ledger、lesson detail docs 或新的 reference/template,同步更新入口索引。
- 收口时写 walkthrough,必须包含 Lessons Reflection;新任务先写并审查
lesson_candidates.md。如人工标记值得沉淀,默认先用 dry-run 或后续 lesson sedimentation 任务完成分类、冲突检查和建议 diff;只有人工明确批准后, 维护命令才写coding-agent-harness/governance/lessons/详情文档;最后在coding-agent-harness/governance/generated/Harness-Ledger.md与coding-agent-harness/governance/generated/Closeout-Index.md记录本次 harness update 的 delta 和 Lessons Check。
一句话:harness update 是 delta merge,不是重新搭一遍。
当用户要求在项目上搭建 harness 时,使用 v1.0 的六阶段安装流程。安装不是
npm install 式复制文件,而是 CLI scaffold 与 Agent configure 配合完成。
面向 agent 的详细安装和迁移说明见
docs-release/guides/agent-installation.md。如果本 Skill 与该指南出现差异,以
本 Skill 的执行约束为准,并把差异记录为需要修复的文档漂移。
CLI 示例默认使用目标项目可调用的 harness 命令。执行前先检查
command -v harness;如果没有,不要静默全局安装,按安装指南询问用户是否
允许 npm install -g coding-agent-harness。未获明确同意时,用
npx --yes coding-agent-harness <command> 执行同一条命令。只有维护本源码
checkout 时,才把 harness 替换为 node dist/harness.mjs;源码仓的
dist/ 是生成物,若不存在先运行 npm install 或 npm run build:runtime。
Agent 安装合同
这个 CLI 的主要操作者通常是目标项目里的 agent,而不是最终用户。Agent 不应要求用户 记命令、读模板目录或手动判断 locale;这些决策必须由 agent 在安装流程中完成。
- 交互式安装:如果用户在场,agent 必须先确认文档语言,再运行
harness init --locale zh-CN|en-US --capabilities ...。也可以让 CLI 交互提问, 但 agent 仍要在收口说明中写明最终选择。 - 非交互式安装:agent 不得依赖 CLI 的
en-US默认值;必须从用户语境、项目语言或 明确配置中推断 locale,并显式传--locale。如果无法判断,先暂停询问。 - 中文用户或中文项目默认选择
zh-CN;英文团队、英文代码库或用户明确要求英文时选择en-US。 - scaffold 后必须检查
coding-agent-harness/harness.yaml的locale,并确认 dashboard、 task template、review template 来自同一套模板树。 templates/和templates-zh-CN/是两套完整模板树。不要在目标项目里混拷两套模板; 只允许保留 schema 字段、文件名、状态枚举、命令和跨工具协议 token 的英文。- 如果只是 dogfood 测试,默认清理目标项目里的测试产物,不提交。
Phase 1: Diagnose / 项目诊断
读 references/project-onboarding-audit.md,扫描项目技术栈、目录结构、现有文档、
CI、团队/agent 协作方式和风险面,输出诊断报告。
如果发现项目属于微服务、多仓、前后端分仓、平台子系统,或代码中出现外部服务、
SDK、API gateway、message queue、webhook、contract、schema、mock,必须询问用户是否有
外部资料。问题至少覆盖:是否有外部团队文档、接口文档、架构图、会议纪要、链接或导出包;
这些资料能否复制进仓;哪些资料是可信来源。外部资料处理方法见
references/external-source-intake-standard.md。
Phase 2: Decide / 方案决策
与用户确认三件事:
- 文档语言:
zh-CN或en-US。中文用户默认应获得中文任务、评审、 ledger、SSoT、walkthrough 和 reference draft。 - Delivery Operating Model:solo-orchestrator、team-feature-lead、 split-repo-contract、program-multi-repo、waterfall-stage-gate 或 kanban-continuous。
- Capability Packs:core 必装;按需选择 module-parallel、subagent-worker、
adversarial-review、long-running-task、dashboard。旧项目先用
migrate-structure --plan/--apply迁到 v2,不再通过兼容 capability 长期运行。 - External Source Intake:如果外部资料超过 5 份、跨多个主题或会持续增长,
决定是否创建
coding-agent-harness/context/development/external-source-packs/<source-key>/。
Capability 选择规则必须按表执行,不得凭感觉多装:
| Capability | 何时选择 |
|---|---|
core | 永远安装。它是任务计划、回归、walkthrough、Lessons 和 Harness Ledger 的最小内核。 |
dashboard | 用户或 agent 需要本地只读状态页时安装。它不写目标项目文件。 |
adversarial-review | 发布、架构、安全、数据、策略风险需要独立 review artifact 时安装。 |
long-running-task | 用户允许 agent 多轮连续执行、不能每步都询问时安装。 |
module-parallel | 项目有 2 个以上可独立演进模块,且需要模块 owner / registry / 同步规则时安装。 |
subagent-worker | 会改代码的 subagent 需要独立 worktree + commit-backed handoff 时安装;它依赖 module-parallel。 |
如果选择了某个可选 capability,bootstrap summary 必须写清触发它的项目事实。
Phase 3: Scaffold / 脚手架
运行或模拟 harness init --locale zh-CN|en-US --capabilities ...。面向 agent 的安装
必须显式传 --locale;只有人直接在终端运行且未传 --locale 时,CLI 才交互询问。CLI 只创建
目录、模板、空表、索引和 coding-agent-harness/harness.yaml,不得把项目级 reference
伪装成已经定制完成的标准。
CLI 会在 JSON 输出中返回 report。Agent 必须读取这份 report,并把其中的
locale、selectedCapabilities、created/skipped、agentInstructions 和
verificationCommands 转化为交付 summary;不能只看命令退出码。
Phase 4: Configure / 对话式定制
Agent 根据项目事实与用户讨论后定制 AGENTS.md、reference standards、CI/CD、 Regression surface、Delivery SSoT、Module Registry、review routing 和 worktree/subagent handoff 规则。已有项目事实只能 merge/append/residual, 不能模板覆盖。
如果用户提供了外部资料,Configure 阶段必须按
external-source-intake-standard.md 执行:Inventory、Classify、Sanitize、Digest、
Project、Verify、Residual。external-source-packs/ 只保存资料索引、摘要和投影状态;
稳定事实必须回写到 coding-agent-harness/context/architecture、coding-agent-harness/context/development/external-context 或
coding-agent-harness/context/integrations。
Phase 4b: Task Lifecycle / 任务生命周期
初始化或迁移完成后,活跃任务必须通过 CLI 创建和推进,避免 agent 手工复制模板造成漂移:
harness new-task --title "<title>" --locale zh-CN|en-US /path/to/project
harness task-start <task-id-from-new-task-output> --message "<what started>" /path/to/project
harness task-log <task-id-from-new-task-output> --message "<what changed>" --evidence "command:TARGET:path:summary" /path/to/project
harness task-block <task-id-from-new-task-output> --message "<blocker>" /path/to/project
harness task-review <task-id-from-new-task-output> --message "<ready for review>" /path/to/project
harness review-confirm <task-id-from-new-task-output> --confirm <task-id-from-new-task-output> --message "<human confirmation>" /path/to/project
harness task-complete <task-id-from-new-task-output> --message "<closeout>" /path/to/project
harness lesson-promote <task-id-from-new-task-output> <candidate-id> --dry-run /path/to/project
harness task-list --json /path/to/project
new-task --budget simple创建轻量任务目录:brief.md、task_plan.md、visual_map.md、progress.md。new-task默认standard,创建完整任务目录,包括brief.md、计划、策略、路线图、进度、发现和审查文件。new-task --budget complex在完整任务文件之外创建 optional references/artifacts 索引。new-task --title "<title>"默认生成YYYY-MM-DD-<title-slug>-<8hex>任务 ID,降低多人和多 agent 同仓创建任务时的重名概率;只有 coordinator 需要固定兼容 ID 时才传显式<task-id>。- 已存在任务不会被覆盖;旧项目迁移时先
task-list --json,再决定复用旧任务还是开新任务。 - 状态推进只写
progress.md,不得重写历史task_plan.md。 simple任务可以直接in_progress -> done;standard/complex必须in_progress -> review -> done,不能跳过task-review。task-review只表示 Agent Review Submission:agent/coordinator 认为材料包已准备好并提交待审。它不是人工确认。review-confirm是唯一的 Human Review Confirmation 门禁。它只确认人工 review evidence / findings,不代表 closeout;closeout 仍走 walkthrough / Closeout Index。- Review queue 只收录已提交 review packet、材料齐全、无 blocker、等待人工确认的任务。
- 缺文件、缺章节、缺证据、缺 lesson decision 或未执行
task-review的任务进入 Missing Materials 队列,不进入 Review queue。 - open blocking finding、状态矛盾、审计失败或需要 human waiver 的任务进入 Blocked 队列,不进入 Review queue。
- 已 Human Review Confirmation 但 closeout / ledger / lesson routing 未完成的任务属于 Confirmed / Finalized 队列,不应显示成“仍在审查”。
- lesson candidate 进入 Lessons 队列后,默认先 dry-run 或创建后续沉淀任务;不要在 Dashboard 或普通 closeout 中直接写共享 Lessons 表。
- soft delete / supersede / archive 是只读可追溯生命周期,默认不 hard delete 任务目录;保留 tombstone、替代任务、原因和审计记录。
- 证据必须进入
task-log或progress.md,并继续遵守type:PATH:summary格式。
Phase 5: Verify / 验证
运行当前 repo 支持的检查命令,例如:
harness check --profile target-project /path/to/project
harness status --json /path/to/project
如果是在开发或修改本 harness 自身,Phase 5 必须覆盖两条回归路径:
| 回归路径 | 必须证明 |
|---|---|
| 新项目初始化 | 空项目 `init --locale zh-CN |
| 老项目迁移 | 已有旧 harness 文档的项目先 migrate-structure --plan,再 migrate-structure --apply;旧 coding-agent-harness/ 和 legacy registry 从 active root 移走或归档;迁移后 status/check/dashboard 只读 v2 路径。 |
检查失败时不能声称 harness complete;必须修复或记录 owner/action/status 明确的 residual。
旧项目迁移时必须先运行:
harness migrate-plan --json /path/to/project
然后按 docs-release/guides/migration-playbook.md 分阶段处理。不要机械迁移所有历史
task;先迁移活跃或重新打开的任务,再升级当前门禁相关 review 和 capability。
Phase 6: Deliver / 交付
输出 bootstrap summary,说明创建/定制了哪些文件、启用了哪些 capability、当前 语言是什么、哪些检查通过、哪些 residual 仍需用户或后续任务处理,并建议首批任务。
Summary 至少包含:
locale- selected capabilities 及选择理由
- scaffold 创建和跳过的文件
- Configure 阶段做了哪些项目化改动
- 验证命令和结果
- residual owner / action / status
- 是否提交;若只是 dogfood 测试,必须清理测试产物
旧版 Bootstrap 参考
旧 12 阶段 bootstrap 只作为兼容迁移参考,不再放在 Skill 主执行协议里。
需要理解旧项目结构或把旧任务迁移到 v1.0 时,读取
references/legacy-12-phase-bootstrap.md。
最小交付清单
harness bootstrap 完成后,项目中至少应存在以下文件:
-
AGENTS.md,默认 80-160 行,宪章 + 阅读矩阵,不承载安装教程 -
CLAUDE.md,Claude Code 兼容 shim,指向AGENTS.md(不复制完整规范) -
coding-agent-harness/governance/standards/下至少 3 个标准文件 -
coding-agent-harness/planning/tasks/_task-template/包含 task plan / findings / progress / review 模板 -
coding-agent-harness/governance/standards/delivery-operating-model-standard.md -
coding-agent-harness/governance/standards/repo-governance-standard.md -
coding-agent-harness/governance/standards/ci-cd-standard.md -
coding-agent-harness/governance/standards/long-running-task-standard.md -
coding-agent-harness/governance/standards/adversarial-review-standard.md -
coding-agent-harness/governance/standards/review-routing-standard.md -
coding-agent-harness/planning/tasks/_task-template/long-running-task-contract.md -
coding-agent-harness/planning/tasks/_task-template/review.md -
coding-agent-harness/governance/regression/Regression-SSoT.md -
coding-agent-harness/governance/regression/Cadence-Ledger.md -
coding-agent-harness/governance/standards/walkthrough-template.md -
coding-agent-harness/governance/generated/Closeout-Index.md -
coding-agent-harness/governance/lessons/(空目录 + .gitkeep) -
coding-agent-harness/governance/archive/(空目录 + .gitkeep) -
coding-agent-harness/governance/generated/Harness-Ledger.md -
coding-agent-harness/governance/standards/external-source-intake-standard.md -
coding-agent-harness/governance/standards/harness-ledger-standard.md -
.github/pull_request_template.md或 platform-specific PR template / residual - CI workflow 或
ci-cd-standard.md中的 blocked-with-owner residual - Branch protection plan 和 required checks 状态
- Worktree concurrency policy
- Delivery operating model 已选择;多人/多仓模式下有
coding-agent-harness/planning/Delivery-SSoT.md - 如启用模块并行:
coding-agent-harness/planning/modules/Module-Registry.md - 如启用模块并行:
coding-agent-harness/planning/modules/Session-Prompt-Pack.md或每模块session_prompt.md - 如启用模块并行:每个 active module 有
coding-agent-harness/planning/modules/<key>/module_plan.md - 如启用模块并行:模块 task template / shared lock / dependency readiness 规则已落地
- Harness checker 已通过,或 residual 写明 owner/action/status
- Bootstrap Summary 已输出给用户
Feature の完全なライフサイクル
harness の構築が完了した後、各 feature をアイデアからコードにするまでの標準的なフローです。
- ブレインストーミング — 要件を話し合い、設計記録を作成します
- ファイルを使った計画 — タスクディレクトリを作成し、task plan / findings / progress / review ファイルを用意します
- 長時間実行の契約(該当する場合) — 継続実行の権限、review loop、evidence、stop condition を明確にします
- デリバリー運用モデル — 今回のデリバリー形態が solo / team / split-repo / program / stage-gate / kanban のどれに当たるかを確認します
- タスクライフサイクルの事実 — タスクローカルの事実ファイルを更新します。タスクライフサイクルの総覧は CLI が生成します。モジュールを並行して進める場合、worker は module_plan + Coordinator Handoff を書き戻し、coordinator の pass で Module Registry を書き戻します。複数人/複数リポジトリの場合は Delivery SSoT を維持します
- リポジトリガバナンス/CI-CD — PR policy、required checks、branch protection、worktree concurrency を確認します
- Worktree/ブランチでの並行開発 — operating model に基づき、worktree、feature branch、contract branch、release branch のいずれを使うかを決定します
- サブエージェントへの worker 引き継ぎ(該当する場合) — coordinator は独立した worktree / branch / write scope を割り当てます。worker は自身の commit を作成し、commit SHA / checks / residuals を引き継ぎます
- 敵対的レビュー報告(該当する場合) — タスクディレクトリに
review.mdを作成し、Agent Review Submission、material findings / no-finding / residual risk を記録します。このステップはレビュー待ちとして提出したことを示すだけであり、人による承認を意味するものではありません - レビューの振り分け — planned task の完了前に subagent / reviewer によるレビューを自動的に開始するか、skip reason を記録します。Review queue は Human Review Confirmation のみを待ち、資料不足と blocker はそれぞれ Missing Materials / Blocked queue に入ります
- マージ+自動回帰テスト — Cadence Ledger が対応する回帰テスト範囲を開始します。coordinator は worker の commit のみを統合し、複数の worker による未コミットの変更を混在させません
- Walkthrough の完了処理 — 完了記録を作成し、review report を参照します
- Closeout Index の書き戻し — closed 状態の各タスクについて、walkthrough のパスまたは管理された skip reason を必ず記録します
- Lessons の振り返り — walkthrough の作成時に、共通する問題や繰り返し発生する問題を積極的に振り返ります。新しいタスクでは
lesson_candidates.mdを使って人による判断を記録し、queued-promotionを Lessons queue に入れます。デフォルトではまず dry-run を実行するか、知見を蓄積するタスクを作成し、共有 Lessons テーブルには直接書き込みません。checked-createdには promoted lesson の詳細ドキュメントが必要です。旧タスクとの互換性のためのchecked-noneには、理由を明記する必要があります - Generated Ledger の更新 — lifecycle CLI または
harness governance rebuildによって、タスクライフサイクルの総合インデックスを生成します - Worktree のクリーンアップ — マージ済みの worktree を削除します
リファレンス索引
旧 12 段階の番号は references/legacy-12-phase-bootstrap.md にのみ残されています。以下では v1.0 の機能とタスクの状況に応じて参照先を案内し、旧 Phase 番号は使用しません。
| モジュール | リファレンス | 参照するタイミング |
|---|---|---|
| プロジェクト診断 | references/project-onboarding-audit.md | Diagnose フェーズでプロジェクトの形態、リスク、harness の深さを判断するとき |
| AGENTS.md + CLAUDE.md | references/agents-md-pattern.md | Scaffold / Configure の入口ルーティングファイルを作成するとき |
| ディレクトリ構成 | references/docs-directory-standard.md | docs の構成を Scaffold するとき、またはディレクトリの境界を確認するとき |
| 外部資料の取り込み | references/external-source-intake-standard.md | プロジェクトがマイクロサービス、複数リポジトリ、外部チームの資料、またはユーザー提供の資料パッケージに依存するとき |
| Delivery Operating Model | references/delivery-operating-model-standard.md | Decide フェーズで solo / team / split-repo / program / stage-gate / kanban を選択するとき |
| リポジトリガバナンス | references/repo-governance-standard.md | PR、ブランチ、worktree、コミット、リリースの境界を設定するとき |
| CI/CD | references/ci-cd-standard.md | required checks、release gate、CI residual を設定または検証するとき |
| 計画ループ | references/planning-loop.md | タスク計画を作成、進行、または移行するとき |
| 長時間実行タスク | references/long-running-task-standard.md | 継続実行、長いコンテキスト、または stop condition が必要なタスクの場合 |
| 敵対的レビュー | references/adversarial-review-standard.md | 独立したレビュー報告、信頼度への異議申し立て、または material finding のレベル分けが必要なとき |
| レビューの振り分け | references/review-routing-standard.md | セルフレビュー、subagent、外部 reviewer、人によるレビューのいずれにするか決めるとき |
| SSoT ガバナンス | references/ssot-governance.md | Delivery / Regression など、タスクライフサイクル以外の事実を維持するとき |
| Lessons のガバナンス | references/lessons-governance.md | walkthrough の完了後、lesson を蓄積するか判断するとき |
| Harness Ledger | references/harness-ledger.md | 生成されたタスクライフサイクル ledger と、タスク以外のガバナンステーブルの境界を把握するとき |
| 回帰テスト | references/regression-system.md | 回帰テスト範囲、evidence depth、gate を設計または更新するとき |
| Cadence Ledger | references/cadence-ledger.md | 変更の種類に応じて回帰テストの実行単位を開始するとき |
| Walkthrough | references/walkthrough-closeout.md | 完了処理、Closeout Index、デリバリーの説明を行うとき |
| Worktree | references/worktree-parallel.md | 並行開発、worker の引き継ぎ、またはブランチの分離を行うとき |
テンプレート索引
| テンプレート | パス | 用途 |
|---|---|---|
| AGENTS.md | templates/AGENTS.md.template | 対象プロジェクトのエージェント入口:憲章 + 読み取りマトリクス |
| CLAUDE.md | templates/CLAUDE.md.template | Claude Code 互換 shim。AGENTS.md を参照 |
| Regression SSoT | templates/ssot/Regression-SSoT.md | 回帰範囲、エビデンスの深さ、ゲートの状態 |
| Delivery SSoT | templates/ssot/Delivery-SSoT.md | 複数人・複数リポジトリ・段階的なデリバリープラン |
| Harness Ledger | templates/ledger/Harness-Ledger.md | CLI が生成するタスクライフサイクルの総合インデックス |
| Lesson (ref-change) | templates/lessons/lesson-ref-change.md | ウォークスルーの完了後 |
| Lesson (new-doc) | templates/lessons/lesson-new-doc.md | ウォークスルーの完了後 |
| Lesson (arch/process) | templates/lessons/lesson-arch-process-change.md | ウォークスルーの完了後 |
| Cadence Ledger | templates/regression/Cadence-Ledger.md | 回帰テストの実施タイミングとバッチ記録 |
| Task Plan | templates/planning/task_plan.md | 現在のタスク計画 |
| Findings | templates/planning/findings.md | 発見事項、リスク、残存事項 |
| Progress | templates/planning/progress.md | ライフサイクルの状態と実行ログ |
| Review Report | templates/planning/review.md | レビューでの発見事項、確認事項、残存リスク |
| Long-Running Task Contract | templates/planning/long-running-task-contract.md | 長期タスクの承認、レビューの反復、停止条件 |
| Module Session Prompt | templates/planning/module_session_prompt.md | モジュール並行開発セッションのコールドスタート |
| Walkthrough | templates/walkthrough/walkthrough-template.md | タスク完了の記録 |
| Closeout Index | governance rebuild generated output | governance/generated/Closeout-Index.md はタスク完了メタデータから再構築され、独立したテンプレートはありません |
| Testing Standard | templates/reference/testing-standard.md | テスト、スモークテスト、回帰テストの規範 |
| Execution Workflow | templates/reference/execution-workflow-standard.md | 実行、コミット、PR、エビデンスの記録 |
| Delivery Operating Model Standard | templates/reference/delivery-operating-model-standard.md | デリバリー組織モデルの選択 |
| Repository Governance Standard | templates/reference/repo-governance-standard.md | リポジトリ、ブランチ、PR、worktree のルール |
| Pull Request Standard | templates/reference/pull-request-standard.md | PR の説明、日英バイリンガル、バージョンへの影響、検証、参照 |
| CI/CD Standard | templates/reference/ci-cd-standard.md | CI/CD、必須チェック、リリース時の残存事項 |
| Long-Running Task Standard | templates/reference/long-running-task-standard.md | 長期タスクのプロトコル |
| Adversarial Review Standard | templates/reference/adversarial-review-standard.md | 敵対的レビューのプロトコル |
| Review Routing Standard | templates/reference/review-routing-standard.md | reviewer / subagent / 人間によるレビューの振り分け |
| Docs Library | templates/reference/docs-library-standard.md | ドキュメントの構成、命名、アーカイブ |
| External Source Intake Standard | templates/reference/external-source-intake-standard.md | 外部資料の取り込み、要約、投影 |
| Harness Ledger Standard | templates/reference/harness-ledger-standard.md | Harness Ledger の書き込み規範 |
| Regression Governance | templates/reference/regression-ssot-governance.md | Regression SSoT のガバナンス |
| Walkthrough Standard | templates/reference/walkthrough-standard.md | walkthrough / closeout / lessons の完了規範 |
| Worktree Standard | templates/reference/worktree-standard.md | worktree、ブランチ、ワーカーへの引き継ぎ |
| Engineering Standard | templates/reference/engineering-standard.md | エンジニアリングとアーキテクチャの制約 |