CtrlK
BlogDocsLog inGet started
Tessl Logo

ac-tdd-runner

Run TDD cycle for feature implementation. Use when implementing features with RED-GREEN-REFACTOR, running test-driven development, automating TDD workflow, or ensuring test-first development.

64

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/ac-tdd-runner/SKILL.md

The canonical home for this skill is ac-tdd-runner in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

AC TDD Runner

Automate the Test-Driven Development cycle for feature implementation.

Purpose

Enforces the RED-GREEN-REFACTOR cycle, ensuring all features are implemented with test-first methodology for quality and maintainability.

Quick Start

from scripts.tdd_runner import TDDRunner

runner = TDDRunner(project_dir)
result = await runner.run_cycle(feature)

TDD Cycle

RED Phase

Write failing tests first:

red_result = await runner.red_phase(feature)
# Creates test file with failing tests
# Verifies tests actually fail

GREEN Phase

Implement minimum code to pass:

green_result = await runner.green_phase(feature)
# Implements code
# Runs tests until all pass
# Minimum necessary implementation

REFACTOR Phase

Clean up while tests pass:

refactor_result = await runner.refactor_phase(feature)
# Improve code structure
# Ensure tests still pass
# Apply coding standards

Cycle Result

{
  "feature_id": "auth-001",
  "cycle_complete": true,
  "phases": {
    "red": {
      "success": true,
      "tests_created": 5,
      "all_tests_fail": true
    },
    "green": {
      "success": true,
      "iterations": 3,
      "all_tests_pass": true
    },
    "refactor": {
      "success": true,
      "changes_made": ["extracted_helper", "renamed_variable"],
      "tests_still_pass": true
    }
  },
  "coverage": 92.5,
  "duration_ms": 120000
}

RED Phase Details

  1. Generate test file from feature test_cases
  2. Write test functions with proper structure
  3. Run tests to verify they fail
  4. If tests pass unexpectedly, add more specific assertions

GREEN Phase Details

  1. Analyze failing tests
  2. Write minimum implementation
  3. Run tests
  4. If tests fail, iterate on implementation
  5. Stop when all tests pass

REFACTOR Phase Details

  1. Identify code smells
  2. Apply refactoring patterns
  3. Run tests after each change
  4. Revert if tests fail
  5. Continue until code is clean

Configuration

{
  "max_green_iterations": 10,
  "coverage_threshold": 80,
  "refactoring_patterns": [
    "extract_method",
    "rename_for_clarity",
    "remove_duplication"
  ],
  "test_framework": "pytest"
}

Integration

  • Uses: ac-test-generator for RED phase
  • Uses: ac-criteria-validator for GREEN verification
  • Reports to: ac-task-executor

API Reference

See scripts/tdd_runner.py for full implementation.

Repository
fernandezbaptiste/Skrillz
Path

.claude/skills/ac-tdd-runner/SKILL.md

Commit

93ed392

Last updated
First committed

Canonical home

fernandezbaptiste/Skrillz
In sync

since Sep 12, 2026

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.

Claim skill