| name | project-essence-orchestrator |
| description | 4 領域 (ハーネス/skill/UI/プロジェクトドメイン) の essence + identity レビューを並列起動して統合判断を返す master skill (プロジェクトローカル)。 既存 essence-reviewing-orchestrator (グローバル 3 領域 = 普遍軸) に固有軸 (project-domain = .docs/identity/) を加えた 4 領域版。 context:fork 経由で各 reviewer を呼出し、メインコンテキストを汚さず純粋な領域別評価を実行する。 「project essence レビュー」「4 領域 essence」「全領域 + ドメインレビュー」「project-essence-orchestrator 起動」等で発動。 Skill ツール経由の明示呼出を推奨 (高コスト fork 起動のため意図せぬ発火を避ける)。
|
Project Essence Orchestrator (Master Orchestration Skill, Project-Local)
メイン Claude から明示呼出されるオーケストレーター skill。context:fork ベースの reviewer fork を並列起動し、評価対象への 普遍軸 3 領域 (essence: harness/skill/UI) + 固有軸 1 領域 (identity: project-domain) からの照合分析を集約して Lead (= 本 skill 実行中の Claude) が統合判断を返す。
既存 essence-reviewing-orchestrator (グローバル 3 領域) は 無改修。本 skill はプロジェクトローカルの 4 領域版として独立し、4 軸目 (project-domain) を加える。note 記事「複数レビューアの活用」の UI/プロジェクトドメイン/ハーネス 3 reviewer 例示のうち、固有軸 = プロジェクトドメインを統合する位置付け。
I/O 契約 (skill タイプ: Workflow / orchestrator)
| 項目 | 仕様 |
|---|
| 入力 | <args> (= $ARGUMENTS、評価対象パス)。空なら git diff フォールバック → 不確定なら user に質問 |
| 出力 | 4 領域統合判断 (Lead 統合 = 構造化 Markdown) + 永続化ファイル 1 件 |
| 永続化先 | $HOME/.claude/.docs/project-essence-review-runs/<YYYY-MM-DD_HHMMSS>_<target-slug>.md (Step 6 で Write) |
| エラー時挙動 | sub-skill 失敗 → 残領域で続行 + 欠落明示 / identity 不在 → project-domain は ⚪ 判定保留 / validate 未完了 → 該当 step に戻る |
| 依存 | fork 3-4 体 (harness/skill/ui-essentials-reviewer-fork = グローバル + project-domain-reviewer-fork = プロジェクトローカル) + 評価基準 (~/.claude/.docs/essence/{harness,skill,ui}-essentials.md + .docs/identity/、いずれも改修禁止) |
| 副作用 | 永続化ファイル + progress JSON 書出のみ (それ以外は read-only、評価対象には触れない) |
Orchestration Phase — 評価対象の決定論的注入
開始時刻 (duration 計測用)
!date +%s
親セッションの作業ディレクトリ (sub-skill が継承、cwd 継承対策の Layer 1)
!pwd
評価対象パス (<args> 経由、生入力)
!echo "$ARGUMENTS"
評価対象パスの決定論的解析 (parse-target-path.sh、Lead は type=/path= を採用)
!bash .claude/skills/project-essence-orchestrator/scripts/parse-target-path.sh "$ARGUMENTS"
git diff フォールバック (type=empty の場合に評価対象を補完)
!git diff --stat HEAD~1..HEAD 2>/dev/null | head -20 || echo "(no diff or not a git repo)"
UI 領域の要否判定 (ui-identity.md 存在時のみ ui-essentials-reviewer-fork を並列に含める)
!ls .docs/identity/ui-identity.md 2>/dev/null && echo "UI 領域: 対象 (ui-identity あり)" || echo "UI 領域: skip (ui-identity 不在 = 本プロジェクトは UI 制作しない Anti-Goal)"
identity 存在検証 (project-domain 軸の前提条件)
!ls .docs/identity/*.md 2>/dev/null || echo "(identity 不在 → project-domain は ⚪ 判定保留)"
進捗追跡 JSON 初期化 (ステップ抜け対策)
!bash .claude/skills/project-essence-orchestrator/scripts/init-progress.sh "$ARGUMENTS"
progress_json パス (Lead 用ピン留め)
!ls -t ~/.claude/.docs/project-essence-review-runs/*_progress.json 2>/dev/null | head -1
ナビゲーション (共通設計は既存 essence orchestrator references を流用)
本 skill は essence-reviewing-orchestrator と同型構造。重複を避け、共通設計は既存 references を参照する:
| 詳細 | 参照先 |
|---|
| 設計の核心 6 項目 + エラーマトリクス | ~/.claude/skills/essence-reviewing-orchestrator/references/design-rationale.md |
| Step 1-6 ハブ + 進捗追跡 JSON 共通仕様 | ~/.claude/skills/essence-reviewing-orchestrator/references/orchestration-protocol.md |
| Step 詳細 (入口/分析/判断/永続化) | ~/.claude/skills/essence-reviewing-orchestrator/references/step-{1-2,3-3.5,4-5,6}.md |
| Gotchas (parameter expansion / literal 置換 / grayzone 等) | ~/.claude/skills/essence-reviewing-orchestrator/references/gotchas.md |
| 普遍軸 essence 24 行最小要約 | ~/.claude/skills/essence-reviewing-orchestrator/references/essence-summary.md |
| 固有軸 identity (本プロジェクトの自己定義) | .docs/identity/{project-charter,harness-identity,skill-identity}.md |
4 領域版固有の差分 (本 skill が essence orchestrator に追加する点) は下記「指示」セクションに inline。
指示 (Lead = 本 skill 実行中の Claude への責務)
Lead は以下の手順で 3-4 領域並列レビューを実行する。共通の Step 詳細は上記 references 参照、4 領域版の差分のみ以下に明示:
- Step 1 評価対象確定: 上記
### 評価対象パス を確認、空なら git diff フォールバック or ユーザー質問
- Step 2 並列起動 (3-4 fork、1 メッセージ内発火):
- 必須 3:
Skill(harness-essentials-reviewer-fork) + Skill(skill-essentials-reviewer-fork) + Skill(project-domain-reviewer-fork)、各 args="<評価対象>"
- 条件付き:
### UI 領域の要否判定 が「対象」なら Skill(ui-essentials-reviewer-fork) も追加 (本プロジェクトは通常 skip)
- Step 3 戻り値分析: 各領域の原則/identity マトリクス + severity 付き指摘を抽出
- Step 3.5 領域横断チェック: 普遍軸 (harness/skill/ui essence) と固有軸 (project-domain identity) の関係を整理。特に「essence は満たすが identity の選択に反する」or「identity は満たすが essence 原則違反」の交差ケースを検出。共通懸念・矛盾も抽出
- Step 4 Lead 統合判断: 領域横断 Critical 優先 / 反インフレ (全領域 🟢 は赤信号) / 矛盾解消 / Claude Only 維持。普遍軸と固有軸の混同を防ぐ (essence 原則違反と identity 選択違反は別レイヤーとして報告)
- Step 5 出力: 下記「出力フォーマット」に従う
- Step 6 永続化 (3 段必須): mkdir → Write tool で
$HOME/.claude/.docs/project-essence-review-runs/ に保存 → bash .claude/skills/project-essence-orchestrator/scripts/validate-all-steps.sh "<progress_json>" で 9 step 完走を機械検証
各 step 完了時に bash .claude/skills/project-essence-orchestrator/scripts/mark-step-completed.sh "<progress_json>" "<step_id>" で進捗 JSON を更新。
出力フォーマット (4 領域統合判断)
# Project Essence Review: {対象名}
> 評価基準: essence/{harness,skill,ui}-essentials.md (普遍軸) + .docs/identity/ (固有軸)
## 総合判断
<🟢/🟡/🔴/⚪> <推奨アクション 2-3行>
## 領域別サマリ
| 領域 | 軸 | 判定 | Critical | High | 一言 |
|---|---|---|---|---|---|
| harness | 普遍 | 🟢/🟡/🔴/⚪ | <n> | <n> | ... |
| skill | 普遍 | ... | ... | ... | ... |
| UI | 普遍 | (skip if ui-identity 不在) | ... | ... | ... |
| project-domain | 固有 | ... | ... | ... | ... |
## 領域横断の論点 (Step 3.5)
- 普遍軸と固有軸の交差ケース: <essence は満たすが identity 違反、等>
- 共通懸念: <複数領域で繰り返し出た指摘>
- 矛盾: <領域間で評価が割れた点と Lead の解消>
## 領域別詳細
(各 fork の戻り値を領域ごとに要約)
## Lead 統合所見 (2-3文)
Observability:
domains_evaluated: <3 or 4>
total_critical: <n>
total_high: <n>
duration_sec: <n>
ui_domain: <included / skipped>
Gotcha
- must: 「全領域 🟢」は赤信号 (反インフレ原則違反候補、Lead は能動的に見落としを探す)
- must: 外部 AI (GPT/Gemini/Codex/Cursor 等) 連携は禁止 (Claude Only 不変原則、CLAUDE.md
## Harness 遵守)
- must: 普遍軸 (essence) と固有軸 (identity) の混同禁止。「Opus 固定」「kebab-case」は identity 違反、「コンテキスト有限資源」は essence 違反として別レイヤーで報告
- must: UI 領域は
ui-identity.md 存在時のみ並列に含める。本プロジェクトは「UI 制作しない」Anti-Goal のため通常は 3 領域 (harness/skill/project-domain)
- must: 評価対象パスは
$ARGUMENTS 経由で絶対パス渡し (各 fork に伝播)
- should: Critical 検出時は Step 4 末尾で HITL チェックポイントを発火 (片面性バイアス解消)
- avoid:
${VAR:-default} を !構文内で使わない、$VAR 単体参照のみ (Contains expansion deny で hook が発火しない、essence orchestrator Gotcha 継承)
- avoid: 既存 essence-reviewing-orchestrator (グローバル 3 領域) の改修 (memory
feedback_no-existing-harness-modification 準拠、本 skill は独立した 4 領域版)
- scripts 相対パス: 本 skill は master (非 fork) のため cwd = プロジェクトルート前提で
.claude/skills/project-essence-orchestrator/scripts/ を相対参照 (essence orchestrator は ~/.claude/... 絶対だが本 skill は project ローカル配置)
- 永続化先分離: グローバル 3 領域 review は
essence-review-runs/、本 skill 4 領域 review は project-essence-review-runs/ (混在防止)
