Blueprint

Generate two artifacts for every blueprint:

1. Plan spec (.md) -- the executable plan in structured markdown, saved to ~/.claude/blueprint/
2. Visual blueprint (.html) -- the interactive HTML presentation, saved to ~/.agent/diagrams/

The .md file is the working document you hand to an agent or follow yourself. The .html is the visual version of the same content. Both files share a matching name (e.g., ws-events-blueprint.md + ws-events-blueprint.html).

Workflow

1. Explore (Subagents)

Before generating anything, understand the codebase. Launch parallel explore subagents to investigate the areas relevant to the user's request.

When to use subagents:

• 1 agent: isolated change, user gave specific file paths
• 2-3 agents: multiple areas involved, need to understand existing patterns
• Each agent gets a focused objective: "find existing auth middleware and trace its usage", not "explore the codebase"