# tdd

Guides your agent through red, green, refactor: write a failing test first, add minimal code to pass, then clean up.

Skill by Rohit Ghumare. Category: Testing.

## Install

Project (for this project only):

```sh
npx skills add rohitg00/pro-workflow --skill tdd
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add rohitg00/pro-workflow --skill tdd -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass

Installs: 105. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/rohitg00/pro-workflow/tdd)

## Source

[Open the source](https://github.com/rohitg00/pro-workflow/tree/HEAD/skills/tdd). Checked 2026-10-24. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: tdd
description: Drive a change through a red-green-refactor loop - failing test first, minimal code to pass, then clean up. Use when implementing a feature or fixing a bug where correctness matters and a test can pin the behavior. Says "TDD", "test first", "red green refactor", "write the test first".
user-invocable: true
---

# tdd

The agent codes better with a tight feedback loop than with a long
specification. A failing test is the tightest loop there is: it states the
target, and the target either goes green or it does not.

## The loop

1. **Red.** Write one failing test that states the next slice of behavior.
   Run it. Confirm it fails for the right reason - a test that passes before
   you write the code is testing nothing. If it errors instead of failing on
   the assertion, fix the test setup first.
2. **Green.** Write the least code that makes the test pass. Not the general
   solution, not the abstraction - the minimal move. Run the test. Green.
3. **Refactor.** Now clean up with the test as a net: remove duplication,
   name things, simplify. Re-run after every edit. Behavior is frozen; only
   the shape changes.
4. Repeat for the next slice. Small slices. The rate of feedback is the
   speed limit - never take on a step too big to hold a single test.

## What makes a test worth writing

- **Tests behavior, not implementation.** Assert on the observable result,
  not on which private method got called. A test that breaks on every
  refactor is a liability.
- **One reason to fail.** Each test pins one behavior. When it goes red you
  should know what broke without reading the body.
- **Real seams, minimal mocks.** Mock at the system boundary (network, clock,
  filesystem), not internal collaborators. A test that mocks the thing under
  test asserts nothing.
- **No tautologies.** A test that restates the implementation (`expect(x).toBe(x)`
  after setting `x`) verifies nothing. Assert the value the behavior should produce.

## When to reach for it

Reach for TDD when the behavior is specifiable and a test can pin it: business
logic, parsers, state machines, bug fixes (write the failing case first, then
fix). Skip it for pure exploration, throwaway spikes, and layout-only UI where
a test asserts nothing a human would not eyeball.

## Output contract

Show each red-green transition, not just the final green. If a test is hard to
write, say what the difficulty reveals about the design - untestable code is
usually badly-seamed code, and that is a finding, not an obstacle.
````

- Previous: [skill-router](https://syn4pse.dev/terminal/skill-router.md)
- Next: [writing-guidelines](https://syn4pse.dev/terminal/rohitg00-writing-guidelines.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
