tdg

TDG - Test-Driven Generation Plugin

A Claude Code plugin that brings Test-Driven Development workflows to AI-assisted coding, following the Red-Green-Refactor cycle for systematic code generation.

About

TDG (Test-Driven Generation) enhances Claude Code with structured workflows for test-driven development. It helps you:

• Follow the Red-Green-Refactor TDD cycle systematically
• Write tests before implementation
• Maintain high test coverage
• Create atomic, well-organized commits
• Track work with issue numbers for full traceability

Installation

# Add the TDG marketplace
claude plugin marketplace add chanwit/tdg

# Install the plugin
claude plugin install tdg

Components

Commands

• /tdg:init - Initialize TDG configuration for your project (detects language, framework, test commands)
• /tdg:version - Show the current TDG plugin version
• /tdg:atomic-commit - Create clean, atomic commits by analyzing and organizing your changes

Skills

• TDG (Test-Driven Generation) - Complete TDD workflow following Red-Green-Refactor cycles

  • Automatically detects current phase (red/green/refactor)
  • Guides you through writing tests first
  • Ensures commits follow TDD conventions
  • Requires issue number for traceability

• Atomic Commit - Create clean, atomic commits for non-TDD workflows

  • Analyzes changes and detects mixed concerns
  • Groups related changes into logical commits
  • Ensures each commit is a complete unit of work
  • Validates tests pass before committing

Hooks

• Automation hooks (coming soon)

Usage

Getting Started

1. Initialize TDG in your project:

/tdg:init

2. Use the TDG skill for test-driven development:

Use TDG to implement user authentication

3. For organizing existing changes, use the Atomic Commit skill:

Create atomic commits for my changes

TDG Workflow

The TDG skill follows a strict Red-Green-Refactor cycle:

1. Red Phase - Write failing tests

   • Commits prefixed with red: test spec for ...
   • Include issue number: red: test spec for user login (#42)

2. Green Phase - Implement code to pass tests

   • Commits prefixed with green: ...
   • Example: green: implement user login (#42)

3. Refactor Phase - Optimize and clean up

   • Commits prefixed with refactor: ...
   • Example: refactor: extract auth service (#42)

Author

Chanwit Kaewkasi

License

MIT

Links

• Repository: https://github.com/chanwit/tdg