Spec-first Agentic Development

Le principe fondamental consiste à commencer chaque tâche de développement par une spécification écrite stockée dans le dépôt. Cette spécification décrit l'objectif, les faits pertinents (y compris les références de fichiers et de lignes), les étapes à suivre et des critères de « fait » précis. Avant que tout code ne soit écrit, un nouvel examinateur examine la spécification par rapport à la base de code existante pour vérifier son exactitude et sa faisabilité. Une fois approuvée, un agent IA procède à la construction de la fonctionnalité sur sa propre branche isolée et son espace de travail. Le commit final n'est autorisé à entrer dans le dépôt principal qu'après que toutes les vérifications et tests prédéfinis aient été réussis, garantissant la qualité du code et le respect de la spécification.

Ce système diffère considérablement de la « vibe coding » traditionnelle en remplaçant les invites ad hoc par une spécification examinée et persistante. Il enregistre chaque décision prise par l'agent avec son raisonnement, fournissant une traçabilité claire et réduisant le besoin de documentation post-développement. Les spécifications sont conçues pour cerner l'intention et l'architecture plutôt que d'être des générateurs de code trop précis, les tests et les portes de commit fournissant la précision nécessaire. Les anciennes spécifications sont traitées comme des enregistrements de changement immuables, similaires aux commits, et ne sont pas mises à jour, empêchant ainsi le vieillissement.

Spec-first Agentic Development prend en charge le développement parallèle, permettant à plusieurs agents de travailler sur différentes spécifications simultanément en utilisant des identifiants de branche et d'espace de travail uniques. Le processus est ininterrompu, car les spécifications examinées répondent aux questions ouvertes, permettant aux agents de construire directement selon les critères de « fait ». L'ensemble du flux de travail est structuré, avec une spécification correspondant à une branche et un commit, simplifiant les demandes de tirage et garantissant la cohérence. L'état est maintenu dans `context.yaml`, rendant le travail reprenable même après des redémarrages.

La méthode, les modèles et le plugin Claude Code sont tous sous licence MIT, ce qui en fait une solution sans coût. Bien que le plugin Claude Code automatise la comptabilité et les fonctions de porte, la méthodologie peut également être adoptée avec d'autres agents comme Codex, Cursor ou Copilot en suivant `AGENTS.md` et en installant un hook git commit-msg pour la porte. Cette approche a été développée et affinée grâce à la création d'Agent Smith, une usine logicielle agentique open-source, démontrant son application pratique et son efficacité.