Planning with Files

Установка

Ручная установка

/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-files

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл заставляет агента вести план не в контекстном окне, а в трех markdown-файлах в проекте: task_plan.md с фазами и чекбоксами, findings.md с заметками и решениями и progress.md с журналом сессии. Хуки жизненного цикла на старте сессии, на отправке промпта и перед компактизацией снова подкладывают текущую фазу плана в контекст, поэтому работа не теряется после /clear, компактизации и сбоя. Восстановление читает только файлы плана в проекте, отдельный режим catchup по явной команде может прочитать локальные записи сессий того же проекта для сводных счетчиков или ограниченных выдержек. Есть режим с воротами завершения: хук Stop удерживает остановку, пока в плане остается незавершенная фаза, с лимитом и защитой от зависания. Целостность плана проверяется хешем SHA-256: изменение тела плана мимо утвержденного хеша помечается как подмена. Параллельные задачи получают отдельные каталоги плана. Ставится в Claude Code как плагин и в десятки других агентов через стандарт Agent Skills.

Для кого. Для разработчиков и тех, кто ведет через агента длинные многошаговые задачи, которые не должны сбрасываться при очистке контекста.

Пример запроса к агенту

Составь план этой задачи в файлах и продолжай с текущей фазы даже после очистки контекста

Ограничения

Полный эффект дают хуки жизненного цикла, а их регистрирует установка через плагин или через npx skills, но не пакет npm сам по себе. Ворота завершения и режим продолжения работают только на хостах, которые это поддерживают. Файлы плана по умолчанию исключены из git и лежат локально, между собой хосты их не синхронизируют. Приводимые в README цифры про число ходов восстановления авторы сами называют историческими и полученными в их собственных прогонах, а не свежим замером текущего поведения.

Как отключить. Удалите плагин planning-with-files через /plugin в Claude Code или уберите папку скилла из каталога скиллов агента. Файлы task_plan.md, findings.md и progress.md можно удалить из проекта вручную.

Проверка безопасности

• Регистрирует хуки жизненного цикла, которые запускают скрипты на каждом шаге
• Читает файлы проекта и пишет файлы плана на диск

Коротко о README

README представляет скилл персистентного планирования для кодовых агентов: план задачи хранится в трех markdown-файлах на диске, а хуки жизненного цикла подкладывают текущую фазу в контекст на каждом шаге, чтобы работа переживала /clear, компактизацию и сбои. Описаны опциональные режимы: ворота завершения удерживают остановку до готовности плана, хеш SHA-256 ловит подмену плана, автономный режим экономит токены. Подход отсылает к принципам Manus про файловую систему как рабочую память. Установка в Claude Code через плагин, в остальные агенты через npx skills и стандарт Agent Skills, есть нативные плагины для Codex, Pi, Hermes, OpenCode и DeepSeek Harness. Приведены собственные бенчмарки автора. Лицензия MIT.

SKILL.md

---
name: planning-with-files
description: "Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk; lifecycle hooks inject selected project planning context. Automatic recovery reads project planning files only. Explicit session-catchup.py --metadata reads same-project local agent session records and emits aggregate counts only; --replay may emit bounded nonce-framed excerpts. Optional gated mode can request continuation only when the host supports it and never runs commands declared in Markdown. The skill has no network upload path. Use for research or work needing 5+ tool calls."
user-invocable: true
allowed-tools: "Read Write Edit Bash Glob Grep"
metadata:
  version: "3.20.1"
---

# Planning with Files

Work like Manus: Use persistent markdown files as your "working memory on disk."

## FIRST: Restore Project State

Before continuing, resolve the plan this task owns: use the installed resolve-plan-dir script with the task's PLAN_ID and PWF_PLAN_ROOT, and read task_plan.md, progress.md and findings.md from that one selected directory. Run git diff --stat to see code changes not yet recorded in the planning files.

Похожие