tjboudreaux/eng-tdd
skills/eng-tdd/SKILL.md
Enforces disciplined RED-GREEN-REFACTOR cycle—write failing test first, watch it fail, write minimal code to pass, then refactor.
$ install --global
skillsauthnpx skillsauth add tjboudreaux/cc-plugin-engineering-excellence eng-tddInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 24, 2026, 9:00 PM1.8s1 file scanned
SKILL.md
- name:
- eng-tdd
- description:
- Enforces disciplined RED-GREEN-REFACTOR cycle—write failing test first, watch it fail, write minimal code to pass, then refactor.
Test-Driven Development (TDD)
Overview
Write the test first. Watch it fail. Implement just enough to pass. Refactor while staying green. If you didn’t see the test fail, you don’t know whether it tests the right behavior.
Iron Law
NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST
Wrote code before the test? Delete it. Start from tests.
When to Use
- Every feature, bug fix, refactor, or behavior change.
- Exceptions only with explicit human approval (throwaway prototypes, generated code, etc.).
Red-Green-Refactor Cycle
- RED – Write one minimal test describing desired behavior.
- Clear, specific name.
- Tests real behavior (avoid unnecessary mocks).
- Verify RED – Run the test; confirm it fails for the expected reason.
- GREEN – Write the simplest code to make the test pass. No extra features.
- Verify GREEN – Run the test suite; ensure the new test and existing tests pass.
- REFACTOR – Clean up code/tests while keeping everything green.
- Repeat for next behavior.
Good vs Bad Tests
| Good | Bad |
|------|-----|
| Tests one thing | Vague “does work” |
| Clear name | test1 |
| Real behavior | Asserts on mocks |
Why Order Matters
- Tests written after code pass immediately → prove nothing.
- Manual testing isn’t reproducible evidence.
- Keeping prewritten code “for reference” breaks TDD—delete and rebuild from tests.
Rationalization Countermeasures
| Excuse | Response | |--------|----------| | “Too simple” | Simple code breaks—test anyway. | | “I’ll test later” | Tests-after confirm existing behavior, not requirements. | | “Manual testing is enough” | No record or rerun; automation is required. | | “Deleting work is wasteful” | Sunk cost; untested code is debt. | | “Being pragmatic” | TDD prevents debugging hell; pragmatism = reliability. |
Verification Checklist
- [ ] Every new behavior guarded by a test.
- [ ] Saw each test fail before implementation.
- [ ] Each failure was due to missing behavior (not typos).
- [ ] Wrote minimal code to make each test pass.
- [ ] Full suite green after changes.
- [ ] Refactors done only while green.
- [ ] Tests cover edge/error cases.
Failed any item? You skipped TDD—start over.
Integrating Bug Fixes
- Reproduce bug with a failing test first.
- Apply fix to satisfy the test.
- Keep the test to prevent regressions.
Final Rule
Production code exists only alongside a test that failed before the code was written. Otherwise, redo it with TDD.
Related Skills
tjboudreaux/tools-debugging-root-cause
tools
VerifiedTrustedCommunity
Systematic debugging playbook for tracing failures backward through the call chain, adding instrumentation, and fixing bugs at their origin.
1SKILL.mdUpdated Apr 17, 2026
tjboudreaux/meta-superpowers
testing
VerifiedTrustedCommunity
Startup protocol for every task—discover applicable skills, run them, announce usage, and follow required workflows (brainstorming, TodoWrite checklists, etc.).
1SKILL.mdUpdated Apr 17, 2026
tjboudreaux/eng-verification
testing
VerifiedTrustedCommunity
Mandatory checklist before claiming work is complete—run the evidence-producing command, inspect output, and only then state a result.
1SKILL.mdUpdated Apr 17, 2026
tjboudreaux/eng-user-impact
testing
VerifiedTrustedCommunity
Anchor every engineering decision in user value, measurable outcomes, accessibility, and cross-platform experience coherence.
1SKILL.mdUpdated Apr 17, 2026