nizos

TDD Guard — Git skill for Claude Code

Git community intermediate

by Nizar Selander - A hooks-driven system that monitors file operations in real-time and blocks changes that violate TDD principles.

How to install TDD Guard

This entry records only its repository, not the path inside it, so there is no exact command to give. Open nizos/tdd-guard and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What TDD Guard does

[](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)

Alternatives in Git

Bulletproof Quick Start Guide — Target Audience: Complete beginners Never used Python/git before 11.1k ★
CCometixLine — A high-performance Claude Code statusline tool written in Rust with Git integration and real-time usage tracki 2.4k ★
Destructive Command Guard — The Destructive Command Guard (dcg) is for blocking dangerous git and shell commands from being executed by ag 869 ★

README

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)

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](docs/installation.md).