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>
This commit is contained in:
50
.planning/intel/brand-decisions-v1.md
Normal file
50
.planning/intel/brand-decisions-v1.md
Normal file
@@ -0,0 +1,50 @@
|
||||
# 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)
|
||||
Reference in New Issue
Block a user