| name | tdd |
| description | Test-driven development loop for Solidity smart contracts. unit-test-engineer writes failing tests, contract-developer implements, loop until green. |
| triggers | ["write tests first","tdd","test-driven","write unit tests for","test-first development","write failing tests"] |
| agent | orchestrator |
| model | sonnet |
Purpose
Implements a strict TDD loop for contract development. Ensures every line of implementation code is covered by a test written before the implementation. Maximum 5 iterations before halting.
Workflow
- Orchestrator calls
eth_skill_start({ skill: "tdd", totalPhases: 1 })
- Orchestrator spawns
unit-test-engineer with the contract specification
unit-test-engineer writes failing tests and runs them to confirm failure- Orchestrator spawns
contract-developer with the failing tests
contract-developer writes minimal implementation to pass the tests- Orchestrator spawns
unit-test-engineer again to verify tests pass + coverage
- If tests fail: loop back to step 4 (max 5 iterations)
- When tests pass: orchestrator reports coverage and hands off
- Orchestrator calls
eth_reset()
Usage
"write tests first for an ERC20 vault"
"tdd a staking contract"
"write unit tests for the Auction contract before implementing"
# Output:
- test/[ContractName].t.sol (Foundry) or test/[ContractName].test.ts (Hardhat)
- src/[ContractName].sol with minimal implementation
- Coverage report
Configuration
- Max TDD loop iterations: 5 (orchestrator halts and reports after 5 failed loops)
- Toolchain auto-detected (Foundry/Hardhat)
- Coverage threshold: reported but not enforced (user decides if sufficient)
