Brackish: 두 개의 클로드 코드 인스턴스가 OpenAPI 3.1을 통해 API 계약을 협상하게 하기

Brackish는 두 개의 Claude Code 세션이 공유 OpenAPI 3.1 문서를 통해 API 계약을 협상할 수 있게 해주는 CLI 도구입니다. 이 도구가 해결하는 문제: 한 Claude가 FastAPI 소스를 가지고 있고 다른 Claude가 React/TypeScript 소스를 가지고 있을 때, 각각은 경계에 대해 서로 다른 가정을 합니다. Brackish는 구현 코드가 작성되기 전에 이러한 불일치를 표면화하고 해결하기 위한 제안/수락/거부 채널을 제공합니다.

작동 방식

대립적 역학은 의도적입니다. 예를 들어:

• 프론트엔드 Claude는 즉시 응답을 기대하는 POST를 초안합니다.
• 백엔드 Claude는 해당 작업이 몇 분이 걸린다는 것을 알기 때문에 해당 형태를 거부하고 작업 ID와 완료를 위한 SSE 스트림이 포함된 202 Accepted를 제안합니다.
• 이 불일치는 명시적 거부와 근거로 표면화됩니다. 어느 측도 코드를 작성하기 전에 말이죠.

Brackish는 중재자로 중간에 위치합니다. 올바른 API가 무엇인지 알지 못하지만, 두 Claude가 동의하는 모든 것이 유효한 OpenAPI 3.1임을 강제합니다. 출력은 openapi-typescript 및 fastapi-codegen 같은 도구에 직접 공급되며, 두 모델이 동의하는 임의의 마크다운이 아닌 실제 표준에 기반합니다.

설치

npm install -g brackish-cli && brackish install

대상 사용자

비교적 큰 프로젝트에서 Claude Code를 사용하며, 하나의 Claude가 양쪽을 모두 처리하는 것으로 충분하지 않은 개발자 — 특히 백엔드와 프론트엔드 팀(또는 세션)이 API 계약에 동의해야 할 때.