PAI Architecture Summary

Auto-generated by ArchitectureSummaryGenerator.ts. Do not edit manually. Generated: 2026-04-22T19:22:40.593Z | Source: DOCUMENTATION/PAISystemArchitecture.md

Overview

PAI (Personal AI Infrastructure) is scaffolding for AI — architectural framework that makes AI assistance dependable, maintainable, and effective. Built around a universal algorithm for accomplishing any task: Current State to Ideal State via verifiable iteration (ISC).

Current versions: PAI 5.0.0 | Algorithm v3.29.0 | Memory v7.6

Subsystem Reference

Subsystem	Doc Path	Exists
Life OS thesis (what PAI is for)	PAI/DOCUMENTATION/LifeOs/LifeOsThesis.md	Y
Life OS schema (USER/ shape)	PAI/DOCUMENTATION/LifeOs/LifeOsSchema.md	Y
System prompt (constitutional rules)	PAI/PAI_SYSTEM_PROMPT.md	Y
System architecture (master doc)	PAI/DOCUMENTATION/PAISystemArchitecture.md	Y
Architecture summary	PAI/DOCUMENTATION/ARCHITECTURE_SUMMARY.md	Y
Algorithm system	PAI/DOCUMENTATION/Algorithm/AlgorithmSystem.md	Y
Memory system	PAI/DOCUMENTATION/Memory/MemorySystem.md	Y
Skill system	PAI/DOCUMENTATION/Skills/SkillSystem.md	Y
Hook system	PAI/DOCUMENTATION/Hooks/HookSystem.md	Y
Agent system	PAI/DOCUMENTATION/Agents/AgentSystem.md	Y
Delegation system	PAI/DOCUMENTATION/Delegation/DelegationSystem.md	Y
Security system	PAI/DOCUMENTATION/Security/SecuritySystem.md	Y
Notification system	PAI/DOCUMENTATION/Notifications/NotificationSystem.md	Y
Observability system	PAI/DOCUMENTATION/Observability/ObservabilitySystem.md	Y
Pulse system	PAI/DOCUMENTATION/Pulse/PulseSystem.md	Y
DA subsystem (design)	PAI/DOCUMENTATION/Pulse/DaSubsystem.md	Y
CLI tools (Algorithm + Arbol)	PAI/DOCUMENTATION/Tools/Cli.md	Y
CLI-first architecture	PAI/DOCUMENTATION/Tools/CliFirstArchitecture.md	Y
Configuration system	PAI/DOCUMENTATION/Config/ConfigSystem.md	Y
Containment policy	PAI/DOCUMENTATION/Tools/Containment.md	Y
Arbol (cloud execution)	PAI/DOCUMENTATION/Arbol/ArbolSystem.md	Y
Feed system	PAI/DOCUMENTATION/Feed/FeedSystem.md	Y
Fabric system	PAI/DOCUMENTATION/Fabric/FabricSystem.md	Y
Terminal tabs	PAI/DOCUMENTATION/Pulse/TerminalTabs.md	Y
Tools reference	PAI/DOCUMENTATION/Tools/Tools.md	Y
PRD format spec	PAI/DOCUMENTATION/PrdFormat.md	Y

Architecture Sections

• Directory Structure
• The Founding Principles
• Instruction Hierarchy — The Model’s Input Chain
• Subsystem Architecture
• Reference Documents
• File Naming Conventions
• Security Architecture
• Pipeline Topology
• System Self-Management

Founding Principles

1. PAI is the Life Operating System
2. Customization of an Agentic Platform for Achieving Your Goals
3. The Continuously Upgrading Algorithm (THE CENTERPIECE)
4. Clear Thinking + Prompting is King
5. Scaffolding > Model
6. As Deterministic as Possible
7. Code Before Prompts
8. Spec / Test / Evals First
9. UNIX Philosophy (Modular Tooling)
10. ENG / SRE Principles ++
11. CLI as Interface
12. Goal -> Code -> CLI -> Prompts -> Agents
13. Custom Skill Management
14. Custom Memory System
15. Custom Agent Personalities / Voices
16. Science as Cognitive Loop
17. Permission to Fail

Instruction Hierarchy

1. System Prompt — Constitutional rules (PAI_SYSTEM_PROMPT.md, highest authority, survives compaction)
2. CLAUDE.md — Operational procedures, format templates, context routing
3. @Imported Files — Principal identity, DA identity, projects, telos (loaded with CLAUDE.md)
4. Dynamic Context — Session-specific state from LoadContext hook (ephemeral)

Key Design Decisions

• Algorithm is the gravitational center — everything else feeds it
• PRD is single source of truth for every Algorithm run
• Skills are the organizational unit for domain expertise (self-activating, composable)
• Hooks provide lifecycle integration (SessionStart through SessionEnd)
• Memory compounds intelligence across sessions (WORK -> LEARNING -> KNOWLEDGE)
• System/user config separation enables public releases without personal data

Pipeline Topology

System file inventory by pipeline. When you modify a file, trace its pipeline to find downstream docs that need updating. The DocIntegrity.hook.ts (Stop) automates cross-reference checks and the ArchitectureSummaryGenerator.ts regenerates the summary when the master doc changes.

Pipeline	Key Files
Security	hooks/SecurityPipeline.hook.ts, hooks/security/pipeline.ts, hooks/security/inspectors/{Pattern,Egress,Rules,Prompt,Injection}Inspector.ts, USER/SECURITY/PATTERNS.yaml
Algorithm	Algorithm/v3.29.0.md, Algorithm/capabilities.md, Algorithm/mode-detection.md, hooks/PRDSync.hook.ts → MEMORY/WORK/{slug}/PRD.md
Memory	hooks/WorkCompletionLearning.hook.ts, hooks/SatisfactionCapture.hook.ts, hooks/RelationshipMemory.hook.ts, Tools/KnowledgeHarvester.ts → MEMORY/KNOWLEDGE/, MEMORY/LEARNING/; Tools/SessionHarvester.ts --mine → KNOWLEDGE/_harvest-queue/; Tools/MemoryRetriever.ts (BM25 retrieval), Tools/KnowledgeGraph.ts (graph navigation) — read-only
Hooks	hooks/*.hook.ts, hooks/handlers/*.ts, hooks/lib/*.ts, settings.json
Observability	hooks/ToolActivityTracker.hook.ts, hooks/ToolFailureTracker.hook.ts, hooks/SubagentTracker.hook.ts, hooks/lib/observability-transport.ts → MEMORY/OBSERVABILITY/*.jsonl
Pulse	Pulse/pulse.ts (port 31337), Pulse/modules/{observability,hooks,wiki,imessage,telegram}.ts, Pulse/PULSE.toml, Pulse/Observability/src/
Skills	skills/*/SKILL.md, skills/*/Workflows/*.md, skills/*/Tools/*.ts, USER/SKILLCUSTOMIZATIONS/
Config	settings.json, CLAUDE.md, PAI_SYSTEM_PROMPT.md (directly edited) → skills/_PAI/TOOLS/ShadowRelease.ts (containment-based public release builder) → skills/_PAI/TEMPLATES/ (public templates + USER scaffold)
Notifications	Pulse/pulse.ts voice handler → ElevenLabs API → MEMORY/VOICE/voice-events.jsonl
Doc Integrity	hooks/DocIntegrity.hook.ts (Stop) → hooks/handlers/DocCrossRefIntegrity.ts + hooks/handlers/RebuildArchSummary.ts → Tools/ArchitectureSummaryGenerator.ts

Cross-References

• Full architecture: PAI/DOCUMENTATION/PAISystemArchitecture.md
• Algorithm spec: PAI/ALGORITHM/v3.29.0.md
• PRD format: PAI/DOCUMENTATION/PrdFormat.md
• Config system: PAI/DOCUMENTATION/Config/ConfigSystem.md