Update Spec Tasks

Mark tasks as complete, update status, or modify task details.

What This Does

1. Finds the specified task in task files
2. Updates its status and acceptance criteria
3. Recalculates milestone progress
4. Updates SPEC.md status table

Arguments

$ARGUMENTS should include:

• Task identifier (e.g., "auth-2" for task 2 in auth.md)
• Optional: --status pending|in_progress|complete|blocked
• Optional: --check 1,2 to mark specific acceptance criteria complete
• Optional: --note "some note" to add a note

Examples:

/spec-flow:update auth-2 --status complete
/spec-flow:update auth-2 --check 1,3
/spec-flow:update auth-2 --status blocked --note "Waiting on API key"

Workflow

1. Parse task identifier from $1:

   • Format: {milestone}-{task_number} (e.g., "auth-2")
   • Or: {milestone}/{task_name} (e.g., "auth/session-management")

2. Find task file:

   • Look in .claude/spec/tasks/{milestone}.md
   • Locate task by number or name

3. Apply updates:

   • If --status: Update status field
   • If --check: Mark acceptance criteria checkboxes
   • If --note: Append to Notes section with timestamp

4. Recalculate milestone progress:

   • Count completed vs total tasks
   • Update "Status:" line at top of task file

5. Update SPEC.md:

   • Find milestone in Status table
   • Update progress percentage
   • Update Blocked column if any tasks blocked

6. Report changes made

Task Identifier Resolution

auth-2          -> .claude/spec/tasks/auth.md, Task #2
auth-session    -> .claude/spec/tasks/auth.md, Task containing "session"
api/rate-limit  -> .claude/spec/tasks/api.md, Task containing "rate-limit"

Output Format

Updated: auth.md Task 2 "Session Management"
  Status: In Progress -> Complete
  Criteria: 4/4 complete

Milestone progress: auth.md 60% -> 80%
SPEC.md updated: MVP milestone now 40% complete

Example Usage

/spec-flow:update auth-2
/spec-flow:update auth-2 --status complete
/spec-flow:update api-1 --check 1,2,3
/spec-flow:update auth-2 --status blocked --note "Need API credentials"