harness-sync

name	harness-sync
description	HAR: Sync Plans.md with implementation. Drift detect, marker update, retrospective. Trigger: sync-status, where am I, check progress. --snapshot for snapshots. Do NOT load for: planning, implementation, review, release.
description-en	HAR: Sync Plans.md with implementation. Drift detect, marker update, retrospective. Trigger: sync-status, where am I, check progress. --snapshot for snapshots. Do NOT load for: planning, implementation, review, release.
description-ja	HAR:Plans.md と実装の進捗同期。差分検出・マーカー更新・レトロスペクティブ。sync-status、進捗確認、今どこ、どこまで終わったで起動。--snapshot でスナップショット保存。プランニング・実装・レビュー・リリースには使わない。
kind	workflow
purpose	Reconcile Plans.md, git, and implementation state
trigger	sync-status, where am I, check progress
shape	workflow
role	synchronizer
pair	harness-plan
owner	harness-core
since	2026-05-05
allowed-tools	["Read","Edit","Bash","Grep","Glob"]
argument-hint	[--snapshot|--no-retro]
user-invocable	true
effort	medium

Harness Sync

Plans.md と実装状況を照合し、差分を検出・更新する。 旧 sync-status および harness-plan sync サブコマンドの独立版。

Quick Reference

ユーザー入力	動作
harness-sync	進捗同期 + レトロスペクティブ（デフォルト ON）
harness-sync --no-retro	進捗同期のみ（レトロスキップ）
harness-sync --snapshot	スナップショット保存（進捗の時点記録）
harness-sync --plan roadmap	named Plans の roadmap を同期
"今どこ？" / "進捗確認"	同上

オプション

オプション	説明	デフォルト
--snapshot	現在の進捗をスナップショットとして保存	false
--no-retro	レトロスペクティブをスキップ	false（デフォルトで実行）
--plan NAME	plans/manifest.json の named plan を使う	active/default

Step 0: Plans.md 検証

Plans.md の存在とフォーマットを確認する。問題がある場合は即座に案内して停止する。 複数 Plans.md がある repo では、対象 plan を scripts/plan-registry.sh list または --plan NAME で確認してから読む。

状態	案内
Plans.md が存在しない	Plans.md が見つかりません。harness-plan create で作成してください。 → 停止
ヘッダーに DoD / Depends カラムがない（v1 形式）	Plans.md が旧フォーマット（3カラム）です。harness-plan create で v2（5カラム）に再生成してください。既存タスクは自動的に引き継がれます。 → 停止
v2 形式（5カラム）	そのまま Step 1 に進む

Step 1: 現状収集（並列）

# Plans.md の状態
cat Plans.md

# Git 変更状態
git status
git diff --stat HEAD~3

# 直近コミット履歴
git log --oneline -10

# エージェントトレース（直近の編集ファイル）
 -20 .claude/state/agent-trace.jsonl 2>/dev/null | jq -r  |  -u