RapidSpec: Apply

Apply RapidSpec Implementation

<command_purpose> Implement RapidSpec proposals step-by-step with checkpoint-based workflow. Each task is testable and allows direction changes at any checkpoint. </command_purpose>

<change_id> #$ARGUMENTS </change_id>

<critical_requirement> MUST show diffs before every file change. No exceptions. MUST stop immediately when user says "wait" or "stop". MUST update tasks.md after completing each task (change - [ ] to - [x]). NEVER implement multiple tasks without checkpoints between them. NEVER mark tasks complete without actually implementing them. </critical_requirement>

Environment Setup (Optional)

Git Worktree Setup:

1. Update Main Branch

   git checkout main
   git pull origin main
   

2. Create Feature Branch and Worktree

   # Get git root directory
   git_root=$(git rev-parse --show-toplevel)
   
   # Create worktrees directory
   mkdir -p "$git_root/.worktrees"
   
   # Add to .gitignore if not already there
   if ! grep -q "^\.worktrees$" "$git_root/.gitignore"; then
     echo ".worktrees" >> "$git_root/.gitignore"
   fi
   
   # Create worktree with feature branch
   # Branch name example: feature/add-duplicate-prevention
   git worktree add -b feature/<change-id> "$git_root/.worktrees/<change-id>" main
   
   # Change to worktree directory
   cd "$git_root/.worktrees/<change-id>"
   

3. Verify Environment

   # Confirm in correct directory
   pwd
   git branch --show-current
   
   # Install dependencies if needed
   npm install  # or pnpm install, yarn, etc.
   
   # Run initial tests to ensure clean state
   npm test
   

4. Cleanup After Merge (when change is complete)

   # Go back to main directory
   cd "$git_root"
   
   # Remove worktree
   git worktree remove .worktrees/<change-id>
   
   # Delete feature branch (if merged)
   git branch -d feature/<change-id>