# CLAUDE.md

Guidance for Claude Code working in this repository.
This file is a table of contents only — read the linked document when the topic becomes relevant.

## Always applies

- **Communication language is Hungarian.** Talk to the developer in Hungarian.
- **Everything else is English**: code, identifiers, database schema, comments, commit messages, documentation.
- Never write a plan, an implementation or a document without checking the relevant topic below first.
- **Private context lives in `CLAUDE.local.md`, not in memory.** Who the developer is, who the client contacts
  are, credentials-adjacent notes, anything not meant for the repository. It is gitignored. Write new private
  context there and nowhere else — do not create memory files for this project.

## Topics

| When | Read |
|------|------|
| Starting any task | [docs/WORKFLOW.md](docs/WORKFLOW.md) |
| Writing PHP / JS / SCSS / views | [docs/CODE_STYLE.md](docs/CODE_STYLE.md) |
| Writing or running tests | [docs/TESTING.md](docs/TESTING.md) |
| Proving a change works | [docs/VERIFICATION.md](docs/VERIFICATION.md) |
| Committing | [docs/COMMIT.md](docs/COMMIT.md) |
| Writing or updating documentation | [docs/DOCUMENTATION.md](docs/DOCUMENTATION.md) |
| Understanding the codebase | [docs/wiki/README.md](docs/wiki/README.md) |
| Looking up a past decision | [docs/adr/README.md](docs/adr/README.md) |
| Checking the state of ongoing work | [docs/plans/README.md](docs/plans/README.md) |
| Running things locally, Docker, assets | [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) |
| Scheduled tasks | [docs/CRON.md](docs/CRON.md) |
| The admin backend | [docs/ADMIN.md](docs/ADMIN.md) |
| Deployment | [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md) |
| Project overview, tech stack | [docs/INTRODUCTION.md](docs/INTRODUCTION.md) |
| Application structure, entry points | [docs/STRUCTURE.md](docs/STRUCTURE.md) |

## Environment

The developer runs a local Dockerized dev environment. Two things are **his**, never Claude's:

- **Claude never deploys.** The developer installs to the server.
- **Claude never starts Encore.** He keeps `npm run encore dev watch` running himself.

See [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) and [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md).