aakashdhar 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
vibe/TASKS.md— phases, features, tasks, gates, active work, backloggit log --oneline -1— last commitgit log --oneline --since="7 days ago" | wc -l— commits this weekvibe/bugs/— count folders, note any activevibe/backlog/— count files (deferred items)vibe/DECISIONS.md— count D-[ID] entriesvibe/cost/history.json— total project cost if exists (read silently, skip if missing)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):
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):
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.