singularity-forge/docs/dev/context-and-hooks
ace-pm b29c12d5e5 refactor(native): rename gsd_parser.rs to forge_parser.rs
Final rebrand: rename remaining Rust source file to complete the gsd → forge
transition. All parser references already use forge_parser after earlier commits.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-15 14:58:21 +02:00
..
01-the-context-pipeline.md docs: reorganize into user-docs/ and dev/ subdirectories 2026-04-10 09:25:31 -05:00
02-hook-reference.md docs: reorganize into user-docs/ and dev/ subdirectories 2026-04-10 09:25:31 -05:00
03-context-injection-patterns.md docs: reorganize into user-docs/ and dev/ subdirectories 2026-04-10 09:25:31 -05:00
04-message-types-and-llm-visibility.md docs: reorganize into user-docs/ and dev/ subdirectories 2026-04-10 09:25:31 -05:00
05-inter-extension-communication.md docs: reorganize into user-docs/ and dev/ subdirectories 2026-04-10 09:25:31 -05:00
06-advanced-patterns-from-source.md docs: reorganize into user-docs/ and dev/ subdirectories 2026-04-10 09:25:31 -05:00
07-the-system-prompt-anatomy.md refactor(native): rename gsd_parser.rs to forge_parser.rs 2026-04-15 14:58:21 +02:00
README.md docs: reorganize into user-docs/ and dev/ subdirectories 2026-04-10 09:25:31 -05: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