tdd-workflow

Build test-first implementation plans and execute RED-GREEN-REFACTOR for Rust, Python, and TypeScript.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/sujithatzackriya/skills --skill tdd-workflow-sujithatzackriya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tdd-workflow
Source: https://github.com/sujithatzackriya/skills/tree/main/skills/tdd-workflow
Command: npx skills add https://github.com/sujithatzackriya/skills --skill tdd-workflow-sujithatzackriya

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you implement features, bug fixes, and refactors with confidence by forcing a test-first plan anchored in invariants and a risk-focused test strategy.

Core Features & Use Cases

  • Framework-driven TDD: Uses first-principles by default, but routes each TODO through best-fit reasoning/testing frameworks via the think skill.
  • Plan-first, test-first execution: Produces a Phase 1 TODO plan (paths, dependencies, invariants, risk flags, known unknowns) before writing any production code.
  • RED-GREEN-REFACTOR with review gates: Iterates through failing tests, minimal passing implementation, and refactoring while enforcing review checks (including optional deep review).
  • Interactive or autopilot modes: Supports --sub-skill (silently plan/emit TODOs for orchestrators) and --plan-only (emit TODO YAML and stop after Phase 1).

Quick Start

Use the tdd-workflow skill to implement your change by asking it to run a TDD loop on your TODO: "tdd-workflow implement plan for this feature with tests first."

Frequently Asked Questions about tdd-workflow

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

FAQPage Schema
How do I implement a red green refactor TDD loop for TypeScript or Python?

Red green refactor TDD for TypeScript, Python, or Rust is executed by deriving invariants and a risk surface first, then iterating through failing tests to minimal passing implementation and refactoring with enforced review gates.

What is the best way to plan a test-first feature implementation before writing code?

Test-first implementation planning produces a Phase 1 TODO plan containing file paths, dependencies, invariants, risk flags, and known unknowns before any production code is written.

Can I generate a TDD test strategy for Rust without writing implementation code immediately?

You can generate a TDD test strategy and stop after the planning phase by using the --plan-only mode, which emits the TODO YAML and halts execution before production coding begins.

Does this test-driven development workflow support automated code review and regression safety?

Test-driven development workflow supports regression safety by optionally running codex review and enforcing review gates throughout the refactoring phase to verify correctness.

How do I fix bugs using a test-first approach that identifies risk surfaces and invariants?

Bug fixing with a test-first approach builds a structured plan by deriving invariants and mapping the risk surface, ensuring each fix is validated through targeted failing tests before implementation.