# GitNexus PR Reviewer Swarm (cross-CLI)

A coordinated, **read-only** production-readiness PR review for GitNexus, runnable from any
AI coding CLI. Seven specialized review personas produce one structured, evidence-grounded
review.

## Single source of truth

All review logic lives here and is shared by every CLI — edit these, not the per-CLI wrappers:

```
pr-swarm-review/
  orchestration.md      # coordinator contract: Swarm vs Solo modes, lanes, classifications, output structure
  personas/             # the 7 canonical persona prompts (role + rules + output sections)
    01-pr-facts-historian.md       (model tier: sonnet)
    02-branch-hygiene-reviewer.md  (model tier: haiku)
    03-risk-architect.md           (model tier: sonnet)
    04-test-ci-verifier.md         (model tier: haiku)
    05-security-boundary-reviewer.md (model tier: sonnet)
    06-docs-dod-reviewer.md        (model tier: sonnet)
    07-synthesis-critic.md         (model tier: sonnet)
  README.md             # this file
```

Per-CLI entrypoints are **thin wrappers** that read the files above at runtime. Only
Claude Code has first-class parallel subagents (**Swarm mode**); every other CLI runs the
same lanes sequentially in one agent (**Solo mode**) with an identical output contract.

## Invoke it from your CLI

| CLI | How to invoke | Adapter file |
|-----|---------------|--------------|
| **Claude Code** | `/gitnexus-pr-swarm-review <PR>` (Swarm mode; dispatches the 7 `gitnexus-*` subagents) | `.claude/skills/gitnexus-pr-swarm-review/SKILL.md` + `.claude/agents/gitnexus-*.md` |
| **Gemini CLI** | `/gitnexus-pr-swarm-review <PR>` | `.gemini/commands/gitnexus-pr-swarm-review.toml` |
| **GitHub Copilot** | `/gitnexus-pr-swarm-review` (then paste the PR) | `.github/prompts/gitnexus-pr-swarm-review.prompt.md` |
| **Cursor** | `/gitnexus-pr-swarm-review` (then paste the PR) | `.cursor/commands/gitnexus-pr-swarm-review.md` |
| **Codex CLI** | Ask: "run the GitNexus PR swarm review for <PR>" (Codex reads `AGENTS.md`) — or install the user-level prompt below | `AGENTS.md` § PR Swarm Review |
| **Any AGENTS.md-aware agent** | Ask it to "follow `pr-swarm-review/orchestration.md` for <PR>" | `AGENTS.md` § PR Swarm Review |

### Codex (optional user-level slash command)

Codex prompts are user-level only (not repo-shareable). To get a `/gitnexus-pr-swarm-review`
slash command, create `~/.codex/prompts/gitnexus-pr-swarm-review.md`:

```markdown
---
description: GitNexus production-readiness PR swarm review (Solo mode)
argument-hint: <PR URL or number>
---
Read `pr-swarm-review/orchestration.md` in this repo and run it in **Solo mode** for $ARGUMENTS.
You are single-agent: adopt each persona in `pr-swarm-review/personas/` in dependency order,
then self-critique with lane 7 before emitting the review. Stay read-only.
```

## Key properties

- **Read-only.** No persona edits files, commits, or posts to GitHub. Each enforces an
  explicit permitted/prohibited Bash list.
- **Evidence-grounded.** Every finding cites files, line ranges, checks, issue/PR refs, or commands.
- **Missing visibility becomes verification work** rather than invented facts.
- **Manually invoked.** No hooks or automatic triggers.

## Extending to a new CLI

Add one thin wrapper for the CLI's command/prompt format whose body says: *read
`pr-swarm-review/orchestration.md` and run it (Swarm mode if the runtime has parallel
subagents, else Solo mode)*. Do not copy the persona/orchestration text into the wrapper.

## Relationship to the existing review skill

This coexists with `/gitnexus-review` (a graph-backed review for PRs, branches,
ranges, or local changes using GitNexus MCP tools; it scales from one pass to
per-domain expert lenses derived from the graph's clusters). This swarm is the
fixed-roster, multi-persona deep production-readiness review.
