auto-build/plugin/commands/migrate.md

description

description
Migrate from old .auto-build-data/ structure to new .auto-build/ structure

Migrate Auto-Build Data

Migrate specs and memory from the old .auto-build-data/ location to the new .auto-build/ location for team collaboration.

When to Use

Run this command if you have an existing project that was using Auto-Build v1.0.5 or earlier, where specs and memory were stored in .auto-build-data/ (gitignored).

What It Does

1. Moves specs: .auto-build-data/specs/ → .auto-build/specs/
2. Moves memory: .auto-build-data/memory/ → .auto-build/memory/
3. Keeps local data: .auto-build-data/worktrees/ and .auto-build-data/cache/ stay local
4. Updates .gitignore: Ensures only .auto-build-data/ is ignored

Workflow

1. Check for Existing Data

First, check if migration is needed:

# Check if old structure exists
ls -la .auto-build-data/specs/
ls -la .auto-build-data/memory/

If .auto-build-data/specs/ or .auto-build-data/memory/ exist with data, proceed with migration.

2. Create New Structure

mkdir -p .auto-build/specs
mkdir -p .auto-build/memory/sessions

3. Move Specs

# Move all feature specs
if [ -d ".auto-build-data/specs" ] && [ "$(ls -A .auto-build-data/specs)" ]; then
    mv .auto-build-data/specs/* .auto-build/specs/
    echo "Moved specs to .auto-build/specs/"
fi

4. Move Memory

# Move memory files
if [ -f ".auto-build-data/memory/patterns.json" ]; then
    mv .auto-build-data/memory/patterns.json .auto-build/memory/
fi

if [ -f ".auto-build-data/memory/gotchas.json" ]; then
    mv .auto-build-data/memory/gotchas.json .auto-build/memory/
fi

if [ -d ".auto-build-data/memory/sessions" ] && [ "$(ls -A .auto-build-data/memory/sessions)" ]; then
    mv .auto-build-data/memory/sessions/* .auto-build/memory/sessions/
fi

echo "Moved memory to .auto-build/memory/"

5. Initialize Missing Files

If memory files don't exist, create them:

if [ ! -f ".auto-build/memory/patterns.json" ]; then
    echo '{"patterns": [], "updated": null}' > .auto-build/memory/patterns.json
fi

if [ ! -f ".auto-build/memory/gotchas.json" ]; then
    echo '{"gotchas": [], "updated": null}' > .auto-build/memory/gotchas.json
fi

6. Update .gitignore

Ensure .gitignore only ignores .auto-build-data/:

# Remove old entries if present
grep -v "^\.auto-build-data/" .gitignore > .gitignore.tmp && mv .gitignore.tmp .gitignore

# Add correct entry
if ! grep -q "^\.auto-build-data/" .gitignore; then
    echo "" >> .gitignore
    echo "# Auto-Build local data (worktrees, cache)" >> .gitignore
    echo ".auto-build-data/" >> .gitignore
fi

7. Display Summary

════════════════════════════════════════════════════════════════
  Migration Complete
════════════════════════════════════════════════════════════════

✅ Specs moved to .auto-build/specs/
✅ Memory moved to .auto-build/memory/
✅ .gitignore updated

New structure (committed to git):
  .auto-build/
  ├── specs/{feature-name}/
  │   ├── spec.md
  │   ├── plan.md
  │   └── status.json
  └── memory/
      ├── patterns.json
      ├── gotchas.json
      └── sessions/

Local data (gitignored):
  .auto-build-data/
  ├── worktrees/
  └── cache/

NEXT STEPS:
1. Review the migrated files
2. Commit the new .auto-build/ directory:
   git add .auto-build/
   git commit -m "chore: Migrate auto-build specs and memory for team sharing"
3. Push to share with your team

════════════════════════════════════════════════════════════════

Notes

• This migration is one-way - the old structure is not preserved
• After migration, specs and memory are version controlled and shared with your team
• Worktrees remain local as they are machine-specific