раздел 05

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

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

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

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

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

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

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

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

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

Сделайте CLAUDE.md симлинком на AGENTS.md - и файл работает в Claude Code, Codex и Cursor сразу.

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

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

Словарь

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

Куда дальше