implementing-with-tdd

BPSAI's avatarfrom BPSAI

Use when implementing bug fixes, features, or any code changes where test-first development is appropriate.

⭐2stars🔀0forks📁View on GitHub🕐Updated Dec 31, 2025

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.
nameimplementing-with-tdd
descriptionUse 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