Skip to content
status logo

Specification Status Dashboard

status

Display specification status dashboard showing workflow progress, quality scores, and pending items.

SKILL.md

Full skill instructions

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

# 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)

╔══════════════════════════════════════════════════════════════════════╗
║                    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)

╔══════════════════════════════════════════════════════════════════════╗
║                     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

IconMeaning
✓Complete
🔄In Progress
⏳Pending
▶Current Task
⚠️Has Issues

Grades

GradeScoreMeaning
A+95-100Exceptional quality
A90-94Excellent
B80-89Good
C70-79Acceptable
D60-69Needs work
F<60Failing

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