---

slug: sama-rewrite-v2-first title: Rewrite /sama using the SV "latest is default, legacy preserved" pattern date: 2026-05-24 branch: sama-v2-first-images pr_number: 36 merge_sha: fd50ede status: lossy related_posts: []

Recovered opening (from prior-session conversation summary, paraphrased):

Goal: Rewrite /sama using the Silicon Valley "latest is default, legacy is preserved" pattern (Stripe, Vue, React). Same canonical URL, v2-first content above the fold, v1 four-disciplines content preserved below a horizontal rule. Create three new images so the page isn't text-only: sama-hero (1200x630 with live-state strip), sama-layers (four-layer diagram with downward import arrows + §1.2 Law caption), sama-metrics (horizontal bar chart of the n=8 workingSetFit datapoints with tdd.md highlighted as SAMA-disciplined). Each v1 discipline page (/sama/sorted, /sama/architecture, /sama/modeled, /sama/atomic) gets a Stripe-style older-version banner prepended.

What is preserved from the original /goal: only the opening sentence above, recovered from the prior-session conversation summary at the start of this conversation. The full Done when clauses, Constraints (anti-fudge), and Load-bearing files sections did not survive summarization.

What landed: /sama redesigned with v2-first content + three new images. Discipline pages got the Stripe-style v1 banner via samaSlugHandler in d21_handlers_sama.ts. URLs unchanged; v1 content preserved verbatim, just relocated. 367/367 tests pass; /sama/v2/verify still 7/7 ✓. See PR #36.