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

4.7 KiB
Raw Blame History

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)