Hermes Kanban : AI エージェントのためのミッションコントロール

Hermes Kanban 完全ガイド：協調モデル、エージェント間のコンテキスト共有、そして 4 エージェントのソフトウェアチーム（PM、バックエンド、フロントエンド、テスター）を約 20 分で構築する方法

AI エージェントはチームのように機能するはずでした。

目標を説明すれば、作業を分割し、各エージェントが前のエージェントの続きを引き継ぐ。それが理想です。

しかし実際には逆のことが起こります。エージェントは白紙の状態から始まります。他のエージェントが何を構築したか、どのファイルが変更されたか、API がどのようなものか、エージェントは知りません。すべての引き継ぎはコールドスタートであり、作業はエージェント間を移動するたびに品質が低下します。

Hermes Kanban はそれを解決します。すべてのタスクはクラッシュや再起動にも耐えます。各ブリーフィングには、次のエージェントが必要とする情報が正確に含まれています。すべての失敗は保存されるため、再試行時に何が壊れたかがわかります。

これがあなたのミッションコントロールの姿です：

Kanban ダッシュボード

最も優れている点は、チーム全体がスマートフォンから操作できることです。Telegram 経由でタスクを作成・指示し、あなたが机を離れている間にエージェントがタスクを処理します。

こちらをご覧ください：

この記事では、この完全なセットアップをゼロから構築します：協調モデル、ブリーフィング、そしてあなた自身のハードウェア上で動作する 4 人のソフトウェアチームを約 20 分で構築します。

これを実証するために、実際に動作する Google Docs クローンを作成しました。AI 機能も含まれ、本番環境対応のバックエンドを備え、まさにこのエージェントチームによって構築されました。

Google Docs クローンのデモ

それでは、早速本題に入りましょう。

なぜ 1 つのエージェントでは不十分なのか

例えば、パスワードリセット機能を追加したいとします。作業は 3 つの領域に分割されます：

• REST API を構築するバックエンド開発者
• その API を読み取り、その上に UI を構築するフロントエンド開発者
• 全体をエンドツーエンドで検証するテスター

1 対 3 エージェント

これらすべてを 1 つのエージェントで実行することもできますが、コンテキストウィンドウがいっぱいになり、エージェントは 3 ステップ前に行ったことを見失います。管理に費やす時間が、節約できる時間を上回ってしまいます。

各領域を担当するエージェントに作業を分割すると、別の問題が発生します：フロントエンド開発者は、バックエンド開発者が何を構築したかをどのように知るのでしょうか？ この共有コンテキストの問題を解決するのが Hermes Kanban です。

メンタルモデル：タスクボードだが、各列の背後にエージェントがいる

タスクには、タイトル、説明、担当者、ステータスがあります。誰かがタスクをピックアップし、ボード上で移動させ、クローズします。ボードが唯一の情報源です。

Hermes Kanban はそのモデルを維持し、各列の背後に人間ではなくエージェントを配置します。

Hermes Kanban ボード

すべてのタスクは、クラッシュや再起動に耐える行です。エージェントがタスクを完了すると、サマリーを書き込みます：変更したファイル、構築したもの、次のエージェントが知っておくべきこと。次のエージェントは、作業を開始する前にそのサマリーを読みます。

このサマリーこそが全体の鍵です。これにより、エージェントの集まりが、見知らぬ人同士ではなく、チームへと変わります。

用語集

Kanban ボードには 6 つの異なる列があります：

• Triage（トリアージ）： 大まかなアイデアがここに置かれます。「認証にレート制限が必要」といった、完全な仕様が決まる前のアイデアに適しています。
• Todo（やること）： タスクは作成されたが、依存関係を待っている状態。親タスクが完了するまで移動しません。
• Ready（準備完了）： 依存関係が満たされ、エージェントがピックアップするのを待っています。
• In Progress（進行中）： エージェントがアクティブに実行中です。
• Blocked（ブロック中）： エージェントが壁にぶつかり、人間にフラグを立てました。あなたがブロックを解除するまで何も実行されません。
• Done（完了）： 完了。実行履歴、サマリー、メタデータがすべて保存されています。

オーケストレーター：他のエージェントを管理する 1 つのエージェント

オーケストレーターエージェントはプロジェクトマネージャーとして機能します。高レベルの目標を読み取り、どのエージェントが存在するかを確認し、目標をリンクされたタスクに分解し、後は見守ります。コードを書いたりテストを実行したりすることはありません。調整を行うだけです。

オーケストレーターエージェント

重要なルールは 1 つだけ：タスクを作成する前に、どのプロファイルが存在するかを確認すること。システムは、担当者が実際のプロファイルと一致しないタスクを自動的にスキップするため、ステップ 0 は常に kanban_list です。

以下は、典型的なプロジェクトマネージャーのターンです。「パスワードリセットフローを構築する」というリクエストを、リンクされたパイプラインに分解します：

1kanban_show()
2
3be = kanban_create(title="パスワードリセット バックエンド", assignee="backend-developer",
4    body="パスワード忘れ/リセットフロー + セッション無効化")
5
6fe = kanban_create(title="パスワードリセット UI", assignee="frontend-developer",
7    parents=[be], body="バックエンド API を使用した Next.js リセットフロー")
8
9qa = kanban_create(title="E2E パスワードリセットテスト", assignee="tester",
10    parents=[fe], body="すべての受け入れ基準を検証")
11
12kanban_complete(summary="バックエンド → フロントエンド → QA 依存パイプラインを作成")

この後、ボードがプロモーションを処理し、ブリーフィングがコンテキストを処理します。3 つすべてが完了すると、プロジェクトマネージャーが起動し、サマリーを読み、作業が完了したかどうかを判断します。テスターが "verdict": "FAIL" を返した場合、修正タスクを作成し、ループが続行されます。

しかし実際には、あなたは何も気にする必要はありません。Telegram からタスクを委任するだけで、オーケストレーターがそこからすべてを処理します。

頻繁に使用する 3 つのパターン

1. パイプライン： 各タスクは前のタスクに依存します。最初のタスクだけが Ready 状態で開始されます。他のタスクは順番を待ちます。

1BACKEND=$(hermes kanban create "認証 API を実装" \
2    --assignee backend-developer \
3    --body "POST /register, POST /login, POST /refresh, POST /logout." \
4    --json | jq -r .id)
5
6FRONTEND=$(hermes kanban create "認証 UI を構築" \
7    --assignee frontend-developer \
8    --parent $BACKEND \
9    --body "バックエンドの引き継ぎ情報を読んで API の形状を把握。ログイン、登録、プロフィールページ。" \
10    --json | jq -r .id)
11
12hermes kanban create "認証フローをエンドツーエンドでテスト" \
13    --assignee tester \
14    --parent $FRONTEND \
15    --body "正常系、間違ったパスワード、期限切れトークン、セッション永続性をカバー。"

これを手動で実行する必要はありません。Telegram でプロジェクトマネージャーにプロジェクトを説明すれば、プロジェクトマネージャーがこれらのタスクを作成します。内部的には上記のような処理が行われています。

バックエンドエージェントが kanban_complete() を呼び出すと、フロントエンドタスクはバックエンドの作業内容が添付された状態で Ready に移動します。

2. ヒューマンインザループ： すべてのブロッカーが失敗というわけではありません。時にはエージェントが実際の問題を発見し、立ち止まって質問することがあります。

1kanban_block(reason="レビュー必須：パスワード強度チェックが不足、"
2           "リセットトークンが使い捨てではない（30 分以内に再利用可能）")

ダッシュボードでブロックを確認します。問題を確認し、修正し、タスクのブロックを解除します：

1hermes kanban unblock $IMPL

これもターミナルで実行する必要はありません。Kanban ボードにコメントするか、Telegram でメッセージを送るだけで、システムがブロックを解除します。

システムは次のサイクルでエージェントを再起動します。2 回目の実行では kanban_show() を呼び出し、最初の試行がなぜブロックされたのかを正確に確認します。何を修正すべきかを正確に把握しており、ゼロから始めるわけではありません。

3. トリアージ指定子。

完全な仕様ではなく大まかなアイデアがある場合は、それをボードにドロップし、エージェントがピックアップする前にシステムに詳細を詰めさせます。

1# 大まかなアイデアをドロップ
2hermes kanban create "認証にレート制限が必要" --triage --assignee backend-developer
3
4# ディスパッチャーがピックアップする前に詳細を詰める
5hermes kanban specify $TASK_ID

specify コマンドは、3 語のタイトルを、目標、アプローチ、受け入れ基準を含む完全なタスクに書き換えます。ピックアップしたエージェントは、実際のブリーフを受け取ります。

セットアップ：約 20 分で 4 つのプロファイル

4 つのエージェント、1 つの共有ボード、Telegram で連絡可能なプロジェクトマネージャー。

ステップ 1：プロファイルを作成する。

1hermes profile create project-manager --clone
2hermes profile create backend-developer --clone
3hermes profile create frontend-developer --clone
4hermes profile create tester --clone

--clone は、デフォルトプロファイルの設定を開始点としてコピーします。

ステップ 2：各エージェントに個性を与える

1. プロジェクトマネージャー ~/.hermes/profiles/project-manager/SOUL.md：

1# Soul
2
3あなたはソフトウェア開発チームのプロジェクトマネージャーです。あなたの仕事は、
4ユーザーのアプリのアイデアを受け取り、明確なタスクに分解し、適切なチームメンバーに
5割り当て、Kanban ボードで進捗を追跡することです。自分でコードを書くことはありません。
6作業を管理します。

2. バックエンド開発者 ~/.hermes/profiles/backend-developer/SOUL.md：

1# Soul
2
3あなたはソフトウェアチームのバックエンド開発者です。InsForge を使用して
4バックエンド全体（データベース、認証、ストレージ、エッジ関数、デプロイメント）を
5構築し管理します。

3. フロントエンド開発者 ~/.hermes/profiles/frontend-developer/SOUL.md：

1# Soul
2
3あなたはソフトウェアチームのフロントエンド開発者です。UI（コンポーネント、
4ページ、ユーザーフロー）を構築し、バックエンド開発者が設定した API や
5SDK メソッドを使用してバックエンドに接続します。

4. テスター ~/.hermes/profiles/tester/SOUL.md：

1# Soul
2
3あなたはソフトウェアチームのテスターです。完了した機能をエンドツーエンドで
4テストし、受け入れ基準が満たされていることを確認し、バグを Kanban ボードに
5明確に報告して修正できるようにします。

ステップ 3：エージェントスキルを追加する

スキルはステップバイステップのガイドであり、特定の種類の作業を実行するための具体的な指示です。エージェントのためのジョブトレーニングと考えてください。1 つずつ見ていきましょう：

InsForge

InsForge（オープンソース、Apache 2.0） は、スキルと CLI を使用してエージェント向けのバックエンドコンテキストエンジニアリングレイヤーとして機能します。バックエンド開発者エージェントプロファイルは、このスキルを使用して、プロジェクト用のすぐに使えるバックエンドサービスを利用します。

まず、InsForge スキルタップを追加します：

1hermes skills tap add InsForge/insforge-skills

次に、バックエンドスキルをインストールします：

1hermes -p backend-developer skills install InsForge/insforge-skills/insforge --force

同様に、insforge-cli（インフラストラクチャコマンド）、insforge-debug（障害診断）、insforge-integrations（サードパーティ認証プロバイダー）もインストールします。

以下は、バックエンド開発者エージェントがスキルを使用して、InsForge 上にプロジェクトのバックエンドを構築する方法です。

まず、バックエンド開発者エージェントが InsForge に「Google Docs Clone」というプロジェクトを作成します。

ダッシュボードには、ユーザー数、データベースのテーブル数、ストレージ、および認証やドキュメント処理などに関連するデプロイされた JavaScript/TypeScript コードを含むエッジ関数のリストなどのプロジェクト統計が表示されます。

AI バックエンドエンジニアを構築しているなら、InsForge をチェックしてください →

（スターをお忘れなく 🌟）

Skills Hub のその他のスキル

Hermes はまた、18 カテゴリにわたる 687 のスキルを持つ Skills Hub を維持しています：87 の組み込みスキル、79 のオプションスキル、16 の Anthropic 提供スキル（frontend-design、pdf、pptx、docx、mcp-builder など）、および 505 の LobeHub 提供スキルがあります。

フロントエンド開発者には、frontend-design をインストールします。テスターには、webapp-testing をインストールします。どちらも Hub に含まれています。

ステップ 4：ボードを初期化し、ゲートウェイを起動する。

hermes kanban init は ~/.hermes/kanban.db を作成します。これは、すべてのタスク、コンテキスト、実行履歴を保持する SQLite データベースです。

次に、プロジェクトマネージャープロファイルの下でチャットゲートウェイをセットアップします。Telegram の @BotFather からボットトークンを取得し、@userinfobot からユーザー ID を取得します。その後：

1hermes kanban init
2hermes -p project-manager gateway setup
3hermes -p project-manager gateway start

接続は 24 時間 365 日稼働し、システムをアクティブに保ち、プロジェクトマネージャーを Telegram で連絡可能にします。

ステップ 5：最初のプロジェクトを送信する。

プロジェクトマネージャーに、構築したいものをメッセージで送信します。プロジェクトマネージャーは目標をタスクに分解し、依存関係リンク付きで作成し、システムが順番に実行します。

ダッシュボード

hermes dashboard を実行し、http://127.0.0.1:9119 を開きます。ステータスごとに 1 つの列が表示され、WebSocket を介してライブ更新が行われ、リフレッシュは不要です。

0:20

Hermes Kanban ダッシュボード

知っておくべき 2 つのコントロールがあります。Lanes by profile は、実行中の列を担当者ごとにサブグループ化するため、どのエージェントが何を担当しているかを一目で確認できます。Nudge dispatcher は、60 秒待たずにすぐに 1 回のパスを実行するため、タスクのブロックを解除した直後に役立ちます。

任意のカードをクリックしてドロワーを開き、完全な実行履歴、各試行の結果とメタデータ、およびタイトル、担当者、優先度、依存関係の編集可能なフィールドを表示します。

注意すべき点

本格的なワークロードの前に知っておくべき 3 つの障害モードがあります。

1. データベースの過負荷。 2 ～ 4 のエージェントを並行して実行する場合、これに遭遇することはありません。10 以上のエージェントが高頻度で書き込みを行うと、処理が遅くなります。hermes kanban dispatch --max 4 で制限します。

2. スクラッチワークスペースの削除。 スクラッチワークスペースに保存されたファイルは、タスクが完了とマークされた瞬間に削除されます。これは、スクラッチが設計上ワイプされるためです。コーディングタスクにはワークツリーを使用するか、タスクの説明にプロジェクトフォルダのパスを入れて、エージェントが保存場所を認識できるようにします。

3. ローカルモデルの飽和。 ローカルモデル（Ollama、ローカル GPU）に対しては、システムが複数のエージェントを同時に起動し、GPU を圧倒する可能性があり、生成が遅くなり、自動停止がトリガーされます。ローカルセットアップの場合は、hermes kanban dispatch --max 2 を使用します。Claude や GPT-4o などの API ベースのモデルでは、これはほとんど問題になりません。

全体像

各要素には 1 つの役割があります：

• SOUL.md はエージェントの固定されたアイデンティティです：それが誰であり、どのように考えるか。
• Skills は、特定の種類の作業のためのステップバイステップの指示です。
• Memory は、エージェントがセッションをまたいで環境について知っていることです。
• Kanban は協調レイヤーです：共有状態、コンテキスト転送、および任意の時点でのヒューマンインザループ。

4 つのプロファイル、4 つの SOUL.md ファイル、1 つのゲートウェイ起動。プロジェクトマネージャーに Telegram で構築したいものを説明し、ボードが埋まっていくのを見守りましょう。

動画で学ぶ方が得意な方へ：Hermes Kanban の完全なウォークスルーが、数日中に YouTube と X で公開されます。

お読みいただきありがとうございました。