implementing-with-tdd
Use when implementing bug fixes, features, or any code changes where test-first development is appropriate.
When & Why to Use This Skill
The 'Implementing with TDD' skill facilitates a robust Test-Driven Development (TDD) workflow for software engineering tasks. It guides developers through the essential Red-Green-Refactor cycle, ensuring that every bug fix or new feature is backed by automated tests. By integrating pytest for testing and Ruff for linting, this skill promotes high code quality, reduces regressions, and streamlines the path from task initiation to final deployment.
Use Cases
- Feature Development: Define functional requirements through test cases before writing implementation code to ensure 100% specification alignment.
- Bug Suppression: Reproduce reported issues with failing test cases first to verify the fix and prevent the same bug from reappearing in the future.
- Code Refactoring: Restructure and optimize existing codebases with confidence, using the established test suite to ensure no breaking changes are introduced.
- Automated Quality Assurance: Execute comprehensive CI checks, including linting and type-checking, to maintain professional coding standards across the project.
| name | implementing-with-tdd |
|---|---|
| description | Use when implementing bug fixes, features, or any code changes where test-first development is appropriate. |
TDD Implementation
PairCoder Integration
When implementing via TDD in this project:
- Start task:
bpsai-pair task update TASK-XXX --status in_progress - Write test in
tests/test_<module>.py - Run test:
pytest tests/test_<module>.py -v(expect RED) - Implement in
tools/cli/bpsai_pair/ - Run test:
pytest tests/test_<module>.py -v(expect GREEN) - Refactor if needed, keeping tests green
- Complete: Follow managing-task-lifecycle skill for two-step completion
Project Test Commands
# Run specific test
pytest tests/test_module.py::test_function -v
# Run all tests
pytest
# Run with coverage
pytest --cov=tools/cli/bpsai_pair
# Run only failed tests
pytest --lf
# Stop on first failure
pytest -x
# Show print output
pytest -s
Project Test Conventions
- Test files:
tests/test_<module>.py - Test functions:
test_<function>_<scenario>_<expected>() - Use fixtures from
tests/conftest.py - Mock external services (Trello API, etc.)
Linting
# Check linting
ruff check .
# Auto-fix
ruff check --fix .
Run All Checks
bpsai-pair ci # Runs tests + linting + type checks in one command
Task Completion
After tests pass, follow the managing-task-lifecycle skill:
bpsai-pair ttask done TRELLO-XX --summary "..." --list "Deployed/Done"bpsai-pair task update TASK-XXX --status done