Blueprint

Cos'è Blueprint?

Blueprint è un planning copilot per coding agent. Aiuta un agente a porre le domande giuste prima di scrivere codice, poi produce un piano in markdown che l'agente può eseguire in un'unica passata.

Lo strumento è progettato per essere agent-agnostic e usa una pianificazione basata su Q&A: esplora un codebase e pone domande a scelta multipla facili da rispondere. L'output serve a evidenziare problemi e decisioni che potresti non aver considerato, strutturato come una spec/piano riutilizzabile.

Caratteristiche Principali

• Pianificazione Q&A prima del codice: Blueprint rallenta l'esecuzione quel tanto che basta per chiarire i requisiti, poi genera un piano strutturato.
• Esplorazione del codebase: Legge il tuo workspace/codebase e usa quel contesto per guidare le domande che pone.
• Domande a scelta multipla: Le domande sono formattate per risposte rapide, coprendo comunque le ambiguità importanti.
• Output piano in markdown: Il risultato è un file markdown destinato al passaggio diretto a coding agent.
• Competenze agent-agnostic (compatibili con skills.sh): Blueprint è confezionato come skills compatibili con più harness di coding agent.
• Template integrati con sezioni open-questions: Include template di pianificazione predefiniti che definiscono sezioni come overview, comportamento atteso, fasi di implementazione, strategia di testing e open questions.

Come Usare Blueprint

1. Installa la skill usando il comando npx indicato nel repository: npx skills add imbue-ai/blueprint.
2. Avvia una sessione di pianificazione invocando la skill nel tuo coding agent con una breve descrizione del task (es. /blueprint Aggiungi un layer di caching per ridurre le chiamate API).
3. Scegli un template quando richiesto. Blueprint esplora il tuo codebase e inizia a porre domande.
4. Rispondi alle domande finché Blueprint determina che il terreno è stato sufficientemente coperto.
5. Genera il piano usando /blueprint-generate. Il piano viene scritto in un percorso formattato come blueprint/<slug>/plan-<slug>.md.
6. Rifinisci in chat se necessario e chiedi delle open questions (es. “quali sono le open questions?”) prima di passare il piano al tuo coding agent.

Casi d'Uso

• Progetti greenfield / nuove feature: Pianifica una grande nuova feature assicurando che requisiti, comportamento atteso e strategia di testing siano esplicitamente coperti prima dell'implementazione.
• Cambi incrementali che richiedono coordinamento: Quando un cambio è abbastanza grande da richiedere una spec attenta (non solo una rapida modifica), Blueprint aiuta a strutturare decisioni e fasi.
• Ricerca ed esperimenti: Per nuovi modelli, sistemi o sottosistemi, il flusso Q&A di Blueprint cattura assunzioni e incognite come un piano con open questions.
• Lavoro su un codebase sconosciuto: Blueprint esplora il workspace e pone domande chiarificatrici basate su ciò che trova, riducendo il rischio di mancare vincoli chiave.
• Riduzione errori di esecuzione nei workflow agent: Se un agente altrimenti “si precipiterebbe a codificare”, Blueprint fornisce un file piano esplicito che l'agente può eseguire dopo la fase di pianificazione.

FAQ

• Quali harness di coding agent sono supportati? Il repository indica compatibilità con harness come Claude Code, Codex CLI, Gemini CLI, Pi agent e altri harness compatibili.

• Dove viene salvato il piano generato? Il piano viene scritto in blueprint/<slug>/plan-<slug>.md dopo aver eseguito /blueprint-generate.

• Quali template include Blueprint? Include due template integrati predefiniti: Default (sezioni tra cui overview, comportamento atteso, piano/fasi di implementazione, strategia di testing e open questions) e Concise (sezioni tra cui overview, comportamento atteso e cambiamenti).

• Posso personalizzare la struttura del piano? Sì. Il repository indica che puoi descrivere un template personalizzato inline quando richiesto, e puoi anche aggiungere/modificare persistentemente i template via templates.json così le due skill di Blueprint restano sincronizzate.

• Blueprint è limitato al lavoro front-end? La guida del README suggerisce che è meno ideale per frontend dove la maggior parte delle decisioni sono visive, e più adatto a progetti greenfield, grandi nuove feature, e pianificazione di ricerca o sottosistemi.

Alternative

• Generatori di specifiche o documenti (stile revisione manuale): Gli strumenti che producono specifiche lunghe dopo che l'agente ha fatto le proprie scelte differiscono da Blueprint invertendo il flusso di lavoro: Blueprint cerca prima il tuo input tramite Q&A.
• Workflow "plan mode" degli agenti da tool per coding agent: Alcune piattaforme di agenti includono modalità di pianificazione proprie; Blueprint è posizionato specificamente come planning copilot che genera un piano in markdown eseguibile dall'agente e pone domande brevi focalizzate sui requisiti.
• Assistenti generici per review di codebase: Le alternative possono riassumere o analizzare repository, ma l'output distintivo di Blueprint è un piano strutturato in markdown con sezioni definite e domande aperte destinate all'esecuzione.
• Workflow sidebar VS Code con estensione di pianificazione: Se preferisci tooling integrato nell'editor, Blueprint è disponibile anche come VS Code extension che funziona in VS Code, Cursor e Windsurf, il che può differire da setup puramente basati su chat per agenti.