spec-kitty-implement
⚠️ CRITICAL: Working Directory Requirement
After running spec-kitty implement WP##, you MUST:
- Run the cd command shown in the output - e.g.,
cd .worktrees/###-feature-WP##/ - ALL file operations happen in this directory - Read, Write, Edit tools must target files in the workspace
- NEVER write deliverable files to the main repository - This is a critical workflow error
Why this matters:
- Each WP has an isolated worktree with its own branch
- Changes in main repository will NOT be seen by reviewers looking at the WP worktree
- Writing to main instead of the workspace causes review failures and merge conflicts
IMPORTANT: After running the command below, you'll see a LONG work package prompt (~1000+ lines).
You MUST scroll to the BOTTOM to see the completion command!
Run this command to get the work package prompt and implementation instructions:
spec-kitty agent workflow implement $ARGUMENTS --agent <your-name>
spec-kitty agent workflow implement $ARGUMENTS --agent <your-name>
CRITICAL: You MUST provide --agent <your-name> to track who is implementing!
If no WP ID is provided, it will automatically find the first work package with lane: "planned" and move it to "doing" for you.
Commit Workflow
BEFORE moving to for_review, you MUST commit your implementation:
cd .worktrees/###-feature-WP##/
# Stage only expected deliverables for this WP (never use `git add -A`)
git add <deliverable-path-1> <deliverable-path-2> ...
git commit -m "feat(WP##): <describe your implementation>"
Set-Location .worktrees\###-feature-WP##\
# Stage only expected deliverables for this WP (never use `git add -A`)
git add <deliverable-path-1> <deliverable-path-2> ...
git commit -m "feat(WP##): <describe your implementation>"
Then move to review:
spec-kitty agent tasks move-task WP## --to for_review --note "Ready for review: <summary>"
Why this matters:
move-taskvalidates that your worktree has commits beyond main- Uncommitted changes will block the move to for_review
- This prevents lost work and ensures reviewers see complete implementations
The Python script handles all file updates automatically - no manual editing required!
NOTE: If /spec-kitty.status shows your WP in "doing" after you moved it to "for_review", don't panic - a reviewer may have moved it back (changes requested), or there's a sync delay. Focus on your WP.