# planning-with-files

Плагин planning-with-files хранит план задачи в task_plan.md, findings.md и progress.md на диске, чтобы агент продолжил работу после /clear, сжатия контекста или сбоя.

- плагин · `type=plugin` · Claude Code, Codex · ★ 28179 у репозитория
- Автор: OthmanAdi
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/OthmanAdi/planning-with-files
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст и 39 файлов скриптов) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/plugins/planning-with-files

## Что делает

Плагин держит план на диске, а не в контекстном окне. В проекте лежат три markdown-файла: `task_plan.md` с фазами и чекбоксами, `findings.md` с заметками и решениями, `progress.md` с журналом сессии и результатами тестов. После `/clear`, сжатия контекста или сбоя агент открывает `task_plan.md` и продолжает с текущей фазы.

Хуки жизненного цикла возвращают в контекст выбранную часть плана. Необязательный режим с проверкой завершения может попросить агента продолжать, пока план не отмечен выполненным. Он работает только на хостах, которые это умеют, и не запускает команды, записанные в Markdown. Для параллельных задач создаются каталоги `.planning/YYYY-MM-DD-slug/` с теми же тремя файлами, нужный выбирает `.active_plan`. Файлы по умолчанию попадают в gitignore.

Автоматическое восстановление читает только файлы проекта. Локальные записи сессий того же проекта открываются лишь в явном режиме catchup, и тогда плагин выдаёт счётчики или короткие фрагменты. Отправки по сети нет. По собственным замерам проекта, план на диске сократил переориентацию агента с 13.3 хода до 5.0.

## Установка

### Claude Code (родная платформа)

**Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add OthmanAdi/planning-with-files
```
В чате агента (не в терминале):
```text
/plugin install planning-with-files@planning-with-files
```

## Когда брать
- продолжить задачу с нужной фазы после `/clear`
- сохранить заметки исследования, когда контекст сжимается
- вести отдельные планы для параллельных задач
- удержать агента от остановки, пока план не закрыт
- вернуться к работе после сбоя сессии

## Примеры запросов агенту
- Используй planning-with-files: разбей миграцию на фазы и веди план в `task_plan.md`
- Продолжи работу по `task_plan.md` с текущей фазы, заметки пиши в `findings.md`
- Заведи через planning-with-files отдельный план в `.planning/` для параллельной задачи

## Похожие
- [planning](https://affpapa.org/nevibecode/skills/planning.md) — скилл · 712 установок
- [planning-and-task-breakdown](https://affpapa.org/nevibecode/skills/planning-and-task-breakdown.md) — скилл · 80700 установок
- [planning-agent](https://affpapa.org/nevibecode/skills/planning-agent.md) — скилл · 522 установки
- [planning-cadence](https://affpapa.org/nevibecode/skills/planning-cadence.md) — скилл · 491 установка
- [044-planning-jira](https://affpapa.org/nevibecode/skills/044-planning-jira.md) — скилл · 322 установки
- [043-planning-github-issues](https://affpapa.org/nevibecode/skills/043-planning-github-issues.md) — скилл · 312 установок

Из того же набора: [othmanadi/planning-with-files](https://affpapa.org/nevibecode/by/othmanadi/planning-with-files.md) — 14 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
