implementing-with-tdd

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:

1. Start task: bpsai-pair task update TASK-XXX --status in_progress
2. Write test in tests/test_<module>.py
3. Run test: pytest tests/test_<module>.py -v (expect RED)
4. Implement in tools/cli/bpsai_pair/
5. Run test: pytest tests/test_<module>.py -v (expect GREEN)
6. Refactor if needed, keeping tests green
7. 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:

1. bpsai-pair ttask done TRELLO-XX --summary "..." --list "Deployed/Done"
2. bpsai-pair task update TASK-XXX --status done