Карта методов
Эта таблица сопоставляет самые распространённые режимы отказа в долгих задачах агента-кодера с артефактом или операционным правилом, которое обычно решает их первым.
| Режим отказа | Как это выглядит на практике | Первичный фикс | Поддерживающий артефакт |
|---|---|---|---|
| Cold-start confusion | Новая сессия тратит большую часть времени на повторное выяснение сетапа и статуса | Сделайте репозиторий системой учёта | claude-progress.md |
| Scope sprawl | Агент начинает несколько фич и ни одну из них не доводит до чистого конца | Ограничьте активный скоуп | feature_list.json |
| Premature completion | Агент заявляет о done после правок кода, но до runnable-доказательства | Привяжите завершение к доказательствам | clean-state-checklist.md |
| Fragile startup | Каждая сессия заново учится, как поднимать проект | Стандартизируйте сетап и верификацию | init.sh |
| Weak handoff | Следующая сессия не может понять, что верифицировано, что сломано и что дальше | Заканчивайте явным handoff | session-handoff.md |
| Subjective review | Качество ревью зависит от вкуса или памяти | Оценивайте вывод по фиксированным категориям | evaluator-rubric.md |
Операционный принцип
Добавляйте наименьший артефакт, который напрямую адресует наблюдаемый режим отказа. Не пытайтесь решить любую проблему надёжности, сваливая всё больше текста в один глобальный файл инструкций.