@topy-ai/maggie 0.8.6 → 0.8.7

package/README-zh-TW.md

@@ -143,7 +143,7 @@ structure drift 或重複 treatment product 時 fail closed。
 deployment、memory、feedback 和 MaggieDash。內容先 draft/review，外部寫入、
 publish 與 production deployment 需要明確確認。
 
-目前 npm 版本為 `0.8.6`,補齊兩個設計技能:加入完整的生產 reference(所有可複製的程式碼片段與預設表格),並把設計來源明確為 Figma 非必需(實時 URL、既有程式碼、Figma、或純截圖)。先前 0.8.5 採納兩個設計技能(改編自 MIT 的 `elayadesign/ai-design-skills`):maggie-landing-page(轉化策略 + 視覺系統紀律,具體數值為可被專案 DESIGN.md 覆蓋的預設值;由 maggie-design 生產與驗證)與 maggie-design-motion(靜態設計→像素級動畫 HTML 複刻→匯出 MP4 + GIF)。先前 0.8.4 將技能庫擴展成完整的「一人用 AI 跑一家公司」C-suite,新增八條職能線:maggie-sales(CRM 中立的銷售管線)、maggie-finance(只解釋的 CFO 指標,含確定性 maggie_finance.py 計算器)、maggie-support(面向客戶的客戶成功)、maggie-product(路線圖 + 預註冊實驗)、maggie-fundraising(pitch deck、data room、投資人更新)、maggie-legal(ToS/隱私/DPA/SOC2 readiness)、maggie-monetization(定價/paywall/dunning,金錢操作需人工批准)、maggie-orchestrator(CEO 編排層:將目標拆成帶審批門的 mission 分派到各職能線,含 maggie_orchestrator.py 規劃器)。先前 0.8.3 將 cmo.so/www 開發經驗沉澱進技能庫:新增兩個技能 maggie-skill-authoring(依 catalog 與 MCP 工具白名單撰寫/校驗社區營銷 playbook 技能)與 maggie-feedback-triage(反饋的團隊接收端:決策/定級/分派、PRD + issue 流程、24/7 隊列守護);新增多個 reference(OAuth PKCE 登入、Expo 約定與 Router 骨架、MCP evals 測試框架、conversation cards、WordPress→Firebase 認證遷移手冊);並增補 maggie-assistant-tools(tool≤user 每輪工具過濾、agent loop 安全不變量、preview-only 橋接代理、MCP resources/prompts、注解加固、CLI 與 ChatGPT 插件打包)、maggie-auth-reference(自清理登入測試套件、自簽單次令牌)、maggie-mobile-app(OTA 開機拉取、live==built 部署守衛)、maggie-deployment(pm2 單包發布、live-hash 校驗)與 maggie-ops(template-as-code 郵件同步)。先前 0.8.2 新增 maggie-spirit(為 AI 品牌生成平面像素 spirit/sprite 系統)與 goal-led AI agent 設計參考;0.8.0 為安全優化 roadmap(scan、image-patch、標頭評分、SSVC、GDPR 日誌規則、新 MCP 工具)。先前 0.8.0 為安全優化 roadmap(scan、image-patch、標頭評分、SSVC、GDPR 日誌規則、新 MCP 工具),含 fix-plan 修補風險分級 T1–T4(判斷補丁是否安全套用)與 host-impact 補丁影響面量測(哪些服務需重啟、是否需重開機)、public-check、Maggie Security、batch 31 排程 agent routines、報告收件匣與無人值守 agent 限制、PHP runtime 盤點與主機鎖、pull 網站改寫、query 點子與社群佇列檢查，batch 30 MaggieDash 先裝核心、release privacy gate、feedback 備援、社群連結與圖片檢查、大量頁面產生與 app 檢查，batch 29 預約規則、部署、app QA、助理與社群功能，以及 batch 28 產品 app、assistant tools、mobile、product release、skills catalog 與 bridge host 功能、batch 26、27 feedback 修正與 idempotent `maggie update`與 Booking email-template 合約/CLI validator 同步。本版完成 2026-09-24 booking feedback batch：Calendar grid/free-slot entry 與 host modal focus-restoration evidence。本版新增 Starter marketplace provisioning plan；本版完成 feedback batches 22、23：加入 declarative browser interaction evidence、design markup/style/content-key gate、compiler source anchoring、entity double-escape protection、`update --help` read-only、noindex hypothetical indexability、可過期 baseline acknowledgement、DOM-only link extraction regression，以及 MaggieDash 0.2.10 的 content override、短期 browser session、CDN-safe public-session cache contracts。authentication 和 isolated dev server 仍由 host 負責。`maggie-booking` workflow、傳統 email/password、Stripe、Resend、public booking flow 及既有安全邊界維持不變；provider-bound video generation 與 transactional delivery 仍記錄在 issue #39，前一批延後功能仍在 issue #38，不會直接成為 active memory。0.7.33 記錄並審查一筆更正回饋；確認 0.7.32 已正確處理 batch index，沒有修改已驗證的 shared behavior。0.7.32 加入 feedback 一基索引支援、MaggieDash panel 的 source/freshness/error evidence、Consent Mode 與實際 write/no-op reconciliation、SEO baseline recapture、sitemap origin rebasing、content-diff scope、migration ledger reconciliation、deployment credential preflight、release provenance/runtime preflight、icon release gate、opt-in blog auto-publish gate，以及 least-privilege VPS deployer。也修復 top-level `maggie feedback` dispatcher parity。0.7.31 加入 update 差異摘要、atomic installer copy、subset install manifest merge，以及 inventory drift 時 doctor non-zero。0.7.30 補上 feedback tracking issue closeout gate 與 batch 14/15 audit ledger。0.7.29 修正 npm package landing page 使用英文 README；0.7.28 加入 versioned Gemini model policy、明確 fallback 與 provenance、bundled-first CLI
+目前 npm 版本為 `0.8.7`,把 redesign 稽核併入 `maggie-design`(改編自 MIT 的 `elayadesign/redesign-skill`):掃描 + 診斷 AI 通病/缺失狀態/雜亂程式碼,再經 in-place/verify 流程就地修正,因此「稽核/打磨/升級既有站點」會路由到 maggie-design。先前 0.8.6 補齊兩個設計技能:加入完整的生產 reference,並把設計來源明確為 Figma 非必需(實時 URL、既有程式碼、Figma、或純截圖)。先前 0.8.5 採納兩個設計技能(改編自 MIT 的 `elayadesign/ai-design-skills`):maggie-landing-page(轉化策略 + 視覺系統紀律,具體數值為可被專案 DESIGN.md 覆蓋的預設值;由 maggie-design 生產與驗證)與 maggie-design-motion(靜態設計→像素級動畫 HTML 複刻→匯出 MP4 + GIF)。先前 0.8.4 將技能庫擴展成完整的「一人用 AI 跑一家公司」C-suite,新增八條職能線:maggie-sales(CRM 中立的銷售管線)、maggie-finance(只解釋的 CFO 指標,含確定性 maggie_finance.py 計算器)、maggie-support(面向客戶的客戶成功)、maggie-product(路線圖 + 預註冊實驗)、maggie-fundraising(pitch deck、data room、投資人更新)、maggie-legal(ToS/隱私/DPA/SOC2 readiness)、maggie-monetization(定價/paywall/dunning,金錢操作需人工批准)、maggie-orchestrator(CEO 編排層:將目標拆成帶審批門的 mission 分派到各職能線,含 maggie_orchestrator.py 規劃器)。先前 0.8.3 將 cmo.so/www 開發經驗沉澱進技能庫:新增兩個技能 maggie-skill-authoring(依 catalog 與 MCP 工具白名單撰寫/校驗社區營銷 playbook 技能)與 maggie-feedback-triage(反饋的團隊接收端:決策/定級/分派、PRD + issue 流程、24/7 隊列守護);新增多個 reference(OAuth PKCE 登入、Expo 約定與 Router 骨架、MCP evals 測試框架、conversation cards、WordPress→Firebase 認證遷移手冊);並增補 maggie-assistant-tools(tool≤user 每輪工具過濾、agent loop 安全不變量、preview-only 橋接代理、MCP resources/prompts、注解加固、CLI 與 ChatGPT 插件打包)、maggie-auth-reference(自清理登入測試套件、自簽單次令牌)、maggie-mobile-app(OTA 開機拉取、live==built 部署守衛)、maggie-deployment(pm2 單包發布、live-hash 校驗)與 maggie-ops(template-as-code 郵件同步)。先前 0.8.2 新增 maggie-spirit(為 AI 品牌生成平面像素 spirit/sprite 系統)與 goal-led AI agent 設計參考;0.8.0 為安全優化 roadmap(scan、image-patch、標頭評分、SSVC、GDPR 日誌規則、新 MCP 工具)。先前 0.8.0 為安全優化 roadmap(scan、image-patch、標頭評分、SSVC、GDPR 日誌規則、新 MCP 工具),含 fix-plan 修補風險分級 T1–T4(判斷補丁是否安全套用)與 host-impact 補丁影響面量測(哪些服務需重啟、是否需重開機)、public-check、Maggie Security、batch 31 排程 agent routines、報告收件匣與無人值守 agent 限制、PHP runtime 盤點與主機鎖、pull 網站改寫、query 點子與社群佇列檢查，batch 30 MaggieDash 先裝核心、release privacy gate、feedback 備援、社群連結與圖片檢查、大量頁面產生與 app 檢查，batch 29 預約規則、部署、app QA、助理與社群功能，以及 batch 28 產品 app、assistant tools、mobile、product release、skills catalog 與 bridge host 功能、batch 26、27 feedback 修正與 idempotent `maggie update`與 Booking email-template 合約/CLI validator 同步。本版完成 2026-09-24 booking feedback batch：Calendar grid/free-slot entry 與 host modal focus-restoration evidence。本版新增 Starter marketplace provisioning plan；本版完成 feedback batches 22、23：加入 declarative browser interaction evidence、design markup/style/content-key gate、compiler source anchoring、entity double-escape protection、`update --help` read-only、noindex hypothetical indexability、可過期 baseline acknowledgement、DOM-only link extraction regression，以及 MaggieDash 0.2.10 的 content override、短期 browser session、CDN-safe public-session cache contracts。authentication 和 isolated dev server 仍由 host 負責。`maggie-booking` workflow、傳統 email/password、Stripe、Resend、public booking flow 及既有安全邊界維持不變；provider-bound video generation 與 transactional delivery 仍記錄在 issue #39，前一批延後功能仍在 issue #38，不會直接成為 active memory。0.7.33 記錄並審查一筆更正回饋；確認 0.7.32 已正確處理 batch index，沒有修改已驗證的 shared behavior。0.7.32 加入 feedback 一基索引支援、MaggieDash panel 的 source/freshness/error evidence、Consent Mode 與實際 write/no-op reconciliation、SEO baseline recapture、sitemap origin rebasing、content-diff scope、migration ledger reconciliation、deployment credential preflight、release provenance/runtime preflight、icon release gate、opt-in blog auto-publish gate，以及 least-privilege VPS deployer。也修復 top-level `maggie feedback` dispatcher parity。0.7.31 加入 update 差異摘要、atomic installer copy、subset install manifest merge，以及 inventory drift 時 doctor non-zero。0.7.30 補上 feedback tracking issue closeout gate 與 batch 14/15 audit ledger。0.7.29 修正 npm package landing page 使用英文 README；0.7.28 加入 versioned Gemini model policy、明確 fallback 與 provenance、bundled-first CLI
 dispatch、`maggie --version`、feedback batch review 聚合與重複偵測、marketplace enrichment evidence、booking
 worker/resolver evidence，以及 read-only migration preflight。它也包含 host-owned mobile app surface contract、signed-in
 camera-state QA、直接 Astro route resolution、correlated feedback batch，以及

package/README.md

@@ -89,7 +89,7 @@ Maggie keeps the existing project foundation and asks for decisions before
 shared routes, analytics, or publishing boundaries change. The current
 package ships 36 installable skills and a local-first MaggieDash foundation.
 
-This package is `0.8.6` — it completes the two adopted design skills with full production references (every copy-ready snippet and default table) and makes the design source Figma-optional (live URL, existing code, Figma, or a screenshot). `0.8.5` adopted the two design skills (adapted, MIT, from `elayadesign/ai-design-skills`): `maggie-landing-page` (conversion strategy + a visual-system discipline whose values defer to the project's DESIGN.md) and `maggie-design-motion` (static design → pixel-exact animated HTML replica → MP4 + GIF export). `0.8.4` expanded the library into a full "one person runs a company with AI" C-suite with eight new function lanes: `maggie-sales` (CRM-neutral pipeline), `maggie-finance` (explain-only CFO metrics + a deterministic `maggie_finance.py` calculator), `maggie-support` (customer success), `maggie-product` (roadmap + pre-registered experiments), `maggie-fundraising` (deck, data room, investor updates), `maggie-legal` (ToS/privacy/DPA/SOC2 readiness), `maggie-monetization` (pricing/paywalls/dunning; money actions human-approved), and `maggie-orchestrator` (the CEO layer that decomposes a goal into gated missions across the lanes, with a `maggie_orchestrator.py` planner). `0.8.3` folded cmo.so/www development learnings in (maggie-skill-authoring, maggie-feedback-triage, and mobile/MCP/auth references); `0.8.2` added `maggie-spirit`; `0.8.0` was the security optimization roadmap.
+This package is `0.8.7` — it folds a redesign audit into `maggie-design` (from the MIT `elayadesign/redesign-skill`): scan + diagnose generic AI-design patterns/weak states/sloppy code, then fix in place via the in-place/verify flow, so "audit/polish/upgrade an existing site" routes to maggie-design. `0.8.6` completed the two adopted design skills with full production references and made the design source Figma-optional (live URL, existing code, Figma, or a screenshot). `0.8.5` adopted the two design skills (adapted, MIT, from `elayadesign/ai-design-skills`): `maggie-landing-page` (conversion strategy + a visual-system discipline whose values defer to the project's DESIGN.md) and `maggie-design-motion` (static design → pixel-exact animated HTML replica → MP4 + GIF export). `0.8.4` expanded the library into a full "one person runs a company with AI" C-suite with eight new function lanes: `maggie-sales` (CRM-neutral pipeline), `maggie-finance` (explain-only CFO metrics + a deterministic `maggie_finance.py` calculator), `maggie-support` (customer success), `maggie-product` (roadmap + pre-registered experiments), `maggie-fundraising` (deck, data room, investor updates), `maggie-legal` (ToS/privacy/DPA/SOC2 readiness), `maggie-monetization` (pricing/paywalls/dunning; money actions human-approved), and `maggie-orchestrator` (the CEO layer that decomposes a goal into gated missions across the lanes, with a `maggie_orchestrator.py` planner). `0.8.3` folded cmo.so/www development learnings in (maggie-skill-authoring, maggie-feedback-triage, and mobile/MCP/auth references); `0.8.2` added `maggie-spirit`; `0.8.0` was the security optimization roadmap.
 
 The 0.7.59 release made `maggie security host-audit` (the deep
 lynis audit over SSH) robust on hosts where a storage test can stall: lynis runs

package/bundled-references/redesign-audit.md

@@ -0,0 +1,144 @@
+# Redesign audit (existing sites)
+
+A diagnostic checklist for upgrading an **existing** site or app to premium quality:
+find the generic AI-design patterns, weak states, and sloppy code, then fix them
+**in place** without breaking functionality or migrating frameworks. Used by the `maggie-design` skill - run the
+audit to decide *what* to change, then apply the changes through maggie-design's
+`in-place` / `section` / `verify` flow (small, reviewable, evidence-backed edits),
+never a rewrite.
+
+Concrete values (fonts, dark colours, spacing, type scale, radius, icons, motion)
+come from [landing-page visual defaults](landing-page-visual-defaults.md); they are
+**defaults** that the project's own DESIGN.md/tokens override. Never invent a value
+that is in neither place - ask. Adapted from `elayadesign/redesign-skill`
+`redesign-existing-projects` (MIT; from `Leonxlnx/taste-skill`); see Credits.
+
+## How to run it
+
+1. **Scan** - read the codebase; identify framework, styling method (Tailwind v3/v4,
+   vanilla CSS, styled-components, CSS modules), and the current patterns.
+2. **Diagnose** - go through the audit below; list every generic pattern, weak
+   point, and missing state. **Report before fixing; let the user veto items.**
+3. **Fix** - apply targeted upgrades inside the existing stack, in the Fix-priority
+   order, through maggie-design (test after each; keep diffs reviewable).
+
+## Audit
+
+### Typography
+Browser-default or Inter/Roboto/Arial/Open Sans/Helvetica fonts; two typefaces on
+one site; any italics; ultra-bold (800/900); only 400+700 in use (add 500/600);
+headlines lacking presence (more display size, tighter tracking); body wider than
+~65 characters; proportional numerals in data UI (use `tabular-nums`); missing
+letter-spacing (negative on big headers, positive on small caps); all-caps
+subheaders everywhere; orphaned words (`text-wrap: balance`/`pretty`); hyphens in
+copy; off-scale font sizes (snap to the type scale, closest step below); off-scale
+button type (main `text-base` semibold, header `text-sm` semibold).
+
+### Colour and surfaces
+Backgrounds outside the approved dark palette (snap to it; not `#0a0a0a`/`#121212`/
+tinted navy); **any background gradient** (flat only; the one exception is hero
+heading text); flat hero heading colour (apply the approved text gradient); **the
+purple/blue "AI gradient" - the single most common AI fingerprint** (flat neutral
+base + one accent); oversaturated accents (keep under ~80%); more than one accent;
+mixing warm and cool grays; generic pure-black `box-shadow` (tint toward the
+background hue); zero-texture flatness (subtle noise/grain, never a gradient);
+inconsistent lighting direction (one light source); a random dark section in a light
+page or vice versa; empty sections with no depth (masked low-opacity imagery or a
+pattern; `https://picsum.photos/seed/{name}/1920/1080` as a placeholder, never an
+ambient gradient).
+
+### Layout
+Everything centred/symmetrical (break it); three equal card columns as the feature
+row (keep 3-5 benefits as content, but zig-zag/asymmetric/scroll/masonry as layout);
+`height: 100vh` (use `min-height: 100dvh`); complex flexbox percentage math (CSS
+Grid); no max-width container (~1200-1440px; hero capped ~680px); flexbox-forced
+equal card heights (allow variable/masonry); radius by feel (token scale +
+nested-radius formula); ad-hoc spacing (the spacing scale); no overlap/depth
+(negative margins to layer); symmetrical vertical padding (optical, usually more at
+the bottom); dashboard always a left sidebar (try top nav / command menu /
+collapsible); missing whitespace; CTAs not bottom-aligned in card groups; pricing/
+comparison list items starting at different Y (fixed-height title/price blocks);
+misaligned baselines across side-by-side elements; mathematically-but-not-optically
+aligned icons/text.
+
+### Interactivity and states
+Default easing (`ease`/`linear`/`ease-in-out` -> the base curve, 500ms movement /
+300ms colour-opacity, never under 200ms); content just "there" on scroll (rise+fade
+once, 600-800ms); scroll listeners (use `IntersectionObserver`/`whileInView`); nav
+welded to the top edge (float it, translucent blur); instant menu-icon swap (animate
+it); cramped mobile dropdown (full-height panel, links staggered ~60ms, under 400ms);
+no reduced-motion handling (swap movement for a fade); no hover state; no active/
+pressed feedback (`scale(0.98)`/`translateY(1px)`); missing focus ring; no loading
+states (skeletons, not spinners); no empty states (a composed getting-started view);
+no error states (inline, specific, never `alert()`); dead `#` links; no current-page
+nav indicator; scroll jumping (`scroll-behavior: smooth`); animating `top`/`left`/
+`width`/`height` (use `transform`/`opacity`).
+
+### Content
+Placeholder/stock people and repeated faces; suspiciously round numbers; generic
+brand names; filler words ("revolutionize", "supercharge", "cutting edge",
+"effortless", "transform your workflow", "world class"); vague value props
+("streamline"/"optimize" -> a measurable outcome); features with no outcome; weak
+CTAs ("Learn more"/"Submit" -> verb + what they get); competing CTAs above the fold;
+proof buried at the bottom; no risk reversal; loud/cute system messages (calm and
+specific); passive voice; placeholder/Latin text (a blocker); Title Case (use
+sentence case).
+
+### Component patterns
+Generic card (border + shadow + white bg -> background or spacing alone; cards only
+where elevation means hierarchy); single-side card border (all around or none);
+always one filled + one ghost button (add text/tertiary); pill "New"/"Beta" badges
+(square/flag/plain); accordion FAQ (keep 6-12 Q&A, change the pattern); three-card
+carousel testimonials with dots; three-tower pricing (emphasise the recommended tier
+by colour/weight, not height); modals for everything (inline/slide-over/expand);
+avatar circles only (squircles); sun/moon theme toggle (dropdown/system/settings);
+four-column footer link farm (main paths + legal only).
+
+### Iconography and imagery
+Lucide/Feather/Material icons (-> the approved set); cliche metaphors (rocket for
+"launch", shield for "security" -> bolt, fingerprint, spark, vault); inconsistent
+stroke widths; missing favicon; stock "diverse team" photos.
+
+### Code quality
+Div soup (semantic HTML); inline styles mixed with classes; hardcoded pixel widths
+(`%`/`rem`/`em`/`max-width`); missing/`alt="image"` alt text; arbitrary z-index like
+`9999` (a scale); commented-out dead code; **import hallucinations** (verify every
+import exists in the dependency file); missing meta tags (`<title>`, description,
+`og:image`, social).
+
+### Strategic omissions (what AI builds forgets)
+Legal links; back navigation; a custom 404; form validation; a skip-to-content link;
+cookie consent where required (see `maggie-legal`); landing-page indexing not
+considered (`noindex` ad-only/time-bound, real title/meta/internal-links/AEO FAQ for
+evergreen - hand SEO specifics to `maggie-seo-geo`).
+
+## Fix priority (max impact, min risk)
+
+1. Font swap - biggest instant win, lowest risk.
+2. Colour and surface cleanup - snap to the palette, remove background gradients.
+3. Hover / active / focus states - makes it feel alive.
+4. Layout and spacing - grid, max-width, spacing scale, nested-radius formula.
+5. Motion pass - base curve, IntersectionObserver reveals, floating nav, mobile menu.
+6. Replace generic components - swap cliche patterns for the alternatives above.
+7. Loading / empty / error states - makes it feel finished.
+8. Copy pass - cut cliches, add specificity, fix CTAs.
+9. Type-scale polish - the premium final touch.
+
+## Rules
+
+- Work with the existing stack; do not migrate frameworks or styling libraries.
+- Do not break functionality; test after every change (maggie-design's verify/QA).
+- Report the diagnosis before fixing; let the user veto items.
+- Check the dependency file before importing any library; check Tailwind v3 vs v4
+  before touching config; no framework -> vanilla CSS.
+- Small, targeted, reviewable changes over big rewrites.
+- Never invent a design value; if it is in neither this audit nor the visual
+  defaults nor the project's system, ask.
+
+## Credits
+
+Adapted (not transcribed) from
+[`elayadesign/redesign-skill`](https://github.com/elayadesign/redesign-skill)
+`redesign-existing-projects` by Elaya (MIT), which adapts audit structure and
+content-realism checks from [`Leonxlnx/taste-skill`](https://github.com/Leonxlnx/taste-skill)
+by Leon Lin (MIT).

package/bundled-skills/catalog.json

@@ -44,7 +44,7 @@
     },
     {
       "name": "maggie-design",
-      "description": "Design authorized interior pages, review rendered responsive layouts, or explicitly rebrand a packaged homepage/template. Use rebrand only with a named source brand and target brand."
+      "description": "Design authorized interior pages, review rendered responsive layouts, explicitly rebrand a packaged homepage/template, or audit and upgrade an existing site/app in place (fix generic AI-design patterns, weak states, and sloppy code). Use rebrand only with a named source brand and target brand. Use the redesign audit whenever the user wants to improve, polish, upgrade, refine, audit, or redesign an existing page, even when they just say it looks cheap, generic, or AI-made."
     },
     {
       "name": "maggie-design-motion",

package/bundled-skills/maggie-design/SKILL.md

@@ -1,12 +1,28 @@
 ---
 name: maggie-design
-description: Design authorized interior pages, review rendered responsive layouts, or explicitly rebrand a packaged homepage/template. Use rebrand only with a named source brand and target brand.
+description: Design authorized interior pages, review rendered responsive layouts, explicitly rebrand a packaged homepage/template, or audit and upgrade an existing site/app in place (fix generic AI-design patterns, weak states, and sloppy code). Use rebrand only with a named source brand and target brand. Use the redesign audit whenever the user wants to improve, polish, upgrade, refine, audit, or redesign an existing page, even when they just say it looks cheap, generic, or AI-made.
 metadata:
-  version: 1.6.1
+  version: 1.7.0
 ---
 
 # Maggie Design
 
+## Redesign audit (upgrade an existing site in place)
+
+When the user wants to improve, polish, upgrade, or redesign an **existing** page or
+app - including "it looks generic / cheap / AI-made" - run the
+[redesign audit](../../references/redesign-audit.md): scan the codebase, diagnose the
+generic AI-design patterns, weak states, and sloppy code against its checklist,
+**report the diagnosis before fixing**, then apply targeted upgrades in its
+fix-priority order through the in-place / section / verify flow below (small,
+reviewable, evidence-backed edits, never a rewrite, never a framework migration).
+Concrete values come from
+[landing-page visual defaults](../../references/landing-page-visual-defaults.md),
+overridden by the project's own DESIGN.md/tokens. For building a new landing page
+from scratch use [`maggie-landing-page`](../maggie-landing-page/SKILL.md); for
+turning a design into an animated showcase use
+[`maggie-design-motion`](../maggie-design-motion/SKILL.md).
+
 ## In-place route evidence
 
 `maggie design in-place --project . --route /example` resolves local source

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topy-ai/maggie",
-  "version": "0.8.6",
+  "version": "0.8.7",
   "description": "Install and manage Maggie Skills for AI coding agents",
   "license": "MIT",
   "type": "module",

package/references/redesign-audit.md

@@ -0,0 +1,144 @@
+# Redesign audit (existing sites)
+
+A diagnostic checklist for upgrading an **existing** site or app to premium quality:
+find the generic AI-design patterns, weak states, and sloppy code, then fix them
+**in place** without breaking functionality or migrating frameworks. Used by the `maggie-design` skill - run the
+audit to decide *what* to change, then apply the changes through maggie-design's
+`in-place` / `section` / `verify` flow (small, reviewable, evidence-backed edits),
+never a rewrite.
+
+Concrete values (fonts, dark colours, spacing, type scale, radius, icons, motion)
+come from [landing-page visual defaults](landing-page-visual-defaults.md); they are
+**defaults** that the project's own DESIGN.md/tokens override. Never invent a value
+that is in neither place - ask. Adapted from `elayadesign/redesign-skill`
+`redesign-existing-projects` (MIT; from `Leonxlnx/taste-skill`); see Credits.
+
+## How to run it
+
+1. **Scan** - read the codebase; identify framework, styling method (Tailwind v3/v4,
+   vanilla CSS, styled-components, CSS modules), and the current patterns.
+2. **Diagnose** - go through the audit below; list every generic pattern, weak
+   point, and missing state. **Report before fixing; let the user veto items.**
+3. **Fix** - apply targeted upgrades inside the existing stack, in the Fix-priority
+   order, through maggie-design (test after each; keep diffs reviewable).
+
+## Audit
+
+### Typography
+Browser-default or Inter/Roboto/Arial/Open Sans/Helvetica fonts; two typefaces on
+one site; any italics; ultra-bold (800/900); only 400+700 in use (add 500/600);
+headlines lacking presence (more display size, tighter tracking); body wider than
+~65 characters; proportional numerals in data UI (use `tabular-nums`); missing
+letter-spacing (negative on big headers, positive on small caps); all-caps
+subheaders everywhere; orphaned words (`text-wrap: balance`/`pretty`); hyphens in
+copy; off-scale font sizes (snap to the type scale, closest step below); off-scale
+button type (main `text-base` semibold, header `text-sm` semibold).
+
+### Colour and surfaces
+Backgrounds outside the approved dark palette (snap to it; not `#0a0a0a`/`#121212`/
+tinted navy); **any background gradient** (flat only; the one exception is hero
+heading text); flat hero heading colour (apply the approved text gradient); **the
+purple/blue "AI gradient" - the single most common AI fingerprint** (flat neutral
+base + one accent); oversaturated accents (keep under ~80%); more than one accent;
+mixing warm and cool grays; generic pure-black `box-shadow` (tint toward the
+background hue); zero-texture flatness (subtle noise/grain, never a gradient);
+inconsistent lighting direction (one light source); a random dark section in a light
+page or vice versa; empty sections with no depth (masked low-opacity imagery or a
+pattern; `https://picsum.photos/seed/{name}/1920/1080` as a placeholder, never an
+ambient gradient).
+
+### Layout
+Everything centred/symmetrical (break it); three equal card columns as the feature
+row (keep 3-5 benefits as content, but zig-zag/asymmetric/scroll/masonry as layout);
+`height: 100vh` (use `min-height: 100dvh`); complex flexbox percentage math (CSS
+Grid); no max-width container (~1200-1440px; hero capped ~680px); flexbox-forced
+equal card heights (allow variable/masonry); radius by feel (token scale +
+nested-radius formula); ad-hoc spacing (the spacing scale); no overlap/depth
+(negative margins to layer); symmetrical vertical padding (optical, usually more at
+the bottom); dashboard always a left sidebar (try top nav / command menu /
+collapsible); missing whitespace; CTAs not bottom-aligned in card groups; pricing/
+comparison list items starting at different Y (fixed-height title/price blocks);
+misaligned baselines across side-by-side elements; mathematically-but-not-optically
+aligned icons/text.
+
+### Interactivity and states
+Default easing (`ease`/`linear`/`ease-in-out` -> the base curve, 500ms movement /
+300ms colour-opacity, never under 200ms); content just "there" on scroll (rise+fade
+once, 600-800ms); scroll listeners (use `IntersectionObserver`/`whileInView`); nav
+welded to the top edge (float it, translucent blur); instant menu-icon swap (animate
+it); cramped mobile dropdown (full-height panel, links staggered ~60ms, under 400ms);
+no reduced-motion handling (swap movement for a fade); no hover state; no active/
+pressed feedback (`scale(0.98)`/`translateY(1px)`); missing focus ring; no loading
+states (skeletons, not spinners); no empty states (a composed getting-started view);
+no error states (inline, specific, never `alert()`); dead `#` links; no current-page
+nav indicator; scroll jumping (`scroll-behavior: smooth`); animating `top`/`left`/
+`width`/`height` (use `transform`/`opacity`).
+
+### Content
+Placeholder/stock people and repeated faces; suspiciously round numbers; generic
+brand names; filler words ("revolutionize", "supercharge", "cutting edge",
+"effortless", "transform your workflow", "world class"); vague value props
+("streamline"/"optimize" -> a measurable outcome); features with no outcome; weak
+CTAs ("Learn more"/"Submit" -> verb + what they get); competing CTAs above the fold;
+proof buried at the bottom; no risk reversal; loud/cute system messages (calm and
+specific); passive voice; placeholder/Latin text (a blocker); Title Case (use
+sentence case).
+
+### Component patterns
+Generic card (border + shadow + white bg -> background or spacing alone; cards only
+where elevation means hierarchy); single-side card border (all around or none);
+always one filled + one ghost button (add text/tertiary); pill "New"/"Beta" badges
+(square/flag/plain); accordion FAQ (keep 6-12 Q&A, change the pattern); three-card
+carousel testimonials with dots; three-tower pricing (emphasise the recommended tier
+by colour/weight, not height); modals for everything (inline/slide-over/expand);
+avatar circles only (squircles); sun/moon theme toggle (dropdown/system/settings);
+four-column footer link farm (main paths + legal only).
+
+### Iconography and imagery
+Lucide/Feather/Material icons (-> the approved set); cliche metaphors (rocket for
+"launch", shield for "security" -> bolt, fingerprint, spark, vault); inconsistent
+stroke widths; missing favicon; stock "diverse team" photos.
+
+### Code quality
+Div soup (semantic HTML); inline styles mixed with classes; hardcoded pixel widths
+(`%`/`rem`/`em`/`max-width`); missing/`alt="image"` alt text; arbitrary z-index like
+`9999` (a scale); commented-out dead code; **import hallucinations** (verify every
+import exists in the dependency file); missing meta tags (`<title>`, description,
+`og:image`, social).
+
+### Strategic omissions (what AI builds forgets)
+Legal links; back navigation; a custom 404; form validation; a skip-to-content link;
+cookie consent where required (see `maggie-legal`); landing-page indexing not
+considered (`noindex` ad-only/time-bound, real title/meta/internal-links/AEO FAQ for
+evergreen - hand SEO specifics to `maggie-seo-geo`).
+
+## Fix priority (max impact, min risk)
+
+1. Font swap - biggest instant win, lowest risk.
+2. Colour and surface cleanup - snap to the palette, remove background gradients.
+3. Hover / active / focus states - makes it feel alive.
+4. Layout and spacing - grid, max-width, spacing scale, nested-radius formula.
+5. Motion pass - base curve, IntersectionObserver reveals, floating nav, mobile menu.
+6. Replace generic components - swap cliche patterns for the alternatives above.
+7. Loading / empty / error states - makes it feel finished.
+8. Copy pass - cut cliches, add specificity, fix CTAs.
+9. Type-scale polish - the premium final touch.
+
+## Rules
+
+- Work with the existing stack; do not migrate frameworks or styling libraries.
+- Do not break functionality; test after every change (maggie-design's verify/QA).
+- Report the diagnosis before fixing; let the user veto items.
+- Check the dependency file before importing any library; check Tailwind v3 vs v4
+  before touching config; no framework -> vanilla CSS.
+- Small, targeted, reviewable changes over big rewrites.
+- Never invent a design value; if it is in neither this audit nor the visual
+  defaults nor the project's system, ask.
+
+## Credits
+
+Adapted (not transcribed) from
+[`elayadesign/redesign-skill`](https://github.com/elayadesign/redesign-skill)
+`redesign-existing-projects` by Elaya (MIT), which adapts audit structure and
+content-realism checks from [`Leonxlnx/taste-skill`](https://github.com/Leonxlnx/taste-skill)
+by Leon Lin (MIT).