claude-engineering-plugin/plugins/compound-engineering/skills/ce-code-review/references/persona-catalog.md

Persona Catalog

21 reviewer personas organized into always-on, cross-cutting conditional, stack-specific conditional, and language/framework conditional layers, plus CE-specific agents. The orchestrator uses this catalog to select which reviewers to spawn for each review.

Always-on (4 personas + 2 CE agents)

Spawned on every review regardless of diff content.

Persona agents (structured JSON output):

Persona	Agent	Focus
correctness	ce-correctness-reviewer	Logic errors, edge cases, state bugs, error propagation, intent compliance
testing	ce-testing-reviewer	Coverage gaps, weak assertions, brittle tests, missing edge case tests
maintainability	ce-maintainability-reviewer	Coupling, complexity, naming, dead code, premature abstraction
project-standards	ce-project-standards-reviewer	CLAUDE.md and AGENTS.md compliance -- frontmatter, references, naming, cross-platform portability, tool selection

CE agents (unstructured output, synthesized separately):

Agent	Focus
ce-agent-native-reviewer	Verify new features are agent-accessible
ce-learnings-researcher	Search docs/solutions/ for past issues related to this PR's modules and patterns

Conditional (8 personas)

Spawned when the orchestrator identifies relevant patterns in the diff. The orchestrator reads the full diff and reasons about selection -- this is agent judgment, not keyword matching.

Persona	Agent	Select when diff touches...
security	ce-security-reviewer	Auth middleware, public endpoints, user input handling, permission checks, secrets management
performance	ce-performance-reviewer	Database queries, ORM calls, loop-heavy data transforms, caching layers, async/concurrent code
api-contract	ce-api-contract-reviewer	Route definitions, serializer/interface changes, event schemas, exported type signatures, API versioning
data-migrations	ce-data-migrations-reviewer	Migration files, schema changes, backfill scripts, data transformations
reliability	ce-reliability-reviewer	Error handling, retry logic, circuit breakers, timeouts, background jobs, async handlers, health checks
adversarial	ce-adversarial-reviewer	Diff has >=50 changed lines of executable code (not prose/instruction Markdown, JSON schemas, or config), OR touches auth, payments, data mutations, external API integrations, or other high-risk domains regardless of file type
cli-readiness	ce-cli-readiness-reviewer	CLI command definitions, argument parsing, CLI framework usage, command handler implementations
previous-comments	ce-previous-comments-reviewer	PR-only. Reviewing a PR that has existing review comments or review threads from prior review rounds. Skip entirely when no PR metadata was gathered in Stage 1.

Stack-Specific Conditional (4 personas)

These reviewers keep their original opinionated lens. They are additive with the cross-cutting personas above, not replacements for them.

Persona	Agent	Select when diff touches...
kieran-python	ce-kieran-python-reviewer	Python modules, endpoints, services, scripts, or typed domain code
kieran-typescript	ce-kieran-typescript-reviewer	TypeScript components, services, hooks, utilities, or shared types
julik-frontend-races	ce-julik-frontend-races-reviewer	Stimulus/Turbo controllers, DOM event wiring, timers, async UI flows, animations, or frontend state transitions with race potential
swift-ios	ce-swift-ios-reviewer	Swift files, SwiftUI views, UIKit controllers, .entitlements, PrivacyInfo.xcprivacy, .xcdatamodeld, Package.swift, Package.resolved, storyboards, XIBs, or semantic build-setting / target-membership / code-signing changes in .pbxproj

Language & Framework Conditional (5 personas)

Spawned when the orchestrator identifies language or framework-specific patterns in the diff. These provide deeper domain expertise than the general-purpose personas above.

Persona	Agent	Select when diff touches...
python-quality	ce-kieran-python-reviewer	Python files, FastAPI routes, Pydantic models, async/await patterns, SQLAlchemy usage
fastapi-philosophy	ce-tiangolo-fastapi-reviewer	FastAPI application code, dependency injection, response models, middleware, OpenAPI schemas
typescript-quality	ce-kieran-typescript-reviewer	TypeScript files, React components, type definitions, generic patterns
frontend-races	ce-julik-frontend-races-reviewer	Frontend JavaScript, Stimulus controllers, event listeners, async UI code, animations, DOM lifecycle
architecture	ce-architecture-strategist	New services, module boundaries, dependency graphs, API layer changes, package structure

CE Conditional Agents (design, migration & external review)

These CE-native agents provide specialized analysis beyond what the persona agents cover. Spawn them when the diff includes database migrations, schema.rb, data backfills, design documents, or when the PR originates from specific platforms.

Agent	Focus	Select when...
ce-design-conformance-reviewer	Surfaces deviations between the diff and the repo's design docs or implementation plan	The repo contains design documents (docs/, docs/design/, docs/architecture/, docs/specs/) or an active plan matching the current branch
ce-schema-drift-detector	Cross-references schema.rb changes against included migrations to catch unrelated drift	The diff includes migration files or schema.rb
ce-deployment-verification-agent	Produces Go/No-Go deployment checklist with SQL verification queries and rollback procedures	The diff includes migration files, schema.rb, or data backfills
ce-zip-agent-validator	Pressure-tests zip-agent review comments for validity against full codebase context	The PR URL contains git.zoominfo.com

Selection rules

1. Always spawn all 4 always-on personas plus the 2 CE always-on agents.
2. For each cross-cutting conditional persona, the orchestrator reads the diff and decides whether the persona's domain is relevant. This is a judgment call, not a keyword match.
3. For each stack-specific conditional persona, use file types and changed patterns as a starting point, then decide whether the diff actually introduces meaningful work for that reviewer. Do not spawn language-specific reviewers just because one config or generated file happens to match the extension.
4. For each language/framework conditional persona, check whether the diff touches language or framework-specific patterns that warrant deeper domain expertise. These are additive with stack-specific personas, not replacements.
5. For CE conditional agents, spawn when applicable: migration files (db/migrate/*.rb, db/schema.rb) or data backfill scripts trigger ce-schema-drift-detector and ce-deployment-verification-agent; design documents or active plans trigger ce-design-conformance-reviewer; PR URLs containing git.zoominfo.com trigger ce-zip-agent-validator.
6. Announce the team before spawning with a one-line justification per conditional reviewer selected.