Correct the pattern pages from the research rounds #1611

New issue

Open

opened 2026-11-06 18:46:00 +00:00 by jared · 0 comments

jared commented

2026-11-06 18:46:00 +00:00

Owner

Problem

The 24 pages under plugins/os-sdlc/pattern-pages have errors. Seven pages teach a different form from their name: AR, BLD, FRC, MAP, MVC, P&F, SVC. Each page shows a one-line source with no links. Jared needs each page to be accurate, useful, and clear for a quick read: what the pattern is about, when to use it or not, and how to deploy it.

Observed

docs/system-design-format/pattern-research/README.md holds the findings, with one file per pattern beside it (commit 11bb7a13). Rulings 40 to 51 in docs/decisions/rulings.tsv settle the first decisions.

Reproduce

n/a: documentation and catalog metadata; the research files name each line.

Approach

One AFK batch, by the standard above. Take page text from section 6, section 7, and section 9 of each research file.

Required work:

README T1: correct the page lines that are wrong under every option.
Apply the page texts for conflicts C1, C3, C4, and C7.
Rewrite AR, BLD, FRC, MAP, MVC, P&F, and SVC by the file recommendations.
README T2: correct the source: citations. Cite by chapter, with no book years (ruling D9).
README T3: add a sources list to each page with citation, link, and research-file link. Change SECTIONS in pattern_site/entry.rb so the site shows it, and require it in /os-sdlc:pattern-page.
Display names: Command Dispatcher (D1) and Simple Factory (D2), with their landscape lines. Keep the ids and file names.
Set strict?: false on REPO (D57). Drop the LAY DataSource to Domain pair (D55).
Name Factory Method and Abstract Factory on the Simple Factory page (D73). Correct landscape line 109 (D72).

Rejected: book checks; unverified tags stay. Rejected: new catalog tests; these are parked on a separate ticket.

Acceptance criteria

Given the batch, when plugins/os-sdlc/bin/system-model pattern-site runs, then the build passes.
Given any page, when a reader opens it, then it shows what the pattern is about, when to use it or not, how to deploy it, and its sources with links.
Given the seven wrong-form pages, when a reader compares each example with the page name, then the example shows the named pattern.

Non-goals

Pages for Factory Method and Abstract Factory. New facts. Replacement tests.

Origin

Trigger: the pattern research rounds in session 99cf732f, asked for by Jared.
Improvised this session: none
Chain: page errors ← pages written from secondary knowledge ← no source check at page creation (#1581). End: DESIGN, plugins/os-sdlc/skills/pattern-page.
Root candidate: none found; searched pattern page, pattern_site, pattern-pages, pattern-research, entry.rb
Where: plugins/os-sdlc/pattern-pages/*.yml
Session: 99cf732f-5c43-4b14-8f5e-59712e2e9ba9
Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os/99cf732f-5c43-4b14-8f5e-59712e2e9ba9.jsonl

VERDICT: CREATE

## Problem The 24 pages under `plugins/os-sdlc/pattern-pages` have errors. Seven pages teach a different form from their name: AR, BLD, FRC, MAP, MVC, P&F, SVC. Each page shows a one-line source with no links. Jared needs each page to be accurate, useful, and clear for a quick read: what the pattern is about, when to use it or not, and how to deploy it. ## Observed `docs/system-design-format/pattern-research/README.md` holds the findings, with one file per pattern beside it (commit 11bb7a13). Rulings 40 to 51 in `docs/decisions/rulings.tsv` settle the first decisions. ## Reproduce n/a: documentation and catalog metadata; the research files name each line. ## Approach One AFK batch, by the standard above. Take page text from section 6, section 7, and section 9 of each research file. Required work: 1. README T1: correct the page lines that are wrong under every option. 2. Apply the page texts for conflicts C1, C3, C4, and C7. 3. Rewrite AR, BLD, FRC, MAP, MVC, P&F, and SVC by the file recommendations. 4. README T2: correct the `source:` citations. Cite by chapter, with no book years (ruling D9). 5. README T3: add a `sources` list to each page with citation, link, and research-file link. Change `SECTIONS` in `pattern_site/entry.rb` so the site shows it, and require it in `/os-sdlc:pattern-page`. 6. Display names: Command Dispatcher (D1) and Simple Factory (D2), with their landscape lines. Keep the ids and file names. 7. Set `strict?: false` on REPO (D57). Drop the LAY `DataSource` to `Domain` pair (D55). 8. Name Factory Method and Abstract Factory on the Simple Factory page (D73). Correct landscape line 109 (D72). Rejected: book checks; unverified tags stay. Rejected: new catalog tests; these are parked on a separate ticket. ## Acceptance criteria 1. Given the batch, when `plugins/os-sdlc/bin/system-model pattern-site` runs, then the build passes. 2. Given any page, when a reader opens it, then it shows what the pattern is about, when to use it or not, how to deploy it, and its sources with links. 3. Given the seven wrong-form pages, when a reader compares each example with the page name, then the example shows the named pattern. ## Non-goals Pages for Factory Method and Abstract Factory. New facts. Replacement tests. ## Origin - Trigger: the pattern research rounds in session 99cf732f, asked for by Jared. - Improvised this session: none - Chain: page errors ← pages written from secondary knowledge ← no source check at page creation (#1581). End: DESIGN, `plugins/os-sdlc/skills/pattern-page`. - Root candidate: none found; searched pattern page, pattern_site, pattern-pages, pattern-research, entry.rb - Where: `plugins/os-sdlc/pattern-pages/*.yml` - Session: 99cf732f-5c43-4b14-8f5e-59712e2e9ba9 - Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os/99cf732f-5c43-4b14-8f5e-59712e2e9ba9.jsonl VERDICT: CREATE

jared added the

plugin/os-sdlc

filed-by/user

category/code-change

labels

2026-11-06 18:46:00 +00:00

jared referenced this issue

2026-11-06 18:46:11 +00:00

Replace the catalog tests that do not detect their patterns #1612

jared referenced this issue from a commit

2026-11-06 20:25:09 +00:00

docs(decisions): record the pattern wrap-up rulings (#1611)