Sobre o projeto

Model Citizen é um plano de controle para agentes de codificação, projetado para se posicionar sob qualquer camada de bibliotecas de regras ou orquestração que você use. Ele permite definir regras, habilidades, papéis e posturas uma vez, projetando-os no Claude Code e no Codex, aplicando-os com hooks e mantendo um registro do que cada sessão fez e gastou. Principais recursos incluem: - **Guardrails com julgamento**: Hooks lidam com verificações determinísticas, como classificar comandos de shell (somente leitura a irreversíveis), interromper turnos quando o portão do seu repositório está vermelho, revisar contexto fresco, capturar segredos, neutralizar saída não confiável de ferramentas e fazer sandboxing. - **Configurações reversíveis**: Sincronização tem uma execução seca, diff mostra desvio, um diário de propriedade registra mudanças, e desinstalação restaura o que adotou. Primitivas compartilhadas vivem em um lugar e sincronizam nas configurações nativas de cada runtime. - **Visibilidade de custo e uso**: Posturas de custo (econômica, equilibrada, máxima) definem modelo, esforço e orçamentos suaves por papel. Tiering de modelo atribui papéis a classes de capacidade (fronteira, forte, padrão, leve) em vez de modelos específicos. Um feed de uso relata custos de turno e subagente, e um log de decisão registra decisões de hook. - **Saída legível**: Posturas de voz (concisa, cartão-resposta, escaneável) moldam a saída. O Cartão de Revisão planeja abertura com um cartão de uma tela e para em um portão de build. Retornos de subagentes são limitados com descobertas e limites de palavras. - **Regras mensuráveis**: Cada regra nomeia um detector determinístico sobre o transcripto ou explica por que não pode ser decidido. Lint falha em commits caso contrário. Relatórios de uso mostram com que frequência cada regra disparou. - **Interruptores de preferência**: Nove dimensões de postura (autonomia, delegação, teste, custo, voz, commits, planejamento, licenciamento, construir vs. comprar) cada uma com variantes nomeadas. Defina padrões, sobrescreva por repositório ou sessão, e escreva suas próprias dimensões de postura como pastas Markdown. Ele suporta Claude Code CLI (macOS, Linux) como qualificado, com Codex CLI e outros clientes não qualificados ou planejados. O harness não é um gateway de API LLM ou provedor de modelo; Claude Code e Codex permanecem responsáveis pelo acesso ao modelo e permissões nativas. A instalação é via um script de uma linha ou clone manual. Comandos de sincronização, diagnóstico e desinstalação gerenciam configuração e propriedade. O projeto é licenciado sob MIT e aceita contribuições.