Eve library

Chapter 2 · Explore the product graph · brief · 10 September 2026

Guide

Revision 1

On this page

The second chapter of the Use Eve track, rewritten in the Eve edition on 10 September 2026. It follows the plan agreed on 9 September and recorded in EVE-V1-REDESIGN-TODOS.md. The receipt for the delivery is under verification/; this file records what the chapter is for and why it is shaped this way.

The job#

Chapter one ends with a question it deliberately does not answer: Enrollment in Tara has no mapped journey, and what should happen next is not obvious. This chapter answers it by teaching the reader to read the product graph themselves, and it ends by producing the one work item chapter three follows through triage, execution and delivery.

Running example. Enrollment in Tara has no mapped journey. What should happen next? — the same example chapter one introduced, carried through all twenty-two slides.

Three learning promises (the cover)#

  1. The shape of the graph — what contains what, which verb joins two records, and which links cross between areas.
  2. How to inspect one feature — open it in the Explore lens and read the inspector rather than the highlight.
  3. What counts as evidence — coverage verdicts, waivers, freshness, and the one action a gap actually justifies.

Three things to remember (the close)#

  1. The verb is the claim. Containment locates; a verb asserts. Keep the verb and the identifier when you explain anything.
  2. Check the scope, then the answer. An exact-node read and a containment-wide read both look complete, and only one answers your question.
  3. A label starts an investigation. Unverified does not mean broken, and a nearby passing test does not mean done.

Bridge to chapter three. One work item, its observed and expected behaviour, and the evidence that would close it — followed from capture to a verified delivery.

Sections#

Four sections of four content slides each, opened by a section-divider that names all four so a reader arriving in the middle can place themselves.

Section Slides
Read the graph spine, edges, cross-links, planes
Inspect a feature explorer walk, neighbourhood, inspector scope, exercise
Read coverage analysis questions, coverage verdicts, waivers, freshness
Turn a gap into work route impact, backlog reconciliation, decisions on gaps, exercise

Treatment decisions#

  • Three graph diagrams, not one. Containment, verbs and cross-links are three different claims about the same flow, and running them together was what made the old containment and relation maps hard to read. Each diagram keeps the Enrollment flow in focus so the reader's eye has one fixed point.
  • The planes are three cards, not two columns. There are three planes — compiled knowledge, the serving runtime and live intent — so a two-column comparison would have had to merge two of them. The card grid names each and what changes it.
  • The inspector capture stands beside its legend. explorer-selection.png is taller than it is wide, so imageLayout: "side" keeps each pin within a glance of its meaning.
  • The two matching rules are a compare panel. The inspector and the work-list tool differ in kind, not in degree, and the slide exists because both of their answers look complete. A verdict line says which question each one answers.
  • Two step journeys, not four cards. The reconciliation and the closing exercise are both ordered, and each step leaves a record the next one needs; cards would have lost the order and the handoffs.
  • The freshness record keeps its layout and gains the Eve edition's actor chip and field tones: the Verifier owns the record, and the two evidence fields are toned apart from the one knowledge field.

What was rebound#

  • content/59-eve-coverage-analysis.json merged into content/58-eve-product-graph.json; every slide id kept.
  • authoring/eve-capability-guides.json: the two entries for this guide became one, with the merged manuscript and all twenty-two slides.
  • authoring/eve-capability-teaching.json: the two assignments for this guide carry the rewritten slides' titles and takeaways.
  • assignments/eve-product-graph.json: both units re-read against the rewritten planes slide, with a dated re-review note and a new slide fingerprint.
  • Tests that used chapter 2 slides as fixtures for field-guide layout contracts were rebound to slides that still use those layouts.