Display feature tracker statistics, phase progress, and completion summary.
Steps
:
Check if feature tracking is enabled
:
Look for
docs/blueprint/feature-tracker.json
If not found, report:
Feature tracking not enabled in this project.
Run /blueprint-init and enable feature tracking to get started.
Load tracker data
:
Read
feature-tracker.json
Extract project name, source document, last_updated
Get statistics section
Get phase information
Get PRD status
Calculate derived metrics
(if not in statistics):
Count features by status at all nesting levels
Calculate completion percentage
Count features per phase
Count PRDs by status
Display status report
:
Feature Tracker Status
======================
Project: {project}
Source: {source_document}
Last Updated: {last_updated}
Overall Progress:
==================
{progress_bar} {completion_percentage}% ({complete}/{total_features})
Complete: {complete}
Partial: {partial}
In Progress: {in_progress}
Not Started: {not_started}
Blocked: {blocked}
Phase Progress:
===============
{For each phase:}
Phase {N}: {name}
Status: {status}
Features: {complete}/{total} complete
PRD Coverage:
=============
{For each PRD:}
{PRD_NAME}: {status}
Features: {features_implemented count}
{If tests_passing:} Tests: {tests_passing} passing
{If blocked features exist:}
Blocked Features:
=================
{For each blocked feature:}
- {FR code}: {name}
Reason: {implementation.notes or "No reason documented"}
{If not_started features exist and count <= 10:}
Ready to Start:
===============
{List first 10 not_started features by phase order}
- {FR code}: {name} (Phase {N})
Display visual progress bar
:
Create ASCII progress bar:
[##########----------] 52.4%
for complete percentage
for remaining
20 characters wide
Check for staleness
:
If
last_updated
is more than 7 days old, warn:
Note: Tracker hasn't been synced in {N} days.
Run /blueprint-feature-tracker-sync to update.
Prompt for next action
(use AskUserQuestion):
Build options dynamically based on state:
If stale → Include "Sync feature tracker"
If not_started features exist → Include "Start next feature"
If in_progress features exist → Include "Continue current work"
Always include "View detailed breakdown" and "Exit"
question: "What would you like to do?"
options:
{Dynamic options based on state}
- label: "Sync feature tracker" (if stale)
description: "Update tracker from project state"
- label: "Start next feature" (if not_started exist)
description: "Begin work on the next pending feature"
- label: "Continue current work" (if in_progress exist)
description: "Resume work on in-progress features"
- label: "View features by status"
description: "List all features filtered by status"
- label: "Exit"
description: "Done viewing status"
Based on selection:
"Sync" → Run
/blueprint-feature-tracker-sync
"Start next" → Show next not_started feature details, suggest starting
"Continue" → Show in_progress features, suggest continuing
"View by status" → Ask which status, then list matching features
"Exit" → End command
Example Output
:
Feature Tracker Status
======================
Project: gooho
Source: REQUIREMENTS.md
Last Updated: 2026-01-01
Overall Progress:
==================
[##########----------] 52.4% (22/42)
Complete: 22
Partial: 4
In Progress: 2
Not Started: 14
Blocked: 0
Phase Progress:
===============
Phase 0: Foundation
Status: complete
Features: 4/4 complete
Phase 1: Core Gameplay
Status: complete
Features: 8/8 complete
Phase 2: Advanced Features
Status: in_progress
Features: 10/14 complete
Phase 3-8: Future Development
Status: not_started
Features: 0/16 complete
PRD Coverage:
=============
PRD_GAME_SETUP_FLOW: complete
Features: 4
Tests: 45 passing
PRD_TERRAIN_VISUAL_ENHANCEMENT: complete
Features: 6
Tests: 107 passing
PRD_ENTITY_BEHAVIOR_SYSTEM: complete
Features: 8
Tests: 187 passing
PRD_UI_CONTROLS_SYSTEM: partial
Features: 3/5
Ready to Start:
===============
- FR3.1: Resource Types (Phase 3)
- FR3.2: Resource Gathering (Phase 3)
- FR3.3: Resource Storage (Phase 3)
- FR4.1: Basic Crafting (Phase 4)
- FR4.2: Recipe System (Phase 4)
Note: 14 features ready to start. Run /blueprint-feature-tracker-sync before beginning new work.
Quick Commands
(shown at end):
Quick commands for feature tracker:
- jq '.statistics' docs/blueprint/feature-tracker.json
- jq '.. | objects | select(.status == "not_started") | .name' docs/blueprint/feature-tracker.json
- jq '.prds | to_entries | .[] | "(.key): (.value.status)"' docs/blueprint/feature-tracker.json