ai-agents-metrics

ARCH-008: Write CLI command reference

Priority: medium Complexity: low Status: done

Problem

The project has 40+ CLI commands. To understand what a specific command does, its flags, and its behaviour, you need to read argparse definitions in cli.py. This is expensive to do at the start of every session.

Desired state

A docs/cli-reference.md file with a table of commands grouped by purpose:

For each command: purpose, key flags, typical usage example.

Acceptance criteria