Brackish: 2つのClaude CodeインスタンスにOpenAPI 3.1経由でAPI契約を交渉させる

Brackishは、2つのClaude Codeセッションが共有のOpenAPI 3.1ドキュメントを介してAPI契約を交渉できるCLIツールです。解決する問題：一方のClaudeがFastAPIのソースを持ち、もう一方がReact/TypeScriptのソースを持つ場合、それぞれが境界について異なる仮定をします。Brackishは、実装コードが書かれる前に、それらの不一致を表面化して解決するための提案/承諾/拒否チャネルを提供します。

仕組み

対立のダイナミクスは意図的です。例えば：

• フロントエンドのClaudeは、即座の応答を期待するPOSTを起草します。
• バックエンドのClaudeは、その操作に数分かかることを知っているので、その形状を拒否し、ジョブIDと完了用のSSEストリームを伴う202 Acceptedを提案します。
• その不一致は、どちらかの側がコードを書く前に、明示的な拒否と理由として表面化します。

Brackishは仲介者として中央に位置します。正しいAPIが何かを知っているわけではありませんが、2つのClaudeが合意した内容が有効なOpenAPI 3.1であることを強制します。出力は、openapi-typescriptやfastapi-codegenなどのツールに直接供給されます。これは、2つのモデルがたまたま合意したマークダウンではなく、実際の標準に基づいています。

インストール

npm install -g brackish-cli && brackish install

対象者

両方を担当する単一のClaudeでは不十分な複雑なプロジェクトにClaude Codeを使用している開発者。特に、バックエンドとフロントエンドのチーム（またはセッション）がAPI契約に合意する必要がある場合に適しています。