PAI
Overview

PAI Architecture Summary

Last synced: Apr 30, 2026

PAI Architecture Summary

Auto-generated by ArchitectureSummaryGenerator.ts. Do not edit manually. Generated: 2026-04-30T19:57:26.553Z | 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 v6.3.0 | Memory v7.6

Subsystem Reference

SubsystemDoc Path
Life OS thesisPAI/DOCUMENTATION/LifeOs/LifeOsThesis.md
Life OS schemaPAI/DOCUMENTATION/LifeOs/LifeOsSchema.md
System promptPAI/PAI_SYSTEM_PROMPT.md
System architecturePAI/DOCUMENTATION/PAISystemArchitecture.md
Architecture summaryPAI/DOCUMENTATION/ARCHITECTURE_SUMMARY.md
AlgorithmPAI/DOCUMENTATION/Algorithm/AlgorithmSystem.md
MemoryPAI/DOCUMENTATION/Memory/MemorySystem.md
SkillsPAI/DOCUMENTATION/Skills/SkillSystem.md
HooksPAI/DOCUMENTATION/Hooks/HookSystem.md
AgentsPAI/DOCUMENTATION/Agents/AgentSystem.md
DelegationPAI/DOCUMENTATION/Delegation/DelegationSystem.md
SecurityPAI/DOCUMENTATION/Security/SecuritySystem.md
NotificationsPAI/DOCUMENTATION/Notifications/NotificationSystem.md
ObservabilityPAI/DOCUMENTATION/Observability/ObservabilitySystem.md
PulsePAI/DOCUMENTATION/Pulse/PulseSystem.md
DA subsystem (design)PAI/DOCUMENTATION/Pulse/DaSubsystem.md
CLI tools (Algorithm + Arbol)PAI/DOCUMENTATION/Tools/Cli.md
ConfigurationPAI/DOCUMENTATION/Config/ConfigSystem.md
Containment policyPAI/DOCUMENTATION/Tools/Containment.md
Arbol (cloud execution)PAI/DOCUMENTATION/Arbol/ArbolSystem.md
FeedPAI/DOCUMENTATION/Feed/FeedSystem.md
FabricPAI/DOCUMENTATION/Fabric/FabricSystem.md
Terminal tabsPAI/DOCUMENTATION/Pulse/TerminalTabs.md
Tools referencePAI/DOCUMENTATION/Tools/Tools.md
ISAPAI/DOCUMENTATION/Isa/IsaSystem.md
ISA format specPAI/DOCUMENTATION/IsaFormat.md

Sections in source doc: 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 — PAI_SYSTEM_PROMPT.md, constitutional, survives compaction
  2. CLAUDE.md — operational procedures, format templates, context routing
  3. @Imported files — PRINCIPAL_IDENTITY, DA_IDENTITY, PROJECTS, PRINCIPAL_TELOS, this file
  4. Dynamic context — LoadContext hook output, ephemeral

Key Design Decisions

  • Algorithm is the gravitational center — everything else feeds it
  • ISA is the single source of truth per Algorithm run
  • Skills = self-activating composable domain units
  • Hooks provide SessionStart→SessionEnd lifecycle integration
  • Memory compounds 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.

PipelineKey Files
Securityhooks/SecurityPipeline.hook.ts, hooks/security/pipeline.ts, hooks/security/inspectors/{Pattern,Egress,Rules,Prompt,Injection}Inspector.ts, USER/SECURITY/PATTERNS.yaml
AlgorithmAlgorithm/LATEST → Algorithm/v{VERSION}.md (currently v6.3.0), Algorithm/capabilities.md, Algorithm/mode-detection.md, hooks/ISASync.hook.ts → MEMORY/WORK/{slug}/ISA.md, skills/ISA/ (canonical Scaffold/Append/Reconcile workflows)
Memoryhooks/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
Hookshooks/*.hook.ts, hooks/handlers/*.ts, hooks/lib/*.ts, settings.json
Observabilityhooks/ToolActivityTracker.hook.ts, hooks/ToolFailureTracker.hook.ts, hooks/lib/observability-transport.ts → MEMORY/OBSERVABILITY/*.jsonl
PulsePulse/pulse.ts (port 31337), Pulse/modules/{observability,hooks,wiki,imessage,telegram,user-index,da}.ts, Pulse/PULSE.toml, Pulse/Observability/src/, Pulse/Assistant/module.ts
Skillsskills/*/SKILL.md, skills/*/Workflows/*.md, skills/*/Tools/*.ts, USER/SKILLCUSTOMIZATIONS/
Configsettings.json, CLAUDE.md, PAI_SYSTEM_PROMPT.md (directly edited) → release tooling clones the live tree, deletes private zones, overlays public templates + USER scaffold into staging, runs gates
NotificationsPulse/pulse.ts voice handler → ElevenLabs API → MEMORY/VOICE/voice-events.jsonl
Doc Integrityhooks/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/v6.3.0.md
  • ISA format: PAI/DOCUMENTATION/IsaFormat.md
  • Config system: PAI/DOCUMENTATION/Config/ConfigSystem.md