Back to Get Shit Done

šŸ“Š Project Statistics — {milestone_version} {milestone_name}

get-shit-done/workflows/stats.md

1.42.02.2 KB
Original Source
<purpose> Display comprehensive project statistics including phases, plans, requirements, git metrics, and timeline. </purpose>

<required_reading> Read all files referenced by the invoking prompt's execution_context before starting. </required_reading>

<process> <step name="gather_stats"> Gather project statistics:
bash
STATS=$(gsd-sdk query stats.json)
if [[ "$STATS" == @file:* ]]; then STATS=$(cat "${STATS#@file:}"); fi

Extract fields from JSON: milestone_version, milestone_name, phases, phases_completed, phases_total, total_plans, total_summaries, percent, plan_percent, requirements_total, requirements_complete, git_commits, git_first_commit_date, last_activity. </step>

<step name="present_stats"> Present to the user with this format:
# šŸ“Š Project Statistics — {milestone_version} {milestone_name}

## Progress
[ā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā–‘ā–‘] X/Y phases (Z%)

## Plans
X/Y plans complete (Z%)

## Phases
| Phase | Name | Plans | Completed | Status |
|-------|------|-------|-----------|--------|
| ...   | ...  | ...   | ...       | ...    |

## Requirements
āœ… X/Y requirements complete

## Git
- **Commits:** N
- **Started:** YYYY-MM-DD
- **Last activity:** YYYY-MM-DD

## Timeline
- **Project age:** N days

If no .planning/ directory exists, inform the user to run /gsd-new-project first. </step>

<step name="mvp_summary"> **MVP phase summary.** Read all phases via `gsd-sdk query roadmap.analyze` (Phase 1's `cmdRoadmapAnalyze` surfaces a `mode` field per phase). Count phases by mode:
bash
ANALYZE=$(gsd-sdk query roadmap.analyze)
if [[ "$ANALYZE" == @file:* ]]; then ANALYZE=$(cat "${ANALYZE#@file:}"); fi
MVP_COUNT=$(echo "$ANALYZE" | jq '[.phases[] | select(.mode == "mvp")] | length')
TOTAL_COUNT=$(echo "$ANALYZE" | jq '.phases | length')

Emit a summary line in the stats output:

Phases: ${TOTAL_COUNT} total | ${MVP_COUNT} MVP | $((TOTAL_COUNT - MVP_COUNT)) standard

If MVP_COUNT == 0, the project has no MVP-mode phases — omit the line (no clutter for non-MVP projects). </step>

</process>

<success_criteria>

  • Statistics gathered from project state
  • Results formatted clearly
  • Displayed to user </success_criteria>