Brackish: Deixe Duas Instâncias do Claude Code Negociarem um Contrato de API via OpenAPI 3.1

Brackish é uma ferramenta CLI que permite que duas sessões do Claude Code negociem um contrato de API por meio de um documento OpenAPI 3.1 compartilhado. O problema que resolve: quando um Claude tem o código-fonte do FastAPI e outro tem o código-fonte do React/TypeScript, cada um faz suposições sobre os limites que divergem. O Brackish fornece um canal de propor/aceitar/rejeitar para expor e resolver essas divergências antes que qualquer código de implementação seja escrito.

Como funciona

A dinâmica adversarial é intencional. Por exemplo:

• O Claude do frontend cria um POST esperando uma resposta imediata.
• O Claude do backend sabe que essa operação leva vários minutos, então ele rejeita o formato e propõe um 202 Accepted com um ID de job mais um stream SSE para conclusão.
• Essa divergência aparece como uma rejeição explícita com uma justificativa — antes que qualquer lado escreva código.

O Brackish atua como um árbitro no meio. Ele não sabe qual é a API correta, mas garante que o que os dois Claudes concordarem seja OpenAPI 3.1 válido. A saída alimenta diretamente ferramentas como openapi-typescript e fastapi-codegen — baseada em um padrão real, não em qualquer markdown que dois modelos concordem.

Instalação

npm install -g brackish-cli && brackish install

Para quem é

Desenvolvedores que usam Claude Code em projetos não triviais onde um Claude trabalhando em ambos os lados não é suficiente — especialmente quando equipes (ou sessões) de backend e frontend precisam concordar sobre um contrato de API.