| name | pi-primitive-check |
| description | Use when evaluating proposed Pi customisation work against built-in Pi primitives before implementation, especially extensions, packages, slash commands, and workflow ideas. |
| compatibility | Requires the Pi coding-agent monorepo docs and source tree. |
Pi Primitive Check
Use this before implementing speculative Pi customisation ideas. The
goal is to avoid building a parallel abstraction when Pi already has a
primitive.
Workflow
- Restate the underlying user need, separate from the proposed
solution.
- Search local Pi docs for overlapping primitives, especially
commands, session features, SDK APIs, extension events, tools,
skills, and TUI APIs.
- Search this repo for existing built-ins and
packages/pi-* that
already address the need.
- Classify the proposal:
- use existing Pi primitive
- document or wrap existing primitive
- compose existing primitives
- implement new feature
- If overlap exists, pause and ask the user to confirm before coding.
Required local sources
Read relevant files from the installed Pi docs before deciding:
- README:
/home/scott/repos/my-pi/node_modules/.pnpm/@earendil-works+pi-coding-agent@0.78.1_ws@8.21.0_zod@4.4.3/node_modules/@earendil-works/pi-coding-agent/README.md
- Docs directory:
/home/scott/repos/my-pi/node_modules/.pnpm/@earendil-works+pi-coding-agent@0.78.1_ws@8.21.0_zod@4.4.3/node_modules/@earendil-works/pi-coding-agent/docs
- Examples directory:
/home/scott/repos/my-pi/node_modules/.pnpm/@earendil-works+pi-coding-agent@0.78.1_ws@8.21.0_zod@4.4.3/node_modules/@earendil-works/pi-coding-agent/examples
Prefer targeted rg over broad reading, then read the relevant docs
fully enough to verify behavior.
Output format
Primitive check:
- User need:
- Existing Pi primitives:
- Existing Pi customisation pieces:
- Overlap/risk:
- Recommendation:
- Confirm before build:
Keep the recommendation direct. If the answer is “do not build this”,
say so.
