Солоноватый: Пусть два экземпляра Claude Code согласуют контракт API через OpenAPI 3.1

Brackish — это CLI-инструмент, который позволяет двум сессиям Claude Code согласовать API-контракт через общий документ OpenAPI 3.1. Проблема, которую он решает: когда один Claude имеет исходный код FastAPI, а другой — React/TypeScript, каждый делает предположения о границах, которые расходятся. Brackish предоставляет канал предложения/принятия/отклонения для выявления и разрешения этих разногласий до того, как будет написан код реализации.

Как это работает

Противостояние заложено намеренно. Например:

• Фронтенд Claude создает POST, ожидая немедленного ответа.
• Бэкенд Claude знает, что эта операция занимает несколько минут, поэтому отклоняет структуру и предлагает 202 Accepted с идентификатором задания и SSE-потоком для завершения.
• Это разногласие проявляется как явное отклонение с обоснованием — до того, как любая из сторон напишет код.

Brackish выступает в роли арбитра. Он не знает, какой API правильный, но обеспечивает, чтобы то, о чем договорились два Claude, было валидным OpenAPI 3.1. Результат напрямую передается в такие инструменты, как openapi-typescript и fastapi-codegen — основанные на реальном стандарте, а не на разметке, о которой договорились две модели.

Установка

npm install -g brackish-cli && brackish install

Для кого это

Для разработчиков, использующих Claude Code в нетривиальных проектах, где одного Claude, работающего над обеими сторонами, недостаточно — особенно когда команды бэкенда и фронтенда (или сессии) должны согласовать API-контракт.