# Eve two-track edition · 9 September 2026

The user reviewed the Eve section and asked for it to be rich, beautiful,
perfectly arranged, easy to understand and to flow. The diagnosis, the decisions
they made, and what this first delivery changes are recorded here so the
remaining chapters can follow the same system.

## What was wrong

Rendered review of the 25-guide, 217-slide Eve route on 9 September found:

- 123 of 217 slides were a table, a comparison grid or prose columns; only 3
  slides showed an image although 12 real workbench captures already existed.
- Every slide shared one skeleton (kicker, headline, subtitle, centred table,
  takeaway) with no covers, dividers or summaries, and about a third of each
  slide was empty.
- Six guides ended every title with a full stop and nineteen did not; three
  kicker formats were in use; every footer said "Architecture & flows" even in
  the how-to guides.
- Thirteen sidebar folders hid two real tracks; eight folders held one or two
  guides; overview and detail guides on the same topic appeared as unrelated
  siblings.
- `eve-four-planes` drew Experience, Reasoning, Execution and Governance planes
  while its own text and narration taught Member, Builder, Agent and Quality.

## Decisions (user, 9 September 2026)

1. Merge the 25 guides into **12 chapters in two tracks**: _Use Eve_ (six
   chapters) and _How Eve works_ (six chapters). Every existing slide id is
   kept; the merged guides concatenate their predecessors in reading order.
2. Add a **second accent** for Eve-owned things: teal `#1d5c63`, beside the
   library's terracotta. Terracotta now marks the member and Lilith.
3. Redesign one guide first, the opener, so the look can be approved before the
   remaining eleven chapters are rewritten in the same system.

## The Eve edition

`designEdition: "eve"` on a slide selects the edition. It adds:

- **Chapter chrome.** A strip above the title names the track, shows a six
  segment position bar and the chapter number, and keeps the dated source scope
  at the right. The footer names the track and chapter. Both derive from the
  catalog's `tracks` object and each guide's `track` field; nothing is authored
  per slide.
- **Four actors, one vocabulary.** Member (terracotta, meets Lilith), Builder
  (teal, works with Eve), Agent (ochre) and Verifier (slate) share fixed colours
  and glyphs across every layout that names an actor.
- **Layouts.** `chapter-cover` (promise, running example, listening time, three
  things you will learn), `chapter-close` (three things to remember and a bridge
  card linking to the next chapter), `actor-map`, `card-grid` (two to six glyph
  cards with an optional actor colour and evidence line), `capture-callouts`
  (one pinned real capture with numbered pins and a legend) and `step-journey`
  (three to five numbered steps coloured by the acting actor, each naming what
  it leaves behind, with labelled handoffs between them). All are validated in
  `tools/presentations/presentation_eve_edition.py`; a cover or close renders
  without the repeated figure caption.
- **Voice rules.** Titles are short names of nine words or fewer without a
  terminal full stop; the validator enforces both.

The chapter strip and the cover's listening time come from `track_contexts()` in
the builder, which numbers chapters, measures verified narration and names the
previous and next guide.

## Delivered in this increment

- Catalog: 12 Eve guides on two tracks; reading routes `eve-course`,
  `eve-workbench` (Use Eve), `eve-architecture` (How Eve works) and
  `eve-overview` (the two opening chapters). Retired deck files were removed.
- Chapter 1, **Meet Eve** (`content/57-eve-meet.json`, nine slides): a cover,
  the rewritten opening question, the actor map, four surface cards, the real
  Explorer capture with five callouts, three progress cards, the four-step
  journey, four refusal cards and a close that bridges to the product graph.
  Four slides are new; five keep their ids with new titles, subtitles and
  lighter notes.
- The four-planes diagram in `diagrams.json` now shows Member, Builder, Agent
  and Quality planes, matching its narration.
- Assignment, capability-teaching and test bindings were remapped from the old
  guide ids to the merged ones; no slide binding changed.

## Not yet done

Chapters 2 to 12 still render their inherited slides in the field-guide edition.
Every slide of a tracked chapter already carries the chapter strip and the
track-and-chapter footer, but their tables, titles and structure are untouched
until each is rewritten. Historical authoring ledgers
(`eve-quality-ledger.json`, `eve-design-changes.json`,
`eve-depth-source-map.json`, `v1-audit-baseline.json`) keep the old guide ids as
a record of the earlier passes.
