syntaxai/tdd.md · commit aca2b1e

Redesign sama-layers image based on feedback (v2)

Original image was strak/manifest-style but didn't differentiate the
layers visually or land the core message clearly. Five concrete pieces
of feedback addressed:

1. Core vs Pure disambiguation:
   Layer 1 Core → "domain decisions — business logic · policies"
   Layer 0 Pure → "deterministic primitives — types · constants"
   (Spec names stay; only the per-box subtitle is sharper.)

2. Visual differentiation between layers:
   Each box gets an 8px colored left-stripe forming a warm-to-cool
   gradient top to bottom — Entry amber, Adapter orange, Core teal,
   Pure green. Reads as "volatile/external at top, stable/foundation
   at bottom" without being garish.

3. Replaced "may import 0, 1, 2" labels:
   Per-box import-list labels removed. Direction is now told by
   simple "↓ uses" labels between boxes. Less cognitive load.

4. Concrete worked example threaded through all four boxes:
   POST /checkout → Stripe.charges.create() → applyPaymentRules()
                 → Money(amount, currency). Each italic line colored
   to match its layer's stripe, creating implicit visual chaining
   without explicit arrows between examples.

5. Main message scaled up:
   "Imports only flow downward." is now the 38pt headline. The full
   §1.2 Law lives below as a 16pt subtitle.

Image bumped to ?v=2 in the markdown reference so the new render
lands immediately on visitors who saw v=1.

Co-Authored-By: Claude Opus 4.7 <[email protected]>

author

syntaxai <[email protected]>

date

2026-05-24 12:43:43 +01:00

parent

9f41d89

commit

aca2b1e133a0b37d4d0076f8913051982c868429