Spec Status

Display project specification status and recommend next actions.

What This Does

1. Reads SPEC.md and all task files
2. Calculates completion percentages per milestone
3. Identifies blocked tasks
4. Recommends next task to work on
5. Shows recent activity

Arguments

$ARGUMENTS can include:

• --detailed - Show per-task status, not just milestones
• --json - Output as JSON for programmatic use

Workflow

1. Check if .claude/spec/SPEC.md exists

   • If not: Suggest running /spec-flow:init

2. Parse SPEC.md for:

   • Project name and description
   • Milestone list with task references

3. For each task file in .claude/spec/tasks/:

   • Count total tasks and completed tasks
   • Identify blocked tasks
   • Note tasks marked "In Progress"

4. Calculate overall progress:

   • Per-milestone: (completed / total) * 100
   • Overall: weighted by milestone importance

5. Generate recommendations:

   • If task in progress: "Continue: [task name]"
   • If blocked: "Unblock: [blocked task] - [reason]"
   • Otherwise: "Start: [next priority task]"

6. Show output in format below

Output Format

# Project Status: [name]

## Overall: 45% complete

| Milestone | Progress | Blocked |
|-----------|----------|---------|
| MVP       | 60%      | No      |
| v1.0      | 0%       | Yes     |

## Current Focus

**In Progress**: Session validation middleware
  File: .claude/spec/tasks/auth.md
  Acceptance: 2/4 complete

## Blocked Tasks

1. API rate limiting - Waiting on auth completion

## Next Actions

1. Complete: Session validation middleware (auth.md task 2)
2. Unblock: API rate limiting - requires auth completion
3. Start: User dashboard (next milestone)

## Recent Activity

- 2026-01-05: Completed OAuth provider setup
- 2026-01-04: Started authentication milestone

Example Usage

/spec-flow:status
/spec-flow:status --detailed
/spec-flow:status --json