🛠 Инструкция по эксплуатации: коротко и по делу
Abstract
Эта заметка нужна как быстрый операционный стандарт: когда подключать агента, что подготовить перед запуском и как фиксировать результат, чтобы не терять контекст.
Когда это действительно нужно
- Задача больше 20-30 минут и состоит из нескольких шагов.
- Нужна работа с несколькими файлами и важен единый стиль.
- Нужно сохранить результат в базу так, чтобы им можно было переиспользовать.
Если задача маленькая (правка 3-5 строк, быстрый ответ, разовая заметка), не усложняй процесс: делай вручную.
Минимальный набор перед стартом
- Понятная цель в 1-2 предложениях: что именно должно получиться.
- Ограничения: что менять можно, что нельзя.
- Источники контекста: нужные файлы/папки.
- Критерий готовности: как понять, что задача завершена.
Без этих 4 пунктов агент чаще даёт шум вместо результата.
Рабочий цикл (5 шагов)
-
Сформулируй задачу
Коротко опиши итог и ограничения. -
Дай контекст
Передай конкретные файлы, а не “посмотри всё”. -
Запусти выполнение
Попроси сделать изменения и сразу применить их в файлах. -
Проверь результат
Сверь с критерием готовности: структура, ссылки, логика, читаемость. -
Зафиксируй полезное
Сохрани выводы в заметку/индекс, чтобы не повторять ту же работу.
Где держать правила
- В
.cursorrules— постоянные требования к стилю и процессу. - В
CLAUDE.md(или аналоге) — инструкции для CLI-агентов в конкретной папке. - В тематических заметках — примеры и шаблоны под реальные кейсы.
Принцип: постоянные правила живут рядом с проектом, а не в голове.
Антипаттерны (что убрать)
- Слишком абстрактные роли и термины без примеров применения.
- Перегруженные таблицы “ради красоты”, которые не помогают принять решение.
- Жесткий процесс там, где достаточно 1-2 простых шагов.
- Отсутствие критерия “когда не использовать агента”.
Чеклист перед завершением
- Цель задачи достигнута и проверяема.
- Изменения в файлах точечные, без лишней “магии”.
- Полезные выводы сохранены в базе знаний.
- По заметке понятно, как повторить процесс через неделю.