К основному содержанию
команда CX Codex

pwf · othmanadi — команда для Claude Code: планирование и установка

Команда pwf для Claude Code запускает файловое планирование задачи через три заметки. Агент подключает её по запросу спланировать работу.

MIT ★ 28 179 обновлён 2026-11-04

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-files
Открыть на GitHub

Что делает pwf

pwf запускает планирование задачи и ведёт три файла: task_plan.md для этапов, статусов и решений, findings.md для исследований и progress.md для журнала сессии. Если план уже существует, команда читает эти файлы и сохраняет их, не перезаписывая.

Для выбора плана используются скрипты из scripts/: resolve-plan-dir.sh и init-session.sh; в PowerShell есть варианты .ps1. Для новой задачи команда создаёт план в корне проекта или в отдельной папке .planning/<id>/. Если PWF_PLAN_ROOT задан, он должен быть абсолютным путём к существующему корню проекта. При нескольких планах без селектора команда останавливается и просит задать PLAN_ID=<slug>.

Какие задачи решает

  • разбить задачу на этапы и отмечать их статус
  • сохранить результаты исследования в отдельном файле
  • вести журнал работы над задачей между сессиями
  • возобновить существующий план без перезаписи файлов

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

  • Спланируй реализацию новой функции по этапам.
  • Разбери задачу и веди результаты в файлах плана.
  • Продолжи существующий план и обнови журнал сессии.

Как установить pwf

1Через маркетплейс плагинов

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

2Вручную: положить файлы

.claude/commands/pwf.md

Вызов — /pwf. Для всех проектов — ~/.claude/commands/

Вопросы о pwf

Как установить pwf в Claude Code?

Выполни команды по порядку: /plugin marketplace add OthmanAdi/planning-with-files, затем /plugin install planning-with-files@planning-with-files.

Что делает pwf?

Команда запускает файловое планирование задачи. Она ведёт task_plan.md, findings.md и progress.md, а существующие файлы плана сохраняет.

Что происходит, если найдено несколько планов?

Команда останавливается и просит выбрать план через PLAN_ID=<slug>. Без селектора она не переключается на другой план.

Исходный текст

pwf.md · MIT
---
description: "Short alias for /plan. Starts Manus-style file-based planning: task_plan.md, findings.md, progress.md. Available since v3.0.0."
---

Invoke the planning-with-files:planning-with-files skill and follow it exactly as presented to you. Treat any arguments as the task to plan.

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

If the user asked for autonomous or gated mode in their words (for example "autonomous", "gated", "don't stop until done"), initialize with `init-session.sh --autonomous` or `init-session.sh --gated` accordingly; otherwise initialize the default way.

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

Похожие слэш-команды

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →

Сначала — pwf от других авторов.

pwf OthmanAdi Команда pwf запускает рабочий процесс planning-with-files: создаёт план задачи, файл находок и файл прогресса для текущего проекта. CX Codex +1 ★ 28 179звёзд репо alan-plan tryalan-ai Скилл alan-plan проводит агента по шагам планирования: разбор задачи, уточняющие вопросы, черновик плана и сохранение артефакта в Alan. CX Codex +1 1 800установок gepetto softaworks gepetto превращает Markdown-спецификацию в план реализации: изучает тему, уточняет требования у пользователя и отправляет план на внешнюю проверку. Запускайте его до начала сложной разработки. CX Codex +1 1 600установок prd snarktank Скилл опрашивает разработчика и формирует структурированный PRD для новой фичи в файле tasks/prd-[feature-name].md. Помогает зафиксировать требования до написания кода. CX Codex +1 1 500установок plan-harder am-will Скилл превращает задачу в поэтапный план со спринтами и атомарными шагами. Срабатывает по фразе «plan harder», когда проекту требуется строгая декомпозиция. CX Codex +1 1 200установок app-brief daveebbelaar Скилл app-brief для Claude Code и Cursor создаёт одностраничный файл docs/BRIEF.md для нового приложения под macOS до написания кода. CX Codex +1 1 000установок planning davila7 Скилл planning ведёт markdown-файлы с целями, находками и логом сессии, чтобы агент не потерял задачу на длинной цепочке шагов. CX Codex +1 712установок

Из того же набора14

Весь набор →
planning-with-files Скилл planning-with-files для Claude Code и Codex хранит план, находки и прогресс сложной задачи в Markdown-файлах проекта. Организует работу над задачами с 5+ вызовами инструментов. CX Codex +1 49 300установок plan Загружает скилл planning-with-files и запускает по нему планирование в текущем проекте: инициализирует файлы плана и читает их. CX Codex +1 ★ 28 179звёзд репо plan Команда запускает файловое планирование в стиле Manus для сложных задач. Она создаёт файлы task_plan.md, findings.md и progress.md либо подхватывает уже начатый план проекта. CX Codex +1 ★ 28 179звёзд репо pwf Команда pwf запускает рабочий процесс planning-with-files: создаёт план задачи, файл находок и файл прогресса для текущего проекта. CX Codex +1 ★ 28 179звёзд репо status Команда status показывает текущую фазу проекта, процент готовности и ошибки из task_plan.md. Команда запускается для быстрой проверки прогресса без перечитывания всех рабочих файлов. CX Codex +1 ★ 28 179звёзд репо plan-doctor Команда plan-doctor проверяет, не молчат ли хуки planning-with-files: находится ли план, срабатывает ли инжект, в каком состоянии аттестация. Запускайте, когда хуки притихли. CX Codex +1 ★ 28 179звёзд репо plan-goal Команда plan-goal собирает условие завершения из task_plan.md и подставляет его в /goal, чтобы агент не остановился на середине плана. CX Codex +1 ★ 28 179звёзд репо plan-attest Команда plan-attest фиксирует содержимое task_plan.md с помощью хэша SHA-256. Хуки блокируют инъекцию плана в модель, если файл изменился без повторного подтверждения. CX Codex +1 ★ 28 179звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой