# Harness Plan Brief

Generate a Plan Brief HTML for non-engineer vibecoders before implementation starts.

- 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-plan-brief -g -a claude-code -y`
Codex: `npx skills add Chachamaru127/claude-code-harness --skill harness-plan-brief -g -a codex -y`
Cursor: `npx skills add Chachamaru127/claude-code-harness --skill harness-plan-brief -g -a cursor -y`
Gemini CLI: `npx skills add Chachamaru127/claude-code-harness --skill harness-plan-brief -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add Chachamaru127/claude-code-harness`

## Description

Generate a Plan Brief HTML for non-engineer vibecoders before implementation starts. Searches harness-mem (project-only) for relevant past decisions, patterns, and Plans archive entries, then renders a single-file HTML artifact summarizing understanding, options, risks, acceptance criteria, and confidence. Use when the user requests a planning preview, a non-engineer-friendly summary before approval, or says: plan brief, planning preview, 計画概要, 計画レビュー. 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-plan-brief

非エンジニアの発注者・プロデューサー職向けに、Claude が着手しようとしている計画を **HTML 1 枚** で提示するスキル。
発注者の認知負荷ピーク (1) 計画理解の段階で使う。

## Quick Reference

- 「**Plan Brief を作って**」 → このスキル
- 「**実装前にざっくり整理**」 → このスキル
- 「**非エンジニア向けに計画を見せて**」 → このスキル

## 責任境界

| 範囲 | このスキルの責務 |
|------|-----------------|
| 検索 | **現プロジェクトのみ** (`project: <current>`, `strict_project: true` を必ず指定) |
| クロスプロジェクト | **やらない** (Phase 65.3 以降で `--cross-project-group <name>` flag で opt-in 解放) |
| 書き込み | やらない (Plan Brief 承認後の memory write は `plan-brief-record-decision.sh` の責務) |
| plan_readiness 算出 | `scripts/plan-brief-compile.sh` に委譲。互換フィールド名 `confidence` は残すが、意味は DoD 明確度 + 依存解決率に限定 |

## 入力

引数 `[task-description]` にユーザーの request を渡す。
引数なしの場合は、会話の原依頼と選択済み計画から回収する。複数の候補が残って判断を変える場合だけ確認する。
計画の目的、担当範囲、未決事項と合格条件を示し、計画概要の作成依頼から実装を始めない。

## 出力

| 出力 | パス | 形式 |
|------|------|------|
| Plan Brief HTML | `.claude/state/views/plan-brief-<timestamp>.html` | 単独で開ける HTML (no server, no JS framework) |
| Plan Brief context JSON | `.claude/state/views/plan-brief-<timestamp>.context.json` | `plan-brief-context.v1` schema |

## Schema: `plan-brief-context.v1`

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