Claude Code для pet-проєкту: гайд по грамотному сетапу

Відкриваєш нову сесію в агенті, пишеш задачу, а потім ще два абзаци пояснюєш, як він повинен працювати: де лежить API, як запускати тести, за яким воркфлоу працювати.

Якщо ловиш себе на цьому знову і знову, час завести CLAUDE.md.

Що залишити в CLAUDE.md

Я б залишив там тільки те, що Claude потрібно знати майже в кожній задачі:

• як запустити проєкт;
• які перевірки прогнати;
• які домовленості є у воркфлоу.

Орієнтир — до 200 рядків. Це не ліміт: довший файл теж завантажиться, просто серед зайвого тексту окремі інструкції легше губляться.

Заборони й автоматичні перевірки

Заборони й автоматичні перевірки я б налаштовував окремо, у .claude/settings.json. Наприклад, hook може запускати лінтер після правок.

Skills, агенти й MCP

Решту можна додати згодом, коли зʼявиться конкретна задача для skill, окремого агента чи MCP.

До речі, проєктний .mcp.json лежить у корені репозиторію, хоча його постійно хочеться засунути в .claude/.

Кілька місяців тому я показував цю карту в OnlyFounds. Тепер викладаю її на канал: гортай картки, а PDF залишив окремим постом.

Підписуйся на solo lemon., якщо теж будуєш свій IT-продукт паралельно з роботою. Тут розбираємося і з розробкою, і з тим, як знайти для продукту перших юзерів.