Busabase x Knowledge Base for PiKnowledge Base for Pi
Pi keeps its core deliberately small. It loads project instructions, stores shareable session trees, and lets extensions add capabilities that other harnesses bake in. That makes the boundary between installed capability, trusted environment, and reviewed organizational knowledge especially important.
MAP
Pi gives you primitives, not automatic governance: name the extension, scope the environment, and review the result.
Pi keeps its core deliberately small. It loads project instructions, stores shareable session trees, and lets extensions add capabilities that other harnesses bake in. That makes the boundary between installed capability, trusted environment, and reviewed organizational knowledge especially important.
Project instructions and prompt policy
Conversation branches and history
Installed procedure or executable capability
Reviewed shared claim
01 · Knowledge Base for Pi
minimal core with extensions, Skills, prompts, themes, and packages
Pi keeps its core deliberately small. It loads project instructions, stores shareable session trees, and lets extensions add capabilities that other harnesses bake in. That makes the boundary between installed capability, trusted environment, and reviewed organizational knowledge especially important.
| Layer | Owns | Boundary |
|---|---|---|
| AGENTS.md / SYSTEM.md | Project instructions and prompt policy | Execution guidance, not mutable business truth |
| Session tree | Conversation branches and history | Useful provenance, not an accepted decision |
| Skill / extension / package | Installed procedure or executable capability | Needs version and trust review |
| Busabase record | Reviewed shared claim | Owner-controlled organizational memory |
02 · Knowledge Base for Pi
AGENTS.md and SYSTEM.md context
Pi gives you primitives, not automatic governance: name the extension, scope the environment, and review the result.
Pi intentionally omits built-in MCP, subagents, permission popups, and plan mode.
An extension can add tools, events, UI, context injection, or custom controls; installed code is part of the trust boundary.
Summaries preserve useful context but are not a substitute for source-of-truth evidence.
Official guidance points to containerization and project trust; those controls do not validate a claim.
03 · Knowledge Base for Pi
JSONL session trees and extension-controlled compaction
Knowledge Base for Pi: minimal core with extensions, Skills, prompts, themes, and packages; AGENTS.md and SYSTEM.md context; JSONL session trees and extension-controlled compaction.
AGENTS.md / SYSTEM.mdProject instructions and prompt policy. Execution guidance, not mutable business truthSession treeConversation branches and history. Useful provenance, not an accepted decisionSkill / extension / packageInstalled procedure or executable capability. Needs version and trust reviewBusabase recordReviewed shared claim. Owner-controlled organizational memoryEVIDENCE
Knowledge Base for Pi: inspect the execution boundary
MINIMAL CORE: Pi intentionally omits built-in MCP, subagents, permission popups, and plan mode. EXTENSION: An extension can add tools, events, UI, context injection, or custom controls; installed code is part of the trust boundary. COMPACTION: Summaries preserve useful context but are not a substitute for source-of-truth evidence. CONTAINER: Official guidance points to containerization and project trust; those controls do not validate a claim.
pi_1AGENTS.md / SYSTEM.md: Project instructions and prompt policy; Execution guidance, not mutable business truthpi_2Session tree: Conversation branches and history; Useful provenance, not an accepted decisionpi_3Skill / extension / package: Installed procedure or executable capability; Needs version and trust reviewpi_4Busabase record: Reviewed shared claim; Owner-controlled organizational memory
ACCEPTANCE
Knowledge Base for Pi: execution is not acceptance
Pi gives you primitives, not automatic governance: name the extension, scope the environment, and review the result.
Pi intentionally omits built-in MCP, subagents, permission popups, and plan mode.
An extension can add tools, events, UI, context injection, or custom controls; installed code is part of the trust boundary.
Summaries preserve useful context but are not a substitute for source-of-truth evidence.
Official guidance points to containerization and project trust; those controls do not validate a claim.
PLACEMENT
Knowledge Base for Pi: keep context with its owner
AGENTS.md / SYSTEM.md owns Project instructions and prompt policy. Session tree owns Conversation branches and history. Skill / extension / package owns Installed procedure or executable capability. Busabase record owns Reviewed shared claim.
| Layer | Owns | Boundary |
|---|---|---|
| AGENTS.md / SYSTEM.md | Project instructions and prompt policy | Execution guidance, not mutable business truth |
| Session tree | Conversation branches and history | Useful provenance, not an accepted decision |
| Skill / extension / package | Installed procedure or executable capability | Needs version and trust review |
| Busabase record | Reviewed shared claim | Owner-controlled organizational memory |
FRESHNESS
Knowledge Base for Pi: record what can change
MINIMAL CORE: Pi intentionally omits built-in MCP, subagents, permission popups, and plan mode. EXTENSION: An extension can add tools, events, UI, context injection, or custom controls; installed code is part of the trust boundary. COMPACTION: Summaries preserve useful context but are not a substitute for source-of-truth evidence. CONTAINER: Official guidance points to containerization and project trust; those controls do not validate a claim.
source_versionhttps://pi.devruntime_factminimal core with extensions, Skills, prompts, themes, and packages | AGENTS.md and SYSTEM.md context | JSONL session trees and extension-controlled compactionreview_ownerAccountable human reviewernext_reviewA stated recheck boundaryFAQ
Knowledge Base for Pi: practical questions
Pi gives you primitives, not automatic governance: name the extension, scope the environment, and review the result.
Does Pi include a built-in MCP client?
No. The official site frames MCP as something to add through an extension or package; do not treat third-party support as native behavior.
Can an AGENTS.md file hold changing status?
It can, but it is the wrong owner for mutable cross-system facts. Keep project instructions there and review business state separately.
Is a shared session an approval record?
No. It is provenance. A reviewer still needs a bounded claim and source evidence.
Do extensions provide governance by default?
They can implement controls, but their presence does not prove that an outcome was reviewed or remains current.
NEXT
Pi gives you primitives, not automatic governance: name the extension, scope the environment, and review the result.
Pi keeps its core deliberately small. It loads project instructions, stores shareable session trees, and lets extensions add capabilities that other harnesses bake in. That makes the boundary between installed capability, trusted environment, and reviewed organizational knowledge especially important.