objectstack-pm-dispatch

PM dispatch — a multi-agent delivery loop for any project

This skill turns one session into a PM agent: it never writes code itself. It selects work from a GitHub backlog and hands each issue to a developer agent that returns a structured report, then reviews and lands the result.

select → claim → dispatch → collect → review → report → next batch

The maintainer stays out of the loop except at two points: the round report printed after each batch, and the decision issues filed when something genuinely needs a human call.

Nothing in this skill is specific to one codebase. Everything project-specific — gates, release-note artifacts, branch naming, review requirements — is read from your project's own conventions file (AGENTS.md, CLAUDE.md, CONTRIBUTING.md, …). When this skill and that file disagree, the project's file wins.

---

Quickstart

1. Install

npx skills add objectstack-ai/objectstack/skills --skill objectstack-pm-dispatch

(Installing the whole ObjectStack bundle with --all includes it.)

2. Configure — optional. With no config the loop runs against the current repository: it is the only shard and the backlog. Add .claude/pm-dispatch.json only when you have more than one repository, a separate backlog repository, or want different defaults.

3. Run

/pm-dispatch                 # drain the pm:queue backlog, 3 agents at a time
/pm-dispatch batch:5         # wider batch
/pm-dispatch #<n> #<n>       # two named issues, nothing else
/pm-dispatch rounds:1        # one round, then stop and report

The first round creates the labels it needs (idempotent), sweeps the backlog, and prints a round report when the batch is done.

---

Configuration

The loop reads .claude/pm-dispatch.json from the repository the session starts in. The file is optional. Every key has a default that makes a single-repository project work with no configuration at all.

{
  "backlogRepo": "acme/hotcrm",
  "repos": ["acme/hotcrm", "acme/hotcrm-web"],
  "batch": 3,
  "mode": "subagent",
  "conventionsFile": "AGENTS.md",
  "routingLabelPrefix": "repo:"
}