tdd-guard
Automated TDD enforcement for Claude Code
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up tdd-guard (claude-plugin project) into my current project. Found on https://claudeers.com/tdd-guard Repo: https://github.com/nizos/tdd-guard Homepage/docs: — Detected install method: claude-plugin → /plugin install tdd-guard@nizos/tdd-guard Category: automation. Platforms: cli, api. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: active; community-verified: false. Confirm the source before running anything.
/plugin marketplace add nizos/tdd-guard /plugin install tdd-guard@nizos/tdd-guard
git clone https://github.com/nizos/tdd-guard
// compatibility
| Platforms | cli, api |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | TypeScript |
TDD Guard
Automated Test-Driven Development enforcement for Claude Code.
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.
Probity is where new development now happens. It validates using session activity for more reliable results, and works with more agents, languages, and test runners. TDD Guard remains maintained for projects that rely on it.
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
Support
- Discussions - Ask questions and share ideas
- Issues - Report bugs and request features
License
// faq
What is tdd-guard?
Automated TDD enforcement for Claude Code. It is open-source on GitHub.
Is tdd-guard free to use?
tdd-guard is open-source under the MIT license, so it is free to use.
What category does tdd-guard belong to?
tdd-guard is listed under automation in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/tdd-guard)
// retro hit counter
[](https://claudeers.com/tdd-guard)
// reviews
// guestbook
// related in Automation & Workflows
🔓
🔓The API to search, scrape, and interact with the web at scale. 🔥
🔓🌐 Make websites accessible for AI agents. Automate tasks online with ease.
🔓An open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message…