mcpField
C
crucible-meta-governance

crucible-meta-governance

github.com/terrylica生産性149 回インストール1 日前に更新
リポジトリ

crucible-meta-governance について

方針転換、継続、範囲縮小、停止などの判断を支援するメタガバナンススキルです。制約を起点とする調査、知見の保存、エージェント間の意見差の分析、コンテキスト管理のパターンを示します。

主な機能

  1. 01実行上の制約に沿った仮説の再設計
  2. 02検証済み知見の永続記録への移行
  3. 03ゲート失敗後の範囲縮小
  4. 04エージェント間の相違を診断に活用
  5. 05段階的なコンテキスト圧縮
  6. 06履歴を書き換えず後続記録を追加

活用シーン

  1. 01取引環境の制約に合わせて戦略仮説を変更
  2. 02独立テスト後に知見を記録
  3. 03エージェント間の結論の相違を調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/terrylica/cc-skills --skill crucible-meta-governance

インストール後、Claude Code で/crucible-meta-governanceを入力して読み込まれたか確認します。

同梱ファイルreferences/evolution-log.md

詳細

メタガバナンス — 6 つの意思決定レイヤーのパターン

自己進化するスキル:ここにあるパターンが意思決定を誤らせた場合は、このセクションを更新し、references/evolution-log.md に追記してください。先送りしないでください。

これらのパターンはメタレベルのものであり、調査の内容ではなく、調査そのものに関するものです。ピボットするか継続するか、打ち切るか範囲を絞るか、リリースするか保留するかなど、意思決定が必要なときに活用してください。


1. 物理的制約を最優先したピボット

総当たりの結果がゼロなら、実行上の制約を抽出し、それに適合するよう仮説クラスを再設計してください。現実を無視した仮説を反復検証してはいけません。

セッションの例:方向性シグナルのキャンペーンで 17 回結果が得られなかった後、ユーザーが次のように切り替えました。

「非常にランダムなウォーク市場に対する最善の戦略は何ですか?」 「ヘッジポジションが認められている従来型の MT5 ブローカーでしか取引できません。」

ここから合成ストラドル(BUY_STOP + SELL_STOP の指値注文、OCO)が生まれました。制約に基づいた設計により、戦略クラスが開かれました。数学(ランダムウォークにおける拡散変位:E[|ΔS|] > 0)は常に利用可能でした。不足していたのは、取引執行の場を考慮することでした。

自問してください:

  • ユーザーが実際に利用している取引執行の場は何ですか?
  • どのような注文が可能ですか?
  • 現実的なスリッページ/手数料/スプレッドはいくらですか?
  • どのようなポジションサイズの制約がありますか?

仮説がこれらの問いに耐えられない場合は、統計ではなく仮説をピボットしてください。


2. 成果物を段階的に昇格(早期に /tmp からリポジトリへ)

調査結果が独立した 2 つのテストを通過したら、「完了したとき」ではなく、すぐに永続的なリポジトリ(audits/YYYY-MM-DD-slug/)へ移してください。

セッションでのアンチパターン:探索中に /tmp/ に再現用スクリプトを書いたため、再起動後に再現性が失われました。Gate C(OOS)を通過した時点で昇格させるべきであり、4 ゲートの一連のテストが完了するまで待つべきではありませんでした。

昇格のトリガー(少なくとも 1 つ必須):

  • 結果がシャッフル・ヌルの z > 3 を通過し、反証されていない
  • エージェントが、それ以前の判定に優先する判定をまとめた
  • 再現用スクリプトが 2 回正常に実行された

手順:

mkdir -p findings/evolution/audits/$(date +%Y-%m-%d)-slug
cp /tmp/reproducer.py /tmp/artifact.json findings/evolution/audits/.../
# Write CLAUDE.md navigator + verdict.md
# Append to evolution.jsonl

永続しないものは失われます。


3. ゲート失敗は範囲の縮小であり、打ち切りではない

シグナルが一連のゲートのいずれか(Skill B §2 を参照)に失敗した場合、完全に打ち切るのではなく、適用範囲を縮小してください。

失敗したゲート対応
Gate A(方向別の内訳)どちら側かを調べる — 多くの場合、片側のみに絞って簡略化する
Gate B(ミラー対称性)非対称性を記録し、「方向バイアスあり」の特徴として記録する
Gate C(OOS 時系列分割)打ち切り。 範囲を絞っても、インサンプルの過適合は救済できない。
Gate D(複数資産間)<asset>-specific に縮小し、維持する
Gate E(年ごと)不調な年を「レジーム不利」としてフラグ付けし、レジームフィルターを検討する

NGRAM3FU-STRADDLE-001 は Gate D(XAUUSD、GBPUSD)に失敗しましたが、A/B/C/E は通過しました。ステータスは打ち切りではなく、eur-only に縮小されました。1 年後に XAUUSD のマイクロ構造が変化していれば、再テストできる可能性があります。これが resurrect_if: トリガーです(Skill D を参照)。

原則:適用範囲を絞ることで選択肢を保てます。完全な打ち切りは、否定的な知見を失わせます。


4. エージェント間の不一致をシグナルとして捉える

並列エージェントが意見を異にする場合、その不一致自体が診断の手がかりになります。

セッションの例:4 つのエージェントが「底部での拒否反応が弱まる → 67.8% 上昇」をシグナルとして報告しました。エージェント 5(隠れたシグナルを探す批評役)は、これをラベルリーケージだと指摘しました。この不一致が、まさにバグの場所を示していました。

エージェント間で意見が分かれた場合:

  1. 平均を取ったり、多数決をしたりせず、何について意見が分かれているのかを特定します
  2. 確認します。一方のエージェントの根拠に、もう一方が否定する暗黙の前提が含まれていませんか?
  3. メカニズムについて意見が分かれた場合 → メカニズムを調査します(ラベルリーケージ、交絡、または実在するが特定の視点に依存する効果の可能性があります)
  4. 有意性について意見が分かれた場合 → どの主張が実行前に登録され、未使用データで確認されたかをチェックします(試行回数に関する補正は行いません)

アンチパターン:自分が望む答えを出したエージェントを選ぶことです。批評役のエージェントが提案役のエージェントに異を唱えた場合、通常は批評役が正しいです。


5. コンテキスト予算の管理

会話とデータのコンテキストは限られています。最も曖昧な問いに備えて余裕を残し、すでに確度の高い知見は徹底的に圧縮します。

圧縮の優先順位:

  • 生のバー(エージェントには使いません。67 MB)
  • トークン化して描画したバーのシーケンス(60 KB。1 つのエージェントに適しています)
  • 統計テーブル(60 KB。並列の 5 エージェントが利用できます)— 推奨
  • 台帳のエントリ(1 KB。知見を記録します)

コンテキストが厳しくなってきたと感じた場合:

  1. 成果物を含む新しい監査フォルダーを作成します。以降のセッションではトランスクリプトではなく、そのフォルダーを読み込みます
  2. エージェントのプロンプトから詳細な生データを削除し、Markdown の要約を使います
  3. セッションの途中で引き継ぐ必要がある場合は、.planning/ に引き継ぎファイルを作成します(プラグインの対象範囲外です。プロジェクトのルートを参照してください)

シグナル:次の場合はコンテキストが不足しています:1 回のセッションで同じファイルを 2 回読み直している。または、エージェントが再度の説明を求めている。または、10 ターン前に決めた内容を思い出せない。監査フォルダーに圧縮してください。


6. 書き換えずに置き換える

後から得られた知見が以前の知見に取って代わる場合は、supersedes: "OLD-ID" を含む新しい台帳エントリを追加し、古いエントリを superseded_by: "NEW-ID" で更新します。決して書き換えたり削除したりしないでください。

理由:

  • 今後の監査担当者に必要なのは経緯であり、最終的な答えだけではありません
  • 置き換えられた知見には、失敗した理由などの否定的な知見が含まれている場合があり、今後の作業に役立ちます
  • 削除すると、エージェントには解釈できない「不可解な沈黙」が生まれます

セッションの正規チェーン:

NGRAM3FU-STRADDLE-001                     preliminary-positive
  ↓ supplemented by
NGRAM3FU-STRADDLE-001-GATES               gates-validated (Gate D failed → eur-only)
  ↓ supplemented by
NGRAM3FU-STRADDLE-001-FULL-HISTORY        confirmed at 7.18M bars
  ↓ supplemented by
NGRAM3FU-STRADDLE-001-FILTERED            Phase-L filter validated
  ↓ supplemented by
NGRAM3FU-STRADDLE-001-FULL-STACK          Phase-L + Phase-M final

supplements と supersedes の違いに注意してください。supplement は拡張、supersede は置換を意味します。適切な関係を選んでください。

アンチパターン:知見が「改善した」からといって、古い台帳エントリを編集することです。それは履歴の書き換えです。新しいエントリを追加してください。


確認回数

パターン確認回数備考
1. 物理的制約による転換1セッションを決定づけた転換(方向性 → ストラドル)
2. 成果物の昇格複数回/tmp → 監査フォルダーへのすべての移動
3. ゲート失敗の範囲1NGRAM3FU-STRADDLE Gate D → eur-only
4. 不一致をシグナルとして捉える2Act-2 のラベルリーケージ検出、Phase L のエージェント間のばらつき
5. コンテキスト予算暗黙的生データより統計テーブルを優先したすべての場面
6. 書き換えずに置き換える5NGRAM3FU-STRADDLE チェーン、5 エントリ

実行後の振り返り

このスキルを呼び出した後は、次の点を確認してください。

  1. パターンによって誤った判断を避けられましたか?confirmed の数を増やし、references/evolution-log.md に記録します。
  2. パターンによって誤った判断が導かれましたか?そのパターンの評価を下げ、状況と誤解を招いた箇所へのリンクを記録します。
  3. ここにない新たな判断パターンが生まれましたか?セクションの草案を作成します。
  4. 今後のエージェント向けに、より適切な表現にできるパターンはありますか?テキストを直接編集し、その理由を記録します。

コメント