d20d5e8fb5
Add a proper public-facing documentation site using Mintlify with 19 MDX pages covering getting started, auto mode, commands, configuration, and all user-facing features. Move internal/SDK documentation (Pi SDK, TUI, context & hooks, research notes, ADRs) to docs-internal/ since they should not be part of the public documentation. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| 01-the-context-pipeline.md | ||
| 02-hook-reference.md | ||
| 03-context-injection-patterns.md | ||
| 04-message-types-and-llm-visibility.md | ||
| 05-inter-extension-communication.md | ||
| 06-advanced-patterns-from-source.md | ||
| 07-the-system-prompt-anatomy.md | ||
| README.md | ||
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 |