I broke my own agent twice in one week. Once by hand, once with help from a very confident language model. This post is about both breaks, and about the Profiles tab in the CAO Web UI that turns machine-written profiles from "looks right" into "checked."

The reference documentation tells you what CAO does. It's a poor fit for the other half of the story — the walkthrough that takes an hour, the design decision that needs three diagrams to justify, the write-up of an orchestration that worked on real work and the two that didn't. This blog is where that goes.

Anyone who contributes to CLI Agent Orchestrator can publish here. Posts live in docusaurus/blog/ and ship through the same pull request review as the rest of the repository.