jonnifyagile agents
jonnify / Agile Agent Workflow / A3 · The roadmap layer / A3.9 / A3.9.3 · The idea→framework crosswalk

A3.9 · Glossary & references · dive 3

The crosswalk

Each course idea mapped to the /elixir/phoenix chapter that implements it — the nine F6 rungs as routes you can open.

The crosswalk is where the course's abstractions become routes: lifecycle, routing, ecto, contexts, heex, liveview, pubsub, deployment, live-dashboard — each 200, all under one master invariant. Pick an idea on the right to get its rung and route; the section below groups the rungs into the three shippable milestones.

Idea to rung to route · pick an idea

the F6 ladder · nine rungs over one facade F6.9 · live-dashboard — the operations dashboard F6.8 · deployment — deploy as a release F6.7 · pubsub — multi-client live updates F6.6 · liveview — interactivity F6.5 · heex — the rendered catalog F6.4 · contexts — the domain over the facade F6.3 · ecto — durable persistence F6.2 · routing — the walking skeleton F6.1 · lifecycle — the tracer bullet
Idea "tracer bullet" → F6.1 → /elixir/phoenix/lifecycle: the engine served as a web app — request → facade → render, the first end-to-end shot.

The crosswalk

A crosswalk row maps a course idea to the F6 rung that realises it, the /elixir/phoenix chapter, and what that rung ships. The nine rungs are verbatim from the F6 phoenix.roadmap.md — three milestones, one shippable capability per rung, all of it over the unchanged Portal facade.

the tracer bullet / served appF6.1/elixir/phoenix/lifecycle
the walking skeleton / route surfaceF6.2/elixir/phoenix/routing
durable persistenceF6.3/elixir/phoenix/ecto
the domain over the facadeF6.4/elixir/phoenix/contexts
the rendered catalogF6.5/elixir/phoenix/heex
interactivity / inspect-and-adaptF6.6/elixir/phoenix/liveview
multi-client live updatesF6.7/elixir/phoenix/pubsub
deploy as a releaseF6.8/elixir/phoenix/deployment
the operations dashboardF6.9/elixir/phoenix/live-dashboard

The master invariant spans all nine: the web layer calls only the Portal facade and renders only the closed %Portal.Error{} set.

The three milestones

The nine rungs climb in three milestones, each a shippable product step: ship the catalog, make it live, ship to users. Pick a milestone to light its rungs and read the end-state — the thing a real role can do once the milestone lands.

Rungs grouped into milestones · pick a milestone

three milestones over the nine rungs F6.9 · live-dashboard F6.8 · deployment F6.7 · pubsub F6.6 · liveview F6.5 · heex F6.4 · contexts F6.3 · ecto F6.2 · routing F6.1 · lifecycle
Milestone 1 · Ship the catalog → F6.1–F6.5 (lifecycle, routing, ecto, contexts, heex). At the end: browse a persistent catalog and add courses, server-rendered, with inline errors.

A roadmap orders the work into shippable milestones — each a product step a real role can use, not a technical layer.

The crosswalk on the Portal

The crosswalk is the F6 phoenix.roadmap.md read as a lookup table. Take "durable persistence": the roadmap line is F6.3, the milestone is "ship the catalog", the spec it points at is the F6.3 triad, and the behaviour the line defines is none — the line orders the work; the spec defines it. Open /elixir/phoenix/ecto and the idea is built code: the Postgres adapter behind the F5 port, the changeset the parse boundary.

# One crosswalk row, from the F6 phoenix.roadmap.md:
#   idea:      durable persistence
#   rung:      F6.3
#   milestone: ship the catalog
#   points at: the F6.3 spec triad  (behaviour defined by the line = none)
#   route:     /elixir/phoenix/ecto  (the idea as built code)

# Re-ordering the rungs never edits a spec — the line carries order, not behaviour.
the principle

A roadmap line orders the work and points at a spec; it defines no behaviour — re-ordering the rungs never edits a spec.

on the Portal

The F6 phoenix.roadmap.md is exactly that — nine lines, three milestones, each pointing at a rung's spec and its /elixir/phoenix chapter.

The crosswalk turns the course into routes — every idea to a rung, every rung to a chapter of built code, all of it under one master invariant.

References

The delivery sources behind the roadmap, and the sibling reference dives.

Sources

Related in this course