vibe-progress

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):

node -e "
const h = require('./vibe/cost/history.json');
const total = h.sessions ? h.sessions.reduce((s,x) => s + (x.cost_usd||0), 0) : 0;
const sessions = h.sessions ? h.sessions.length : 0;
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.