harness-progress

name	harness-progress
description	Generate a Progress Tracker HTML for non-engineer vibecoders to glance at session progress (cc:WIP / cc:TODO / cc:完了 counts, percentage, elapsed/estimated minutes, cost so far/estimate, drift alerts). Uses Plans.md as source of truth, renders a single-file HTML with auto-regeneration support. Use when user asks for progress overview, session status snapshot, dashboard, or says: progress tracker, 進捗確認, 進捗ボード, dashboard. Do NOT load for: actual implementation, code review, release work.
description-en	Generate a Progress Tracker HTML for non-engineer vibecoders to glance at session progress (cc:WIP / cc:TODO / cc:完了 counts, percentage, elapsed/estimated minutes, cost so far/estimate, drift alerts). Uses Plans.md as source of truth, renders a single-file HTML with auto-regeneration support. Use when user asks for progress overview, session status snapshot, dashboard, or says: progress tracker, 進捗確認, 進捗ボード, dashboard. Do NOT load for: actual implementation, code review, release work.
description-ja	進捗 Tracker HTML を生成する。Plans.md を SoT として cc:WIP / cc:TODO / cc:完了 件数・%、経過分数・コスト・drift alert を 1 枚 HTML で表示。PostToolUse hook で 60 秒に 1 回自動再生成。Use when: 進捗確認, 進捗ボード, dashboard。Do NOT load for: 実装作業, code review, release。
allowed-tools	["Read","Write","Bash"]
argument-hint	[--out <path>] [--no-open]
user-invocable	true

Harness Progress Tracker

Phase 65.4 (Progress Tracker) — 3rd surface of the cognitive-load HTML triplet. Plan Brief / Acceptance Demo に続く 3 つ目の HTML surface で、進行中セッションの全体像を 1 枚の紙で把握 できるようにする。

Quick Reference

入力	動作
/harness-progress	現プロジェクトの進捗 snapshot HTML を生成し開く
/harness-progress --no-open	生成のみ (browser 開かない、PostToolUse hook 用)
/harness-progress --out <path>	出力先指定 (default: out/progress-snapshot.html)

Mission

"今のセッションは何件のタスクをどこまで終わらせて、いつ終わる見込みで、いくら使ったか" を、 エンジニアじゃない vibecoder が 3 秒でブラウザで把握 できる HTML 1 枚を生成する。

やる:

• Plans.md の cc:TODO / cc:WIP / cc:完了 件数を集計
• progress_pct (完了率) を計算 (cc:完了 ÷ 総タスク × 100)
• 経過分数 / 推定総分数 / コスト so-far / コスト estimate を表示
• drift alert を表示 (Phase 65.4.3 以降で populate)

やらない (本 cycle):

• WebSocket / SSE による live update (静的 HTML、再生成で更新)
• 過去 session の history 比較 (Phase 65.4.4 で別軸)
• 他 project の cross-project view (Phase 65.3 と独立)

Schema: progress-snapshot.v1

詳細仕様: schemas/progress-snapshot.v1.schema.json

schema:        progress-snapshot.v1
project:       <basename of git repo>
current_task:  <cc:WIP の最初の項目 1 行サマリ、なければ空文字>
progress_pct:  <0-100 の整数、cc:完了 ÷ 総タスク × 100 の四捨五入>
todo_tasks:    [{number, }]      
     [{, }]      
    [{, , }]     []    
             
     
             
           
                    []       
              
     [{, , , }]