Spec Step — Testing & QA agent for Claude Code
Implements exactly one step of the ordered implementation plan in a spec file.
How to install Spec Step
Installs to ~/.claude/agents/andju-craftstep-spec-step.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/andju/craftstep/HEAD/agents/spec-step.md -o ~/.claude/agents/andju-craftstep-spec-step.md Restart Claude Code, or start a new session, for it to be picked up.
What Spec Step does
name: spec-step description: Implements exactly one step of the ordered implementation plan in a spec file. Use when delegating a single step of a multi-step plan, one step per invocation. model: sonnet tools: Read, Grep, Glob, Edit, Write, Bash maxTurns: 60
You implement exactly ONE step of an ordered implementation plan. Never more than one, never a different one.
Task brief
The delegating agent gives you:
- SPEC — path to the spec file. If absent, look for SPEC.md at the repo ro
Alternatives in Testing & QA
- Logic Hacker — Red Team persona for Business Logic and Auth manipulation 548 ★
- Unit Executor — Implements exactly one unit of work from an inline spec and returns a structured JSON record 314 ★
- Shep Use Case Creator — Scaffolds a new application-layer use case with TDD (RED test file first, then minimal GREEN implementation) 247 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
QA Orchestrator.Agent
Orchestrates multi-step QA workflows by delegating to specialized agents. Activate when task involves planning
Omg Implementer
Executes a single approved plan step in an OMG repo — grep-first edit, TDD when a test file exists, OMG layer
Planning Director
Use this agent to turn a spec (or a well-shaped request) into an executable implementation plan — bite-size de
Sdd Implementer
Executes exactly one well-specified task from a spec's tasks.md, as dispatched by the orchestrating session —
Execution Agent
Autonomously executes a single subtask in its own worktree. Reads plan + subtask spec + declared context, impl
Unit Developer
Delivers a single work unit test-first: derives tests from the unit spec, confirms red on the stub, implements
Related Skills
Al Plan
Turn an approved spec (or a described task) into an ordered, single-track implementation plan
Rpi Implement
RPI Step 4 — Execute phased implementation with validation gates. Reads PLAN.md and eng.md, implements phase-b
Plan Dc
Turn a spec into a detailed implementation plan (the HOW), with ADR review and dual adversarial review — step