ambek .planning

2026-10-23 22:37:55 +08:00
parent e512104d5e
commit 275879a18b
54 changed files with 9921 additions and 0 deletions
@@ -0,0 +1,57 @@
+# 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)