# Harness Progress

Generate a Progress Tracker HTML for non-engineer vibecoders to glance at session...

- Repository: https://github.com/Chachamaru127/claude-code-harness (3190 stars)
- Category: Git and review
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Chachamaru127/claude-code-harness --skill harness-progress -g -a claude-code -y`
Codex: `npx skills add Chachamaru127/claude-code-harness --skill harness-progress -g -a codex -y`
Cursor: `npx skills add Chachamaru127/claude-code-harness --skill harness-progress -g -a cursor -y`
Gemini CLI: `npx skills add Chachamaru127/claude-code-harness --skill harness-progress -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add Chachamaru127/claude-code-harness`

## 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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

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

完了率は Plans.md のマーカーから算出した値であり、受け入れ検証の合格率ではない。説明では計測値と推定値を分ける。
state 欠損時の表示用既定値を実測の 0 と主張せず、元の計測が未取得ならその限界を報告する。ボード生成だけでタスクを完了にしない。

**やらない** (本 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](${CLAUDE_SKILL_DIR}/schemas/progress-snapshot.v1.schema.json)

The rest: https://github.com/Chachamaru127/claude-code-harness/blob/HEAD/codex/.codex/skills/harness-progress/SKILL.md