singularity-forge/docs-internal/context-and-hooks
Lex Christopherson 91ec77291a merge: resolve conflicts with origin/main for PR #2008
Merge main's userSubdirs guard pattern with ecosystem skills directory
migration logic. Keep both detection.ts entry sets (PR's expanded markers
+ main's .NET/Xcode/Docker entries). Preserve PR's skills test assertion.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-25 22:36:37 -06:00
..
01-the-context-pipeline.md docs: add Mintlify documentation site and move internal docs 2026-03-25 09:54:41 -06:00
02-hook-reference.md docs: add Mintlify documentation site and move internal docs 2026-03-25 09:54:41 -06:00
03-context-injection-patterns.md docs: add Mintlify documentation site and move internal docs 2026-03-25 09:54:41 -06:00
04-message-types-and-llm-visibility.md docs: add Mintlify documentation site and move internal docs 2026-03-25 09:54:41 -06:00
05-inter-extension-communication.md docs: add Mintlify documentation site and move internal docs 2026-03-25 09:54:41 -06:00
06-advanced-patterns-from-source.md docs: add Mintlify documentation site and move internal docs 2026-03-25 09:54:41 -06:00
07-the-system-prompt-anatomy.md merge: resolve conflicts with origin/main for PR #2008 2026-03-25 22:36:37 -06:00
README.md docs: add Mintlify documentation site and move internal docs 2026-03-25 09:54:41 -06:00

Context & Hooks — Deep Reference

How context flows through pi, how to intercept and shape it, and advanced patterns for extension authors.

These documents fill gaps between the high-level extending-pi docs and the actual source implementation. Read the extending-pi docs first for fundamentals, then use these for precision work.

Documents

# Document When to read
01 The Context Pipeline Understanding the full journey of a user prompt through every transformation stage to the LLM
02 Hook Reference Complete behavioral specification of every hook — timing, chaining, return shapes, edge cases
03 Context Injection Patterns Practical recipes for injecting, filtering, transforming, and managing context
04 Message Types and LLM Visibility How every message type is converted for the LLM, what it sees, what it doesn't
05 Inter-Extension Communication pi.events, shared state patterns, and multi-extension coordination
06 Advanced Patterns from Source Production patterns extracted from the pi codebase and built-in extensions
07 The System Prompt Anatomy How the system prompt is built, every input source, when it's rebuilt, and every lever to shape it