Find agent skills by outcome

If no CLAUDE.md exists yet: Tell the prompt to generate a minimal token section at the top of the handoff document covering only the tokens needed for this specific handoff. It won't be a full design system

but it prevents hardcoded values.

If you're not using Tailwind: Replace all Tailwind class references in the prompt with your system's equivalents. The structure stays the same — only the value format changes. Tell Claude: Use CSS custom properties as primary

px values as annotations.

7. When encountering ambiguity

prefer the more explicit interpretation.

If still ambiguous

add a TODO comment: // HANDOFF-AMBIGUITY: [description]

6. After implementing each component

run through its state matrix

a component

that is a gap in the spec — flag it

with close enough values. `gap-6` means `gap-6`

not `gap-5`.

□ Every state (hover

active

is not in CLAUDE.md

flag it and use the fallback value provided.

□ Focus-visible ring appears on keyboard nav

not on mouse click

Coding & Debugging

After implementation

the AI agent (or human developer) should verify:

date other year: show Mar 13

2025

date this year: show Mar 13 not Mar 13

2026

list with 500 items: paginate at 20

show Load more button

price $999

999.99: ensure layout doesn't break (test with formatted number)

username 50 characters: truncate at 20 in nav

full in profile

Form validation: inline per-field (see flow specs)

never alert()

Coding & Debugging

- icon: ImageOff from lucide-react

text-gray-400

(rectangle for text

circle for avatars

- initials: first letter of first + last name

uppercase

nav items: single line

truncate if >16 characters on mobile

button labels: single line only

max 30 characters

headings: max 2 lines

then truncate with text-ellipsis (add title attr for full text)

body text: allow natural wrapping

no truncation