Generate the journey-by-pattern grid from system-model #1580

New issue

Open

opened 2026-11-06 13:09:57 +00:00 by jared · 0 comments

jared commented

2026-11-06 13:09:57 +00:00

Owner

Problem

The journey-by-pattern grid is a one-off file, docs/system-design-format/proof/2026-11-06-os-backlog-journeys-by-pattern.html, built by a scratch script. Jared reads it to compare journeys and patterns, and it goes stale when the code changes. The LikeC4 viewer has no pattern layer.

Reproduce

n/a: feature ticket.

Approach

Add a system-model output that writes the grid for any target from the gauge data. Each row links to its LikeC4 view. Each column links to the pattern page from the pattern catalog site ticket, when that page exists. Journey step counts come from the journey files. The setup count needs a source that the generator can read, or the column goes.

Acceptance criteria

Given a target with journeys, when the generator runs, then it writes one grid page with one row per journey and one column per catalog pattern.
Given a pattern with no match for a journey, when the page renders, then the cell shows the missing roles.
Given a journey row, when a reader follows its link, then the LikeC4 view of that journey opens.

Origin

Trigger: Jared on 2026-11-06: "Let's make this a permanent piece of the design system."
Improvised this session: scratch generator grid.rb and the proof file named above.
Chain: no grid in the viewer ← pattern matches exist only in gauge text. Ends at IMPROVISATION: the scratch generator.
Root candidate: none found; searched grid, gauge, journey-by-pattern, system-model, distance_gauge
Where: plugins/os-sdlc/lib/os_sdlc/system_model/distance_gauge.rb
Session: 8720f6ad-c6db-428e-977f-7511559fbfbb
Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os/8720f6ad-c6db-428e-977f-7511559fbfbb.jsonl

VERDICT: CREATE

## Problem The journey-by-pattern grid is a one-off file, `docs/system-design-format/proof/2026-11-06-os-backlog-journeys-by-pattern.html`, built by a scratch script. Jared reads it to compare journeys and patterns, and it goes stale when the code changes. The LikeC4 viewer has no pattern layer. ## Reproduce n/a: feature ticket. ## Approach Add a `system-model` output that writes the grid for any target from the `gauge` data. Each row links to its LikeC4 view. Each column links to the pattern page from the pattern catalog site ticket, when that page exists. Journey step counts come from the journey files. The setup count needs a source that the generator can read, or the column goes. ## Acceptance criteria 1. Given a target with journeys, when the generator runs, then it writes one grid page with one row per journey and one column per catalog pattern. 2. Given a pattern with no match for a journey, when the page renders, then the cell shows the missing roles. 3. Given a journey row, when a reader follows its link, then the LikeC4 view of that journey opens. ## Origin - Trigger: Jared on 2026-11-06: "Let's make this a permanent piece of the design system." - Improvised this session: scratch generator `grid.rb` and the proof file named above. - Chain: no grid in the viewer ← pattern matches exist only in `gauge` text. Ends at `IMPROVISATION`: the scratch generator. - Root candidate: none found; searched grid, gauge, journey-by-pattern, system-model, distance_gauge - Where: plugins/os-sdlc/lib/os_sdlc/system_model/distance_gauge.rb - Session: 8720f6ad-c6db-428e-977f-7511559fbfbb - Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os/8720f6ad-c6db-428e-977f-7511559fbfbb.jsonl VERDICT: CREATE

jared added the

plugin/os-sdlc

filed-by/user

category/code-change

labels

2026-11-06 13:09:57 +00:00

jared referenced this issue

2026-11-06 15:09:57 +00:00

Build a pattern catalog site with one teaching page per pattern #1581

jared referenced this issue

2026-11-06 16:13:35 +00:00

Build a pattern catalog site with one teaching page per pattern #1581