SkillFoxx
Telegram

Planning with Files — скилл

Скилл держит план задачи в файлах на диске и переносит его в контекст на каждом шаге, чтобы работа переживала очистку контекста, компактизацию и сбои

  • 28 020 ★ репозитория
  • Последний коммит
  • MIT
СкиллВыбор редакции

Расширенный доступ

Почему такой уровень

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

othmanadi/planning-with-filesАвтор:Ahmad Othman Ammar Adi

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/planning-with-files

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

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

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

Что делает

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

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

Подходит, если

  • Задача многошаговая и займет несколько сессий или больше пяти вызовов инструментов
  • Нужно, чтобы агент продолжал работу после /clear, компактизации или сбоя, а не начинал заново
  • Нужно удержать агента от преждевременного вывода о завершении работы

Не подходит, если

  • Задача короткая, план не нужен
  • Агент не поддерживает хуки или стандарт Agent Skills

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

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

Ограничения

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

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

Частые вопросы

Что именно переживает /clear?

План лежит в файле task_plan.md на диске. Хук на отправке промпта снова подкладывает текущую фазу в контекст, поэтому после очистки агент продолжает с нужного места, а не переспрашивает задачу.

Скилл куда-то отправляет мои данные?

Нет. По описанию у скилла нет пути выгрузки в сеть, файлы плана остаются локально в проекте.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Скилл и хуки, которые удерживают кодового агента в рамках задачи и убирают лишнюю защиту, ненужные контрольные суммы и расползание объема

ПлагинРасширенный доступ3,9 тыс.

Скилл против зацикливания агента на служебных хешах, замках и квитанциях: сначала результат, потом проверка

СкиллРасширенный доступ185

Сборник скиллов для Codex: поэтапное планирование, параллельные субагенты, документация, браузер, 51 хук и роли агентов.

СкиллРасширенный доступ1 тыс.

MCP-сервер рисует план агента интерактивной схемой в браузере и не пускает его писать код, пока вы не нажмете «Одобрить»

MCP-серверРасширенный доступ642
Нужен VPN

Скиллы для перекрестной работы Claude Code и Codex: один агент готовит план, второй его разбирает, затем идет сборка и независимая проверка кода

СкиллРасширенный доступ3,4 тыс.

Рабочая папка для Claude Code: хуки с локальной Ollama определяют тип проекта, подбирают скиллы и напоминают вести документацию

ВоркфлоуРасширенный доступ307

Из блога

Коротко о README

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

Бейдж для README

Исходный 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.

Сообщить о проблеме