---
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](https://github.com/syntaxai/tdd.md/pull/36).