Files
mokosh/.planning/intel/brand-decisions-v1.md
Mark 5efc2a89e3 docs(intel): ingest designer-team handoff v1 + record 9 brand decisions
Designer-team delivered two bundles (2026-05-17):
- Mokosh.zip: presentation artifacts (Decision Brief + Surface Kit standalone HTMLs)
- Mokosh Design System.zip: implementation handoff (tokens.css + mark/lockup SVGs + memo)

Designer respected every contract: codename Mokosh preserved, MV3 CSP
acknowledged (flagged dev-only Google Fonts @import in tokens.css line 12
for engineering to replace), Cyrillic-first typography (IBM Plex Sans),
WCAG AA validation noted, made recommendations not unilateral decisions.

9 decisions resolved per user ack:
- D-01..06, D-08, D-09: accepted designer defaults
- D-07 OVERRIDE: B · "Mokosh — Session Capture" (vs designer's A · just "Mokosh")
  — operator-facing manifest:name surfaces capture purpose

Brand decisions persisted to brand-decisions-v1.md;
brand-identity.md Open Questions section marked resolved with backlink.

Designer artifacts staged at .planning/intel/design-incoming/ for Plan 01-12
(Design Integration) consumption. Mokosh.zip presentation HTMLs (3.4 MB)
preserved as audit/onboarding reference; can be pruned later if repo size
warrants.

Plan 01-12 implementation handoff catalogued in brand-decisions-v1.md
§"Implementation handoff" — covers tokens.css ingestion, WOFF2 self-hosting,
SVG → PNG rasterization, manifest:name + description update,
welcome layout, VITE_DEV smoke gating.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-17 21:00:54 +02:00

51 lines
4.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)