Skip to content

GravionLabs/elysion / .agents/skills/deliver

deliver

Verified

Deliver a PBI, Bug, Feature or Epic item by item with subagents (implement, review, PR, CI, merge). Use for "/deliver 12" or "deliver feature 7".

references/help.md

View on GitHub
# /deliver

## Usage

```
/deliver <nr> [<nr> …] [--milestone <name>] [--unattended] [--inline] [--max <n>]
/deliver status --milestone <name>
/deliver help
```

`/deliver status --milestone <name>` prints the status block (progress, delivered, ready, waiting, needs you, release state, next milestone; at most 10 lines) without delivering. `deliver` prints it after each PBI too; `pwsh scripts/Get-DeliverStatus.ps1 -Milestone <name> [-Delivered <nr…>] [-Text]` produces it as JSON or text.

Delivers the open PBIs and Bugs of the given issues in dependency order: a subagent implements (`implementation`), a subagent reviews (`code-review`, at most 2 fix rounds), then PR into `release/next`, required checks, squash merge, close. State lives in GitHub only; run it again to continue.

## Arguments and flags

- `<nr> [<nr> …]`: PBI, Bug, Feature or Epic numbers; each open PBI or Bug below them is delivered once. Missing: asked once.
- `--milestone <name>`: adds the open PBIs and Bugs of that milestone. Name it `M<n>`: `M4` finds the title `M4` and, after `github-milestone close`, `M4 (0.2.0)`; legacy titles such as `1.3.0` still work. When all are delivered, `github-release finish` opens the release PR into `main` after a release review; it is never merged by `deliver`. After that PR is merged and tagged, run `/github-milestone close M<n>`.
- `--unattended`: never asks. A pause comments on the issue, adds `needs-decision` and goes on with the next independent PBI. Interactive (default): a pause or a blocked PBI asks in the chat (retry, skip or an instruction).
- `--inline`: deliver all PBIs in this session. Without it an interactive run over more than `deliver.loopThreshold` (default 3) PBIs starts the loop and stays a control session (`references/control.md`). `--no-preflight` skips the preflight (skills, allowlist, stale worktrees; `references/preflight.md`).
- `--max <n>`: stops after `n` delivered, blocked or paused PBIs and prints the report.
- Skipped: `needs-decision`; `needs-refinement` (hint `planner refine <nr>`); `interactive` (unattended only; `/deliver <nr>` in a session delivers it); PBIs claimed by another session.
- `help`, `--help`, `-h`: print this file. Feedback in an interactive run becomes one `[Bug]` or `[PBI]` per finding in the milestone after you confirm (`references/feedback.md`).

### Loop script

One fresh `claude -p "/deliver … --unattended --max 1"` (`copilot -p …` with `-Harness copilot`) per PBI:

```powershell
pwsh scripts/Invoke-DeliverLoop.ps1 -Target 12,14 -Milestone M4 -Max 5
pwsh scripts/Invoke-DeliverLoop.ps1 -Milestone M4 -Harness copilot -Model gpt-5
```

- `-Target <nr…>`: issue numbers, as `<nr>` above
- `-Milestone <name>`: as `--milestone` (`M<n>`, before and after the rename)
- `-Max <n>`: stop after `n` iterations
- `-Model <name>`: overrides the model for every PBI (default: per PBI by tier, fast haiku, standard sonnet, strong opus; copilot: `auto`)
- Shell command `deliver-loop` (offered by `skills-manage`) runs the installed script from any directory of the repository, always in the git toplevel (so logs and state live in the repository root; outside a git repository it keeps the current directory), with the same flags, e.g. `deliver-loop -Milestone M4 -Max 5`. In herdr it opens the workspace `<repo> · deliver` (tab `deliver-loop`).
- Also `-LogPane` (opens the herdr log pane; off by default, `-NoPane` is a deprecated no-op) and `-NoColor` (no `.ansi.log`, plain stdout). Stdout is colored on a terminal. Exit 0 done or max reached, 1 no progress, 2 blocked, 64 bad arguments.

## Examples

```
/deliver 42
/deliver 7 9 11
/deliver --milestone M4
/deliver 7 --unattended --max 3
```

## Config

`.agents/config.json`:

- `deliver.roles`: model and effort per subagent role (`implement`, `review`, `fix`, `release-review`; `tiers` for `implement` and `fix`); see `references/roles.md`.
- `governance`: switches on decision PBIs and spec notes; see `references/governance.md`.

## See also

- `references/loop.md`, `references/claim.md`, `references/release-review.md`, `references/permissions.md`
- `planner` (refine, plan), `github-milestone`, `github-release`
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall