Guides & Recipes¶
Task-oriented how-tos across the 79 guides in this repository — narrower and more hands-on than the architecture reference, which explains why a subsystem is built the way it is. If the operator're trying to do something (deploy, configure, integrate, migrate), start here. If the operator're trying to understand something, start there.
The most load-bearing guides — Quick Start, Installation, Consumption Models, and the Pre-bundled Workflow Skill Suite — stay directly in the site nav. Everything else is grouped here.
Onboarding & first run¶
Getting from zero to a running agent.
- Quick Start
- Installation
- Consumption Models
- Creating an Agent with Python
- Features
- First Principles Architecture
- Tools Registry
Deployment shapes & runbooks¶
Every way to stand this up — profiles, private-repo CI, sovereign/air-gapped, and the runbooks for keeping it running.
- Deploying agent-utilities
- Supported Configurations (the ladder)
- Day-0 Deployment
- Self-Setup (config-complete)
- Standard Private Repos + CI (per profile)
- Sovereign / Self-Hosted (+ air-gap path)
- Company Bootstrap Deployment Guide
- Enterprise enablement runbook
- Graph Database Deployment & Multi-Backend Guide
- Safe Redeploy Runbook
- Backend parity & deployment-profile testing
- Process Lifecycle Management
- Scalable Frontends — one shared backend, multiple thin instances
- Single-GPU LLM serving — tuning for extraction throughput
Configuration, secrets & identity¶
Wiring the config surface, credentials, and SSO.
- Configuration
- Secrets & Authentication
- OAuth 2.0 / OIDC SSO Authentication Guide
- Permissions Kernel
- Workspace Manifest (workspace.yml)
- Hierarchical State Machine (HSM) Infrastructure
Knowledge graph & memory¶
Using and extending the graph itself — schema, retrieval scoring, long-context management, and the native compute engine.
- Knowledge Graph
- Graph Engine (Authority + Mirrors)
- KG-Native Orchestration
- KG Schema Extensions: Research Assimilation
- Universal Knowledge Assimilation Engine
- Scoring Method & Retrieval Semantics
- Registry Hot Cache
- Lossless Context Management (LCM) Guide
- Recursive Language Models (RLM)
- Native Numeric Kernel
- AU native numeric call-site gap report
- KV-Cache Layering (vLLM → LMCache → engine)
Orchestration & agent runtime¶
How agents, skills, and workflows run — routing, evolution, and the conductor/loop mechanics underneath.
- Agents & Orchestration
- Agent Registry
- Agent OS Architecture Reference
- Enabling Autonomous Evolution
- AGI→ASI Implementation Guide
- Conductor Orchestration
- Cognitive Scheduler
- Centralized Dynamic Tool Selection & Visibility
- Loop Engine — running the self-improvement / research / goal loop
- Graph-Native Durable Execution
- Squeeze Evolve: Confidence-Gated Routing & Evolutionary Aggregation
- Structured Prompts
- Spec-Driven Development (SDD) Orchestrator
Skill graphs¶
Building, migrating, and hardening skill graphs.
- Pre-bundled Workflow Skill Suite
- Skill-Graph Migration Runbook (legacy → unified KG-2.7 contract)
- Skill-Graph Migration Plan — updating all existing graphs to the KG-driven format
- Skill-Graph Acquisition — Robustness Ledger
MCP fleet & tool surface¶
Building, exposing, and tuning MCP servers and their tool modes.
- Building MCP Servers & API Wrappers
- Building Fleet API Clients
- MCP Tool Surface (intent tools)
- MCP Fleet Auth & Monitoring Runbook
Enterprise & external-system integration¶
Connecting this platform to the enterprise tool landscape.
- LeanIX EA Integration (mirror/delta/backfeed)
- CMDB/ERP Bidirectional (ServiceNow + ERPNext)
- Universal Enterprise Entities
- Enterprise Ingestion Architecture (Hub-and-Spoke)
- Enterprise Trust — Epistemic Audit & Compliance
- X Personal Assistant & Social Content Ingestion Guide
Observability & operations¶
Watching the system run and keeping it safe while it does.
Architecture & design-pattern primers¶
Lighter-weight companions to the full architecture reference — good starting points before the deep dives.
- Architecture
- Agentic Harness Engineering (AHE) — Architecture
- Capability-Based Architecture Guide
- Capabilities (Self-Healing Patterns)
- Agentic Design Patterns — Architecture Alignment
- Emergent Architecture
- System Integration Architecture
- Mathematical Foundations & Financial Engineering Reference
- Multi-Model Registry & Configuration
- AgentSpecs Catalog
Contributor workflow¶
Working on agent-utilities itself.