Blueprint — Générateur de plans de construction

Transformez un objectif d'une ligne en un plan de construction étape par étape que n'importe quel développeur peut exécuter sans préparation.

Quand l’utiliser

• Pour décomposer une fonctionnalité volumineuse en plusieurs pull requests avec un ordre de dépendance clair
• Planifier une refactorisation ou une migration s’étalant sur plusieurs sessions
• Coordonner des flux de travail parallèles entre sous-agents
• Toute tâche pour laquelle une perte de contexte entre les sessions entraînerait un surcroît de travail

À ne pas utiliser pour les tâches pouvant être réalisées dans une seule pull request, nécessitant moins de 3 appels d'outils, ou lorsque l'utilisateur dit « fais-le, c'est tout ».

Fonctionnement

Blueprint Exécute un pipeline en 5 phases :

1. Recherche — Vérifications préalables (git, authentification GitHub, distant, branche par défaut), puis lecture de la structure du projet, des plans existants et des fichiers en mémoire pour recueillir le contexte.
2. Conception — Décompose l’objectif en étapes de la taille d’une pull request (généralement entre 3 et 12). Attribue les liaisons de dépendance, l’ordre parallèle/série, le niveau de modélisation (le plus strict ou par défaut) et la stratégie de restauration pour chaque étape.
3. Ébauche — Rédige un fichier de plan Markdown autonome dans plans/. Chaque étape comprend un résumé du contexte, une liste de tâches, des commandes de vérification et des critères de sortie — ce qui permet à un nouvel agent d’exécuter n’importe quelle étape sans avoir à lire les étapes précédentes.
4. Révision — Délègue la révision critique à un sous-agent utilisant le modèle le plus performant (par exemple, Opus) à l’aide d’une liste de contrôle et d’un catalogue d’anti-modèles. Corrige tous les problèmes critiques avant la finalisation.
5. Enregistrement — Enregistre le plan, met à jour l’index en mémoire et présente à l’utilisateur le nombre d’étapes et un résumé du parallélisme.

Blueprint Détecte automatiquement la disponibilité de git/gh. Avec git + GitHub CLI, il génère des plans complets de workflow pour les branches, les PR et la CI. En leur absence, il passe en mode direct (édition sur place, sans branches).

Exemples

Utilisation de base

/blueprint myapp "migrate database to PostgreSQL"

Génère plans/myapp-migrate-database-to-postgresql.md avec des étapes telles que :

• Étape 1 : Ajouter le pilote PostgreSQL et la configuration de connexion
• Étape 2 : Créer des scripts de migration pour chaque table
• Étape 3 : Mettre à jour la couche de référentiel pour utiliser le nouveau pilote
• Étape 4 : Ajouter des tests d'intégration pour PostgreSQL
• Étape 5 : Supprimer l'ancien code et la configuration de la base de données

Projet multi-agents

/blueprint chatbot "extract LLM providers into a plugin system"

Génère un plan comportant des étapes parallèles lorsque cela est possible (par exemple, les étapes « implémenter le plugin Anthropic » et « implémenter le plugin OpenAI » s’exécutent en parallèle une fois l’étape d’interface des plugins terminée), des affectations au niveau du modèle (prioritaires pour l'étape de conception de l'interface, par défaut pour la mise en œuvre), et des invariants vérifiés après chaque étape (par exemple, « tous les tests existants réussissent », « aucune importation de fournisseur dans le cœur »).

Fonctionnalités clés

• Exécution à froid — Chaque étape comprend un résumé contextuel autonome. Aucun contexte préalable n’est nécessaire.
• Contrôle de révision antagoniste — Chaque plan est examiné par un sous-agent utilisant le modèle le plus performant, à l’aide d’une liste de contrôle portant sur l’exhaustivité, l’exactitude des dépendances et la détection des anti-modèles.
• Workflow de branche/PR/CI — Intégré à chaque étape. Passe en douceur en mode direct en l’absence de git/gh.
• Détection des étapes parallèles — Le graphe de dépendances identifie les étapes ne comportant ni fichiers partagés ni dépendances de sortie.
• Protocole de modification des plans — Les étapes peuvent être divisées, insérées, ignorées, réorganisées ou abandonnées selon des protocoles formels et avec une piste d’audit.
• Risque d’exécution nul — Compétence Markdown pure. L’ensemble du dépôt ne contient que .md des fichiers — pas de hooks, pas de scripts shell, pas de code exécutable, pas de package.json, aucune étape de compilation. Rien ne s’exécute lors de l’installation ou de l’invocation, hormis le chargeur natif de compétences Markdown de Claude Code.

Installation

Cette compétence est fournie avec Everything Claude Code. Aucune installation distincte n’est nécessaire lorsque ECC est installé.

Installation complète d’ECC

Si vous travaillez à partir du dépôt ECC, vérifiez que la compétence est bien présente à l’aide de la commande suivante :

test -f skills/blueprint/SKILL.md

Pour effectuer une mise à jour ultérieure, consultez le diff ECC avant de procéder :

cd /path/to/everything-claude-code
git fetch origin main
git log --oneline HEAD..origin/main       # review new commits before updating
git checkout           # pin to a specific reviewed commit

Installation autonome via le « vendoring »

Si vous installez uniquement cette compétence en dehors de l’installation complète d’ECC, copiez le fichier validé depuis le dépôt ECC vers ~/.claude/skills/blueprint/SKILL.md. Les copies « vendored » ne disposent pas de git remote ; mettez-les donc à jour en recopiant le fichier à partir d’un commit ECC validé plutôt qu’en exécutant git pull.

Prérequis

• Claude Code (pour la /blueprint commande « / »)
• Git + GitHub CLI (facultatif — permet un workflow complet de branches/PR/CI ; Blueprint détecte l’absence de l’outil et bascule automatiquement en mode direct)

Source

Inspiré de antbotlab/blueprint — projet en amont et conception de référence.