---
name: build-molecule
description: Build a molecule component (PriceCard, FormField, etc.)
argument-hint: "[ComponentName]"
---

Build a molecule component for the FA Design System.

Use the component-builder agent to handle this task. The user wants to build the following molecule component:

**Component:** $ARGUMENTS

**Instructions for the agent:**
1. Read all memory files and conventions before starting
2. Check `docs/memory/component-registry.md` to confirm the component is planned and that its constituent atoms are `done`
3. Create the component in `src/components/molecules/{ComponentName}/`
4. Include: `{ComponentName}.tsx`, `{ComponentName}.stories.tsx`, `index.ts`
5. Compose from existing atom components — import from `@atoms/`
6. Follow all rules in `docs/conventions/component-conventions.md`
7. ALL visual values MUST come from the MUI theme — never hardcode
8. Write comprehensive Storybook stories with realistic content
9. Verify the component renders in Storybook
10. **Run internal QA** (stages 3-5 from `docs/reference/component-lifecycle.md`):
    - Run `/audit` — fix all P0/P1 issues
    - Run `/critique` — fix all P0/P1 issues
    - Run `/harden` — check edge cases for interactive molecules
    - Run `/polish` — final alignment, spacing, transitions
    - Run `/typeset` if text-heavy (cards, form fields)
11. Present to user with summary and scores
12. Update all memory files when done