раздел 05

Шаблон и шпаргалка

Стартовый AGENTS.md / CLAUDE.md

# Проект
Коротко: что это за продукт и для кого.

## Команды
- Запуск: <команда>
- Сборка: <команда>
- Тесты: <команда>
- Линт: <команда>

## Стиль и соглашения
- Язык/стек, форматирование, именование.
- Какие подходы и библиотеки использовать, какие - нет.

## Структура
- Где точки входа и ключевые модули.

## Ограничения
- Чего НЕ трогать, что хрупкое.
- Секреты только в .env, не в коде и не в гите.

## Проверка
- Что прогнать перед готовностью (тесты, линт).

## Поведение (по Карпатому)
- Думай до кода и проговаривай допущения.
- Минимум кода, без лишних абстракций.
- Точечные правки, сохраняй стиль.
- Определи критерий успеха и проверь результат.

В Claude Code тот же файл называется CLAUDE.md: под именем AGENTS.md Claude его не читает. Содержимое одинаковое.

Чек-лист хорошего файла

  • Есть команды (запуск, сборка, тесты, линт).
  • Описан стиль и соглашения.
  • Указана структура и точки входа.
  • Перечислены ограничения и хрупкие места.
  • Сказано, как проверять готовность.
  • Коротко и по делу - не раздувает контекст.
  • Вложенные папки имеют свой файл, если правила отличаются.

Словарь

ТерминЧто это
AGENTS.mdОткрытый стандарт файла инструкций: его читают Codex, Cursor и другие агенты.
CLAUDE.mdТот же файл инструкций для Claude Code: файл под именем AGENTS.md Claude не читает.
GEMINI.mdФайл инструкций Gemini CLI по умолчанию.
ИерархияГлобальный -> корень -> вложенные папки; конкретное перекрывает общее.

Куда дальше