Набор навыков для AI-агента-оркестратора: он делегирует задачи установленным coding CLI, проверяет diff и сам коммитит изменения.
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 обновляется ежедневно.
Похожие проекты
Локальная долговременная память для AI-агентов разработки: хранит решения и выводы в SQLite и предоставляет их через MCP Claude Code, Cursor и другим клиентам.
Понятные навыки для Claude Code, Codex CLI, Cursor CLI и Gemini CLI: превращают отчёты агента о работе в краткий вердикт, понятный каждому.
Подборка из более чем 1 000 Agent Skills от официальных команд разработчиков и сообщества для Claude Code, Codex, Gemini CLI, Cursor и других инструментов.
Рабочий процесс разработки на основе спецификаций для AI-ассистентов, которые согласуют предложения, спецификации и задачи до написания кода.
Порт стека Cursor-навыков pstack от Poteto: структурированные процессы для задач программирования в Claude Code, Codex, Copilot, Pi и других агентных средах.