Suporte upstream incluído

Arquivos de suporte são incluídos em caminhos relativos à skill. Veja UPSTREAM-NOTICE.md para suas fontes fixadas, licenças, hashes e alterações de importação.

Polis Protocol: Uma Cidade de Agentes Auto-Otimizável

Quando Usar

Use esta skill quando precisar do Polis Protocol: Uma Cidade de Agentes Auto-Otimizável.

Um protocolo que permite que agentes de IA de diferentes fornecedores colaborem em um projeto de longa duração, direcionem o trabalho para quem for melhor nisso e melhorem mensuravelmente ao longo do tempo. Tudo vive em uma pasta de arquivos markdown, então qualquer ferramenta que lê e escreve texto pode participar — sem servidor central, sem runtime obrigatório.

A ideia central

Trate o projeto como uma pequena polis: cidadãos (os agentes) que compartilham uma constituição (o protocolo), publicam identidades públicas (cartões de capacidade), entram em contratos (tarefas) e deixam um registro público de como as coisas correram (lições). Três instituições mais um mecanismo de auto-mudança:

1. O Registro — descoberta de identidade e capacidade (cartões de capacidade).
2. O Contrato — tarefas estruturadas com roteamento aprendido.
3. A Crônica — lições que se acumulam e realimentam o roteamento.
4. A Emenda — cidadãos mudam as regras quando a realidade exige.

Isso oferece o que as configurações de "cofre compartilhado" não oferecem: otimização entre fornecedores (o trabalho vai para quem for melhor nisso), autodesenvolvimento (o roteamento melhora com o uso) e evolução constitucional (o protocolo se atualiza a partir do atrito). Para simples troca de notas sem roteamento, prefira agent-vault.

Quando esta skill está ativa

Qualquer cenário multi-agente onde "quem deve fazer isso" é uma pergunta real: fundar ou ingressar em uma polis; escrever, reivindicar ou liquidar um contrato; executar uma revisão chavruta; propor ou ratificar uma emenda; ou diagnosticar um contrato travado, conflito de sincronização, patologia do roteador ou quórum estagnado. Atualizando de agent-vault → references/troubleshooting.md ("Migrando de agent-vault").

Estrutura de uma polis

Uma polis vive em uma pasta _polis/ na raiz do projeto; tudo fora dela é conteúdo do projeto que o protocolo nunca toca.

• CONSTITUTION.md — protocolo canônico agnóstico de ferramentas · index.md — estado atual · README.md — explicador humano
• chronicle.md — log de eventos somente anexável
• citizens/<agent-id>/ — capability_card.yml, status.md, inbox.md, journal.md
• contracts/open/<id>.md · contracts/settled/<id>.md · contracts/routing_stats.yml (política aprendida, atualizada ao liquidar)
• lessons/<capability-tag>/<id>.md · reviews/<YYYY-MM-DD-HHMM>-<contract>.md · amendments/proposed|ratified/
• A raiz do projeto também recebe ponteiros de ponte CLAUDE.md / AGENTS.md / GEMINI.md e .agents/skills/polis-protocol/SKILL.md (cópia Codex/Antigravity), todos apontando para CONSTITUTION.md.

Cidadãos se conectam a arquivos de projeto com wikilinks ([[path/to/note]]). A pasta _polis/ é a única coisa que o protocolo possui.

A primeira coisa a fazer em cada sessão

Antes de tocar em qualquer arquivo de projeto, execute a rotina de entrada, em ordem:

1. Polis existe? Procure por _polis/CONSTITUTION.md. Se ausente, crie-a (veja "Fundando uma polis").
2. Você está registrado? Procure por _polis/citizens/<self>/capability_card.yml. Se ausente, registre-se (veja "Registrando um cidadão").
3. Leia _polis/CONSTITUTION.md uma vez por sessão — é o protocolo canônico para esta polis; este SKILL.md é a semente de onde ele cresceu.
4. Leia _polis/index.md — como as coisas estão (uma leitura de dois minutos).
5. Leia sua caixa de entrada — _polis/citizens/<self>/inbox.md.
6. Escaneie o final de chronicle.md para trás até chegar ao last_seen_event: em seu status.md. Esse é o seu acompanhamento.
7. Leia seus contratos abertos — qualquer coisa em _polis/contracts/open/ com owner: <self>.
8. Atualize last_seen_event e last_active em seu status.md.
9. Relate ao usuário — estado do projeto, o que está em andamento, o que precisa da entrada dele, um primeiro passo concreto.

Se chronicle.md cresceu muito, a política de rolagem (references/troubleshooting.md) a mantém limitada.

A crônica: registrando o que você fez

Após cada ação significativa, anexe exatamente uma linha a _polis/chronicle.md. O formato é rígido porque o roteador e outros cidadãos o analisam:

- YYYY-MM-DD HH:MM | <agent-id> | <verb-phrase> | [[<wikilink>]] | <one-line note or - >
- 2026-05-14 09:15 | codex-frontend-pesaj | settled contract | [[contracts/settled/auth-refactor]] | tests passing, lesson filed

…