Specs et Prompts IA
Capturez des spécifications durables et des modèles de prompts IA réutilisables pour que votre agent ait toujours le bon contexte.
Deux fonctionnalités du Developer Mode donnent à un agent IA le contexte nécessaire pour bien travailler : les Specs et les Prompts IA. Les deux sont disponibles dès que le Developer Mode est activé sur un projet.
Specs
Une spec est une spécification durable — un contrat d'API, un modèle de données, une décision de conception, un ensemble de critères d'acceptation. Les specs sont détenues au niveau projet et peuvent être liées à plusieurs milestones, si bien qu'une source de vérité unique est réutilisée partout où elle est pertinente.
Les specs disposent d'un historique de versions : chaque modification est enregistrée, ce qui vous permet de voir l'évolution d'une spécification et de comparer les versions.
Il en existe deux types :
- Specs globales — références à l'échelle du projet, reliables à un nombre quelconque de milestones.
- Critères d'acceptation — une spec rattachée directement à un seul milestone, qui décrit ce que « terminé » signifie pour lui.
Quand un agent récupère une tâche, il peut aussi tirer les specs du milestone : il implémente alors selon le contrat convenu au lieu de deviner.
Prompts IA
Les Prompts IA sont des modèles de prompts réutilisables stockés dans le projet. Ils standardisent la façon dont vous demandez à un agent d'effectuer un travail récurrent — planifier une tâche, rédiger une spec, relire une modification — pour des résultats cohérents pour tout le monde.
Briefboard fournit un ensemble de prompts par défaut, et vous pouvez :
- Personnaliser un défaut en le surchargeant avec votre propre version.
- Créer des prompts personnalisés propres à votre projet.
- Restaurer un défaut que vous avez masqué ou modifié.
Les prompts se marient naturellement avec les specs : un prompt de planification peut référencer les specs du milestone, transformant des critères convenus en un brief d'implémentation actionnable.
Tout assembler
Une boucle saine ressemble à ceci :
- Rédigez une spec décrivant ce que vous voulez et liez-la au milestone.
- Utilisez un Prompt IA pour que l'agent planifie la tâche à partir de cette spec.
- Laissez l'agent implémenter via MCP, en vérifiant face aux critères d'acceptation.
Les specs gardent l'intention explicite, les prompts gardent le processus reproductible, et le MCP garde l'agent connecté aux données en direct.