agentspec: Command for Claude Code

Status Report Command

Generates a project status report by scanning the SDD workspace, git history, and codebase health indicators.

Usage

/status                    # Full project status report
/status "sprint review"    # Status with specific context for a sprint review

---

What It Does

1. Scans the SDD workspace for active and recently shipped features
2. Checks git state for recent commits, branches, and uncommitted work
3. Detects project health (tests, TODOs, documentation, stack)
4. Generates actionable recommendations based on current state

---

Execution Process

Execute all steps inline (no agent delegation) and produce the report directly.

Step 1: Scan SDD Workspace

# Active features
Glob(".claude/sdd/features/BRAINSTORM_*.md")
Glob(".claude/sdd/features/DEFINE_*.md")
Glob(".claude/sdd/features/DESIGN_*.md")

# Build reports
Glob(".claude/sdd/reports/BUILD_REPORT_*.md")

# Recently shipped
Glob(".claude/sdd/archive/*")

For each discovered document:

• Extract the feature name from the filename
• Read the first 10 lines to determine status and last updated date
• Determine the current SDD phase (Brainstorm, Define, Design, Build, Shipped)
• Flag any blockers mentioned in the document

Step 2: Check Git State

# Recent commits
git log --oneline -10

# Uncommitted changes
git status --short

# Current branch
git branch --show-current

# All local branches
git branch

# Check for pending PRs (only if gh CLI is available)
gh pr list --state open --limit 5 2>/dev/null || echo "gh CLI not available"

Step 3: Detect Project Health

# Test files
Glob("**/test_*.py")
Glob("**/*_test.py")
Glob("**/*.test.ts")
Glob("**/*.test.js")
Glob("**/*.spec.ts")
Glob("**/*.spec.js")
Glob("**/tests/**/*.py")

# TODO/FIXME count
Grep("TODO|FIXME", output_mode="count")

# Documentation check
Glob("CLAUDE.md")
Glob("README.md")

# Stack detection via config files
Glob("**/pyproject.toml")
Glob("**/package.json")
Glob("**/dbt_project.yml")
Glob("**/Dockerfile")
Glob("**/*.tf")
Glob("**/airflow.cfg")
Glob("**/requirements.txt")
Glob("**/Cargo.toml")
Glob("**/go.mod")
Glob("**/pom.xml")

# KB domain alignment
Glob(".claude/kb/*/index.md")