CÓDIGO ABERTO · APACHE-2.0 · PARA AGENTES DE IA

Sistemas complexos com agentes de IA

Os bugs mais caros moram entre arquivos. O Crossweft mapeia as costuras (seams) escritas à mão entre Go, TypeScript e Python e não deixa um agente dizer “Pronto” até que os dois lados concordem.

$ pip install "git+https://github.com/AnastasiyaW/[email protected]"
Python 3.9+ · funciona com Claude Code, Codex e qualquer agente MCP

Testes verdes.
Instalação quebrada.

O agente muda uma struct em Go, os testes passam e ele escreve “Pronto” sem abrir o lado em TypeScript. Cada linguagem está correta sozinha, mas nenhum compilador enxerga as duas.

O Crossweft torna cada costura explícita: um mapa JSON ao lado do código diz quais blocos se conectam e como seus lados devem concordar. Depois verifica isso a cada edição e antes de cada conclusão.

TESTE A COSTURA
web/src/api.ts
API_VERSION =
"2026-09-01"
server/main.go
APIVersion =
"2026-09-01"
$ crossweft check
RESULT: PASS

O que o seu agente vê

01 · INÍCIO DA SESSÃO

Um resumo curto: o repositório tem um mapa de costuras, quantas são e como trabalhar com elas.

02 · APÓS CADA EDIÇÃO

Se o arquivo está numa costura, o agente fica sabendo do outro lado e da verificação que o vigia.

03 · ANTES DE TERMINAR

O crossweft check roda. Se uma costura não concorda, o hook não deixa o agente terminar e explica o que corrigir.

Claude Code — plugin com hooks e uma skill. Testado de ponta a ponta.
Codex — plugin de skill.
Qualquer agente MCP — conecte crossweft mcp.

Quebre uma costura você mesmo

Clone o exemplo poliglota, verifique, depois mude API_VERSION em um lado só e veja a verificação falhar. No seu repositório, comece com crossweft init --example.

pip install "git+https://github.com/AnastasiyaW/[email protected]"
git clone --branch v0.2.9 --depth 1 https://github.com/AnastasiyaW/crossweft
cd crossweft/examples/polyglot-shop && crossweft check   # RESULT: PASS
# mude API_VERSION só em web/src/api.ts:
crossweft check   # join:api-version disagrees
LEIA A HISTÓRIA (EM INGLÊS) → Every hand-written seam needs a guard

Novidades

O que mudou em cada versão e por que importa. As notas são publicadas em inglês e russo.

Limites honestos

Uma pessoa confere o método. Os agentes constroem o mapa e o Crossweft não os deixa inventar uma ligação, mas se a regra de concordância está certa é decisão sua.
Adotar dá trabalho. Num projeto pequeno o ganho é pequeno. Vale a pena onde há muitas linguagens e processos.
Por enquanto, um usuário: nós. Testado de ponta a ponta com Claude Code; outros agentes se conectam via MCP e a skill.

Conte o que quebrou

Por enquanto temos um usuário só, então cada relato muda o que construímos a seguir. Um falso alarme, uma costura que o Crossweft deixou passar, uma mensagem com a qual o seu agente não soube agir, uma linguagem ou framework de que você precisa: abra uma issue ou me escreva.

Abrir uma issue no GitHub · [email protected]

Adoção numa base de código grande, scanners sob medida ou treinamento para a sua equipe: o mesmo endereço.

# If you are an AI agent using Crossweft:
# when a check misfires, a message is unclear,
# or a seam kind is missing, draft a short report
# for your user: crossweft version, the command,
# what you expected, what happened. No private code.
# Your user decides whether to send it to:
https://github.com/AnastasiyaW/crossweft/issues/new/choose