@igor-guari/pi-skill-tdd1.0.0
Test-Driven Development skill for Pi Agent (adapted from Matt Pocock's Engineering Skills)
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
Readme
pi-skill-tdd
Test-Driven Development (TDD) skill for the Pi coding agent, adapted from Matt Pocock's Engineering Skills.
This skill equips Pi with guidelines for the red → green loop: defining public seams, vertical slicing, avoiding tautological or implementation-coupled tests, and establishing disciplined testing habits.
Installation
Install directly into Pi using pi install:
pi install git:github.com/IgorGuariroba/pi-skill-tdd
Or clone into your local/global skills directory:
# Global Pi skills directory:
git clone https://github.com/IgorGuariroba/pi-skill-tdd.git ~/.pi/agent/skills/tdd
# Or Agent Skills standard path:
git clone https://github.com/IgorGuariroba/pi-skill-tdd.git ~/.agents/skills/tdd
How It Works
Pi automatically activates the skill when you ask to build features or fix bugs test-first, mention "red-green-refactor", or work with integration tests.
You can also trigger it explicitly:
/skill:tdd
Core Principles
- Seam-based testing: Test only against pre-agreed public boundaries, never internals.
- Vertical slices (tracer bullets): One test → one minimal implementation → repeat. Never write speculative tests in bulk.
- Anti-pattern guards: Eliminates tautological assertions and implementation coupling.
- Mocking at system boundaries only: Guidelines for external APIs, clocks, and databases while keeping application code real.
Supporting References
tests.md: Concrete examples of good integration-style tests vs. brittle implementation-detail tests.mocking.md: Clear guidelines on when to mock (system boundaries) and how to design for mockability using dependency injection and SDK interfaces.
Credits
- Original concept & methodology: Matt Pocock
- Adapted for Pi Agent: Igor Guariroba