pi-packages

Vitest mock patterns (vi.mock, vi.hoisted, vi.fn reset), TDD planning rules, and general test strategy. Load when writing or debugging tests.

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.

Package-specific context for @gotgenes/pi-permission-system. Load when working on code, tests, or docs in packages/pi-permission-system/.

TypeScript conventions, code design principles (SOLID, self-documenting code, file organization), structural design heuristics (dependency width, LoD, output arguments), pnpm rules, ES2024 target, Pi SDK patterns, and Biome/ESLint conflict workarounds. Load during implementation, refactoring, or code review.

Review a module's dependency and structural patterns for code smells. Use when adding a parameter to a shared interface, when a dependency bag grows past 5 fields, or when planning a refactoring that touches wiring between layers.

Heuristics and process for discovering structural improvements in a package. Load when planning a new improvement round — contains the smell taxonomy, analysis workflow, and prioritization framework distilled from 10 phases of pi-subagents refactoring.

Project-specific markdown rules (one-sentence-per-line, compact tables, sequential numbering) and YAML frontmatter schema for plans/retros. Load when writing or editing markdown — contains rules that differ from standard markdownlint defaults.

Package-specific context for @gotgenes/pi-subagents. Load when working on code, tests, or docs in packages/pi-subagents/.

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.

Package-specific context for @gotgenes/pi-colgrep. Load when working on code, tests, or docs in packages/pi-colgrep/.

Package-specific context for @gotgenes/pi-github-tools. Load when working on code, tests, or docs in packages/pi-github-tools/.

Codebase intelligence via fallow CLI — dead code, duplication, complexity, refactoring targets. Load when investigating unused code, planning refactors, or reviewing fallow output.

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.

Package-specific context for @gotgenes/pi-autoformat. Load when working on code, tests, or docs in packages/pi-autoformat/.