sync-fix

Detect and fix inconsistencies across Phase tasks, Sprint backlogs, and progress records.

1|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/tygwan/AgenticREVIT --skill sync-fix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-fix
Source: https://github.com/tygwan/AgenticREVIT/tree/main/.claude/skills/sync-fix
Command: npx skills add https://github.com/tygwan/AgenticREVIT --skill sync-fix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill detects and fixes inconsistencies across Phase tasks, Sprint backlogs, PROGRESS.md, and CHANGELOG to maintain alignment and reduce manual reconciliation.

Core Features & Use Cases

  • Discrepancy detection: identifies mismatches between Phase tasks and PROGRESS.md, Sprint backlog vs Phase tasks, and CHANGELOG vs Git commits.
  • Auto-sync & auto-fix: recalculates progress, updates Sprint statuses, regenerates PROGRESS.md, and fixes broken links when possible.
  • Validation & reporting: reports conflicts, suggests fixes, and provides an option to perform a safe dry-run before applying changes.
  • Use Case: When Phase tasks are completed but Sprint backlog lags behind, run this skill to synchronize statuses and documentation automatically.

Quick Start

Run /sync-fix with the appropriate targets (e.g., --phase, --sprint, --progress) and optional flags like --dry-run or --backup to preview and apply fixes.

Frequently Asked Questions about sync-fix

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

FAQPage Schema
How do I fix inconsistencies between my Phase tasks and progress documentation?

Sync-fix detects and automatically reconciles mismatches between Phase tasks, Sprint backlogs, PROGRESS.md, and CHANGELOG. Run it with target flags like --phase and --progress to identify conflicting statuses and apply deterministic updates across your documentation.

Can I preview synchronization changes before applying them to my project documents?

Yes. Sync-fix includes a --dry-run flag that lets you review all proposed fixes and conflict resolutions without modifying your files. You can also enable --backup to preserve originals before applying changes.

What should I do when my Sprint backlog status diverges from completed Phase tasks?

Run sync-fix with --sprint and --phase targets to automatically recalculate Sprint statuses and align them with Phase task completion. It enforces mismatch detection and updates backlog entries to match the authoritative source you specify.

How does sync-fix handle broken links and document references in project documentation?

Sync-fix validates and regenerates broken links across Phase tasks, Sprint backlogs, and progress records. It checks link integrity during reconciliation and repairs references when possible, maintaining consistency across your documentation set.

When should I use sync-fix versus manual documentation updates?

Use sync-fix when multiple documents—Phase, Sprint, progress, and changelog—may have diverged and need unified reconciliation. It's built for automated detection and deterministic fixes across workflows where manual syncing creates drift and inconsistency.

Does sync-fix compare documentation against Git commit history?

Yes. Sync-fix detects discrepancies between CHANGELOG entries and Git commits as part of its reconciliation scope. It identifies when logged changes don't match actual repository history and can flag these conflicts for resolution.