tdd

Enforce test-first development with automated red-green-refactor validation.

8|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/ShaheerKhawaja/ProductionOS --skill tdd-shaheerkhawaja
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tdd
Source: https://github.com/ShaheerKhawaja/ProductionOS/tree/main/skills/tdd
Command: npx skills add https://github.com/ShaheerKhawaja/ProductionOS --skill tdd-shaheerkhawaja

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Codex-first test-driven development workflow that ensures tests are written before implementation and that refactoring stays safe and incremental.

Core Features & Use Cases

  • Enforces red-green-refactor cycle and test-first discipline.
  • Guides Codex to implement only the minimal change required to satisfy tests.
  • Provides a repeatable workflow suitable for CI and local development.

Quick Start

Start by invoking the Codex TDD workflow to write a failing test for your target feature.

Frequently Asked Questions about tdd

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

FAQPage Schema
How do I automate a test-driven development workflow for code generation?

Automating test-driven development involves enforcing a test-first approach where you write a failing test, implement minimal code to pass it, and refactor safely. This Skill automates that red-green-refactor cycle for Codex-based tasks to ensure correctness.

What is the best way to enforce test-first discipline when using Codex?

The best way to enforce test-first discipline is to apply an automated TDD workflow that requires a failing test before any implementation. This Skill guides Codex to write only the minimal viable code needed to satisfy tests and re-runs them to verify coverage.

How do I start a TDD workflow for a new feature with Codex?

To start a TDD workflow, invoke the workflow to write a failing test for your target feature first. The system then enforces the red-green-refactor cycle, guiding Codex to implement the minimal change required to make the test pass before allowing any refactoring.

Does this test-driven development workflow work across different programming languages?

Yes, this test-driven development workflow applies to software development tasks across languages and tooling. It enforces automated validation of the red-green-refactor cycle regardless of the specific language, maintaining a failing-test-first approach throughout.

Can I use this TDD workflow for both local development and CI pipelines?

Yes, you can use this TDD workflow for both local development and CI pipelines. It provides a repeatable workflow that enforces test-first discipline and automated validation of the red-green-refactor cycle, ensuring safe and incremental refactoring across environments.

Why should I write a failing test before implementation during refactoring?

Writing a failing test before implementation ensures that tests define behavior before code is written. This approach enforces the red-green-refactor cycle, verifying that your implementation satisfies the test requirements and that refactoring remains safe and incremental.