# [Project name]

<!--
Starter CLAUDE.md. Save it at the repository root, replace every [bracketed]
part, and delete any section that has nothing true to say. Claude reads this
file at the start of every session, so each line should earn its place.
Comments like this one are for people; delete them when you are done.
-->

## What this project is

[One or two sentences: what it does, who uses it, and where it runs.]

## Stack

- Language and runtime: [for example TypeScript on Node.js 22]
- Framework: [name and major version]
- Data: [database, ORM or query layer]
- Tests: [test runner]
- Deploy: [how and where it ships]

## Commands

```bash
[dev command]     # start the app locally
[test command]    # run the tests; single file: [how]
[lint command]    # lint and format check
[build command]   # production build
```

## Directory map

```text
[src/app/]        [routes or entry points]
[src/lib/]        [shared logic]
[src/db/]         [schema and migrations]
[tests/]          [where tests live and how they are named]
```

## Hard rules

These break the build or production when ignored.

1. [Rule, and what fails when it is broken]
2. [Rule, and what fails when it is broken]
3. Never commit secrets. Configuration comes from [where].

## Conventions

- [Naming: files, functions, database columns]
- [Imports: the alias or the order to use]
- [Errors: how they are raised, logged and returned]
- Follow the patterns in the file you are editing before adding a new one.

## How to verify work

- Read a file before editing it, and the files that call it.
- For a bug, reproduce it first, then fix it, then run the same reproduction.
- After each change run `[test command]` and `[lint command]`, and report
  the real output. Do not say it works without running it.
- [Any check specific to this project, such as a type check or a migration
  dry run]

## What not to do

- Do not refactor or rename things outside the task unless asked.
- Do not add a dependency without asking.
- Do not edit [generated files or folders]; change [their source] instead.
- Do not commit or push unless asked. One logical change per commit.
- [Anything this team has been burned by before]
