Sobre el proyecto
La Constitución de Ingeniería de Eric es un marco reutilizable que sirve como fuente única de verdad sobre cómo humanos y agentes de IA colaboran en proyectos de software. Está diseñado para integrarse en cualquier repositorio Git como un submódulo de solo lectura `constitution/`, complementado con un pequeño conjunto de archivos de proyecto locales, y aplicado tanto por agentes de codificación de IA como por pipelines de CI.
El repositorio contiene documentos de gobernanza 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 aplican automáticamente las reglas de la constitución, y un conjunto completo de scripts de verificación de referencia que validan el cumplimiento en CI. Estos verificadores cubren la consistencia de plantillas de instrucciones en archivos de proveedores (AGENTS.md, CLAUDE.md, .cursorrules, etc.), validez de metadatos de habilidades, trazabilidad de requisitos a pruebas, verificaciones cruzadas de inventario de software OTS, reglas de dependencia de arquitectura (asegurando que las dependencias del código fuente apunten hacia adentro según la Regla de Dependencia), alineación de versiones y etiquetas de lanzamiento, frescura de documentación y wiki, integridad de enlaces de wiki, escaneo de secretos y medición de peso de instrucciones.
El script de arranque (`scripts/bootstrap.sh`) inicializa un repositorio existente agregando el submódulo, creando archivos de gobernanza faltantes y generando un informe de adopción. Admite archivos de instrucciones de agente opcionales mediante banderas `--agents` (claude, cursor, copilot, goose, openhands, antigravity, continue, aider, generic, all), con AGENTS.md como predeterminado. El script nunca sobrescribe archivos existentes por defecto, colocando copias de plantillas en `.constitution-bootstrap/templates/` para fusión manual. También agrega una insignia de adopción estandarizada al README, gestionada entre marcadores para evitar duplicación.
El marco incluye plantillas para listas de verificación de finalización de pull requests, CODEOWNERS, compuertas de flujo de trabajo de CI (fijadas por SHA), un agente personalizado Solon para GitHub Copilot en Visual Studio y plantillas de documentación para requisitos de producto, backlogs de hitos, planes de sesión, inventarios de software OTS, páginas de inicio de wiki y autopsias de incidentes. También proporciona un servidor MCP que expone documentos y fuentes de la constitución como recursos, y un flujo de trabajo de fuentes de conocimiento para destilar libros y artículos en resúmenes consumibles por agentes bajo `sources/`.
La integración con IDE es automática: abrir un repositorio arrancado en Visual Studio, VS Code o IDEs de JetBrains permite que los asistentes de IA (GitHub Copilot, Continue.dev, Cursor) lean los archivos de instrucciones confirmados, que apuntan al submódulo de la constitución. Un hook de SessionStart en Claude Code marca submódulos obsoletos inmediatamente. El CI del propio marco ejecuta la suite de pruebas completa más los verificadores de autogobernanza en cada pull request y push a main, y un flujo de trabajo de alineación de etiquetas de lanzamiento protege las etiquetas de versión.
El proyecto incluye documentación extensa sobre integración, versionado (actualmente 1.48.0) y un ejemplo de diseño de proyecto trabajado. Se posiciona como una capa de gobernanza más que como una biblioteca de código, enfatizando prácticas de desarrollo asistido por IA disciplinadas y medibles.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.