Skip to content

SPINE

Scope: Single navigation spine for docs/.
Audience: Readers consuming docs top-down.
Guarantees: Lists all docs in order.
Non-Goals: Per-topic READMEs.
Why: This doc exists to record its single responsibility for review.

Overview

This doc defines one responsibility.
Architecture components are defined in Architecture.
Read Index before edits.
Read Docs Style for context.

Contracts

Each statement is a contract.
Contracts align with mkdocs.yml.
Contracts link to Index and Docs Style.

Invariants

Invariants describe stable behavior.
Checks align with mkdocs.yml.
Invariants align with Index.

Failure Modes

Failures are explicit and tested.
Failure coverage aligns with mkdocs.yml.
Failures align with Docs Style.

Extension Points

Extensions require tests and docs.
Extensions are tracked in Index.
Extensions align with mkdocs.yml.

Exit Criteria

This doc becomes obsolete when the surface ends.
The replacement is linked in Docs Style.
Obsolete docs are removed.

Code refs: tests/unit/test_docs_contract.py.
Docs list:
- Docs Style
- Docs Voice
- Naming
- Triage
- Spine
- Index
- Getting Started
- Core Concepts
- Core
- Semver
- Anti Patterns
- Roadmap Ceiling
- Positioning
- Release Identity
- Agentic Criteria
- Agent Taxonomy
- Formal Model
- Falsifiable Claim
- Decisive Experiment
- Ablation Studies
- Neutral Results
- Reviewer Premortem
- System Schematic
- Mpi
- Golden Path
- Misuse Guards
- Surface Area
- Sandbox
- Invariant Visualization
- Why Not X
- Architecture
- Invariants
- Experimental
- Llm Authority
- Execution Model
- Execution Lifecycle
- Design Debt
- Cli
- Cli Surface
- Overview
- Schema
- Dependencies
- Threat Model
- Citation