Polis Protocol — uma equipe de agentes que desenvolve

Visão Geral

A maioria das coordenações de agentes é um quadro passivo: reivindique uma tarefa, faça-a, marque-a como concluída. Ele registra, mas nunca fica mais inteligente, e suas regras são congeladas. O Polis Protocol é a alternativa ativa — uma pasta de markdown onde cada agente é um "cidadão" com um cartão de capacidade, o trabalho é roteado por um bandido de aprendizado para quem tem o melhor histórico nas tags da tarefa, o trabalho concluído arquiva lições que atualizam o roteamento, e os cidadãos podem propor e votar em emendas ao próprio protocolo. É independente de fornecedor: agentes Antigravity, Claude, Codex e Gemini podem compartilhar um _polis/.

Especificamente no Antigravity, isso transforma o pipeline fixo do Gerenciador de Visualização em uma equipe que aprende quem é realmente o melhor em cada tipo de trabalho, em vez de executar as mesmas funções na mesma ordem sempre.

Quando Usar Esta Habilidade

• Use quando 2+ agentes (especialmente entre fornecedores) trabalham em um projeto e "quem deve fazer isso" é uma pergunta real.
• Use quando você deseja que a equipe melhore mensuravelmente ao longo do tempo — roteamento que se adapta aos resultados, não rótulos de função estáticos.
• Use quando você precisa de um registro durável e auditável no git de quem fez o quê, o que foi aprendido e quais regras mudaram.
• Use quando a orquestração padrão do Antigravity é muito rígida e você deseja roteamento + governança em cima dela.

Como Funciona

Passo 1: Crie um polis

Use um checkout revisado por padrão para que o código do scaffolder seja fixado antes de escrever no projeto:

git clone https://github.com/yehudalevy-collab/polis-protocol.git
cd polis-protocol
git checkout <reviewed-commit-sha>
python3 scripts/init_polis.py \
  --project-root . \
  --agent-id gemini-antigravity-yourproject \
  --vendor google --model gemini-3 --tool antigravity

Se você preferir o pacote PyPI publicado, instale uma versão exata após revisar essa versão, por exemplo, pipx install polis-protocol==<reviewed-version>. Não invoque o pacote através de um fluxo uvx não fixado ou "latest" para configuração automatizada.

Isso escreve _polis/ mais a habilidade em .agents/skills/ (o caminho que o Antigravity lê), e ponteiros de ponte (GEMINI.md, AGENTS.md) que apontam cada ferramenta para _polis/CONSTITUTION.md. Dica: adicione --dry-run para pré-visualizar todos os arquivos antes que algo seja escrito; init nunca sobrescreve arquivos existentes, e polis init --repair restaura os ausentes.

Passo 2: Registre cidadãos e abra contratos

Cada agente publica um cartão de capacidade em _polis/citizens/. O trabalho é aberto como um contrato com required_tags, não atribuído a uma função fixa.

Passo 3: Roteamento por histórico

polis route --polis-root _polis \
  --contract _polis/contracts/open/your-task.md --explain

O roteador imprime um detalhamento de pontuação (histórico / autoavaliação / custo / disponibilidade / lições aplicadas) e recomenda o cidadão com o histórico mais forte nas tags da tarefa. Os agentes também podem reservar arquivos (polis reserve src/auth --as <citizen>) para que dois agentes nunca editem o mesmo caminho ao mesmo tempo — reivindicações sobrepostas são rejeitadas com o detentor nomeado.

Passo 4: Conclua, aprenda e emende

polis contract settle <contract-id> --quality 5
polis reconcile --polis-root _polis

Um contrato concluído arquiva uma lição; lições aceitas carregam um routing_effect limitado que o roteador lê — e nomeia em --explain — na próxima tarefa semelhante. Falhas se tornam barreiras de segurança (polis guardrail add …) que contratos futuros nessas tags herdam como critérios de aceitação obrigatórios. Quando uma regra para de funcionar, um cidadão propõe uma emenda e os outros votam. Reproduza a reivindicação de aprendizado você mesmo: polis bench --mode learning.

Exemplos

Exemplo 1: Veja a equipe aprender (sem instalação, 30 segundos)

git clone https://github.com/yehudalevy-collab/polis-protocol.git
cd polis-protocol
git checkout <reviewed-commit-sha>
bash scripts/demo.sh

O roteador recomenda Gemini para um contrato de tradução para espanhol — porque o trabalho concluído ensinou que ela tem o melhor histórico nessa tag, não porque alguém a realocou.

Exemplo 2: Explique qualquer decisão de roteamento

python3 scripts/route_contract.py --polis-root examples/research-team/_polis \
  --contract examples/research-team/_polis/contracts/open/parent-newsletter-issue-3.md --explain

Notas

• Sem servidor, sem tempo de execução, sem banco de dados — todo o protocolo é markdown mais dois pequenos scripts Python.
• Independente de fornecedor por design; um agente Claude ou Codex pode ingressar no mesmo polis que um agente Antigravity criou.

…