migrate-to-guidance

Migrate CLAUDE.md to Guidance

You are tasked with migrating a project's existing CLAUDE.md files (typically created by /skill:annotate-inline) into the .rpiv/guidance/ system.

The migration relocates files from in-place CLAUDE.md to .rpiv/guidance/{path}/architecture.md and transforms internal cross-references.

Input

$ARGUMENTS — optional --delete-originals flag to remove the source CLAUDE.md files after migration.

Steps to follow:

1. Pre-flight check:

   • Use Glob to find all **/CLAUDE.md files in the project
   • If none are found, inform the user: "No CLAUDE.md files found in this project. Nothing to migrate." and stop
   • If .rpiv/guidance/ already exists, note this — there may be conflicts

2. Dry run — preview the migration:

   • Run the migration script in dry-run mode:

     node scripts/migrate.js --project-dir "${CWD}" --dry-run
     

   • Parse the JSON output from stdout and present a migration plan to the user:

     ## Migration Plan
     
     Found {N} CLAUDE.md files to migrate:
     
     | Source | Target | Lines |
     |--------|--------|-------|
     | CLAUDE.md | .rpiv/guidance/architecture.md | 45 |
     | src/core/CLAUDE.md | .rpiv/guidance/src/core/architecture.md | 78 |
     | ... | ... | ... |
     

   • If there are conflicts (targets that already exist), list them:

     ### Conflicts (targets already exist):
     - .rpiv/guidance/src/core/architecture.md
     
     Use --force to overwrite these.
     

   • If there are warnings (unresolved prose references), list them:

     ### Warnings:
     - .rpiv/guidance/architecture.md line 23: Prose reference may need manual update
     

   • Ask the user for confirmation before proceeding. Ask whether they want to:
     • Delete the original CLAUDE.md files after migration (--delete-originals)
     • Overwrite existing conflicts (--force)

3. Execute the migration:

   • Build the command based on user choices:

     node scripts/migrate.js --project-dir "${CWD}" [--delete-originals] [--force]
     

   • Run the migration and parse the JSON output
   • Present the results:

     ## Migration Complete
     
     | Source | Target | Lines | Refs Updated |
     |--------|--------|-------|--------------|
     | CLAUDE.md | .rpiv/guidance/architecture.md | 45 | 3 |
     | src/core/CLAUDE.md | .rpiv/guidance/src/core/architecture.md | 78 | 1 |
     | ... | ... | ... | ... |
     
     Total: {N} files migrated
     {Originals deleted: yes/no}