Which files does Arch Sync analyze by default?

By default, it scans all Markdown files within the docs/architecture/ directory, but you can also target specific files using the --doc flag.

Does Arch Sync automatically modify my documentation?

No. Architecture documents are critical, so Arch Sync only proposes changes for human review and requires explicit approval before any edits are applied.

Can I use Arch Sync to add new modules to my documentation?

Yes. If the tool detects a new module in your codebase that isn't mentioned in your architecture docs, it will propose an addition to the relevant section.

How does the skill detect discrepancies?

It uses specialized scripts to compare the modules and types defined in your architecture docs against the actual directory structure and source-of-truth files like CLAUDE.md.

Architecture Sync

Name: Architecture Sync
Author: alexnodeland

byalexnodeland

•

Learning & Documentation

Maintains documentation accuracy by comparing architectural blueprints with the current codebase structure and proposing updates.

Arch Sync bridges the gap between high-level documentation and actual implementation by analyzing your codebase's modules, types, and components against existing architecture files. It automatically identifies discrepancies such as missing module references, stale components that no longer exist, or type mismatches. Designed with a 'human-in-the-loop' philosophy, it never modifies critical architectural blueprints automatically; instead, it generates precise diff proposals for review, ensuring that your system's source of truth is maintained without manual overhead.

Key Features

01Preservation of existing document formatting and structure

02Automated codebase-to-doc discrepancy detection

03Support for individual file or bulk directory processing

04Integration with CLAUDE.md and local directory structures

05Interactive proposal system for human-controlled updates

063 GitHub stars

Use Cases

01Maintaining accurate module inventories after large-scale refactoring

02Streamlining technical debt audits for system documentation

03Eliminating documentation rot in high-level system blueprints

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alexnodeland/principled arch-sync

For use in Claude.ai and ChatGPT

Download Skill