Architecture
Architecture
Understand AgentOS boundaries, authority and repository ownership.
AgentOS coordinates PostgreSQL, Kubernetes, Herdr, PVCs, Git and providers without replacing their native authority. These pages navigate the implemented architecture; the linked source remains the complete contract.
Agents and runtime Pods
Separate durable Agent identity from replaceable Kubernetes processes.
Delegation and supervision
Move outcomes down one hierarchy edge and evidence back up.
PostgreSQL coordination
Durable Fleet truth, RLS and atomic organizational transitions.
External events and reconciliation
Turn provider signals into accountable Fleet work without making notifications authoritative.
Kubernetes and authorization
Workload truth, persistent homes and least-authority runtime boundaries.
Herdr and native sessions
Inspect and steer real harness terminals without inventing a second session protocol.
Toolchains and worktrees
Reproducible Fleet tools and isolated project delivery on persistent storage.
Bootstrap boundary
Transfer trust from a temporary local Agent to one persistent First Mate in two stages.
Security and chain of custody
Bind human intent, authenticated ownership, native action and delivered evidence.
Last updated on