validator · disler — Claude Code subagent: task checks
The validator subagent checks a task against its acceptance criteria and reports issues. Run it after a builder agent finishes its work.
no license ★ 3,990 updated 2026-03-04
.claude/agents/validator.mdWhat validator does
validator handles one task at a time. It reads the task details and acceptance criteria with TaskGet, then examines relevant files and command output. When the task calls for tests, type checks, or linting, it runs those checks and compares the results with the stated requirements.
The agent is read-only: it reports problems but cannot change files. Once its review is done, it marks the task complete with TaskUpdate and records the status, checks performed, and findings. Any fixes must come from another agent or a person.
What it helps with
- check whether a task meets its acceptance criteria
- spot missing or incorrect changes in relevant files
- run requested checks and record their results
- save a validation status with
TaskUpdate
Example prompts for the agent
- Ask the
validatorsubagent to check the task against its acceptance criteria. - Review the builder’s changes and run the tests required by the task.
- Compare the result with the requirements and report any failed checks.
How to install validator
Manually: put the files in place
.claude/agents/validator.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/validator.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/validator.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about validator
How do I install validator in Claude Code?
Add the agent file at .claude/agents/validator.md.
What does validator do?
It checks one task against its acceptance criteria, inspects relevant files, and runs requested checks. It then records its status and findings with TaskUpdate.
Can validator fix issues it finds?
No. It can inspect and report, but it cannot edit files.
Similar subagents
All subagents for Testing and QA →validator by other authors comes first.