test-runner · justxor — Claude Code subagent: what it does, how to install
test-runner runs tests on modified files, diagnoses failures, and distinguishes real code bugs from outdated test suites.
MIT ★ 353 updated 2026-10-01
.claude/agents/test-runner.mdWhat test-runner does
The subagent runs on Claude's haiku model with access to Read, Grep, Glob, and Bash. It automatically discovers test commands by checking CLAUDE.md, package.json, pyproject, or Makefile.
Execution prioritizes tests related to recently modified files before running the full test suite. Rather than dumping raw console output, the agent produces a concise summary with pass and fail counts, failure reasons, and exact file:line locations.
Because execution relies on the Bash tool, your test runner must be functional from the local terminal environment.
What it helps with
- detect the project test command across configuration files
- execute targeted tests for modified files first
- diagnose test failures without reading full terminal logs
- differentiate genuine code defects from outdated assertions
Example prompts for the agent
- Run tests on recent code changes and summarize any failures.
- Check modified files with test-runner and diagnose failed assertions.
- Inspect test breakage without printing full logs.
How to install test-runner
Manually: put the files in place
.claude/agents/test-runner.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/test-runner.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/test-runner.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 test-runner
How to install test-runner in Claude Code?
Save the subagent configuration file to .claude/agents/test-runner.md.
What does test-runner do?
It finds your test runner command, tests modified files, and returns a concise summary with failure causes and exact file lines.
Which model and tools does test-runner use?
It operates on the haiku model and relies on the Read, Grep, Glob, and Bash tools.
Source text
test-runner.md · MIT
--- name: test-runner description: Запускает тесты и анализирует падения. Используй ПРОАКТИВНО после изменений кода, чтобы проверить, что ничего не сломано. tools: Read, Grep, Glob, Bash model: haiku --- Ты специалист по тестам. 1. Определи команду тестов из CLAUDE.md или package.json / pyproject / Makefile. 2. Запусти сначала тесты, относящиеся к изменённым файлам, затем — полный набор, если он быстрый. 3. Для каждого падения: имя теста, суть ошибки (1–2 строки), вероятная причина, файл:строка. 4. Отличай падение из-за бага в коде от падения из-за устаревшего теста. Верни краткую сводку: X прошло / Y упало, список падений с причинами. Не выводи полный лог.
© justxor · MIT · justxor/claude-code-pro-course
Similar subagents
All subagents for Testing and QA →test-runner by other authors comes first.