tap

Pi / oh-my-pi plugin for TDD-driven development.

Take a feature idea from whiteboard to working code:

• Issue capture that preserves the user's prompt and existing repo labels
• Ideation that converges on one well-specified feature issue
• BLUF implementation planning written to /tmp
• RED → GREEN → REFACTOR execution through a live todo list and focused phase agents

Prerequisites

• oh-my-pi or Pi Agent installed
• For Pi Agent only: pi-subagents and pi-web-access extensions installed

pi install npm:pi-subagents
pi install npm:pi-web-access

Install

Install for oh-my-pi through Claude Code's plugin system:

claude plugin marketplace add bjspdn/tap-pi
claude plugin install tap@tap-pi

Restart omp or run /reload-plugins after installation. OMP discovers Claude-installed plugin skills from Claude's plugin cache; installing with omp plugin install tap@tap-pi does not expose skills in current OMP releases.

For local development:

omp plugin link .

Pi Agent install:

pi install git:github.com/bjspdn/tap-pi

Update later:

claude plugin marketplace update tap-pi
claude plugin update tap@tap-pi
pi update tap


/marketplace update tap-pi 
/marketplace upgrade tap@tap-pi 

How to use

The main workflow uses a GitHub issue for the feature idea and sitrep, then a /tmp implementation plan plus the live todo list for execution.

/create-issue "add a string truncation helper"
#  → files a free-form issue (e.g. #42), adapts to existing labels

/tap-into 42
#  → brainstorms + writes the sitrep back to the issue body

/tap-convey 42
#  → writes a BLUF implementation plan to /tmp

/tap-run 42
#  → reads the /tmp plan, decomposes it into RED/GREEN/REFACTOR todos,
#    delegates phases to subagents, and commits behavior-focused changes

Skills

Skill	Command	What it does
create-issue	/create-issue	Files a free-form GitHub issue from the prompt, adapting to the repo's existing labels.
tap-into	/tap-into	Brainstorming partner. Explores codebase + web in parallel, challenges assumptions, writes a converged sitrep back to the issue body.
tap-convey	/tap-convey	Decomposes the sitrep into a vertical-slice BLUF implementation plan under /tmp.
tap-run	/tap-run	Executes a /tmp plan sequentially with RED/GREEN/REFACTOR todos and behavior-focused commits.
tap-research	/tap-research	Deep multi-hop research on any technical topic. Emits a structured artifact under research/.
tap-refactor	/tap-refactor	Aggressive structural refactoring targeting 80% line reduction without behavior change.

Versioning + releases

Semver, automated via bump-version.sh:

./scripts/bump-version.sh 0.2.0       # bump, changelog, commit, tag, push, release
./scripts/bump-version.sh --check     # check version sync
./scripts/bump-version.sh --audit     # check + scan for stale version strings

Development

Enable pre-commit validation:

git config core.hooksPath scripts/hooks

Run validation manually:

./scripts/validate.sh

License

MIT