Blueprint

Qu'est-ce que Blueprint ?

Blueprint est un copilote de planification pour agents de code. Il aide un agent à poser les bonnes questions avant d'écrire du code, puis produit un plan Markdown que l'agent peut exécuter en une passe.

L'outil est conçu pour être indépendant des agents et utilise une planification pilotée par Q&R : il explore une base de code et pose des questions à choix multiples faciles à répondre. La sortie vise à faire émerger des problèmes et décisions que vous n'auriez peut-être pas considérés, structurés comme une spécification/plan réutilisable.

Fonctionnalités clés

• Planification Q&R avant code : Blueprint ralentit l'exécution juste assez pour clarifier les exigences, puis génère un plan structuré.
• Exploration de la base de code : Il lit votre espace de travail/base de code et utilise ce contexte pour orienter les questions posées.
• Questions à choix multiples : Les questions sont formatées pour des réponses rapides, tout en couvrant les ambiguïtés importantes.
• Sortie plan Markdown : Le résultat est un fichier Markdown destiné à un transfert direct aux agents de code.
• Compétences indépendantes des agents (compatibles avec skills.sh) : Blueprint est packagé comme des compétences compatibles avec plusieurs harnais d'agents de code.
• Modèles intégrés avec sections questions ouvertes : Inclut des modèles de planification par défaut définissant des sections comme aperçu, comportement attendu, phases d'implémentation, stratégie de test et questions ouvertes.

Comment utiliser Blueprint

1. Installez la compétence avec la commande npx indiquée dans le dépôt : npx skills add imbue-ai/blueprint.
2. Démarrez une session de planification en invoquant la compétence dans votre agent de code avec une brève description de tâche (ex. : /blueprint Ajouter une couche de cache pour réduire les appels API).
3. Choisissez un modèle quand on vous le demande. Blueprint explore votre base de code et commence à poser des questions.
4. Répondez aux questions jusqu'à ce que Blueprint juge que le terrain est suffisamment couvert.
5. Générez le plan avec /blueprint-generate. Le plan est écrit dans un chemin formaté comme blueprint/<slug>/plan-<slug>.md.
6. Affinez en chat si nécessaire et demandez les questions ouvertes (ex. : « quelles sont les questions ouvertes ? ») avant de passer le plan à votre agent de code.

Cas d'usage

• Projets greenfield / nouvelles fonctionnalités : Planifiez une grande nouvelle fonctionnalité en veillant à ce que les exigences, le comportement attendu et la stratégie de test soient explicitement couverts avant l'implémentation.
• Changement incrémental nécessitant coordination : Quand un changement est assez important pour requérir une spécification soignée (pas juste une édition rapide), Blueprint aide à structurer décisions et phases.
• Recherche et expériences : Pour de nouveaux modèles, systèmes ou sous-systèmes, le flux Q&R de Blueprint capture les hypothèses et inconnues sous forme de plan avec questions ouvertes.
• Travail sur une base de code inconnue : Blueprint explore l'espace de travail et pose des questions clarificatrices basées sur ses découvertes, réduisant le risque de manquer des contraintes clés.
• Réduction des erreurs d'exécution dans les workflows d'agents : Si un agent a tendance à « se précipiter sur le code », Blueprint fournit un fichier de plan explicite que l'agent peut exécuter après la phase de planification.

FAQ

• Quels harnais d'agents de code sont supportés ? Le dépôt indique une compatibilité avec des harnais comme Claude Code, Codex CLI, Gemini CLI, Pi agent, et d'autres harnais compatibles.

• Où est sauvegardé le plan généré ? Le plan est écrit dans blueprint/<slug>/plan-<slug>.md après exécution de /blueprint-generate.

• Quels modèles Blueprint inclut-il ? Il est livré avec deux modèles intégrés par défaut : Default (sections incluant aperçu, comportement attendu, plan/phases d'implémentation, stratégie de test et questions ouvertes) et Concise (sections incluant aperçu, comportement attendu et changements).

• Puis-je personnaliser la structure du plan ? Oui. Le dépôt indique que vous pouvez décrire un modèle personnalisé en ligne quand on vous le demande, et ajouter/éditer persistentement des modèles via templates.json pour que les deux compétences Blueprint restent synchronisées.

• Blueprint est-il limité au front-end ? Les conseils du README suggèrent qu'il est moins idéal pour les frontends où la plupart des décisions sont visuelles, et plus adapté aux projets greenfield, grandes nouvelles fonctionnalités, et planification de recherche ou sous-systèmes.

Alternatives

• Générateurs de spécifications ou de documents (style révision manuelle) : Les outils qui produisent de longues spécifications après que l’agent a fait ses propres choix diffèrent de Blueprint en inversant le flux de travail — Blueprint cherche d’abord votre input via Q&R.
• Flux de travail en « mode plan » des outils d’agents de code : Certaines plateformes d’agents incluent leurs propres modes de planification ; Blueprint est positionné spécifiquement comme un copilote de planification qui génère un plan Markdown exécutable par l’agent et pose des questions courtes axées sur les exigences.
• Assistants génériques de revue de codebase : Les alternatives peuvent résumer ou analyser des dépôts, mais la sortie distinctive de Blueprint est un plan Markdown structuré avec des sections définies et des questions ouvertes destinées à l’exécution.
• Flux de travail de barre latérale VS Code utilisant une extension de planification : Si vous préférez des outils intégrés à l’éditeur, Blueprint est aussi disponible en tant qu’extension VS Code qui fonctionne dans VS Code, Cursor et Windsurf, ce qui peut différer des configurations d’agents purement pilotées par chat.