tdd-guard

TDD Guard is a TypeScript npm package that hooks into Claude Code to enforce Test-Driven Development discipline during agentic coding sessions. It installs as a Claude Code plugin via three slash commands and intercepts the agent's file-writing actions to block two specific violations: writing implementation code before any failing tests exist, and writing more code than current tests require. It also integrates with project linters to enforce the refactor phase of the red-green-refactor cycle. When a violation is detected, the hook blocks the action and returns an explanation of what must happen first rather than silently failing. The tool supports ten test frameworks across multiple languages, including Vitest, Jest, pytest, PHPUnit, Go, Rust, RSpec, and Minitest. Validation can be routed to faster or more capable models depending on project needs, and enforcement can be toggled mid-session. Software developers who want Claude Code to respect TDD workflows rather than skip directly to passing implementations are the primary audience.

What people ask about tdd-guard