# CLAUDE.md

## Context

[Two paragraphs. What is this project. Who is it for. What is the headline goal. What has shipped. What has not. Working brief, not marketing.]

## Stack

- Runtime: [Node.js 22 / Python 3.12 / etc.]
- Framework: [Next.js 14 / FastAPI / etc.]
- Language: [TypeScript / Python / etc.]
- Database: [Postgres / SQLite / etc.]
- Testing: [Vitest / pytest / etc.]
- Deployment: [Vercel / Docker on VPS / etc.]

## Conventions

- [Specific convention. "We prefer functional components."]
- [Specific convention. "All async functions return Result types."]
- [Specific convention. "File names are kebab-case."]

## Domain Knowledge

[Vocabulary, business logic, regulatory constraints specific to this project. The things someone new could not infer from reading code.]

## Hard Rules

- Never commit directly to main.
- Never log PII.
- [Other hard rules. Keep under ten.]

## Workflow

- Run tests: `[command]`
- Start dev: `[command]`
- Build: `[command]`
- Deploy: `[command]`
- Roll back: `[command]`

## Plain Language and Hypothesis Discipline

[Paste the standard addendum from aerosensei.com/foundations/your-first-claude-md here verbatim.]