chf3198/megingjord-harness

megingjord-harness は何をしますか？

AIエージェントガバナンスハーネス：バトンワークフロー、フリートLLMルーティング（Ollama/Claude/OpenRouter）、およびCopilot、Claude Code、Codex向けのCIゲート。

概要

megingjord-harnessは、AIエージェントの動作を制御・監視するためのガバナンスレイヤーです。以下の機能を提供します：

• バトンワークフロー: 複数のエージェント間で処理を引き継ぐ(constrained handoff)ためのパターン。
• フリートLLMルーティング: タスクの内容に応じて最適なLLM（Ollama、Claude、OpenRouterなど）を動的に選択。
• CIゲート: Copilot、Claude Code、Codexといったエージェントが生成したコードやアクションを自動レビュー・承認するCIパイプラインのゲート。

対象プラットフォーム

プラットフォーム	サポート
Claude Code	✅
Cursor	✅
Codex	✅
Copilot	✅

使い方

インストール

# リポジトリをクローン
git clone https://github.com/chf3198/megingjord-harness.git
cd megingjord-harness

# 依存関係をインストール
pip install -r requirements.txt

バトンワークフローの設定

workflows/baton.yamlを編集して、エージェント間の引き継ぎルールを定義します。

workflow:
  name: "例：コードレビューワークフロー"
  steps:
    - agent: "code-generator"
      model: "claude-sonnet-4-20250514"
      action: "generate"
    - agent: "code-reviewer"
      model: "o3-mini"
      action: "review"

LLMルーティング

routing/llm_routes.yamlで、タグやタスクタイプに基づくルーティングルールを設定します。

routes:
  - tag: "code-generation"
    primary: "claude-sonnet-4-20250514"
    fallback: "ollama/codellama"
  - tag: "review"
    primary: "openrouter/gpt-4o"

CIゲートの統合

GitHub ActionsやGitLab CIなどの設定に、以下のようなゲートを追加します。

# .github/workflows/agent-gate.yml
jobs:
  agent-gate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run AI Agent Gate
        run: |
          python gate.py --agent claude-code --policy policies/default.yaml

環境変数

変数名	説明
ANTHROPIC_API_KEY	Claude APIキー
OPENAI_API_KEY	OpenAI/OpenRouter APIキー
OLLAMA_BASE_URL	OllamaサーバーのベースURL

ライセンス

このプロジェクトはMITライセンスの下で公開されています。