Phase 1: Design Tokens + Rams Foundation - Discussion Log
Audit trail only. Do not use as input to planning, research, or execution agents.
Decisions captured in CONTEXT.md — this log preserves the analysis.
Date: 2026-10-22
Phase: 01-design-tokens-rams-foundation
Mode: default (interactive)
Areas Discussed
Token package format
| Question |
Options presented |
Selection |
| Package form |
Tailwind v4 @theme / v3 JS config / plain CSS vars + adapter |
Tailwind v4 CSS-first (@theme) |
| Naming |
Mirror mockup names / semantic rename / you decide |
Mirror mockup names |
| Bare tokens vs tokens + rendered sheet |
Tokens + sheet / tokens only / you decide |
Tokens + rendered sheet |
| Telegram light/dark pre-planning |
Pre-slot dual theme / defer to Phase 3 / you decide |
Pre-slot dual theme |
Source-of-truth resolution
| Question |
Options presented |
Selection |
| Root DESIGN.md conflict |
Supersede + keep philosophy / merge + rewrite / archive |
Supersede, keep philosophy |
| Fate of mockups + inline Tailwind blocks |
Stay read-only / migrate mockups / you decide |
Mockups stay read-only |
| Owner of numeric values |
Package owns / docs own / you decide |
Package owns values |
Basemap styling depth
| Question |
Options presented |
Selection |
| Rams-ification depth |
Full Rams pass / grayscale only / iterate in gallery |
Full Rams pass |
| Color sourcing |
Derived from tokens / fork + hand-tune / you decide |
Derived from tokens |
| Label typography |
Rams fonts / stock / compare in gallery |
Rams fonts in labels |
Component sheet + gallery scope
| Question |
Options presented |
Selection |
| Sheet components |
Mockup-derived set / core primitives / you decide |
Mockup-derived set |
| Gallery form |
Static side-by-side / interactive tool / you decide |
Static side-by-side page |
| DSGN-01 audit |
Automated / manual / you decide |
Automated token audit |
| Render production |
Playwright / manual captures / you decide |
Playwright screenshots |
Build pipeline choice
| Question |
Options presented |
Selection |
| Phase 1 tooling |
Minimal npm + v4 CLI / full framework / CSS only |
Minimal npm + v4 CLI |
| Fonts |
Self-host woff2 / keep Google Fonts CDN / you decide |
Self-host fonts |
| CI scope |
Local scripts / CI day one / you decide |
Local scripts first |
Corrections Made
No corrections — user accepted recommended options throughout.
Deferred Ideas
- Interactive compare tool (revisit if gallery review painful)
- Incident-report interaction flows (v2: REP-01/02)
- CI workflow (Phase 2)
