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/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.
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