Implementation

TDD-based workflow for all code changes.

Workflow

Phase 1: Understand & Plan

1. •Explore codebase to understand context and existing patterns
2. •Create detailed TodoWrite items for each test case to implement
3. •Mark first todo as in_progress

Phase 2: Red-Green-Refactor Cycle

For each todo item:

1. •Red: Write failing test
   • •Define expected behavior/contract
   • •Include concrete examples and edge cases
   • •Follow project test naming conventions
2. •Run tests - verify new test fails
3. •Green: Write minimal code to pass
   • •Only implement what's needed to pass the test
   • •No premature optimization
4. •Run tests - verify all tests pass
5. •Refactor: Opportunistic cleanup
   • •Clean up touched code if beneficial
   • •High test coverage ensures safety
6. •Run tests - verify still passing
7. •Mark todo completed, next as in_progress

Phase 3: Verify

1. •Run full test suite
2. •Use available MCP servers or skills for additional verification if applicable
3. •Ensure all todos completed

Phase 4: Subagents

Run the following custom subagents parallel:

1. •code-simplifier
2. •test-reviewer

Guidelines

• •Investigate and fix test failures autonomously - do not ask unless stuck
• •Explain key decisions only, not every step
• •High test coverage enables safe opportunistic cleanup of touched code
• •Run tests after each TDD cycle, not just at the end
• •Use TodoWrite to track each test case for visibility