mcpField
O
omerta

omerta

github.com/kucherenkoエージェントワークフロー8543 回インストール1 日前に更新
リポジトリ

omerta について

Omerta は Gangsta Agents Family 向けのガバナンススキルです。エージェント間の連絡、チェックポイント、出典の提示、予算管理、仕様に沿った変更を定めます。

主な機能

  1. 01階層を介したエージェント間連絡
  2. 02ファイルによる状態チェックポイント
  3. 03主張への出典の提示
  4. 04トークン予算の管理
  5. 05仕様に沿った変更の徹底

活用シーン

  1. 01エージェントの役割間で作業を調整
  2. 02セッション中断後に作業を再開
  3. 03プロジェクトの出典に基づき主張を確認
  4. 04タスク実行時のリソース予算を管理

インストール

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

$npx skills add https://github.com/kucherenko/gangsta --skill omerta

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

詳細

Omerta：Gangsta Agents Family の掟

概要

Omerta は、Gangsta Agents Family のガバナンスフレームワークです。これは特定のフェーズではなく、すべてのスキルがすべての段階で徹底する、横断的な要件です。これらの掟に例外はありません。

五つの掟

掟 1：紹介のルール（認可プロトコル）

Underboss または Don の仲介なしに、エージェント同士がやり取りすることはありません。

  • Worker 同士が直接やり取りすることはできません
  • すべてのメッセージは、Worker → Crew Lead → Underboss の経路を通ります
  • これにより、エージェントが仕様の範囲外で共通の前提を形成する「影の連携」を防ぎます
  • 違反：エージェント同士で直接メッセージを送ろうとする行為はすべてブロックされ、記録されます
掟 2：可用性のルール（状態の永続性）

すべての Heist の状態は、必ずファイルにチェックポイントとして保存してください。セッションが中断された場合も、状態を復元できなければなりません。

  • チェックポイントの保存先：docs/gangsta/<heist-name>/checkpoints/YYYY-MM-DD-checkpoint-<phase>.md
  • チェックポイントの形式：フェーズ、ステータス、タイムスタンプ、再開手順を含む YAML フロントマター
  • フェーズを移行するたびに、次のフェーズを開始する前にチェックポイントを保存します
  • セッション再開時は、Don が最新のチェックポイントを読み込み、その時点から続行します

チェックポイントのテンプレート：

---
heist: <heist-name>
phase: <current-phase>
status: in-progress | completed | blocked
timestamp: YYYY-MM-DDTHH:MM:SS
next-action: <what to do next>
artifacts:
  - <list of files produced so far>
---

## Resume Context
<Summary of what has been done and what remains>
掟 3：真実のルール（ハルシネーション防止）

すべての主張には、必ず出典を示してください。エージェントは「事実優先」の姿勢を取ります。

主張の種類必須の出典
コードの動作file:line 参照
仕様要件Contract のセクション名
アーキテクチャ上の決定Constitution の項目
過去のパターンLedger のインサイト／失敗事例の参照
  • 出典のない主張は無効であり、直ちに指摘しなければなりません
  • Consigliere は、いつでも Truth チェックを実施する権限を持ちます
  • 指摘を受けたエージェントは、出典を提示するか、主張を撤回しなければなりません
掟 4：予算のルール（リソース管理）
  • 各 Crew Lead は、Underboss が設定した割り当て済みのトークン予算内で作業します
  • Worker は、Reports でリソース消費量を報告します
  • あるテリトリーが予算を超過した場合、Underboss が追加配分を承認するまで作業を一時停止します
  • すべての「利益」（マージされたコード、合格したテスト）は、Worker → Crew Lead → Underboss → Don の経路で上位に報告します
掟 5：仕様は絶対

仕様は、絶対的な真実の拠り所です。

  • コードが仕様と矛盾する場合は、まず仕様を改訂します。逆は決して行いません
  • 「影のコード」によるホットフィックスは禁止です。すべてのコード変更は、Contract の条項に基づいていなければなりません
  • The Hit の最中にバグが見つかった場合：
    1. Worker が Crew Lead にエスカレーションします
    2. Crew Lead が Underboss にエスカレーションします
    3. Underboss は、Contract を改訂するためのミニ Grilling（1 回のみ）を実施できます
    4. Contract を改訂した後に限り、実装を進めます

Omerta 準拠チェックリスト

すべてのスキルは、次のフェーズまたはアクションに進む前に、このチェックリストを必ず確認してください。

  • 紹介のルール： エージェント間のやり取りはすべて階層を介している（Worker 同士の直接連絡はない）
  • 可用性のルール： 現在の状態がファイルにチェックポイントとして保存されている
  • 真実のルール： すべての主張に出典が示されている（無効な主張がない）
  • 予算のルール： リソース消費量が割り当て済みの予算内に収まっている
  • 仕様は絶対： すべての変更が Contract の条項に基づいている

危険信号

次のようなことを考えたら、そこで止まってください。Omerta に違反しようとしています。

考え違反する掟
「仕様を更新せずに、この修正をさっと済ませよう」掟 5：仕様は絶対
「これは事実だと分かっているから、出典を示す必要はない」掟 3：真実のルール
「別のエージェントに直接聞こう。そちらのほうが早い」掟 1：紹介のルール
「この作業が終わったらチェックポイントを保存しよう」掟 2：可用性のルール
「もうすぐ終わるのだから、今は予算を気にしなくていい」掟 4：予算のルール

コメント

Markdown 対応