TDD Guard

TDD Guard

[](https://www.npmjs.com/package/tdd-guard) [](https://www.npmjs.com/package/tdd-guard) [](https://github.com/nizos/tdd-guard/actions/workflows/ci.yml) [](https://github.com/nizos/tdd-guard/actions/workflows/security.yml) [](LICENSE)

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)

Installation

Open Claude Code in your project and run:

1. /plugin marketplace add nizos/tdd-guard
2. /plugin install tdd-guard@tdd-guard
3. /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](docs/installation.md).

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

...