@appsforgood/next-supabase-kit 0.3.0 → 0.4.0

package/schemas/project-context.schema.json

@@ -1,94 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-skills.dev/schemas/project-context.schema.json",
-  "title": "Agent Kit Project Context",
-  "type": "object",
-  "required": [
-    "schemaVersion",
-    "projectName",
-    "productSummary",
-    "productCategory",
-    "primaryAudience",
-    "primaryWorkflows",
-    "businessCriticalBehavior",
-    "architecture",
-    "dataSensitivity",
-    "authModel",
-    "tenantModel",
-    "integrations",
-    "uiDirection",
-    "messaging",
-    "qualityTarget",
-    "knownConstraints",
-    "openQuestions",
-    "evidence",
-    "lastReviewedAt",
-    "owners"
-  ],
-  "additionalProperties": false,
-  "properties": {
-    "schemaVersion": { "const": 1 },
-    "projectName": { "type": "string" },
-    "productSummary": { "type": "string" },
-    "productCategory": { "type": "string" },
-    "primaryAudience": { "type": "string" },
-    "primaryWorkflows": { "type": "array", "items": { "type": "string" } },
-    "businessCriticalBehavior": { "type": "array", "items": { "type": "string" } },
-    "architecture": {
-      "type": "object",
-      "required": ["scripts", "frameworks", "uiLibraries", "hasSupabase", "supabaseSignals", "testTools", "envExampleKeys", "deployment"],
-      "additionalProperties": false,
-      "properties": {
-        "packageManager": { "type": "string" },
-        "scripts": { "type": "array", "items": { "type": "string" } },
-        "frameworks": { "type": "array", "items": { "type": "string" } },
-        "uiLibraries": { "type": "array", "items": { "type": "string" } },
-        "hasSupabase": { "type": "boolean" },
-        "supabaseSignals": { "type": "array", "items": { "type": "string" } },
-        "testTools": { "type": "array", "items": { "type": "string" } },
-        "envExampleKeys": { "type": "array", "items": { "type": "string" } },
-        "deployment": { "type": "array", "items": { "type": "string" } }
-      }
-    },
-    "dataSensitivity": { "type": "array", "items": { "type": "string" } },
-    "authModel": { "type": "string" },
-    "tenantModel": { "type": "string" },
-    "integrations": { "type": "array", "items": { "type": "string" } },
-    "uiDirection": {
-      "type": "object",
-      "required": ["preferred", "avoid"],
-      "additionalProperties": false,
-      "properties": {
-        "preferred": { "type": "string" },
-        "avoid": { "type": "string" }
-      }
-    },
-    "messaging": {
-      "type": "object",
-      "required": ["valueProposition", "proof", "objections"],
-      "additionalProperties": false,
-      "properties": {
-        "valueProposition": { "type": "string" },
-        "proof": { "type": "array", "items": { "type": "string" } },
-        "objections": { "type": "array", "items": { "type": "string" } }
-      }
-    },
-    "qualityTarget": { "type": "string", "enum": ["baseline-setup", "needs-improvement", "best-practice-candidate"] },
-    "knownConstraints": { "type": "array", "items": { "type": "string" } },
-    "openQuestions": { "type": "array", "items": { "type": "string" } },
-    "evidence": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["source", "note"],
-        "additionalProperties": false,
-        "properties": {
-          "source": { "type": "string", "minLength": 1 },
-          "note": { "type": "string", "minLength": 1 }
-        }
-      }
-    },
-    "lastReviewedAt": { "type": "string", "format": "date-time" },
-    "owners": { "type": "array", "items": { "type": "string" } }
-  }
-}

package/schemas/runtime-event.schema.json

@@ -1,66 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-skills.dev/schemas/runtime-event.schema.json",
-  "title": "Agent Kit Runtime Event",
-  "type": "object",
-  "required": ["schemaVersion", "eventId", "sequence", "runId", "createdAt", "type"],
-  "additionalProperties": false,
-  "properties": {
-    "schemaVersion": { "const": 1 },
-    "eventId": { "type": "string", "minLength": 1 },
-    "sequence": { "type": "integer", "minimum": 1 },
-    "runId": { "type": "string", "minLength": 1 },
-    "createdAt": { "type": "string", "format": "date-time" },
-    "type": {
-      "enum": [
-        "run_started",
-        "run_status_changed",
-        "agent_started",
-        "agent_completed",
-        "handoff",
-        "approval_requested",
-        "approval_decided",
-        "tool_started",
-        "tool_completed",
-        "provider_selected",
-        "artifact",
-        "verification",
-        "run_error",
-        "run_completed"
-      ]
-    },
-    "agentId": { "type": "string", "minLength": 1 },
-    "text": { "type": "string" },
-    "status": { "enum": ["planned", "running", "awaiting-approval", "blocked", "cancelled", "failed", "complete"] },
-    "approval": {
-      "oneOf": [
-        {
-          "type": "object",
-          "required": ["approvalId", "runId", "risk", "title", "detail", "requestedAt"],
-          "additionalProperties": false,
-          "properties": {
-            "approvalId": { "type": "string", "minLength": 1 },
-            "runId": { "type": "string", "minLength": 1 },
-            "risk": { "enum": ["plan", "write", "network", "secret", "destructive", "host-mutation", "final-commit"] },
-            "title": { "type": "string", "minLength": 1 },
-            "detail": { "type": "string" },
-            "requestedAt": { "type": "string", "format": "date-time" }
-          }
-        },
-        {
-          "type": "object",
-          "required": ["approvalId", "decision", "decidedAt"],
-          "additionalProperties": false,
-          "properties": {
-            "approvalId": { "type": "string", "minLength": 1 },
-            "decision": { "enum": ["approve", "reject"] },
-            "decidedAt": { "type": "string", "format": "date-time" },
-            "actor": { "type": "string", "minLength": 1 },
-            "note": { "type": "string" }
-          }
-        }
-      ]
-    },
-    "data": { "type": "object", "additionalProperties": true }
-  }
-}

package/schemas/runtime-run.schema.json

@@ -1,58 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-skills.dev/schemas/runtime-run.schema.json",
-  "title": "Agent Kit Runtime Run",
-  "type": "object",
-  "required": ["schemaVersion", "runId", "workflowId", "goal", "status", "createdAt", "updatedAt", "sourceRoot", "baseCommit", "results"],
-  "additionalProperties": false,
-  "properties": {
-    "schemaVersion": { "const": 1 },
-    "runId": { "type": "string", "pattern": "^[a-zA-Z0-9_-]+$" },
-    "workflowId": { "type": "string", "minLength": 1 },
-    "goal": { "type": "string", "minLength": 1 },
-    "status": { "$ref": "#/$defs/status" },
-    "createdAt": { "type": "string", "format": "date-time" },
-    "updatedAt": { "type": "string", "format": "date-time" },
-    "sourceRoot": { "type": "string", "minLength": 1 },
-    "baseCommit": { "type": "string", "minLength": 1 },
-    "worktreePath": { "type": "string", "minLength": 1 },
-    "branchName": { "type": "string", "minLength": 1 },
-    "activeAgentId": { "type": "string", "minLength": 1 },
-    "pendingApproval": { "$ref": "#/$defs/approvalRequest" },
-    "commit": { "type": "string", "minLength": 1 },
-    "changed": { "type": "string" },
-    "results": { "type": "array", "items": { "$ref": "#/$defs/agentResult" } },
-    "error": { "type": "string" }
-  },
-  "$defs": {
-    "status": { "enum": ["planned", "running", "awaiting-approval", "blocked", "cancelled", "failed", "complete"] },
-    "risk": { "enum": ["plan", "write", "network", "secret", "destructive", "host-mutation", "final-commit"] },
-    "approvalRequest": {
-      "type": "object",
-      "required": ["approvalId", "runId", "risk", "title", "detail", "requestedAt"],
-      "additionalProperties": false,
-      "properties": {
-        "approvalId": { "type": "string", "minLength": 1 },
-        "runId": { "type": "string", "minLength": 1 },
-        "risk": { "$ref": "#/$defs/risk" },
-        "title": { "type": "string", "minLength": 1 },
-        "detail": { "type": "string" },
-        "requestedAt": { "type": "string", "format": "date-time" }
-      }
-    },
-    "agentResult": {
-      "type": "object",
-      "required": ["agentId", "summary", "decision", "risk", "artifacts", "verification"],
-      "additionalProperties": false,
-      "properties": {
-        "agentId": { "type": "string", "minLength": 1 },
-        "summary": { "type": "string" },
-        "decision": { "type": "string" },
-        "risk": { "type": "string" },
-        "artifacts": { "type": "array", "items": { "type": "string" } },
-        "verification": { "type": "array", "items": { "type": "string" } },
-        "requestedHandoff": { "type": "string", "minLength": 1 }
-      }
-    }
-  }
-}

package/schemas/session-event.schema.json

@@ -1,48 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-skills.dev/schemas/session-event.schema.json",
-  "title": "Agent Kit Session Event",
-  "type": "object",
-  "required": ["type", "createdAt"],
-  "additionalProperties": false,
-  "properties": {
-    "eventId": { "type": "string", "format": "uuid" },
-    "sequence": { "type": "integer", "minimum": 1 },
-    "type": {
-      "type": "string",
-      "enum": [
-        "session_started",
-        "project_context_loaded",
-        "agent_message",
-        "agent_decision",
-        "handoff",
-        "human_correction",
-        "correction_promoted",
-        "artifact_recorded",
-        "command_recorded",
-        "verification_recorded",
-        "open_question",
-        "required_output_updated",
-        "session_status_changed",
-        "session_rendered"
-      ]
-    },
-    "createdAt": { "type": "string", "format": "date-time" },
-    "agentId": { "type": "string", "minLength": 1 },
-    "fromAgentId": { "type": "string", "minLength": 1 },
-    "toAgentId": { "type": "string", "minLength": 1 },
-    "text": { "type": "string" },
-    "decision": { "type": "string" },
-    "risk": { "type": "string" },
-    "evidence": { "type": "array", "items": { "type": "string" } },
-    "scope": { "type": "string", "enum": ["session", "project", "agent", "upstream-proposal"] },
-    "correctionId": { "type": "string", "minLength": 1 },
-    "artifactPath": { "type": "string", "minLength": 1 },
-    "command": { "type": "string", "minLength": 1 },
-    "result": { "type": "string", "enum": ["pass", "fail", "skipped"] },
-    "outputName": { "type": "string", "minLength": 1 },
-    "outputStatus": { "type": "string", "enum": ["missing", "partial", "complete", "not-applicable"] },
-    "status": { "type": "string", "enum": ["planned", "in-progress", "blocked", "complete"] },
-    "notes": { "type": "string" }
-  }
-}

package/schemas/studio-session.schema.json

@@ -1,48 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-skills.dev/schemas/studio-session.schema.json",
-  "title": "Agent Kit Studio Session",
-  "type": "object",
-  "required": [
-    "schemaVersion",
-    "sessionId",
-    "title",
-    "createdAt",
-    "updatedAt",
-    "status",
-    "workflowId",
-    "request",
-    "affectedLayers",
-    "qualityTarget",
-    "requiredOutputs"
-  ],
-  "additionalProperties": false,
-  "properties": {
-    "schemaVersion": { "const": 1 },
-    "sessionId": { "type": "string", "minLength": 1 },
-    "title": { "type": "string", "minLength": 1 },
-    "createdAt": { "type": "string", "format": "date-time" },
-    "updatedAt": { "type": "string", "format": "date-time" },
-    "status": { "type": "string", "enum": ["planned", "in-progress", "blocked", "complete"] },
-    "workflowId": { "type": "string", "minLength": 1 },
-    "request": { "type": "string", "minLength": 1 },
-    "affectedLayers": { "type": "array", "items": { "type": "string" } },
-    "activeAgentId": { "type": "string" },
-    "nextAgentId": { "type": "string" },
-    "qualityTarget": { "type": "string", "enum": ["baseline-setup", "needs-improvement", "best-practice-candidate"] },
-    "requiredOutputs": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["name", "status"],
-        "additionalProperties": false,
-        "properties": {
-          "name": { "type": "string", "minLength": 1 },
-          "status": { "type": "string", "enum": ["missing", "partial", "complete", "not-applicable"] },
-          "evidence": { "type": "string" }
-        }
-      }
-    },
-    "renderedAt": { "type": "string", "format": "date-time" }
-  }
-}

package/skills/accessibility-wcag.md

@@ -1,15 +0,0 @@
-# Accessibility WCAG Skill
-
-## Use When
-
-Working on navigation, forms, modals, menus, tables, dashboards, custom controls, or interactive states.
-
-## Checklist
-
-- Semantic HTML is used where possible.
-- ARIA is used only when needed.
-- Keyboard navigation works.
-- Focus states are visible.
-- Color contrast meets WCAG 2.1 AA.
-- Forms have labels and clear error messages.
-- Motion is not required to understand the UI.

package/skills/agent-handoff-tracing.md

@@ -1,44 +0,0 @@
-# Agent Handoff Tracing Skill
-
-## Use When
-
-Planning, routing, reviewing, or completing work that involves more than one agent role, touches a core workflow, or needs auditable council evidence.
-
-## Goal
-
-Make agent collaboration inspectable. Every meaningful handoff should state who owns the next step, what was decided, what risk remains, and what evidence proves the required outputs.
-
-## Required Checks
-
-- Select the workflow from `.agent-kit/agent-roster.json`.
-- Read `.agent-kit/project-context.json` and `.agent-kit/project-context.md` when present.
-- Read active project and agent correction rules from `.agent-kit/corrections/` before making or reviewing decisions.
-- Confirm the workflow sequence and council members before implementation.
-- Record each agent handoff with decision, risk, next handoff, and evidence.
-- Confirm required outputs are missing, partial, complete, or not applicable.
-- Use `agent-kit session start`, `decision`, `handoff`, `correct`, `artifact`, `verify`, `render`, and `close` for local Agent Studio traces when available.
-- Use `COUNCIL.md` for human-readable notes and schema-backed `.agent-kit/council-sessions/` records when CLI tooling is unavailable.
-- Run `agent-kit audit` after adding structured session records.
-- Run `agent-kit session render` after changing session evidence so `index.md` and `transcript.md` are current.
-- Run `agent-kit studio export` when a self-contained local HTML session view would help the user inspect handoffs and transcript streams.
-- Do not mark a council session complete until required outputs and verification evidence are present.
-
-## Reject By Default
-
-- Specialist agents acting without Planner routing on ambiguous or cross-layer work.
-- Core changes that skip Lead Architect.
-- Security-sensitive work that skips Security Reviewer.
-- Behavior changes that skip QA evidence.
-- Handoffs with only a summary and no risk, next owner, or evidence.
-- Continuing after a user correction without recording the correction and deciding whether it should become a durable project or agent rule.
-
-## Review Output
-
-Return:
-
-- Workflow selected.
-- Agents required and agents actually involved.
-- Missing handoffs or missing required outputs.
-- Evidence that proves completion.
-- Recommended next handoff.
-- Agent Studio session path or rendered Markdown evidence when available.

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

@@ -1,26 +0,0 @@
-# Best-Practice Maturity Review
-
-Use this skill when deciding whether a project, feature, release, or repository setup is baseline, strong, or best-practice ready.
-
-## Required Inputs
-
-- Current request, roadmap item, or release scope.
-- `QUALITY_GATES.md`.
-- Relevant `SPEC.md`, `DECISIONS.md`, `SECURITY.md`, `DESIGN.md`, `TESTING.md`, and `DEPLOYMENT.md` sections.
-- Current council workflow from `.agent-kit/agent-roster.json`.
-
-## Review Steps
-
-1. Classify the target maturity level: baseline, strong, or best-practice.
-2. Map affected areas: council, architecture, Supabase/RLS, security, frontend, accessibility, testing, release, docs, and repo health.
-3. Name the evidence required for each affected area.
-4. Treat missing evidence as incomplete, not as a pass with caveats.
-5. Promote repeated research or dogfood findings into templates, skills, checklists, audit checks, tests, release gates, or `DECISIONS.md`.
-
-## Output
-
-- Maturity level claimed.
-- Missing evidence by area.
-- Required council handoffs.
-- Verification commands or artifacts.
-- Docs that must be updated before the work is considered done.

package/skills/content-first-design.md

@@ -1,50 +0,0 @@
-# Content-First Design Skill
-
-## Use When
-
-Building or reviewing any user-facing site, product screen, landing page, dashboard, tool, admin workflow, marketplace, content experience, ecommerce flow, portfolio, venue page, community surface, education product, or AI workflow UI.
-
-## Goal
-
-Prevent generic output by making the interface derive from the product's real audience, content, workflows, brand constraints, and category context before visual styling or component assembly starts.
-
-## Required Inputs
-
-Collect or infer these before implementation:
-
-- Primary audience and their user needs.
-- Real content inventory: nouns, labels, record types, data fields, assets, examples, and domain language.
-- Product category and expected workflow density.
-- Brand personality, existing visual constraints, and accessibility constraints.
-- Competitive or category references to learn from without copying.
-- Non-goals: patterns, phrases, palettes, layouts, or tropes to avoid.
-
-## Required Design Work
-
-- Fill or update `DESIGN.md`.
-- Produce at least two distinct creative directions before choosing one.
-- Record a reference set, anti-references, source-safety notes, and a design critique verdict before acceptance.
-- Score significant frontend work with the frontend product-quality rubric before acceptance.
-- Map first-screen hierarchy to the user's primary task, object, or workflow.
-- Define how tokens, imagery, density, and copy support the chosen direction.
-- Identify missing real content or assets before substituting placeholders.
-
-## Reject By Default
-
-- Styling before content and workflow are understood.
-- Generic SaaS headings, fake metrics, abstract gradient backgrounds, and card-heavy filler.
-- Interfaces whose first screen could apply to any product in the category.
-- Visual directions with no link to audience, content, or domain.
-- Placeholder screenshots accepted as final evidence.
-
-## Review Output
-
-Return:
-
-- Missing content, audience, or brand inputs.
-- The selected creative direction and why it fits.
-- The reference-led critique verdict and any remaining generic-design risks.
-- The product-quality scorecard verdict and any critical zeroes.
-- Which visible details make the design specific to this product.
-- Which assets, copy, or data examples are still missing.
-- Whether `DESIGN.md`, `STYLE_GUIDE.md`, and screenshot evidence are sufficient for acceptance.

package/skills/conversion-copywriting.md

@@ -1,38 +0,0 @@
-# Conversion Copywriting Skill
-
-## Use When
-
-Writing or reviewing copy for landing pages, signup flows, pricing pages, checkout paths, demos, waitlists, product-led onboarding, upgrade prompts, or conversion-critical CTAs.
-
-## Goal
-
-Make each conversion surface clear, truthful, specific, and aligned to the user's stage of intent.
-
-## Required Inputs
-
-- Audience segment and awareness level.
-- Conversion goal and next action.
-- User pain, desired outcome, and urgency.
-- Product differentiator and proof.
-- Objections, risks, or trust concerns.
-- Constraints: legal, compliance, pricing, availability, region, or support limits.
-
-## Required Work
-
-- Map the page or flow to one primary action and one acceptable secondary action.
-- Match headline, subhead, proof, and CTA to the same value proposition.
-- Add trust-building copy only when the proof exists.
-- Make risk, limitations, and eligibility clear near the relevant action.
-- Use concrete product nouns, workflow language, and customer language from `MESSAGING.md`.
-- Review microcopy around forms, errors, payment, confirmation, and cancellation.
-
-## Reject By Default
-
-- Multiple competing CTAs with no hierarchy.
-- Broad benefit claims without proof or product specificity.
-- Copy that creates legal, pricing, privacy, medical, financial, or compliance risk.
-- Dark patterns, hidden conditions, forced urgency, or unclear cancellation language.
-
-## Review Output
-
-Return conversion goal, primary/secondary CTA, page hierarchy, proof used, objections handled, risky claims, missing evidence, and test ideas.

package/skills/deployment-observability.md

@@ -1,14 +0,0 @@
-# Deployment And Observability Skill
-
-## Use When
-
-Working on deployments, env vars, migrations, cron jobs, logs, production incidents, monitoring, or rollback.
-
-## Checklist
-
-- Required env vars are documented.
-- Server-only secrets are isolated.
-- Migration and app deploy order is clear.
-- Smoke checks are defined.
-- Logs expose operational failures without leaking secrets.
-- Rollback steps are documented.

package/skills/docs-maintainer.md

@@ -1,19 +0,0 @@
-# Documentation Maintainer Skill
-
-## Use When
-
-Any meaningful behavior, architecture, security, workflow, testing, deployment, or design standard changes.
-
-## Checklist
-
-- `SPEC.md` reflects current system behavior.
-- `DECISIONS.md` records important tradeoffs.
-- `DOCS.md` explains setup and workflows.
-- `COUNCIL.md` records meaningful agent handoffs, required outputs, evidence, and verification status.
-- `QUALITY_GATES.md` reflects maturity target and evidence expectations.
-- `DESIGN.md` reflects brand/content, reference-led critique, and creative-direction changes.
-- `STYLE_GUIDE.md` reflects code and design patterns.
-- `SECURITY.md` reflects current threat model and auth boundaries.
-- `TESTING.md` reflects current coverage and gaps.
-- `DEPLOYMENT.md` reflects release and rollback steps.
-- `UPGRADE.md` reflects version, migration, rollback, and package-update evidence.

package/skills/frontend-design-system.md

@@ -1,68 +0,0 @@
-# Frontend Design System Skill
-
-## Use When
-
-Building or reviewing any user-facing screen, page, component, app shell, dashboard, admin view, onboarding flow, or marketing surface.
-
-## Goal
-
-Create interfaces that are domain-specific, accessible, polished, and useful. Avoid the common AI-generated look.
-
-## Reject By Default
-
-- Generic purple-blue gradient heroes.
-- Vague SaaS value props.
-- Fake dashboard metrics.
-- Floating card soup.
-- Oversized rounded panels without workflow purpose.
-- Placeholder landing pages when the user asked for an app or tool.
-- One-note color palettes.
-- Styling that starts before content, audience, and workflow are understood.
-
-## Prefer
-
-- Task-first product screens.
-- Domain-specific information architecture.
-- Reusable design tokens.
-- A documented component and state inventory.
-- Clear density rules.
-- Accessible forms and controls.
-- Real loading, empty, error, disabled, and success states.
-- Mobile-first layouts.
-- Visual direction that fits the product category.
-- A chosen creative direction that is visible in tokens, layout, copy, imagery, and interaction tone.
-
-## Design Adapter Trigger
-
-Use a provider-neutral design adapter and the matching `design-briefs/*` file when:
-
-- The screen risks looking generic.
-- The product category needs stronger visual direction.
-- The workflow is unclear.
-- A high-stakes UI needs external review.
-
-Use `prompts/screenshot-review.md` after implementation when desktop and mobile screenshots exist.
-
-Use `skills/content-first-design.md`, `prompts/brand-content-intake.md`, and `prompts/creative-direction-matrix.md` before implementation when the product, audience, content, brand, or visual direction is under-specified.
-
-Use `skills/reference-led-design-critique.md` and `prompts/design-critique-gate.md` before accepting significant frontend work, especially when the screen could still look generic despite having tokens, states, and screenshots.
-
-Use `skills/frontend-product-quality-rubric.md` and `prompts/frontend-product-quality-scorecard.md` before accepting significant frontend work. The scorecard must reject work when the product task, content specificity, accessibility, or source safety is weak, even if the UI looks polished.
-
-Use `skills/frontend-distinctiveness-benchmark.md` and `prompts/frontend-distinctiveness-benchmark.md` before accepting significant frontend work that could still be interchangeable with another product in the same category. The benchmark must prove first-screen specificity, content fingerprint, safe reference learning, asset provenance, state proof, and visual QA evidence.
-
-## Review Output
-
-Return:
-
-- What looks generic or under-specified.
-- Which brand, content, audience, or creative-direction inputs are missing.
-- Which reference-set, anti-reference, source-safety, or distinctiveness evidence is missing.
-- Which design tokens are missing.
-- Which component states are missing.
-- Which accessibility risks remain.
-- Which provider-neutral design brief should be used next, if any.
-- Which screenshot evidence is still needed before the UI can be accepted.
-- Which visual-regression or component-state evidence is needed before release.
-- Which product-quality scorecard dimensions failed and what must improve before acceptance.
-- Which distinctiveness benchmark evidence is missing before the UI can be accepted as product-specific.

package/skills/frontend-distinctiveness-benchmark.md

@@ -1,40 +0,0 @@
-# Frontend Distinctiveness Benchmark Skill
-
-## Use When
-
-Planning, building, or accepting any meaningful user-facing screen where the product could drift into generic AI-site output despite having clean components, tokens, or screenshots.
-
-## Goal
-
-Prove that the interface belongs to this product, this audience, and this workflow. The design should be grounded in real content and safe reference learning before visual polish is accepted.
-
-## Required Evidence
-
-- First-screen proof: the first viewport shows the real product object, task, workflow, content, or decision.
-- Content fingerprint: product nouns, labels, data shapes, records, actions, and edge cases are visible in the UI or documented in `DESIGN.md`.
-- Reference benchmark: 3-5 relevant references name lessons to learn and 2-3 anti-references name tropes to avoid.
-- Source-safety notes: no copied brand marks, protected layouts, proprietary assets, exact copy, or visual signatures.
-- Creative divergence: at least two plausible directions were compared before one was chosen.
-- State proof: important loading, empty, error, disabled, success, permission, and focus states are designed or captured.
-- Asset provenance: real, generated, licensed, or placeholder assets are identified with usage constraints.
-- Visual QA proof: desktop, mobile, and high-risk state evidence exists for the change risk.
-
-## Reject By Default
-
-- The first screen could be reused for another product in the same category by changing only the logo or headline.
-- The interface uses fake metrics, generic dashboard cards, vague SaaS copy, abstract gradient decoration, or stock-like imagery to hide missing product decisions.
-- References are copied instead of translated into generalized lessons.
-- Product-specific content is postponed until after styling.
-- A scorecard passes while first-screen proof, content fingerprint, source safety, or visual QA evidence is missing.
-
-## Review Output
-
-Return:
-
-- First-screen proof verdict: missing, adequate, or strong.
-- Content fingerprint verdict: missing, adequate, or strong.
-- Reference benchmark verdict: missing, adequate, or strong.
-- Source-safety and asset-provenance risks.
-- Generic-AI-site risk after review.
-- Required changes before implementation or acceptance.
-- Evidence still needed for best-practice frontend status.