HAR: Sync Plans.md with implementation. An agent skill from Chachamaru127/claude-code-harness.

MITAuto-check: notesProduct & Project Management

Install Harness Sync

skills CLI
$ npx skills add Chachamaru127/claude-code-harness --skill harness-sync -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Chachamaru127/claude-code-harness harness-sync --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Chachamaru127/claude-code-harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/harness-sync .claude/skills/harness-sync && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
harness-sync
GitHub stars
3.2k
Token cost
~1.6k tokens
SKILL.md length
262 words
Files
1
Skills in repo
25
Repo updated
First seen
Licence
MIT

At a glance

HAR: Sync Plans.md with implementation. An agent skill from Chachamaru127/claude-code-harness.

  • Works in 9 steps: Plans.md 検証 → 現状収集(並列) → 5: Agent Trace 分析 → …
  • Tasks that involve Retrospectives
  • SKILL.md covers Quick Reference, オプション, Step 0: Plans.md 検証 and Step 1: 現状収集(並列), plus 9 more sections
  • Calls git and jq

What it does

Harness Sync is an agent skill from Chachamaru127/claude-code-harness. 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.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Product & Project Management, covering Retrospectives. The repository describes itself as: Claude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle. The licence is MIT.

When your agent uses it

  • Tasks that involve Retrospectives

Example prompts

  • “/harness-sync”

Requirements

  • Pre-approved tools (allowed-tools): Read, Edit, Bash, Grep, Glob

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Plans.md 検証
  2. 現状収集(並列)
  3. 5: Agent Trace 分析
  4. 差分検出
  5. Plans.md 更新提案
  6. 進捗サマリー出力
  7. 5: スナップショット保存(--snapshot 指定時)
  8. 次のアクション提案
  9. レトロスペクティブ(デフォルト ON)

What it can do on your machine

Read from SKILL.md and the folder at commit 2b2b748. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Edit
    • Bash
    • Grep
    • Glob

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • jq

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Harness Sync loads about 1.6k tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 262 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~58
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Edit, Bash, Grep, Glob

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Chachamaru127/claude-code-harness at commit 2b2b748, republished under its MIT licence (© Chachamaru127). 262 words, ~1,564 tokens.

Download SKILL.mdSave it as .claude/skills/harness-sync/SKILL.md (or your agent's skills folder).
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.
allowed-tools
Read, Edit, Bash, Grep, Glob
description-en
HAR: Sync Plans.md with implementation. Drift detect, marker update, retrospective. Trigger: sync-status, where am I, check progress. --snapshot for…
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

Harness Sync

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

Quick Reference

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

オプション

オプション説明デフォルト
--snapshot現在の進捗をスナップショットとして保存false
--no-retroレトロスペクティブをスキップfalse(デフォルトで実行)
--plan NAMEplans/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: 現状収集(並列)

bash
# Plans.md の状態
cat Plans.md

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

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

# エージェントトレース(直近の編集ファイル)
tail -20 .claude/state/agent-trace.jsonl 2>/dev/null | jq -r '.files[].path' | sort -u

Step 1.5: Agent Trace 分析

Agent Trace から直近の編集履歴を取得し、Plans.md のタスクと照合する:

bash
# 直近の編集ファイル一覧
RECENT_FILES=$(tail -20 .claude/state/agent-trace.jsonl 2>/dev/null | \
  jq -r '.files[].path' | sort -u)

# プロジェクト情報
PROJECT=$(tail -1 .claude/state/agent-trace.jsonl 2>/dev/null | \
  jq -r '.metadata.project')

照合ポイント:

チェック項目検出方法
Plans.md にないファイル編集Agent Trace vs タスク記述
タスク記述と異なるファイル想定ファイル vs 実際の編集
長時間編集がないタスクAgent Trace 時系列 vs WIP 期間

Step 2: 差分検出

チェック項目検出方法
完了済みなのに cc:WIPDoD・必須チェック・必要な review の証拠 vs マーカー
着手済みなのに cc:TODO変更ファイル vs マーカー
cc:完了 なのに未コミットgit status vs マーカー

Step 3: Plans.md 更新提案

状況確認だけの依頼は読み取りと差分報告で完了する。同期更新を明示依頼されている場合は、証拠に一致するマーカー更新を再確認せず実行する。 対象が曖昧、証拠が不足、または仕様判断が必要な項目だけ提案に残す。コミットや Worker の自己申告だけでは完了にしない。

Plans.md 更新が必要です

| Task | 現在 | 変更後 | 理由 |
|------|------|--------|------|
| XX   | cc:WIP | cc:完了 | DoD・必須チェック・review の証拠を確認済み |
| YY   | cc:TODO | cc:WIP | ファイル編集済み |

Step 4: 進捗サマリー出力

markdown
## 進捗サマリー

**プロジェクト**: {{project_name}}

| ステータス | 件数 |
|----------|------|
| 未着手 (cc:TODO) | {{count}} |
| 作業中 (cc:WIP) | {{count}} |
| 完了 (cc:完了) | {{count}} |
| PM確認済 (pm:確認済) | {{count}} |

**進捗率**: {{percent}}%

### 直近の編集ファイル (Agent Trace)
- {{file1}}
- {{file2}}

Step 4.5: スナップショット保存(--snapshot 指定時)

--snapshot が指定された場合、現在の進捗状態を時刻付きスナップショットとして保存する。

保存先

.claude/state/snapshots/ ディレクトリに JSON 形式で保存:

bash
SNAPSHOT_DIR="${PROJECT_ROOT}/.claude/state/snapshots"
mkdir -p "${SNAPSHOT_DIR}"
SNAPSHOT_FILE="${SNAPSHOT_DIR}/progress-$(date -u +%Y%m%dT%H%M%SZ).json"
スナップショット内容
json
{
  "timestamp": "2026-03-08T10:30:00Z",
  "phase": "Phase 26",
  "progress": {
    "total": 16,
    "todo": 5,
    "wip": 3,
    "done": 6,
    "confirmed": 2
  },
  "progress_rate": 50,
  "recent_commits": ["abc1234 feat: ...", "def5678 fix: ..."],
  "recent_files": ["skills/harness-work/SKILL.md", "..."],
  "notes": ""
}
差分比較

前回スナップショットが存在する場合、差分を表示:

markdown
## スナップショット差分

| 指標 | 前回 ({{prev_time}}) | 今回 | 変化 |
|------|---------------------|------|------|
| 進捗率 | {{prev}}% | {{current}}% | +{{diff}}%pt |
| 完了タスク | {{prev_done}} | {{current_done}} | +{{diff_done}} |
| WIP タスク | {{prev_wip}} | {{current_wip}} | {{diff_wip}} |

設計意図: snapshot はユーザーが「今の状態を記録しておきたい」と思った時に手動で使う。 breezing 中の自動的なプログレスフィード(26.2.3)とは別の機能。

Step 5: 次のアクション提案

次にやること

**優先 1**: {{タスク}}
- 理由: {{依頼中 / アンブロック待ち}}

**推奨**: harness-work, harness-review

異常検知

状況警告
複数の cc:WIP複数タスクが同時進行中
pm:依頼中 が未処理PM の依頼を先に処理する
大きな乖離タスク管理が追いついていない
WIP が 3日以上更新なしブロックされていないか確認

Step 6: レトロスペクティブ(デフォルト ON)

cc:完了 タスクが 1 件以上あれば自動的に振り返りを実行する。 --no-retro で明示的にスキップ可能。

Step R1: 完了タスク収集
bash
# Plans.md から cc:完了 / pm:確認済 のタスクを抽出
grep -E 'cc:完了|pm:確認済' Plans.md

# 直近の完了コミット履歴
git log --oneline --since="7 days ago"

# 変更規模
git diff --stat HEAD~10
Step R2: 振り返り 4 項目
項目分析方法
見積もり精度Plans.md のタスク記述から想定ファイル数を推論 → git diff --stat の実変更ファイル数と比較
ブロック原因blocked マーカーが付いたタスクの理由パターンを集計(技術的/外部依存/仕様不明確)
品質マーカー的中率[feature:security] 等を付けたタスクで実際に関連問題が出たか
スコープ変動Plans.md の初回コミット時のタスク数 vs 現在のタスク数(追加/削除件数)
Step R3: 振り返りサマリー出力
markdown
## 振り返りサマリー

**期間**: {{start_date}} 〜 {{end_date}}

| 指標 | 値 |
|------|-----|
| 完了タスク | {{count}} 件 |
| ブロック発生 | {{blocked_count}} 件 |
| スコープ変動 | +{{added}} / -{{removed}} 件 |
| 見積もり精度 | 想定 {{est}} ファイル → 実際 {{actual}} ファイル |

### 学び
- {{1-2 行の学び}}

### 次に活かすこと
- {{1-2 行の改善アクション}}
Step R4: harness-mem への記録

振り返りは今回確認した証拠と改善案を報告する。永続記録を明示依頼されている場合だけ、対象の harness-mem または .claude/agent-memory/ に出典と判断理由を記録する。 通常の進捗確認や sync を永続記録の依頼として扱わない。

関連スキル

  • harness-plan — 計画作成・タスク管理
  • harness-work — タスク実装
  • harness-review — コードレビュー

© Chachamaru127, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/harness-sync of Chachamaru127/claude-code-harness.

Open the folder on GitHubat commit 2b2b748

Compare with similar skills

Harness Sync next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Harness Sync compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Harness Sync this skillChachamaru127/claude-code-harness3.2k—~1.6kAutomated safety check: NotesMIT
Weekly Engineering Retrogarrytan/gstack136k—~2.4kAutomated safety check: PassMIT
Dough Execute Planterryyin/lizard2.5k—~4.3kAutomated safety check: PassCustom licence
After Action Reportrampstackco/claude-skills9401 repos~2.5kAutomated safety check: PassMIT
Oral Paper SkillAdkid-Zephyr/oral-paper-skill340—~1.9kAutomated safety check: PassNone
Deck Retroasheshgoplani/agent-deck1k—~1.8kAutomated safety check: PassMIT

Similar skills

  • Builds a weekly engineering retrospective from git history: commit counts, per-person contributions, work patterns and code quality numbers over a chosen window.

    136k GitHub stars~2.4k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Dough Execute Plan

    terryyin/lizard

    Executes one selected story or bounded retrospective correction through an executable plan, or one authorized planless slice from a selected simple story or a contextual instruction, with…

    2.5k GitHub stars~4.3k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • After Action Report

    rampstackco/claude-skills

    Run a structured after-action review (postmortem, retrospective) on a launch, incident, or completed project to capture timeline, root cause analysis, contributing factors, and actionable lessons.

    940 GitHub starsUsed in 1 repo~2.5k tokens
    Product & Project ManagementAuto-check passed
  • Oral Paper Skill

    Adkid-Zephyr/oral-paper-skill

    Help authors learn from exemplary ICLR, ICML, and NeurIPS papers through source-linked manuscript comparisons, concrete writing and experiment suggestions, and guided reflection.

    340 GitHub stars~1.9k tokensUpdated 20 days ago
    Product & Project ManagementAuto-check passed
  • Deck Retro

    asheshgoplani/agent-deck

    Run a fully local agent-deck retrospective over the user's own transcripts, Recall index and logs.

    1k GitHub stars~1.8k tokensUpdated 3 days ago
    Product & Project ManagementAuto-check passed
  • Reviews planned, completed planless quick, or quick-to-planned execution against original intent, aggregate commits, current whole-product architecture, and tests, including after cleanup.

    2.5k GitHub stars~4k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

More from Chachamaru127/claude-code-harness

All 25 skills in this repo
  • CI Failure Triage and Repair

    Chachamaru127/claude-code-harness

    Diagnoses failing CI pipelines and tests, deciding first whether the test or the implementation is at fault, and hands hard cases to a dedicated fixer subagent.

    3.2k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check: notes
  • Cursor Composer Task Delegate

    Chachamaru127/claude-code-harness

    Hands one implementation task to Cursor Composer in an isolated git worktree, then reviews its diff and cherry-picks the result into the main branch.

    3.2k GitHub stars~4.4k tokensUpdated 3 days ago
    Auto-check: notes
  • Acceptance Demo Generator

    Chachamaru127/claude-code-harness

    Renders a single HTML page showing each acceptance criterion as verified or not, with a ship, wait, or reject recommendation for non-engineers.

    3.2k GitHub stars~3.4k tokensUpdated 3 days ago
    Auto-check: notes
  • Harness Long-Running Task Loop

    Chachamaru127/claude-code-harness

    Repeats a long task as a series of scheduled wake-ups, each re-entering with fresh context and calling harness-work for one task per cycle.

    3.2k GitHub stars~2.3k tokensUpdated 3 days ago
    Auto-check: notes
  • Harness Plan

    Chachamaru127/claude-code-harness

    Creates and maintains Plans.md task plans with a spec delta, updates task markers and syncs plan progress with the implementation.

    3.2k GitHub stars~3.7k tokensUpdated 3 days ago
    Auto-check: notes
  • Harness Release

    Chachamaru127/claude-code-harness

    Runs a release for any project that keeps a Keep a Changelog file on GitHub, from version bump to merge, tag and GitHub Release after a single approval.

    3.2k GitHub stars~4.4k tokensUpdated 3 days ago
    Auto-check: notes

Questions about Harness Sync

What does Harness Sync do?

HAR: Sync Plans.md with implementation. An agent skill from Chachamaru127/claude-code-harness. Harness Sync is an agent skill from Chachamaru127/claude-code-harness.md with implementation.

When should I use Harness Sync?

Harness Sync fits situations like: tasks that involve Retrospectives.

How do I install Harness Sync in Claude Code?

Run `npx skills add Chachamaru127/claude-code-harness --skill harness-sync -a claude-code`. Or copy the skill folder (skills/harness-sync in Chachamaru127/claude-code-harness) into .claude/skills/harness-sync in your project. Claude Code loads it when a task matches its description.

How do I install Harness Sync in Codex?

Run `npx skills add Chachamaru127/claude-code-harness --skill harness-sync -a codex`. Or copy the skill folder (skills/harness-sync in Chachamaru127/claude-code-harness) into .agents/skills/harness-sync in your project. Codex loads it when a task matches its description.

Can I use Harness Sync in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Chachamaru127/claude-code-harness --skill harness-sync -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/harness-sync, .gemini/skills/harness-sync, .github/skills/harness-sync and .opencode/skills/harness-sync in your project.

What does Harness Sync need to run?

Going by SKILL.md and its folder, Harness Sync needs the command-line tools its instructions call (git and jq). Its frontmatter pre-approves these tools: Read, Edit, Bash, Grep, Glob.

Does Harness Sync access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Harness Sync safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Harness Sync use?

Harness Sync is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Harness Sync use?

About 1.6k tokens (SKILL.md is roughly 6.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Harness Sync?

Skills that share tags, products or a category with Harness Sync: Weekly Engineering Retro (garrytan/gstack, 136k stars), Dough Execute Plan (terryyin/lizard, 2.5k stars), After Action Report (rampstackco/claude-skills, 940 stars) and Oral Paper Skill (Adkid-Zephyr/oral-paper-skill, 340 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Harness Sync?

Chachamaru127 (a GitHub user) maintains it in Chachamaru127/claude-code-harness, which has 3,154 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on October 5, 2026.

Source: Chachamaru127/claude-code-harness on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.