Does this work with monorepos?

Yes, it is designed to find the nearest CLAUDE.md for each modified file, making it ideal for Nx monorepos or projects with nested documentation.

How does the skill determine what needs to be updated?

The skill analyzes your staged git changes (git diff --cached) to find new files, modified dependencies in package.json, and significant code changes of more than 50 lines.

Will it overwrite my existing documentation?

No, the update strategy is non-destructive. It focuses on adding new information and syncing changes rather than removing existing documentation.

Do I need to stage my files before using this skill?

Yes, for the auto-detect mode to work effectively, you should use 'git add' on your changes first so the skill can analyze the staged diff.

Can I revert changes made by this skill?

Since the skill modifies local files, you can easily review the changes with 'git diff' and revert them using 'git restore CLAUDE.md' if necessary.

CLAUDE.md Documentation Sync

Name: CLAUDE.md Documentation Sync
Author: Uniswap

byUniswap

•

Content Management

Automatically synchronizes CLAUDE.md documentation files with your latest staged git changes to ensure project context stays current.

About

The CLAUDE.md Documentation Sync skill is a specialized utility designed to maintain documentation parity within your codebase. By analyzing staged git changes, it intelligently identifies new files, dependency updates in package.json, and significant logic modifications to suggest relevant updates for your CLAUDE.md files. This ensures that AI agents always have the most accurate, up-to-date context about your project's structure and commands, eliminating the manual overhead of updating project guides after every major code change.

Key Features

13 GitHub stars
Intelligent grouping of changes by the nearest CLAUDE.md file
Optimized performance with 1-3 second typical execution
Automated git diff analysis for staged changes
Automatic detection of new dependencies and project commands
Non-destructive update strategy with user confirmation

Use Cases

Syncing package and command changes across complex monorepo structures
Keeping project context files current after adding new modules or packages
Automatically documenting major refactors or significant code additions

About

Key Features

13 GitHub stars
Intelligent grouping of changes by the nearest CLAUDE.md file
Optimized performance with 1-3 second typical execution
Automated git diff analysis for staged changes
Automatic detection of new dependencies and project commands
Non-destructive update strategy with user confirmation

Use Cases

Syncing package and command changes across complex monorepo structures
Keeping project context files current after adding new modules or packages
Automatically documenting major refactors or significant code additions