golden_path

Scope: Canonical golden path example.
Audience: External users and contributors.
Guarantees: Example uses MPI only.
Non-Goals: Full tutorial.
Why: This doc exists to record its single responsibility for review.

Overview

This doc points to the canonical example.
MPI context lives in Mpi.
Architecture context lives in Architecture.

Contracts

The example uses only MPI entry points.
The example shows agenticity, failure, and recovery.
The example runtime stays under 60 seconds on default hardware.
Example code lives in scripts/golden_path_example.py.

Invariants

The golden path remains single and canonical.
Evidence aligns with tests/regression/test_negative_results.py.
MPI meaning aligns with Core Concepts.

Failure Modes

Multiple examples dilute Mpi.
Hidden dependencies break Core.
Unlinked usage breaks Docs Style.

Extension Points

Extensions follow Experimental.
Review rules align with Triage.
MPI changes align with Surface Area.

Exit Criteria

This doc is obsolete when examples are generated.
The replacement is Mpi.
Obsolete docs are removed.

Code refs: scripts/golden_path_example.py.