blueprint-standards

Defines structural design artifact formats — information architecture, user flows, content model, brand direction, and AI interaction model. Use when creating or reviewing structural design documents that precede prototype generation.

Blueprint Standards

Purpose

Blueprint artifacts define the structural foundation that prototypes and UI specifications build upon. They bridge the gap between validated opportunities and tangible product design.

Blueprint artifacts answer: "What pages exist, how do users move between them, what data lives where, and what does the product feel like?"

Artifact Overview

ArtifactQuestion It AnswersTemplate
Information ArchitectureWhat pages exist and how are they organized?references/ia-template.md
User FlowsHow do users move through the product to achieve goals?references/flow-template.md
Content ModelWhat data types exist and how do they relate?references/content-model-template.md
Brand DirectionWhat does the product look and feel like?references/brand-direction-template.md
AI Interaction ModelHow does the user interact with AI features?references/ai-interaction-model-template.md

When Blueprint Artifacts Are Required

Blueprint artifacts provide the structural context that makes prototypes coherent across multiple hypotheses. Create them before generating prototypes.

Relationship to Other Artifacts

docs/product/vision.md              ← Strategic intent
docs/product/design-principles.md   ← Trade-off resolutions
docs/product/personas/              ← Who uses it
docs/discovery/opportunities/       ← What problems to solve
docs/discovery/hypotheses/          ← How to solve them
                ↓
docs/product/design/                ← Blueprint (structural design)
                ↓
docs/discovery/prototypes/          ← Tangible validation artifacts
                ↓
docs/prd/                           ← Implementation specification

Blueprint Scope

Blueprint defines: Structure, navigation, data relationships, visual direction, interaction patterns Blueprint defers: Pixel-level specifications, component APIs, responsive breakpoint details, design token values → these belong to UI Spec (implementation phase)

Key Principles

  • Opportunity-grounded: Every page in the IA traces to a validated Opportunity or a supporting function
  • Persona-informed: Flows are written from the perspective of specific personas
  • Consistent across prototypes: Brand direction and IA provide shared context that all prototypes reference
  • Updatable through reflection: Blueprint artifacts evolve as new learnings surface in docs/product/learnings.md
  • Minimal viable structure: Define enough to make prototypes coherent, defer details that require implementation-phase decisions