Test-Driven Development
Overview
Enforces the TDD discipline in all CC10X BUILD workflows. The RED-GREEN-REFACTOR cycle is mandatory and cannot be skipped or deferred.
TDD Cycle
- RED: Write failing test first. Run with
CI=true npm testor--runflag. Exit code MUST be 1. - GREEN: Write minimal code to make test pass. Exit code MUST be 0.
- REFACTOR: Clean up implementation while keeping tests green. Exit code MUST remain 0.
Non-Negotiable Rules
- Always use run mode (
CI=true npm testor--runflag) - NEVER use watch mode (prevents hanging processes)
- Use timeout guards (
timeout 60s) as backup - Record exit codes as evidence at each phase
- If tests fail 3 consecutive times in GREEN, report failure status
- Never skip RED phase (failing test must exist before implementation)
- Never defer tests to "later" -- TDD means tests first
Scope Discipline
- If implementation requires >3 file changes, flag for scope review
- Architectural choices require user approval unless pre-approved in plan
- New dependencies require user approval
When to Use
- Every feature implementation in BUILD workflow
- Every bug fix in DEBUG workflow (regression test)
Agents Used
component-builder(primary consumer)bug-investigator(regression tests)