| name | recipe-blueprint |
| description | Selects and defines the structural design context needed by a prototype or PRD. Use when shared information architecture, flows, content, brand, Visual Tokens, or AI interaction decisions are missing. |
| disable-model-invocation | true |
| metadata | {"opencode/autoinvoke":"false"} |
Context: Create or update structural design artifacts in docs/product/design/ so prototype generation and PRD authoring reuse the same design context.
Required Skills [LOAD BEFORE EXECUTION]
- [LOAD IF NOT ACTIVE]
blueprint-standards — artifact selection and templates
Conditional Skills [LOAD WHEN TRIGGERED]
- WHEN the selected artifacts define user-facing states, persona-sensitive behavior, or accessibility boundaries: [LOAD IF NOT ACTIVE]
design-perspective
- WHEN the selected artifacts require state-design or product-confidence rules: [LOAD IF NOT ACTIVE]
product-principles
A blueprint may contain any subset of the defined artifacts.
Execution Decision Flow
1. Context Reading
Identify the prototype or PRD decision that needs shared design context. Read only the available vision, principles, personas, Opportunities, journeys, and learnings that can change that decision.
When missing evidence leaves the design outcome materially ambiguous, name the exact product decision required from the user. Otherwise proceed with the available evidence and mark the assumption in the affected artifact.
2. IA and Key Flow Definition
Use blueprint-standards references:
references/ia-template.mdreferences/flow-template.md
When navigation or task sequence affects the consumer, capture:
- page hierarchy
- navigation model
- labeling and taxonomy
- the critical user flows needed by the consumer, with entry, success, and relevant recovery paths
3. Content Model Definition
When entity shape or lifecycle affects the consumer, use references/content-model-template.md to define:
- core entities
- relationships
- lifecycle states when relevant
- where those entities appear in the product
4. Brand Direction and Visual Tokens
When visual consistency affects the consumer, use references/brand-direction-template.md to define:
- tone and voice
- color and typography direction
- motion and density choices
- reference products
- Visual Tokens for prototype consistency
Visual Tokens are concrete prototype values, not final production tokens.
When Visual Tokens are needed, derive them using the Derived From rules in the template and mark Source as auto-derived unless a design expert later refines the values.
5. AI Interaction Model
If AI behavior affects the current prototype or PRD, use references/ai-interaction-model-template.md to define:
- interaction patterns
- disclosure and confidence communication
- guardrails
- error taxonomy
Present the blueprint decisions that were created to the user for confirmation.
End the current turn with the blueprint draft as the workflow output. Write artifacts only after the user confirms those decisions in a later turn.
6. File Output
After that confirmation, write only the artifacts produced for the current consumer:
docs/product/design/information-architecture.md when IA was neededdocs/product/design/content-model.md when a content model was neededdocs/product/design/brand-direction.md when brand direction or Visual Tokens were neededdocs/product/design/ai-interaction-model.md when AI interaction decisions were neededdocs/product/design/flows/flow-{name}.md for each required flow
Scope Boundaries
Included: structural design artifacts for reusable prototype and PRD context
Not included: pixel-perfect specs, final production design system, implementation details
Completion
The workflow is complete when the confirmed artifacts needed by the current consumer exist, or a no-change result identifies the reusable artifacts and any unresolved design decision.
