# FullSpec : Cadre de développement piloté par l'IA avec Claude Code
Le développement assisté par l'IA vire souvent au chaos sans documents d'architecture unifiés. FullSpec résout cela en formalisant tout le cycle de vie, de l'idée à la mise en production, via une chaîne de spécifications générées et maintenues par des agents IA.
Le problème : L'IA sans mémoire architecturale
Le défi principal avec les LLM comme Claude Code, c'est l'absence de contexte pour les décisions architecturales. L'IA produit du code rapidement, mais oublie pourquoi le système est conçu ainsi. Dans un projet avec 25 microservices, cela génère des conflits majeurs :
- Algorithmes de chiffrement incohérents entre services voisins
- Contrats API incompatibles
- Décisions contradictoires issues de sessions parallèles
Les documents traditionnels sont insuffisants : ils sont soit obsolètes, soit noyés dans la bureaucratie. L'IA a besoin de spécifications fraîches, complètes et sans contradictions — et FullSpec fournit exactement cet environnement.
Architecture FullSpec : 23 agents et 8 phases
Le cadre structure le développement via des documents formels générés et validés par des agents IA. Les utilisateurs lancent /chain avec une description de tâche, comme « implémenter l'authentification OAuth2 », déclenchant une séquence en 8 phases.
Niveaux de spécifications
La chaîne produit quatre niveaux de documents avec des revues obligatoires à chaque étape :
- Discussion — exigences, critères de succès, périmètre et risques
- Conception — changements système : services, contrats API, modèles de données
- Plan de tests — scénarios de tests rédigés avant tout code
- Plan de développement — tâches, dépendances et blocs d'exécution
Une fois les spécifications approuvées, le système génère automatiquement les documents, crée des Issues GitHub, rédige le code et les tests, effectue des revues de code et prépare des PR.
Mécanismes clés du cadre
Flux de travail parallèles d'agents
Au lieu d'un seul Claude traitant les tâches en séquence, FullSpec déploie 23 agents IA spécialisés :
- Générateur de conception
- Planificateur de tests
- Codeurs pour divers langages
- Évaluateurs à chaque niveau
- Agents de synchronisation de docs
Lors des synchronisations, il lance N agents en parallèle — un par service.
Validation automatique et règles
Le système intègre plus de 80 scripts de validation et 30 hooks pre-commit qui vérifient :
- Formats de documents
- Cohérence structurelle
- Absence de secrets dans le code
- Normes de messages de commit
16 règles contextuelles se chargent automatiquement par type de fichier : .ts → standards TypeScript, .py → standards FastAPI. Les règles résident dans .claude/rules/ et s'appliquent sans invites supplémentaires.
Spécifications vivantes et détection de conflits
Ce qui le distingue des concurrents : le système détecte et corrige les incohérences code-spécifications. Après commit, CONFLICT-CHECK s'exécute :
- Arrête en cas de contradictions
- Identifie le niveau de conflit (Conception, Plan Dev, etc.)
- Propagé les mises à jour de spécifications de haut en bas
- Maintient les docs à jour sur toutes les étapes de dev
Comparaison avec les alternatives
| Critère | FullSpec | Spec Kit (GitHub) | Kiro (AWS) | OpenSpec (Fission AI) |
|----------|----------|-------------------|------------|-----------------------|
| Type | Cadre de processus | Kit CLI | IDE (fork VS Code) | Cadre CLI |
| Formalisation des exigences | Discussion avec critères | Constitution + Spec | Exigences (EARS) | Proposition |
| Conception architecturale | Conception avec contrats API | Plan | Conception (markdown) | Conception |
| Planification de tests pré-code | Plan Tests avec numérotation TC-N | Non | Non | Non |
| Détection de conflits | Automatique + mises à jour en cascade | Non | Non | Non |
| Docs vivants | Synchronisation auto depuis specs | Non | Non | Non |
| Automatisation GitHub | Issues, PR, Revues, Releases | Non | Non | Non |
| Agents IA | 23 parallèles | 0 | 1 (intégré) | 0 |
| Validation | 80+ scripts, 30 hooks pre-commit | 0 | 0 | ~5 |
| Support brownfield | Pas encore | Oui | Oui | Oui (focus) |
FullSpec couvre tout le cycle de dev mais est lié à Claude Code et manque d'intégration brownfield pour l'instant.
Spécifications techniques
- 71 compétences — commandes slash pour chaque étape de processus
- 23 agents IA — travailleurs parallèles spécialisés
- 80+ scripts de validation — vérifications à tous les stades
- 30 hooks pre-commit — contrôle qualité automatisé
- 16 règles contextuelles — s'étend avec les nouvelles technos
- 8 phases de processus — de l'idée à la release en prod
- Standardisation récursive — se construit lui-même selon ses règles
Points clés à retenir
- Faible barrière d'entrée — complexe en interne, mais les users tapent juste
/chainet confirment en chat - Claude Code uniquement — conçu pour cette IA ; autres non testées
- Docs en russe — instructions et specs en russe, mais Claude gère sans souci
- Greenfield seulement — template pour nouveaux projets ; brownfield en cours
- Open source — licence MIT sur GitHub
Ce projet donne vie à une approche où l'IA ne se contente pas de générer du code : elle excelle dans un processus formalisé avec des docs vivants. Il réduit les risques architecturaux et booste la prévisibilité pour les équipes utilisant l'IA.
— Editorial Team
Aucun commentaire pour le moment.