Skip to main content
Generalmelodic-software

status

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

Stars
74
Source
melodic-software/claude-code-plugins
Updated
2026-04-07
Slug
melodic-software--claude-code-plugins--status
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/melodic-software/claude-code-plugins/HEAD/plugins/spec-driven-development/skills/status/SKILL.md -o .claude/skills/status.md

Drops the SKILL.md into .claude/skills/status.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

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

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