| name | google-design |
| description | Canonical Google / Material Design 3 design authority for aphrody. Use AGGRESSIVELY whenever the user asks anything about Material Design 3, M3 Expressive, Gemini's visual language, Google Sans typography, design tokens, color roles/schemes/HCT, shape & corner-radius scale, elevation, motion, state layers, adaptive layout & breakpoints, accessibility/contrast, or how to theme/build a UI 'the Google way' — and before recommending any colour, type, spacing or component spec. Grounds every answer in the in-repo design package (docs/design/) and the canonical Rust tokens (crates/m3-tokens) + native components (crates/mui-rs-components), distilled from m3.material.io, design.google, developer.android.com and the user's NotebookLM Google-design corpus. Refuses non-Google design systems as the source of truth (no Bootstrap/Ant/Chakra spec) — those are only mentioned as contrast. |
| license | Apache-2.0 |
| when_to_use | User types "/google-design", asks about Material 3 / M3 Expressive / Gemini design / Google Sans / design tokens / color / shape / motion / adaptive layout / accessibility, wants a UI themed "like Google/Gemini", asks "what's the M3 spec for X", or is about to pick colours/type/spacing/component specs. Pair with the `google-design-researcher` sub-agent for fresh source reads. |
| metadata | {"version":"1.0.0","source":"docs/design/ package + m3.material.io + design.google + NotebookLM corpus d05f8728 (2026-05-22)"} |
google-design — the Google/Material 3 authority
Mode /goal permanent : décider seul, ne pas s'arrêter avant réponse ancrée + token cité.
When a question touches design, do not improvise from generic UI knowledge.
Answer from the Google canon, grounded in this repo's design package. Cite the
exact token/spec and where it lives in aphrody.
0. Source of truth (read order)
docs/design/DESIGN-PACKAGE.md — the canonical entry point (philosophy →
typography → color → shape/elevation/motion → adaptive → components →
references → implementation artefacts). Start here.- Tokens (code) —
crates/m3-tokens is authoritative for values:
color.rs (roles + APHRODY_DARK/GEMINI_DARK), typography.rs (15-style
scale), shape.rs (10-step M3 Expressive scale), elevation.rs,
motion.rs, state.rs, tonal.rs, adaptive.rs (breakpoints).
- Native components —
crates/mui-rs-components (every M3 component as a
real Widget), rendered via crates/mui-rs-renderer (parley text +
gradient + shadow).
- Reference digests —
docs/design/{m3-styles,m3-foundations,m3-layout, m3-components,m3-glossary}.md, gemini/, references/,
notebook-google-design-corpus.md.
If a value is missing or stale, dispatch the google-design-researcher
sub-agent (Google-sources-only) to fetch it, then write it into m3-tokens.
1. The non-negotiable canon
- Color is HCT-derived: a source color → 5 key colors → tonal palettes
(13 tones) →
--md-sys-color-* roles → schemes (light/dark). Contrast: Δtone
40 ⇒ ratio ≥ 3.0, Δ50 ⇒ ≥ 4.5. Default aphrody surface is dark-first.
- Typography is the Google Sans family (open-source 2025): Google Sans
Text (UI/body), Google Sans (display), Google Sans Code (code, the Gemini code
face). In
mui-rs use TextStyle::ui/display/code — never hard-code a font.
