harness-plan-brief

name	harness-plan-brief
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.
description-en	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.
description-ja	実装着手前に Plan Brief HTML を生成する。現プロジェクトのみで harness-mem を検索し (`strict_project: true`)、過去 decision / pattern / Plans archive から類似案件を抽出して `plan-brief-context.v1` schema に整形、`render-html.sh` で単独 HTML を生成しブラウザ自動 open する。Use when: 計画概要, 非エンジニア向け事前共有, 提案前 review。Do NOT load for: 実装作業, code review, release。
allowed-tools	["Read","Write","Edit","Bash"]
argument-hint	[task-description]
user-invocable	true

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

{
  "schema": "plan-brief-context.v1",
  "user_request": "string (ユーザーの request 原文)",
  "my_understanding": "string (Claude の理解を 1-3 段落で)",
  "options"