Planning with Files: агент больше не теряет план после /clear
Когда контекстное окно сбрасывается, агент забывает, на каком шаге был. planning-with-files держит рабочее состояние в трёх файлах проекта: task_plan.md, findings.md и progress.md. Хуки возвращают выбранные фрагменты плана в каждый ход, поэтому после /clear, сбоя или сжатия контекста агент продолжает с текущей фазы.
Три файла: task_plan.md с фазами и галочками, findings.md с заметками исследования, progress.md с журналом сессии и результатами тестов.
Хуки на отправку запроса, вызовы инструментов, остановку и сжатие контекста подмешивают план и напоминают обновить прогресс.
Параллельные задачи получают отдельные папки .planning/ с датой и именем, а активная выбирается через файл .active_plan.
Правило двух действий: после каждых двух просмотров, поисков или шагов в браузере агент записывает находки в файл.
По измерениям авторов, план на диске сократил возврат к задаче с 13,3 до 5 ходов, а в слепых A/B-сравнениях скилл выиграл 3 из 3.
Когда пригодится
Задача растягивается на десятки вызовов инструментов и то и дело упирается в /clear или сжатие контекста.
Нужно вернуться к работе на следующий день и сразу увидеть, какая фаза закончена, а какая нет.
Несколько агентов или веток работают параллельно, и у каждой задачи должен быть свой план.
Попросите агента
Начни задачу «перевести API на версию 2» с плана по фазам в task_plan.md
Прочитай task_plan.md и progress.md и продолжи с текущей фазы
Запиши в findings.md, что мы выяснили про ошибку авторизации
Вопросы
Как установить planning-with-files?
Командой npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g, она ставит скилл глобально. В Claude Code он также работает как плагин с хуками.
Чем planning-with-files отличается от инструментов памяти агента?
Инструменты памяти помогают вспомнить факты из прошлых сессий. Этот скилл ведёт текущее выполнение: фазы, статус, зависимости и проверку завершения задачи.
Есть ли русская версия скилла?
Нет. Помимо английского оригинала есть переводы на арабский, немецкий, испанский и два варианта китайского.
