sync-docs

Audit CLAUDE.md files and auto-align them with the current codebase.

Updated Apr 1, 2026

Search Tags:#automation #documentation #codebase #audit #claude.md #drift #docs-sync

Ready to run

npx skills add https://github.com/julianjab/ia-tools --skill sync-docs-julianjab

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: sync-docs
Source: https://github.com/julianjab/ia-tools/tree/main/skills/sync-docs
Command: npx skills add https://github.com/julianjab/ia-tools --skill sync-docs-julianjab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drift between CLAUDE.md documentation and the actual codebase undermines trust and slows reviews. This Skill audits CLAUDE.md files across the repository and auto-updates them to reflect the current state.

Core Features & Use Cases

Drift detection: compares CLAUDE.md with the code to identify mismatches in services, components, and commands.
Auto-fix & patching: applies conservative updates to align docs with code, with a safe dry-run option.
Use Case: When preparing a PR, run sync-docs to ensure CLAUDE.md accurately documents the current project structure.

Quick Start

Run the sync-docs tool to audit and auto-update CLAUDE.md files across the repository.

Frequently Asked Questions about sync-docs

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

FAQPage Schema

How do I keep CLAUDE.md documentation aligned with my codebase?▼

To align CLAUDE.md with your codebase, audit the files against the current code to detect drift, then apply conservative auto-fixes. This ensures documentation accurately reflects services, components, and commands before you submit a pull request.

What is documentation drift in a monorepo and how do I detect it?▼

Documentation drift occurs when CLAUDE.md files become outdated relative to the actual code. You detect this drift by scanning root, core, app, and package-level CLAUDE.md files to identify mismatches in structure, dependencies, commands, and integration points.

Can I dry-run documentation updates before applying fixes to CLAUDE.md?▼

Yes, you can perform a dry-run to preview documentation updates before applying them. This safe option allows you to review suggested patches that align CLAUDE.md with the codebase without immediately modifying the actual files.

How do I auto-fix outdated CLAUDE.md files before creating a PR?▼

To auto-fix outdated CLAUDE.md files before a PR, run a documentation sync audit that applies conservative updates aligning docs with code. This ensures your project structure, components, and commands are accurately documented for code review.

Does CLAUDE.md synchronization work across multiple packages in a monorepo?▼

Yes, CLAUDE.md synchronization works across multiple packages in a monorepo. The audit scans root, core, app, and package-level files to detect structural drift and suggest fixes, ensuring every layer of the repository remains accurately documented.

What specific codebase structures are checked during a CLAUDE.md audit?▼

During a CLAUDE.md audit, the system runs structured checks for project structure, components, dependencies, commands, patterns, and integration points. This comprehensive comparison identifies exactly where the documentation has drifted from the actual code.