DESIGN.md@templates · git:20261013.29afc4f · 2026-10-13 · sha256 1c0bc74d060c0483
DESIGN.md@templates git:20261013.29afc4fA
Immutable. This exact content never changes and is served at /api/v1/blob/1c0bc74d060c0483.
# DESIGN.md Use this file as project-specific visual memory. Keep it true to the shipped product, not to an aspiration that has not been rendered. ## Product Character - Product / audience: - Primary workflow: - Surface mode: - Input model and viewing distance: - Density and frequency: ## Direction - Design stance: - Style anchor: - Signature move: - Signature interaction: - What is intentionally not used: - Independent concepts considered: - Chosen concept and why it belongs to this product: - Rejected concepts and reason: ## Research Atlas - User-provided references and inspection status: - Competitor or category references and inspection status: - Section-level winners: navigation / opening / object or feature proof / mobile / motion or state / ending: - Selected references and visible decisions borrowed: - Rejected references or traits and why: - Reference weaknesses preserved or corrected: - Template-risk observation: - Synthesis summary: ## Authority And Exceptions - Direction owner: project `DESIGN.md` / user reference / accepted concept / model proposal: - Rules inherited from the owner: - Advisory defaults intentionally overridden: - Why each exception is deliberate: - Evidence or reference inspected: - Hard invariants preserved: - Render proof reviewed at desktop / mobile / non-default / reduced-motion: ## Composition And Reading Distance - Structural hypotheses to compare before polishing: - Selected hypothesis and why it fits the subject: - Per-region placement / text alignment / measure / occupancy / field / surface / pause / geometry tokens / neighbor relationship: - Viewport field / content shell / object stage / reading measure: - Useful empty space and its job: - Changes of width, density, and pause across the full page: - Wide screen limits / intermediate regrouping / narrow re-staging: - Actual widths and states inspected; remaining composition defects: ## Type - UI/body: - Display/editorial: - Numeric/code: - Language/script support: - Largest text role and ceiling: ## Color And Material - Canvas / surfaces: - Text / muted text: - Border / divider: - Action accent: - Semantic states: - Radius / depth / translucency rules: ## Geometry And Edges - Edge character: - Corner hierarchy: page field / dominant stage / secondary panel / control / pill: - Separation order: spacing / tone / inset / overlap / depth / border / divider: - Line policy and permitted jobs: - Localized sharp exceptions and why: - Desktop / mobile silhouette reviewed: ## Assets - User-provided assets and required handling: - Existing / official sources: - Searched or generated assets and provenance: - Primary asset role and focal crop: - Desktop / mobile variants: - Loading / poster / static fallback: - Quality issues or blockers: ## Components - Navigation: - Controls: - Forms: - Lists / tables: - Panels / drawers / dialogs: - Media / product object: - Card budget: - States that must be designed: ## Product Signal - Signal mode: functional product / narrative / art-directed / experimental: - Product object: - User and job: - Core loop: - Primary action: - Visible result: - Concrete content / data: - State matrix: - First viewport proof: - Prototype interaction: - Presentation shell rejected because: ## Authored Experience Signal - Subject or world: - Audience intent: - Attention path: - Creative thesis: - Proof: - Transition or ending: - Why this form belongs to the work: ## Motion And Devices - Motion grammar: - Reduced-motion fallback: - Desktop behavior: - Mobile / touch behavior: - Embedded / remote behavior: ## Evidence - References inspected: - Selected concept or screenshot revision and source: - Visual decisions translated into implementation: - Screens or routes verified: - Actual baseline and revised captures: - Known gaps: - Last reviewed: