---
name: build-organism
description: Build an organism component (Navigation, PricingTable, etc.)
argument-hint: "[ComponentName]"
---

Build an organism component for the FA Design System.

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

**Component:** $ARGUMENTS

**Instructions for the agent:**
1. Read all memory files and conventions before starting
2. Check `docs/memory/component-registry.md` — confirm the organism is planned
3. Verify all constituent molecules and atoms are marked `done` in the registry — if any are not, STOP and tell the user which dependencies need to be built first
4. Create the component in `src/components/organisms/{ComponentName}/`
5. Include: `{ComponentName}.tsx`, `{ComponentName}.stories.tsx`, `index.ts`
6. Compose from existing molecule and atom components — import from `@molecules/` and `@atoms/`
7. Follow all rules in `docs/conventions/component-conventions.md`
8. ALL visual values MUST come from the MUI theme — never hardcode
9. Write comprehensive Storybook stories with realistic page-level content
10. Verify the component renders in Storybook
11. **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 all edge cases (organisms handle real data)
    - Run `/polish` — final alignment, spacing, transitions
    - Run `/typeset` if text-heavy
    - Run `/adapt` — responsive check (organisms are layout components)
    - Run `/quieter` if the organism handles sensitive moments (pricing, forms, errors)
    - Run `/clarify` if the organism has decision points or complex information
12. Present to user with summary and scores
13. Update all memory files when done