documentation#

deeper dive into phi's design.

contents#

• architecture.md — entry points, scheduling, why this shape
• memory.md — the four kinds of state phi draws on (thread, private, public, intent)
• system-prompt.md — block-by-block reference for what's actually in phi's context per run
• mcp.md — model context protocol integration
• testing.md — testing philosophy

reading order#

1. architecture.md — overall shape
2. memory.md — what phi knows and where it lives
3. system-prompt.md — exactly what reaches the model on every run
4. mcp.md — external capabilities
5. testing.md — how we verify behavior

each doc is self-contained and can be read independently.