# Mokosh Brand Decisions v1 (2026-05-17)

Snapshot of the 9 brand/design decisions resolved against the designer team's
handoff (delivered to `.planning/intel/design-incoming/`). User reviewed the
Decision Brief in browser; accepted designer's recommendations on D-01..06,
D-08, D-09; overrode D-07.

## Resolutions

| # | Decision | Owner | Designer recommendation | User pick | Note |
|---|---|---|---|---|---|
| D-01 | Mark concept | Design | A · Loom (2×2 weave intersection) | **A** (accepted) | Unlocks PNG icon rasterization from `mokosh-mark.svg` |
| D-02 | Welcome layout | Design | A · Hero + Loom dial (text left, dial right) | **A** (accepted) | Unlocks Plan 01-10 (`src/welcome/` build) |
| D-03 | Voice register | Brand | A · Sober (short commands, periods, no extra) | **A** (accepted) | Carries to all i18n strings |
| D-04 | Palette | Design | A · Loom (warm linen + natural dyes: madder/moss/amber/brick) | **A** (accepted) | `tokens.css` palette is canonical |
| D-05 | Type pairing | Design | A · Newsreader (serif display) + IBM Plex Sans (UI body, Cyrillic) + IBM Plex Mono (diagnostic) | **A** (accepted) | All three OFL; unlocks WOFF2 self-hosting (replaces Google Fonts `@import` in `tokens.css:12`) |
| D-06 | Icon strategy | Design | A · Neutral mark + dynamic badge (`chrome.action.setBadgeBackgroundColor`) | **A** (accepted) | Matches engineering's current arch; NO A-06 per-state PNG set |
| **D-07** | **Display name (`manifest.json:name`)** | Brand | A · `Mokosh` | **B · `Mokosh — Session Capture`** | **OVERRIDE** — operator-facing name surfaces capture purpose |
| D-08 | Tagline (RU+EN parallel) | Brand | A · `«Тридцать секунд назад, всегда под рукой.»` / `"Thirty seconds ago, always at hand."` | **A** (accepted) | `manifest.json:description` + welcome hero copy |
| D-09 | Smoke shipping | Eng + Both | A · Dev-only (behind VITE_DEV flag) | **A** (accepted) | Current production bundle accidentally ships smoke page — Plan 01-12 task to gate it |

## 8 i18n copy strings (deferred per-string)

Designer flagged 8 operator strings in Brief §02 (popup CTA, badge tooltips,
notification titles + messages, welcome copy, etc.) that need final wording.
These **INHERIT the D-03 Sober register default** unless user overrides on a
per-string basis. Plan 01-12 (Design Integration) will surface each for ack
as it lands.

## Implementation handoff (what Plan 01-12 must do)

- **D-01 + D-06**: Rasterize `mokosh-mark.svg` to `icons/icon{16,48,128}.png` (PNG required by Chrome notification API; SVG ≠ acceptable). Preserve neutral mark across all states; no per-state variants.
- **D-04**: Ingest `tokens.css` `--mks-*` color palette as authoritative; rewire `src/popup/`, `src/welcome/`, smoke.sh to use these tokens. Replace engineering placeholder palette (`#212121`/`#00C853`/etc.) entirely.
- **D-05**: Self-host Newsreader (variable) + IBM Plex Sans (4 weights) + IBM Plex Mono (2 weights), Latin + Cyrillic subsets, WOFF2 only. Remove Google Fonts `@import` from `tokens.css:12` (MV3 CSP). Bundle via Vite asset pipeline.
- **D-07**: Update `manifest.json:name` to `"Mokosh — Session Capture"`. Consider i18n via `_locales/` if RU variant differs from EN (per Chrome MV3 best practice — manifest:name = `"__MSG_extName__"` with `default_locale`).
- **D-08**: Update `manifest.json:description` to the tagline (one of the RU/EN per default_locale). Carry to welcome hero copy.
- **D-02**: Plan 01-10 builds welcome tab with Hero + Loom dial layout (designer's Surface Kit §05 option A).
- **D-09**: Gate smoke page behind `VITE_DEV` flag in `vite.config.ts` so production `npm run build` excludes it. Current state ships smoke unintentionally.

## Source artifacts

- `.planning/intel/design-incoming/mokosh/dist/Decision Brief (standalone).html` — full Brief with options + recommendations
- `.planning/intel/design-incoming/mokosh/dist/Mokosh Surface Kit (standalone).html` — interactive design canvas
- `.planning/intel/design-incoming/system/bundle/mokosh-handoff/tokens.css` — production token system
- `.planning/intel/design-incoming/system/bundle/mokosh-handoff/assets/mokosh-mark.svg` — 32×32 brand mark
- `.planning/intel/design-incoming/system/bundle/mokosh-handoff/assets/mokosh-lockup.svg` — 240×56 mark + wordmark lockup
- `.planning/intel/design-incoming/system/bundle/mokosh-handoff/handoff.html` — designer's memo
- `.planning/intel/brand-identity.md` — original engineering brief (now resolved per this doc)
- `.planning/intel/design-system.md` — engineering's prior visual sketch (superseded for tokens; tokens.css is canonical)
- `.planning/intel/assets-spec.md` — deliverables spec (icon dimensions/floors still binding)
