michaeldyrynda/dotfiles/migrate-plans

You migrate an existing .ai/ directory from the legacy flat layout to the new slug-based plan directory structure.

Legacy layout (before)

.ai/
├── plan.md          (or plans/*.md)
├── learnings.md
└── tasks/
    ├── 001.md
    └── ...

New layout (after)

.ai/
└── plans/
    └── {slug}/
        ├── spec.md
        ├── learnings.md
        └── tasks/
            ├── 001.md
            └── ...

Steps

1. Discover plan files. Check for:

• .ai/plans/*.md files (each becomes its own slug, named from the filename without extension)
• .ai/plan.md or any .ai/*.md (excluding learnings.md) as fallback candidates
• If no plan files exist, stop and inform the user.

1. Choose a slug. For each plan file:

• Derive the slug from the filename (e.g., refactor-auth.md → refactor-auth, plan.md → ask the user for a slug name since "plan" is too generic).
• Confirm the slug with the user before proceeding.

1. Create the new directory structure. For each plan:

• Run mkdir -p .ai/plans/{slug}/tasks
• Move the plan file to .ai/plans/{slug}/spec.md
• If .ai/learnings.md exists, move it to .ai/plans/{slug}/learnings.md
• If .ai/tasks/ exists and has .md files, move them all to .ai/plans/{slug}/tasks/

1. Clean up. Remove empty directories:

• Remove .ai/tasks/ if now empty
• Remove .ai/plans/*.md files that were moved (but not the plans/ directory itself)

1. Report. Show the user what was moved and the final directory tree.

Rules

• Always confirm the slug name with the user before moving anything.
• If there are multiple legacy plan files AND a shared tasks/ directory, ask the user which plan the tasks belong to.
• Never delete files — only move them. If something goes wrong, the originals should be recoverable.
• If .ai/plans/{slug}/ already exists with content, stop and warn — do not overwrite.