boshu2__agentops/docs/reference/index.md

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.
• Curation — Skill Quality Rubric. Use this when scoring skill packaging standards and readiness.
• Evolution control — AgentOps Domain Evolution BDD, AgentOps Skill Domain Map, AgentOps Hexagonal Architecture Map, and AgentOps Domain Evolution Plan. Use these before running broad skill, CLI, or hook evolution loops.

• :material-book-alphabet: Glossary

  ---

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

• :material-variable: Environment Variables

  ---

  All configuration variables with defaults and precedence.

• :material-test-tube: Testing Guide

  ---

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

• :material-source-branch: CI/CD Architecture

  ---

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

• :material-tag: Releasing

  ---

  Release process for ao CLI and plugin.

• :material-ambulance: Incident Runbook

  ---

  Operational runbook for incidents and recovery.

• :material-wrench: Troubleshooting

  ---

  Common issues and quick fixes.

• :material-alert: Agent Footguns

  ---

  Common agent failure modes and mitigations.

• :material-briefcase: AgentOps Brief

  ---

  Executive summary of AgentOps.

• :material-map: System Map

  ---

  Visual system map.

• :material-file-tree: CLI ↔ Skills Map

  ---

  Which commands are called by which skills and hooks.

• :material-book-open-variant: Deep Reference

  ---

  Deep documentation and pipeline details.

• :material-star-check: Skill Quality Rubric

  ---

  Scoring model for repo-runtime, export, and mega-skill readiness.

• :material-graph-outline: Domain Evolution BDD

  ---

  Gherkin acceptance contract for auditing, domain-mapping, and evolving AgentOps.

• :material-sitemap: Skill Domain Map

  ---

  All checked-in AgentOps skills mapped to BC1-BC6 with first dispositions.

• :material-hexagon-multiple: Hexagonal Architecture Map

  ---

  Domain, port, adapter, and proof-gate target for skill, CLI, and hook evolution.

• :material-progress-check: Domain Evolution Plan

  ---

  Sequenced bootstrap and evolution plan anchored to soc-y5vh.