run-elegant-review

Purpose & Output Contract

新規Skill / rubric改訂 / アーキテクチャ提案 / creator-kit構成要素を、30種の思考法で多角的に検証し、4条件 (矛盾なし / 漏れなし / 整合性あり / 依存関係整合) をすべてPASSさせるまで改善する。

本Skillの改善は、対象固有の事実をそのまま埋め込むのではなく、必ず 具体値 → 変数 → テンプレート → 横展開条件 に戻して設計する。対象固有情報は証跡として残し、再利用可能なプロンプト・Skill・SubAgent・script・config では変数名と既定値で表現する。

Output Contract

• findings.json: paradigm別findings + 4-condition gates + variable abstraction + total score (templates/findings.json 準拠)
• review-<target-type>.md: 人間可読レポート (target_type に応じた template を採用)
• 完了条件: 4条件すべて PASS かつ 30思考法すべてに構造化 findings が存在 (coverage script で検証)

引数

• target_type ∈ {skill, rubric, proposal, kit-component, script, config, agent, custom}
• target_path: 対象ファイル/ディレクトリの絶対パス

変数化ポリシー

具体情報	テンプレート変数	例
プロジェクトルート	{{PROJECT_ROOT}}	/path/to/project
kitルート	{{KIT_ROOT}}	{{PROJECT_ROOT}}/creator-kit
対象種別	{{target_type}}	skill, script, config
対象パス	{{target_path}}	絶対パスまたは {{PROJECT_ROOT}} 基準相対パス
レビュー作業領域	{{review_workspace}}	OS別一時ディレクトリ配下
所有者	{{owner}}	チーム名または個人名
実行OS	{{os_kind}}	mac, linux, windows, unknown
外部ツール名	{{external_executor}}	codex, claude-code, none

禁止: 実プロジェクト名、個人名、固定絶対パス、固定API URL、固定ownerを、再利用されるプロンプト・Skill・SubAgent・script・configへ直接埋め込むこと。必要な場合は source_trace に証跡として残す。

---

30思考法カテゴリ (7カテゴリ / 計30)

詳細定義は references/30-paradigms-full.md を参照 (Progressive Disclosure)。

A. 論理分析系 (5)

1. 批判的思考 (Critical)
2. 演繹思考 (Deductive)
3. 帰納的思考 (Inductive)
4. アブダクション (Abductive)
5. 垂直思考 (Vertical)

B. 構造分解系 (4)

6. 要素分解 (Decomposition)
7. MECE
8. 2軸思考 (Two-axis)
9. プロセス思考 (Process)

C. メタ抽象系 (3)

10. メタ思考 (Meta)
11. 抽象化思考
12. ダブル・ループ思考 (Double-loop)

D. 発想拡張系 (6)

13. ブレインストーミング
14. 水平思考 (Lateral)
15. 逆説思考 (Paradox)
16. 類推思考 (Analogy)
17. if思考 (What-if)
18. 素人思考 (Beginner's mind)

E. システム系 (3)

19. システム思考
20. 因果関係分析 (Causal analysis)
21. 因果ループ (Causal loop)

F. 戦略価値系 (4)

22. トレードオン思考 (Trade-on)
23. プラスサム思考 (Positive-sum)
24. 価値提案思考 (Value proposition)
25. 戦略的思考 (Strategic)

G. 問題解決系 (5)

26. why思考 (Why)
27. 改善思考 (Improvement)
28. 仮説思考 (Hypothesis)
29. 論点思考 (Issue)
30. KJ法 (KJ method)

---

検証4条件

機械可読定義は references/4-conditions.json / rubric表現は references/elegant-4-conditions.json を参照。

#	条件	定義	check method
C1	矛盾なし (Consistency)	内部の主張・ルール間で論理矛盾がない	claim graph で contradiction edge を検出
C2	漏れなし (Completeness)	対象スコープに必要な要素がMECEに揃う	required-element checklist を全件PASS
C3	整合性あり (Coherence)	上位仕様 (24章正本 / rubric) と整合	rubric_refs と diff し violation=0
C4	依存関係整合 (Dependency)	参照・前提・順序が破綻していない	DAG topological sort が成立

完了条件: C1〜C4 すべて PASS。1つでもFAILなら Phase3 改善ループへ。

---

実行フロー

詳細は references/orchestration-flow.md、各エージェント責務は references/agent-roles.md を参照。

副作用境界

• Phase1 と Phase2 は read-only。対象ファイルを編集せず、観察・findings 作成だけを行う。
• Phase3 のみ write 可。編集は集約済み findings に紐づく最小パッチに限定する。
• Phase2 単独監査として呼ばれた場合、findings.json などの成果物生成を求められても、ユーザー指定の出力先がない限り対象ディレクトリを書き換えない。

Phase 1: 思考リセット俯瞰 (Agent 1: elegant-reset-observer)

• 既存バイアスを破棄し、対象を素のまま観察
• 目的・スコープ・前提・利害関係者を抽出
• 省略禁止: ここを飛ばすと Goodhart の罠 (rubric最適化のための形式改善) に陥る

Phase 2: 並列3エージェント分析

Phase1 の出力を入力として、3エージェントを並列起動:

• Agent 2 elegant-logical-structural-analyst: A論理分析5 + B構造分解4 = 9思考法
• Agent 3 elegant-meta-divergent-analyst: Cメタ抽象3 + D発想拡張6 = 9思考法
• Agent 4 elegant-system-strategic-analyst: Eシステム3 + F戦略価値4 + G問題解決5 = 12思考法

各エージェントは担当思考法 × C1〜C4 のマトリクスで paradigm_findings を生成し、具体値を variable_abstraction に戻す。集約後、scripts/validate-paradigm-coverage.py で全30件の構造と内容を検証 → scripts/build-paradigm-scorecard.py で集約。

Phase 3: 改善実行 (Agent 5: elegant-improvement-executor)

• findings を重大度順にソート
• 4条件 FAIL 項目に対しパッチを適用
• 具体情報の直書きを変数・テンプレート・既定値へ昇格し、source_trace に由来を残す
• 再度 Phase2 へ (収束判定は references/convergence-policy.json 参照)
• 収束条件 (全クリア) または安全弁発火 (max 3) まで継続

---

収束ループ設計 (正負フィードバック両輪)

詳細は references/convergence-policy.json を参照。本Skillは「PASS/FAIL の1bit判定」ではなく、解像度3層 + 両輪フィードバック + 安全弁 で収束を判定する。

解像度3層

層	出力	用途
L1	C1-C4 の PASS/FAIL (4bit)	最終判定
L2	各C条件・各思考法のスコア (0.0-1.0)	周回内の精緻評価
L3	周回間のΔベクトル (正/負両方向)	収束兆候の検出

両輪フィードバック

• 負のフィードバック (Detector): C1-C4違反・パラダイム破綻を検出 → 修正パッチ適用 → 品質ラインに到達させる
• 正のフィードバック (Amplifier): 良い設計判断・再利用可能パターンを抽出 → amplified-patterns.json に蓄積 → 他章/他Skillへ横展開

両輪を備えて初めて「減点を避ける運用」から「加点を取りに行く運用」に転換できる。

停止条件

1. 収束完了 (Δneg < 0.10 AND Δpos < 0.10): 減らす問題も増やす良点もなくなった → status: complete
2. 発散 (Δneg が2周連続で増加): 改善方針自体に欠陥 → human_escalate
3. 安全弁発火 (iteration_count >= max_iterations(=3)): 上限到達 → status: incomplete、force_pass禁止、human_review必須

重要: 安全弁発火を成功扱いにすると Goodhart 罠が再生産される。max到達は失敗として扱う。

出力アーティファクト

• findings.json (機械可読)
• review-<target-type>.md (人間可読、template採用)
• paradigm-scorecard.csv (paradigm × condition matrix)
• variable-abstraction (具体値をテンプレート変数へ置換した対応表。findings.json と review に含める)

---

Gotchas

1. 30思考法すべて省略禁止 — JSONでは paradigm_findings 30件、各 observations / issues の構造を scripts/validate-paradigm-coverage.py が検証し、欠落あれば非ゼロ終了。
2. Phase1 を飛ばさない — 先入観のまま rubric チェックに入ると C2/C3 が偽陽性 PASS する。
3. Goodhart の罠 — score 最大化のために本質を歪めない。低score でも本質が正しいなら C1〜C4 のみで判定。
4. 並列前提 — Phase2 の3エージェントは互いの中間結果を参照しない (独立性確保)。
5. rubric_refs の継承 — ref-skill-design-rubric と elegant-4-conditions.json は deep-merge / most-specific-wins。
6. 具体値の直書き禁止 — 横展開を阻害する固有名詞・固定パス・固定URL・固定ownerは、テンプレート変数か config example に移す。例外は証跡・引用・source trace のみ。

---

Additional Resources

• references/30-paradigms-full.md — 30思考法すべての定義
• references/4-conditions.json — 4条件の機械可読定義
• references/elegant-4-conditions.json — rubric rule 表現
• references/agent-roles.md — エージェント1〜5の責務
• references/orchestration-flow.md — Phase1→2→3 詳細フロー
• references/variable-template-contract.md — 具体情報を変数化して横展開する契約
• templates/review-skill.md / review-rubric.md / review-proposal.md — 出力雛形
• templates/findings.json — JSON出力スキーマ
• scripts/build-paradigm-scorecard.py — matrix 生成
• scripts/validate-paradigm-coverage.py — 30思考法カバレッジ検査
• examples/example-review-output.md — 模擬レビュー完成例
• 関連: assign-skill-design-evaluator, ref-skill-design-rubric