Tdd Enforce

• Improve code quality: rename variables, extract functions, remove duplication.
• Ensure all docstrings are accurate after refactoring — update any that no longer match behavior.
• Run all tests after every change. Tests must stay green.
• Only refactor if there's a clear improvement — don't refactor for its own sake.

Rules

• Never write implementation code before the test exists.
• If fixing a bug, first write a test that reproduces the bug (fails), then fix it (passes).
• One test-implement cycle at a time. Don't batch multiple features.
• If a test is hard to write, that's a signal the interface design needs rethinking.
• Every new function, class, and module must have documentation before the cycle is complete.

Commands

# Python
pytest tests/unit -x -v          # Run unit tests, stop on first failure
pytest -x -k "test_name"         # Run specific test

# TypeScript
npx vitest run --reporter=verbose  # Run all tests
npx vitest run path/to/test.ts     # Run specific test file