sync-docs

Scan recent code changes and merge design decisions into SPEC.md.

1|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/justincordova/agents --skill sync-docs-justincordova
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: sync-docs
Source: https://github.com/justincordova/agents/tree/main/skills/sync-docs
Command: npx skills add https://github.com/justincordova/agents --skill sync-docs-justincordova

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reconcile documentation with the current state of the codebase to fix drift.

Core Features & Use Cases

  • On-demand doc reconciliation to reflect implemented features and decisions.
  • Merge design decisions into SPEC.md and consolidate multiple iterations into a single coherent update.
  • Guardrails to avoid automatic runs, ensuring deliberate activation only.

Quick Start

Run the sync-docs command to reconcile documentation with the current codebase and consolidate updates.

Frequently Asked Questions about sync-docs

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

FAQPage Schema
How do I fix documentation drift in my codebase?โ–ผ

You reconcile documentation with the current codebase state to fix drift. This skill scans recent code changes, identifies affected documents, and merges design decisions into SPEC.md to consolidate updates without auto-running.

What is the best way to consolidate multiple iterations into SPEC.md?โ–ผ

Consolidate iterations into SPEC.md through on-demand doc reconciliation. It merges design decisions and multiple feature iterations into a single coherent update reflecting the current implemented codebase state.

How do I merge design decisions into SPEC.md during a release cycle?โ–ผ

Merge design decisions into SPEC.md by triggering on-demand doc reconciliation during feature iteration or release cycles. It scans recent code changes and consolidates diverged design files into a single coherent update.

Does documentation sync run automatically when code changes?โ–ผ

No, documentation sync does not run automatically. Guardrails prevent automatic execution, ensuring deliberate activation only so you manually reconcile docs with the codebase when ready to consolidate updates.

When do I need to reconcile documentation with my codebase?โ–ผ

Reconcile documentation when design docs, SPEC.md, and related files diverge from the codebase. This typically happens during feature iteration and release cycles where implemented features and design decisions accumulate.