Skip to content
Back to search

tdd-guard

MarketplaceWorks with Claude CodeGitHub

Automated TDD enforcement for Claude Code

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nizos-tdd-guard/badge.svg)](/listings/nizos-tdd-guard)

HTML

<a href="/listings/nizos-tdd-guard"><img src="/api/listings/nizos-tdd-guard/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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:

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).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 13 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "tdd-guard",
  3. "owner": {
  4. "name": "Nizar Selander"
  5. },
  6. "plugins": [
  7. {
  8. "name": "tdd-guard",
  9. "source": "./plugin",
  10. "description": "Automated Test-Driven Development enforcement"
  11. }
  12. ]
  13. }
README.md · README · 84 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # TDD Guard
  2. [![npm version](https://badge.fury.io/js/tdd-guard.svg)](https://www.npmjs.com/package/tdd-guard)
  3. [![npm downloads](https://img.shields.io/npm/dt/tdd-guard)](https://www.npmjs.com/package/tdd-guard)
  4. [![CI](https://github.com/nizos/tdd-guard/actions/workflows/ci.yml/badge.svg)](https://github.com/nizos/tdd-guard/actions/workflows/ci.yml)
  5. [![Security](https://github.com/nizos/tdd-guard/actions/workflows/security.yml/badge.svg)](https://github.com/nizos/tdd-guard/actions/workflows/security.yml)
  6. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
  7. > [!IMPORTANT]
  8. > **TDD Guard grew into [Probity](https://github.com/nizos/probity)**: the same
  9. > TDD enforcement, now for Claude Code, Codex, and GitHub Copilot CLI, with
  10. > more reliable validation and no test reporters to set up. New projects should
  11. > start there. TDD Guard remains maintained for the projects that rely on it.
  12. Automated Test-Driven Development enforcement for Claude Code.
  13. <p align="center">
  14. <img src="docs/assets/tdd-guard-demo.gif" alt="TDD Guard blocking TDD violations" width="1200">
  15. </p>
  16. 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.
  17. ## Features
  18. - **Test-First Enforcement** - Blocks implementation without failing tests
  19. - **Minimal Implementation** - Prevents code beyond current test requirements
  20. - **Lint Integration** - Enforces refactoring using your linting rules
  21. - **Customizable Rules** - Adjust validation rules to match your TDD style
  22. - **Flexible Validation** - Choose faster or more capable models for your needs
  23. - **Session Control** - Toggle on and off mid-session
  24. ## Getting Started
  25. ### Requirements
  26. - Node.js 22+
  27. - A supported test framework (Vitest, Jest, Storybook, pytest, PHPUnit, Go, Rust, RSpec, Minitest)
  28. ### Installation
  29. Open Claude Code in your project and run:
  30. 1. `/plugin marketplace add nizos/tdd-guard`
  31. 2. `/plugin install tdd-guard@tdd-guard`
  32. 3. `/tdd-guard:setup`
  33. 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).
  34. ## Configuration
  35. - [Custom instructions](docs/custom-instructions.md) - Customize TDD validation rules
  36. - [Lint integration](docs/linting.md) - Automated refactoring support
  37. - [Strengthening enforcement](docs/enforcement.md) - Prevent agents from bypassing validation
  38. - [Ignore patterns](docs/ignore-patterns.md) - Control which files are validated
  39. - [Validation Model](docs/validation-model.md) - Choose faster or more capable model
  40. - [All settings](docs/configuration.md) - Complete settings documentation
  41. ## Security
  42. 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](https://docs.anthropic.com/en/docs/claude-code/hooks#security-considerations) for more on hook safety.
  43. ## Development
  44. ### Contributing
  45. Contributions are welcome! See the [contributing guidelines](CONTRIBUTING.md) to get started.
  46. **Contributors:**
  47. - Python/pytest support: [@Durafen](https://github.com/Durafen)
  48. - PHP/PHPUnit support: [@wazum](https://github.com/wazum)
  49. - Rust/cargo support: [@104hp6u](https://github.com/104hp6u)
  50. - Go support: [@sQVe](https://github.com/sQVe), [@wizzomafizzo](https://github.com/wizzomafizzo)
  51. - Storybook support: [@akornmeier](https://github.com/akornmeier)
  52. - Ruby/RSpec & Minitest support: [@Hiro-Chiba](https://github.com/Hiro-Chiba)
  53. ## Support
  54. - [Discussions](https://github.com/nizos/tdd-guard/discussions) - Ask questions and share ideas
  55. - [Issues](https://github.com/nizos/tdd-guard/issues) - Report bugs and request features
  56. ## License
  57. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.