Parsons/.claude/skills/build-organism/SKILL.md

name, description, argument-hint

name	description	argument-hint
build-organism	Build an organism component (Navigation, PricingTable, etc.)	[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