Reference

Deep documentation, runbooks, and lookup tables. These are the pages you open when something breaks, when you need the exact name of an environment variable, or when you want to understand why a specific failure mode exists and how to avoid it.

Three groups worth knowing:

• Lookup — Glossary, Environment Variables, CLI ↔ Skills Map. Skim once, then search-on-demand.
• Operations — Testing, CI/CD, Releasing, Incident Runbook. Load these before you ship a release or page someone.
• Field guides — Agent Footguns, Troubleshooting, AgentOps Brief. Read before onboarding a new teammate.

• Glossary

  ---

  Definitions of domain-specific terms (Beads, Brownian Ratchet, RPI, etc).

• Environment Variables

  ---

  All configuration variables with defaults and precedence.

• Testing Guide

  ---

  Umbrella guide for all test types, tiers, and conventions.

• CI/CD Architecture

  ---

  Workflow map, job graph, blocking vs soft gates, local CI.

• Releasing

  ---

  Release process for ao CLI and plugin.

• Incident Runbook

  ---

  Operational runbook for incidents and recovery.

• Troubleshooting

  ---

  Common issues and quick fixes.

• Agent Footguns

  ---

  Common agent failure modes and mitigations.

• AgentOps Brief

  ---

  Executive summary of AgentOps.

• System Map

  ---

  Visual system map.

• CLI ↔ Skills Map

  ---

  Which commands are called by which skills and hooks.

• Deep Reference

  ---

  Deep documentation and pipeline details.