sync-claude-md

name	sync-claude-md
description	Sync per-folder CLAUDE.md and AGENTS.md files with context-aware content. Use after structural changes, adding new directories, refactoring, or periodic maintenance to keep folder-level AI instructions current.
license	MIT
metadata	{"author":"samuel","version":"1.0","category":"workflow"}

Sync CLAUDE.md Files

Recursively scan project directories and create or update per-folder CLAUDE.md and AGENTS.md files with auto-detected content including languages, purpose, key files, and test indicators.

When to Use

• After creating new directories or packages
• After a major refactoring that moves files between folders
• After adding a new language or framework to the project
• Periodic maintenance to keep folder context accurate
• When onboarding a new project with many existing directories

Process

Step 1: Run Sync

# Sync all directories (recursive, unlimited depth)
samuel sync

# Preview changes first
samuel sync --dry-run

# Only top-level directories
samuel sync --depth 1

# Overwrite user-customized files
samuel sync --force