---
name: status
description: "Display specification status dashboard showing workflow progress, quality scores, and pending items."
argument-hint: "[--all | <spec-id>]"
allowed-tools: Read, Glob, Grep, Skill
---

# Specification Status Dashboard

Display the status of specifications including workflow progress, quality scores, and pending items.

## Workflow

1. **Scan Specifications**
   - If `--all`: Scan entire `.specs/` directory
   - If spec-id: Load specific specification
   - If no argument: Show recent/active specifications

2. **Collect Status**
   - Read specification metadata
   - Check workflow phase
   - Calculate quality scores
   - Identify pending items

3. **Generate Dashboard**
   - Display summary table
   - Show phase progress
   - Highlight issues

## Arguments

- `$ARGUMENTS` - Specification ID or path
- `--all` - Show all specifications
- `--format` - Output format: table (default), json, markdown

## Examples

```bash
# Show all specifications
/spec-driven-development:status --all

# Show specific specification
/spec-driven-development:status user-auth

# JSON output for tooling
/spec-driven-development:status --all --format json
```

## Dashboard Display

### Summary View (--all)

```text
╔══════════════════════════════════════════════════════════════════════╗
║                    SPECIFICATION STATUS DASHBOARD                     ║
╠══════════════════════════════════════════════════════════════════════╣
║                                                                       ║
║  Total: 8 specifications                                              ║
║  ✓ Complete: 3  |  🔄 In Progress: 2  |  ⏳ Pending: 3                ║
║                                                                       ║
╠═══════════════════════════════════════════════════════════════════════╣
║  ID          │ Phase     │ Grade │ Tasks    │ Issues │ Updated       ║
╠═══════════════════════════════════════════════════════════════════════╣
║  user-auth   │ Implement │ A (92)│ 5/8 done │ 0      │ 2 hours ago   ║
║  cart        │ Tasks     │ B (85)│ 0/6 done │ 1      │ 1 day ago     ║
║  checkout    │ Plan      │ B (81)│ pending  │ 2      │ 3 days ago    ║
║  search      │ Specify   │ C (74)│ pending  │ 3      │ 1 week ago    ║
║  orders      │ Complete  │ A (95)│ 12/12    │ 0      │ 2 weeks ago   ║
║  payments    │ Complete  │ A (91)│ 8/8      │ 0      │ 3 weeks ago   ║
║  inventory   │ Complete  │ B (88)│ 6/6      │ 0      │ 1 month ago   ║
║  reports     │ Pending   │ -     │ -        │ -      │ never         ║
╚═══════════════════════════════════════════════════════════════════════╝

⚠️  3 specifications need attention (issues > 0)
```

### Detailed View (single spec)

```text
╔══════════════════════════════════════════════════════════════════════╗
║                     SPECIFICATION: user-auth                          ║
╠══════════════════════════════════════════════════════════════════════╣
║                                                                       ║
║  Phase: IMPLEMENT (4/5)                                               ║
║  Grade: A (92/100)                                                    ║
║  Last Updated: 2024-01-15T14:30:00Z                                   ║
║                                                                       ║
╠═══════════════════════════════════════════════════════════════════════╣
║                         WORKFLOW PROGRESS                             ║
╠═══════════════════════════════════════════════════════════════════════╣
║                                                                       ║
║  [✓] Phase 0: Constitution     ────────────────────  Complete         ║
║  [✓] Phase 1: Specify          ────────────────────  Complete         ║
║  [✓] Phase 2: Plan             ────────────────────  Complete         ║
║  [✓] Phase 3: Tasks            ────────────────────  Complete         ║
║  [▶] Phase 4: Implement        ████████████░░░░░░░░  62% (5/8 tasks)  ║
║                                                                       ║
╠═══════════════════════════════════════════════════════════════════════╣
║                         REQUIREMENTS STATUS                           ║
╠═══════════════════════════════════════════════════════════════════════╣
║                                                                       ║
║  FR-1: Email Login             ✓ Complete    (4/4 ACs)                ║
║  FR-2: OAuth Login             🔄 In Progress (2/3 ACs)               ║
║  FR-3: Session Management      ⏳ Pending     (0/5 ACs)               ║
║  NFR-1: Performance            ✓ Complete    (2/2 ACs)                ║
║                                                                       ║
╠═══════════════════════════════════════════════════════════════════════╣
║                           TASK STATUS                                 ║
╠═══════════════════════════════════════════════════════════════════════╣
║                                                                       ║
║  [✓] TASK-1: Create user model                                        ║
║  [✓] TASK-2: Implement password hashing                               ║
║  [✓] TASK-3: Create login endpoint                                    ║
║  [✓] TASK-4: Add email validation                                     ║
║  [✓] TASK-5: Implement JWT generation                                 ║
║  [▶] TASK-6: Add OAuth provider integration  ← CURRENT                ║
║  [ ] TASK-7: Create session storage                                   ║
║  [ ] TASK-8: Add logout endpoint                                      ║
║                                                                       ║
╠═══════════════════════════════════════════════════════════════════════╣
║                            ARTIFACTS                                  ║
╠═══════════════════════════════════════════════════════════════════════╣
║                                                                       ║
║  📄 Specification:  .specs/user-auth/spec.md                          ║
║  📐 Design:         .specs/user-auth/design.md                        ║
║  📋 Tasks:          .specs/user-auth/tasks.md                         ║
║  📊 Last Audit:     2024-01-14 (Grade: A)                             ║
║                                                                       ║
╚═══════════════════════════════════════════════════════════════════════╝

Next Action: Complete TASK-6 (OAuth provider integration)
```

## Status Indicators

| Icon | Meaning |
| --- | --- |
| ✓ | Complete |
| 🔄 | In Progress |
| ⏳ | Pending |
| ▶ | Current Task |
| ⚠️ | Has Issues |

## Grades

| Grade | Score | Meaning |
| --- | --- | --- |
| A+ | 95-100 | Exceptional quality |
| A | 90-94 | Excellent |
| B | 80-89 | Good |
| C | 70-79 | Acceptable |
| D | 60-69 | Needs work |
| F | <60 | Failing |

## Related Commands

- `/spec-driven-development:audit` - Full quality audit
- `/spec-driven-development:validate` - Validate specification
- `/spec-driven-development:implement` - Continue implementation
- `/spec-driven-development:speckit-run` - Resume workflow