tdd-guard

Name: tdd-guard
Author: nizos

by nizos

Verified

Automated TDD enforcement for Claude Code

2,250stars

173forks

TypeScript

Added 12/27/2025

Installation

# Add to your Claude Code skills
git clone https://github.com/nizos/tdd-guard

Getting Started

Guides for using ai agents skills like tdd-guard.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 4/25/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-04-25T05:50:36.451Z",
  "semgrepRan": false,
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is tdd-guard?

tdd-guard is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by nizos. Automated TDD enforcement for Claude Code. It has 2,250 GitHub stars.

Is tdd-guard safe to use?

Yes. tdd-guard passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install tdd-guard?

Clone the repository with "git clone https://github.com/nizos/tdd-guard" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is tdd-guard written in?

tdd-guard is primarily written in TypeScript. It is open-source under nizos on GitHub, so you can review or fork the full source.

Are there alternatives to tdd-guard?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh tdd-guard against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

carbon prompt-in-context-learning

TDD Guard

[!IMPORTANT] TDD Guard grew into Probity: the same TDD enforcement, now for Claude Code, Codex, and GitHub Copilot CLI, with more reliable validation and no test reporters to set up. New projects should start there. TDD Guard remains maintained for the projects that rely on it.

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.

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

MIT