quality-sync

Trace git diffs to regenerate affected .workflow documentation entries.

511|63|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/catlog22/Maestro-Flow --skill quality-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: quality-sync
Source: https://github.com/catlog22/Maestro-Flow/tree/main/.codex/skills/quality-sync
Command: npx skills add https://github.com/catlog22/Maestro-Flow --skill quality-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents documentation drift by automatically detecting code changes and synchronizing related documentation entries through file, component, feature, and requirement mappings so docs remain accurate and up to date.

Core Features & Use Cases

  • Change detection: Uses git diffs or a full resync baseline to determine which tracked files changed and whether a sync is required.
  • Impact tracing: Traces changes through file → component → feature → requirement layers via doc-index.json to build the full set of affected documentation entries.
  • Safe updates: Supports dry-run previews, content-hash updates to doc-index.json, and state.json bookkeeping (last_synced, last_synced_commit) to maintain an auditable sync history.
  • Use Case: After a refactor that moves or renames source files, run this Skill to automatically regenerate impacted API and architecture docs and update index timestamps without manual searching.

Quick Start

Run quality-sync with --dry-run to preview which documentation entries would be regenerated based on changes since the last synced commit.

Frequently Asked Questions about quality-sync

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

FAQPage Schema
How do I keep documentation aligned with code changes automatically?

To keep documentation aligned with code changes automatically, you can use a synchronization tool that traces git diffs through file, component, feature, and requirement layers to detect and regenerate impacted documentation entries.

How does git diff documentation synchronization work?

Git diff documentation synchronization works by comparing tracked files against a baseline commit or last_synced timestamp, mapping those changes through doc-index.json to identify affected entries, and regenerating the impacted documentation.

Can I preview which documentation entries will be updated before applying changes?

Yes, you can preview documentation updates by running the synchronization process in --dry-run mode, which identifies and lists affected .workflow/codebase documentation entries without modifying any files.

Do I need an initialized .workflow directory to sync documentation?

Yes, you need an initialized .workflow directory and git availability to sync documentation, as the tool relies on doc-index.json for impact tracing and state.json for tracking the last_synced timestamp and commit.

What is the best way to update architecture docs after a source file refactor?

The best way to update architecture docs after a refactor is to run a full resync or baseline sync that automatically maps moved or renamed source files to their corresponding feature and requirement layers to regenerate impacted docs.

What happens to documentation state when a full resync is performed?

When a full resync is performed, content hashes in doc-index.json are updated and state.json records the last_synced timestamp and last_synced_commit, maintaining an auditable sync history for future change detection.