orc

Answer reviewer comments on YOUR open PR — categorize unresolved threads, push fixes, and post replies. Workspace-aware across linked PRs.

Author an Architecture Decision Record (ADR) — produce a numbered docs/adr/NNNN-*.md following the orc:adr-writing template. Also handles supersession and status transitions on existing ADRs.

Clean up after completed or abandoned orc sessions — removes workspace state, registry entry, git worktree, and optionally the merged branch. Destructive; always previews and asks first. Workspace-aware.

Review someone else's open GitHub PR — posts a real PR review with line-anchored inline comments and suggestions. Verdict computed mechanically from severities; mandatory preview gate before posting. Workspace-aware across linked PRs. For your OWN working diff, prefer the bundled /code-review instead.

Systematic root-cause investigation, then fix with TDD — never proposes a fix before finding the cause. Writes a resumable diagnosis to .orc/ state plus a regression test; --jira <KEY> links a ticket. Workspace-aware across sibling repos. For a quick one-off look without session state, prefer the bundled /debug.

Applies a defined list of code changes, runs the project's test suite, and reports a diff. Used by /orc:address to execute reviewer-requested fixes, or any context where a list of changes is already decided and just needs to be made cleanly.

Long-running root-cause investigation for hard bugs and unexpected behavior. Use when a bug needs disciplined isolation — reproduction, hypothesis, instrumentation, regression-testing — before any fix is attempted. Maintains an isolated context and produces a written diagnosis the implementing engineer can act on.

Provisions a fast, reproducible dev environment for QA or standalone use — detects existing Docker setup (compose > devcontainer > Dockerfile), generates a minimal compose when none exists (hybrid by default: services in containers, app on host), boots with healthcheck-gated readiness, and writes docker-env-state.json + an evidence packet to .orc/<branch>/files/env/. Falls back to host-mode boot when Docker is unavailable — never hard-blocks QA. Dispatched by /orc:env, /orc:qa Phase 4, and /orc:flow Phase 6.

Senior-developer agent that implements a defined slice list from a plan + failing test(s). Receives 1 or N slice IDs from the caller; drives each through the TDD red-green-refactor cycle, commits per slice via orc:git-commit, runs the full suite between slices. Default executor in /orc:flow Phase 5 (single instance for sequential slices, multiple parallel instances for parallel-safe slices). Also dispatched by /orc:fan-out for plan-slice-shaped tasks. Escalates back to the user when a slice is ambiguous, requires a new dependency, or can't be made green after a bounded number of attempts.

Reviews someone else's open GitHub PR end-to-end. Fetches diff via gh CLI, walks every changed file, and returns structured findings as JSON for the /orc:code-review command's posting layer to convert into inline GitHub PR comments. Used by /orc:code-review.

Author and update Architecture Decision Records (ADRs) — the durable record of a decision and its trade-offs, in docs/adr/NNNN-*.md. Use to lock in an architectural decision or to supersede an ADR.

Browser automation CLI for AI agents; use for web tasks - navigate, click, fill forms, screenshot, scrape, test web/Electron apps.

Implement Clean, Hexagonal (Ports & Adapters), and Domain-Driven architecture patterns. Use when designing service layers, refactoring monoliths into bounded contexts, or fixing layer dependency cycles.

Ultra-compressed, signal-only pull request descriptions. Use when opening a PR or when the user says "write a PR description", "PR body", "draft the PR", or invokes /caveman-pr.

Ultra-compressed code review comments — one line per finding: location, problem, fix. Use when the user says "review this PR", "code review", "review the diff", "/review", or invokes /caveman-review.

9 hooks across 4 events