Sobre o projeto

A Constituição de Engenharia de Eric é um framework reutilizável que serve como fonte única de verdade para como humanos e agentes de IA colaboram em projetos de software. Ele é projetado para ser puxado para qualquer repositório Git como um submódulo somente leitura `constitution/`, em camadas com um pequeno conjunto de arquivos de projeto locais, e aplicado tanto por agentes de codificação de IA quanto por pipelines de CI. O repositório contém documentos de governança autoritativos (CONSTITUTION.md, AI_WORKFLOW.md, INTEGRATION.md, TESTING.md, DOCUMENTATION.md, SECURITY.md, OPERATIONS.md, ARCHITECTURE.md, RELEASES.md, TODO_GUIDELINES.md, KNOWLEDGE_SOURCES.md), 25 habilidades de agente integradas que aplicam automaticamente as regras da constituição, e um conjunto abrangente de scripts de verificação de referência que validam a conformidade no CI. Esses verificadores cobrem consistência de modelos de instrução entre arquivos de fornecedores (AGENTS.md, CLAUDE.md, .cursorrules, etc.), validade de metadados de habilidades, rastreabilidade de requisitos para testes, verificações cruzadas de inventário de software OTS, regras de dependência de arquitetura (garantindo que dependências de código-fonte apontem para dentro conforme a Regra de Dependência), alinhamento de versão e tags de release, frescor de documentação e wiki, integridade de links de wiki, varredura de segredos e medição de peso de instruções. O script de bootstrap (`scripts/bootstrap.sh`) inicializa um repositório existente adicionando o submódulo, criando arquivos de governança ausentes e gerando um relatório de adoção. Ele suporta arquivos de instrução de agente opt-in via flags `--agents` (claude, cursor, copilot, goose, openhands, antigravity, continue, aider, generic, all), com AGENTS.md como padrão. O script nunca sobrescreve arquivos existentes por padrão, colocando cópias de modelo em `.constitution-bootstrap/templates/` para mesclagem manual. Ele também adiciona um selo de adoção padronizado ao README, gerenciado entre marcadores para evitar duplicação. O framework inclui modelos para listas de verificação de conclusão de pull request, CODEOWNERS, portões de fluxo de trabalho de CI (fixados por SHA), um agente personalizado Solon para GitHub Copilot no Visual Studio e modelos de documentação para requisitos de produto, backlogs de marcos, planos de sessão, inventários de software OTS, páginas iniciais de wiki e postmortems de incidentes. Ele também fornece um servidor MCP expondo documentos e fontes da constituição como recursos, e um fluxo de trabalho de fontes de conhecimento para destilar livros e artigos em resumos consumíveis por agentes sob `sources/`. A integração com IDE é automática: abrir um repositório inicializado no Visual Studio, VS Code ou IDEs JetBrains permite que assistentes de IA (GitHub Copilot, Continue.dev, Cursor) leiam os arquivos de instrução comprometidos, que apontam para o submódulo da constituição. Um hook de SessionStart no Claude Code sinaliza submódulos desatualizados imediatamente. O próprio CI do framework executa a suíte de testes completa mais verificadores de autogovernança em cada pull request e push para main, e um fluxo de trabalho de alinhamento de tags de release protege tags de versão. O projeto inclui documentação extensa sobre integração, versionamento (atualmente 1.48.0) e um layout de exemplo de projeto trabalhado. Ele é posicionado como uma camada de governança em vez de uma biblioteca de código, enfatizando práticas de desenvolvimento assistido por IA disciplinadas e mensuráveis.