tdd-guard
Claude Code plugin for TDD enforcement — blocks implementation without failing tests, prevents over-implementation
Claude Code plugin that ensures agents strictly follow Test-Driven Development principles, preventing premature implementation or skipping tests. It actively monitors agent actions, blocking code changes that violate TDD rules and providing concrete feedback on necessary next steps. Integrates with popular test frameworks like Vitest, Jest, and Pytest, installing directly via the Claude Code plugin marketplace.
- Blocks code implementation without existing failing tests
- Prevents agents from writing code beyond current test requirements
- Enforces refactoring using project-specific linting rules
- Customizable TDD validation rules to match project styles
- Toggle TDD enforcement on and off mid-session
README
View on GitHub ↗TDD Guard
Automated Test-Driven Development enforcement for Claude Code.
Overview
TDD Guard ensures Claude Code follows Test-Driven Development principles. When your agent tries to skip tests or over-implement, TDD Guard blocks the action and explains what needs to happen instead.
Click to watch TDD Guard in action
Features
- Test-First Enforcement - Blocks implementation without failing tests
- Minimal Implementation - Prevents code beyond current test requirements
- Lint Integration - Enforces refactoring using your linting rules
- Customizable Rules - Adjust validation rules to match your TDD style
- Flexible Validation - Choose faster or more capable models for your needs
- Session Control - Toggle on and off mid-session
Getting Started
Requirements
- Node.js 22+
- A supported test framework (Vitest, Jest, Storybook, pytest, PHPUnit, Go, Rust, RSpec, Minitest)
Installation
Open Claude Code in your project and run:
/plugin marketplace add nizos/tdd-guard/plugin install tdd-guard@tdd-guard/tdd-guard:setup
This adds the marketplace, installs the plugin, and configures the test reporter for your project. You may need to restart your terminal session or IDE extension for the setup skill to appear. For manual installation and configuration, see the installation guide.
Configuration
- Custom instructions - Customize TDD validation rules
- Lint integration - Automated refactoring support
- Strengthening enforcement - Prevent agents from bypassing validation
- Ignore patterns - Control which files are validated
- Validation Model - Choose faster or more capable model
- All settings - Complete settings documentation
Security
TDD Guard hooks run with your user permissions. We maintain automated security scanning, dependency audits, and welcome source code review. See Claude Code's security considerations for more on hook safety.
Development
Contributing
Contributions are welcome! See the contributing guidelines to get started.
Contributors:
- Python/pytest support: @Durafen
- PHP/PHPUnit support: @wazum
- Rust/cargo support: @104hp6u
- Go support: @sQVe, @wizzomafizzo
- Storybook support: @akornmeier
- Ruby/RSpec & Minitest support: @Hiro-Chiba
Roadmap
- Expand language and test framework support
- Validate file modifications made through MCPs and shell commands
- Encourage meaningful refactoring opportunities when tests are green
- Add support for multiple concurrent sessions per project
Support
- Discussions - Ask questions and share ideas
- Issues - Report bugs and request features
License
Similar claude code plugins
everything-claude-code
Claude Code plugin: agent harness performance system with skills, memory, security, and continuous learning
superpowers
Claude Code plugin for agentic software development — automates TDD, planning, and subagent coordination
claude-mem
Persistent memory for Claude Code plugin — captures, compresses, and reinjects session context
andrej-karpathy-skills
Claude Code plugin for LLM coding guidelines — applies Karpathy's principles to prevent common AI coding pitfalls
