agent-mux docs

This section has three tracks:

• Reference — the canonical API and behavior contract for @a5c-ai/agent-mux
• Tutorials — task-oriented walkthroughs and usage guides
• Archive — historical comparisons, design proposals, research, and superseded planning material

Source of truth

reference/ is the normative source of truth for current @a5c-ai/agent-mux behavior.

If a tutorial or archived document conflicts with a reference page, the reference page wins.

Start here

• Package users: start with Reference
• First-time users: start with Getting Started, then confirm details in Reference
• Historical context, parity notes, and exploratory design work: see Archive

Publishing contract

• reference/ defines current behavior and API surface
• tutorials/ is discoverable but non-normative
• archive/ is preserved for context and is not source-of-truth

The main docs site consumes these markdown files directly. Keep the track boundaries explicit.