Eve library

Eve two-track edition · 9 September 2026

Guide

Revision 1

On this page

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.