GravionLabs/elysion / .agents/skills/deliver
deliver
VerifiedDeliver 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/permissions.md
View on GitHub# Permissions: shell allowlists per harness
An `--unattended` run stops at the first permission prompt (spike #823, `docs/spikes/deliver.md` section 2). `deliver` and its subagents run eight kinds of shell commands; each must be on the allowlist of the harness:
| Commands | Used by |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------ |
| the verify commands of the repository's `AGENTS.md` (build, test, format, lint) | implement and fix subagents |
| `git` (`fetch`, `switch`, `worktree`, `add`, `commit`, `rebase`, `push`, `diff`, `ls-remote`, `branch`) | all |
| `gh` (`auth status`, `api`, `issue`, `pr`, `label`, `repo view`) | this session, `github-pull-request` |
| `pwsh` with `scripts/Remove-PbiWorktrees.ps1` of this skill: the path of the installed skill, e.g. `.claude/skills/deliver/…` in the project or `~/.claude/skills/deliver/…` for a global install | this session, step 8 (cleanup) |
| `pwsh` with `Get-Lessons.ps1` of the `lessons` skill: `.claude/skills/lessons/…`, `~/.claude/skills/lessons/…` or `.agents/skills/lessons/…` | implement, review and fix subagents (`implementation`, `code-review`) |
| `pwsh` with `scripts/Report-Progress.ps1` of this skill | this session, every progress line (`references/terminal-backends.md`) |
| `pwsh` with `scripts/Get-RunState.ps1` of this skill (read-only run reader) | agents with a shell that read a run (`references/loop.md`, "Reading a run") |
| `poimen-server report` | only when the run is inside a poimen terminal (`POIMEN_TERMINAL_ID`, `references/terminal-backends.md`) |
The other scripts of this skill (`Test-DeliverPreflight.ps1` at Start 3, `Get-DeliverStatus.ps1`) need `scripts/` of the installed skill as a whole: the `…/deliver/scripts/` entries below; the preflight checks them. The whole-directory entry `…/deliver/scripts/:*` also permits `Invoke-DeliverLoop.ps1` and every other script of the skill.
Replace the `pnpm` lines below with the commands of the repository's `AGENTS.md`. The deny entries block the common force-push and `--admin` forms; `deliver` needs neither, and the ruleset on `release/next` stays the real gate.
Claude Code denies any command with a quoted `$(…)` substitution even when its prefix is allowed ("Quoted text in this command can't be checked before it runs"). The same holds for any variable expansion (checked headless with `--permission-mode default`, 2026-10-29). Skill text and subagent prompts write simple commands only.
## Claude Code
`.claude/settings.json` of the repository, key `permissions.allow` (commit it, so every clone gets it). File edits of the subagents need `Edit` and `Write` here or `--permission-mode acceptEdits`.
```json
{
"permissions": {
"allow": [
"Bash(git:*)",
"Bash(gh auth status)",
"Bash(gh api:*)",
"Bash(gh issue:*)",
"Bash(gh pr:*)",
"Bash(pwsh .claude/skills/deliver/scripts/Remove-PbiWorktrees.ps1:*)",
"Bash(pwsh .claude/skills/deliver/scripts/Report-Progress.ps1:*)",
"Bash(pwsh .claude/skills/deliver/scripts/Get-RunState.ps1:*)",
"Bash(pwsh .claude/skills/deliver/scripts/:*)",
"Bash(pwsh .claude/skills/lessons/scripts/Get-Lessons.ps1:*)",
"Bash(pwsh ~/.claude/skills/lessons/scripts/Get-Lessons.ps1:*)",
"Bash(poimen-server report:*)",
"Bash(pnpm install)",
"Bash(pnpm run build)",
"Bash(pnpm test:*)",
"Bash(pnpm vitest run:*)",
"Bash(pnpm run format:*)",
"Edit",
"Write"
],
"deny": ["Bash(git push --force:*)", "Bash(git push -f:*)", "Bash(gh pr merge --admin:*)"]
}
}
```
Headless: `claude -p "/deliver <nr> --unattended"` reads the same file; `--allowedTools` adds entries for one run.
## OpenCode
`opencode.json` of the repository, key `permission.bash`. Patterns are globs; the last matching rule wins, so the catch-all comes first.
```json
{
"permission": {
"edit": "allow",
"bash": {
"*": "ask",
"git *": "allow",
"gh auth status": "allow",
"gh api *": "allow",
"gh issue *": "allow",
"gh pr *": "allow",
"pwsh *deliver/scripts/Remove-PbiWorktrees.ps1*": "allow",
"pwsh *deliver/scripts/Report-Progress.ps1*": "allow",
"pwsh *deliver/scripts/Get-RunState.ps1*": "allow",
"pwsh *deliver/scripts/*": "allow",
"pwsh *lessons/scripts/Get-Lessons.ps1*": "allow",
"poimen-server report*": "allow",
"pnpm install": "allow",
"pnpm run build": "allow",
"pnpm test*": "allow",
"pnpm vitest run *": "allow",
"pnpm run format*": "allow",
"git push --force*": "deny",
"git push -f*": "deny",
"gh pr merge --admin*": "deny"
}
}
}
```
Headless: `opencode run "/deliver <nr> --unattended"`. A rule left at `ask` stops the run.
## Copilot CLI
No project file: the allowlist is passed per run with `--allow-tool`. `shell(<command>)` should allow the command with every subcommand and argument; for `git` the trial below shows it does not. `--deny-tool` wins over `--allow-tool`. `write` allows file edits.
```powershell
copilot -p "/deliver <nr> --unattended" `
--allow-tool 'shell(git fetch)' `
--allow-tool 'shell(git switch)' `
--allow-tool 'shell(git worktree)' `
--allow-tool 'shell(git add)' `
--allow-tool 'shell(git commit)' `
--allow-tool 'shell(git rebase)' `
--allow-tool 'shell(git push)' `
--allow-tool 'shell(git diff)' `
--allow-tool 'shell(git ls-remote)' `
--allow-tool 'shell(git branch)' `
--allow-tool 'shell(gh auth status)' `
--allow-tool 'shell(gh api)' `
--allow-tool 'shell(gh issue)' `
--allow-tool 'shell(gh pr)' `
--allow-tool 'shell(gh label)' `
--allow-tool 'shell(gh repo view)' `
--allow-tool 'shell(pwsh)' `
--allow-tool 'shell(poimen-server report)' `
--allow-tool 'shell(pnpm install)' `
--allow-tool 'shell(pnpm run build)' `
--allow-tool 'shell(pnpm test)' `
--allow-tool 'shell(pnpm vitest run)' `
--allow-tool 'shell(pnpm run format)' `
--allow-tool 'write' `
--deny-tool 'shell(git push --force)' `
--deny-tool 'shell(git push -f)' `
--deny-tool 'shell(gh pr merge --admin)'
```
Trial #5 (Copilot CLI 1.0.105, `-p` mode):
- `shell(git)` covered read-only subcommands only; `git push`, `commit`, `switch`, `rebase`, `fetch`, `add`, `worktree` and `clone` were denied until each had its own `shell(git <sub>)` entry.
- The `--deny-tool` lines did not block `git push --force --dry-run origin release/next` while `shell(git push)` was allowed. The ruleset on `release/next` is the gate.
- `-p` gives up on the background CI watch after 600 s and ends before the merge. Set `COPILOT_TASK_WAIT_TIMEOUT_SECONDS=3600` for `-p` runs; `copilot --resume=<id> -p "continue"` finishes a run that ended early.
- The model per subagent is set only in `~/.copilot/settings.json` (`subagents.agents.general-purpose.model`), not per repository.
Live check of the unattended flags (Copilot CLI 1.0.105, `-p --no-ask-user`): `--allow-all-tools` alone denies `view` of paths outside the cwd (worktrees of subagents) and shell commands with URLs; adding `--allow-all-paths --allow-all-urls` allows both, in the orchestrator and in subagents. `Invoke-DeliverLoop.ps1 -Harness copilot` passes these three flags (`references/loop.md`); the per-tool list above is for runs that must stay narrower.
Keep the call in a PowerShell script of the repository so the list lives next to the code like the other two files.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |