maestro:blueprint

Generate Maestro feature blueprint plans and HTML visual artifacts.

1|Updated May 26, 2026

Search Tags:#blueprint #mermaid diagrams #architecture planning #codebase exploration #maestro #implementation spec #phase-based tasks

Ready to run

npx skills add https://github.com/Leonardo-Corte/local-social-smm-agent --skill maestro-blueprint

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: maestro:blueprint
Source: https://github.com/Leonardo-Corte/local-social-smm-agent/tree/main/reference/github-agent-orchestration/maestro/.claude/skills/maestro%253Ablueprint
Command: npx skills add https://github.com/Leonardo-Corte/local-social-smm-agent --skill maestro-blueprint

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns a “blueprint this change” request into a concrete implementation plan by first mapping the relevant parts of the codebase and then producing a structured maestro-format plan plus a readable visual HTML overview.

Core Features & Use Cases

Codebase exploration for affected areas: Guides parallel checks across src/features/<name>/ (bounded contexts), src/infra/, src/shared/, src/tui/, existing tracks/plans, and tests.
Maestro plan spec generation: Produces a .md plan (Context, Critical Files, Design Decisions, Phases with Tasks + acceptance criteria, Risks, Verification, Dependencies) saved to .maestro/plans/{feature-name}.md.
Visual HTML blueprint generation: Builds an interactive, themed HTML presentation (timeline, per-phase file/task breakdown, Mermaid architecture and dependency graphs, risk matrix, verification checklist) for quick human review.

Quick Start

Ask the AI to blueprint the change by providing a clear feature description, for example: “Blueprint the new maestro command that creates and runs missions from a user-provided plan spec.”

Frequently Asked Questions about maestro:blueprint

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I generate an implementation spec for a multi-file architectural change?▼

To generate an implementation spec for a multi-file change, you explore the relevant codebase areas and synthesize a structured plan. This produces a markdown plan with phases, tasks, and acceptance criteria alongside a visual HTML architecture overview.

What is the best way to visualize feature architecture before implementation?▼

The best way to visualize feature architecture is generating a themed HTML blueprint with Mermaid diagrams. It maps the codebase and presents an interactive timeline, per-phase file breakdowns, and a risk matrix for quick human review.

How does codebase exploration work for architecture planning?▼

Codebase exploration for architecture planning guides parallel checks across bounded contexts, infra, shared modules, and tests. It identifies critical files and existing tracks to ensure the generated plan spec accurately reflects the current project structure.

Do I need a specific project structure to create a feature blueprint?▼

You need a project structure with bounded contexts like `src/features/`, `src/infra/`, and `src/shared/` to map effectively. The feature blueprint generation checks these directories to identify critical files and design dependencies for the plan.

What components are included in a phase-based implementation plan?▼

A phase-based implementation plan includes context, critical files, design decisions, and sequential phases. Each phase contains specific tasks, acceptance criteria, verification steps, risks, and dependencies saved directly as a markdown spec.

Why use Mermaid diagrams for codebase exploration and planning?▼

Mermaid diagrams provide visual dependency graphs and architecture visualizations for complex feature changes. They help developers quickly understand multi-file interactions and track phase-based tasks within the generated HTML blueprint overview.