CLAUDE.md@starter-kit git:20260930.92d4796A

Immutable. This exact content never changes and is served at /api/v1/blob/2b167491e60f65a3.

# Проект: <Название>

<!-- Шаблон. Замените примеры на реальные команды вашего проекта. Держите файл коротким (< 200 строк). -->

## Обзор
- Что это: <одно предложение о проекте>
- Стек: <TypeScript, Node 20, PostgreSQL, React>
- Подробнее: @README.md

## Команды
- `pnpm install` — установка зависимостей
- `pnpm dev` — dev-сервер
- `pnpm test` — все тесты; `pnpm test path/to/file.test.ts` — один файл (предпочтительно)
- `pnpm lint` / `pnpm typecheck` — обязательно перед коммитом

## Архитектура
- `src/routes/` → `src/services/` → `src/repositories/` — слои не перепрыгивать
- Общие типы — `src/types/`
- Конфигурация — только через `src/config.ts`, не читать `process.env` напрямую

## Стиль кода
- TypeScript strict, без `any`
- Именованные экспорты, без default export
- Ошибки — через классы из `src/errors.ts`

## Workflow
- Для задач сложнее одного файла — сначала план
- Сначала тест, потом реализация; после изменений запускай релевантные тесты
- Коммиты — Conventional Commits (`feat:`, `fix:`, `refactor:` ...)
- Ветки: `feature/<кратко>`, `fix/<кратко>`

## ВАЖНО / Никогда
- НИКОГДА не редактируй уже применённые миграции в `migrations/`
- Не коммить `.env` и секреты
- Не добавляй зависимости без явной просьбы