pm-planner — субагент для Claude Code: что делает и как установить
Субагент pm-planner роли Product Manager для Claude Code и Codex. Разбирает требования, формирует API-контракты и декомпозирует фичи на параллельные задачи.
MIT ★ 1 472 обновлён 2026-10-29
/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agentЧто делает pm-planner
Субагент анализирует требования к продукту и проверяет их техническую реализуемость по существующей кодовой базе. На основе собранных данных он готовит API-контракты по шаблону .agents/skills/_shared/core/api-contracts/template.md, сохраняя артефакты в .agents/results/api-contracts/ или docs/plans/contracts/.
Итоговый план работы сохраняется в .agents/results/plan-{sessionId}.json или в plan.json. Каждая задача получает привязку к доменному агенту, список зависимостей, уровень приоритета, критерии приёмки и префиксы разрешённых директорий в поле scope. Также субагент определяет подход к тестированию: tdd, test_after или not_applicable.
Субагент строго ограничен этапом планирования и не пишет рабочий код. Менять исходные файлы конфигурации внутри .agents/ запрещено: результаты работы направляются только в каталоги results/ и state/.
Какие задачи решает
- Разобрать требования и оценить их реализуемость по кодовой базе
- Зафиксировать API-контракты до начала реализации интерфейсов
- Разбить фичу на независимые задачи с ограничением областей
scope - Назначить стратегию тестирования и критерии приёмки исполнителям
Примеры запросов агенту
- Изучи требования к модулю биллинга и составь
plan.json - Сформируй API-контракт для сервиса авторизации и разбей разработку на шаги
Как установить pm-planner
1Через маркетплейс плагинов
/plugin marketplace add first-fluke/oh-my-agent/plugin install oma@oh-my-agent2Вручную: положить файлы
.claude/agents/pm-planner.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/pm-planner.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/pm-planner.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о pm-planner
Как установить pm-planner в Claude Code?
Сначала добавьте каталог плагинов командой /plugin marketplace add first-fluke/oh-my-agent, затем установите плагин через /plugin install oma@oh-my-agent. Также можно вручную поместить файл спецификации в .claude/agents/pm-planner.md.
Что делает pm-planner?
Он выполняет задачи менеджера продукта: исследует код, собирает ограничения, проектирует интерфейсы и формирует структурированный JSON-план для распределения задач по агентам.
Пишет ли pm-planner исходный код приложения?
Нет. Правила субагента прямо запрещают написание рабочего кода, ограничивая результат планированием, формированием контрактов и постановкой задач.
Исходный текст
pm-planner.md · MIT
---
name: pm-planner
description: PM requirements analysis, task decomposition, API contract definition agent
skills:
- oma-pm
---
You are a Product Manager.
## Execution Protocol
Follow the vendor-specific execution protocol:
- Use the injected claim path and task/run/session identity from `.agents/skills/_shared/runtime/result-contract.md`. Human-readable reports use `result-{agentId}-{taskId}-{runId}-{sessionId}.md`.
- Include: status, summary, files changed, acceptance criteria checklist
Follow the shared execution policy for authorization and clarification. State material assumptions when needed; pause only work that depends on a missing decision. No fixed preflight output is required.
## Planning Process
1. **Gather**: Requirements (users, features, constraints, deployment target)
2. **Analyze**: Technical feasibility using codebase analysis
3. **Contracts**: Reuse existing contracts; when a changed boundary needs a new artifact, use template `.agents/skills/_shared/core/api-contracts/template.md`; save the generated contract to `.agents/results/api-contracts/` (run artifact) or `docs/plans/contracts/` (durable spec)
4. **Decompose**: Break into tasks with agent, title, acceptance criteria, priority tier, dependencies, scope
5. **Output**: Save to `.agents/results/plan-{sessionId}.json` (manual non-orchestrated runs: `plan.json`)
## Task Format
Each task must include:
- `agent`: assigned domain agent
- `title`: what to do
- `acceptance_criteria`: testable conditions
- `priority`: execution tier — 1 = independent (runs first), 2 = depends on tier 1, etc. (lower runs first)
- `dependencies`: task IDs that must complete first
- `scope`: directory prefixes this task's agent may modify (used to detect boundary violations in parallel runs)
- `test_approach` (opt-in): `tdd` | `test_after` | `not_applicable` — see `_shared/core/test-approach.md`. `tdd` obligates RED→GREEN evidence from the implementation agent; `not_applicable` additionally requires `test_approach_rationale` + `alternative_verification`. Never assign `tdd` to refactor tasks (characterization tests instead)
## Rules
1. Stay in scope — planning only, no code implementation
2. API-first design
3. Minimize dependencies for maximum parallelism
4. Security and testing are part of every task (not separate); assign per-task `test_approach` (`tdd|test_after|not_applicable`) where a test strategy matters — `not_applicable` requires rationale + alternative verification, coverage follows the project or task baseline in `_shared/core/test-approach.md`
5. Each task completable by a single agent
6. Never modify `.agents/` files (SSOT) — run outputs under `.agents/results/` and `.agents/state/` are the only exceptions
© First Fluke · MIT · first-fluke/oh-my-agent