o2alexanderfedin

Claudecode TDD Guard — Development skill for Claude Code

Development community

Automated TDD enforcement for Claude Code.

How to install Claudecode TDD Guard

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

What Claudecode TDD Guard does

Automated TDD enforcement for Claude Code.

Alternatives in Development

  • Claude Code Rev — Runnable ClaudeCode source code 3k ★
  • Claudecode.nvim — A Claude Code Neovim IDE Extension 2.3k ★
  • Haft — Engineering decisions engine that know when they're stale 1.4k ★

README

TDD Guard

[![npm version](https://badge.fury.io/js/tdd-guard.svg)](https://www.npmjs.com/package/tdd-guard) [![CI](https://github.com/nizos/tdd-guard/actions/workflows/ci.yml/badge.svg)](https://github.com/nizos/tdd-guard/actions/workflows/ci.yml) [![Security](https://github.com/nizos/tdd-guard/actions/workflows/security.yml/badge.svg)](https://github.com/nizos/tdd-guard/actions/workflows/security.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](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—enforcing the red-green-refactor cycle automatically.

TDD Guard Demo
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
  • Multi-Language Support - TypeScript, JavaScript, Python, PHP, and Go
  • Session Control - Toggle on and off mid-session
  • Configurable Validation - Configure which files to validate with ignore patterns
  • Flexible Validation - Use local Claude or Anthropic API

Requirements

  • Node.js 18+
  • Claude Code or Anthropic API key
  • Test framework (Jest, Vitest, pytest, PHPUnit, or Go 1.24+)

Quick Start

1. Install TDD Guard

npm install -g tdd-guard

2. Add Test Reporter

TDD Guard needs to capture test results from your test runner. Choose your language below:

JavaScript/TypeScript

Choose your test runner:

Vitest