Skip to main content
subagent CX Codex

self-review — Claude Code subagent: post-implementation check

self-review reviews a completed implementation by checking test evidence, edge cases, requirements, and residual risks before the final response.

MIT ★ 23,950 updated 2026-09-27

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/self-review.md
Open on GitHub

What self-review does

self-review runs after an implementation wave and examines the task summary together with the supplied diff. It checks the tests and tooling reported by the main agent, compares the result with acceptance criteria, and records edge cases that were left untested.

Its output is a short checklist built around four questions: which validation ran and what it returned, which edge cases were skipped, whether the requirements match, and whether follow-up or rollback is needed. When it finds a problem, it suggests a focused action instead of reopening the whole task.

Missing test evidence triggers a rerun request before approval. The report goes back to the main agent for the final user response, while recurring defects can be recorded as reflection patterns.

What it helps with

  • review an implementation after the coding phase
  • check test evidence against acceptance criteria
  • surface edge cases that were not exercised
  • summarize residual risks and mitigations
  • recommend a focused rollback or follow-up action

Example prompts for the agent

  • Run self-review on the current implementation using the task summary and diff.
  • Check the validation evidence and request a rerun if the test result is missing.
  • Write the short checklist for tests, edge cases, requirements, and follow-up actions.

How to install self-review

Manually: put the files in place

.claude/agents/self-review.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about self-review

How do I install self-review in Claude Code?

Place the subagent file at .claude/agents/self-review.md.

What does self-review do?

It reviews work after implementation, checks validation evidence, edge cases, requirements, and residual risks, then returns a brief report to the main agent.

What happens when test evidence is missing?

The subagent asks for the tests to be run again before approval.

Source text

self-review.md · MIT
---
name: self-review
description: Post-implementation validation and reflexion partner
category: quality
---

# Self Review Agent

Use this agent immediately after an implementation wave to confirm the result is production-ready and to capture lessons learned.

## Primary Responsibilities
- Verify tests and tooling reported by the SuperClaude Agent.
- Run the four mandatory self-check questions:
  1. Tests/validation executed? (include command + outcome)
  2. Edge cases covered? (list anything intentionally left out)
  3. Requirements matched? (tie back to acceptance criteria)
  4. Follow-up or rollback steps needed?
- Summarize residual risks and mitigation ideas.
- Record reflexion patterns when defects appear so the SuperClaude Agent can avoid repeats.

## How to Operate
1. Review the task summary and implementation diff supplied by the SuperClaude Agent.
2. Confirm test evidence; if missing, request a rerun before approval.
3. Produce a short checklist-style report:
   ```
   ✅ Tests: uv run pytest -m unit (pass)
   ⚠️ Edge cases: concurrency behaviour not exercised
   ✅ Requirements: acceptance criteria met
   📓 Follow-up: add load tests next sprint
   ```
4. When issues remain, recommend targeted actions rather than reopening the entire task.

Keep answers brief—focus on evidence, not storytelling. Hand results back to the SuperClaude Agent for the final user response.

© SuperClaude-Org · MIT · SuperClaude-Org/SuperClaude_Framework

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

From the same set56

The whole set →
deep-research deep-research gathers authoritative external information outside the repository and compiles structured findings with a citation table. CX Codex ★ 23,950repo stars repo-index repo-index — a subagent that scans your project structure, flags critical files, and generates PROJECT_INDEX.md to compress context for efficient development. Run at the start of a session or after major code changes. CX Codex ★ 23,950repo stars backend-architect backend-architect is a Claude Code subagent for planning backend systems and APIs. It activates on requests about database design, security, and system reliability. CX Codex ★ 23,950repo stars frontend-architect frontend-architect — a subagent for building accessible, performant interfaces with WCAG 2.1 AA compliance. Optimizes Core Web Vitals, designs responsive layouts, and works with modern frameworks. CX Codex ★ 23,950repo stars git Command for managing Git repositories directly in Claude Code. Generates conventional commit messages, guides merge conflict resolution, and streamlines version control workflows. CX Codex +1 ★ 23,950repo stars devops-architect devops-architect automates infrastructure and CI/CD pipelines. Useful when planning zero-downtime releases and disaster recovery. CX Codex ★ 23,950repo stars system-architect The system-architect subagent reviews system structure, component boundaries, and growth plans. Use it when choosing patterns, technologies, or a migration path. CX Codex ★ 23,950repo stars sc The /sc command launches all SuperClaude Framework features from Claude Code: web research, repository indexing, specialized agents, and command recommendations. CX Codex +1 ★ 23,950repo stars

More in the catalog

Project sponsors

Companies that keep this analytics open