HeadlinesBriefing favicon HeadlinesBriefing.com

Evanflow: A TDD‑Driven Loop for Claude Code on GitHub

Hacker News •
×

GitHub hosts the evanflow framework, a TDD‑driven loop built for Claude Code users. It guides a feature from a brainstorm through planning, execution, testing, and iteration, stopping at each checkpoint for human approval. The system avoids auto‑commits and auto‑staging, keeping developers in control of every change.

The toolchain bundles 16 core skills plus two custom subagents. Initial steps generate two or three design options with embedded stress tests, then map a file structure before any code is written. After each task, inline verification halts the loop if blockers appear, forcing a developer‑driven decision point.

Evanflow’s TDD mode follows a vertical‑slice pattern: one failing test triggers a minimal implementation, then repeats. After each iteration, the system re‑reads the diff, runs quality checks, captures UI screenshots via headless Chromium, and applies a five‑failure‑modes checklist to guard against hallucination, scope creep, and context drift.

Installation is streamlined through the Claude Code plugin marketplace, auto‑activating a guardrail hook that blocks destructive git operations. Developers can invoke the entire loop with a single prompt, “let’s evanflow this,” and then rely on the orchestrator to surface only vetted changes, ensuring code quality without the noise of unnecessary commits.