tdd
Test-Driven Development patterns and red-green-refactor workflow. Auto-triggers when writing tests first, implementing TDD, or discussing test coverage.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Test-Driven Development
The Red-Green-Refactor Cycle
- RED: Write a failing test that defines expected behavior
- GREEN: Write minimal code to make the test pass
- REFACTOR: Improve code quality while keeping tests green
Critical Rules
- Never write production code without a failing test first
- Only write enough code to make the current test pass
- Refactor only when tests are green
- Run tests after every change
Test Structure (AAA Pattern)
// Arrange - Set up test data and conditions
// Act - Execute the code under test
// Assert - Verify the expected outcome
Test Naming Convention
test_[unit]_[scenario]_[expected_result]
Examples:
- test_calculateTotal_emptyCart_returnsZero
- test_userLogin_invalidPassword_throwsAuthError
- test_parseDate_invalidFormat_returnsNull
Test Doubles
| Type | Purpose | Use When |
|---|---|---|
| Stub | Returns canned data | Testing with specific inputs |
| Mock | Verifies interactions | Checking method calls |
| Fake | Working implementation | Need realistic behavior |
| Spy | Records calls | Observing side effects |
Coverage Targets
- Unit tests: >90% line coverage
- Integration tests: Critical paths covered
- E2E tests: Happy paths + key error scenarios
Anti-Patterns to Avoid
- Testing implementation details (test behavior, not internals)
- Overly specific assertions (leads to brittle tests)
- Test interdependence (each test must be isolated)
- Testing trivial code (getters/setters)
- Ignoring flaky tests (fix or remove immediately)
TDD for Different Contexts
API Endpoints
- Test request validation
- Test business logic
- Test response format
- Test error handling
UI Components
- Test rendering with props
- Test user interactions
- Test state changes
- Test accessibility
Database Operations
- Test CRUD operations
- Test constraints/validation
- Test transactions
- Test edge cases (null, empty)
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!