
Run the full deep quality gate after completing an implementation phase — review, fix, test, report, squash-commit. Principal approval REQUIRED before commit (phase boundary is NOT auto-approved). Auto-emits phase-complete dispatch to captain for PR landing.
Read a dispatch and mark it as read — works from any branch or worktree
Manage dispatches — list, read, fetch, reply, create, resolve
Run a quality gate before creating a PR — review, fix, test, report, produce QGR receipt
Structured flag review — categorize, approve, dispose. Three-bucket triage for accumulated flags.
Quick-capture observations to a queue for later follow-up or 1B1 discussion
Git Commit Message Generator — QG-aware wrapper
Write a session handoff using the handoff tool — archive, write, verify
Classify git diffs as formatting-only vs substantive changes.
Run the quality gate after completing an iteration — review, fix, test, report, auto-commit. No principal approval needed (iteration boundary is auto-approved). Auto-emits a structured dispatch to captain so the small-batch-cadence daemon can pick up for PR landing.
Captain-only. Quality-check, commit, push, create PR, and cut a release in one flow. The "code is ready" command for captain-owned branches. Every PR is a release. Formerly `/release` — v2 rename to captain-actor-verb.
Monitor GitHub Actions CI status via background streaming — replaces email notifications
Event-driven dispatch monitoring via Monitor tool — replaces /loop polling
Onboard a new principal to the current repo — scaffold sandbox, register agent, write CLAUDE-PRINCIPAL.md, mutate agency.yaml, bootstrap captain handoff. The discoverable end-to-end command for adding a person to an agency repo.
Review a PR and post comments after approval. Does NOT make code changes.
Complete a plan — final deep QG, finalize artifacts, produce Reference doc
File, view, comment on, and close issues against the-agency framework on GitHub. Two-way channel with persisted local audit trail in `usr/{principal}/reports/`.
Run after a PR is merged on GitHub. Verifies merge, merges origin into master, invokes /sync-all.
--- name: pr-captain-land description: Captain-only. Land an agent's prepared branch — switch, verify receipt, bump agency_version, create PR, watch CI, merge, release, notify agent. The single-writer serialization point for agency_version and PR creation. Companion to /pr-submit (the-agency#296 Phase 1 pilot). The `captain-` qualifier in the name signals scope at a glance (complements `paths: []` scoping and the Step-1 runtime precondition). agency-skill-version: 2 when_to_use: Captain on maste
Captain-only. Merge a PR safely — true merge commit (never squash, never rebase), branch protection respected, --principal-approved gate for --admin override. Prevents the "accidentally squashed via the wide GitHub UI button" failure mode that has burned the fleet.
Captain-only. After a PR has merged on GitHub, verify the merge, merge origin/master locally, sync all worktrees, create the GitHub release (every PR is a release), and clean up the PR branch. Formerly `/post-merge` — v2 rename to noun-actor-verb.
Create a new workstream with scaffolded artifacts, agent registrations, and optional worktree
Review PVR, A&D, and Plan before starting a new phase — highlight findings, discuss decisions
Fleet health check across three dimensions — workstream, agent, worktree. Reports severity (healthy/attention/warning/critical) and sets exit codes for CI integration. Run this when you want to know "is the fleet OK right now?" — at session start, before a release, or after any disruption.
Run the quality gate — parallel agent review, fix cycle, test, report. Composable — called by /iteration-complete and /phase-complete.
Merge a PR safely — true merge commit (never squash, never rebase), branch protection respected, --principal-approved gate for --admin override.
Add a frontend app (Next.js) to an existing workstream using a SPEC-PROVIDER starter pack
Create a new git worktree with dedicated branch and bootstrapped dev environment
Append to or read the captain's narrative log — decisions, friction, learning, milestones, observations, builds.
Quality-check, commit, push, create PR, and cut a release in one flow.
Activate a sandbox item by symlinking it to the Claude Code discovery location
Graduate a sandbox experiment to shared team-wide tooling
Create a new experimental command, hook, rule, tool, or script in your sandbox
Captain-only. Review all draft PRs (or a specified PR / project) and generate per-workstream dispatch files routing findings to worktree agents. Formerly `/captain-review` v1 — v2 migration preserves semantics.
Show all sandbox items across engineers with activation status
Captain-only. Fetch, merge origin into master, merge unique worktree work into master, and sync all worktrees. The daily rhythm command. NEVER pushes to remote. NEVER rebases. NEVER resets to origin. Formerly `/sync-all` — v2 rename to captain-actor-verb.
Show all active sandbox symlinks and their health (OK or broken)
Secret Management — set, get, list, delete, rotate, scan via configured provider
Fetch, merge origin into master, merge worktree work into master, sync all worktrees. NEVER pushes.
Clean session teardown — commit all work, write a resumption-framed handoff, stop monitors, report readiness. Leaves a clean working tree. No asking.
Monitor Claude Code changelog for new releases and features via background streaming
List past Claude Code sessions with metadata (date, branch, directory, size, first message)
Add a backend service (NestJS prototype module) to an existing workstream using a SPEC-PROVIDER starter pack
Read a past session and produce a structured summary (messages, tool calls, files, decisions)
Code review the current branch against origin/master using 7 parallel review agents with confidence scoring.
Full session startup for worktree agents — shells to session-pickup --from fresh (sync master + preflight), reports state (handoff mode, dispatch drift, monitor health), relaunches dead monitors, hands back next-action.
Set up a new engineer's sandbox workspace under usr/
Merge a target branch into the current branch and push to origin. The ONLY framework skill that pushes to a remote. Requires explicit confirmation. Never rebases. Default-actor skill (agents and captain both use it; captain for captain-* branches, agents for their worktree branches).
Real-time conversation capture — records dialogue and decisions as they happen.
Cross-repo dispatch lifecycle — check, read, resolve, reply, push. Captain-only.
Port files from a source repo to the-agency — auto path mapping, PR creation
Remove a git worktree and optionally delete its branch
List all git worktrees with status info (branch, clean/dirty, deps)
Mid-session compact prep — force-commit the handoff, flush coord work, write continuation-framed handoff, direct to /compact.
Sync worktree with master — merge, copy settings, run sandbox-sync, report changes
DEPRECATED — use `git merge <target>` or `/sync` instead. Rebase is blocked by hookify.
Fetch review comments on current PR, compose threaded replies, and resolve threads. Does NOT make code changes.
Remove a sandbox symlink to deactivate an experimental item
Try another engineer's sandbox experiment by symlinking it locally
Post-compact pickup — read continuation handoff, verify state (tree clean, monitors alive, dispatch drift), resume next-action.
Commit coordination artifacts (handoffs, dispatches, seeds, config) without QG
Crawl and extract content from configured sites using the provider engine
Run a command in a target directory without touching the parent shell's CWD. Use any time you would write "cd foo && bar" — that pattern is blocked by the block-compound-bash hookify rule.
Drive toward a complete Product Vision & Requirements (PVR) using 1B1 protocol with completeness checklist.
Agent-side signal to captain that your branch is ready for PR landing. Runs preconditions (clean tree, pushed, matching QGR receipt) then dispatches captain with a structured payload. Captain's /pr-captain-land picks it up. Replaces the distributed "agent creates PR" model with a captain-owned PR lifecycle (the-agency#296).
Deploy the project using the configured platform provider
Drive toward a complete Architecture & Design (A&D) using 1B1 protocol with completeness checklist.
Preview the current project using the configured infrastructure provider
Monitor GitHub Actions CI status via background streaming — replaces email notifications
Drive toward a complete Architecture & Design (A&D) using 1B1 protocol with completeness checklist.
Event-driven dispatch monitoring via Monitor tool — replaces /loop polling
Merge a PR safely — true merge commit (never squash, never rebase), branch protection respected, --principal-approved gate for --admin override.
Run a quality gate before creating a PR — review, fix, test, report, produce QGR receipt
Preview the current project using the configured infrastructure provider
Run the quality gate — parallel agent review, fix cycle, test, report. Composable — called by /iteration-complete and /phase-complete.
Quality-check, commit, push, create PR, and cut a release in one flow.
Review a PR and post comments after approval. Does NOT make code changes.
Run a command in a target directory without touching the parent shell's CWD. Use any time you would write "cd foo && bar" — that pattern is blocked by the block-compound-bash hookify rule.
Graduate a sandbox experiment to shared team-wide tooling
Remove a sandbox symlink to deactivate an experimental item
Set up a new engineer's sandbox workspace under usr/
Try another engineer's sandbox experiment by symlinking it locally
Secret Management — set, get, list, delete, rotate, scan via configured provider
Mid-session context refresh — commit, write handoff, then compact
Merge target into current branch and push to origin. The ONLY command that pushes.
Real-time conversation capture — records dialogue and decisions as they happen.
Create a new workstream with scaffolded artifacts, agent registrations, and optional worktree
Create a new git worktree with dedicated branch and bootstrapped dev environment
Remove a git worktree and optionally delete its branch
List all git worktrees with status info (branch, clean/dirty, deps)
Activate a sandbox item by symlinking it to the Claude Code discovery location
Create a new experimental command, hook, rule, tool, or script in your sandbox
Append to or read the captain's narrative log — decisions, friction, learning, milestones
Review all draft PRs and generate dispatch reports for routing findings to worktree agents.
Commit coordination artifacts (handoffs, dispatches, seeds, config) without QG
Manage dispatches — list, read, fetch, reply, create, resolve
Write a session handoff using the handoff tool — archive, write, verify
File, view, comment on, and close issues against the-agency framework on GitHub. Two-way channel with persisted local audit trail in `usr/{principal}/reports/`.
Fleet health check across three dimensions — workstream, agent, worktree. Reports severity (healthy/attention/warning/critical) and sets exit codes for CI integration. Run this when you want to know "is the fleet OK right now?" — at session start, before a release, or after any disruption.
Crawl and extract content from configured sites using the provider engine
Monitor Claude Code changelog for new releases and features via background streaming
Code review the current branch against origin/master using 7 parallel review agents with confidence scoring.
Cross-repo dispatch lifecycle — check, read, resolve, reply, push. Captain-only.
Drive toward a complete Product Vision & Requirements (PVR) using 1B1 protocol with completeness checklist.
Deploy the project using the configured platform provider
Classify git diffs as formatting-only vs substantive changes.
Read a dispatch and mark it as read — works from any branch or worktree
Structured flag review — categorize, approve, dispose. Three-bucket triage for accumulated flags.
Git Commit Message Generator — QG-aware wrapper
Run the quality gate after completing an iteration — review, fix, test, report, auto-commit
Quick-capture observations to a queue for later follow-up or 1B1 discussion
Run the full quality gate after completing an implementation phase — review, fix, test, report, commit
Complete a plan — final deep QG, finalize artifacts, produce Reference doc
Run after a PR is merged on GitHub. Verifies merge, merges origin into master, invokes /sync-all.
Review PVR, A&D, and Plan before starting a new phase — highlight findings, discuss decisions
Onboard a new principal to the current repo — scaffold sandbox, register agent, write CLAUDE-PRINCIPAL.md, mutate agency.yaml, bootstrap captain handoff. The discoverable end-to-end command for adding a person to an agency repo.
Fetch review comments on current PR, compose threaded replies, and resolve threads. Does NOT make code changes.
DEPRECATED — use `git merge <target>` or `/sync` instead. Rebase is blocked by hookify.
Show all sandbox items across engineers with activation status
Show all active sandbox symlinks and their health (OK or broken)
End a session cleanly — commit, write handoff, report readiness
List past Claude Code sessions with metadata (date, branch, directory, size, first message)
Read a past session and produce a structured summary (messages, tool calls, files, decisions)
Resume a worktree session — sync master, read handoff, check dispatches, report state
Fetch, merge origin into master, merge worktree work into master, sync all worktrees. NEVER pushes.
Port files from a source repo to the-agency — auto path mapping, PR creation
Sync worktree with master — merge, copy settings, run sandbox-sync, report changes