AI-Powered TDD Coaching

Master TDD with AI Guidance

KaidoCraft watches your commits during kata practice and provides real-time, personalized feedback tailored to your skill level. Progressive learning across 8 sessions—from basics to advanced TDD mastery.

Get Started View on GitHub
Terminal

$ npm install -g @kaidocraft/cli

$ kaidocraft setup

? Select your session number (1-8):

❯ Session 1

  Session 2

  Session 3

? Enter the kata name:

FizzBuzz

✓ Session 1 configured for FizzBuzz kata.

Concepts IN SCOPE for this session:

- Red-Green-Refactor cycle

- Test-first discipline

- Behavior-focused tests

Learn Faster

Everything you need to master TDD

KaidoCraft combines AI coaching with deliberate practice to accelerate your TDD journey.

Progressive Learning

8 carefully designed sessions that gradually introduce TDD concepts. Start with Red-Green-Refactor basics and advance to Object Calisthenics.

Commit-based Feedback

Automatic review after each commit. The post-commit hook captures your work and provides instant, contextual AI feedback.

Concept Gating

AI feedback is scoped to concepts you've learned. No overwhelming advanced topics—just the right guidance for your level.

Kata-Focused Practice

Practice with classic coding katas like FizzBuzz, Bowling Game, and Roman Numerals. Deliberate practice with immediate feedback.

Progressive Learning

8 Sessions to TDD Mastery

Each session introduces new concepts while reinforcing what you've learned. Progress at your own pace with AI guidance tailored to your current level.

Sessions 1-2

Foundations

Master the basic TDD rhythm

Red-Green-Refactor cycle Test-first discipline Behavior-focused tests
Sessions 3-4

Test Design

Structure tests effectively

Test ordering Test naming Rule of 3 Triangulation
Sessions 5-6

Transformations

Apply the TPP methodology

Transformation Priority Premise Simple to complex Design emergence
Sessions 7-8

Clean Code

Advanced design principles

Object Calisthenics One level of indentation No ELSE keyword First-class collections

Get Started

Up and running in minutes

Install the CLI, configure your session, and start practicing TDD with AI guidance.

Step 1

Install the CLI

npm install -g @kaidocraft/cli
Step 2

Navigate to your kata project

# Create a new kata project
mkdir fizzbuzz-kata && cd fizzbuzz-kata
git init
Step 3

Configure your session

kaidocraft setup

You'll be prompted to select your session number (1-8) and enter the kata name.

Step 4

Practice TDD and commit

# Write a failing test, then make it pass
git add .
git commit -m "test: add test for fizz on multiples of 3"

# KaidoCraft automatically reviews your commit!

The post-commit hook captures your work and provides instant AI feedback.

Documentation

Everything you need to know

Detailed documentation on commands, configuration, and recommended katas.

Commands

Available CLI commands

setup Configure a new TDD coaching session
kaidocraft setup
  • Prompts for session number (1-8)
  • Prompts for kata name
  • Saves configuration to .kaidocraft file
  • Installs post-commit hook for automatic feedback
--help Display available commands and options
kaidocraft --help
  • Shows all available commands
  • Displays version information

Configuration

Session configuration file

Session configuration is stored in a .kaidocraft file in your project root:

KAIDOCRAFT_SESSION=1

KAIDOCRAFT_KATA=FizzBuzz

KAIDOCRAFT_USER_ID=<uuid>

The configuration file is automatically created when you run kaidocraft setup. Your user ID persists across sessions for tracking your progress.

Recommended Katas

Classic coding katas organized by difficulty

Kata Difficulty Recommended Sessions
FizzBuzz Beginner Sessions 1-2
String Calculator Beginner Sessions 1-3
Bowling Game Intermediate Sessions 3-5
Roman Numerals Intermediate Sessions 4-6
Game of Life Advanced Sessions 6-8