| name | recipe-refine-visuals |
| description | Use when a design-capable human wants to refine the auto-derived Visual Tokens in `docs/product/design/brand-direction.md` |
| disable-model-invocation | true |
| metadata | {"opencode/autoinvoke":"false"} |
Context: Refine the Visual Tokens in docs/product/design/brand-direction.md after recipe-blueprint has created an initial set.
This side workflow applies when a human with design judgment explicitly requests refinement of the auto-derived token set.
Required Skills [LOAD BEFORE EXECUTION]
- [LOAD IF NOT ACTIVE]
blueprint-standards — brand-direction template and Visual Token structure
- [LOAD IF NOT ACTIVE]
design-perspective — accessibility and persona-aware design review
Workflow
- Read
docs/product/design/brand-direction.md
- Review current Visual Tokens against design principles, personas, and prototype learnings
- Verify:
- text-on-surface contrast ratio is at least 4.5:1 for normal text
- heading text is at least 1.25x the body size in the primary hierarchy step
- spacing tokens form a consistent increasing scale without reversals
- Apply exact overrides supplied by the user and mark the source as
expert-refined
- When the request requires a new design choice, present only that choice and its rationale; update the file after the user confirms it
Scope Boundaries
Included: colors, typography, spacing, radius, shadow values
Not included: redesigning the entire blueprint or introducing implementation-specific component APIs
