harness-plan

name	harness-plan
description	HAR: Research-backed, team-validated task planning, Plans.md management, progress sync. Trigger: create a plan, add tasks, update Plans.md, mark complete, check progress. Do NOT load for: implementation, review, release.
description-en	HAR: Research-backed, team-validated task planning, Plans.md management, progress sync. Trigger: create a plan, add tasks, update Plans.md, mark complete, check progress. Do NOT load for: implementation, review, release.
description-ja	HAR:調査・採点・記憶確認・TeamAgent/サブエージェント検証つきのタスク計画、Plans.md管理、進捗同期を担当。計画作って、タスク追加、Plans.md更新、完了マーク、進捗確認で起動。実装・レビュー・リリースには使わない。
kind	workflow
purpose	Maintain co-required planning output for the spec.md product contract and Plans.md task contract
trigger	create a plan, add tasks, update Plans.md, check progress
shape	workflow
role	generator
pair	harness-sync
owner	harness-core
since	2026-05-05
allowed-tools	["Read","Write","Edit","Bash","Grep","Glob","WebSearch","Task"]
argument-hint	[create|add|update|sync|sync --no-retro|--ci]
user-invocable	true
effort	medium

Harness Plan

Harness の統合プランニングスキル。 以下の3つの旧スキルを統合:

• planning (plan-with-agent) — アイデア → Plans.md への落とし込み
• plans-management — タスク状態管理・マーカー更新
• sync-status — Plans.md と実装の同期確認

Quick Reference

ユーザー入力	サブコマンド	動作
"計画を作って" / /harness-plan create	create	Spec delta / skip reason → Plans.md task 生成
"タスクを追加して" / /harness-plan add	add	Plans.md に新タスク追加
"完了にして" / /harness-plan update	update	タスクマーカーを cc:完了 に変更
"今どこ？" / /harness-plan sync	sync	実装とPlans.mdを照合・同期
/harness-sync	sync	進捗確認（独立 sync surface と同等）
/harness-plan create	create	spec.md / Plans.md 二正本の計画作成
/harness-plan list	list	plans/manifest.json の named Plans を一覧
/harness-plan switch <name>	switch	active plan を .claude/state/active-plan.json に保存

Literal companion commands（CC 2.1.108+）

• /recap: 久しぶりに戻った時に要約を取り直してから sync へ入る
• /undo: /rewind の別名。直前の plan 更新を即座に戻したい時にそのまま使う

サブコマンド詳細

標準の計画品質契約

See references/planning-quality.md

harness-plan は、spec.md product contract and Plans.md task contract の co-required planning output を作る planning surface である。 precedence は spec.md > sub-spec > Plans.md のまま維持する。 Plans.md は task ledger、root spec.md は product contract であり、上下関係は崩さない。 渡された情報をそのまま Plans.md に落とさない。 計画作成や大きな task 追加では、最新情報・既存仕様・記憶・TeamAgent / サブエージェントによる複数視点の議論を確認し、 このプロダクトに取り入れるべき要素だけを task contract に変換する。 は または と task 生成をセットで返す。 出力には必ず または を含める。 / は Harness が生成し、consumer は承認・修正だけ行う。