Authoring and reviewing Mermaid diagrams — pitfall categories (semicolons, angle-bracket tokens, quoted headings), renderer verification, and state-machine disambiguation with note blocks. Load when authoring or reviewing Mermaid diagrams in any doc type.
Reference for the Pi coding agent's turn/tool execution model and extension event lifecycle. Use when designing extension timing (when to flush, notify, or intercept), understanding event sequencing, or reasoning about what the agent sees between turns. Includes the verified lifecycle diagram, event handler…
Pre-completion protocol for implementation agents — gather context, dispatch the pre-completion-reviewer subagent, and handle its report before writing stage notes and recommending /ship-issue. Load at the end of /tdd-plan and /build-plan after all implementation steps are complete.
Evaluate a newly filed issue for fit with its package's open improvement phase and record the operator's disposition in the roadmap's sweep list. Load at the moment a session files a GitHub issue — during planning, implementation, or a retrospective.
Tidy-First protocol for the planning agent — dispatch the tidy-first-assessor subagent over the files the planned change will touch, then fold its preparatory-refactor suggestions into the plan's TDD Order as refactor:/test: steps. Load during /plan-issue, after the design is settled and before writing the plan.
AGENTS.md instructions for gotgenes/pi-packages, covering agents.md, monorepo structure, docs-in-distribution convention, architecture-doc conventions and reading this repo's own artifacts.
Decision heuristics for choosing between colgrep (semantic/hybrid) and grep (exact match) during code exploration. Load before exploring unfamiliar code — contains the grep-vs-colgrep decision table and hybrid search strategies that prevent defaulting to grep for everything.