TDD Agent

Creates a tracked branch and executes automated edit-review cycles for coding tasks.

1|Updated Oct 29, 2025
One-click install
npx skills add https://github.com/IANTHEREAL/dev_agent --skill tdd-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: TDD Agent
Source: https://github.com/IANTHEREAL/dev_agent/tree/main/.
Command: npx skills add https://github.com/IANTHEREAL/dev_agent --skill tdd-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pip install -e ., and includes scripts (resource) components.

What problem does it solve?

This Skill automates the Test-Driven Development (TDD) process, handling the intricate cycle of writing code, reviewing it, and fixing issues, freeing developers from repetitive tasks.

Core Features & Use Cases

  • Automated TDD Cycle: Manages the implement-review-fix loop, delegating tasks to specialized AI agents.
  • Code Implementation & Review: Orchestrates code generation, test creation, and rigorous code reviews.
  • Branch Management: Creates and tracks new branches for each development iteration, ensuring a clean lineage.
  • Use Case: Automatically add a new API endpoint for user authentication, including writing tests and ensuring code quality, all driven by a simple task description.

Quick Start

Use the TDD Agent skill to add user authentication to the API, starting from parent branch ID '123e4567-e89b-12d3-a456-426614174000'.

Frequently Asked Questions about TDD Agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate the TDD workflow with code review and testing cycles?

TDD Agent automates the test-driven development cycle by launching specialist agents that handle code implementation, test creation, and review across Pantheon branches. It orchestrates the implement-review-fix loop, managing branch creation and tracking to eliminate repetitive manual cycles.

Can I use TDD Agent with Claude Code and code review roles in my CI/CD pipeline?

Yes. TDD Agent integrates with Codex, Claude Code, and review_code roles, orchestrating parallel workflows across your Pantheon project. It automates code generation, testing, and rigorous review as part of your CI/CD pipeline.

What setup do I need to run TDD Agent for automated code generation and testing?

Install the Skill using pip install -e . and provide mandatory inputs: agent role, prompt, project name, and parent branch ID. TDD Agent then launches the automated workflow, manages branch polling with exponential backoff, and returns structured results or error logs.

How does TDD Agent handle branch management during iterative development?

TDD Agent creates and tracks new branches for each development iteration rooted at a specified parent branch, recording branch IDs and retrieving outputs. This ensures clean lineage and isolation for implement-review-fix cycles across your development workflow.

What happens if code review fails in the TDD Agent workflow?

TDD Agent attempts to read code review logs up to three times with exponential backoff polling. If review fails after retries, it returns FINISHED_WITH_ERROR with structured error data, allowing you to diagnose issues and restart the cycle.