opendevbrowser 0.0.16 → 0.0.18

package/skills/opendevbrowser-design-agent/assets/templates/canvas-generation-plan.design.v1.json

@@ -0,0 +1,58 @@
+{
+  "requestId": "req_plan_design_01",
+  "canvasSessionId": "<canvas-session-id>",
+  "leaseId": "<lease-id>",
+  "documentId": "<document-id>",
+  "generationPlan": {
+    "targetOutcome": {
+      "mode": "high-fi-live-edit",
+      "summary": "Clarify hierarchy, trust, and action flow"
+    },
+    "visualDirection": {
+      "profile": "product-led-clarity",
+      "styleAxes": {
+        "contrast": "high",
+        "density": "airy"
+      }
+    },
+    "layoutStrategy": {
+      "approach": "hero-led-grid"
+    },
+    "contentStrategy": {
+      "source": "real-content-first"
+    },
+    "componentStrategy": {
+      "mode": "reuse-first",
+      "approvedLibraries": [
+        "shadcn"
+      ]
+    },
+    "motionPosture": {
+      "level": "subtle",
+      "allow3D": false,
+      "allowParallax": false,
+      "allowCustomSmoothScroll": false
+    },
+    "responsivePosture": {
+      "primaryViewport": "desktop",
+      "requiredViewports": [
+        "desktop",
+        "tablet",
+        "mobile"
+      ]
+    },
+    "accessibilityPosture": {
+      "target": "WCAG_2_2_AA",
+      "reducedMotion": "required",
+      "keyboardParity": true
+    },
+    "validationTargets": {
+      "blockOn": [
+        "contrast-failure"
+      ],
+      "warnOn": [
+        "responsive-mismatch"
+      ]
+    }
+  }
+}

package/skills/opendevbrowser-design-agent/assets/templates/design-audit-report.v1.md

@@ -0,0 +1,34 @@
+# Design Audit Report
+
+## Context
+
+- Surface:
+- Goal:
+- Contract source:
+- Validation scope:
+
+## Findings
+
+| Severity | Issue | Evidence | Fix | Validation |
+| --- | --- | --- | --- | --- |
+|  |  |  |  |  |
+
+## Contract Alignment
+
+- Intent:
+- Design language:
+- Pattern family:
+- State ownership:
+- Responsive posture:
+- Accessibility posture:
+
+## Real-Surface Evidence
+
+- Isolated preview:
+- Browser session:
+- Screenshot paths:
+- Trace or profiler evidence:
+
+## Open Questions
+
+- UNCONFIRMED:

package/skills/opendevbrowser-design-agent/assets/templates/design-brief.v1.md

@@ -0,0 +1,40 @@
+# Design Brief
+
+## Goal
+
+- Product or feature:
+- Audience:
+- Primary task:
+- Success criteria:
+
+## Context
+
+- Existing surface:
+- Existing design system or constraints:
+- Relevant screenshots or references:
+- Technical stack:
+
+## Desired Direction
+
+- Visual direction:
+- Tone:
+- Interaction posture:
+- Motion posture:
+- Accessibility target:
+
+## Required States
+
+- Default:
+- Hover:
+- Focus:
+- Empty:
+- Loading:
+- Success:
+- Error:
+
+## Validation Plan
+
+- Required surfaces:
+- Required viewports:
+- Required browser checks:
+- Docs or AGENTS updates needed:

package/skills/opendevbrowser-design-agent/assets/templates/design-contract.v1.json

@@ -0,0 +1,226 @@
+{
+  "intent": {
+    "audience": "Operators evaluating a new OpenDevBrowser design flow",
+    "task": "Understand the primary page value and complete the intended action quickly",
+    "successCriteria": [
+      "Primary action is obvious within 5 seconds",
+      "Layout remains coherent on desktop, tablet, and mobile"
+    ],
+    "trustPosture": "clear and confident"
+  },
+  "designLanguage": {
+    "direction": "product-led clarity",
+    "styleAxes": {
+      "contrast": "high",
+      "density": "airy",
+      "shapeLanguage": "rounded-structured",
+      "depth": "subtle",
+      "texture": "minimal",
+      "motion": "purposeful"
+    },
+    "approvedLibraries": {
+      "components": [
+        "shadcn"
+      ],
+      "icons": [
+        "tabler"
+      ],
+      "styling": [
+        "tailwindcss"
+      ]
+    },
+    "semanticTokenSource": {
+      "owner": "app-shell theme provider",
+      "tokens": [
+        "color",
+        "typography",
+        "spacing",
+        "radius",
+        "shadow",
+        "motion"
+      ],
+      "rule": "Use semantic tokens in repeated UI; reserve raw values for rare one-off illustration"
+    }
+  },
+  "contentModel": {
+    "primaryMessage": "Show the core value immediately with real copy",
+    "supportingMessages": [
+      "Reinforce trust",
+      "Clarify the primary action",
+      "Reduce ambiguity"
+    ],
+    "realContentRequired": true,
+    "states": [
+      "default",
+      "hover",
+      "focus",
+      "empty",
+      "loading",
+      "success",
+      "error"
+    ],
+    "loadingStrategy": "Preserve the final layout with 3-6 placeholders or one section-level loader when structure cannot be previewed",
+    "emptyStateStrategy": "Explain why nothing is shown and provide the next useful action",
+    "errorStateStrategy": "Keep retry or recovery actions close to the failed region",
+    "transientFeedbackStrategy": "Use short, non-blocking overlays for confirmations instead of reflowing the main layout",
+    "avoidPlaceholderCopy": true
+  },
+  "navigationModel": {
+    "owner": "feature shell route controller",
+    "primaryRouteModel": "One canonical route map translates tabs, selected records, and editor modes into URL-backed state",
+    "deepLinkPolicy": "Shareable tabs, filters, sort, and selected entities stay in the URL with a safe fallback when params are stale or incomplete",
+    "invalidRouteFallback": "Recover to the closest safe baseline view instead of leaving the screen in a partially initialized state",
+    "overlayEntryPoints": [
+      "route-owned detail drawer",
+      "feature-owned confirmation modal"
+    ]
+  },
+  "asyncModel": {
+    "owner": "feature-local controller with URL-owned query state when sharing or refresh matters",
+    "loadTrigger": "load-on-enter for the first view; debounced restart on query, scope, or sort change",
+    "restartTriggers": [
+      "query",
+      "scope",
+      "sort"
+    ],
+    "debounceMs": 250,
+    "emptyQueryBehavior": "Reset to the baseline or empty state without a remote fetch unless the product explicitly needs default results",
+    "cancellationPolicy": "Treat stale requests as normal and do not surface cancellation as a user-facing error",
+    "moveToServiceWhen": [
+      "work must survive dismissal",
+      "caching or retry policy becomes shared",
+      "multiple screens depend on the same in-flight state"
+    ],
+    "urlOwnership": "Put query, filter, and sort in the URL when the state should survive refresh, sharing, or handoff"
+  },
+  "layoutSystem": {
+    "grid": "12-column responsive grid",
+    "containers": "max-width sections with asymmetric emphasis",
+    "spacingRhythm": "8px base with larger section jumps",
+    "alignmentRules": [
+      "Primary content aligns to a consistent reading column",
+      "Actions stay near the message they complete"
+    ]
+  },
+  "typographySystem": {
+    "families": [
+      "Space Grotesk",
+      "Source Sans 3"
+    ],
+    "scale": [
+      "12",
+      "14",
+      "16",
+      "20",
+      "28",
+      "40",
+      "56"
+    ],
+    "measure": "60-72 characters for dense reading blocks",
+    "fallbackPolicy": "Use repo-native or licensed alternatives when these families are unavailable",
+    "loadingStrategy": "Avoid layout shift and keep fallback metrics close"
+  },
+  "motionSystem": {
+    "timing": "short and decisive",
+    "reducedMotionPolicy": "Preserve meaning with reduced movement",
+    "interactionMoments": [
+      "page entry",
+      "section reveal",
+      "primary CTA feedback"
+    ],
+    "parallaxPolicy": "off unless explicitly justified"
+  },
+  "performanceModel": {
+    "renderHotspots": [
+      "scan-heavy collection region",
+      "secondary inspector or preview pane"
+    ],
+    "stableIdentityPolicy": "Rows, cards, tabs, and overlays use stable domain ids instead of array indexes",
+    "listStrategy": "Use the smallest structure that stays fast with realistic data; choose progressive reveal, lazy containers, or virtualization deliberately",
+    "secondaryPanelPolicy": "Heavy inspectors, previews, and editors load on demand when they are not required for first paint",
+    "measurementPlan": "Validate realistic data volume with browser traces and the framework profiler before claiming the surface is performant"
+  },
+  "responsiveSystem": {
+    "breakpoints": [
+      "mobile",
+      "tablet",
+      "desktop"
+    ],
+    "adaptationRules": [
+      "Collapse multicolumn sections before copy becomes cramped",
+      "Preserve primary CTA prominence on the smallest viewport"
+    ],
+    "touchPolicy": "Comfortable targets and low-friction scroll paths",
+    "overflowPolicy": "No horizontal scroll for primary content"
+  },
+  "accessibilityPolicy": {
+    "target": "WCAG 2.2 AA",
+    "keyboardRequirements": [
+      "Visible focus",
+      "Logical tab order"
+    ],
+    "focusPolicy": "Focus rings must remain visible against every background",
+    "semanticRequirements": [
+      "Landmarks are explicit",
+      "Headings remain hierarchical"
+    ]
+  },
+  "generationPlan": {
+    "targetOutcome": {
+      "mode": "high-fi-live-edit",
+      "summary": "Improve hierarchy, clarity, and conversion confidence"
+    },
+    "visualDirection": {
+      "profile": "product-led-clarity",
+      "styleAxes": {
+        "contrast": "high",
+        "density": "airy"
+      }
+    },
+    "layoutStrategy": {
+      "approach": "hero-led-grid"
+    },
+    "contentStrategy": {
+      "source": "real-content-first"
+    },
+    "componentStrategy": {
+      "mode": "reuse-first",
+      "approvedLibraries": [
+        "shadcn"
+      ]
+    },
+    "motionPosture": {
+      "level": "subtle",
+      "allow3D": false,
+      "allowParallax": false,
+      "allowCustomSmoothScroll": false
+    },
+    "responsivePosture": {
+      "primaryViewport": "desktop",
+      "requiredViewports": [
+        "desktop",
+        "tablet",
+        "mobile"
+      ]
+    },
+    "accessibilityPosture": {
+      "target": "WCAG_2_2_AA",
+      "reducedMotion": "required",
+      "keyboardParity": true
+    },
+    "validationTargets": {
+      "blockOn": [
+        "contrast-failure",
+        "keyboard-regression",
+        "stale-search-results",
+        "invalid-route-recovery-failure"
+      ],
+      "warnOn": [
+        "responsive-mismatch",
+        "layout-shift",
+        "spinner-stacking",
+        "scan-surface-jank"
+      ]
+    }
+  }
+}

package/skills/opendevbrowser-design-agent/assets/templates/design-release-gate.v1.json

@@ -0,0 +1,35 @@
+{
+  "surfaceId": "surface-001",
+  "decision": "blocked",
+  "contractAligned": false,
+  "patternBoardReviewed": false,
+  "browserEvidence": [],
+  "requiredChecks": [
+    {
+      "id": "design-contract",
+      "status": "blocked",
+      "evidence": ""
+    },
+    {
+      "id": "real-surface-validation",
+      "status": "blocked",
+      "evidence": ""
+    },
+    {
+      "id": "responsive-behavior",
+      "status": "blocked",
+      "evidence": ""
+    },
+    {
+      "id": "accessibility-review",
+      "status": "blocked",
+      "evidence": ""
+    },
+    {
+      "id": "docs-and-agents-sync",
+      "status": "blocked",
+      "evidence": ""
+    }
+  ],
+  "followUps": []
+}

package/skills/opendevbrowser-design-agent/assets/templates/design-review-checklist.json

@@ -0,0 +1,57 @@
+{
+  "requiredStates": [
+    "default",
+    "hover",
+    "focus",
+    "empty",
+    "loading",
+    "success",
+    "error"
+  ],
+  "mustPass": [
+    "design-contract-aligned",
+    "pattern-family-declared",
+    "nearest-surface-reviewed",
+    "shell-ownership-clear",
+    "navigation-ownership-clear",
+    "clear-primary-action",
+    "state-ownership-clear",
+    "async-ownership-clear",
+    "semantic-token-source-clear",
+    "loading-feedback-plan-declared",
+    "scan-surface-performance-plan-clear",
+    "isolated-preview-validated",
+    "preview-dependencies-deterministic",
+    "responsive-intentional",
+    "accessible-focus-visible",
+    "real-browser-validated"
+  ],
+  "scoredCategories": [
+    "clarity",
+    "visual_direction",
+    "component_discipline",
+    "state_coverage",
+    "responsiveness",
+    "accessibility",
+    "performance_and_restraint"
+  ],
+  "failureTriggers": [
+    "boolean-sprawl",
+    "mixed-state-ownership",
+    "shell-ownership-unclear",
+    "stringly-routed-actions",
+    "existing-surface-ignored",
+    "unbounded-search-restarts",
+    "unstable-list-identity",
+    "scroll-driver-unclear",
+    "spinner-stacking",
+    "raw-token-sprawl",
+    "placeholder-dependent",
+    "live-service-preview",
+    "no-isolated-fixture",
+    "mobile-untested",
+    "keyboard-untested",
+    "contract-drift",
+    "no-browser-proof"
+  ]
+}

package/skills/opendevbrowser-design-agent/assets/templates/real-surface-design-matrix.json

@@ -0,0 +1,32 @@
+{
+  "surfaces": [
+    "managed",
+    "extension",
+    "cdpConnect"
+  ],
+  "designTasks": [
+    {
+      "id": "canvas-hero-refine",
+      "goal": "Refine a live canvas document and validate preview fidelity"
+    },
+    {
+      "id": "page-ui-audit",
+      "goal": "Review a real page for hierarchy, states, and accessibility"
+    },
+    {
+      "id": "responsive-proof",
+      "goal": "Prove the design works at mobile, tablet, and desktop widths"
+    }
+  ],
+  "evidence": [
+    "snapshot",
+    "screenshot",
+    "debug-trace-snapshot",
+    "feedback-poll"
+  ],
+  "blockers": [
+    "restricted-origin",
+    "extension-not-ready",
+    "missing-runtime-proof"
+  ]
+}

package/skills/opendevbrowser-design-agent/assets/templates/reference-pattern-board.v1.json

@@ -0,0 +1,31 @@
+{
+  "briefId": "design-brief-001",
+  "targetSurface": "canvas-marketing-landing",
+  "references": [
+    {
+      "id": "ref-001",
+      "name": "Example product page",
+      "url": "https://example.com",
+      "surfaceType": "marketing",
+      "capturedVia": [
+        "snapshot",
+        "screenshot"
+      ],
+      "layoutRecipe": "",
+      "contentHierarchy": [],
+      "componentFamilies": [],
+      "motionPosture": "",
+      "loadingStrategy": "",
+      "tokenNotes": [],
+      "patternsToBorrow": [],
+      "patternsToReject": [],
+      "whyItWorks": ""
+    }
+  ],
+  "synthesis": {
+    "dominantDirection": "",
+    "sharedStrengths": [],
+    "sharedFailuresToAvoid": [],
+    "contractDeltas": []
+  }
+}

package/skills/opendevbrowser-design-agent/scripts/design-workflow.sh

@@ -0,0 +1,171 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=../../opendevbrowser-best-practices/scripts/resolve-odb-cli.sh
+source "$script_dir/../../opendevbrowser-best-practices/scripts/resolve-odb-cli.sh"
+
+render_cli_prefix() {
+  local rendered=()
+  local part
+  for part in "${ODB_CLI[@]}"; do
+    rendered+=("$(printf '%q' "$part")")
+  done
+  printf '%s' "${rendered[*]}"
+}
+
+CLI_PREFIX="$(render_cli_prefix)"
+
+print_help() {
+  cat <<'EOF'
+OpenDevBrowser design-agent workflow router
+
+Usage:
+  ./skills/opendevbrowser-design-agent/scripts/design-workflow.sh <workflow>
+
+Workflows:
+  contract-first
+  research-harvest
+  screenshot-audit
+  canvas-contract
+  real-surface-validation
+  performance-audit
+  release-gate
+  ship-audit
+  list
+EOF
+}
+
+workflow="${1:-list}"
+
+case "$workflow" in
+  list)
+    print_help
+    ;;
+  contract-first)
+    cat <<'EOF'
+cat skills/opendevbrowser-design-agent/assets/templates/design-brief.v1.md
+cat skills/opendevbrowser-design-agent/assets/templates/design-contract.v1.json
+cat skills/opendevbrowser-design-agent/artifacts/design-contract-playbook.md
+cat skills/opendevbrowser-design-agent/artifacts/opendevbrowser-ui-example-map.md
+cat skills/opendevbrowser-design-agent/artifacts/existing-surface-adaptation.md
+cat skills/opendevbrowser-design-agent/artifacts/component-pattern-index.md
+cat skills/opendevbrowser-design-agent/artifacts/app-shell-and-state-wiring.md
+cat skills/opendevbrowser-design-agent/artifacts/state-ownership-matrix.md
+cat skills/opendevbrowser-design-agent/artifacts/async-search-state-ownership.md
+cat skills/opendevbrowser-design-agent/artifacts/scroll-reveal-surface-planning.md
+cat skills/opendevbrowser-design-agent/artifacts/theming-and-token-ownership.md
+cat skills/opendevbrowser-design-agent/artifacts/loading-and-feedback-surfaces.md
+cat skills/opendevbrowser-design-agent/artifacts/frontend-evaluation-rubric.md
+# Fill the brief first, then turn it into the design contract before implementation.
+EOF
+    ;;
+  research-harvest)
+    cat <<EOF
+cat skills/opendevbrowser-design-agent/artifacts/research-harvest-workflow.md
+cat skills/opendevbrowser-design-agent/assets/templates/reference-pattern-board.v1.json
+cat skills/opendevbrowser-design-agent/artifacts/external-pattern-synthesis.md
+cat skills/opendevbrowser-design-agent/artifacts/component-pattern-index.md
+cat skills/opendevbrowser-design-agent/artifacts/existing-surface-adaptation.md
+$CLI_PREFIX launch --no-extension --start-url https://example.com
+$CLI_PREFIX goto --session-id <session-id> --url <reference-url>
+$CLI_PREFIX snapshot --session-id <session-id>
+$CLI_PREFIX screenshot --session-id <session-id>
+$CLI_PREFIX debug-trace-snapshot --session-id <session-id>
+# Repeat for 3-5 live references, then turn the synthesis into contract deltas before implementation.
+EOF
+    ;;
+  screenshot-audit)
+    cat <<'EOF'
+cat skills/opendevbrowser-design-agent/artifacts/design-workflows.md
+cat skills/opendevbrowser-design-agent/artifacts/component-pattern-index.md
+cat skills/opendevbrowser-design-agent/artifacts/opendevbrowser-ui-example-map.md
+cat skills/opendevbrowser-design-agent/artifacts/existing-surface-adaptation.md
+cat skills/opendevbrowser-design-agent/artifacts/async-search-state-ownership.md
+cat skills/opendevbrowser-design-agent/artifacts/scroll-reveal-surface-planning.md
+cat skills/opendevbrowser-design-agent/artifacts/theming-and-token-ownership.md
+cat skills/opendevbrowser-design-agent/artifacts/loading-and-feedback-surfaces.md
+cat skills/opendevbrowser-design-agent/artifacts/implementation-anti-patterns.md
+cat skills/opendevbrowser-design-agent/artifacts/frontend-evaluation-rubric.md
+cat skills/opendevbrowser-design-agent/assets/templates/design-audit-report.v1.md
+cat skills/opendevbrowser-design-agent/assets/templates/design-review-checklist.json
+# Decompose the screenshot into hierarchy, grid, spacing, type, states, and accessibility before coding.
+EOF
+    ;;
+  canvas-contract)
+    cat <<EOF
+cat skills/opendevbrowser-design-agent/assets/templates/design-contract.v1.json
+cat skills/opendevbrowser-design-agent/assets/templates/canvas-generation-plan.design.v1.json
+cat skills/opendevbrowser-design-agent/artifacts/design-contract-playbook.md
+./skills/opendevbrowser-design-agent/scripts/extract-canvas-plan.sh ./tmp/design-contract.json > ./tmp/canvas-plan.json
+$CLI_PREFIX canvas --command canvas.session.open --params '{"requestId":"req_open_01","browserSessionId":"<browser-session-id>","documentId":null,"repoPath":null,"mode":"dual-track"}'
+$CLI_PREFIX canvas --command canvas.plan.set --params-file ./tmp/canvas-plan.json
+$CLI_PREFIX canvas --command canvas.feedback.poll --params '{"requestId":"req_feedback_01","canvasSessionId":"<canvas-session-id>","documentId":"<document-id>","targetId":"<target-id>","afterCursor":null}'
+EOF
+    ;;
+  real-surface-validation)
+    cat <<EOF
+cat skills/opendevbrowser-design-agent/assets/templates/real-surface-design-matrix.json
+cat skills/opendevbrowser-design-agent/assets/templates/design-review-checklist.json
+cat skills/opendevbrowser-design-agent/artifacts/isolated-preview-validation.md
+cat skills/opendevbrowser-design-agent/artifacts/scroll-reveal-surface-planning.md
+cat skills/opendevbrowser-design-agent/artifacts/loading-and-feedback-surfaces.md
+cat skills/opendevbrowser-design-agent/artifacts/theming-and-token-ownership.md
+$CLI_PREFIX launch --no-extension --start-url https://example.com
+$CLI_PREFIX snapshot --session-id <session-id>
+$CLI_PREFIX screenshot --session-id <session-id>
+$CLI_PREFIX debug-trace-snapshot --session-id <session-id>
+# Repeat on extension and cdpConnect when parity is part of the acceptance criteria.
+EOF
+    ;;
+  performance-audit)
+    cat <<EOF
+cat skills/opendevbrowser-design-agent/artifacts/performance-audit-playbook.md
+cat skills/opendevbrowser-design-agent/artifacts/scroll-reveal-surface-planning.md
+cat skills/opendevbrowser-design-agent/artifacts/implementation-anti-patterns.md
+cat skills/opendevbrowser-design-agent/assets/templates/design-audit-report.v1.md
+$CLI_PREFIX launch --no-extension --start-url http://127.0.0.1:3000
+$CLI_PREFIX debug-trace-snapshot --session-id <session-id>
+$CLI_PREFIX screenshot --session-id <session-id>
+# Pair the browser evidence with React DevTools Profiler or the framework profiler before changing structure.
+EOF
+    ;;
+  release-gate)
+    cat <<'EOF'
+./skills/opendevbrowser-design-agent/scripts/validate-skill-assets.sh
+cat skills/opendevbrowser-design-agent/artifacts/design-release-gate.md
+cat skills/opendevbrowser-design-agent/assets/templates/design-release-gate.v1.json
+cat skills/opendevbrowser-design-agent/assets/templates/design-review-checklist.json
+cat skills/opendevbrowser-design-agent/assets/templates/real-surface-design-matrix.json
+cat skills/opendevbrowser-design-agent/assets/templates/reference-pattern-board.v1.json
+# Re-run the required browser matrix and mark every blocking check pass/fail with evidence before shipping.
+EOF
+    ;;
+  ship-audit)
+    cat <<'EOF'
+./skills/opendevbrowser-design-agent/scripts/validate-skill-assets.sh
+./skills/opendevbrowser-best-practices/scripts/validate-skill-assets.sh
+cat skills/opendevbrowser-design-agent/artifacts/frontend-evaluation-rubric.md
+cat skills/opendevbrowser-design-agent/artifacts/existing-surface-adaptation.md
+cat skills/opendevbrowser-design-agent/artifacts/app-shell-and-state-wiring.md
+cat skills/opendevbrowser-design-agent/artifacts/state-ownership-matrix.md
+cat skills/opendevbrowser-design-agent/artifacts/async-search-state-ownership.md
+cat skills/opendevbrowser-design-agent/artifacts/scroll-reveal-surface-planning.md
+cat skills/opendevbrowser-design-agent/artifacts/theming-and-token-ownership.md
+cat skills/opendevbrowser-design-agent/artifacts/loading-and-feedback-surfaces.md
+cat skills/opendevbrowser-design-agent/artifacts/research-harvest-workflow.md
+cat skills/opendevbrowser-design-agent/artifacts/design-release-gate.md
+cat skills/opendevbrowser-design-agent/artifacts/implementation-anti-patterns.md
+cat skills/opendevbrowser-design-agent/assets/templates/design-audit-report.v1.md
+cat skills/opendevbrowser-design-agent/assets/templates/design-review-checklist.json
+cat skills/opendevbrowser-design-agent/assets/templates/reference-pattern-board.v1.json
+cat skills/opendevbrowser-design-agent/assets/templates/design-release-gate.v1.json
+# Re-read the design contract, compare it to the shipped UI, then update docs/AGENTS/skills references in the same pass.
+EOF
+    ;;
+  *)
+    echo "Unknown workflow: $workflow" >&2
+    print_help
+    exit 2
+    ;;
+esac