Files
waggle-os/docs/briefs/2026-04-20-claude-design-setup-submission.md
Oleg Maslov 0c3e2ead3b
Some checks failed
Installer Smoke / installer-smoke (push) Has been cancelled
moving
2026-09-02 10:10:29 +02:00

83 lines
6.2 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.
---
date: 2026-04-20
type: brief
status: LOCKED — pending form submission
workspace: claude.ai/design
purpose: Waggle OS landing design system setup — form submission record
---
# claude.ai/design — Waggle OS Design System setup
## Status
LOCKED for submission. Marko confirmed (2026-04-20): blurb, visual direction, and full 12-bee asset set approved via "da da i da". Brief exists for reproducibility and audit.
## Context
- **Workspace:** claude.ai/design (Anthropic Labs Research Preview, Claude Code export path confirmed — production pipeline, not mockup)
- **Output goal:** Design System that replicates existing Hive Design System (not generates from scratch), to be used for Waggle OS landing page + potential UX fixes to `apps/www`
- **Upstream sources:** `D:\Projects\waggle-os\apps\www\src\styles\globals.css` (color tokens), `D:\Projects\waggle-os\docs\BRAND-VOICE.md` (ratified 2026-04-15), `D:\Projects\waggle-os\app\icons\` (bee mascots + functional icons), `D:\Projects\waggle-os\app\public\waggle-logo.svg` (brand mark)
## Form Field 1 — Company blurb
```
Waggle is the cognitive layer that makes any AI better — on your device, under your control. Built on hive-mind, an open-source memory substrate (Apache 2.0), Waggle gives agents persistent memory, structured retrieval, and audit-grade provenance across every interaction. Works with open models for free, sovereign deployment. Works with frontier models to extend their intelligence further. MPEG-4 compression, bitemporal knowledge graphs, EU AI Act audit triggers. Local-first. Zero cloud required. For teams that need AI that remembers, reasons, and respects their data.
```
Word count: 84. Anti-hype compliance: no "revolutionary", "transform", "game-changing". Dual-axis framing preserved (open models free / frontier models extended). Technical differentiators named without jargon (MPEG-4, bitemporal KG, EU AI Act). Privacy positioned as default, not feature.
## Form Field 2 — Any other notes (visual direction)
```
Dark-first aesthetic. Calm-confident, technical precision, zero marketing hype. Color palette — foundation: hive navy/blue-gray scale (950 #08090c darkest, 900 #0c0e14, 800 #171b26, 700 #1f2433, 500 #3d4560, 100 #dce0eb, 50 #f0f2f7). Single accent: honey amber (400 #f5b731, 500 #e5a000, 600 #b87a00). Status accents reserved: #a78bfa for AI, #34d399 for healthy states. Use honey amber for emphasis only, not surfaces. Avoid gradient-heavy hero compositions. Subtle honeycomb geometric motifs as background texture, not foreground decoration. Typography: Inter, sentence case headings, tight kerning, em dashes not hyphens, Oxford comma. Bee mascot illustrations reserved for persona cards and empty states — not hero. Button hierarchy: primary = honey amber, secondary = hive outline, tertiary = text link. Reference: think Linear + Notion dark mode, not Stripe. Information density over whitespace minimalism. Code/terminal elements should feel native, not decorative. No stock photography, no abstract 3D renders.
```
## Form Field 3 — Asset uploads
**Correction note (2026-04-20):** Original inventory mis-attributed paths to `app\icons\` — that folder is an NSIS installer placeholder only. Actual bee mascot and brand assets live in `apps\www\public\brand\`. Also confirmed 13 bee variants (not 12 — includes `bee-confused-dark`).
**Priority order (verified paths):**
1. `D:\Projects\waggle-os\app\public\waggle-logo.svg` — primary brand mark (canonical SVG)
2. `D:\Projects\waggle-os\apps\www\public\brand\bee-analyst-dark.png`
3. `D:\Projects\waggle-os\apps\www\public\brand\bee-architect-dark.png`
4. `D:\Projects\waggle-os\apps\www\public\brand\bee-builder-dark.png`
5. `D:\Projects\waggle-os\apps\www\public\brand\bee-celebrating-dark.png`
6. `D:\Projects\waggle-os\apps\www\public\brand\bee-confused-dark.png`
7. `D:\Projects\waggle-os\apps\www\public\brand\bee-connector-dark.png`
8. `D:\Projects\waggle-os\apps\www\public\brand\bee-hunter-dark.png`
9. `D:\Projects\waggle-os\apps\www\public\brand\bee-marketer-dark.png`
10. `D:\Projects\waggle-os\apps\www\public\brand\bee-orchestrator-dark.png`
11. `D:\Projects\waggle-os\apps\www\public\brand\bee-researcher-dark.png`
12. `D:\Projects\waggle-os\apps\www\public\brand\bee-sleeping-dark.png`
13. `D:\Projects\waggle-os\apps\www\public\brand\bee-team-dark.png`
14. `D:\Projects\waggle-os\apps\www\public\brand\bee-writer-dark.png`
15. `D:\Projects\waggle-os\apps\www\public\brand\hex-texture-dark.png`
Total: 15 assets. Light variants excluded — dark-first is locked, light variants would dilute the generated system's aesthetic anchor. Functional icon set (16 × 2 .jpeg) also in `apps\www\public\brand\` but excluded — too granular for design system init; will be mapped via Code Connect post-generation.
**What we are NOT uploading and why:**
- Inter font files — system default, no upload needed
- CSS variables as file — inlined in Form Field 2 as hex codes
- Functional icons (16 × 2) — too granular for design system init; will be referenced in Code Connect map post-generation
- Logo raster variants (PNG, JPEG) — SVG is canonical, raster is derivative
## Control Gate before "Continue to generation"
Stop point after form is filled but before clicking `Continue to generation`. Marko reviews final state in browser, gives go/no-go. Reason: generation is the expensive step (time + model compute); late correction cheaper here than post-gen regeneration.
## Post-generation control gates (for reference)
- **Gate 1:** Review generated Design System artifact against Hive DS fidelity checklist
- **Gate 2:** Claude Code export — inspect generated code before merging into `apps/www`
- **Gate 3:** Landing page draft review before any deployment
## Decisions locked by this submission
- claude.ai/design is production design workspace for Waggle OS landing + UX work
- M1 headline ("The cognitive layer that makes your AI better. Whatever AI you pick.") is default Hero copy
- M3 headline ("Better Opus. Free Qwen. Same cognitive layer.") is alternate for technical personas (P3 Sasha, P7 Priya)
- M2 dropped from active variant set
- Hive/honey palette is the single design system source of truth — no parallel system
- Dark-first is immutable; light mode is optional post-launch, not in scope for landing