/migration-next - Run Next Pending Migration

Show and optionally run the next pending submodule migration from the queue document.

Usage

# Interactive mode - show next and prompt
/migration-next

# Automated mode - no prompts
/migration-next --yes

# Preview mode - show what would run
/migration-next --dry-run

# Combine flags
/migration-next --dry-run --yes

Options

Option	Short	Description
--yes	-y	Skip confirmation prompts
--dry-run	-n	Preview without executing

System Prompt

EXECUTION DIRECTIVE: When /migration-next is invoked, you MUST:

1. Load queue document from context-storage/lowercase-migration/SUBMODULE-MIGRATION-QUEUE.md
2. Display queue statistics (pending, completed, failed counts)
3. Find next pending submodule (first with ⏳ status)
4. Show details (name, category, files, command)
5. Show upcoming (next 5 pending after this one)
6. Prompt for confirmation (unless --yes)
7. Execute migration if confirmed:
   • Update queue status to 🔄
   • Run execute-submodule-migration.py
   • Validate results
   • Update queue status to ✅ or ❌
8. Show updated statistics

Execution

# Via orchestration script
python3 scripts/lowercase-migration/orchestrate-full-migration.py --next [--yes] [--dry-run]

Output Format

======================================================================
SUBMODULE MIGRATION QUEUE STATUS
======================================================================
Queue file: context-storage/lowercase-migration/SUBMODULE-MIGRATION-QUEUE.md

  ⏳ Pending:     77
  🔄 In Progress: 0
  ✅ Completed:   2
  ❌ Failed:      0
  ─────────────────
  Total:         79

----------------------------------------------------------------------
NEXT PENDING SUBMODULE
----------------------------------------------------------------------
  Priority:  #3
  Name:      coditect-docs-api
  Category:  docs
  Files:     234
  Dirs:      0

  Command:
    /lowercase-migration submodules/docs/coditect-docs-api --yes

----------------------------------------------------------------------
UPCOMING (next 5):
  #4 coditect-integration-slack (integrations) - 89 files
  #5 coditect-integration-github (integrations) - 156 files
  ...

Run migration on this submodule? [y/N]:

Examples

Interactive Migration Session

# Check status first
/migration-status

# Run next migration (will prompt)
/migration-next

# After completion, run next
/migration-next

Batch Mode

# Run multiple without prompts
/migration-next --yes
/migration-next --yes
/migration-next --yes

Preview Only

# See what would run without executing
/migration-next --dry-run

Success Output

✅ COMMAND COMPLETE: /migration-next
Migrated: coditect-docs-api
Status: ✅ Completed
Files renamed: 234
Remaining pending: 76

Completion Checklist

• Queue document loaded
• Statistics displayed
• Next pending identified
• Details shown
• Confirmation received (or --yes)
• Migration executed
• Queue status updated
• Final statistics shown

Failure Indicators

• ❌ Queue document not found
• ❌ No pending submodules
• ❌ Migration script failed
• ❌ Queue update failed

When All Complete

When no pending submodules remain:

======================================================================
SUBMODULE MIGRATION QUEUE STATUS
======================================================================
  ⏳ Pending:     0
  ✅ Completed:   79
  ❌ Failed:      0

✓ All submodules have been migrated!

Related

• Command: /migration-status
• Command: /lowercase-migration
• Skill: interactive-migration
• Script: orchestrate-full-migration.py --next

---

Command Version: 1.0.0 Track: AM.2 (Lowercase Migration) Author: CODITECT Framework Team