Blueprint — Générateur de Plans de Construction

Que fait Blueprint — Générateur de Plans de Construction ?

Transformez un objectif en une ligne en un plan de construction étape par étape que n'importe quel agent de codage peut exécuter à froid.

Quand l'utiliser

• Décomposer une grande fonctionnalité en plusieurs PRs avec un ordre de dépendance clair
• Planifier une refonte ou une migration qui s'étend sur plusieurs sessions
• Coordonner des flux de travail parallèles entre sous-agents
• Toute tâche où une perte de contexte entre les sessions entraînerait des reprises

Ne pas utiliser pour des tâches réalisables en une seule PR, moins de 3 appels d'outils, ou lorsque l'utilisateur dit « fais-le directement ».

Comment ça fonctionne

Blueprint exécute un pipeline en 5 phases :

1. Recherche — Vérifications préalables (git, gh auth, remote, branche par défaut), puis lecture de la structure du projet, des plans existants et des fichiers mémoire pour rassembler le contexte.
2. Conception — Décompose l'objectif en étapes de taille PR unique (3 à 12 typiquement). Assigne les arêtes de dépendance, l'ordonnancement parallèle/série, le niveau de modèle (le plus fort par défaut), et la stratégie de rollback par étape.
3. Rédaction — Écrit un fichier de plan Markdown autonome dans plans/. Chaque étape comprend un brief de contexte, une liste de tâches, des commandes de vérification et des critères de sortie — afin qu'un agent frais puisse exécuter n'importe quelle étape sans lire les précédentes.
4. Révision — Délègue une revue contradictoire à un sous-agent de modèle le plus fort (par exemple Opus) contre une checklist et un catalogue d'anti-patrons. Corrige toutes les constatations critiques avant de finaliser.
5. Enregistrement — Sauvegarde le plan, met à jour l'index mémoire et présente à l'utilisateur le nombre d'étapes et le 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 avec branches/PR/CI. Sans eux, il passe en mode direct (édition sur place, sans branches).

Exemples

Utilisation de base

/blueprint myapp "migrer la base de données vers PostgreSQL"

Produit plans/myapp-migrer-la-base-de-donnees-vers-postgresql.md avec des étapes comme :

• É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 dépôt pour utiliser le nouveau pilote
• Étape 4 : Ajouter des tests d'intégration contre PostgreSQL
• Étape 5 : Supprimer l'ancien code et la configuration de la base de données

Projet multi-agent

/blueprint chatbot "extraire les fournisseurs LLM dans un système de plugins"

Produit un plan avec des étapes parallèles lorsque c'est possible (par exemple « implémenter le plugin Anthropic » et « implémenter le plugin OpenAI » s'exécutent en parallèle après l'étape d'interface du plugin), des affectations de niveau de modèle (le plus fort pour l'étape de conception de l'interface, défaut pour l'implémentation), et des invariants vérifiés après chaque étape (par exemple « tous les tests existants passent », « aucune importation de fournisseur dans le coeur »).

Fonctionnalités clés

• Exécution à froid — Chaque étape comprend un brief de contexte autonome. Aucun contexte préalable nécessaire.
• Porte de révision contradictoire — Chaque plan est examiné par un sous-agent de modèle le plus fort contre une checklist couvrant l'exhaustivité, la correction des dépendances et la détection d'anti-patrons.
• Workflow branche/PR/CI — Intégré dans chaque étape. Dégradation gracieuse en mode direct lorsque git/gh est absent.
• Détection de parallélisme — Le graphe de dépendances identifie les étapes sans fichiers partagés ni dépendances de sortie.
• Protocole de mutation du plan — Les étapes peuvent être divisées, insérées, ignorées, réordonnées ou abandonnées avec des protocoles formels et une piste d'audit.
• Aucun risque d'exécution — Compétence Markdown pur. L'ensemble du dépôt ne contient que des fichiers .md — pas de hooks, pas de scripts shell, pas de code exécutable, pas de package.json, pas d'étape de construction. Rien ne s'exécute à l'installation ou à l'invocation au-delà du chargeur natif de compétences Markdown de Claude Code.

Installation

Cette compétence est livrée avec Everything Claude Code. Aucune installation séparée n'est nécessaire lorsque ECC est installé.

Installation complète d'ECC

Si vous travaillez à partir de la copie du dépôt ECC, vérifiez que la compétence est présente avec :

test -f skills/blueprint/SKILL.md

Pour mettre à jour ultérieurement, examinez le diff ECC avant de mettre à jour :

cd /chemin/vers/everything-claude-code
git fetch origin main
git log --oneline HEAD..origin/main       # examinez les nouveaux commits avant de mettre à jour
git checkout <sha-complète-examinée>      # épinglez à un commit spécifique examiné

Installation autonome vendue

Si vous vendez uniquement cette compétence en dehors de l'installation complète d'ECC, copiez le fichier examiné depuis le dépôt ECC dans ~/.claude/skills/blueprint/SKILL.md. Les copies vendues n'ont pas de dépôt distant, alors mettez-les à jour en recopiant le fichier depuis un commit ECC examiné plutôt qu'en exécutant git pull.

Prérequis

• Claude Code (pour la commande slash /blueprint)
• Git + GitHub CLI (optionnel — active le workflow complet branche/PR/CI ; Blueprint détecte l'absence et passe automatiquement en mode direct)

Source

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