@appsforgood/next-supabase-kit 0.1.5 → 0.1.6

package/dist/studio/wizard/assets/wizard.js

@@ -92,8 +92,7 @@
     els.ringPct.textContent = pct + "%";
     els.ring.style.setProperty("--pct", String(pct));
     if (els.levelPill && state.agenticLevel) {
-      els.levelPill.textContent =
-        "L" + state.agenticLevel.currentLevel + " → L" + state.agenticLevel.targetLevel;
+      els.levelPill.textContent = "L" + state.agenticLevel.currentLevel + " → L" + state.agenticLevel.targetLevel;
       els.levelPill.hidden = false;
     }
     render();
@@ -137,10 +136,8 @@
     const sections = state.progress?.sections || [];
     els.sectionNav.innerHTML = sections
       .map((s) => {
-        const chipClass =
-          s.status === "done" ? "done" : s.status === "in_progress" ? "progress" : s.status === "optional" ? "optional" : "";
-        const chipLabel =
-          s.status === "done" ? "Done" : s.status === "in_progress" ? "Now" : s.status === "optional" ? "Optional" : "—";
+        const chipClass = s.status === "done" ? "done" : s.status === "in_progress" ? "progress" : s.status === "optional" ? "optional" : "";
+        const chipLabel = s.status === "done" ? "Done" : s.status === "in_progress" ? "Now" : s.status === "optional" ? "Optional" : "—";
         return (
           '<li><button type="button" data-section="' +
           s.id +
@@ -171,14 +168,7 @@
 
   function renderTeamIntro() {
     const cards = state.agents
-      .map(
-        (a) =>
-          '<li class="agent-card"><strong>' +
-          escapeHtml(a.name) +
-          "</strong><p>" +
-          escapeHtml(a.roleSummary) +
-          "</p></li>"
-      )
+      .map((a) => '<li class="agent-card"><strong>' + escapeHtml(a.name) + "</strong><p>" + escapeHtml(a.roleSummary) + "</p></li>")
       .join("");
     return (
       '<p class="why">Next you will brief each specialist — one step per agent. Skip any you are not ready to answer; you can return later.</p>' +
@@ -211,9 +201,7 @@
   }
 
   function renderHome() {
-    const pills = (boot.stackSignals || [])
-      .map((s) => '<span class="pill">' + escapeHtml(s) + "</span>")
-      .join("");
+    const pills = (boot.stackSignals || []).map((s) => '<span class="pill">' + escapeHtml(s) + "</span>").join("");
     const agentCount = state.agents.length || boot.agents?.length || 0;
     const officePromo =
       '<div class="office-promo">' +
@@ -243,9 +231,7 @@
       depthCard("complete", "Complete (~25 min)", "Standard plus DESIGN and MESSAGING intake drafts.") +
       "</div>" +
       (state.progress?.recommendedNext
-        ? '<p class="why" style="margin-top:18px">Continue: <strong>' +
-          escapeHtml(state.progress.recommendedNext) +
-          "</strong></p>"
+        ? '<p class="why" style="margin-top:18px">Continue: <strong>' + escapeHtml(state.progress.recommendedNext) + "</strong></p>"
         : "")
     );
   }
@@ -259,8 +245,8 @@
       level.currentLevel +
       " → target L" +
       level.targetLevel +
-      " <span class=\"hint-inline\">(setup progress is separate from audit readiness and visual QA tiers)</span></p>" +
-      (level.maintainerNote ? "<p class=\"hint\">" + escapeHtml(level.maintainerNote) + "</p>" : "") +
+      ' <span class="hint-inline">(setup progress is separate from audit readiness and visual QA tiers)</span></p>' +
+      (level.maintainerNote ? '<p class="hint">' + escapeHtml(level.maintainerNote) + "</p>" : "") +
       "</div>"
     );
   }
@@ -284,9 +270,9 @@
     const val = escapeHtml(state.form[name] || "");
     if (type === "textarea") {
       return (
-        "<label for=\"" +
+        '<label for="' +
         name +
-        "\">" +
+        '">' +
         escapeHtml(label) +
         (hint ? "<span>" + escapeHtml(hint) + "</span>" : "") +
         '</label><textarea id="' +
@@ -303,9 +289,9 @@
       );
     }
     return (
-      "<label for=\"" +
+      '<label for="' +
       name +
-      "\">" +
+      '">' +
       escapeHtml(label) +
       (hint ? "<span>" + escapeHtml(hint) + "</span>" : "") +
       '</label><input id="' +
@@ -334,25 +320,11 @@
         ),
       productCategory: () => {
         const opts = (boot.categories || [])
-          .map(
-            (c) =>
-              '<option value="' +
-              c +
-              '"' +
-              (state.form.productCategory === c ? " selected" : "") +
-              ">" +
-              c +
-              "</option>"
-          )
+          .map((c) => '<option value="' + c + '"' + (state.form.productCategory === c ? " selected" : "") + ">" + c + "</option>")
           .join("");
-        return (
-          '<label for="productCategory">Category</label><select id="productCategory" name="productCategory">' +
-          opts +
-          "</select>"
-        );
+        return '<label for="productCategory">Category</label><select id="productCategory" name="productCategory">' + opts + "</select>";
       },
-      primaryAudience: () =>
-        inputField("primaryAudience", "Primary user or buyer", "", "text", "Who uses or pays for this product?"),
+      primaryAudience: () => inputField("primaryAudience", "Primary user or buyer", "", "text", "Who uses or pays for this product?"),
       primaryWorkflows: () =>
         inputField(
           "primaryWorkflows",
@@ -363,16 +335,7 @@
         ),
       tenantModel: () => {
         const opts = (boot.tenantModels || [])
-          .map(
-            (c) =>
-              '<option value="' +
-              c +
-              '"' +
-              (state.form.tenantModel === c ? " selected" : "") +
-              ">" +
-              c +
-              "</option>"
-          )
+          .map((c) => '<option value="' + c + '"' + (state.form.tenantModel === c ? " selected" : "") + ">" + c + "</option>")
           .join("");
         return '<label for="tenantModel">Who uses the system?</label><select id="tenantModel" name="tenantModel">' + opts + "</select>";
       },
@@ -388,12 +351,9 @@
           "textarea",
           "Describe auth boundaries agents must not break."
         ),
-      uiPreferred: () =>
-        inputField("uiPreferred", "UI should feel like…", "", "textarea", "Task-first, clear hierarchy, readable typography."),
-      uiAvoid: () =>
-        inputField("uiAvoid", "UI should avoid…", "Optional.", "textarea", "Generic SaaS heroes, card soup, fake metrics."),
-      valueProposition: () =>
-        inputField("valueProposition", "Value proposition", "", "textarea", "What outcome do users get?"),
+      uiPreferred: () => inputField("uiPreferred", "UI should feel like…", "", "textarea", "Task-first, clear hierarchy, readable typography."),
+      uiAvoid: () => inputField("uiAvoid", "UI should avoid…", "Optional.", "textarea", "Generic SaaS heroes, card soup, fake metrics."),
+      valueProposition: () => inputField("valueProposition", "Value proposition", "", "textarea", "What outcome do users get?"),
       proof: () => inputField("proof", "Proof points", "One per line. Real evidence only.", "textarea", ""),
       objections: () => inputField("objections", "Objections", "One per line. Optional.", "textarea", ""),
       qualityTarget: () => {
@@ -410,16 +370,7 @@
       },
       ideSurface: () => {
         const opts = state.ideSurfaces
-          .map(
-            (s) =>
-              '<option value="' +
-              s.id +
-              '"' +
-              (state.form.ideSurface === s.id ? " selected" : "") +
-              ">" +
-              escapeHtml(s.label) +
-              "</option>"
-          )
+          .map((s) => '<option value="' + s.id + '"' + (state.form.ideSurface === s.id ? " selected" : "") + ">" + escapeHtml(s.label) + "</option>")
           .join("");
         const chip = renderAdapterChip(state.lastAdapterValidation);
         return (
@@ -494,15 +445,7 @@
         : validation.warn > 0
           ? "Adapter validate: pass with warnings"
           : "Adapter validate: pass";
-    return (
-      '<p class="adapter-chip ' +
-      kind +
-      '" role="status">' +
-      escapeHtml(label) +
-      " (" +
-      escapeHtml(validation.target) +
-      ")</p>"
-    );
+    return '<p class="adapter-chip ' + kind + '" role="status">' + escapeHtml(label) + " (" + escapeHtml(validation.target) + ")</p>";
   }
 
   function renderComplete() {
@@ -513,13 +456,7 @@
       .join("");
     return (
       '<div class="complete-icon" aria-hidden="true">✓</div><h2>Setup saved</h2>' +
-      (level
-        ? '<p class="why">Agentic level <strong>L' +
-          level.currentLevel +
-          "</strong> (target L" +
-          level.targetLevel +
-          ").</p>"
-        : "") +
+      (level ? '<p class="why">Agentic level <strong>L' + level.currentLevel + "</strong> (target L" + level.targetLevel + ").</p>" : "") +
       '<p class="why">Agents read <code>.agent-kit/project-context.md</code> and <code>.agent-kit/agent-briefs.md</code> before meaningful work.</p>' +
       '<ol class="next-steps">' +
       "<li>Run eval loop from <code>LOOP_CODING.md</code>: <code>npm test</code>, <code>agent-kit audit --min-readiness baseline-setup</code></li>" +

package/examples/next-supabase-installed/.agent-kit/agent-roster.json

@@ -70,6 +70,7 @@
         "frontend-distinctiveness-benchmark",
         "frontend-product-quality-rubric",
         "frontend-design-system",
+        "ui-improvement-harness",
         "visual-regression-qa",
         "accessibility-wcag"
       ],
@@ -171,7 +172,7 @@
     },
     {
       "id": "frontend-change",
-      "triggers": ["screen", "component", "layout", "design", "responsive", "accessibility", "screenshot"],
+      "triggers": ["screen", "component", "layout", "design", "responsive", "accessibility", "screenshot", "ui audit", "ui polish", "browser qa"],
       "sequence": ["planner", "frontend-design-lead", "marketing-copy-lead", "nextjs-engineer", "qa-engineer", "docs-maintainer"],
       "council": ["frontend-design-lead", "marketing-copy-lead", "qa-engineer"],
       "requiredOutputs": [
@@ -183,10 +184,13 @@
         "design critique verdict",
         "frontend product-quality scorecard",
         "domain-specific UI rationale",
+        "UI detector findings and severity",
+        "UI command workflow applied when polishing or auditing",
         "visual QA evidence",
         "state coverage",
         "accessibility checks",
-        "desktop/mobile verification"
+        "desktop/mobile verification",
+        "authenticated screen evidence when applicable"
       ]
     },
     {
@@ -219,7 +223,7 @@
     "Meaningful multi-agent work must record council-session evidence in COUNCIL.md or a structured record that follows .agent-kit/schemas/council-session.schema.json.",
     "Planner starts planning and ambiguous requests by default.",
     "Lead Architect must review core changes before implementation.",
-    "Frontend Design Lead must record reference-set evidence, anti-references, a design critique verdict, a distinctiveness benchmark, and a frontend product-quality scorecard before accepting significant frontend work.",
+    "Frontend Design Lead must record reference-set evidence, anti-references, a design critique verdict, a distinctiveness benchmark, a frontend product-quality scorecard, UI detector severity findings, and desktop/mobile screenshot evidence before accepting significant frontend work.",
     "Marketing Copy Lead must ask discovery questions and record audience, pain, outcome, value proposition, proof, objections, voice/tone, and conversion goal before accepting public-facing or conversion-facing copy.",
     "Security Reviewer must review auth, data mutation, external-call, dependency, secret, and release-risk changes.",
     "QA Engineer must verify behavior changes before completion.",

package/examples/next-supabase-installed/.agent-kit/manifest.json

@@ -1,6 +1,6 @@
 {
   "packageName": "@appsforgood/next-supabase-kit",
-  "packageVersion": "0.1.5",
+  "packageVersion": "0.1.6",
   "stack": "next-supabase",
   "installedAt": "2026-06-17T11:49:38.732Z",
   "docs": [
@@ -40,20 +40,20 @@
   "modelRouting": ".agent-kit/model-routing.json",
   "templateHashes": {
     "AGENTS.md": "c7f3e7360938a1ed804d2110e9af96e6f09d50c49138063bef0db1642ddaf84f",
-    "AGENT_ROSTER.md": "fb88198d0a5f911ec8cbaa2850c1a47e1dbd1fe2c8144f9ce633bbfc1ec414d3",
-    "ASSISTANT_ADAPTERS.md": "b5fb02dbab39bab1af5122050cb86acbc726e24226e7024a3b984d5fdc12f798",
+    "AGENT_ROSTER.md": "40147eecf3977bf64431204b67f24eb277a834ba5b6f894c053c79c0a9dbb8f5",
+    "ASSISTANT_ADAPTERS.md": "4d37ba6555814cf18c6ac2a302a614af07bb33b0ac0eb5f19886c3af3328cb63",
     "COUNCIL.md": "40bec9051664c9c38b8360ee16f21b5e4716030d19c493cdec67395ab06528e1",
-    "SKILLS.md": "3c3c2eb40438a42026479dccac7bbf084ba22e2d758c425dff59385d05eae3bd",
-    "SPEC.md": "bb0406a141338b630a82026e4a2bb37f38448b3641d3b3ada62d146711a4fbfe",
-    "DECISIONS.md": "0c08d1106a40f829b197d552d0397c9bcd9af7e168a55c47ff5be033c6035ec6",
-    "DOCS.md": "da6a9006daf78bf410051153fe2838417b7f46459904582c2259ec1dba4bd29f",
-    "DESIGN.md": "70f52e539073e7c4c1d37e63c9a21672a3221d2931d3ff284058dabf60243530",
+    "SKILLS.md": "320b76f37e8b509d597ba01331d3b1a4dc4f1eb68b6d2294ba4125fb2ab02970",
+    "SPEC.md": "30dca40819d3d204cfcb33f016e67d0d9008d0fad0907db9c93f6d32e50e057a",
+    "DECISIONS.md": "1374d33cc40a9f3086f57c1af885c3e4defaa67df5116168cf4872d2ae8a3628",
+    "DOCS.md": "c9501b68bfa97788579ddaaa4b072ca7a7c80a5890e6ec10c05901694fcdae48",
+    "DESIGN.md": "e464ff8d9a8e542d00a04143a51417752dc98e1afcfa7e2a5549ecfbb47a479b",
     "MESSAGING.md": "f1f7c0f11796820b60bb44e42a65749763f7167944ba6acf092a1cf7b59e50de",
     "MODEL_ROUTING.md": "f0ca3bd12872cd5f61ff4c6bef670249c0a0188f20c049cb0d09d84219b1839c",
-    "QUALITY_GATES.md": "df9a39ad301394f7f58bc3dd5bf52f9fafeefffdc240fb7ae6a9b6a74b8da0b5",
-    "STYLE_GUIDE.md": "dcaed2d7885e920060d74e4ba5a8d548a08a729a3efc178434a17b5a182fb628",
+    "QUALITY_GATES.md": "15f260c75d6180d1e583917e367ab522030e878f1a6e93ba5f18eba17fef4bb2",
+    "STYLE_GUIDE.md": "0fcb8e04ed3d31fa560a0165588ad56efd262463ca0f3aa26633fba955daf0db",
     "SECURITY.md": "f046e4dc794f49700ddee4cb866e2ba1983a1b71268f2e244892d615b41714f8",
-    "TESTING.md": "2889421a1a66d5a6d910e9896a7f21fe4041aa2f6c0f52c92bac8505b66ba06a",
+    "TESTING.md": "59a82645445c3af0c9ccc26a9ed5154c1f710b202d3d13ffa9558a0b1d8a96de",
     "LOOP_CODING.md": "3d4719c7fc7c2e8465ee15aec27574adbbc5207d58123ecf4f88f3942c522812",
     "DEPLOYMENT.md": "c33d949c2b1850f8ee6c38e5ec565325c3d47f4daac13b81c75e1b35655ea174",
     "UPGRADE.md": "d4678475458744dee7c1f23b69c04e3cf82d9e896196e62455585aaae5d3a25a"

package/examples/next-supabase-installed/audit-output.json

@@ -1,6 +1,6 @@
 {
   "summary": {
-    "pass": 65,
+    "pass": 66,
     "warn": 5,
     "fail": 0
   },
@@ -19,7 +19,7 @@
     {
       "level": "pass",
       "area": "install",
-      "message": "Agent kit installed at version 0.1.5."
+      "message": "Agent kit installed at version 0.1.6."
     },
     {
       "level": "pass",
@@ -366,6 +366,11 @@
       "message": "No package.json found to verify test scripts.",
       "remediation": "Add package.json with test, lint, and build scripts appropriate to the stack."
     },
+    {
+      "level": "pass",
+      "area": "project-reality",
+      "message": "No obvious committed secret patterns detected in tracked source files."
+    },
     {
       "level": "pass",
       "area": "project-reality",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appsforgood/next-supabase-kit",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Open agent council, skills, prompts, checklists, and markdown templates for Next.js and Supabase projects.",
   "type": "module",
   "repository": {
@@ -73,8 +73,12 @@
     "build": "tsup && node scripts/copy-studio-assets.mjs",
     "dev": "tsx src/cli/index.ts",
     "typecheck": "tsc --noEmit",
-    "lint": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
     "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "test:watch": "vitest",
     "smoke": "node dist/index.js doctor",
     "smoke:install": "node scripts/smoke-install.mjs",
@@ -87,22 +91,34 @@
     "sbom:check": "node scripts/sbom-check.mjs",
     "sbom:generate": "node scripts/sbom-check.mjs --output sbom.cdx.json",
     "publish:verify": "node scripts/post-publish-verify.mjs",
+    "changeset": "changeset",
+    "changeset:version": "changeset version",
     "release:check": "node scripts/release-check.mjs",
     "pack:check": "npm pack --dry-run",
     "dogfood:init": "node scripts/dogfood-init.mjs",
     "adapter:validate": "node dist/index.js adapter validate all"
   },
   "dependencies": {
-    "@octokit/rest": "^21.1.1",
-    "commander": "^12.1.0",
+    "@clack/prompts": "^1.6.0",
+    "@octokit/rest": "^22.0.1",
+    "commander": "^14.0.3",
+    "picocolors": "^1.1.1",
     "simple-git": "^3.27.0",
-    "zod": "^3.24.1"
+    "zod": "^4.4.3"
   },
   "devDependencies": {
+    "@changesets/cli": "^2.31.0",
+    "@eslint/js": "^9.39.4",
     "@types/node": "^25.9.3",
+    "@vitest/coverage-v8": "^4.1.9",
+    "eslint": "^9.39.4",
+    "eslint-config-prettier": "^10.1.8",
+    "globals": "^17.7.0",
+    "prettier": "^3.9.4",
     "tsup": "^8.3.5",
     "tsx": "^4.19.2",
     "typescript": "^6.0.3",
+    "typescript-eslint": "^8.62.1",
     "vitest": "^4.1.8"
   },
   "overrides": {

package/prompts/ui-command-index.md

@@ -0,0 +1,124 @@
+# UI Command Index
+
+Use this index to run repeatable UI improvement workflows. These are command-like prompts for any assistant surface and the source of truth for native runtime commands.
+
+Canonical sources:
+
+- `DESIGN.md`
+- `STYLE_GUIDE.md`
+- `TESTING.md`
+- `QUALITY_GATES.md`
+- `.agent-kit/agent-roster.json`
+- `.agent-kit/skills/ui-improvement-harness.md`
+- `.agent-kit/checklists/ui-detectors.md`
+- `.agent-kit/checklists/ui-acceptance-rubric.md`
+- `.agent-kit/prompts/screenshot-review.md`
+- `.agent-kit/prompts/visual-qa-plan.md`
+
+## `/ui-audit`
+
+Audit a target UI surface before release.
+
+Required steps:
+
+1. Identify target route, component, workflow, auth state, data state, and risk tier.
+2. Load product/design context and relevant design brief.
+3. Review desktop and mobile evidence, or state which evidence must still be captured.
+4. Run the UI detector checklist.
+5. Return blockers, majors, minors, preserved capabilities, and required fixes.
+
+Required outputs: target surface, risk tier, detector findings by severity, missing evidence, pass/fail verdict.
+
+## `/ui-polish`
+
+Improve visual quality without changing product scope.
+
+Required steps:
+
+1. Start from detector findings, screenshots, or a named surface.
+2. Preserve product behavior, auth boundaries, copy claims, and data contracts.
+3. Improve hierarchy, spacing, density, alignment, component states, and interaction feedback.
+4. Avoid decorative complexity and generic SaaS defaults.
+5. Re-run detector and screenshot critique after changes.
+
+Required outputs: polish goals, changes made or proposed, detector deltas, screenshots needed, residual risks.
+
+## `/layout-cleanup`
+
+Reduce clutter and repair layout structure.
+
+Required steps:
+
+1. Identify primary task, secondary tasks, and content hierarchy.
+2. Remove unnecessary nesting, repeated surfaces, card-within-card patterns, and arbitrary dividers.
+3. Normalize spacing, grouping, alignment, heading scale, and responsive containers.
+4. Verify no truncation, overlap, or horizontal overflow remains.
+
+Required outputs: layout findings, cleanup actions, preserved workflow, desktop/mobile evidence.
+
+## `/responsive-cleanup`
+
+Make a UI work across mobile and desktop.
+
+Required steps:
+
+1. Review mobile width, desktop width, and any tablet breakpoint used by the project.
+2. Verify tap targets, text fit, navigation, primary action visibility, sticky UI, and scroll behavior.
+3. Verify stateful screens on mobile, not only the happy path.
+4. Capture or request mobile and desktop screenshots before acceptance.
+
+Required outputs: viewports checked, responsive findings, fixes, screenshots, remaining risks.
+
+## `/accessibility-pass`
+
+Run a WCAG 2.1 AA-oriented pass on the target UI.
+
+Required steps:
+
+1. Check semantics, headings, landmarks, forms, labels, tables, and buttons.
+2. Check keyboard navigation, visible focus, tab order, escape/close behavior, and skip path when applicable.
+3. Check contrast, reduced motion, error association, touch targets, and status announcements.
+4. Keep auth, state, and data-boundary tests separate from visual checks.
+
+Required outputs: accessibility findings, severity, fixes, skipped checks, test evidence.
+
+## `/distinctiveness-pass`
+
+Prove the UI belongs to this product and does not look generic.
+
+Required steps:
+
+1. Compare the first viewport to product category, audience, workflow, and content fingerprint.
+2. Confirm references were translated into lessons without copying source layouts, copy, assets, or brand marks.
+3. Remove fake metrics, vague claims, abstract filler, and interchangeable card stacks.
+4. Re-score distinctiveness and product quality where significant UI work is involved.
+
+Required outputs: product-specific evidence, generic-risk findings, source-safety notes, required changes.
+
+## `/screenshot-critique`
+
+Review provided screenshots or captured browser screenshots.
+
+Required steps:
+
+1. Name each screenshot, viewport, route, auth state, data state, and UI state.
+2. Run screenshot review, detector checklist, and accessibility risk scan.
+3. Compare against `DESIGN.md`, `STYLE_GUIDE.md`, and selected creative direction.
+4. Return concrete fixes, not broad design advice.
+
+Required outputs: screenshot inventory, blockers, high-value fixes, accepted areas, missing screenshots.
+
+## `/browser-qa`
+
+Run a live browser QA loop for an implemented UI.
+
+Required steps:
+
+1. Start or identify the dev/preview server and target routes.
+2. Open the target with required auth, role, tenant, and data state.
+3. Capture desktop and mobile screenshots.
+4. Run detector, screenshot critique, accessibility pass, and responsive cleanup.
+5. Apply scoped fixes and repeat until acceptance criteria pass.
+6. Record evidence with `agent-kit session output` when Agent Studio is in use.
+
+Required outputs: route, auth state, commands run, screenshots, detector results, fixes, final verdict.

package/rosters/next-supabase-default-council.json

@@ -70,6 +70,7 @@
         "frontend-distinctiveness-benchmark",
         "frontend-product-quality-rubric",
         "frontend-design-system",
+        "ui-improvement-harness",
         "visual-regression-qa",
         "accessibility-wcag"
       ],
@@ -95,13 +96,7 @@
         "voice-tone",
         "pricing-copy"
       ],
-      "skills": [
-        "positioning-messaging",
-        "conversion-copywriting",
-        "landing-page-copy",
-        "product-voice-tone",
-        "onboarding-empty-state-copy"
-      ],
+      "skills": ["positioning-messaging", "conversion-copywriting", "landing-page-copy", "product-voice-tone", "onboarding-empty-state-copy"],
       "handsOffTo": ["frontend-design-lead", "nextjs-engineer", "qa-engineer", "docs-maintainer"]
     },
     {
@@ -147,7 +142,19 @@
     },
     {
       "id": "core-change",
-      "triggers": ["schema", "auth", "rls", "api", "route handler", "server action", "dependency", "upgrade", "release workflow", "package behavior", "cross-layer"],
+      "triggers": [
+        "schema",
+        "auth",
+        "rls",
+        "api",
+        "route handler",
+        "server action",
+        "dependency",
+        "upgrade",
+        "release workflow",
+        "package behavior",
+        "cross-layer"
+      ],
       "sequence": [
         "planner",
         "lead-architect",
@@ -171,7 +178,7 @@
     },
     {
       "id": "frontend-change",
-      "triggers": ["screen", "component", "layout", "design", "responsive", "accessibility", "screenshot"],
+      "triggers": ["screen", "component", "layout", "design", "responsive", "accessibility", "screenshot", "ui audit", "ui polish", "browser qa"],
       "sequence": ["planner", "frontend-design-lead", "marketing-copy-lead", "nextjs-engineer", "qa-engineer", "docs-maintainer"],
       "council": ["frontend-design-lead", "marketing-copy-lead", "qa-engineer"],
       "requiredOutputs": [
@@ -183,15 +190,33 @@
         "design critique verdict",
         "frontend product-quality scorecard",
         "domain-specific UI rationale",
+        "UI detector findings and severity",
+        "UI command workflow applied when polishing or auditing",
         "visual QA evidence",
         "state coverage",
         "accessibility checks",
-        "desktop/mobile verification"
+        "desktop/mobile verification",
+        "authenticated screen evidence when applicable"
       ]
     },
     {
       "id": "marketing-copy",
-      "triggers": ["copy", "copywriting", "marketing", "positioning", "messaging", "value prop", "value proposition", "landing page", "headline", "cta", "conversion", "onboarding", "empty state", "pricing"],
+      "triggers": [
+        "copy",
+        "copywriting",
+        "marketing",
+        "positioning",
+        "messaging",
+        "value prop",
+        "value proposition",
+        "landing page",
+        "headline",
+        "cta",
+        "conversion",
+        "onboarding",
+        "empty state",
+        "pricing"
+      ],
       "sequence": ["planner", "marketing-copy-lead", "frontend-design-lead", "qa-engineer", "docs-maintainer"],
       "council": ["marketing-copy-lead", "frontend-design-lead"],
       "requiredOutputs": [
@@ -219,7 +244,7 @@
     "Meaningful multi-agent work must record council-session evidence in COUNCIL.md or a structured record that follows .agent-kit/schemas/council-session.schema.json.",
     "Planner starts planning and ambiguous requests by default.",
     "Lead Architect must review core changes before implementation.",
-    "Frontend Design Lead must record reference-set evidence, anti-references, a design critique verdict, a distinctiveness benchmark, and a frontend product-quality scorecard before accepting significant frontend work.",
+    "Frontend Design Lead must record reference-set evidence, anti-references, a design critique verdict, a distinctiveness benchmark, a frontend product-quality scorecard, UI detector severity findings, and desktop/mobile screenshot evidence before accepting significant frontend work.",
     "Marketing Copy Lead must ask discovery questions and record audience, pain, outcome, value proposition, proof, objections, voice/tone, and conversion goal before accepting public-facing or conversion-facing copy.",
     "Security Reviewer must review auth, data mutation, external-call, dependency, secret, and release-risk changes.",
     "QA Engineer must verify behavior changes before completion.",

package/runtime-skills/ui-improvement-harness/SKILL.md

@@ -0,0 +1,12 @@
+---
+name: ui-improvement-harness
+description: Use when running repeatable UI audit, polish, layout cleanup, responsive cleanup, accessibility, screenshot critique, visual distinctiveness, or live browser QA workflows.
+---
+
+# UI Improvement Harness Runtime Skill
+
+Canonical workflow: `skills/ui-improvement-harness.md`.
+
+Installed-project canonical workflow: `.agent-kit/skills/ui-improvement-harness.md`.
+
+Use the canonical skill before accepting meaningful UI polish, audit, screenshot review, or browser iteration work. Runtime wrappers must not fork the detector, rubric, or command policy.