---
name: write-stories
description: Write or update Storybook stories for a component
argument-hint: "[ComponentName]"
---

Write or update Storybook stories for an existing component.

Use the story-writer agent to handle this task. The component to document:

**Component:** $ARGUMENTS

**Instructions for the agent:**
1. Read `docs/conventions/component-conventions.md` for story standards
2. Read the component source file at `src/components/` (check atoms/, molecules/, organisms/)
3. Create or update `{ComponentName}.stories.tsx` in the component's folder
4. Cover ALL items in the story coverage checklist:
   - [ ] Default state with typical content
   - [ ] All visual variants side by side
   - [ ] All sizes side by side (if applicable)
   - [ ] Disabled state
   - [ ] Loading state (if applicable)
   - [ ] Error state (if applicable)
   - [ ] Long content / content overflow
   - [ ] Empty/minimal content
   - [ ] With and without optional elements (icons, badges, etc.)
5. Every story meta MUST include `tags: ['autodocs']`
6. Verify the component renders correctly in Storybook at http://localhost:6006
7. Update `docs/memory/session-log.md` when done
