TDD Runner — Testing & QA agent for Claude Code
Use when implementing or fixing a bounded slice test-first: runs the scoped tests, reads the real failure, makes the minimal fix, never weakens assertions.
How to install TDD Runner
Installs to ~/.claude/agents/pahlevikun-levistack-tdd-runner.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/pahlevikun/levistack/HEAD/agents/tdd-runner.md -o ~/.claude/agents/pahlevikun-levistack-tdd-runner.md Restart Claude Code, or start a new session, for it to be picked up.
What TDD Runner does
name: tdd-runner description: "Use when implementing or fixing a bounded slice test-first: runs the scoped tests, reads the real failure, makes the minimal fix, never weakens assertions." tools: Read, Grep, Glob, Write, Edit, Bash
You drive test-driven development. **Tests are the source of truth for behavior**: you change the code to match the test, never the reverse, unless the user explicitly approves a test fix.
Loop
- Pick the smallest test scope: the plan task, the rules' nam
Alternatives in Testing & QA
- Shep Use Case Creator — Scaffolds a new application-layer use case with TDD (RED test file first, then minimal GREEN implementation) 247 ★
- Eval Improver — Improver role of the D365FO agent eval loop 136 ★
- TDD Specialist — Test-Driven Development specialist for Elixir/Phoenix projects using ExUnit 76 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Crafter
TDD implementation engineer for building software with test-first discipline. Use for delivering designs with
TDD Builder
Build-lane executor for mow dispatch briefs and any scoped implementation task with acceptance checks. Test-fi
TDD Coder
Implements one concrete, already-scoped piece of MeowPay work test-first - writes the failing test from a tdd-
Claudehut Test Runner
Runs the test suite and reports real pass/fail counts and failure causes — the fresh test evidence Review reco
Spec Runner
Runs the Savi specs affected by the current change and triages every failure into real-bug / stale-spec / pre-
TDD Pair
Enforces TDD discipline during implementation. Watches for "wrote code without a failing test first" and stops
Related Skills
TDD Implement
by jerseycheese - Implements Test-Driven Development by analyzing feature requirements, creating tests first (
Prompt Snapshot
Vitest-for-prompts. File-based prompt eval runner with snapshots and assertions — no SaaS, no dashboard, CI-na
Apply Suggestions
Applies code change recommendations, validates integration, and runs tests. Use when: applying suggestions, im