consensus

コンセンサス

各開発者が同じコードベースで AI コーディングエージェントを実行しているチームのための調整ツールです。

エージェントがコードを書く前に、計画を宣言します。コンセンサスは、その計画を進行中のほかのすべての計画とチームの既知の情報に照らして確認し、1秒以内に次のいずれかを回答します。進める、コンテキストを踏まえて進める、または待つ。

なぜ必要なのか

AI コーディングエージェントは高速で、単独で作業します。チームで使うと、Git では検出できない次の2つの問題が発生します。

• 一切重ならないファイル間で設計が衝突する。 あるエージェントがセッションを署名付きトークンに移行する一方で、別のエージェントがサーバー側セッションを前提とするログインエンドポイントを追加します。マージコンフリクトは発生しません。相容れない2つの設計が、数日後のレビューで発覚します。
• エージェントは毎回ゼロから始める。 同じコードが再び読み込まれ、同じ行き止まりが再び試され、あるエージェントの学びが次のエージェントに届きません。

できること

• 書く前に宣言する。 計画は、変更対象のファイルではなく、その内容に基づいて比較されます。コードが存在する前に衝突を検出します。
• 共有メモリ。 エージェントはコードベースを読む前にチームの知見を確認し、作業しながら発見、決定、行き止まりを記録します。
• 積み重なる人間の判断。 2つの計画が実際に衝突した場合、人が一度だけ判断します。その判断は保存され、同じ衝突を引き起こす今後のすべての計画に自動で適用されます。
• 明確な引き継ぎ。 作業が終わると、エージェントは変更点、変更しなかった点、前提としたことを提出します。それがプルリクエストになります。

コンセンサスがコードを読み取り、書き込み、実行、マージすることはありません。

仕組み

1. 1回の言語モデル呼び出しで、計画の スタンス を抽出します。つまり、関わる概念と、エラー処理、認証、データアクセス、API の構造に関する方針です。触れていない軸は空のままとし、推測は行いません。
2. 最も関連性の高い未完了の計画とメモリエントリを、ベクトル検索で取得します。
3. 計画を決定論的に比較します。共通する概念について方針が異なる場合は衝突です。同じ入力には常に同じ回答が返され、すべての入力が記録されます。
4. 人に判断を求める前に、重大な衝突が過去の判断と照合されます。

詳細：仕組み。

エージェントの接続

コンセンサスは MCP サーバーです。各開発者は個人用 API キーを作成し（設定ページ、または POST /api/me/api-keys）、コーディングエージェントに接続します。

Claude Code、ガードレール付き（推奨）。プラグインはサーバーに加え、ワークフローを教えるスキルと、計画が宣言されて判定で許可されるまで Edit／Write を拒否するフックを追加します。

export CONSENSUS_API_KEY="csk_..."          # CONSENSUS_URL defaults to the hosted instance
claude plugin marketplace add masterblaster14/Consensus
claude plugin install consensus@consensus

Claude Code、サーバーのみ：

claude mcp add --transport http consensus https://consensus-production-aed6.up.railway.app/mcp --header "Authorization: Bearer csk_..."

Cursor、Windsurf、その他の MCP クライアント。 クライアントの MCP 設定に追加します。

{ "mcpServers": { "consensus": { "url": "https://consensus-production-aed6.up.railway.app/mcp", "headers": { "Authorization": "Bearer csk_..." } } } }

MCP Registry に io.github.masterblaster14/consensus として登録されているため、レジストリ対応クライアントは名前で検索できます。

エージェントの操作はすべて、キーを所有する開発者に帰属します。ツール：declare_intent、check_verdict、query_memory、write_memory、file_handoff、withdraw_claim、get_status、report_usage。

チームと連携機能

• GitHub またはメールリンクでサインインします。最初に組織を作成した人が管理者となり、ほかのメンバーは招待リンクまたはメールドメインから参加します。
• リポジトリごとに共有のライブボードを1つ使用できます。
• GitHub：引き継ぎからプルリクエストを作成し、判断を PR コメントにし、マージされた PR の計画を終了します。
• Notion：タスクを取り込み、決定と判断を反映します。

ホスト版インスタンス：https://consensus-production-aed6.up.railway.app（API ドキュメントは /docs、ライブボードは /board）。

実行方法

Python 3.11、pgvector を有効にした PostgreSQL、Redis が必要です。データベースには Docker Compose を使用します。オフラインモードでは API キーは不要です。

docker compose up -d
.venv/Scripts/python -m alembic upgrade head
.venv/Scripts/python -m scripts.seed_demo
.venv/Scripts/python -m uvicorn app.main:app --port 8000

または、スタック全体をコンテナーで起動します：docker compose --profile full up -d --build。

セットアップの詳細、設定、API 全体についてはバックエンドリファレンスをご覧ください。ホスティングについてはデプロイをご覧ください（Render blueprint、Railway、Fly、または任意の Docker ホスト）。

ライセンス

MIT。LICENSEをご覧ください。

Documentation

• Getting started
• How it works
• Features
• Pitch briefing and Q&A
• Demo script and demo runbook
• Backend reference
• Pricing