# V9 — Features (Page Index)

This directory decomposes the single [`../V9_features.md`](../V9_features.md)
hub into focused, in-depth, code-grounded pages. The hub remains the canonical
entry point and preserves its heading anchors (so existing cross-references keep
resolving); each page below expands one section with far richer, code-grounded
detail. The companion architecture section lives at
[`../architecture/README.md`](../architecture/README.md).

> **Cross-reference convention.** A bare `§N` / `§N.M` points at a section of
> the backlog [`../V9_TODOS.md`](../V9_TODOS.md); `deps§N` points at
> [`../V9_DEPENDENCIES.md`](../V9_DEPENDENCIES.md); page-to-page links are
> relative (`./<slug>.md`, or `../architecture/<slug>.md` for the companion).

## Feature landscape

```mermaid
flowchart LR
  Learner[Learner wonder] --> Atlas[Atlas concept prerequisite and gap resolution]
  Atlas --> Prometheus[Prometheus solve-first lesson forge]
  Prometheus --> Truth[Sophia sources Nyx and Kalika computed truth]
  Truth --> Chiron[Chiron embodied Socratic teaching]
  Truth --> Hephaestus[Hephaestus reachable explorables]
  Chiron --> Gates[Aletheia truth pedagogy completeness safety and provenance]
  Hephaestus --> Gates
  Gates --> Lesson[Versioned accessible lesson artifact]
  Lesson --> Mastery[Threads Mnemosyne mastery and retrieval]
  Mastery --> Theia[Theia braid Commons and next better question]
  Theia --> Atlas
  Gates --> Evidence[(Sources kernels verdicts provenance and replay)]
  Evidence --> Operations[Governance cost localization LMS delivery retraction and rollback]
```

The landscape shows one learning loop, not a content funnel. Wonder is scoped to
prerequisites and authority before generation; teaching and exploration are
gated as a complete lesson; demonstrated evidence updates mastery; continuation
returns to the knowledge spine. Engagement alone never advances truth or
mastery.

Use this index to select the learner-facing job, pair it with the owning
[architecture page](../architecture/README.md), and trace concept/source/kernel
pins, objectives, claims, activities, solutions, gate versions, artifact
versions, learner consent, mastery evidence, fallback, and retraction. Then
inspect product/gap/research/dependency documents, backlog, current
code/tests/artifacts, learner evidence, and operations before assigning status.

Every focused feature page appears exactly once below. The
[V9 documentation guide](../docs/README.md) supplies role-based paths and the
lesson-truth model; the [diagram atlas](../docs/diagram-atlas.md) supplies
knowledge, lesson, data, lifecycle, composition, learner, and release views.
Poetic framing remains explicitly separate from empirical claims and computed
truth.

## Orientation

- [Metis — A Curious Ape's Guide to Reality (Product Overview)](./overview.md) —
  the integration+productization thesis, the five atoms
  (Metis/Wonder/Lesson/Thread/Atlas), the seven wonder axes, and the nine-moment
  learner journey at a glance
- [Subsystem Map, Substrate Reuse, and the Seven Gates](./subsystem-map-and-gates.md)
  — the nine Promethean codenames mapped to their real libs/v9 packages and the
  V1–V8 substrates each composes, plus the G1–G7 release-gate contract every
  lesson must pass

## Generating a Verified Lesson

- [The Atlas of Reality and Wonder Resolution](./atlas-wonder-resolution.md) —
  how a free-text wonder resolves to a mastery-scoped prerequisite frontier —
  graph unification, BM25+dense retrieval, Mnemosyne gap-finding, and the two
  node grounding invariants
- [Prometheus — the Solve-First Lesson Forge](./prometheus-lesson-forge.md) —
  the eight-stage solve-first pipeline
  (resolve→ground→plan→write→explorable→assess→gate→compile), Aletheia's
  truth/accuracy gating, and the verified-skeleton vs regenerable-surface lesson
  artifact

## Delivering and Remembering the Lesson

- [Chiron and Hephaestus — the Embodied Teacher and Explorables](./chiron-and-hephaestus.md)
  — the live Socratic tutor (integrity modes, avatar→voice→text fallback,
  grounded personas) and the manipulable computed-kernel explorables (Nyx sky,
  Kalika orbit) with demonstrably-reached success states
- [Threads, the Personal Atlas, and the Mnemosyne Mastery Loop](./threads-and-mastery-loop.md)
  — the next-better-question thread, the brightness-as-mastery star map, and the
  FSRS knowledge-trace + IRT adaptive difficulty + spaced-retrieval checkpoint
  that feeds mastery back to wonder-scoping

## Soul, Commons, and Platform

- [The Soulful Braid, the Agora Commons, and Explainer Films](./braid-commons-and-films.md)
  — the awe→curiosity→understanding emotional arc and science↔human braid,
  creator-authored guided journeys and shareable objects, and verified
  generative widgets + Manim-style explainer films
- [Governance, Cross-Cutting Discipline, Non-Goals, and Definition of Done](./governance-and-boundaries.md)
  — the AgentRun governance plane (DAG/budget/kill-switch/replay,
  no-eighth-loop), entitlement/age/region gating,
  determinism/cost/a11y/LMS/anti-metric discipline, and the six boundaries +
  seven-point GA bar