Итоги и практика

Ключевые выводы

• Хорошее рабочее пространство даёт ИИ контекст, быстрый цикл обратной связи и дешёвую отмену — настройка и есть множитель, часто важнее самой модели.
• Файл контекста (AGENTS.md / CLAUDE.md) — самое рычажное, что вы можете написать: конкретные правила, громкие запреты и указатели на примеры.
• Сделайте контроль версий рефлексом — коммитьте мелко, читайте дифф, рискованную работу делайте в ветке — тогда ничто, сделанное ИИ, не будет по-настоящему необратимым.
• Держите цикл плотным и дайте агенту замыкать его самому: правка, запуск, чтение ошибки, исправление. Возвращайте диагностику (LSP, линт, проверку типов) обратно ИИ.
• Заприте каждый платный API жёстким лимитом и ограничителем, держите секреты вне репозитория и используйте харнесс, чтобы проверки безопасности нельзя было пропустить.

Попробуйте

Откройте проект, над которым работаете (или создайте пустой каркас), и напишите от руки черновик AGENTS.md: что это за проект, технологический стек, точные команды для dev/test/lint, три реальных соглашения и хотя бы два громких запрета (например, «никогда не читать и не печатать .env», «не добавлять зависимости без предупреждения»). Затем попросите свой ИИ-инструмент внести тривиальное изменение и посмотрите, уважает ли он файл. Каждый раз, когда он делает что-то нежелательное, добавляйте или оттачивайте одну строку. Вы настраиваете комнату, а не только код.

Промпт главы

Read my project and help me write a concise AGENTS.md context file for it.

First, inspect the repo and tell me:
- the tech stack and versions you detect
- the commands for install / dev / test / lint / build
- the layout and where the entry point is

Then draft an AGENTS.md with these sections: What this is, Tech stack,
Commands, Conventions, and Don'ts. Be specific and concrete (name the
exact libraries and rules, not "follow our conventions"). State the don'ts
as loudly as the do's, and point to one existing file as a style example.
Keep it under ~40 lines — I'll prune from there.