cd ~/Projects/DEV/paperclip
git fetch origin && git worktree add ../paperclip-run3 -b design/component-convergence origin/master
cd ../paperclip-run3 && pnpm install

cd ~/Projects/DEV/paperclip-design-simplify
git checkout -b design/component-convergence

Converge Paperclip's duplicated hand-rolled UI onto the shared
primitives, per the approved scope in doc/design/DECISION-SHEET.md
items C2, C3, C5, C11. DESIGN.md is the source of truth; read
doc/design/CHANGING-THE-UI.md and doc/design/RUN3-PROMPT.md first.
Work only in this worktree/branch; never touch master. Small
reviewable commits: one component-conversion unit per commit.

SCOPE
1. C5a: every hand-rolled card container (rounded-* + border +
   bg-card pattern) in ui/src/components/** and ui/src/pages/**
   converts to the Card primitive, preserving layout and behavior.
2. C5b: every hand-rolled pill span converts to Badge (or the
   status-chip system where it encodes status), same preservation.
3. C11: SidebarAgents rows render via SidebarNavItem (keep agent
   status dot + wake affordances; dot uses --status-agent-running).
   Apply one collapsibility policy across sidebar sections and
   record it in DECISION-SHEET.md C11.
4. C2/C3: investigate (do not merge by default): C2 WorkspaceFileBrowser
   vs FileTree tree models; C3 the four entity pickers. Write verdicts
   with evidence into COMPONENT-INVENTORY.md. Execute a merge ONLY if
   the verdict is copy-paste drift with identical data shapes and the
   merge preserves behavior; otherwise document keep-as-is rationale.
5. Add a Storybook story for the AgentDetail page (realistic fixture,
   light+dark) so it joins the visual suite.

VERIFICATION DISCIPLINE (small visual deltas are EXPECTED)
- Before starting: run the suite once to confirm 510/510 green.
- Per conversion commit: run the affected stories; if pixels changed,
  copy each changed story's expected/actual/diff triplet into
  doc/design/run3-review/<story>/ and note the story ids + one-line
  justification in the commit message. Deltas must be small
  (primitive-level: borders, radii, padding) — a layout shift or
  color-meaning change means STOP that conversion, revert it, and
  record it under "Needs human decision" in DECISION-SHEET.md.
- A site that cannot adopt the primitive without breaking behavior:
  skip it, comment why inline, list it in the report.

DONE WHEN (all verified in this worktree)
1. rg finds no hand-rolled card-container or pill-span patterns in
   ui/src/components/** or ui/src/pages/** outside documented inline
   allowlist comments; converted sites import Card/Badge/SidebarNavItem.
2. C2/C3 verdicts written in COMPONENT-INVENTORY.md; C11 policy
   recorded in DECISION-SHEET.md.
3. AgentDetail story exists and renders in the suite.
4. pnpm check:token-gates 3/3 CLEAN; pnpm typecheck green;
   pnpm --filter @paperclipai/ui build exit 0.
5. Full visual suite passes against the updated baseline, and
   doc/design/run3-review/ contains the triplets for every story
   whose baseline changed, committed.
6. All vitest suites for touched components pass, assertions updated
   in lockstep where they referenced old markup/classes.

GUARDRAILS
- Preserve behavior exactly: props, handlers, a11y roles, test ids.
- No new dependencies. No palette-class conversions (Run 4's job).
- Never re-baseline a diff you cannot justify in the commit message.
- If a phase cannot complete, stop and report rather than partially
  applying it.