Brackish: Deja que dos instancias de Claude Code negocien un contrato API mediante OpenAPI 3.1

Brackish es una herramienta CLI que permite que dos sesiones de Claude Code negocien un contrato de API a través de un documento OpenAPI 3.1 compartido. El problema que resuelve: cuando un Claude tiene el código fuente de FastAPI y otro tiene el de React/TypeScript, cada uno hace suposiciones sobre los límites que divergen. Brackish proporciona un canal de propuesta/aceptación/rechazo para identificar y resolver esos desacuerdos antes de que se escriba cualquier código de implementación.

Cómo funciona

La dinámica adversarial es intencional. Por ejemplo:

• El Claude del frontend redacta un POST esperando una respuesta inmediata.
• El Claude del backend sabe que esa operación toma varios minutos, por lo que rechaza la forma y propone un 202 Accepted con un ID de trabajo y un flujo SSE para la finalización.
• Ese desacuerdo se manifiesta como un rechazo explícito con una justificación — antes de que cualquiera de las partes escriba código.

Brackish actúa como árbitro en medio. No sabe cuál es la API correcta, pero garantiza que lo que acuerden los dos Claudes sea OpenAPI 3.1 válido. La salida se alimenta directamente en herramientas como openapi-typescript y fastapi-codegen — basada en un estándar real, no en cualquier markdown en el que dos modelos coincidan.

Instalación

npm install -g brackish-cli && brackish install

Para quién es

Desarrolladores que usan Claude Code para proyectos no triviales donde un solo Claude trabajando en ambos lados no es suficiente — especialmente cuando los equipos (o sesiones) de backend y frontend necesitan ponerse de acuerdo en un contrato de API.