Design Handoff
Designer then implementer — same agent, two explicit passes. See reference/handoff-to-code.md.
Subagents (default)
Orchestrate in main chat; delegate phases via Cursor Task tool. See reference/subagents.md.
- Pass 1 (interpret):
generalPurposesubagent — mockup-brief + Implementation spec only; thenshellfordescribe_handoff. - Pass 2 (build):
explorefor catalog →generalPurposefor shell then route →shellforverify_*, npm,@visual-auditor. - Do not inline Playwright or full implement in the same subagent as interpret.
Gate each phase before launching the next subagent.
When to use
- Designer attaches desktop/mobile screenshots for a route
.heyeddi/designs/<feature>/has reference images- Implementing an approved mockup without Figma MCP
Instructions
Pass 1 — Designer (interpret)
- Run
python scripts/load_handoff.py --route <route> --project-root <root>. - Read
.heyeddi/product.md— Personas + Per-route intent for this route; align brief microcopy and hierarchy (heyeddi-design/reference/audience-design.md). - Read
reference/interpret-mockups.md(PNG) orreference/low-fidelity-mockups.md(wireframe.md) — writemockup-brief.mdwith Implementation spec + Theme notes. - Run
python scripts/describe_handoff.py --route <route> --sync-design. - Stop — do not write Vue until Implementation spec is complete.
Pass 2 — Implementer (build)
- Read
reference/handoff-to-code.md+mockup-brief.mdImplementation spec. - Update
tokens.cssfrom spec — no same-name aliases (--size-6: var(--size-6)breaks spacing). Runpython scripts/verify_tokens.py --check. - Build AppShell / AppSidebar / AppTopBar.
- Run
python scripts/verify_handoff.py --route <route> --phase shell --check. - Build route content (e.g.
SettingsView) — override PrimeVue Card padding per spec. - Run
python scripts/verify_handoff.py --route <route> --phase full --check. - Run
python scripts/verify_theme.py --check— light/dark + PrimeVue surfaces (reference/theme-coherence.md). - Read
reference/mockup-contract.mdwhen needed. - Chain
@primevue-openprops-architect→@visual-auditorwhen available. - Append Decision log — region → component + rationale.
Modes
- Screenshot (v1):
reference/screenshot-mode.md+reference/interpret-mockups.md+reference/handoff-to-code.md - Wireframe / ASCII:
reference/low-fidelity-mockups.md+wireframe.md(no PNG required) - PrimeVue Card slots:
reference/primevue-card-slots.md— body content in<template #content> - Penpot (future):
reference/penpot-mode.md