tdd

tdd is a command for coding agents from affaan-m/ECC. It costs 11 tokens per session (422 once invoked), scanned A, original, MIT.

A command that guides implementation through test-driven development (TDD): write a failing test, add the smallest code that passes it, then improve the code. It also checks test coverage.

In plain words
What is it for?
Use it to build TypeScript features with tests for normal inputs, edge cases, and failures, then check whether enough of the code is covered by tests.
Why use it?
It keeps tests at the centre of development and helps catch missing edge cases and errors before code is considered complete.

Command

Part of the ecc plugin — 70 skills, 56 commands, 68 agents, 1 MCP server shipped together

About the project

ECC is a toolkit that organizes and improves how coding agents work through skills, memory, security checks, research practices, and related extensions. It is for developers using agents such as Claude Code, Codex, OpenCode, and Cursor.

affaan-m/ECC · 248,541 stars · on GitHub · ecc.tools

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/affaan-m/ecc/tdd
Clone the repo
git clone --depth 1 https://github.com/affaan-m/ECC

Or install ecc, the plugin that ships this one along with the rest of its 70 skills, 56 commands, 68 agents, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for tdd

README.md
[![agentmods](https://agentmods.dev/badge/commands/affaan-m/ecc/tdd.svg)](https://agentmods.dev/commands/affaan-m/ecc/tdd)
Your own site
<a href="https://agentmods.dev/commands/affaan-m/ecc/tdd"><img src="https://agentmods.dev/badge/commands/affaan-m/ecc/tdd.svg" alt="Measured on agentmods" height="20"></a>
Per session 11 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 422 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00011 $0.00422
Opus 5 $0.00005 $0.00211
Sonnet 5 $0.00002 $0.00084
Haiku 4.5 $0.00001 $0.00042

Measured yesterday against content hash 0f57c5163f08, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

tdd scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

Copies of this mod

7 near-identical copies found in the catalogue:

  • tdd — 100% identical, 0 lines differ
  • tdd — 100% identical, 0 lines differ
  • tdd — 100% identical, 0 lines differ
  • tdd — 100% identical, 0 lines differ
  • tdd — 98% identical, 2 lines differ
  • tdd — 95% identical, 2 lines differ
  • tdd — 95% identical, 2 lines differ
.opencode/commands/tdd.md · 67 lines

What it actually says

TDD Command

Implement the following using strict test-driven development: $ARGUMENTS

TDD Cycle (MANDATORY)

RED → GREEN → REFACTOR → REPEAT
  1. RED: Write a failing test FIRST
  2. GREEN: Write minimal code to pass the test
  3. REFACTOR: Improve code while keeping tests green
  4. REPEAT: Continue until feature complete

Your Task

Step 1: Define Interfaces (SCAFFOLD)

  • Define TypeScript interfaces for inputs/outputs
  • Create function signature with throw new Error('Not implemented')

Step 2: Write Failing Tests (RED)

  • Write tests that exercise the interface
  • Include happy path, edge cases, and error conditions
  • Run tests - verify they FAIL

Step 3: Implement Minimal Code (GREEN)

  • Write just enough code to make tests pass
  • No premature optimization
  • Run tests - verify they PASS

Step 4: Refactor (IMPROVE)

  • Extract constants, improve naming
  • Remove duplication
  • Run tests - verify they still PASS

Step 5: Check Coverage

  • Target: 80% minimum
  • 100% for critical business logic
  • Add more tests if needed

Coverage Requirements

Code Type Minimum
Standard code 80%
Financial calculations 100%
Authentication logic 100%
Security-critical code 100%

Test Types to Include

  • Unit Tests: Individual functions
  • Edge Cases: Empty, null, max values, boundaries
  • Error Conditions: Invalid inputs, network failures
  • Integration Tests: API endpoints, database operations

MANDATORY: Tests must be written BEFORE implementation. Never skip the RED phase.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 67 lines · 11 tokens per session scan A 0f57c5163f08

Subscribe to this mod's changes

tdd is a command published in the GitHub repository affaan-m/ECC (248,541 stars, last pushed yesterday), licensed MIT. It adds 11 tokens to every session and 422 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.