plan · othmanadi — команда для Claude Code: что делает и как установить
Команда запускает файловое планирование в стиле Manus для сложных задач. Она создаёт файлы task_plan.md, findings.md и progress.md либо подхватывает уже начатый план проекта.
MIT ★ 28 179 обновлён 2026-11-04
/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-filesЧто делает plan
При запуске команда обращается к навыку planning-with-files:planning-with-files и проверяет сохранённые задачи. Каталог вычисляет скрипт resolve-plan-dir.sh (в PowerShell — resolve-plan-dir.ps1). Если найдена активная папка, агент считывает task_plan.md, findings.md и progress.md, не перезаписывая созданные ранее файлы.
Для новой задачи запускается скрипт init-session.sh, создающий изолированный каталог .planning/<id>/. Роли файлов строго разделены: в task_plan.md фиксируются фазы и решения, findings.md хранит выводы исследований, а progress.md ведёт журнал сессии. Каждый заголовок ### Phase N: Name обязан содержать ровно одну строку **Status:**.
План проверяется скриптом check-complete.sh --validate. Если в каталоге накопилось несколько задач без селектора, скрипт завершится статусом PWF_PLAN_AMBIGUOUS_V1, поэтому для продолжения работы агенту понадобится переменная PLAN_ID=<slug>.
Какие задачи решает
- разбить сложную разработку на фазы с отслеживанием статусов в task_plan.md
- сохранять результаты исследований в findings.md отдельно от рабочего кода
- вести журнал выполнения сессий в progress.md без потери контекста
- возобновить работу над существующей задачей без перезаписи файлов плана
Примеры запросов агенту
- /plan
- /planning-with-files:plan
- Запусти планирование новой задачи через /plan
Как установить plan
1Через маркетплейс плагинов
/plugin marketplace add OthmanAdi/planning-with-files/plugin install planning-with-files@planning-with-files2Вручную: положить файлы
.claude/commands/planning-with-files-plan.mdВстроенная /plan перекрывает файл с тем же именем, поэтому файл назван иначе. Вызов — /planning-with-files-plan. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/plan.mdВызов — /prompts:plan. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/plan.prompt.mdВручную: положить файлы
.gemini/commands/plan.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о plan
Как установить plan в Claude Code?
Для установки через маркетплейс выполните /plugin marketplace add OthmanAdi/planning-with-files, затем /plugin install planning-with-files@planning-with-files.
Что делает команда plan?
Она организует сессионное планирование через файлы task_plan.md, findings.md и progress.md. Это помогает агенту следовать фазам работы и фиксировать выводы.
Что происходит при наличии нескольких планов?
Скрипт resolve-plan-dir.sh выдаёт статус PWF_PLAN_AMBIGUOUS_V1 и останавливает запуск. Чтобы агент продолжил работу, нужно явно задать переменную PLAN_ID=<slug>.
Исходный текст
plan.md · MIT
---
description: "Start Manus-style file-based planning. Creates task_plan.md, findings.md, progress.md for complex tasks."
---
Invoke the planning-with-files:planning-with-files skill and follow it exactly as presented to you.
Restore before creating. If `PWF_PLAN_ROOT` is set, validate it as an absolute existing project root; refuse an invalid root pin before reading or creating files. Otherwise the project root is the current directory. Resolve the selected task with `sh ${CLAUDE_PLUGIN_ROOT}/scripts/resolve-plan-dir.sh` (PowerShell: `& "$env:CLAUDE_PLUGIN_ROOT\scripts\resolve-plan-dir.ps1"`):
- A printed directory is the selected task. Resume it: read its `task_plan.md`, `findings.md`, and `progress.md` and preserve them; never overwrite existing planning files.
- Empty output with non-empty `PLAN_ID` means the plan selector was rejected. Stop and ask the user to correct the pin. Do not fall back to the root or another plan.
- Empty output where `resolve-plan-dir.sh --check-ambiguity` (PowerShell: `-CheckAmbiguity`) prints `PWF_PLAN_AMBIGUOUS_V1` means multiple plans exist without a selector. Stop and ask the user to set `PLAN_ID=<slug>`.
- Otherwise empty output is the legacy project-root convention: resume `task_plan.md` from the validated project root (`PWF_PLAN_ROOT` when set), if it exists. A valid root pin alone does not reject a legacy root plan.
Only for a new task, run the initializer from the validated project root, including when `PWF_PLAN_ROOT` points away from the host cwd: `sh ${CLAUDE_PLUGIN_ROOT}/scripts/init-session.sh` (PowerShell: `init-session.ps1`). Pass a task name for an isolated `.planning/<id>/` plan and pin the host with its printed `PLAN_ID`. `.planning/.active_plan` is a shared default; it does not bind a parallel session.
- `task_plan.md`: for phases, progress, and decisions
- `findings.md`: for research and discoveries
- `progress.md`: for session logging
Keep each `### Phase N: Name` heading with exactly one `**Status:**` line, then validate the selected plan's explicit path with `sh ${CLAUDE_PLUGIN_ROOT}/scripts/check-complete.sh --validate path/to/task_plan.md` (PowerShell: `check-complete.ps1 -Validate -PlanFile path/to/task_plan.md`). If an existing plan fails validation, report it instead of rewriting it.
Then guide the user through the planning workflow.
© OthmanAdi · MIT · OthmanAdi/planning-with-files
Похожие слэш-команды
Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →Сначала — plan от других авторов.