|
Track A produces proof-grade artifacts such as bundles, manifests, hashes, and verification results. Track B produces hypotheses, exploratory reasoning, and live workspace investigation state. Use the proof path when later humans or CI must trust the output. Use the live path when the work is still moving. |
cx now ships a curated documentation site with four cooperating surfaces:
-
native proof path:
bundle,validate,verify,extract -
live workspace path:
mcp -
durable cognition path:
notes -
adapter/oracle path: expert diagnostics and parity only
This Antora site is the front door for the curated documentation surface.
The canonical curated source now spans docs/modules/ROOT/ for shared and
repository-reference content plus docs/modules/onboarding/,
docs/modules/manual/, and docs/modules/architecture/ for the
published concern-specific modules.
Run
What to type to ship something today.
-
cx init --stdout -
cx inspect --token-breakdown -
cx bundle --config cx.toml -
cx verify dist/<project>-bundle --against . -
Manual Overview for the shortest route to commands and workflows.
-
Operating Modes for choosing between live MCP, bundles, and notes.
-
Friday to Monday workflow for live exploration to proof handoff.
-
Agent integration for repository-local AI workflows.
Understand
Why CX is shaped this way.
|
The Antora site is the curated documentation surface. The |
-
Architecture Overview for the arc42-based architecture spine.
-
Mental Model for the CX triad and trust spectrum.
-
System Contracts for the proof and handoff boundaries.
-
Render Kernel Contract for native rendering invariants.
-
Release and Integrity for release assurance, schema publishing, and v0.4 closure.
Why this site exists
The repository already behaves like a governed documentation system rather than a casual Markdown folder. Antora gives that system explicit navigation, page classes, breadcrumbs, reusable primers, and a clearer separation between onboarding, reference, architecture, workflows, and release material.