⚠️ 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-task validates 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.