раздел 05

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

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

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

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

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

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

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

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

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

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

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

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

Словарь

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

Куда дальше