harness-sync

Synchronize Plans.md progress with implementation via drift detection and marker updates.

2|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/fockus/claude-skill-build --skill harness-sync-fockus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-sync
Source: https://github.com/fockus/claude-skill-build/tree/main/skills/harness-sync
Command: npx skills add https://github.com/fockus/claude-skill-build --skill harness-sync-fockus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Synchronizes progress between Plans.md and actual implementation by detecting drift, updating markers, and triggering retrospectives.

Core Features & Use Cases

  • Drift detection between Plans.md and code progress with automatic marker updates.
  • Retrospective generation to capture lessons learned after task completions.
  • Progress snapshot support via --snapshot and status queries such as harness-sync and sync-status.

Quick Start

Run harness-sync to sync Plans.md with the current implementation and optionally enable snapshots.

Frequently Asked Questions about harness-sync

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

FAQPage Schema
How do I sync Plans.md with actual code implementation progress?

Sync Plans.md by running harness-sync to detect drift between your tracked tasks and code, automatically update markers, and trigger retrospectives to capture lessons learned.

What is drift detection in Plans.md and how does it work?

Drift detection compares your Plans.md task markers against actual implementation progress, identifies discrepancies, and applies automatic marker updates to keep your plans synchronized.

How do I generate a retrospective after completing a task in Plans.md?

Generate a retrospective by running harness-sync, which initiates a guided retro process after task completions to capture lessons learned and update your progress tracking.

Can I save a progress snapshot of my Plans.md implementation status?

Yes, save progress snapshots by running harness-sync with the --snapshot flag, which records your current Plans.md status and implementation progress for later reference.

How do I check sync status between my plans and code changes?

Check sync status by running harness-sync with the sync-status query, which validates your Plans.md, detects drift, and reports the current synchronization state of your implementation.

Do I need any dependencies to run Plans.md validation and marker updates?

No dependencies are required. harness-sync operates standalone to perform Plans.md validation, drift detection, marker updates, and retrospective generation without external tools.