Use TDD only when the user asked for it or the repository requires it. Follow the repo testing MDX and vitest-v5 (or the stack's test skill). Do not commit unless asked.
- Red: write a failing test for the desired behavior. Use real APIs where the repo tests do; mock only at documented boundaries.
- Green: write the smallest implementation that passes that test.
- Refactor: improve structure while tests stay green.
- Repeat for the next increment. Run the focused test file each cycle, then the affected suite.
- Docs:
/w-docsif behavior or commands changed.
