# AGENTS.md

Storybook is the industry standard workshop for building, documenting, and testing UI components in isolation

## Setup

```
yarn install
```

## Commands

```
yarn start                # run the app
yarn test                 # run the test suite, must pass before any commit
yarn lint                 # lint
yarn ci-tests
yarn docs:check
yarn fmt:check
yarn fmt:write
yarn get-report-message
```

## Layout

- `code/`            4450 source files
- `scripts/`         185 source files
- `test-storybooks/` 184 source files
- `agent-eval/`      179 source files
- `docs/`            1 source file

## Conventions

- Tests live alongside the code they cover, following `agent-eval/lib/mcp/codex-browser-mock.test.ts`.
- CI defines what passing means. See `.github/workflows/agent-eval.yml`, and keep it green.
- TODO: add the two or three conventions a newcomer always gets wrong here.

## Gotchas

- `.yarn/releases/yarn-4.18.0.cjs` is 3696KB. It will not fit comfortably in context, so read it in parts.

---

Drafted by agentreadme.com from what is in this repository. Everything marked TODO
needs a human. Check it in as AGENTS.md at the root.