À propos du projet

La Constitution d'ingénierie d'Eric est un cadre réutilisable qui sert de source unique de vérité pour la collaboration entre humains et agents IA sur des projets logiciels. Il est conçu pour être intégré dans n'importe quel dépôt Git en tant que sous-module `constitution/` en lecture seule, complété par un petit ensemble de fichiers de projet locaux, et appliqué à la fois par les agents de codage IA et les pipelines CI. Le dépôt contient des documents de gouvernance faisant autorité (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 compétences d'agent intégrées qui appliquent automatiquement les règles de la constitution, et un ensemble complet de scripts de vérification de référence qui valident la conformité dans la CI. Ces vérificateurs couvrent la cohérence des modèles d'instructions entre les fichiers des fournisseurs (AGENTS.md, CLAUDE.md, .cursorrules, etc.), la validité des métadonnées des compétences, la traçabilité des exigences aux tests, les vérifications croisées de l'inventaire logiciel OTS, les règles de dépendance d'architecture (garantissant que les dépendances du code source pointent vers l'intérieur conformément à la règle de dépendance), l'alignement des versions et des balises de publication, la fraîcheur de la documentation et du wiki, l'intégrité des liens du wiki, l'analyse des secrets et la mesure du poids des instructions. Le script d'amorçage (`scripts/bootstrap.sh`) initialise un dépôt existant en ajoutant le sous-module, en créant les fichiers de gouvernance manquants et en générant un rapport d'adoption. Il prend en charge les fichiers d'instructions d'agent opt-in via les drapeaux `--agents` (claude, cursor, copilot, goose, openhands, antigravity, continue, aider, generic, all), avec AGENTS.md par défaut. Le script ne remplace jamais les fichiers existants par défaut, plaçant des copies de modèles dans `.constitution-bootstrap/templates/` pour une fusion manuelle. Il ajoute également un badge d'adoption standardisé au README, géré entre des marqueurs pour éviter la duplication. Le cadre comprend des modèles pour les listes de contrôle d'achèvement des demandes de tirage, CODEOWNERS, les portes de flux de travail CI (épinglées SHA), un agent personnalisé Solon pour GitHub Copilot dans Visual Studio, et des modèles de documentation pour les exigences de produit, les arriérés de jalons, les plans de session, les inventaires logiciels OTS, les pages d'accueil du wiki et les post-mortems d'incidents. Il fournit également un serveur MCP exposant les documents et sources de la constitution en tant que ressources, et un flux de travail de sources de connaissances pour distiller des livres et des articles en résumés consommables par les agents sous `sources/`. L'intégration IDE est automatique : l'ouverture d'un dépôt amorcé dans Visual Studio, VS Code ou les IDE JetBrains permet aux assistants IA (GitHub Copilot, Continue.dev, Cursor) de lire les fichiers d'instructions validés, qui pointent vers le sous-module de constitution. Un hook SessionStart dans Claude Code signale immédiatement les sous-modules obsolètes. La CI du cadre lui-même exécute la suite de tests complète plus les vérificateurs d'auto-gouvernance sur chaque demande de tirage et poussée vers main, et un flux de travail d'alignement des balises de publication protège les balises de version. Le projet comprend une documentation complète sur l'intégration, le versionnage (actuellement 1.48.0) et un exemple de disposition de projet travaillé. Il est positionné comme une couche de gouvernance plutôt qu'une bibliothèque de code, mettant l'accent sur des pratiques de développement assistées par IA disciplinées et mesurables.