mirror of
https://github.com/pbakaus/impeccable.git
synced 2026-09-11 21:57:14 +03:00
The format at https://stitch.withgoogle.com/docs/design-md/format/ defines exactly six sections in a fixed order: Overview, Colors, Typography, Elevation, Components, Do's and Don'ts. Our previous format used non-compliant names (Visual Theme & Atmosphere, Color Palette & Roles, Typography Rules, Component Stylings), a non-existent "Layout Principles" section, and had no Do's and Don'ts. Changes to reference/document.md: - Fixed section list to match the spec character-for-character - Added mandatory "Creative North Star" pattern at top of Overview - Added Named Rules pattern (e.g. "The No-Line Rule") — stickier than bullet lists for AI consumers, mirrors Stitch's own generator output - Added explicit Do's and Don'ts section with concrete, forceful guardrails - Elevation is now its own section (was buried in Components) - Layout/motion/responsive content folds into Overview + Components rather than inventing new top-level sections - Guidance on forceful voice ("prohibited"/"forbidden"/"never") matching PRODUCT.md's expert-decisive tone - Pitfalls section warns against renaming sections or adding new ones Changes to our DESIGN.md: - Rewrote to use spec-compliant section headers with evocative subtitles (e.g. "## 2. Colors: The Warm-Paper Palette") - Opened with "Creative North Star: The Editorial Sanctuary" - Added 11 Named Rules across sections (The One Voice Rule, The Paper- Not-White Rule, The OKLCH-Only Rule, The Italic-Is-Voice Rule, The 1.6 Leading Rule, The Fluid-Headlines-Only Rule, The Flat-By- Default Rule, The Low-Alpha Rule, The Tinted-Shadow-Only-For-Accent Rule, plus the existing implicit ones) - Full Do's and Don'ts section with 10 Dos and 15 Don'ts, many of which translate PRODUCT.md anti-references into concrete prohibitions - Elevation section documents shadow vocabulary separately from Components - Layout/spacing/motion content relocated to a sub-section under Components Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>