harness-sync

Reconcile Plans.md with commits to surface implementation drift.

39|46|Updated May 29, 2026
One-click install
npx skills add https://github.com/maxwell2732/claudecode-research-harness-workflow --skill harness-sync-maxwell2732
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-sync
Source: https://github.com/maxwell2732/claudecode-research-harness-workflow/tree/main/skills/harness-sync
Command: npx skills add https://github.com/maxwell2732/claudecode-research-harness-workflow --skill harness-sync-maxwell2732

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps Plans.md in sync with the actual implementation state, surfacing drift and ensuring documentation stays aligned.

Core Features & Use Cases

  • Reconcile Plans.md with the current codebase to surface drift and drive corrections.
  • Provide retrospective context and enable point-in-time snapshots of progress.
  • Standalone version of the legacy sync-status and harness-plan sync commands.

Quick Start

Run harness-sync to perform a progress sync and, if desired, a retrospective; use --snapshot to record a point-in-time state.

Frequently Asked Questions about harness-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect drift between my Plans.md file and the actual codebase implementation?

To detect drift between your Plans.md and the actual codebase, you can run a reconciliation process that validates the plan structure and compares plan items against recent commits to surface misalignments.

What is the best way to keep project plans in sync with evolving code?

Keeping project plans in sync with evolving code involves reconciling the planning document with the implementation state by comparing planned items to commits, driving corrections and ensuring documentation stays aligned.

Can I take a point-in-time snapshot of my project plan progress?

Yes, you can take a point-in-time snapshot of your project plan progress by running the sync process with a snapshot flag, which records the current state of your implementation reconciliation.

How do I generate a retrospective report for plan implementation status?

Generating a retrospective report for plan implementation status requires running a sync process that compares your planning document to actual commits and provides retrospective context to record progress over time.

Does plan-implementation reconciliation work for projects without a structured Plans.md file?

Plan-implementation reconciliation requires a living Plans.md file with a valid structure; the process validates the document's structure before comparing its items to commits, so projects without structured plans cannot be reconciled.