Public DocsDesign Phase
Design Phase Supported Flow Beats
Design Phase Supported Flow Beats
Accepted Beat Path
- Open with the gap:
design-phaseis a Supported Flow for visual/product design work that needs evidence, artifacts, backlog context, and active delivery. - Position the flow between requirements and implementation: too concrete for requirements discovery alone, too unresolved for delivery alone.
- State the promise: turn existing design evidence and lean constraints into approved artifacts, backlog items, and a started
delivery-phase. - Name the first principle: design starts from existing product truth, not blank-slate taste.
- Walk intake as evidence collection: routes, pages, flows, target surfaces, theme CSS, tokens, global styles, components, screenshots, Figma inputs, content, brand constraints, and known decisions.
- Explain confidence handling: missing screenshots or Figma do not block by default; low-confidence intake asks one concrete clarification or screenshot request.
- Introduce route-gated execution: entrypoint reads
router.md, emits router output, loads exactly one phase, writes a handoff, then stops or re-enters. - Clarify direct entry: starting at prototype, approval, backlog, or delivery handoff still routes through prerequisite and staleness checks.
- Show the phase path: intake -> grill -> prototype -> approval -> backlog -> delivery-handoff.
- Land the router contract: selected phase, evidence, next file, stop-or-re-enter decision, blockers, and route trace.
- Land the handoff contract: phase, status, scope, artifacts, validation, open questions, next route, and blockers.
- Explain staleness as a design safety gate: scope, route, theme, components, content, artifact intent, approval, backlog ids, and target surface can invalidate old evidence.
- Pivot to grill: the grill is intentionally lean and only asks goals, scope, constraints, conflicts, hard requirements, ownership, target surface, non-negotiables, and artifact intent.
- Warn against over-grilling: detailed UI choices belong to prototype, where the user can react to visual evidence.
- Name the scope rule: one branch per user-visible page or flow; section branches only when the section is an independent decision surface.
- Introduce artifact intent as the prototype fork: the user wants either image references or prototype artifacts.
- Explain capability fallback: image intent uses imagegen when available and falls back to
$prototypeonly when unavailable; prototype intent activates$prototypedirectly. - Make design directions subordinate: directions are generated as artifact input, not as a standalone proposal phase.
- Emphasize delegation:
$prototypeproduction belongs to subagents so the main thread stays clean for user discussion and validation. - Explain approval: approval is explicit and per user-visible scope unit; artifact existence is not approval.
- Define the approved artifact contract: scope, intent, links, durable visual assets, evidence, accepted constraints, implementation notes, acceptance checks, and staleness risks.
- State the backlog gate: no approved artifact set means no backlog conversion.
- Explain backlog conversion:
write-backlogreceives approved artifact context and preserves visual evidence, constraints, acceptance checks, and fallback blockers. - Introduce durable assets: design artifacts must not live only in prose, temp files, or transient browser URLs.
- Route asset details to
repo-asset-management: backlog attachments first, repo-provider attachments as fallback, provider commands outside the page. - Close the lifecycle with delivery handoff:
delivery-handoffstartsdelivery-phasewith backlog ids, approved artifacts, target surfaces, constraints, validation expectations, frontend taste skills, and before/after PR evidence guidance. - Add the delivery boundary: delivery should not reopen design approval unless artifacts are stale or contradicted by implementation evidence.
- End with terminal outcomes: either approved artifacts become backlog and delivery starts, or the flow stops with a concrete blocker.
Parked Beats
- A detailed provider-by-provider asset hosting explanation belongs in
repo-asset-management, not this flow page. - A long example of generated image versus prototype output may be useful later, but the current source material does not include a real runtime example.
- Skill-reference updates for
design-phaseandrepo-asset-managementare adjacent docs work, but not part of this Supported Flows page journey.
Gaps For Shape Pass
- Decide whether the final page needs a Mermaid sequence diagram or a compact phase table.
- Decide how strongly to cross-link
Requirements To Backlog,Manual Delivery Flow,repo-asset-management, andSkill Reference. - Add one short operator example if a real design-phase run exists later.