Repolode
OthmanAdi

OthmanAdi/planning-with-files

Навык планирования на основе файлов для AI coding agents: планы задач хранятся на диске и переживают сброс контекста, /clear и сбои.

Звёзды
27,923
Форки
2,313
Открытые issues
11
Последний коммит
3 дня назад

Что это?

Planning with Files — это навык для AI coding agents, который хранит план задачи, заметки по исследованию и ход выполнения в трёх markdown-файлах в проекте: task_plan.md, findings.md и progress.md. Поскольку состояние сохраняется на диске, а не в контекстном окне, агент может продолжить с текущего этапа после /clear, сжатия контекста или сбоя.

Lifecycle hooks повторно добавляют контекст активного плана в начале каждого хода, а проверка завершения сообщает, выполнены ли все этапы плана. Для параллельных задач можно использовать отдельные каталоги в .planning/, выбирая нужный через указатель активного плана. Автоматическое восстановление читает только файлы проекта; для чтения локальных записей сессий агента нужно явно включить режим catchup.

Навык можно установить через npx skills, маркетплейс плагинов Claude Code или npm. Для него предусмотрены нативные интеграции с Claude Code, Codex CLI, Cursor, OpenCode, Hermes Agent и другими инструментами, а также переводы на несколько языков.

Ключевые возможности

  • 01Хранит план, результаты исследования и ход выполнения в markdown-файлах проекта
  • 02Повторно добавляет активный план в каждый ход с помощью lifecycle hooks
  • 03Восстанавливает план после /clear, сжатия контекста или сбоев сессии
  • 04Проверка завершения сообщает, выполнены ли все этапы плана
  • 05Изолированные каталоги планов для параллельных задач
  • 06Устанавливается во множестве coding agents благодаря стандарту Agent Skills

Сценарии использования

  • Долгие рефакторинги или миграции, растянутые на множество сессий
  • Многоэтапные задачи программирования, в которых агенту важно не потерять ход работы после /clear
  • Ведение проверяемой истории решений и результатов тестов во время работы агента

В подборках

Темы

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

Что такое planning-with-files?
Навык планирования на основе файлов для AI coding agents: планы задач хранятся на диске и переживают сброс контекста, /clear и сбои. Planning with Files — это навык для AI coding agents, который хранит план задачи, заметки по исследованию и ход выполнения в трёх markdown-файлах в проекте: task_plan.md, findings.md и progress.md. Поскольку состояние сохраняется на диске, а не в контекстном окне, агент может продолжить с текущего этапа после /clear, сжатия контекста или сбоя.
planning-with-files можно использовать бесплатно? Какая у него лицензия?
planning-with-files распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
planning-with-files всё ещё поддерживается?
Активно поддерживается. Последний коммит в planning-with-files — 4 нояб. 2026 г..
Для чего можно использовать planning-with-files?
Долгие рефакторинги или миграции, растянутые на множество сессий Многоэтапные задачи программирования, в которых агенту важно не потерять ход работы после /clear Ведение проверяемой истории решений и результатов тестов во время работы агента
Где скачать planning-with-files?
Исходный код и инструкции по установке — на GitHub: https://github.com/OthmanAdi/planning-with-files

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Порт стека Cursor-навыков pstack от Poteto: структурированные процессы для задач программирования в Claude Code, Codex, Copilot, Pi и других агентных средах.

4,1 тыс.+445 за неделю370JavaScriptMITАктивно поддерживаетсяОбновлён 20 часов назад