How ibadmore/bmad-progress-dashboard works
BMAD Progress Dashboard scans a project’s documentation and story checklists, calculates planning and development completion, derives milestones, and writes a Markdown dashboard. Users can update on demand, watch for file changes, trigger updates programmatically, or view progress interactively in the terminal. The calculation stages are implemented in one substantial source file, so they share its path. The README documents the generated dashboard and major user modes; links between the CLI wrapper and individual commands are not shown in the sampled source.
Main entry points: update-progress.js Project scanner · bmad-progress Progress CLI · progress-terminal.js Terminal dashboard · progress-watcher.js File watcher
Components 11
User entrypoints
- Progress CLI
progress-tracking-bundle/bmad-progress - Terminal dashboard
progress-tracking-bundle/tools/progress-tracking/progress-terminal.js - File watcher
progress-tracking-bundle/tools/progress-tracking/progress-watcher.js - Update trigger
progress-tracking-bundle/tools/progress-tracking/trigger-progress-update.js
Progress engine
- Project scanner
progress-tracking-bundle/tools/progress-tracking/update-progress.js - Progress calculator
progress-tracking-bundle/tools/progress-tracking/update-progress.js - Milestone derivation
progress-tracking-bundle/tools/progress-tracking/update-progress.js - Dashboard generator
progress-tracking-bundle/tools/progress-tracking/update-progress.js
Project artifacts
- BMAD docs and stories
- Progress dashboard
Other components
- BMAD developer
Connections 14
- BMAD developer → Progress CLI: runs commands
README.md - BMAD developer → Terminal dashboard: opens view
README.md - BMAD developer → File watcher: starts watching
README.md - BMAD docs and stories → Project scanner: scans files
README.md - Project scanner → Progress calculator: provides scan results
progress-tracking-bundle/tools/progress-tracking/update-progress.js - Progress calculator → Milestone derivation: provides progress
progress-tracking-bundle/tools/progress-tracking/update-progress.js - Progress calculator → Dashboard generator: provides metrics
progress-tracking-bundle/tools/progress-tracking/update-progress.js - Milestone derivation → Dashboard generator: provides milestones
progress-tracking-bundle/tools/progress-tracking/update-progress.js - Dashboard generator → Progress dashboard: generates
README.md - Terminal dashboard → Project scanner: calls scan functions
progress-tracking-bundle/tools/progress-tracking/progress-terminal.js - File watcher → Project scanner: executes update script
progress-tracking-bundle/tools/progress-tracking/progress-watcher.js - Update trigger → Project scanner: executes update script
progress-tracking-bundle/tools/progress-tracking/trigger-progress-update.js - Progress CLI → Terminal dashboard: dispatches view
- Progress CLI → File watcher: dispatches watch