Skip to content

Review System

review-pr, review-plan, and review-work-item share a multi-lens review system. Each lens is a specialised subagent (the reviewer agent) that evaluates the artefact through a specific quality perspective; the orchestrating skill compiles the lens outputs into one analysis.

Code review lenses (used by review-pr and review-plan):

LensFocus
ArchitectureModularity, coupling, dependency direction, structural drift
Code QualityComplexity, design principles, error handling, code smells
CompatibilityAPI contracts, cross-platform, protocol compliance, deps
CorrectnessLogical validity, boundary conditions, state management, concurrency
DatabaseMigration safety, schema design, query correctness, integrity
DocumentationDocumentation completeness, accuracy, audience fit
PerformanceAlgorithmic efficiency, resource usage, concurrency, caching
PortabilityEnvironment independence, deployment flexibility, vendor lock
SafetyData loss prevention, operational safety, protective mechanisms
SecurityOWASP Top 10, input validation, auth/authz, secrets, data flows
StandardsProject conventions, API standards, naming, accessibility
Test CoverageCoverage adequacy, assertion quality, test pyramid, anti-patterns
UsabilityDeveloper experience, API ergonomics, configuration, migration paths

Work item review lenses (used by review-work-item):

LensFocus
CompletenessSection presence, content density, type-appropriate content
TestabilityMeasurable criteria, verifiable outcomes, verification framing
ClarityUnambiguous referents, internal consistency, jargon handling
ScopeRight-sizing, decomposition, orthogonality
DependencyImplied couplings — blockers, consumers, external systems

Lenses are automatically selected based on scope, or you can specify focus areas:

/review-pr 123 focus on security and architecture
/review-work-item 0042 focus on testability

See the Configuration page for enabling, disabling, or adding custom lenses.