CLAUDE.md Template for Web Apps

# Project: [APP NAME]

[One sentence: what this app is and who uses it.]

## Commands
- Dev server: `pnpm dev`
- Type check: `pnpm typecheck`
- Tests: `pnpm test` (single file: `pnpm test path/to/file.test.ts`)
- Lint + format: `pnpm lint`

Always run typecheck and the relevant tests before declaring a change done.

## Architecture
- [FRAMEWORK + VERSION, e.g. Next.js 16 App Router]
- Data layer: all reads/writes go through `lib/[X]`, never query the DB from components.
- State: [e.g. server components by default; client components only for interactivity].

## Conventions
- TypeScript strict; no `any`, no type assertions to silence errors.
- Prefer editing existing files over creating new ones; match surrounding style.
- Keep components under ~150 lines; extract when they grow past that.
- Error handling: fail loudly in dev, degrade gracefully in prod. Never swallow errors silently.

## Do not
- Do not add dependencies without asking.
- Do not edit generated files: [LIST, e.g. `*.gen.ts`, migrations].
- Do not commit: leave commits to me unless I ask.

## Deeper docs
Read these only when the task touches them:
- `docs/[X].md`: [one line on what it covers, e.g. "auth flow and session handling"]
- `docs/[Y].md`: [e.g. "deploy pipeline and environments"]

## Context
- [Anything non-obvious: auth quirks, deploy setup, flaky tests, domain terms.]