Documentation¶
This site is generated with MkDocs and the Material for MkDocs theme. The source of truth remains the Markdown files in the repository (docs/, plus root README.md, AGENTS.md, and CHANGELOG.md).
Start here — end-to-end publication
Operator checklist: Campaign result pack publication — run → validate → pack → compare → publish with committed examples.
Latest release: v0.2.5 · Roadmap (complete): v0.2.5 · Tracking (closed): v0.2.5 campaign (also first item under Publication & reports in the sidebar) · prior v0.2.4 · Publication workflow audit (evidence-driven gaps).
Site handbook (nav, CI, findings): Documentation site.
Publication workflow at a glance¶
| Step | Doc |
|---|---|
| 1. CLI & artifact reference | Benchmark campaigns — campaign run, pack, pack-check, compare-packs, compare |
| 2. Operator checklist | Campaign result pack publication |
| 3. Matrix & Markdown reports (non-campaign) | Reporting pipeline — alwm report, matrices |
| 4. CI & drift | Verification — layers: alwm validate (one file), validate-artifacts (committed sweep), just ci (full bar) |
| 5. Fingerprints & regression | Longitudinal reporting |
| 6. Walk committed trees | Campaign walkthrough |
| 7. Where examples live | Examples index — examples/ packs, campaign runs, compares |
Use the left sidebar Publication & reports (v0.2.5) for the same pages in narrative order.
Milestones & releases¶
| Latest release | v0.2.5 |
| Next milestone | Not yet defined (new work under repository root CHANGELOG.md → [Unreleased]) |
| Prior release notes | v0.2.4 · v0.2.3 · v0.2.2 · v0.2.1 |
| Arc (fingerprints & campaigns) | v0.2.0 roadmap |
Browse by area¶
- Workflows — Benchmarking, reporting (also under Publication & reports in the site nav), local dev, smoke, multi-agent parallel, Documentation site handbook (MkDocs nav,
just docs-build, CI). - Architecture — Data model, browser, runtime.
- Audits — Capability classification, schema drift inventory.
- Tracking — Campaign orchestration, v0.2.5 tracking (closed), v0.2.4 tracking (closed).
Repository files on GitHub¶
Canonical root files are not duplicated in this build; open them on GitHub:
See Contributing for uv setup ([dev,docs]) and just docs.