# 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)