blueprint

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ù la perte de contexte entre sessions entraînerait des reprises

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

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 lit la structure du projet, les plans existants et les fichiers mémoire pour rassembler le contexte.
2. Conception — Décompose l'objectif en étapes de taille PR (3 à 12 en général). Attribue les arêtes de dépendance, l'ordonnancement parallèle/sériel, le niveau de modèle (le plus fort vs 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 résumé de contexte, une liste de tâches, des commandes de vérification et des critères de sortie — de sorte qu'un nouvel agent puisse exécuter n'importe quelle étape sans lire les étapes précédentes.
4. Révision — Délègue une revue contradictoire à un sous-agent avec le modèle le plus fort (par exemple, Opus) selon 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 le nombre d'étapes ainsi qu'un résumé du parallélisme à l'utilisateur.

Blueprint détecte automatiquement la disponibilité de git/gh. Avec git et GitHub CLI, il génère des plans de workflow complets (branche/PR/CI). Sans eux, il passe en mode direct (modification sur place, sans branches).

Exemples

Utilisation de base

/blueprint myapp "migrate database to PostgreSQL"

Produit plans/myapp-migrate-database-to-postgresql.md avec des étapes comme :

• Étape 1 : Ajouter le pilote PostgreSQL et la configuration de connexion
• Étape 2 : Créer les 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 base de données

Projet multi-agent

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

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 attributions de niveau de modèle (le plus fort pour l'étape de conception de l'interface, par défaut pour l'implémentation), et des invariants vérifiés après chaque étape (par exemple, « tous les tests existants réussissent », « aucun import de fournisseur dans le noyau »).

Fonctionnalités clés

• Exécution à froid — Chaque étape comprend un résumé de contexte autonome. Aucun contexte préalable nécessaire.
• Porte de revue contradictoire — Chaque plan est révisé par un sous-agent avec le modèle le plus fort selon une checklist couvrant l'exhaustivité, la justesse des dépendances et la détection d'anti-patrons.
• Workflow Branche/PR/CI — Intégré dans chaque étape. Dégradé gracieusement en mode direct en l'absence de git/gh.
• 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 de plan — Les étapes peuvent être fractionnées, insérées, sautées, réordonnées ou abandonnées avec des protocoles formels et une piste d'audit.
• Zéro risque d'exécution — Compétence purement Markdown. 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 lors de l'installation ou de 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 plus tard, examinez le diff ECC avant de mettre à jour :

cd /path/to/everything-claude-code
git fetch origin main
git log --oneline HEAD..origin/main       # examinez les nouveaux commits avant de mettre à jour
git checkout <reviewed-full-sha>          # épinglez-vous à un commit spécifique examiné

Installation autonome vendue

Si vous ne vendez que cette compétence en dehors de l'installation complète d'ECC, copiez le fichier examiné depuis le dépôt ECC vers ~/.claude/skills/blueprint/SKILL.md. Les copies vendues n'ont pas de dépôt git distant, donc 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 /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é par antbotlab/blueprint — projet amont et conception de référence.