@hegemonart/get-design-done 1.34.3 → 1.34.4

package/.claude-plugin/marketplace.json

@@ -5,14 +5,14 @@
   },
   "metadata": {
     "description": "Get Design Done — 5-stage agent-orchestrated design pipeline with 9 connections, handoff-first workflow, bidirectional Figma write-back, 22+ specialized agents, queryable knowledge layer (intel store, dependency analysis, learnings extraction), and a self-improvement loop (reflector, frontmatter + budget feedback, global-skills layer). v1.20.0 ships the SDK foundation: gdd-state MCP server (11 typed tools), lockfile-safe STATE.md mutations, event stream, and resilience primitives (jittered-backoff, rate-guard, error-classifier, iteration-budget) for rate-limit + 429 + context-overflow recovery. Full CI/CD pipeline (Node 22/24 × Linux/macOS/Windows) and release automation (auto-tag + GitHub Release + release-time smoke test).",
-    "version": "1.34.3"
+    "version": "1.34.4"
   },
   "plugins": [
     {
       "name": "get-design-done",
       "source": "./",
       "description": "Agent-orchestrated 5-stage design pipeline: Brief → Explore → Plan → Design → Verify. 22+ specialized agents, 9 connections (Figma, Refero, Preview, Storybook, Chromatic, Figma Writer, Graphify, Pinterest, Claude Design), Claude Design handoff, bidirectional Figma write-back, and a queryable intel store (.design/intel/) for dependency and learnings queries. Standalone commands: style, darkmode, compare, figma-write, graphify, handoff, analyze-dependencies, skill-manifest, extract-learnings. Embeds NNG heuristics, WCAG thresholds, typographic systems, motion framework, and anti-pattern catalog. Ships with a full CI/CD pipeline (Node 22/24 × Linux/macOS/Windows) and release automation. Optimization layer (v1.0.4.1, retroactive): gdd-router + gdd-cache-manager skills, PreToolUse budget-enforcer hook, tier-aware agent frontmatter, lazy checker gates, streaming synthesizer, /gdd:warm-cache + /gdd:optimize commands, and cost telemetry at .design/telemetry/costs.jsonl — targeting 50-70% per-task token-cost reduction with no quality-floor regression. v1.20.0 SDK foundation: gdd-state MCP server (11 typed tools), lockfile-safe STATE.md mutations, event stream at .design/telemetry/events.jsonl, resilience primitives (jittered-backoff, rate-guard, error-classifier, iteration-budget) with rate-limit + 429 + context-overflow recovery, and TypeScript toolchain.",
-      "version": "1.34.3",
+      "version": "1.34.4",
       "author": {
         "name": "hegemonart"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "get-design-done",
   "short_name": "gdd",
-  "version": "1.34.3",
+  "version": "1.34.4",
   "description": "Agent-orchestrated 5-stage design pipeline: Brief → Explore → Plan → Design → Verify. 22+ specialized agents, 9 connections (Figma, Refero, Preview, Storybook, Chromatic, Figma Writer, Graphify, Pinterest, Claude Design), handoff-first workflow via Claude Design bundles, bidirectional Figma write-back (annotations, Code Connect), queryable intel store (`.design/intel/`) for O(1) design surface lookups, and self-improvement loop (reflector agent, frontmatter + budget feedback, global-skills layer at `~/.claude/gdd/global-skills/`). Standalone commands: style, darkmode, compare, figma-write, graphify, handoff, analyze-dependencies, skill-manifest, extract-learnings, reflect, apply-reflections. Embeds NNG heuristics, WCAG thresholds, typographic systems, motion framework, and anti-pattern catalog. Ships with a full CI/CD pipeline (Node 22/24 × Linux/macOS/Windows, lint + schema + frontmatter + stale-ref + shellcheck + gitleaks + injection-scan + blocking size-budget) and release automation (auto-tag + GitHub Release + release-time smoke test). Optimization layer (v1.0.4.1, retroactive): gdd-router + gdd-cache-manager skills, PreToolUse budget-enforcer hook, tier-aware agent frontmatter, lazy checker gates, streaming synthesizer, /gdd:warm-cache + /gdd:optimize commands, and cost telemetry at .design/telemetry/costs.jsonl — targeting 50-70% per-task token-cost reduction with no quality-floor regression. v1.20.0 SDK foundation: gdd-state MCP server (11 typed tools), lockfile-safe STATE.md mutations, event stream at .design/telemetry/events.jsonl, resilience primitives (jittered-backoff, rate-guard, error-classifier, iteration-budget) with rate-limit + 429 + context-overflow recovery, and TypeScript toolchain. v1.27.7 ships gdd-mcp (Phase 27.7): 12 read-only MCP tools for sub-3s priming. v1.28.0 (Phase 28): Foundational References Tier 2 — 5 new reference files (color-theory, composition, proportion-systems, i18n, contrast-advanced), 2 verifier i18n probes + 1 explore i18n-readiness probe, 12 additive cross-link insertions across 10 existing references, 2 orthogonal audit-scoring lens-tags (composition_alignment + i18n_readiness).",
   "author": {
     "name": "hegemonart",

package/CHANGELOG.md

@@ -4,6 +4,28 @@ All notable changes to get-design-done are documented here. Versions follow [sem
 
 ---
 
+## [1.34.4] - 2026-06-01
+
+### Phase 34.4 — Lazyweb + Mobbin Research Connections (recovered)
+
+Adds **two visual-reference MCP connections** to the discover stage — **Lazyweb** (free) and **Mobbin** (paid) — modeled on the existing Refero/Pinterest connection contract. Purely additive: no new pipeline stage, no new artifact, no new audit pillar; **no new runtime dependency** (both are optional user-installed MCPs, documented in their spec, never pre-declared in the plugin manifest — the Refero precedent). Recovered from a stranded Phase 30.5 fork (authored 2026-05-04 → expanded 2026-05-16) that never reached the canonical roadmap because `.planning/` is gitignored and a parallel session reused the 30.5 slot. A decimal release on the v1.34.x arc (CHANGELOG-only, D-02).
+
+### Added
+
+- **`connections/lazyweb.md` — free reference MCP (discover Tier 1, D-01).** Free bearer-token Streamable-HTTP MCP at `https://www.lazyweb.com/mcp` (`lazyweb_search` + `lazyweb_health`); 250k+ real app screens for pricing pages, onboarding flows, redesign comparisons, UI benchmarking. Copy-command setup (token at `~/.lazyweb/lazyweb_mcp_token`, then `claude plugin install lazyweb@lazyweb`) — **no auto-run** (the token write is a user-consent step). ToolSearch-only probe.
+- **`connections/mobbin.md` — curated mobile/flow reference MCP (discover Tier 2, D-01).** HTTP MCP at `https://api.mobbin.com/mcp` (`claude mcp add mobbin --transport http https://api.mobbin.com/mcp`, auto-run-safe — OAuth on first call, requires an active Mobbin subscription); 600k+ screens / 130k+ flows for mobile + flow-level references. ToolSearch-only probe.
+- **Cost-aware discover tier order (D-01).** Reference sources now resolve **Lazyweb (free, tried first) → Mobbin / Refero (paid, whichever is bound + subscribed) → Pinterest → awesome-design-md → WebFetch** — try the zero-cost source before any paid one. Wired through `connections/connections.md` (table + Capability Matrix + probe pattern, onboarded 12 → 14), `skills/discover/discover-procedure.md` (probes D/E), `skills/connections/` (`/gdd:connections` wizard + onboarding reference), and `agents/design-context-builder.md` (Area 5 rewrite + `tools` frontmatter).
+- **Regression baseline.** `test/fixtures/baselines/phase-34-4/` (onboarded-connections snapshot + `manifests-version.txt`=1.34.4) pinned by `test/suite/phase-34-4-baseline.test.cjs`.
+
+### Notes
+
+- **No new runtime dependency** — both connections are optional user-installed MCPs (Refero precedent); neither is declared in `.claude-plugin/plugin.json`. Discover-stage only — no scan/plan/design/verify integration.
+- The 31.5 tarball golden (`test/fixtures/baselines/phase-31-5/tarball-manifest.txt`) was regenerated as a reviewed delta: **+2** newly-shipped files (`connections/lazyweb.md`, `connections/mobbin.md`), zero removals. Tests are not shipped.
+- 6-manifest lockstep at **v1.34.4** (`package.json` + `package-lock.json` (root + `packages.""`) + `.claude-plugin/plugin.json` + `.claude-plugin/marketplace.json` (metadata.version + plugins[0].version) + `.cursor-plugin/plugin.json` + `.codex-plugin/plugin.json`). Version-sync hygiene upfront (D-09): `OFF_CADENCE_VERSIONS.add('1.34.4')` + the 18 live-pinned `manifests-version.txt` baselines forward-propagated 1.34.3 → 1.34.4.
+- **Provenance:** recovered from the `thirsty-curran` worktree's stranded `.planning` fork during a roadmap-reconciliation audit; the contiguity renumber (Phase 36→35 …, 2026-06-01) is unrelated and concurrent.
+
+---
+
 ## [1.34.3] - 2026-05-31
 
 ### Phase 34.3 — Non-Web Output Layer: Print/PDF

package/README.md

@@ -130,6 +130,10 @@ GDD also generates **print/PDF** output — the project-type detector routes a `
 
 The constraints live in [`reference/print-design.md`](reference/print-design.md) — the `@page` box model (size/margin/marks), bleed box + crop/registration marks, CMYK color-space awareness (print is subtractive CMYK, not screen RGB), font embedding/outlining (print RIPs have no web fonts), and a 300dpi raster fallback. A deterministic static checker ([`scripts/lib/print/validate-print-css.cjs`](scripts/lib/print/validate-print-css.cjs)) flags the statically-verifiable subset (`PR-PAGE`/`PR-BLEED`/`PR-CMYK`/`PR-FONT`/`PR-DPI`). Rendered PDF/page verification via the optional [`print-renderer`](connections/print-renderer.md) connection (Paged.js/headless-Chrome or PDFKit) is **optional** — when absent the verify stage degrades to the static validator. Print generation is opt-in; **web stays the default**.
 
+### Research connections — Lazyweb + Mobbin (v1.34.4)
+
+The **discover** stage grounds design in real product references, resolving sources **cost-aware — the free source is tried before any paid one**. [`Lazyweb`](connections/lazyweb.md) (free MCP, 250k+ app screens — pricing pages, onboarding, redesign comparisons) is **Tier 1, always first**; [`Mobbin`](connections/mobbin.md) (paid MCP, 600k+ screens / 130k+ flows — mobile + flow-level) and [`Refero`](connections/refero.md) are **Tier 2** (use whichever you subscribe to), then Pinterest → local archetypes → WebFetch. Both are optional user-installed MCPs (**no new runtime dependency**), onboardable via `/gdd:connections`.
+
 ### Previous releases
 
 - **v1.26.0** — Headless Model Resolver (per-runtime tier→model map, `resolved_models` router field, per-runtime price tables, `reasoning-class` runtime-neutral alias).

package/agents/design-context-builder.md

@@ -1,7 +1,7 @@
 ---
 name: design-context-builder
 description: Detects existing design system state via grep/glob, runs discovery interview asking ONLY unanswered questions, produces .design/DESIGN-CONTEXT.md. Spawned by the discover stage.
-tools: Read, Write, Bash, Grep, Glob, mcp__figma__get_variable_defs, mcp__figma__get_metadata, mcp__figma-desktop__get_variable_defs, mcp__figma-desktop__get_metadata, mcp__Figma__get_variable_defs, mcp__Figma__get_metadata, mcp__refero__search
+tools: Read, Write, Bash, Grep, Glob, mcp__figma__get_variable_defs, mcp__figma__get_metadata, mcp__figma-desktop__get_variable_defs, mcp__figma-desktop__get_metadata, mcp__Figma__get_variable_defs, mcp__Figma__get_metadata, mcp__refero__search, mcp__lazyweb__search, mcp__lazyweb__health, mcp__mobbin__search
 required_reading:
   - connections/storybook.md
 color: blue
@@ -383,51 +383,34 @@ The NOT is equally important:
 
 **Style direction (style-vocabulary.md):** Ask the user to confirm or adjust the inferred UI aesthetic style before writing the context file. Infer the style from the brand direction words captured above. Look up the inferred style name verbatim in `reference/style-vocabulary.md` to confirm it is coherent with the product type (Best For / Avoid For columns) and to surface the performance cost (Performance column) in the Constraints section. Record the confirmed style name verbatim in the context file as a `D-0N` decision so downstream agents can pattern-match it. Example: `D-04: [Style] "Glassmorphism Dark" — confirmed for gaming media player context; GPU cost noted in constraints.`
 
-### Area 5 — Visual References (Refero-augmented)
+### Area 5 — Visual References (cost-aware — free source first)
 
-This area uses Refero MCP when available, with graceful fallback to local brand archetypes and finally WebFetch. Refero tool names may vary — verify via ToolSearch before calling.
+This area pulls real product references, resolving sources **cost-aware (D-01, Phase 34.4): try the free source before any paid one.** Check `.design/STATE.md` `<connections>` for `lazyweb:` / `mobbin:` / `refero:` / `pinterest:` status before proceeding. Tool names may vary — verify via ToolSearch before calling. **Two or more references are required.**
 
-Check `.design/STATE.md` `<connections>` for `refero:` status before proceeding.
+**Tier 1 — Lazyweb (FREE — tried first; if `lazyweb: available`)**
 
-**Tier 1 — Refero (if `refero: available` in `.design/STATE.md` `<connections>`)**
-
-ToolSearch first — Refero tools may be in the deferred tool set:
+ToolSearch first (tools may be deferred): `ToolSearch({ query: "lazyweb", max_results: 10 })` (expect `lazyweb_search` + `lazyweb_health`). Run ≥2 `lazyweb_search` queries — one **structural** (from README/scope, e.g. `"pricing page three tiers"`, `"onboarding checklist"`, `"data table pagination"`) + one **aesthetic** (from the Area-4 brand direction, e.g. `"warm editorial SaaS"`, `"neutral Swiss dashboard"`). Pre-populate:
 
 ```
-ToolSearch({ query: "refero", max_results: 10 })
+L-01: [Lazyweb result title] — source: lazyweb — borrow: [inferred borrow rationale]
+L-02: [Lazyweb result title] — source: lazyweb — borrow: [inferred borrow rationale]
 ```
 
-Confirm the exact search tool name from results (expected: `mcp__refero__search` — may differ).
-
-Run at least 2 searches:
-
-1. **Structural query** — inferred from README / project scope (example: `"admin dashboard filters"`, `"onboarding flow"`, `"data table pagination"`)
-2. **Aesthetic query** — inferred from brand direction captured in Area 4, if any (example: `"brutalist editorial UI"`, `"warm developer tool dashboard"`)
-
-Select 2–3 results. Pre-populate references as:
-
-```
-R-01: [Refero result title] — source: refero — borrow: [inferred borrow rationale from result content]
-R-02: [Refero result title] — source: refero — borrow: [inferred borrow rationale]
-```
-
-Present to user: "I found these references from Refero. Confirm or replace?"
-
-**Tier 2 — awesome-design-md (if `refero: not_configured` OR `refero: unavailable`)**
+**Tier 2 — Mobbin / Refero (PAID — use whichever is bound + has an active subscription; if both, Mobbin for mobile/flow-level, Refero for broad screen-level)**
 
-Look in `~/.claude/libs/awesome-design-md/design-md/` — 68 brand archetypes, each with a full `DESIGN.md` token file. Pick 1–2 closest matches by inferred product category (e.g., B2B SaaS → Linear, Vercel; consumer → Airbnb, Spotify; editorial → NYT, Bloomberg).
+Fall here when Lazyweb is unavailable, or for paid depth. If `mobbin: available`: `ToolSearch({ query: "mobbin", max_results: 10 })`, run structural/flow + aesthetic queries, cite `M-01: [title] — source: mobbin — borrow: …`. If `refero: available`: `ToolSearch({ query: "refero", max_results: 10 })` (expected `mcp__refero__search` — may differ), run a structural + an aesthetic query, cite `R-01: [title] — source: refero — borrow: …`. Present to user: "I found these references. Confirm or replace?"
 
-Pre-populate: `R-01: [Brand name] — source: awesome-design-md — borrow: [token values — color palette, spacing scale, typography]`
+**Tier 3 — Pinterest (if `pinterest: available`)**
 
-Add a note in `<references>`: `Note: Refero unavailable — using local brand archetypes as references.`
+Visual inspiration search via the verified Pinterest tool (ToolSearch `"mcp-pinterest"` first). Cite `P-01: [title] — source: pinterest — borrow: …`.
 
-**Tier 3 — WebFetch (last resort, if awesome-design-md unavailable)**
+**Tier 4 — awesome-design-md (local brand archetypes, if no reference MCP is available)**
 
-Ask the user for a getdesign.md URL. WebFetch it and extract design tokens.
+Look in `~/.claude/libs/awesome-design-md/design-md/` — 68 brand archetypes, each with a full `DESIGN.md` token file. Pick 1–2 closest matches by inferred product category (e.g., B2B SaaS → Linear, Vercel; consumer → Airbnb, Spotify; editorial → NYT, Bloomberg). Pre-populate `R-01: [Brand name] — source: awesome-design-md — borrow: [token values — color palette, spacing scale, typography]` + add a note in `<references>`: `Note: no reference MCP available — using local brand archetypes.`
 
-Pre-populate: `R-01: [URL] — source: webfetch — borrow: [extracted tokens: color palette, type scale, spacing units]`
+**Tier 5 — WebFetch (last resort, if awesome-design-md unavailable)**
 
-Note: Refero tool name may differ — always verify via ToolSearch. Two or more references are required.
+Ask the user for a getdesign.md URL. WebFetch it and extract design tokens. Pre-populate `R-01: [URL] — source: webfetch — borrow: [extracted tokens: color palette, type scale, spacing units]`.
 
 ### Area 6 — Constraints
 

package/connections/connections.md

@@ -2,7 +2,7 @@
 
 This directory contains connection specifications for external tools and MCPs that the get-design-done pipeline integrates with. Each connection has its own spec file. This file is the index.
 
-**Getting started:** run `/gdd:connections` for the interactive onboarding wizard — it probes all 12 connections, recommends setup based on your project type, and walks you through installing each one (auto-run for reversible MCP adds, copy-command for everything else). You can also run `/gdd:connections list` for a read-only status check or `/gdd:connections <name>` to jump to a single connection's setup.
+**Getting started:** run `/gdd:connections` for the interactive onboarding wizard — it probes all 14 connections, recommends setup based on your project type, and walks you through installing each one (auto-run for reversible MCP adds, copy-command for everything else). You can also run `/gdd:connections list` for a read-only status check or `/gdd:connections <name>` to jump to a single connection's setup.
 
 ---
 
@@ -28,6 +28,8 @@ This directory contains connection specifications for external tools and MCPs th
 | Android Emulator | Active | [`connections/android-emulator.md`](connections/android-emulator.md) | **Optional**; CLI: `adb` / `emulator` (no MCP); native-Android rendered evidence for verify; degrade-to-code-only when absent (D-03) |
 | Litmus | Active | [`connections/litmus.md`](connections/litmus.md) | **Optional** render-test (email; Email-on-Acid alternative); cross-client rendered screenshots for verify; degrade-to-static-validator / code-only when absent (D-03) |
 | Print-Renderer | Active | [`connections/print-renderer.md`](connections/print-renderer.md) | **Optional** print render-test (Paged.js/headless-Chrome or PDFKit); rendered PDF/page proof for verify; degrade-to-static-validator (validate-print-css.cjs) / code-only when absent (D-03) |
+| Lazyweb | Active | [`connections/lazyweb.md`](connections/lazyweb.md) | **Free** bearer-token MCP `lazyweb_search` / `lazyweb_health` (ToolSearch-only probe; copy-command setup, no auto-run); discover **Tier 1** — tried first (D-01) |
+| Mobbin | Active | [`connections/mobbin.md`](connections/mobbin.md) | **Paid** HTTP MCP `claude mcp add mobbin --transport http https://api.mobbin.com/mcp` (ToolSearch-only probe; auto-run-safe, OAuth); discover **Tier 2** — mobile/flow-level (D-01) |
 
 ---
 
@@ -55,6 +57,8 @@ Each cell describes what the connection contributes at that pipeline stage, or `
 | Android Emulator | — | — | — | native Android code-gen target (compose-executor / emitCompose) | rendered Compose screenshot when emulator available, else degrade to code-only structural audit (D-03) | — | — |
 | Litmus | — | — | — | email render-test target (email-executor) | cross-client rendered evidence when Litmus available, else degrade to the static email-HTML validator / code-only (D-03) | — | — |
 | Print-Renderer | — | — | — | print render-test target (pdf-executor) | rendered PDF/page evidence when the print-render is available, else degrade to the static print-CSS validator / code-only (D-03) | — | — |
+| Lazyweb | — | reference search via `lazyweb_search` (**Tier 1 — free, tried first**; D-01); complements refero/pinterest | — | — | — | — | — |
+| Mobbin | — | reference search via mobbin tools (**Tier 2 — paid, mobile/flow-level**; D-01); complements refero/lazyweb | — | — | — | — | — |
 
 **Column definitions:**
 
@@ -138,6 +142,30 @@ Write refero status to STATE.md <connections>.
 
 Note: Refero probe is ToolSearch-only (no live tool call). ToolSearch presence is sufficient; a live Refero search as probe would waste tokens before confirming the connection is even needed.
 
+**Lazyweb probe (execute at stage entry, after reading STATE.md):**
+
+```
+Step D1 — ToolSearch check:
+  ToolSearch({ query: "lazyweb", max_results: 5 })
+  → Empty result      → lazyweb: not_configured  (use fallback chain)
+  → Non-empty result  → lazyweb: available
+
+Write lazyweb status to STATE.md <connections>.
+```
+
+**Mobbin probe (execute at stage entry, after reading STATE.md):**
+
+```
+Step E1 — ToolSearch check:
+  ToolSearch({ query: "mobbin", max_results: 5 })
+  → Empty result      → mobbin: not_configured  (use fallback chain)
+  → Non-empty result  → mobbin: available
+
+Write mobbin status to STATE.md <connections>.
+```
+
+Note: Lazyweb + Mobbin probes are ToolSearch-only (no live call). The discover stage resolves reference sources **cost-aware (D-01): Lazyweb (free) → Mobbin / Refero (paid, whichever is bound + subscribed) → Pinterest → awesome-design-md → WebFetch.**
+
 ---
 
 **Preview probe (execute at stage entry, after reading STATE.md):**

package/connections/lazyweb.md

@@ -0,0 +1,124 @@
+# Lazyweb MCP — Connection Specification
+
+This file is the connection specification for Lazyweb within the get-design-done pipeline. It lives in `connections/` alongside other connection specs. See `connections/connections.md` for the full connection index and capability matrix.
+
+---
+
+Lazyweb is a **free, MCP-native visual-reference library** (250k+ real app screens). In the discover stage it is the **cost-aware default**: because it requires no paid subscription, GDD tries it **first**, before any paid reference source (Mobbin/Refero). Pitched for pricing pages, onboarding flows, "improve this existing screen" comparisons, and UI benchmarking against shipped products.
+
+---
+
+## Setup
+
+**Prerequisites:**
+
+- No account or subscription required — the free tier authorizes read-only UI reference search.
+- A Lazyweb MCP bearer token (free) saved locally.
+
+**Install (Claude Code):** *copy-command — never auto-run, because it writes a credential to disk (user-consent step).*
+
+```
+# 1. save the free bearer token (chmod 600 — local config only, never commit)
+mkdir -p ~/.lazyweb && printf '%s' "<your-token>" > ~/.lazyweb/lazyweb_mcp_token && chmod 600 ~/.lazyweb/lazyweb_mcp_token
+# 2. install the plugin
+claude plugin marketplace add https://github.com/aboul3ata/lazyweb-skill
+claude plugin install lazyweb@lazyweb
+```
+
+**Cursor / Codex / generic MCP:** register the Streamable-HTTP MCP endpoint `https://www.lazyweb.com/mcp` with the bearer token per the host's MCP-config format (follow Lazyweb's install docs for the exact block). Restart the session after install.
+
+**Verification:**
+
+```
+ToolSearch({ query: "lazyweb", max_results: 10 })
+```
+
+Expect `lazyweb_search` + `lazyweb_health`. If empty, the MCP is not registered — complete the install and restart.
+
+---
+
+## When to use
+
+In the **discover** stage, **try Lazyweb first** (it's free). Strong for:
+
+- Pricing pages, plan/billing layouts
+- Onboarding + activation flows
+- "Improve this existing screen" / redesign comparisons
+- UI benchmarking against real, shipped products
+
+## Tools available (verify via ToolSearch on first use)
+
+- **`lazyweb_search` `{ query, limit }`** — semantic search across Lazyweb's indexed app-screen corpus.
+- **`lazyweb_health`** — connection/health probe.
+
+Names may vary between versions — treat the ToolSearch result as authoritative; do not hardcode.
+
+## Search strategy
+
+Run **at least 2 queries per task** — one structural, one aesthetic (same discipline as Refero):
+
+- **Structural** (what it IS): "pricing page three tiers", "onboarding checklist", "empty state dashboard", "settings billing".
+- **Aesthetic** (how it should FEEL): "warm editorial SaaS", "neutral Swiss dashboard", "dark fintech".
+
+## Workflow
+
+```
+1. lazyweb_search "pricing page three tiers"     # structural
+2. lazyweb_search "warm editorial consumer app"  # aesthetic
+3. pick 3-7 that match the brief; save URLs + notes into the discover reference pack
+4. proceed to the plan stage with the pack
+```
+
+## Citing references in output
+
+Always name the reference: cite as `L-01: [title] — source: lazyweb — borrow: [what you took]`. Never claim originality; show the user the logic so they can push back precisely.
+
+## STATE.md integration
+
+Every stage that probes Lazyweb writes the result to `.design/STATE.md` under `<connections>`:
+
+```xml
+<connections>
+lazyweb: available
+</connections>
+```
+
+| Value | Meaning |
+|-------|---------|
+| `available` | ToolSearch returned non-empty results for `lazyweb` |
+| `unavailable` | Lazyweb tools present but a live call errored |
+| `not_configured` | ToolSearch returned empty — MCP not registered |
+
+**Probe pattern (ToolSearch-only — no tool call, no token cost):**
+
+```
+ToolSearch({ query: "lazyweb", max_results: 5 })
+  → Empty result     → lazyweb: not_configured
+  → Non-empty result → lazyweb: available
+```
+
+**Which stages probe Lazyweb:** the discover stage only (via `agents/design-context-builder.md`). Scan, plan, design, and verify do not use it.
+
+---
+
+## Fallback chain (cost-aware — try free before paid)
+
+The discover stage resolves reference sources in this order:
+
+1. **Lazyweb (Tier 1 — FREE)** — always tried first. Use when `lazyweb: available`.
+2. **Mobbin / Refero (Tier 2 — PAID)** — fall here when Lazyweb is unavailable OR you need their depth; use whichever is bound AND has an active subscription (if both, Mobbin then Refero).
+3. **Pinterest (Tier 3)** — headless scrape, occasionally flaky.
+4. **awesome-design-md (Tier 4)** — `~/.claude/libs/awesome-design-md/design-md/` structured DESIGN.md tokens.
+5. **WebFetch (Tier 5)** — last resort.
+
+Lazyweb never *replaces* the paid corpora — it's the free first attempt; fall through for breadth/flow-depth. Never proceed without references — that's the point of discover.
+
+## Anti-pattern + token handling
+
+- Don't dump a huge set of references into the response (noise) — pick 3–7 matching the brief.
+- Don't use it to justify a pre-decided direction (pull first, then decide).
+- **Token handling**: the free tier authorizes no-billing UI reference reads ONLY — never purchases, paid spend, private user data, or destructive actions. The bearer token is local-config-only (`~/.lazyweb/lazyweb_mcp_token`); never commit it to git history.
+
+## If Lazyweb's API changes
+
+Keep this file current. If tool names or the endpoint shift, update the examples here and adjust the routing in `skills/discover/SKILL.md` + `agents/design-context-builder.md`.

package/connections/mobbin.md

@@ -0,0 +1,119 @@
+# Mobbin MCP — Connection Specification
+
+This file is the connection specification for Mobbin within the get-design-done pipeline. It lives in `connections/` alongside other connection specs. See `connections/connections.md` for the full connection index and capability matrix.
+
+---
+
+Mobbin is a **curated mobile + web product reference library** (600k+ screens, 130k+ user flows from 1,600+ shipped apps) — the de-facto standard for **flow-level** mobile references. In the discover stage it is a **Tier-2 (paid) source**: GDD tries free Lazyweb first, then falls to Mobbin or Refero depending on which the user has an active subscription for. Mobbin's edge is editorial discipline + flow-level metadata + verified-product depth, especially for mobile (iOS/Android).
+
+---
+
+## Setup
+
+**Prerequisites:**
+
+- An active Mobbin subscription (the MCP is included with a paid plan).
+
+**Install (Claude Code):** *auto-run-safe — `claude mcp add` is a stateless MCP registration with zero credential filesystem-write; OAuth is handled by Mobbin in a browser on the first tool call.*
+
+```
+claude mcp add mobbin --transport http https://api.mobbin.com/mcp
+```
+
+On the first `mobbin` tool call, Mobbin opens a browser sign-in (OAuth) — no token is written to disk by GDD.
+
+**Cursor / Codex / generic MCP:** register the HTTP MCP endpoint `https://api.mobbin.com/mcp` per the host's MCP-config format; sign in via the OAuth prompt on first use. Restart the session after install.
+
+**Verification:**
+
+```
+ToolSearch({ query: "mobbin", max_results: 10 })
+```
+
+Expect Mobbin search/browse tools. If empty, the MCP is not registered — run the add command and restart.
+
+---
+
+## When to use
+
+In the **discover** stage, fall to Mobbin (after free Lazyweb) when you have a subscription and need:
+
+- **Mobile** UI references (iOS / Android platform conventions)
+- **Flow-level** references (multi-screen journeys) vs single screens
+- Industry-specific patterns — "how do fintech apps do KYC", "social app notification permission priming"
+- Verified, curated, real-product screens
+
+## Tools available (verify via ToolSearch on first use)
+
+Mobbin exposes search / browse tools (apps, screens, flows, collections) under its MCP. Names may vary between versions — treat the ToolSearch result as authoritative; do not hardcode.
+
+## Search strategy
+
+Run structural + aesthetic + **flow-level** queries (Mobbin's differentiator is flows):
+
+- **Structural / flow**: "onboarding fintech", "checkout commerce", "paywall subscription", "empty state messaging".
+- **Platform**: "iOS settings", "Android bottom sheet".
+- **Industry**: "KYC verification flow", "ride-hailing trip tracking".
+
+## Workflow
+
+```
+1. mobbin search "paywall subscription"    # flow/structural
+2. mobbin search "calm editorial fintech"  # aesthetic
+3. pick 3-5 references (NOT whole flow sets) matching the brief; save into the reference pack
+4. proceed to the plan stage with the pack
+```
+
+## Citing references in output
+
+Always name the reference: cite as `M-01: [title] — source: mobbin — borrow: [what you took]`. Show the structure you borrowed (e.g., "takes Revolut's KYC step sequencing").
+
+## STATE.md integration
+
+Every stage that probes Mobbin writes the result to `.design/STATE.md` under `<connections>`:
+
+```xml
+<connections>
+mobbin: available
+</connections>
+```
+
+| Value | Meaning |
+|-------|---------|
+| `available` | ToolSearch returned non-empty results for `mobbin` |
+| `unavailable` | Mobbin tools present but a live call errored (e.g., not signed in / no subscription) |
+| `not_configured` | ToolSearch returned empty — MCP not registered |
+
+**Probe pattern (ToolSearch-only — no tool call, no API cost):**
+
+```
+ToolSearch({ query: "mobbin", max_results: 5 })
+  → Empty result     → mobbin: not_configured
+  → Non-empty result → mobbin: available
+```
+
+**Which stages probe Mobbin:** the discover stage only (via `agents/design-context-builder.md`). Scan, plan, design, and verify do not use it.
+
+---
+
+## Fallback chain (cost-aware — try free before paid)
+
+The discover stage resolves reference sources in this order:
+
+1. **Lazyweb (Tier 1 — FREE)** — always tried first.
+2. **Mobbin / Refero (Tier 2 — PAID)** — Mobbin and Refero are peers here; use whichever is bound AND has an active subscription. If both are available, **Mobbin** for mobile/flow-level depth, **Refero** for broad screen-level coverage.
+3. **Pinterest (Tier 3)** — headless scrape, occasionally flaky.
+4. **awesome-design-md (Tier 4)** — structured DESIGN.md tokens.
+5. **WebFetch (Tier 5)** — last resort.
+
+Never proceed without references — that's the point of discover.
+
+## Anti-pattern
+
+- **Don't dump entire flow sets** into the response — pick 3–5 references that match the brief.
+- Don't use Mobbin for desktop-heavy work where Refero/Lazyweb are stronger (Mobbin's depth is mobile + flows).
+- Don't use it to justify a pre-decided direction (pull first, then decide).
+
+## If Mobbin's API changes
+
+Keep this file current. If tool names or the endpoint shift, update the examples here and adjust the routing in `skills/discover/SKILL.md` + `agents/design-context-builder.md`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hegemonart/get-design-done",
-  "version": "1.34.3",
+  "version": "1.34.4",
   "description": "A design-quality pipeline for AI coding agents: brief, plan, implement, and verify UI work against your design system.",
   "author": "Hegemon",
   "homepage": "https://github.com/hegemonart/get-design-done",

package/skills/connections/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: gdd-connections
-description: "Interactive onboarding wizard for the 12 external integrations the pipeline supports — probes all (`figma`, `refero`, `preview`, `storybook`, `chromatic`, `graphify`, `pinterest`, `claude-design`, `paper-design`, `pencil-dev`, `21st-dev`, `magic-patterns`), recommends based on project type, walks the user through setup (auto-run MCP install or copy-command fallback), writes results to `STATE.md <connections>`. Use after `/gdd:new-project` or whenever the user wants to add, inspect, or skip a connection. Re-runnable anytime."
+description: "Interactive onboarding wizard for the 14 external integrations the pipeline supports — probes all (`figma`, `refero`, `preview`, `storybook`, `chromatic`, `graphify`, `pinterest`, `claude-design`, `paper-design`, `pencil-dev`, `21st-dev`, `magic-patterns`, `lazyweb`, `mobbin`), recommends based on project type, walks the user through setup (auto-run MCP install or copy-command fallback), writes results to `STATE.md <connections>`. Use after `/gdd:new-project` or whenever the user wants to add, inspect, or skip a connection. Re-runnable anytime."
 argument-hint: "[list | <connection-name> | --auto]"
 user-invocable: true
 tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, ToolSearch
@@ -8,11 +8,11 @@ tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, ToolSearch
 
 # /gdd:connections
 
-Interactive onboarding for the 12 external integrations the pipeline supports. Replaces "probe silently at scan entry and hope the user noticed" with an explicit "here is what can plug in, here is how."
+Interactive onboarding for the 14 external integrations the pipeline supports. Replaces "probe silently at scan entry and hope the user noticed" with an explicit "here is what can plug in, here is how."
 
 Canonical per-connection specs live in `../../connections/<name>.md` (one file per integration). The capability matrix + probe-pattern spec live in `../../connections/connections.md`. This skill is the **user-facing front end** for those specs.
 
-For the 12 probe scripts (MCP + HTTP + CLI + file probes), bucket categorization, per-connection setup screen, auto-run eligibility matrix, value-prop one-liners, and STATE.md / config.json write contracts, see `./connections-onboarding.md`. For the cross-skill probe pattern + connection-handshake summary, see `../../reference/shared-preamble.md#connection-handshake-summary`. For the cross-skill output discipline, see `../../reference/shared-preamble.md#output-contract-reminders`.
+For the 14 probe scripts (MCP + HTTP + CLI + file probes), bucket categorization, per-connection setup screen, auto-run eligibility matrix, value-prop one-liners, and STATE.md / config.json write contracts, see `./connections-onboarding.md`. For the cross-skill probe pattern + connection-handshake summary, see `../../reference/shared-preamble.md#connection-handshake-summary`. For the cross-skill output discipline, see `../../reference/shared-preamble.md#output-contract-reminders`.
 
 ---
 
@@ -38,7 +38,7 @@ For the 12 probe scripts (MCP + HTTP + CLI + file probes), bucket categorization
 
 ## Workflow
 
-1. **Probe all 12 connections** — run every probe script per `./connections-onboarding.md#step-1--probe-all-12-connections`. MCP probes use `ToolSearch` first; HTTP / CLI / file probes follow non-MCP patterns. Merge results into `STATE.md <connections>` with the three-value schema (`available | unavailable | not_configured`) — never add new values.
+1. **Probe all 14 connections** — run every probe script per `./connections-onboarding.md#step-1--probe-all-14-connections`. MCP probes use `ToolSearch` first; HTTP / CLI / file probes follow non-MCP patterns. Merge results into `STATE.md <connections>` with the three-value schema (`available | unavailable | not_configured`) — never add new values.
 2. **Categorize + build summary** — bucket each probe result (available / recommended / optional / skipped / unavailable) using project-hint detection. Detail + recommendation mapping: `./connections-onboarding.md#step-2--bucket-categorization`.
 3. **Print summary table** — show buckets + value-prop one-liners (verbatim from `./connections-onboarding.md#step-3--summary-table`).
 4. **Route by mode** — `list` / `--auto` exits after summary; `<name>` jumps straight to Step 5; default mode opens an AskUserQuestion (configure recommended / pick one by one / configure all optional / re-check specific / exit). Routing detail: `./connections-onboarding.md#step-4--route-by-mode`.

package/skills/connections/connections-onboarding.md

@@ -9,7 +9,7 @@ last_updated: 2026-05-18
 
 Source: extracted from `skills/connections/SKILL.md` (Phase 28.5 rework — D-10 extract-then-link).
 The skill's load-bearing routing + invocation-mode dispatch stays in `../skills/connections/SKILL.md`;
-this file holds the 12 probe scripts, bucket categorization, per-connection setup screen,
+this file holds the 14 probe scripts, bucket categorization, per-connection setup screen,
 auto-run eligibility matrix, value-prop one-liners, and STATE.md / config.json write contracts.
 
 # Connections Onboarding Procedure
@@ -27,7 +27,7 @@ this file does NOT duplicate them; it points at them by name.
 
 ---
 
-## Step 1 — Probe all 12 connections
+## Step 1 — Probe all 14 connections
 
 Run every probe below in order. MCP probes call `ToolSearch` first (deferred tools fail silently without it). Write every result to `STATE.md <connections>` when done.
 
@@ -86,6 +86,20 @@ ToolSearch({ query: "mcp__magic_patterns", max_results: 5 })
 → Non-empty → magic_patterns: available
 ```
 
+**lazyweb:** (discover Tier 1 — free, tried first; D-01)
+```
+ToolSearch({ query: "lazyweb", max_results: 5 })
+→ Empty → lazyweb: not_configured
+→ Non-empty → lazyweb: available
+```
+
+**mobbin:** (discover Tier 2 — paid, mobile/flow-level; D-01)
+```
+ToolSearch({ query: "mobbin", max_results: 5 })
+→ Empty → mobbin: not_configured
+→ Non-empty → mobbin: available
+```
+
 ### Non-MCP probes
 
 **storybook** (HTTP):
@@ -131,7 +145,7 @@ Bash: ls .design/handoff/ 2>/dev/null || find . -maxdepth 3 \
   → Non-empty → claude_design: available
 ```
 
-After all 12 probes complete, merge results into `STATE.md <connections>`. Preserve the three-value schema verbatim (`available | unavailable | not_configured`). Do not add new values.
+After all 14 probes complete, merge results into `STATE.md <connections>`. Preserve the three-value schema verbatim (`available | unavailable | not_configured`). Do not add new values.
 
 ---
 
@@ -167,7 +181,7 @@ HAS_FIGMA_HINT=$( grep -r "figma\.com/file" -l . --include="*.md" 2>/dev/null |
 | `HAS_STORYBOOK_DIR` or storybook available | storybook, chromatic |
 | `HAS_PEN_FILES` | pencil-dev |
 | `HAS_REACT` | 21st-dev, magic-patterns |
-| Always | refero, preview |
+| Always | refero, preview, lazyweb (free — cost-aware default, D-01) |
 
 ---
 
@@ -212,6 +226,8 @@ One-line value props (use verbatim):
 | pencil-dev | `.pen` spec files as canonical design source |
 | 21st-dev | AI component generator (marketplace search) |
 | magic-patterns | AI component generator (DS-aware) |
+| lazyweb | free design reference search (pricing/onboarding/redesign) — discover Tier 1 |
+| mobbin | curated mobile + flow-level references (paid) — discover Tier 2 |
 
 ---
 
@@ -239,7 +255,7 @@ options:
   - "Exit"                            → emit ## CONNECTIONS COMPLETE, exit
 ```
 
-If recommended bucket is empty, swap that option for "Show all 12 and pick."
+If recommended bucket is empty, swap that option for "Show all 14 and pick."
 
 ---
 
@@ -296,6 +312,8 @@ options:
 | 21st-dev | `npx @21st-dev/magic init` + env var | ✗ no | Env var required — force manual |
 | pencil-dev | VS Code extension | ✗ no | IDE-level install — force manual |
 | claude-design | handoff bundle drop | ✗ no | User-driven file drop — force manual |
+| mobbin | `claude mcp add mobbin --transport http https://api.mobbin.com/mcp` | ✓ yes | Reversible MCP add; no credential filesystem-write (OAuth on first call) |
+| lazyweb | `claude plugin install lazyweb@lazyweb` (after token write to `~/.lazyweb/`) | ✗ no | Writes a bearer token to disk — force manual (user-consent step) |
 
 For non-auto-run connections, hide the "Run install command now" option entirely in 5.3.
 

package/skills/discover/discover-procedure.md

@@ -68,7 +68,25 @@ C2. Empty result  -> pinterest: not_configured
 
 No live `pinterest_search` call at probe time — ToolSearch presence is sufficient. The synthesizer makes the actual search calls.
 
-After all probes (A, B, C), update `.design/STATE.md` `<connections>` with the results and continue. Downstream stages (design-context-builder) read `<connections>` from STATE.md rather than re-probing.
+### D — Lazyweb probe (ToolSearch-only — free, discover Tier 1 per D-01)
+
+```
+D1. ToolSearch({ query: "lazyweb", max_results: 5 })
+D2. Empty result  -> lazyweb: not_configured
+    Non-empty     -> lazyweb: available
+```
+
+### E — Mobbin probe (ToolSearch-only — paid, discover Tier 2 per D-01)
+
+```
+E1. ToolSearch({ query: "mobbin", max_results: 5 })
+E2. Empty result  -> mobbin: not_configured
+    Non-empty     -> mobbin: available
+```
+
+**Reference-source tier order (cost-aware, D-01):** Lazyweb (free, tried first) → Mobbin / Refero (paid, whichever is bound + subscribed) → Pinterest → awesome-design-md → WebFetch.
+
+After all probes (A, B, C, D, E), update `.design/STATE.md` `<connections>` with the results and continue. Downstream stages (design-context-builder) read `<connections>` from STATE.md rather than re-probing.
 
 ---