@appsforgood/next-supabase-kit 0.1.0 → 0.1.3

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

@@ -1,8 +1,8 @@
 {
-  "packageName": "@agent-skills/next-supabase-kit",
-  "packageVersion": "0.1.0",
+  "packageName": "@appsforgood/next-supabase-kit",
+  "packageVersion": "0.1.3",
   "stack": "next-supabase",
-  "installedAt": "2026-06-07T11:22:09.937Z",
+  "installedAt": "2026-06-14T04:35:38.435Z",
   "docs": [
     "AGENTS.md",
     "AGENT_ROSTER.md",
@@ -27,6 +27,7 @@
     "skills",
     "prompts",
     "checklists",
+    "runtime-skills",
     "design-adapters",
     "assistant-adapters",
     "design-briefs",
@@ -37,22 +38,22 @@
   "agentRoster": ".agent-kit/agent-roster.json",
   "modelRouting": ".agent-kit/model-routing.json",
   "templateHashes": {
-    "AGENTS.md": "f9bb80554334f8466d4d0c0c5ae0fa1ed0e7fd5060ef28802e97ed96f76c1a98",
+    "AGENTS.md": "c7f3e7360938a1ed804d2110e9af96e6f09d50c49138063bef0db1642ddaf84f",
     "AGENT_ROSTER.md": "fb88198d0a5f911ec8cbaa2850c1a47e1dbd1fe2c8144f9ce633bbfc1ec414d3",
-    "ASSISTANT_ADAPTERS.md": "d6154a64d77f37cdcfa1f6e59c7d30fc0728c07553551ea77c4fe8d14f1c7365",
+    "ASSISTANT_ADAPTERS.md": "7deab45792ad5724c292f99fda64ea24d84dbdf81204a8fa0371325dbc86671b",
     "COUNCIL.md": "40bec9051664c9c38b8360ee16f21b5e4716030d19c493cdec67395ab06528e1",
     "SKILLS.md": "3c3c2eb40438a42026479dccac7bbf084ba22e2d758c425dff59385d05eae3bd",
-    "SPEC.md": "8a12bae351b0ceda50dfb2e63ec68767e27f68ffdc15f25bb21bba189855578e",
-    "DECISIONS.md": "89b1c8d70450dae83d8b877d5c6acb6517a3555321fdc6fb7259726e06beebab",
-    "DOCS.md": "40a3f03278785b7edc8f43fc0c9a72f2ab33f966efe391039cda27c33b6899f1",
+    "SPEC.md": "bb0406a141338b630a82026e4a2bb37f38448b3641d3b3ada62d146711a4fbfe",
+    "DECISIONS.md": "0c08d1106a40f829b197d552d0397c9bcd9af7e168a55c47ff5be033c6035ec6",
+    "DOCS.md": "4a2940e8d2526d4ad8f481c82451dd65d62f0420638795580a5f04dacec237de",
     "DESIGN.md": "70f52e539073e7c4c1d37e63c9a21672a3221d2931d3ff284058dabf60243530",
     "MESSAGING.md": "f1f7c0f11796820b60bb44e42a65749763f7167944ba6acf092a1cf7b59e50de",
-    "MODEL_ROUTING.md": "0835335a03c1c24275e4a1ddb7905062858035079f9010c14a6a9d70ce7831a7",
-    "QUALITY_GATES.md": "0de13d3add75dfa0c01b957cf6b3a1ae552dd7dab2a2e1c17be74263b6b6950d",
+    "MODEL_ROUTING.md": "f0ca3bd12872cd5f61ff4c6bef670249c0a0188f20c049cb0d09d84219b1839c",
+    "QUALITY_GATES.md": "df9a39ad301394f7f58bc3dd5bf52f9fafeefffdc240fb7ae6a9b6a74b8da0b5",
     "STYLE_GUIDE.md": "dcaed2d7885e920060d74e4ba5a8d548a08a729a3efc178434a17b5a182fb628",
     "SECURITY.md": "f046e4dc794f49700ddee4cb866e2ba1983a1b71268f2e244892d615b41714f8",
-    "TESTING.md": "183f9ca56b95f6390bcfda75a3da3bd22298c8c6ff0d815982022b2af74da75d",
+    "TESTING.md": "30ef3fa51a6b8e0b5ef608d7b7c448d6a7958bc87c27e15786a54f361fc7ef23",
     "DEPLOYMENT.md": "c33d949c2b1850f8ee6c38e5ec565325c3d47f4daac13b81c75e1b35655ea174",
-    "UPGRADE.md": "e8393975a7a46c2020cd6afb4c4b4d2cc17807fbec1d33f52b7d159f4eb1e3a0"
+    "UPGRADE.md": "d4678475458744dee7c1f23b69c04e3cf82d9e896196e62455585aaae5d3a25a"
   }
 }

package/examples/next-supabase-installed/.agent-kit/model-routing.json

@@ -153,6 +153,13 @@
       "modelSelection": "Use Copilot chat or coding-agent model selection where available; repo instructions advise but do not force model selection",
       "enforcement": "advisory",
       "adapter": ".agent-kit/assistant-adapters/model-selection/github-copilot-model-selection.md"
+    },
+    {
+      "tool": "Antigravity",
+      "instructionSurface": ".antigravity/agent-kit/plugin.json, .antigravity/agent-kit/commands/*.toml, and .antigravity/runtime-skills/*/SKILL.md",
+      "modelSelection": "Use Antigravity runtime or workspace model controls where available; native commands advise Agent Kit model profiles but do not force provider selection",
+      "enforcement": "advisory",
+      "adapter": ".agent-kit/assistant-adapters/antigravity.md"
     }
   ],
   "updatePolicy": [

package/examples/next-supabase-installed/README.md

@@ -3,9 +3,9 @@
 This directory shows the expected shape after running:
 
 ```bash
-npx @agent-skills/next-supabase-kit init --stack next-supabase
-npx @agent-skills/next-supabase-kit audit --json
-npx @agent-skills/next-supabase-kit audit --min-readiness baseline-setup
+npx @appsforgood/next-supabase-kit init --stack next-supabase
+npx @appsforgood/next-supabase-kit audit --json
+npx @appsforgood/next-supabase-kit audit --min-readiness baseline-setup
 ```
 
 The example is intentionally compact. It documents the generated structure, representative manifest metadata, Cursor adapter rules under `.cursor/rules/`, and expected audit shape without duplicating every template file. `npm run examples:check` verifies that these committed example files still match a clean install from the current built CLI.

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

@@ -1,23 +1,24 @@
 {
   "summary": {
-    "pass": 60,
-    "warn": 3,
+    "pass": 62,
+    "warn": 4,
     "fail": 0
   },
   "readiness": {
     "level": "baseline-setup",
     "summary": "Agent kit setup is valid, but project-specific evidence still needs to replace starter placeholders.",
     "nextActions": [
-      "Run agent-kit onboard or agent-kit init --guided so agents can start with project-specific context.",
+      "Answer product summary, audience, workflows, auth/tenant model, UI direction, value proposition, and quality target with agent-kit setup or by editing .agent-kit/project-context.json.",
       "Replace TBD adapter rows with date, owner, evidence, model-selection status, and known limitations for each active IDE.",
-      "Replace TBD/example rows with real project evidence, or document why an item is not applicable before claiming strong or best-practice maturity."
+      "Replace TBD/example rows with real project evidence, or document why an item is not applicable before claiming strong or best-practice maturity.",
+      "Add package.json with test, lint, and build scripts appropriate to the stack."
     ]
   },
   "findings": [
     {
       "level": "pass",
       "area": "install",
-      "message": "Agent kit installed at version 0.1.0."
+      "message": "Agent kit installed at version 0.1.3."
     },
     {
       "level": "pass",
@@ -179,11 +180,16 @@
       "area": "agents",
       "message": ".agent-kit/schemas/studio-session.schema.json is present and parseable."
     },
+    {
+      "level": "pass",
+      "area": "agents",
+      "message": ".agent-kit/schemas/onboarding-state.schema.json is present and parseable."
+    },
     {
       "level": "warn",
       "area": "studio",
-      "message": ".agent-kit/project-context.json is missing.",
-      "remediation": "Run agent-kit onboard or agent-kit init --guided so agents can start with project-specific context."
+      "message": ".agent-kit/project-context.json is valid but still missing high-value project context.",
+      "remediation": "Answer product summary, audience, workflows, auth/tenant model, UI direction, value proposition, and quality target with agent-kit setup or by editing .agent-kit/project-context.json."
     },
     {
       "level": "pass",
@@ -331,6 +337,17 @@
       "area": "evidence",
       "message": "Project evidence docs still contain starter placeholders: COUNCIL.md, SPEC.md, DESIGN.md, MESSAGING.md, SECURITY.md, DEPLOYMENT.md, ASSISTANT_ADAPTERS.md, UPGRADE.md.",
       "remediation": "Replace TBD/example rows with real project evidence, or document why an item is not applicable before claiming strong or best-practice maturity."
+    },
+    {
+      "level": "warn",
+      "area": "project-reality",
+      "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": ".agent-kit/project-context.json exists."
     }
   ]
 }

package/examples/next-supabase-installed/tree.txt

@@ -16,6 +16,9 @@
 |-- TESTING.md
 |-- DEPLOYMENT.md
 |-- UPGRADE.md
+|-- .github
+|   `-- workflows
+|       `-- agent-kit-audit.yml
 |-- .cursor
 |   `-- rules
 |       |-- cursor-agent-kit.mdc
@@ -24,10 +27,13 @@
     |-- manifest.json
     |-- agent-roster.json
     |-- model-routing.json
+    |-- project-context.json
+    |-- project-context.md
     |-- config.json
     |-- overrides.json
     |-- agents/
     |-- skills/
+    |-- runtime-skills/
     |-- prompts/
     |-- checklists/
     |-- design-adapters/

package/model-routing/default-model-routing.json

@@ -153,6 +153,13 @@
       "modelSelection": "Use Copilot chat or coding-agent model selection where available; repo instructions advise but do not force model selection",
       "enforcement": "advisory",
       "adapter": ".agent-kit/assistant-adapters/model-selection/github-copilot-model-selection.md"
+    },
+    {
+      "tool": "Antigravity",
+      "instructionSurface": ".antigravity/agent-kit/plugin.json, .antigravity/agent-kit/commands/*.toml, and .antigravity/runtime-skills/*/SKILL.md",
+      "modelSelection": "Use Antigravity runtime or workspace model controls where available; native commands advise Agent Kit model profiles but do not force provider selection",
+      "enforcement": "advisory",
+      "adapter": ".agent-kit/assistant-adapters/antigravity.md"
     }
   ],
   "updatePolicy": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appsforgood/next-supabase-kit",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "Open agent council, skills, prompts, checklists, and markdown templates for Next.js and Supabase projects.",
   "type": "module",
   "repository": {
@@ -20,11 +20,15 @@
   },
   "files": [
     "dist",
+    "dist/studio/wizard/assets",
+    "dist/studio/office/assets",
     "templates",
     "agents",
     "skills",
     "prompts",
     "checklists",
+    "antigravity",
+    "runtime-skills",
     "design-adapters",
     "assistant-adapters",
     "model-routing",
@@ -63,7 +67,7 @@
   },
   "packageManager": "npm@11.6.2",
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && node scripts/copy-studio-assets.mjs",
     "dev": "tsx src/cli/index.ts",
     "typecheck": "tsc --noEmit",
     "lint": "tsc --noEmit",
@@ -72,7 +76,9 @@
     "smoke": "node dist/index.js doctor",
     "smoke:install": "node scripts/smoke-install.mjs",
     "smoke:studio": "node scripts/smoke-studio.mjs",
+    "smoke:setup": "node scripts/smoke-setup.mjs",
     "smoke:audit-gate": "node scripts/smoke-audit-gate.mjs",
+    "package:validate": "node dist/index.js package validate",
     "examples:check": "node scripts/example-check.mjs",
     "version:check": "node scripts/version-check.mjs",
     "sbom:check": "node scripts/sbom-check.mjs",
@@ -88,11 +94,13 @@
     "zod": "^3.24.1"
   },
   "devDependencies": {
-    "@rolldown/binding-win32-x64-msvc": "^1.0.3",
-    "@types/node": "^22.10.5",
+    "@types/node": "^25.9.3",
     "tsup": "^8.3.5",
     "tsx": "^4.19.2",
-    "typescript": "^5.7.3",
+    "typescript": "^6.0.3",
     "vitest": "^4.1.8"
+  },
+  "overrides": {
+    "esbuild": "0.28.1"
   }
 }

package/runtime-skills/README.md

@@ -0,0 +1,7 @@
+# Runtime Skills
+
+These portable `SKILL.md` wrappers are for runtimes that discover skills by directory.
+
+Canonical skill content remains in `skills/*.md` and installed project copies under `.agent-kit/skills/*.md`. Runtime wrappers must point back to the canonical skill file instead of forking the workflow.
+
+When a canonical skill changes, update the matching wrapper description only if the trigger behavior changes.

package/runtime-skills/accessibility-wcag/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: accessibility-wcag
+description: Use for WCAG 2.1 AA review of forms, navigation, modals, menus, tables, dashboards, and custom interactions.
+---
+
+Canonical workflow: read `skills/accessibility-wcag.md` or `.agent-kit/skills/accessibility-wcag.md`.
+
+Apply semantic HTML first, ARIA only when needed, keyboard navigation, focus states, and WCAG 2.1 AA color contrast. Record accessibility evidence with `agent-kit session output` when the work changes user-facing UI.

package/runtime-skills/agent-handoff-tracing/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: agent-handoff-tracing
+description: Use for meaningful multi-agent work where decisions, risks, handoffs, outputs, and verification must survive the chat.
+---
+
+Canonical workflow: read `skills/agent-handoff-tracing.md` or `.agent-kit/skills/agent-handoff-tracing.md`.
+
+Select the roster workflow, read project context and corrections, record decisions/handoffs/required outputs with `agent-kit session ...`, then run `agent-kit session render`.

package/runtime-skills/best-practice-maturity-review/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: best-practice-maturity-review
+description: Use for setup audits, release readiness, dogfood reviews, roadmap checkpoints, and best-practice maturity claims.
+---
+
+Canonical workflow: read `skills/best-practice-maturity-review.md` or `.agent-kit/skills/best-practice-maturity-review.md`.
+
+Use `QUALITY_GATES.md` to name the target level and require evidence for each affected area. Treat missing evidence as incomplete, not as a passing caveat.

package/runtime-skills/content-first-design/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: content-first-design
+description: Use before designing or changing user-facing product screens, dashboards, tools, marketplaces, content experiences, or AI workflow UIs.
+---
+
+Canonical workflow: read `skills/content-first-design.md` or `.agent-kit/skills/content-first-design.md`.
+
+Capture audience, user needs, product category, content inventory, brand constraints, creative options, and non-goals before implementation starts.

package/runtime-skills/conversion-copywriting/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: conversion-copywriting
+description: Use for public-facing or conversion-facing headlines, CTAs, onboarding, pricing, landing pages, and UX copy.
+---
+
+Canonical workflow: read `skills/conversion-copywriting.md` or `.agent-kit/skills/conversion-copywriting.md`.
+
+Use `MESSAGING.md` for audience, pain, desired outcome, proof, objections, voice, and conversion goal. Mark unsupported claims as assumptions.

package/runtime-skills/deployment-observability/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: deployment-observability
+description: Use for release readiness, environment variables, migration order, logs, monitoring, rollback, and post-release verification.
+---
+
+Canonical workflow: read `skills/deployment-observability.md` or `.agent-kit/skills/deployment-observability.md`.
+
+Confirm deployment prerequisites, observable failures, release order, verification commands, and rollback guidance before shipping.

package/runtime-skills/docs-maintainer/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: docs-maintainer
+description: Use after significant architecture, behavior, release, security, adapter, or workflow changes that affect living docs.
+---
+
+Canonical workflow: read `skills/docs-maintainer.md` or `.agent-kit/skills/docs-maintainer.md`.
+
+Update `SPEC.md`, `DECISIONS.md`, `DOCS.md`, `QUALITY_GATES.md`, `TESTING.md`, `UPGRADE.md`, and related docs so another engineer or agent can continue safely.

package/runtime-skills/frontend-design-system/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: frontend-design-system
+description: Use for user-facing screens and components that need design tokens, component states, responsiveness, accessibility, and anti-generic UI review.
+---
+
+Canonical workflow: read `skills/frontend-design-system.md` or `.agent-kit/skills/frontend-design-system.md`.
+
+Require real content, task-first hierarchy, component states, accessibility, mobile behavior, and visual QA evidence before accepting significant frontend work.

package/runtime-skills/frontend-distinctiveness-benchmark/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: frontend-distinctiveness-benchmark
+description: Use when significant frontend work risks looking interchangeable with a generic AI-generated product.
+---
+
+Canonical workflow: read `skills/frontend-distinctiveness-benchmark.md` or `.agent-kit/skills/frontend-distinctiveness-benchmark.md`.
+
+Prove first-screen specificity, product nouns, data shapes, real actions, source-safe references, asset provenance, important states, and desktop/mobile evidence.

package/runtime-skills/frontend-product-quality-rubric/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: frontend-product-quality-rubric
+description: Use to score significant frontend work for user fit, content specificity, visual identity, IA, states, accessibility, and source safety.
+---
+
+Canonical workflow: read `skills/frontend-product-quality-rubric.md` or `.agent-kit/skills/frontend-product-quality-rubric.md`.
+
+Reject critical zeroes, require at least `10/14` for acceptance, and require higher evidence for best-practice frontend claims.

package/runtime-skills/landing-page-copy/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: landing-page-copy
+description: Use for landing-page headlines, subheads, proof, objections, CTAs, and conversion copy.
+---
+
+Canonical workflow: read `skills/landing-page-copy.md` or `.agent-kit/skills/landing-page-copy.md`.
+
+Tie copy to audience, problem, outcome, differentiator, proof, objections, and one clear primary CTA. Avoid generic SaaS claims.

package/runtime-skills/nextjs-app-router/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: nextjs-app-router
+description: Use for Next.js App Router, Server Components, Client Components, Route Handlers, Server Actions, caching, forms, and metadata.
+---
+
+Canonical workflow: read `skills/nextjs-app-router.md` or `.agent-kit/skills/nextjs-app-router.md`.
+
+Keep server/client boundaries explicit, preserve auth context, protect secrets from client bundles, and handle loading, error, empty, and success states.

package/runtime-skills/onboarding-empty-state-copy/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: onboarding-empty-state-copy
+description: Use for onboarding copy, first-run states, empty states, setup prompts, and guided user flows.
+---
+
+Canonical workflow: read `skills/onboarding-empty-state-copy.md` or `.agent-kit/skills/onboarding-empty-state-copy.md`.
+
+Use product-specific nouns and actions, reduce cognitive load, avoid unsupported claims, and align copy with `MESSAGING.md`.

package/runtime-skills/owasp-security-review/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: owasp-security-review
+description: Use for auth, API routes, Server Actions, external fetches, file uploads, webhooks, dependencies, and data mutations.
+---
+
+Canonical workflow: read `skills/owasp-security-review.md` or `.agent-kit/skills/owasp-security-review.md`.
+
+Review broken access control, IDOR, injection, SSRF, misconfiguration, vulnerable dependencies, secret handling, validation, encoding, and safe errors.

package/runtime-skills/planning-council/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: planning-council
+description: Use for planning, roadmaps, ambiguous feature requests, core architecture changes, auth/data work, release work, and multi-agent routing.
+---
+
+Canonical workflow: read `skills/planning-council.md` or `.agent-kit/skills/planning-council.md`.
+
+Classify the request, select the roster workflow, name the maturity target, map affected layers, preserve contracts, assign handoffs, and record evidence.

package/runtime-skills/positioning-messaging/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: positioning-messaging
+description: Use for audience, pain, outcome, alternatives, differentiator, proof, objections, voice, and conversion strategy.
+---
+
+Canonical workflow: read `skills/positioning-messaging.md` or `.agent-kit/skills/positioning-messaging.md`.
+
+Update `MESSAGING.md`, ask only high-impact discovery questions, and connect every public claim to real proof or an explicit assumption.

package/runtime-skills/postgres-migrations/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: postgres-migrations
+description: Use for schema changes, constraints, indexes, SQL functions, triggers, seed data, data migrations, and rollback planning.
+---
+
+Canonical workflow: read `skills/postgres-migrations.md` or `.agent-kit/skills/postgres-migrations.md`.
+
+Order migrations, protect integrity with constraints, add indexes for access patterns, and document rollback or retry guidance.

package/runtime-skills/product-voice-tone/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: product-voice-tone
+description: Use for product voice, tone, microcopy, onboarding language, CTA style, and consistent UX copy.
+---
+
+Canonical workflow: read `skills/product-voice-tone.md` or `.agent-kit/skills/product-voice-tone.md`.
+
+Keep voice grounded in product facts, audience needs, proof, objections, and `MESSAGING.md`; avoid generic AI-looking language.

package/runtime-skills/reference-led-design-critique/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: reference-led-design-critique
+description: Use before accepting significant frontend work that needs references, anti-references, source safety, and design critique.
+---
+
+Canonical workflow: read `skills/reference-led-design-critique.md` or `.agent-kit/skills/reference-led-design-critique.md`.
+
+Use references for lessons without copying protected source design, brand identity, copy, or assets. Record critique verdict and required changes.

package/runtime-skills/supabase-auth-rls/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: supabase-auth-rls
+description: Use for Supabase Auth, SSR clients, sessions, middleware, RLS policies, Storage policies, and service-role usage.
+---
+
+Canonical workflow: read `skills/supabase-auth-rls.md` or `.agent-kit/skills/supabase-auth-rls.md`.
+
+Enforce authorization in RLS, keep service-role keys server-only, test session refresh and redirects, and prevent IDOR at the SQL boundary.

package/runtime-skills/testing-qa/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: testing-qa
+description: Use for unit tests, regression tests, smoke checks, Playwright coverage, visual QA, and acceptance evidence.
+---
+
+Canonical workflow: read `skills/testing-qa.md` or `.agent-kit/skills/testing-qa.md`.
+
+Cover core logic, preserved behavior, critical paths, auth/data mutations, network failures, empty/error states, and explicitly document gaps.

package/runtime-skills/upgrade-maintenance/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: upgrade-maintenance
+description: Use for Agent Kit, Next.js, Supabase, UI library, testing tool, release workflow, adapter, and dependency upgrades.
+---
+
+Canonical workflow: read `skills/upgrade-maintenance.md` or `.agent-kit/skills/upgrade-maintenance.md`.
+
+Run `agent-kit diff`, preserve overrides, review conflicts, check release notes/migrations/codemods, run audit, and record rollback evidence.

package/runtime-skills/visual-regression-qa/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: visual-regression-qa
+description: Use for user-facing screen changes, reusable components, visual design tokens, responsive layouts, image-heavy pages, and visual acceptance.
+---
+
+Canonical workflow: read `skills/visual-regression-qa.md` or `.agent-kit/skills/visual-regression-qa.md`.
+
+Name the visual QA tier, capture important states and breakpoints, handle volatile regions, and keep visual checks separate from accessibility and data-boundary tests.

package/schemas/onboarding-state.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.dev/schemas/onboarding-state.schema.json",
+  "title": "Agent Kit Onboarding State",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "depth",
+    "startedAt",
+    "lastVisitedAt",
+    "completedSections",
+    "skippedSections",
+    "currentSection",
+    "currentStep",
+    "wizardVersion"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "depth": { "type": "string", "enum": ["quick", "standard", "complete", "undecided"] },
+    "startedAt": { "type": "string", "format": "date-time" },
+    "lastVisitedAt": { "type": "string", "format": "date-time" },
+    "completedAt": { "type": "string", "format": "date-time" },
+    "completedSections": { "type": "array", "items": { "type": "string" } },
+    "skippedSections": { "type": "array", "items": { "type": "string" } },
+    "currentSection": { "type": "string" },
+    "currentStep": { "type": "integer", "minimum": 0 },
+    "wizardVersion": { "type": "string" },
+    "ideSurface": { "type": "string", "enum": ["cursor", "copilot", "claude", "codex", "other"] },
+    "ideVerifiedAt": { "type": "string", "format": "date-time" },
+    "visualQaTier": { "type": "string", "enum": ["baseline", "strong", "mature"] }
+  }
+}

package/templates/next-supabase/.github/workflows/agent-kit-audit.yml

@@ -0,0 +1,35 @@
+name: Agent Kit Audit
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  audit:
+    name: Agent kit readiness
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: "24"
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run baseline audit gate
+        run: npx agent-kit audit --json --min-readiness baseline-setup

package/templates/next-supabase/AGENTS.md

@@ -2,7 +2,7 @@
 
 This project uses explicit agent roles so implementation, security, quality, and documentation do not collapse into one vague assistant.
 
-Use `.agent-kit/agent-roster.json` as the default council contract. Use `MODEL_ROUTING.md` and `.agent-kit/model-routing.json` to choose model profiles for each agent. Before meaningful work, read `.agent-kit/project-context.json` and `.agent-kit/project-context.md` when present, then apply active corrections from `.agent-kit/corrections/project-rules.json` and `.agent-kit/corrections/agent-rules.json`. When a request is ambiguous, planning-oriented, or cross-layer, start with Planner and follow the matching workflow in `AGENT_ROSTER.md`. Use `ASSISTANT_ADAPTERS.md` to confirm which AI coding tools load these instructions and how model selection is handled. Record meaningful council sessions in `COUNCIL.md` or the local Agent Studio files under `.agent-kit/council-sessions/`.
+Use `.agent-kit/agent-roster.json` as the default council contract. Use `MODEL_ROUTING.md` and `.agent-kit/model-routing.json` to choose model profiles for each agent. Before meaningful work, read `.agent-kit/project-context.json`, `.agent-kit/project-context.md`, and `.agent-kit/agent-briefs.md` when present, then apply active corrections from `.agent-kit/corrections/project-rules.json` and `.agent-kit/corrections/agent-rules.json`. When a request is ambiguous, planning-oriented, or cross-layer, start with Planner and follow the matching workflow in `AGENT_ROSTER.md`. Use `ASSISTANT_ADAPTERS.md` to confirm which AI coding tools load these instructions and how model selection is handled. Record meaningful council sessions in `COUNCIL.md` or the local Agent Studio files under `.agent-kit/council-sessions/`.
 
 ## Planner
 

package/templates/next-supabase/ASSISTANT_ADAPTERS.md

@@ -26,10 +26,11 @@ Canonical source of truth:
 
 | Tool | Instruction surface | Instruction status | Model-selection status | Enforcement | Evidence | Notes |
 | --- | --- | --- | --- | --- | --- | --- |
-| Codex / AGENTS.md-compatible tools | `AGENTS.md`, optional `.codex/config.toml`, optional `.codex/agents/*.toml` | TBD | TBD | Partial | TBD | Confirm the tool loads root `AGENTS.md`, follows council routing, and uses `MODEL_ROUTING.md` for model choice. |
-| GitHub Copilot / VS Code | `.github/copilot-instructions.md` and `.github/instructions/*.instructions.md` | TBD | TBD | Advisory | TBD | Use `.agent-kit/assistant-adapters/github-copilot-instructions.md`, `github-next-supabase.instructions.md`, and `model-selection/github-copilot-model-selection.md` as starting points. |
+| Codex / AGENTS.md-compatible tools | `AGENTS.md`, optional `.codex/config.toml`, optional `.codex/agents/*.toml` | TBD | TBD | Partial | TBD | Run `agent-kit init --activate codex` to copy optional `.codex/config.toml`. Confirm the tool loads root `AGENTS.md`. |
+| GitHub Copilot / VS Code | `.github/copilot-instructions.md` and `.github/instructions/*.instructions.md` | TBD | TBD | Advisory | TBD | Run `agent-kit init --activate copilot` to promote Copilot instruction files. |
 | Cursor | `.cursor/rules/cursor-agent-kit.mdc` and `.cursor/rules/cursor-model-selection.mdc` | Active on init | Advisory | Advisory | `agent-kit init` copies canonical rules from `.agent-kit/assistant-adapters/`; verify in Cursor Settings > Rules that both rules load. | `agent-kit init` installs `.cursor/rules/cursor-agent-kit.mdc` and `.cursor/rules/cursor-model-selection.mdc`. Re-run `agent-kit diff` after kit updates if the canonical adapter files changed. |
-| Claude Code | `.claude/agents/*.md` and optional `CLAUDE.md` | TBD | TBD | Partial | TBD | Use `.agent-kit/assistant-adapters/claude-code-subagents.md` and `model-selection/claude-code-subagents-with-models.md` as starting points. |
+| Claude Code | `.claude/agents/*.md` and optional `CLAUDE.md` | TBD | TBD | Partial | TBD | Run `agent-kit init --activate claude` to generate subagents from `.agent-kit/agent-roster.json` and install `CLAUDE.md`. |
+| Antigravity | `.antigravity/agent-kit/plugin.json`, `.antigravity/agent-kit/commands/*.toml`, `.antigravity/runtime-skills/*/SKILL.md` | TBD | TBD | Advisory | TBD | Run `agent-kit init --activate antigravity`, then `agent-kit adapter validate antigravity`; optional native validation is `agy plugin validate` when available. |
 
 ## Model Selection
 
@@ -68,6 +69,23 @@ Verification steps:
 
 If a project already customized `.cursor/rules/`, review `.agent-kit/conflicts/` after `agent-kit update` before adopting newer adapter wording.
 
+## Antigravity Activation
+
+`agent-kit init --activate antigravity` installs a native runtime adapter without changing the canonical Agent Kit operating model:
+
+- `.antigravity/agent-kit/plugin.json`
+- `.antigravity/agent-kit/commands/*.toml`
+- `.antigravity/runtime-skills/*/SKILL.md`
+- `.antigravity/agent-kit/README.md`
+
+Validate the structural package with:
+
+```bash
+agent-kit adapter validate antigravity
+```
+
+If the local machine has the Antigravity CLI, teams may also run native plugin validation and record that evidence here. Runtime command files are adapters only; `AGENTS.md`, `.agent-kit/agent-roster.json`, `QUALITY_GATES.md`, and Agent Studio sessions remain canonical.
+
 ## Acceptance Evidence
 
 Before claiming strong or best-practice maturity, replace the TBD rows above with: