Migration from Old Structure

This document tracks the migration from the old AI configuration structure to the new unified structure.

Old → New Mappings

Configuration Files

• CLAUDE.md → Updated to reference .ai/config/shared/
• ai/WORKSPACE.md → .ai/config/shared/workspace.md
• ai/CONTRIB.md → .ai/config/shared/contributing.md
• ai/RPI-WORKFLOW.md → .ai/config/shared/workflows.md
• .github/copilot-instructions.md → Updated to reference .ai/config/shared/instructions.md
• .mcp.json → .ai/config/mcp/mcp.json (symlinked back)

Agents

• .claude/agents/codebase-locator.md → .ai/agents/codebase/locator.md
• .claude/agents/codebase-analyzer.md → .ai/agents/codebase/analyzer.md
• .claude/agents/codebase-pattern-finder.md → .ai/agents/codebase/pattern-finder.md

Skills/Commands

• .claude/commands/rpi/research_codebase.md → .ai/skills/rpi/research-codebase.md
• .claude/commands/rpi/create_plan.md → .ai/skills/rpi/create-plan.md
• .claude/commands/rpi/validate_plan.md → .ai/skills/rpi/validate-plan.md
• .claude/commands/rpi/implement_plan.md → .ai/skills/rpi/implement-plan.md
• .claude/commands/rpi/save_progress.md → .ai/skills/rpi/save-progress.md
• .claude/commands/rpi/resume_work.md → .ai/skills/rpi/resume-work.md
• .claude/commands/rpi/define_test_cases.md → .ai/skills/rpi/define-test-cases.md
• .claude/commands/rpi/refresh_codebase_knowledge.md → .ai/skills/rpi/refresh-knowledge.md

Symlinks Created

• .mcp.json → .ai/config/mcp/mcp.json
• ai/ → .ai/
• .claude/agents/ → .ai/agents/
• .claude/commands/ → .ai/skills/

Backward Compatibility

All old paths remain accessible via symlinks. No scripts or workflows should break.

Old Files Status

Old files in original locations can be safely removed after validation, as they are now:

1. Migrated to new locations
2. Accessible via symlinks
3. Referenced from new structure

Migration Date

2026-02-04