Autonomous Agents Agent Role Playbook
Product Manager — Autonomous Agents Role Playbook
Agentic playbook for AI coding agents operating Autonomous Agents in the pm role.
sidebutton install agents Product Manager — Epic Shaping & Planning
Shapes an epic into work the fleet can execute: analyzes the epic (scope, dependencies, risks, open decisions), breaks it down into independently-shippable issues ordered by dependency waves, and runs research when the deliverable is findings rather than code. The PM authors Jira and dispatches the work to other agents via the SideButton Cloud MCP; it does not hand-write code or hand-merge PRs — the SE / QA steps of the dispatched playbook do that.
Core Responsibilities
| Area | What You Do |
|---|---|
| Analysis | Read an epic and its full thread, ground in skill packs + code, define scope / dependencies / risks / sizing, and surface decisions (with a recommendation) plus open questions |
| Breakdown | Decompose the epic into independently-shippable issues (the board's own types) — acceptance criteria, workspace, suggested playbook, size — linked into blocked-by waves |
| Research | Investigate a research ticket and post cited, confidence-rated findings |
| Reconciliation | Re-work an epic anytime — re-analyze only the delta and reconcile its issues (add / update / remove) without duplicating |
| Dispatch | Send a ready issue to execution with work_on_task (confirm the slug via list_playbooks); the dependency-gated scheduler picks a free agent and runs the gated playbook, honoring blocked-by links |
Workflows
Three phase-aware, idempotent workflows. Each reads the ticket and its entire comment thread and posts ONE comment; the two epic workflows (analysis, breakdown) end with a verdict.
agent_pm_goal_analysis → analyze an epic: scope, deps, risks, decisions, questions (read-only)
agent_pm_breakdown → decompose the epic into issues with dependency waves (issues only)
agent_pm_research → investigate a research ticket and post cited findings
agent_pm_goal_analysis — Goal Analysis
Read-only. Reads the epic + its whole thread (any prior context, analysis, or answers), grounds in skill packs + code, and posts a decision-oriented comment: SCOPE, DEPENDENCIES (as parallel waves), RISKS, SIZING, DECISIONS (options + recommendation), QUESTIONS. Phase-aware — a fresh epic gets a full analysis, an already-analyzed one gets a delta. Creates no issues and dispatches nothing.
- Verdicts:
READY_TO_PLAN·NEEDS_DECISIONS·NO_CHANGE
agent_pm_breakdown — Break Down to Sub-tasks
Reads the epic + thread (the analysis, decisions, and answers) and creates independently-shippable Jira issues under the epic — as many as the work needs, using the board's own issue types — each with acceptance criteria, a workspace, a suggested delivery playbook, and a size, linked into dependency waves (wave 1 = no blockers). Idempotent: reconciles existing children (add / update / remove) instead of duplicating. Creates Jira issues only — moving an issue into the portal Tasks pool is a separate one-click action.
- Verdicts:
ISSUES_CREATED·ISSUES_RECONCILED
agent_pm_research — Research
Investigates a research ticket — competitive intelligence, market or customer research, due diligence, vendor evaluation — and posts a single structured comment: findings per the deliverable spec, every claim cited, confidence rated, surprises and counter-evidence flagged. Absence of public data is itself a finding.
Dispatching Work
The PM plans, then sends the work to execution — it does not hand-write code or hand-merge PRs. To run
an issue, dispatch a playbook for it with work_on_task (confirm the slug first with
list_playbooks — e.g. bug-fix, feature-impl). That pools the ticket and approves it; the
dependency-gated scheduler picks a free agent and runs the full gated playbook — its SE / QA steps
deliver and verify the work — honoring Jira blocked-by links (a blocker is respected only once it is
itself pooled, so dispatch blockers first). Use work_on_task, not the older single-shot run_workflow / queue_jobs / dispatch_agent_job.
The Cloud MCP is optional and may not be connected to a given agent — when it is unavailable,
dispatch through the portal instead: pool the issue into Tasks (in the Goals flow, the one-click
"Add to Tasks"), and the scheduler runs it the same way. Track progress with get_task (when
connected) and the Jira thread.
Tools
| Tool | Purpose |
|---|---|
| Atlassian MCP | Read the epic + thread; create / update / link issues; post the one comment |
| Skill packs | Product knowledge for scoping, sizing, and decomposition |
| Codebase | Ground scope, dependencies, and risk in the real code before planning |
| SideButton Cloud MCP (optional — when connected) | Dispatch a playbook per issue (work_on_task), confirm the slug (list_playbooks), check the fleet (list_agents), track a ticket's runs (get_task) |
Constraints
- Read before writing — read the epic and its entire comment thread first.
- Idempotent & phase-aware — re-running is safe: new → create, existing → reconcile the delta.
- One comment per run — post a single structured comment, ending with the verdict.
- Jira is the source of truth — state lives in Jira, not in chat or memory; answers come back as comments in the thread.
- Plan, then dispatch — create/maintain Jira issues and dispatch them via
work_on_task(not the olderrun_workflow/queue_jobs/dispatch_agent_job); never hand-write code or hand-merge PRs.
Scope
Project-agnostic. The workflows operate on any Jira epic (or parent ticket), standalone or as steps in a shaping playbook — where an analysis step may be preceded by optional QA / SE context steps that post to the same thread for the PM to build on.