Agent skill · software engineering · aradotso
evanflow-tdd-loop
evanflow-tdd-loop — an agent skill for coding agents.
Why this skill is useful
Adds 16 executable skills and a guardrail hook for TDD-driven iterative development that fundamentally enhances the AI's capabilities in software engineering.
What it needs
Requires chromium, jq installed locally. About 7k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
brainstorm → plan → execute (vertical-slice TDD per task) → iterate → STOP └─ sequential, or parallel coder/overseer /plugin marketplace add evanklem/evanflow /plugin install evanflow@evanflow bash All 16 skills at once npx skills@latest add evanklem/evanflow -s '' -y Individual skills npx skills@latest add evanklem/evanflow/evanflow-go npx skills@latest add evanklem/evanflow/evanflow-tdd npx skills@latest add evanklem/evanflow/evanflow-iterate bash git clone https://github.com/evanklem/evanflow.git cd evanflow Skills (project-level) mkdir -p .claude/skills cp -r skills/ .claude/skills/ Custom subagents mkdir -p .claude/agents cp agents/.md .claude/agents/ Git guardrail hook mkdir -p .claude/hooks cp hooks/block-dangerous-git.sh .claude/hooks/ chmod +x .claude/hooks/block-dangerous-git.sh json { "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [ { "type": "command", "command": "\"$CLAUDEPROJECTDIR\"/.claude/hooks/block-dangerous-git.sh" } ] } ] } } bash macOS brew install jq Ubuntu/Debian apt install jq evanflow-go → Say "let's evanflow this" — orchestrates the full loop. User: "Let's evanflow this — add rate limiting to our API" Per task: RED: Write one failing test that specifies behavior via public interface GREEN: Write minimal implementation to pass it REFACTOR: Clean up while the test is still your safety net → next test Plan with 3 independent modules → fork: 3 evanflow-coder subagents (one per module) 3 evanflow-overseer subagents (one per coder, read-only) 1 integration overseer (runs named integration tests at every touchpoint) User: "evanflow improve architecture on the auth module" User: "evanflow debug — users are getting 500s on /api/checkout" User: "evanflow compact — we've been going for a while" bash git push # blocked git reset --hard # blocked git clean -f # blocked git branch -D # blocked git checkout . # blocked git restore . …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/evanflow-tdd-loop