Skip to content

why_not_x

Scope: Why-not-X contrasts.
Audience: Reviewers and contributors.
Guarantees: Contrasts are explicit.
Non-Goals: Full survey.
Why: This doc exists to record its single responsibility for review.

Overview

This doc lists explicit contrasts.
Architecture context lives in Architecture.
MPI context lives in Mpi.

Contracts

Workflow engines focus on orchestration, while this system focuses on bounded state transitions.
Classic MAS frameworks optimize global coordination, while this system enforces local contracts.
End-to-end LLM agents blur control, while this system enforces regulator boundaries.

Invariants

Contrasts align with Core.
Contrasts align with Execution Model.
Evidence aligns with tests/regression/test_architecture_invariants.py.

Failure Modes

Missing contrasts weakens reviewability.
Contrast drift breaks 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 contrasts are encoded.
The replacement is Core.
Obsolete docs are removed.

Code refs: tests/regression/test_architecture_invariants.py.