dme-agent 7.4.1 → 9.69.0

package/assets/references/motion-bible.md

@@ -0,0 +1,262 @@
+# Motion Bible — DME 9.69
+
+> Pure motion reference for Absolute Front-End.  
+> Pair with AGENTS.md. Platform density overrides decoration desire.
+
+---
+
+## Principles
+
+1. **Intent first** — enter, exit, move, emphasize, celebrate (rare).
+2. **One hierarchy of motion** — primary action moves more; chrome less.
+3. **Platform density** — desktop richer; web calmer; mobile minimal.
+4. **Reduced motion is law** — never optional.
+5. **Never one fade for everything.**
+
+---
+
+## Easing graphs (cubic-bezier)
+
+| Token | cubic-bezier | Feel | Use |
+|---|---|---|---|
+| `easeOut` | `0.16, 1, 0.3, 1` | Fast start, soft land | Entrances, most UI appear |
+| `easeIn` | `0.55, 0, 1, 0.45` | Soft start, quick leave | Exits, dismiss |
+| `easeInOut` | `0.65, 0, 0.35, 1` | Symmetric | Reposition on-screen |
+| `cubicOut` | `0.33, 1, 0.68, 1` | Gentle settle | Sheets, drawers |
+| `expoOut` | `0.16, 1, 0.3, 1` | Decided, premium | Hero/desktop reveal |
+| `expoInOut` | `0.87, 0, 0.13, 1` | Dramatic morph | Rare route morph desktop |
+| `emphasized` | `0.2, 0, 0, 1` | Material emphasized | Settle after drag |
+| `standard` | `0.2, 0, 0, 1` | Quiet chrome | Sidebar width, tab line |
+| `decelerate` | `0, 0, 0.2, 1` | Android-like decel | Secondary enter |
+| `accelerate` | `0.4, 0, 1, 1` | Leave frame | Fast exit |
+
+CSS:
+
+```css
+--ease-out: cubic-bezier(0.16, 1, 0.3, 1);
+--ease-in: cubic-bezier(0.55, 0, 1, 0.45);
+--ease-in-out: cubic-bezier(0.65, 0, 0.35, 1);
+--ease-cubic-out: cubic-bezier(0.33, 1, 0.68, 1);
+--ease-emphasized: cubic-bezier(0.2, 0, 0, 1);
+```
+
+Tailwind arbitrary:
+
+```txt
+duration-200 ease-[cubic-bezier(0.16,1,0.3,1)]
+```
+
+---
+
+## Springs (Framer Motion / motion)
+
+| Token | stiffness | damping | mass | Use |
+|---|---|---|---|---|
+| `soft` | 280 | 24 | 0.8 | Button press, icon toggle |
+| `snappy` | 400 | 30 | 0.6 | Command palette, popover, tab indicator |
+| `gentle` | 120 | 20 | 1.0 | Welcome, large panels (desktop) |
+| `stiff` | 500 | 40 | 0.5 | Small toggles, dense tools |
+| `bouncy` | 300 | 16 | 0.7 | **Rare** — playful mood only |
+
+```tsx
+const springSoft = { type: "spring", stiffness: 280, damping: 24, mass: 0.8 }
+const springSnappy = { type: "spring", stiffness: 400, damping: 30, mass: 0.6 }
+const springGentle = { type: "spring", stiffness: 120, damping: 20, mass: 1 }
+```
+
+---
+
+## Duration bands
+
+| Band | ms | Examples |
+|---|---|---|
+| Feedback | 80–120 | Hover, active press color |
+| Functional | 150–250 | Menu, toast, tooltip, tab |
+| Panel | 220–380 | Sheet, dialog, sidebar |
+| Page / welcome | 300–600 | Desktop route, onboarding beat |
+| Cap | ≤800 | Anything longer needs strong reason and stillness after |
+
+Stagger children: **40–60ms** web · **50–80ms** desktop lists (cap total choreography ~400ms web / ~700ms desktop).
+
+---
+
+## Platform density
+
+### Web
+
+- Prefer functional motion + **one** hero block.
+- Avoid multi-panel layoutId storms.
+- Prefer `opacity + 8–12px y` over large travel.
+- Lazy-load heavy motion; CSS for micro when enough.
+
+### Mobile web
+
+- Shorter distances; no hover-dependent meaning.
+- Prefer transforms/opacity (compositor-friendly).
+- Disable nonessential parallax.
+
+### Electron / Tauri
+
+- Shared layout transitions OK.
+- Welcome multi-beat sequences OK (2–4 beats).
+- Sidebar spring, panel dock, palette snappy spring.
+- Still avoid infinite loops and carnival.
+
+---
+
+## Reduced motion
+
+```css
+@media (prefers-reduced-motion: reduce) {
+  *, *::before, *::after {
+    animation-duration: 0.01ms !important;
+    animation-iteration-count: 1 !important;
+    transition-duration: 0.01ms !important;
+    scroll-behavior: auto !important;
+  }
+}
+```
+
+Framer:
+
+```tsx
+const reduce = useReducedMotion()
+const enter = reduce
+  ? { opacity: 1 }
+  : { opacity: 1, y: 0, transition: { duration: 0.28, ease: [0.16, 1, 0.3, 1] } }
+const initial = reduce ? { opacity: 0 } : { opacity: 0, y: 8 }
+```
+
+Law: under reduce → **no large travel, no springs that bounce, no parallax**. Opacity/instant OK.
+
+---
+
+## Pattern recipes
+
+### List enter (web-safe)
+
+```tsx
+const list = {
+  hidden: {},
+  show: { transition: { staggerChildren: 0.05 } },
+}
+const item = {
+  hidden: { opacity: 0, y: 8 },
+  show: {
+    opacity: 1,
+    y: 0,
+    transition: { duration: 0.28, ease: [0.16, 1, 0.3, 1] },
+  },
+}
+```
+
+### Dialog
+
+```tsx
+// overlay: opacity 0→1, duration 0.2, easeOut
+// content: opacity 0→1, scale 0.98→1, duration 0.22, ease [0.16,1,0.3,1]
+// exit: reverse with easeIn ~0.15s
+```
+
+### Sheet (desktop richer)
+
+```tsx
+// x or y: 16–24px travel + opacity
+// transition: { type: "spring", stiffness: 120, damping: 20 } // gentle desktop
+// web: tween cubicOut 0.3s
+```
+
+### Tab indicator
+
+```tsx
+// layoutId="tab"
+// transition: spring snappy
+```
+
+### Button press
+
+```tsx
+// whileTap={{ scale: 0.98 }}
+// transition: spring soft
+```
+
+### Page transition (desktop)
+
+```tsx
+// initial: { opacity: 0, y: 10 }
+// animate: { opacity: 1, y: 0 }
+// exit: { opacity: 0, y: -6 }
+// easeOut in / easeIn out; duration ~0.28 / 0.18
+```
+
+### Welcome sequence (desktop)
+
+Beat 1: mark opacity + scale 0.96→1 (gentle spring)  
+Beat 2: title y:12→0 + opacity (delay 0.08)  
+Beat 3: CTA opacity (delay 0.16)  
+Then: **stillness**. No loop.
+
+### CSS keyframe micro
+
+```css
+@keyframes fade-up {
+  from { opacity: 0; transform: translateY(8px); }
+  to { opacity: 1; transform: translateY(0); }
+}
+.enter {
+  animation: fade-up 0.28s cubic-bezier(0.16, 1, 0.3, 1) both;
+}
+```
+
+### WAAPI (light one-off)
+
+```js
+el.animate(
+  [
+    { opacity: 0, transform: "translateY(8px)" },
+    { opacity: 1, transform: "translateY(0)" },
+  ],
+  { duration: 280, easing: "cubic-bezier(0.16, 1, 0.3, 1)", fill: "both" }
+)
+```
+
+---
+
+## What to animate vs not
+
+| Animate | Prefer static |
+|---|---|
+| Presence (enter/exit) | Long reading body text layout thrash |
+| Feedback (press, success) | Endless ambient blobs |
+| Spatial model (panel dock) | Random decorative floaters |
+| Focus attention once | Competing three heroes moving |
+
+---
+
+## Banned
+
+- Infinite typing loops as product hero
+- Neon particles / mesh morph carnival
+- Bounce overshoot on finance/ops seriousness
+- Same 200ms opacity on every node
+- Parallax that harms scroll comprehension
+- >800ms blocking intro before first interaction without skip
+
+---
+
+## Selection cheat sheet
+
+| Situation | Pick |
+|---|---|
+| Dropdown open | easeOut 180–220ms or spring snappy |
+| Modal open | scale 0.98 + opacity easeOut |
+| Modal close | easeIn 150ms |
+| Toast | easeOut y + opacity |
+| Sidebar collapse desktop | spring gentle / standard tween |
+| KPI first paint | optional count-up once; desktop OK, web subtle |
+| Error shake | 2–3 short x keyframes ≤300ms total; not comic |
+| Skeleton → content | crossfade 150ms |
+
+---
+
+*DME 9.69 Motion Bible · Paz Operativa*

package/assets/references/palette-intake.md

@@ -0,0 +1,159 @@
+# Palette Intake — DME 9.69
+
+> Ask once. Lock for the session. Peace when silent.
+
+---
+
+## Intake questions (single block)
+
+Ask **only if missing** from the user message / brief:
+
+1. **Brand colors** — primary / secondary / accent (hex, HSL, or named tokens)? Or **“use peace gray”**?
+2. **Mood** — one phrase: calm ops · editorial premium · dense tools · playful soft · clinical · finance trust · other
+3. **Platform** — web · desktop Electron/Tauri · mobile web · hybrid
+4. **Product type** — dashboard · landing · SaaS shell · onboarding · marketing · internal tool · other
+
+Optional: dark / light / system · type preference · locale.
+
+### Example intake (agent → user)
+
+```text
+Antes de gerar a UI, trava a sessão (responde em 4 linhas se quiser):
+1. Cores da marca (hex) ou “peace gray”?
+2. Mood (ex: calm ops / editorial)?
+3. Plataforma: web · Electron/Tauri · mobile web?
+4. Tipo: dashboard · landing · app · onboarding?
+```
+
+---
+
+## Lock template (Decision Brief)
+
+```text
+Palette lock:
+  mode: brand | peace-gray
+  canvas: …
+  surface: …
+  text: …
+  muted: …
+  border: …
+  accent: …
+  accent-foreground: …
+  danger / success: …
+  focus-ring: …
+Mood: …
+Platform → motion density: web-calmer | desktop-rich | mobile-min
+Anchor: Vercel dens | Apple editorial | Fumadocs | Linear calm | Raycast command
+```
+
+Do **not** re-ask after lock unless user changes product direction.
+
+---
+
+## Peace Gray default
+
+When brand is unset or user says peace gray / “tanto faz” / “só manda”:
+
+### Light
+
+| Token | Value |
+|---|---|
+| canvas | `#FAFAFA` |
+| surface | `#FFFFFF` |
+| border | `#E4E4E7` (zinc-200) |
+| text | `#18181B` (zinc-900) |
+| text-muted | `#71717A` (zinc-500) |
+| muted-fill | `#F4F4F5` (zinc-100) |
+| accent | `#18181B` (ink CTA) |
+| accent-fg | `#FAFAFA` |
+| ring | `rgba(24,24,27,0.2)` |
+
+### Dark
+
+| Token | Value |
+|---|---|
+| canvas | `#09090B` |
+| surface | `#18181B` |
+| border | `#27272A` (zinc-800) |
+| text | `#FAFAFA` |
+| text-muted | `#A1A1AA` (zinc-400) |
+| muted-fill | `rgba(39,39,42,0.6)` |
+| accent | `#F4F4F5` (ink CTA) |
+| accent-fg | `#18181B` |
+| ring | `rgba(250,250,250,0.25)` |
+
+**Soft contrast:** prefer charcoal/off-white pairings for long reading. Avoid forcing pure `#000` on pure `#FFF` as the only text system.
+
+Stone alternative: swap zinc→stone for warmer peace (editorial calm).
+
+---
+
+## Brand mapping algorithm
+
+Given brand primary (and optional secondary/accent):
+
+1. **Primary** → main CTA / key active states (not every button)
+2. **Secondary** → charts, tags, rare highlights OR ignore if weak
+3. **Accent** → badges, links, focus if primary is too heavy
+4. Build **neutrals** from zinc/stone independent of brand (peace structure stays)
+5. Enforce **≤10% accent** on app surfaces; marketing hero may use more
+6. Derive hover/active as darker/lighter of primary (not neon multipliers)
+7. Check **AA contrast** for text-on-primary buttons; if fail, use ink buttons + brand as underline/dot only
+
+### Tailwind mental model
+
+```txt
+bg-background text-foreground
+bg-card border-border
+bg-primary text-primary-foreground
+bg-muted text-muted-foreground
+ring-ring
+```
+
+Map session lock → CSS variables once; components consume tokens, not ad-hoc hex soup.
+
+---
+
+## Mood → bias (no hex)
+
+| Mood | Neutrals | Accent behavior | Radius |
+|---|---|---|---|
+| Calm ops | zinc | ink or single quiet brand | ≤8 |
+| Editorial premium | stone/warm gray | deep ink; brand sparingly | ≤8 |
+| Dense tools | higher contrast zinc | status colors strict | ≤6–8 |
+| Playful soft | light zinc | pastel brand OK low saturation | ≤12 |
+| Clinical | cool gray | blue/teal status disciplined | ≤8 |
+| Finance trust | deep ink + zinc | green positive / red risk only | ≤8 |
+
+---
+
+## Platform note
+
+Palette is independent of platform; **motion density** is not.  
+Still document both in the same lock block.
+
+---
+
+## Anti-laws (removed from 7.4)
+
+| Old law | 9.69 |
+|---|---|
+| Accent dark always `#FFDE21` | Only if brand/session locks it |
+| Light CTA always `#0065F2` | Only if brand/session locks it |
+| Dark bg always `#09090b` as brand identity | Valid as **peace dark canvas**, not brand personality |
+
+Legacy yellow/blue may appear in historical docs as examples — **not runtime defaults**.
+
+---
+
+## Fail conditions
+
+- Inventing loud multicolor system without brand input
+- Ignoring user-supplied hex
+- Painting every surface with accent
+- Pure black/white only with harsh glare for long sessions
+- Re-asking palette every message
+
+---
+
+*DME 9.69 Palette Intake · Paz Operativa*

package/assets/skills/dme-app-shell/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: dme-app-shell
+description: >
+  DME 9.69 desktop app shells (Electron / Tauri / hybrid).
+  Triggers: /dme-app-shell, electron, tauri, desktop chrome, titlebar.
+---
+
+# DME App Shell 9.69
+
+1. Platform: **electron** | **tauri** | hybrid
+2. Custom titlebar + drag region; OS window controls zone
+3. Left icon rail or full sidebar · content pane · optional inspector
+4. Command palette > nested menus
+5. No marketing hero inside the shell
+6. Motion: subtle (sidebar width, panel opacity) — no bounce on chrome
+7. shadcn: Sidebar, Menubar, Command, Tabs, Sheet, Tooltip
+8. Tauri: lean DOM; prefer native dialogs/tray APIs
+
+Deliver: shell map → chrome vs content → shadcn compose → subtract.

package/assets/skills/dme-critique/SKILL.md

@@ -1,14 +1,113 @@
 ---
 name: dme-critique
 description: >
-  Score UI against DME 7.4.1 (structure, UX human, text discipline, dashboard/landing craft).
-  Triggers: /dme-critique, critique UI, anti-AI check, score design.
+  DME 9.69 scorecard critique: peace, motion craft, icons, platform fit,
+  structure, UX human, text discipline, anti-AI. Triggers: /dme-critique,
+  critique UI, score design, anti-AI check, design review, audit UI.
 ---
 
-# DME Critique
+# DME Critique 9.69 — Scorecard
 
-Score 0–5: Structure, Hierarchy, Type, Color, Density, Identity, shadcn, **UX human**, **Text discipline**, Dashboard/Landing craft, Anti-AI, A11y, Subtraction.
+Score each dimension **0–5**. Be specific: cite UI regions, not vibes.
 
-Fail if text walls, jargon for laypeople, feature-card spam, or missing empty/error states.
+**5** = doctrine locked · **3** = usable but soft · **0–1** = fails identity
 
-Output: scores table · blockers · fix order · keep.
+## Scorecard
+
+| # | Dimension | 5 looks like |
+|---|-----------|--------------|
+| 1 | **Structure** | One protagonist; shell inevitable; hierarchy clear |
+| 2 | **Hierarchy** | size → weight → space → color; eye path intentional |
+| 3 | **Type** | restrained scale; readable; mono only for data |
+| 4 | **Color / Peace** | gray-white peace or locked brand; 90/10 neutrals; no carnival |
+| 5 | **Density** | tight where ops need it; air where editorial needs it |
+| 6 | **Identity** | one anchor (vercel-dens / apple-editorial / fumadocs) |
+| 7 | **shadcn** | primitives composed; zero reinvention of atoms |
+| 8 | **UX human** | non-dev language; verbs; recovery paths; no dark patterns |
+| 9 | **Text discipline** | caps respected; no walls; no banned AI fluff |
+| 10 | **Cards** | lean or absent; no feature-card spam |
+| 11 | **Dashboard/Landing/Shell craft** | right pattern for surface; work object or conversion clear |
+| 12 | **Motion craft** | platform density correct; easing intentional; reduced-motion |
+| 13 | **Icons** | smart density; lucide consistent; no spam tiles |
+| 14 | **Platform fit** | web calm vs app rich; titlebar/drag if desktop |
+| 15 | **States** | empty · loading · error · success · offline considered |
+| 16 | **a11y** | contrast AA; focus; labels; targets |
+| 17 | **Anti-AI** | no mesh/glow/blobs/feature triad essays/journey copy |
+| 18 | **Subtraction** | every element earns space |
+
+## Instant fail (cap total judgment)
+
+Any of these → call **blocker** regardless of average:
+
+- Text walls / jargon for lay audience on non-devtools  
+- Feature-card icon spam (5–6 essay cards)  
+- Missing empty or error for primary flow  
+- Hand-rolled Button/Dialog/Table when shadcn expected  
+- Infinite decorative motion / ignores reduced-motion  
+- Dark patterns (confirmshaming, fake urgency)  
+- “Welcome to your dashboard” as logged-in home filler  
+
+## Platform rubrics (extra)
+
+### Web landing
+
+- 3s message · 10s trust · 30s CTA  
+- Motion ≤ calm fade/stagger  
+
+### Dashboard
+
+- Work object in 10s  
+- Metrics = numbers not paragraphs  
+- Table/queue hero  
+
+### App shell
+
+- Titlebar/drag safe  
+- Welcome not replaying daily  
+- Richer motion only where earned  
+
+## Output format (always)
+
+### 1. Scores table
+
+| Dimension | Score | Note (≤1 line) |
+|-----------|-------|----------------|
+
+### 2. Blockers
+
+Numbered, fix-or-die.
+
+### 3. Fix order
+
+Priority sequence (P0 → P2). Each item: **what · where · how**.
+
+### 4. Keep
+
+3–7 things that already work — don’t redesign for sport.
+
+### 5. Verdict
+
+```
+Average: X.X / 5
+Ship: yes | yes with P0 | no
+One-line identity read: "…"
+```
+
+## Tone
+
+Direct, design-director clear. No praise sandwich fluff. No rewrite of entire product unless asked — critique first.
+
+## Optional deep pass
+
+If he asks “fix it”, route to `/dme-design` with blockers as intake.
+
+## Checklist for the critic
+
+- [ ] All 18 dimensions scored  
+- [ ] Platform named and scored in #14  
+- [ ] Motion #12 and Icons #13 not skipped  
+- [ ] Blockers explicit  
+- [ ] Fix order actionable  
+- [ ] Keep list non-empty if anything works  
+
+**Judge for peace, craft, and humans — not for trendiness.**