--- name: vibe-progress description: > Displays a live ASCII progress dashboard for the current vibe project. Triggers on "/vibe-progress", "progress:", "show progress", "how far along are we". Reads vibe/TASKS.md and git log to render a clean dashboard. Shows overall progress, phase gate status, active work, completed features, active bugs, backlog items, scope decisions, and last git activity. No files are modified. Read-only. Always runs in Plan Mode. --- # Vibe Progress Skill Renders a live ASCII dashboard of the current project's build progress. Reads vibe/TASKS.md and git history. Never modifies any file. **Always run in Plan Mode. Read-only.** --- ## Step 1 — Read project state 1. `vibe/TASKS.md` — phases, features, tasks, gates, active work, backlog 2. `git log --oneline -1` — last commit 3. `git log --oneline --since="7 days ago" | wc -l` — commits this week 4. `vibe/bugs/` — count folders, note any active 5. `vibe/backlog/` — count files (deferred items) 6. `vibe/DECISIONS.md` — count D-[ID] entries 7. `vibe/cost/history.json` — total project cost if exists (read silently, skip if missing) 8. `vibe/.doctor-last-run` — timestamp of last doctor: run (skip if missing) --- ## Step 2 — Calculate stats **Phase 1:** - Total tasks: count P1-XXX items - Done: count [x] P1-XXX items - Status: ✅ / 🔄 / ⬜ **Phase 2:** - Total features: count feature blocks - Done: count ✅ features - Active: 🔄 feature name + task progress (N/total) - Active tasks: list [ ] and [x] tasks in active block **Phase 3:** - Total tasks, done tasks - Status: ✅ / 🔄 / ⬜ **Overall:** - Total tasks across all phases, done tasks - Overall % = (done / total) × 100, rounded to nearest 5 **Phase gates:** Read `## Phase gates` section from TASKS.md exactly. Extract each gate line with its emoji status. **Backlog:** Count items in vibe/backlog/ folder. List names if ≤3 items; show count only if >3. **Cost (if vibe/cost/history.json exists):** ```bash node -e " const h = require('./vibe/cost/history.json'); // history.json is a flat array of session objects (as written by vibe-cost // and read by vibe-ledger). Tolerate a legacy {sessions:[...]} shape too. const arr = Array.isArray(h) ? h : (Array.isArray(h.sessions) ? h.sessions : []); const total = arr.reduce((s,x) => s + (x.cost_usd||0), 0); const sessions = arr.length; console.log('COST:$' + total.toFixed(2) + ':' + sessions + ' sessions'); " 2>/dev/null || echo "COST:none" ``` If no history.json — show "not tracked" in dashboard. **Env health (if vibe/.doctor-last-run exists):** ```bash if [ -f "vibe/.doctor-last-run" ]; then last=$(cat vibe/.doctor-last-run) now=$(date +%s) age=$(( (now - last) / 3600 )) if [ $age -lt 1 ]; then echo "ENV:healthy:checked this session" elif [ $age -lt 24 ]; then echo "ENV:stale:checked ${age}h ago" else echo "ENV:unknown:run doctor: to check" fi else echo "ENV:unknown:doctor: not yet run" fi ``` --- ## Step 3 — Render the dashboard ``` ┌─────────────────────────────────────────────────────────────┐ │ [PROJECT NAME] — Build Progress │ │ [overall%] complete · [N] tasks done of [total] │ ├─────────────────────────────────────────────────────────────┤ │ PHASES │ │ │ │ Phase 1 [bar] [N/total] [status] │ │ Phase 2 [bar] [N/total] [status] │ │ Phase 3 [bar] [N/total] [status] │ ├─────────────────────────────────────────────────────────────┤ │ PHASE GATES │ │ │ │ Phase 1 → 2: [✅ reviewed [date] / 🔴 BLOCKED / ⬜ pending] │ │ Phase 2 → 3: [status] │ │ Phase N → deploy: [status] │ ├─────────────────────────────────────────────────────────────┤ │ ACTIVE NOW │ │ [Feature name or Phase 3 task] │ │ │ │ [x] [task plain english] │ │ [x] [task plain english] │ │ [ ] [task plain english] ← next │ │ [ ] [task plain english] │ ├─────────────────────────────────────────────────────────────┤ │ COMPLETED FEATURES │ │ │ │ ✅ [Feature name] [N/N tasks] │ │ ... │ ├─────────────────────────────────────────────────────────────┤ │ BACKLOG [N items deferred] │ │ [item name if ≤3] / [count only if >3] │ │ │ │ BUGS [N fixed] [N active] │ │ SCOPE CHANGES [N decisions logged] │ │ COMMITS [N this week] │ ├─────────────────────────────────────────────────────────────┤ │ COST [$X.XX total · N sessions] │ │ ENV HEALTH [✅ checked this session / ⚠️ [N]h ago / ❓ not checked] │ ├─────────────────────────────────────────────────────────────┤ │ Last: [last git commit — truncated to 45 chars] │ │ Next: [plain English next task] │ │ │ │ Say "next" to continue building. │ └─────────────────────────────────────────────────────────────┘ ``` **COST row logic:** - If history.json exists: `$X.XX total · N sessions` - If no history.json: `not tracked — run cost: to start` **ENV HEALTH row logic:** - Checked this session (< 1h ago): `✅ checked this session` - Checked today (1-24h ago): `⚠️ checked Nh ago — consider re-running doctor:` - Not checked / no .doctor-last-run: `❓ not checked — run doctor: before building` --- ## Progress bar rendering Bar is 20 characters wide using █ and ░: ``` 0% ░░░░░░░░░░░░░░░░░░░░ 25% █████░░░░░░░░░░░░░░░ 50% ██████████░░░░░░░░░░ 75% ███████████████░░░░░ 100% ████████████████████ ``` Formula: filled = round(percentage / 5), empty = 20 - filled --- ## Status icons ``` ✅ complete (100%) 🔄 in progress (1-99%) ⬜ not started (0%) 🔴 BLOCKED (phase gate blocked by P0 issues) 🐛 active bug fix ``` --- ## Edge cases **Nothing built yet:** All phases ⬜ 0%. Active section: "Start with Phase 1 — say next to begin." Phase gates all ⬜ pending. **Active bug fix:** Add 🐛 ACTIVE BUG FIX section between ACTIVE NOW and COMPLETED FEATURES: ``` ├─────────────────────────────────────────────────────────────┤ │ 🐛 ACTIVE BUG FIX │ │ [Bug summary plain English] │ │ [ ] BUG-001 · Write regression test ← next │ │ [ ] BUG-002 · Implement fix │ │ ... │ ``` **Review gate blocked:** Phase gates section shows 🔴 BLOCKED with the P0 count. Active section shows the RFX- fix tasks. **No backlog:** Show: "BACKLOG 0 items deferred" **All tasks complete:** Active section: "All tasks complete — ready for review: final 🎉" --- ## After rendering Print nothing else. No explanations. No next steps beyond what's in the dashboard. The dashboard is the complete output.