@appsforgood/next-supabase-kit 0.3.0 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +9 -0
- package/README.md +22 -555
- package/UPGRADE.md +11 -77
- package/USER_GUIDE.md +181 -0
- package/agents/app-engineer/agent.md +32 -0
- package/agents/copy/agent.md +27 -0
- package/agents/design/agent.md +27 -0
- package/agents/optional/deploy/agent.md +12 -0
- package/agents/optional/docs/agent.md +12 -0
- package/agents/optional/lead-architect/agent.md +12 -0
- package/agents/optional/research/agent.md +12 -0
- package/agents/planner/agent.md +29 -0
- package/agents/qa/agent.md +35 -0
- package/agents/security/agent.md +28 -0
- package/assistant-adapters/cursor-agent-kit.mdc +5 -26
- package/catalog.json +20 -0
- package/dist/index.js +892 -8251
- package/dist/index.js.map +1 -1
- package/examples/next-supabase-installed/.agent-kit/config.json +22 -26
- package/examples/next-supabase-installed/.agent-kit/manifest.json +78 -222
- package/examples/next-supabase-installed/.antigravity/agent-kit/commands/browser-qa.toml +6 -0
- package/examples/next-supabase-installed/.antigravity/agent-kit/commands/copy.toml +6 -0
- package/examples/next-supabase-installed/.antigravity/agent-kit/commands/frontend.toml +6 -0
- package/examples/next-supabase-installed/.antigravity/agent-kit/commands/plan.toml +6 -0
- package/examples/next-supabase-installed/.antigravity/agent-kit/commands/security.toml +6 -0
- package/examples/next-supabase-installed/.antigravity/agent-kit/commands/ship.toml +6 -0
- package/examples/next-supabase-installed/.antigravity/agent-kit/commands/test.toml +6 -0
- package/examples/next-supabase-installed/.antigravity/agent-kit/plugin.json +12 -0
- package/examples/next-supabase-installed/.antigravity/runtime-skills/accessibility-wcag/SKILL.md +26 -0
- package/examples/next-supabase-installed/.antigravity/runtime-skills/browser-qa/SKILL.md +67 -0
- package/examples/next-supabase-installed/.antigravity/runtime-skills/frontend-design/SKILL.md +26 -0
- package/examples/next-supabase-installed/.antigravity/runtime-skills/nextjs-app-router/SKILL.md +23 -0
- package/examples/next-supabase-installed/.antigravity/runtime-skills/owasp-security-review/SKILL.md +23 -0
- package/examples/next-supabase-installed/.antigravity/runtime-skills/planning/SKILL.md +25 -0
- package/examples/next-supabase-installed/.antigravity/runtime-skills/postgres-migrations/SKILL.md +21 -0
- package/examples/next-supabase-installed/.antigravity/runtime-skills/product-copy/SKILL.md +22 -0
- package/examples/next-supabase-installed/.antigravity/runtime-skills/ship/SKILL.md +22 -0
- package/examples/next-supabase-installed/.antigravity/runtime-skills/supabase-auth-rls/SKILL.md +23 -0
- package/examples/next-supabase-installed/.antigravity/runtime-skills/testing-qa/SKILL.md +27 -0
- package/examples/next-supabase-installed/.claude/agents/app-engineer.md +32 -0
- package/examples/next-supabase-installed/.claude/agents/copy.md +27 -0
- package/examples/next-supabase-installed/.claude/agents/design.md +27 -0
- package/examples/next-supabase-installed/.claude/agents/planner.md +29 -0
- package/examples/next-supabase-installed/.claude/agents/qa.md +35 -0
- package/examples/next-supabase-installed/.claude/agents/security.md +28 -0
- package/examples/next-supabase-installed/.codex/agents/app-engineer.toml +39 -0
- package/examples/next-supabase-installed/.codex/agents/copy.toml +34 -0
- package/examples/next-supabase-installed/.codex/agents/design.toml +34 -0
- package/examples/next-supabase-installed/.codex/agents/planner.toml +36 -0
- package/examples/next-supabase-installed/.codex/agents/qa.toml +42 -0
- package/examples/next-supabase-installed/.codex/agents/security.toml +35 -0
- package/examples/next-supabase-installed/.cursor/agents/app-engineer.md +32 -0
- package/examples/next-supabase-installed/.cursor/agents/copy.md +27 -0
- package/examples/next-supabase-installed/.cursor/agents/design.md +27 -0
- package/examples/next-supabase-installed/.cursor/agents/planner.md +29 -0
- package/examples/next-supabase-installed/.cursor/agents/qa.md +35 -0
- package/examples/next-supabase-installed/.cursor/agents/security.md +28 -0
- package/examples/next-supabase-installed/.cursor/rules/cursor-agent-kit.mdc +12 -0
- package/examples/next-supabase-installed/.cursor/skills/accessibility-wcag/SKILL.md +26 -0
- package/examples/next-supabase-installed/.cursor/skills/browser-qa/SKILL.md +67 -0
- package/examples/next-supabase-installed/.cursor/skills/frontend-design/SKILL.md +26 -0
- package/examples/next-supabase-installed/.cursor/skills/nextjs-app-router/SKILL.md +23 -0
- package/examples/next-supabase-installed/.cursor/skills/owasp-security-review/SKILL.md +23 -0
- package/examples/next-supabase-installed/.cursor/skills/planning/SKILL.md +25 -0
- package/examples/next-supabase-installed/.cursor/skills/postgres-migrations/SKILL.md +21 -0
- package/examples/next-supabase-installed/.cursor/skills/product-copy/SKILL.md +22 -0
- package/examples/next-supabase-installed/.cursor/skills/ship/SKILL.md +22 -0
- package/examples/next-supabase-installed/.cursor/skills/supabase-auth-rls/SKILL.md +23 -0
- package/examples/next-supabase-installed/.cursor/skills/testing-qa/SKILL.md +27 -0
- package/examples/next-supabase-installed/.github/copilot-instructions.md +23 -0
- package/examples/next-supabase-installed/AGENTS.md +30 -0
- package/examples/next-supabase-installed/CLAUDE.md +7 -0
- package/examples/next-supabase-installed/README.md +2 -14
- package/examples/next-supabase-installed/USER_GUIDE.md +181 -0
- package/examples/next-supabase-installed/skills/accessibility-wcag/SKILL.md +26 -0
- package/examples/next-supabase-installed/skills/browser-qa/SKILL.md +67 -0
- package/examples/next-supabase-installed/skills/frontend-design/SKILL.md +26 -0
- package/examples/next-supabase-installed/skills/nextjs-app-router/SKILL.md +23 -0
- package/examples/next-supabase-installed/skills/owasp-security-review/SKILL.md +23 -0
- package/examples/next-supabase-installed/skills/planning/SKILL.md +25 -0
- package/examples/next-supabase-installed/skills/postgres-migrations/SKILL.md +21 -0
- package/examples/next-supabase-installed/skills/product-copy/SKILL.md +22 -0
- package/examples/next-supabase-installed/skills/ship/SKILL.md +22 -0
- package/examples/next-supabase-installed/skills/supabase-auth-rls/SKILL.md +23 -0
- package/examples/next-supabase-installed/skills/testing-qa/SKILL.md +27 -0
- package/examples/next-supabase-installed/tree.txt +57 -42
- package/package.json +15 -43
- package/research/agent-skill-gap-report.md +128 -0
- package/skills/accessibility-wcag/SKILL.md +26 -0
- package/skills/browser-qa/SKILL.md +67 -0
- package/skills/frontend-design/SKILL.md +26 -0
- package/skills/nextjs-app-router/SKILL.md +23 -0
- package/skills/optional/debug/SKILL.md +11 -0
- package/skills/optional/docs/SKILL.md +10 -0
- package/skills/optional/ui-polish/SKILL.md +10 -0
- package/skills/optional/upgrade/SKILL.md +10 -0
- package/skills/owasp-security-review/SKILL.md +23 -0
- package/skills/planning/SKILL.md +25 -0
- package/skills/postgres-migrations/SKILL.md +21 -0
- package/skills/product-copy/SKILL.md +22 -0
- package/skills/ship/SKILL.md +22 -0
- package/skills/supabase-auth-rls/SKILL.md +23 -0
- package/skills/testing-qa/SKILL.md +27 -0
- package/templates/next-supabase/AGENTS.md +19 -129
- package/templates/next-supabase/CLAUDE.md +4 -36
- package/BEST_PRACTICE_EVIDENCE.md +0 -45
- package/DOGFOOD.md +0 -201
- package/GOVERNANCE.md +0 -45
- package/LOOP_CODING.md +0 -107
- package/MAINTAINER_RELEASE.md +0 -100
- package/REPOSITORY_SETTINGS.md +0 -83
- package/RESEARCH_CITATION_POLICY.md +0 -26
- package/SUPPLY_CHAIN.md +0 -57
- package/agents/deployment-observability-engineer.md +0 -13
- package/agents/docs-maintainer.md +0 -17
- package/agents/frontend-design-lead.md +0 -22
- package/agents/lead-architect.md +0 -25
- package/agents/marketing-copy-lead.md +0 -20
- package/agents/nextjs-engineer.md +0 -20
- package/agents/planner.md +0 -20
- package/agents/qa-engineer.md +0 -19
- package/agents/research-analyst.md +0 -13
- package/agents/security-reviewer.md +0 -16
- package/agents/supabase-postgres-engineer.md +0 -19
- package/antigravity/commands/accessibility-pass.toml +0 -16
- package/antigravity/commands/audit.toml +0 -16
- package/antigravity/commands/browser-qa.toml +0 -18
- package/antigravity/commands/copy.toml +0 -16
- package/antigravity/commands/distinctiveness-pass.toml +0 -16
- package/antigravity/commands/frontend.toml +0 -18
- package/antigravity/commands/handoff.toml +0 -16
- package/antigravity/commands/layout-cleanup.toml +0 -16
- package/antigravity/commands/plan.toml +0 -18
- package/antigravity/commands/responsive-cleanup.toml +0 -16
- package/antigravity/commands/review.toml +0 -16
- package/antigravity/commands/screenshot-critique.toml +0 -16
- package/antigravity/commands/security.toml +0 -16
- package/antigravity/commands/setup.toml +0 -16
- package/antigravity/commands/ship.toml +0 -17
- package/antigravity/commands/spec.toml +0 -17
- package/antigravity/commands/test.toml +0 -17
- package/antigravity/commands/ui-audit.toml +0 -17
- package/antigravity/commands/ui-polish.toml +0 -17
- package/antigravity/commands/upgrade.toml +0 -17
- package/antigravity/plugin.json +0 -70
- package/assistant-adapters/antigravity.md +0 -65
- package/assistant-adapters/claude-code-subagents.md +0 -38
- package/assistant-adapters/codex-agents.md +0 -53
- package/assistant-adapters/cursor-frontend.mdc +0 -16
- package/assistant-adapters/cursor-planner.mdc +0 -14
- package/assistant-adapters/cursor-security.mdc +0 -18
- package/assistant-adapters/github-copilot-instructions.md +0 -35
- package/assistant-adapters/github-next-supabase.instructions.md +0 -28
- package/assistant-adapters/model-selection/claude-code-subagents-with-models.md +0 -32
- package/assistant-adapters/model-selection/codex-config.example.toml +0 -32
- package/assistant-adapters/model-selection/cursor-model-selection.mdc +0 -24
- package/assistant-adapters/model-selection/github-copilot-model-selection.md +0 -20
- package/assistant-adapters/orchestrator-runtime.md +0 -39
- package/checklists/accessibility.md +0 -12
- package/checklists/agent-council.md +0 -13
- package/checklists/brand-content.md +0 -15
- package/checklists/deployment.md +0 -10
- package/checklists/design-critique.md +0 -13
- package/checklists/frontend-distinctiveness.md +0 -12
- package/checklists/frontend-product-quality.md +0 -13
- package/checklists/frontend-quality.md +0 -21
- package/checklists/marketing-copy.md +0 -11
- package/checklists/owasp.md +0 -12
- package/checklists/rls.md +0 -10
- package/checklists/testing.md +0 -12
- package/checklists/ui-acceptance-rubric.md +0 -58
- package/checklists/ui-detectors.md +0 -81
- package/checklists/upgrade.md +0 -13
- package/checklists/visual-regression.md +0 -11
- package/design-adapters/claude-design.prompt.md +0 -27
- package/design-adapters/figma.prompt.md +0 -18
- package/design-adapters/google-stitch.prompt.md +0 -36
- package/design-adapters/human-designer-brief.prompt.md +0 -36
- package/design-briefs/admin-dashboard.md +0 -21
- package/design-briefs/ai-workflow-product.md +0 -25
- package/design-briefs/community-social.md +0 -26
- package/design-briefs/content-app.md +0 -21
- package/design-briefs/ecommerce.md +0 -25
- package/design-briefs/education-course.md +0 -25
- package/design-briefs/marketplace.md +0 -21
- package/design-briefs/portfolio-venue.md +0 -25
- package/design-briefs/saas.md +0 -21
- package/design-briefs/tool.md +0 -21
- package/examples/next-supabase-installed/.agent-kit/agent-roster.json +0 -267
- package/examples/next-supabase-installed/.agent-kit/model-routing.json +0 -171
- package/examples/next-supabase-installed/.agent-kit/overrides.json +0 -3
- package/examples/next-supabase-installed/audit-output.json +0 -405
- package/model-routing/default-model-routing.json +0 -171
- package/profiles/admin-app.md +0 -17
- package/profiles/content-app.md +0 -17
- package/profiles/marketplace.md +0 -17
- package/profiles/saas.md +0 -17
- package/profiles/stack-next-firebase.md +0 -25
- package/profiles/stack-next-postgres.md +0 -24
- package/profiles/stack-remix-supabase.md +0 -24
- package/prompts/audit-project-setup.md +0 -28
- package/prompts/brand-content-intake.md +0 -17
- package/prompts/copy-review.md +0 -15
- package/prompts/council-session-review.md +0 -17
- package/prompts/creative-direction-matrix.md +0 -22
- package/prompts/design-critique-gate.md +0 -28
- package/prompts/docs-update.md +0 -16
- package/prompts/frontend-design-review.md +0 -35
- package/prompts/frontend-distinctiveness-benchmark.md +0 -32
- package/prompts/frontend-product-quality-scorecard.md +0 -35
- package/prompts/implement-feature.md +0 -14
- package/prompts/lifecycle-command-index.md +0 -180
- package/prompts/migration-review.md +0 -14
- package/prompts/screenshot-review.md +0 -28
- package/prompts/security-review.md +0 -17
- package/prompts/ui-command-index.md +0 -124
- package/prompts/upgrade-review.md +0 -18
- package/prompts/visual-qa-plan.md +0 -16
- package/research/proposed-updates.md +0 -70
- package/research/scan-config.json +0 -261
- package/research/scan-plan.md +0 -24
- package/research/summaries/.gitkeep +0 -1
- package/research/summaries/agent-workflow-patterns.md +0 -37
- package/research/summaries/agentic-engineering-maturity-levels.md +0 -54
- package/research/summaries/creative-design-patterns.md +0 -38
- package/research/summaries/design-critique-patterns.md +0 -34
- package/research/summaries/docs-and-agent-patterns.md +0 -64
- package/research/summaries/dogfood-adoption-patterns.md +0 -33
- package/research/summaries/frontend-design-patterns.md +0 -64
- package/research/summaries/frontend-distinctiveness-benchmark-patterns.md +0 -38
- package/research/summaries/frontend-product-quality-rubric-patterns.md +0 -37
- package/research/summaries/maturity-model-patterns.md +0 -29
- package/research/summaries/nextjs-patterns.md +0 -65
- package/research/summaries/repo-health-patterns.md +0 -41
- package/research/summaries/scan-overview.md +0 -46
- package/research/summaries/security-patterns.md +0 -64
- package/research/summaries/supabase-rls-patterns.md +0 -54
- package/research/summaries/supply-chain-patterns.md +0 -38
- package/research/summaries/testing-patterns.md +0 -63
- package/research/summaries/upgrade-lifecycle-patterns.md +0 -26
- package/research/summaries/visual-qa-patterns.md +0 -39
- package/rosters/next-supabase-default-council.json +0 -267
- package/runtime-skills/README.md +0 -7
- package/runtime-skills/accessibility-wcag/SKILL.md +0 -8
- package/runtime-skills/agent-handoff-tracing/SKILL.md +0 -8
- package/runtime-skills/best-practice-maturity-review/SKILL.md +0 -8
- package/runtime-skills/content-first-design/SKILL.md +0 -8
- package/runtime-skills/conversion-copywriting/SKILL.md +0 -8
- package/runtime-skills/deployment-observability/SKILL.md +0 -8
- package/runtime-skills/docs-maintainer/SKILL.md +0 -8
- package/runtime-skills/frontend-design-system/SKILL.md +0 -8
- package/runtime-skills/frontend-distinctiveness-benchmark/SKILL.md +0 -8
- package/runtime-skills/frontend-product-quality-rubric/SKILL.md +0 -8
- package/runtime-skills/landing-page-copy/SKILL.md +0 -8
- package/runtime-skills/nextjs-app-router/SKILL.md +0 -8
- package/runtime-skills/onboarding-empty-state-copy/SKILL.md +0 -8
- package/runtime-skills/owasp-security-review/SKILL.md +0 -8
- package/runtime-skills/planning-council/SKILL.md +0 -8
- package/runtime-skills/positioning-messaging/SKILL.md +0 -8
- package/runtime-skills/postgres-migrations/SKILL.md +0 -8
- package/runtime-skills/product-voice-tone/SKILL.md +0 -8
- package/runtime-skills/reference-led-design-critique/SKILL.md +0 -8
- package/runtime-skills/supabase-auth-rls/SKILL.md +0 -8
- package/runtime-skills/testing-qa/SKILL.md +0 -8
- package/runtime-skills/ui-improvement-harness/SKILL.md +0 -12
- package/runtime-skills/upgrade-maintenance/SKILL.md +0 -8
- package/runtime-skills/visual-regression-qa/SKILL.md +0 -8
- package/schemas/agent-roster.schema.json +0 -54
- package/schemas/agentic-level.schema.json +0 -47
- package/schemas/audit-report-v2.schema.json +0 -71
- package/schemas/audit-report.schema.json +0 -50
- package/schemas/correction-rules.schema.json +0 -32
- package/schemas/council-session.schema.json +0 -65
- package/schemas/model-routing.schema.json +0 -72
- package/schemas/onboarding-state.schema.json +0 -36
- package/schemas/orchestrator.schema.json +0 -167
- package/schemas/project-context.schema.json +0 -94
- package/schemas/runtime-event.schema.json +0 -66
- package/schemas/runtime-run.schema.json +0 -58
- package/schemas/session-event.schema.json +0 -48
- package/schemas/studio-session.schema.json +0 -48
- package/skills/accessibility-wcag.md +0 -15
- package/skills/agent-handoff-tracing.md +0 -44
- package/skills/best-practice-maturity-review.md +0 -26
- package/skills/content-first-design.md +0 -50
- package/skills/conversion-copywriting.md +0 -38
- package/skills/deployment-observability.md +0 -14
- package/skills/docs-maintainer.md +0 -19
- package/skills/frontend-design-system.md +0 -68
- package/skills/frontend-distinctiveness-benchmark.md +0 -40
- package/skills/frontend-product-quality-rubric.md +0 -59
- package/skills/landing-page-copy.md +0 -29
- package/skills/nextjs-app-router.md +0 -18
- package/skills/onboarding-empty-state-copy.md +0 -37
- package/skills/owasp-security-review.md +0 -19
- package/skills/planning-council.md +0 -21
- package/skills/positioning-messaging.md +0 -42
- package/skills/postgres-migrations.md +0 -14
- package/skills/product-voice-tone.md +0 -35
- package/skills/reference-led-design-critique.md +0 -48
- package/skills/supabase-auth-rls.md +0 -20
- package/skills/testing-qa.md +0 -15
- package/skills/ui-improvement-harness.md +0 -96
- package/skills/upgrade-maintenance.md +0 -32
- package/skills/visual-regression-qa.md +0 -42
- package/templates/next-supabase/.agent-kit/orchestrator.json +0 -48
- package/templates/next-supabase/.agent-kit/runtime/gitignore.template +0 -2
- package/templates/next-supabase/.github/workflows/agent-kit-audit.yml +0 -34
- package/templates/next-supabase/AGENT_ROSTER.md +0 -101
- package/templates/next-supabase/ASSISTANT_ADAPTERS.md +0 -146
- package/templates/next-supabase/COUNCIL.md +0 -54
- package/templates/next-supabase/DECISIONS.md +0 -87
- package/templates/next-supabase/DEPLOYMENT.md +0 -51
- package/templates/next-supabase/DESIGN.md +0 -180
- package/templates/next-supabase/DOCS.md +0 -80
- package/templates/next-supabase/LOOP_CODING.md +0 -98
- package/templates/next-supabase/MESSAGING.md +0 -81
- package/templates/next-supabase/MODEL_ROUTING.md +0 -130
- package/templates/next-supabase/QUALITY_GATES.md +0 -98
- package/templates/next-supabase/SKILLS.md +0 -235
- package/templates/next-supabase/SPEC.md +0 -122
- package/templates/next-supabase/STYLE_GUIDE.md +0 -121
- package/templates/next-supabase/TESTING.md +0 -107
|
@@ -1,59 +0,0 @@
|
|
|
1
|
-
# Frontend Product Quality Rubric Skill
|
|
2
|
-
|
|
3
|
-
## Use When
|
|
4
|
-
|
|
5
|
-
Reviewing or accepting any meaningful user-facing screen, page, component system, app shell, dashboard, admin workflow, onboarding flow, marketing surface, ecommerce flow, portfolio, venue page, content experience, community surface, education product, or AI workflow UI.
|
|
6
|
-
|
|
7
|
-
## Goal
|
|
8
|
-
|
|
9
|
-
Make frontend quality review repeatable. A UI should not pass because it has modern styling, tokens, or screenshots. It must show the product's real audience, task, content, visual identity, states, accessibility, and source-safe reference learning.
|
|
10
|
-
|
|
11
|
-
## Required Inputs
|
|
12
|
-
|
|
13
|
-
- `DESIGN.md` with brand/content inputs, selected creative direction, reference set, anti-references, and source-safety notes.
|
|
14
|
-
- `DESIGN.md` distinctiveness benchmark evidence: first-screen proof, content fingerprint, reference benchmark, asset provenance, state proof, and visual QA proof.
|
|
15
|
-
- Desktop and mobile screenshots or preview links when implementation exists.
|
|
16
|
-
- Real content, data examples, record names, assets, or explicitly documented placeholder constraints.
|
|
17
|
-
- Component/state evidence for important loading, empty, error, disabled, success, permission, and focus states.
|
|
18
|
-
- Accessibility and visual QA evidence proportional to release risk.
|
|
19
|
-
|
|
20
|
-
## Scorecard
|
|
21
|
-
|
|
22
|
-
Score each dimension as `0`, `1`, or `2`.
|
|
23
|
-
|
|
24
|
-
| Dimension | 0 Reject | 1 Adequate | 2 Strong |
|
|
25
|
-
| --- | --- | --- | --- |
|
|
26
|
-
| User/task fit | First screen could belong to any product | Main task is visible but weakly prioritized | Product object, task, or workflow is immediately clear |
|
|
27
|
-
| Content specificity | Generic copy, fake metrics, or placeholder content hides missing decisions | Some real labels or data, but gaps remain | Real domain language, data shape, and content hierarchy drive the UI |
|
|
28
|
-
| Visual identity | Default AI-site tropes or derivative reference styling | Direction is coherent but not very distinctive | Typography, color, density, imagery, and layout express the chosen product direction |
|
|
29
|
-
| Information architecture | Navigation and hierarchy are unclear | Core path is understandable | Primary and secondary workflows are easy to scan and act on |
|
|
30
|
-
| Component states | Happy path only | Common states are documented | Important state variants are implemented or captured as visual evidence |
|
|
31
|
-
| Accessibility and interaction | Keyboard, focus, labels, contrast, or motion risks are unresolved | WCAG 2.1 AA basics are covered | Accessibility is verified across critical states and viewport changes |
|
|
32
|
-
| Source safety | References are copied or attribution/asset risk is unclear | References are summarized without copying | Lessons, anti-references, and what not to copy are explicit |
|
|
33
|
-
|
|
34
|
-
Acceptance threshold:
|
|
35
|
-
|
|
36
|
-
- Reject if any dimension scores `0` for user/task fit, content specificity, accessibility and interaction, or source safety.
|
|
37
|
-
- Reject if total score is below `10` of `14`.
|
|
38
|
-
- Treat `10-11` as adequate and `12-14` as strong.
|
|
39
|
-
- Best-practice frontend evidence requires a score of at least `12`, no critical zeroes, desktop/mobile review, and visual QA evidence for the change risk.
|
|
40
|
-
- A best-practice frontend verdict also requires a passing distinctiveness benchmark. A polished but interchangeable screen remains a reject even if it reaches the numeric threshold.
|
|
41
|
-
|
|
42
|
-
## Reject By Default
|
|
43
|
-
|
|
44
|
-
- A polished visual system with no real product nouns, data, or workflow.
|
|
45
|
-
- A landing page when the request was for an app, tool, dashboard, or operational workflow.
|
|
46
|
-
- Generic gradients, card-heavy filler, fake analytics, vague SaaS copy, stock-like decoration, or one-note palettes.
|
|
47
|
-
- Reference use that copies a brand, exact layout, visual signature, proprietary asset, or copy.
|
|
48
|
-
- Screenshots that omit mobile, important states, or the first screen's primary task.
|
|
49
|
-
|
|
50
|
-
## Review Output
|
|
51
|
-
|
|
52
|
-
Return:
|
|
53
|
-
|
|
54
|
-
- The score for each dimension and total score.
|
|
55
|
-
- Critical zeroes, if any.
|
|
56
|
-
- The acceptance verdict: `reject`, `adequate`, or `strong`.
|
|
57
|
-
- The smallest changes needed to reach the next verdict.
|
|
58
|
-
- Missing screenshot, state, accessibility, or visual QA evidence.
|
|
59
|
-
- Any source-safety or anti-reference risks that must be resolved before release.
|
|
@@ -1,29 +0,0 @@
|
|
|
1
|
-
# Landing Page Copy Skill
|
|
2
|
-
|
|
3
|
-
## Use When
|
|
4
|
-
|
|
5
|
-
Creating or reviewing homepage, landing page, campaign page, product page, feature page, waitlist page, or launch page copy.
|
|
6
|
-
|
|
7
|
-
## Goal
|
|
8
|
-
|
|
9
|
-
Build a page narrative that quickly proves the product's specific value, not a generic hero followed by interchangeable feature cards.
|
|
10
|
-
|
|
11
|
-
## Required Work
|
|
12
|
-
|
|
13
|
-
- Start from `MESSAGING.md`; ask discovery questions if positioning is unclear.
|
|
14
|
-
- Define the first-viewport promise: audience, problem, outcome, differentiator, and action.
|
|
15
|
-
- Use the product's real nouns, workflows, integrations, constraints, and proof.
|
|
16
|
-
- Build sections around user questions: what is it, who is it for, why now, why this, how it works, proof, objections, next step.
|
|
17
|
-
- Keep claims proportionate to available proof.
|
|
18
|
-
- Pair copy with Frontend Design Lead so information hierarchy and visual direction reinforce the message.
|
|
19
|
-
|
|
20
|
-
## Reject By Default
|
|
21
|
-
|
|
22
|
-
- Hero copy that says only "build faster", "work smarter", "AI-powered", or "all-in-one".
|
|
23
|
-
- Feature cards that list capabilities without tying them to user outcomes.
|
|
24
|
-
- Testimonials, logos, metrics, or security claims that are invented or unverified.
|
|
25
|
-
- Landing pages when the user asked for a working app, tool, or operational workflow.
|
|
26
|
-
|
|
27
|
-
## Review Output
|
|
28
|
-
|
|
29
|
-
Return first-viewport copy, page section outline, proof placement, objection handling, CTA hierarchy, missing inputs, and design handoff notes.
|
|
@@ -1,18 +0,0 @@
|
|
|
1
|
-
# Next.js App Router Skill
|
|
2
|
-
|
|
3
|
-
## Use When
|
|
4
|
-
|
|
5
|
-
Working on routes, layouts, Server Components, Client Components, Server Actions, Route Handlers, data loading, caching, or revalidation.
|
|
6
|
-
|
|
7
|
-
## Checklist
|
|
8
|
-
|
|
9
|
-
- Server Components are the default.
|
|
10
|
-
- Client Components are used only for browser-only behavior.
|
|
11
|
-
- Secrets stay server-only.
|
|
12
|
-
- User-specific data is not stored in shared caches.
|
|
13
|
-
- Route params, query params, forms, and API bodies are validated.
|
|
14
|
-
- Loading, error, empty, and success states are present.
|
|
15
|
-
|
|
16
|
-
## Security Notes
|
|
17
|
-
|
|
18
|
-
Do not trust client-side checks for authorization. Client UI can hide controls, but server code and RLS must enforce permissions.
|
|
@@ -1,37 +0,0 @@
|
|
|
1
|
-
# Onboarding And Empty-State Copy Skill
|
|
2
|
-
|
|
3
|
-
## Use When
|
|
4
|
-
|
|
5
|
-
Writing or reviewing onboarding, activation, setup checklists, empty states, first-run flows, upgrade prompts, permission states, success states, or in-product guidance.
|
|
6
|
-
|
|
7
|
-
## Goal
|
|
8
|
-
|
|
9
|
-
Help users take the next useful step without filler, pressure, or unclear product promises.
|
|
10
|
-
|
|
11
|
-
## Required Inputs
|
|
12
|
-
|
|
13
|
-
- User role and first successful outcome.
|
|
14
|
-
- Required setup steps and dependencies.
|
|
15
|
-
- Empty-state cause: no data yet, filtered out, permission denied, failed load, unavailable feature, or completed workflow.
|
|
16
|
-
- Available next actions and support paths.
|
|
17
|
-
- Product voice and risk level.
|
|
18
|
-
|
|
19
|
-
## Required Work
|
|
20
|
-
|
|
21
|
-
- Explain what happened in the user's language.
|
|
22
|
-
- Offer the smallest useful next action.
|
|
23
|
-
- Separate first-run education from error or permission states.
|
|
24
|
-
- Avoid blaming the user for missing data, permissions, or integrations.
|
|
25
|
-
- Align CTAs with the actual route, action, or support path.
|
|
26
|
-
- Include accessibility-friendly labels and error recovery where relevant.
|
|
27
|
-
|
|
28
|
-
## Reject By Default
|
|
29
|
-
|
|
30
|
-
- Empty states that only say "nothing here yet".
|
|
31
|
-
- Onboarding copy with no clear next action.
|
|
32
|
-
- Upgrade prompts that block core recovery or hide why access is limited.
|
|
33
|
-
- Error or permission copy that obscures the real cause.
|
|
34
|
-
|
|
35
|
-
## Review Output
|
|
36
|
-
|
|
37
|
-
Return state type, user goal, message, primary action, secondary action, recovery path, and any missing product or permission details.
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
# OWASP Security Review Skill
|
|
2
|
-
|
|
3
|
-
## Use When
|
|
4
|
-
|
|
5
|
-
Reviewing auth, APIs, Server Actions, external fetches, file uploads, webhooks, dependencies, or data mutations.
|
|
6
|
-
|
|
7
|
-
## Checklist
|
|
8
|
-
|
|
9
|
-
- Broken access control and IDOR are tested.
|
|
10
|
-
- Inputs are validated and parsed with safe schemas.
|
|
11
|
-
- Outputs are safely rendered or encoded.
|
|
12
|
-
- SSRF risk is addressed for server-side fetches.
|
|
13
|
-
- Secrets are not logged or bundled.
|
|
14
|
-
- Dependencies are reviewed for known critical CVEs.
|
|
15
|
-
- Errors are explicit without leaking internals.
|
|
16
|
-
|
|
17
|
-
## Output Format
|
|
18
|
-
|
|
19
|
-
Report severity, exploit path, affected behavior, and concrete remediation.
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
# Planning And Agent Council
|
|
2
|
-
|
|
3
|
-
## Use When
|
|
4
|
-
|
|
5
|
-
Use for planning requests, roadmap work, ambiguous feature requests, core architecture changes, auth/data changes, release changes, and any task that needs multiple agent roles.
|
|
6
|
-
|
|
7
|
-
## Required Checks
|
|
8
|
-
|
|
9
|
-
- Classify the request as planning, core-change, frontend-change, security-review, release, docs, or research.
|
|
10
|
-
- Read `.agent-kit/agent-roster.json` and use it as the workflow source of truth when present.
|
|
11
|
-
- Use `QUALITY_GATES.md` to name whether the target is baseline, strong, or best-practice.
|
|
12
|
-
- Start planning with the Planner agent.
|
|
13
|
-
- Route core changes through Lead Architect before implementation.
|
|
14
|
-
- Include Security Reviewer for auth, data mutation, external-call, dependency, secret, or deployment-risk changes.
|
|
15
|
-
- Include QA Engineer before completion when behavior changes.
|
|
16
|
-
- Include Documentation Maintainer when living docs need updates.
|
|
17
|
-
- Record meaningful council sessions in `COUNCIL.md` or a structured record matching `.agent-kit/schemas/council-session.schema.json`.
|
|
18
|
-
|
|
19
|
-
## Output
|
|
20
|
-
|
|
21
|
-
Name the active workflow, maturity target, council members, handoff order, affected layers, preserved capabilities, required outputs, decision/risk/next-handoff evidence, verification commands, and unresolved risks.
|
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
# Positioning And Messaging Skill
|
|
2
|
-
|
|
3
|
-
## Use When
|
|
4
|
-
|
|
5
|
-
Defining or reviewing product positioning, audience, value proposition, landing-page strategy, homepage messaging, pricing narrative, launch copy, or public SaaS messaging.
|
|
6
|
-
|
|
7
|
-
## Goal
|
|
8
|
-
|
|
9
|
-
Make copy specific to the actual product, market, user pain, outcome, and proof instead of producing interchangeable SaaS language.
|
|
10
|
-
|
|
11
|
-
## Required Discovery Questions
|
|
12
|
-
|
|
13
|
-
Ask these before writing final copy when the answers are missing:
|
|
14
|
-
|
|
15
|
-
- Who is the primary audience, and what do they already believe or understand?
|
|
16
|
-
- What painful, expensive, slow, risky, or annoying problem are they trying to solve?
|
|
17
|
-
- What outcome do they want, and how will they recognize progress?
|
|
18
|
-
- What alternatives are they using today, including manual workarounds?
|
|
19
|
-
- What is the strongest differentiator: speed, quality, workflow fit, trust, cost, automation, insight, compliance, or convenience?
|
|
20
|
-
- What proof supports the claim: data, customer quote, demo, case study, benchmark, shipped feature, integration, or domain expertise?
|
|
21
|
-
- What objections would stop adoption, signup, payment, or activation?
|
|
22
|
-
- What action should the page or flow make easier?
|
|
23
|
-
|
|
24
|
-
## Required Work
|
|
25
|
-
|
|
26
|
-
- Fill or update `MESSAGING.md`.
|
|
27
|
-
- Write a one-sentence positioning statement.
|
|
28
|
-
- Define primary and secondary value propositions.
|
|
29
|
-
- Name proof points and objections separately from claims.
|
|
30
|
-
- Translate positioning into page-level hierarchy: headline, subhead, primary CTA, secondary CTA, proof, objection handling, and next step.
|
|
31
|
-
- Mark unknowns explicitly instead of hiding them behind broad claims.
|
|
32
|
-
|
|
33
|
-
## Reject By Default
|
|
34
|
-
|
|
35
|
-
- "AI-powered", "supercharge", "revolutionize", "all-in-one", "10x", or similar claims without concrete proof.
|
|
36
|
-
- Headlines that would still work after replacing the product name with a competitor.
|
|
37
|
-
- Copy with no audience, pain, differentiator, proof, or conversion target.
|
|
38
|
-
- Unsupported urgency, fear, savings, compliance, or performance claims.
|
|
39
|
-
|
|
40
|
-
## Review Output
|
|
41
|
-
|
|
42
|
-
Return missing inputs, positioning statement, value proposition, proof gaps, objections, copy hierarchy, CTA rationale, and required follow-up questions.
|
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
# Postgres Migrations Skill
|
|
2
|
-
|
|
3
|
-
## Use When
|
|
4
|
-
|
|
5
|
-
Adding tables, columns, constraints, indexes, functions, triggers, seed data, or policy changes.
|
|
6
|
-
|
|
7
|
-
## Checklist
|
|
8
|
-
|
|
9
|
-
- Migration order is documented.
|
|
10
|
-
- Constraints protect data integrity.
|
|
11
|
-
- Indexes support expected queries.
|
|
12
|
-
- RLS changes are reviewed with auth assumptions.
|
|
13
|
-
- Backfills and destructive changes have rollback guidance.
|
|
14
|
-
- Local and production application order is clear.
|
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
# Product Voice And Tone Skill
|
|
2
|
-
|
|
3
|
-
## Use When
|
|
4
|
-
|
|
5
|
-
Defining or reviewing product voice, tone, brand language, UX writing rules, help text, error messages, onboarding guidance, transactional copy, or notification copy.
|
|
6
|
-
|
|
7
|
-
## Goal
|
|
8
|
-
|
|
9
|
-
Make the product sound deliberate, consistent, and appropriate for the audience and task risk.
|
|
10
|
-
|
|
11
|
-
## Required Inputs
|
|
12
|
-
|
|
13
|
-
- Audience sophistication and emotional state.
|
|
14
|
-
- Product category and trust requirements.
|
|
15
|
-
- Brand traits and words to avoid.
|
|
16
|
-
- Regulatory, legal, accessibility, or support constraints.
|
|
17
|
-
- Examples of existing copy that should be kept or avoided.
|
|
18
|
-
|
|
19
|
-
## Required Work
|
|
20
|
-
|
|
21
|
-
- Define 3-5 voice traits with "do" and "avoid" examples.
|
|
22
|
-
- Set tone rules for success, warning, error, empty, loading, payment, security, and destructive actions.
|
|
23
|
-
- Prefer plain, concrete language over cleverness when user trust or task completion matters.
|
|
24
|
-
- Keep labels, CTAs, form hints, and errors consistent across the product.
|
|
25
|
-
- Update `MESSAGING.md`, `STYLE_GUIDE.md`, or `DESIGN.md` when voice affects product UI.
|
|
26
|
-
|
|
27
|
-
## Reject By Default
|
|
28
|
-
|
|
29
|
-
- Cute or vague copy around errors, billing, security, auth, destructive actions, or compliance.
|
|
30
|
-
- Inconsistent terms for the same object, workflow, or action.
|
|
31
|
-
- Brand voice that hides important limitations or next steps.
|
|
32
|
-
|
|
33
|
-
## Review Output
|
|
34
|
-
|
|
35
|
-
Return voice traits, tone rules by state, terminology decisions, risky wording, and doc updates needed.
|
|
@@ -1,48 +0,0 @@
|
|
|
1
|
-
# Reference-Led Design Critique Skill
|
|
2
|
-
|
|
3
|
-
## Use When
|
|
4
|
-
|
|
5
|
-
Reviewing or designing a user-facing screen, component system, marketing surface, dashboard, tool, onboarding flow, marketplace, content page, ecommerce flow, portfolio, venue page, community surface, education product, or AI workflow UI where visual quality and product specificity matter.
|
|
6
|
-
|
|
7
|
-
## Goal
|
|
8
|
-
|
|
9
|
-
Prevent generic AI-looking UI by grounding design decisions in a small reference set, explicit anti-references, product content, accessibility, and a written critique verdict before implementation is accepted.
|
|
10
|
-
|
|
11
|
-
## Required Inputs
|
|
12
|
-
|
|
13
|
-
- `DESIGN.md` brand/content inputs and selected creative direction.
|
|
14
|
-
- 3-5 category references to learn from without copying.
|
|
15
|
-
- 2-3 anti-references that show what the product must not look like.
|
|
16
|
-
- Real content, assets, data examples, and workflow constraints.
|
|
17
|
-
- Screenshots or preview links for desktop and mobile when implementation exists.
|
|
18
|
-
|
|
19
|
-
## Critique Workflow
|
|
20
|
-
|
|
21
|
-
1. Identify what each reference teaches: density, hierarchy, navigation, content treatment, typography, imagery, motion, or interaction behavior.
|
|
22
|
-
2. State what must not be copied: brand marks, layouts, proprietary components, exact copy, visual signatures, or protected assets.
|
|
23
|
-
3. Compare the proposed UI against the chosen creative direction and product content.
|
|
24
|
-
4. Score distinctiveness as `weak`, `adequate`, or `strong`.
|
|
25
|
-
5. Apply the frontend product-quality scorecard for user/task fit, content specificity, visual identity, IA, states, accessibility, and source safety.
|
|
26
|
-
6. Reject the work if the first screen could fit any generic product in the same category.
|
|
27
|
-
7. Require the smallest useful visual QA evidence for the risk: screenshot review, Playwright screenshots, Storybook states, visual-regression baseline, or equivalent.
|
|
28
|
-
|
|
29
|
-
## Reject By Default
|
|
30
|
-
|
|
31
|
-
- References used as permission to copy a brand, layout, or source design.
|
|
32
|
-
- One-reference design direction.
|
|
33
|
-
- A UI that has tokens and states but no product-specific point of view.
|
|
34
|
-
- Designs that hide missing content behind abstract gradients, fake dashboards, generic illustrations, or vague copy.
|
|
35
|
-
- Screenshot evidence that omits mobile, empty, error, loading, or permission states when those states affect the workflow.
|
|
36
|
-
|
|
37
|
-
## Review Output
|
|
38
|
-
|
|
39
|
-
Return:
|
|
40
|
-
|
|
41
|
-
- Reference set and anti-references used.
|
|
42
|
-
- What was learned from each reference without copying.
|
|
43
|
-
- Product-specific details that make the UI belong to this project.
|
|
44
|
-
- Generic or AI-slop risks that remain.
|
|
45
|
-
- Distinctiveness verdict: weak, adequate, or strong.
|
|
46
|
-
- Frontend product-quality scorecard verdict and total score.
|
|
47
|
-
- Required design changes before implementation or release.
|
|
48
|
-
- Required screenshot, accessibility, and visual QA evidence.
|
|
@@ -1,20 +0,0 @@
|
|
|
1
|
-
# Supabase Auth And RLS Skill
|
|
2
|
-
|
|
3
|
-
## Use When
|
|
4
|
-
|
|
5
|
-
Working on Supabase Auth, SSR clients, middleware, sessions, tables, policies, Storage, or service-role operations.
|
|
6
|
-
|
|
7
|
-
## Checklist
|
|
8
|
-
|
|
9
|
-
- RLS is enabled on user-owned and tenant-owned tables.
|
|
10
|
-
- Policies enforce ownership and tenant boundaries.
|
|
11
|
-
- Service-role key is never exposed to client code.
|
|
12
|
-
- Auth middleware handles session refresh safely.
|
|
13
|
-
- Storage buckets have explicit policies.
|
|
14
|
-
- IDOR attempts are considered and tested.
|
|
15
|
-
- `SPEC.md` contains an RLS policy inventory.
|
|
16
|
-
- Security-sensitive policy assumptions are recorded in `DECISIONS.md`.
|
|
17
|
-
|
|
18
|
-
## Safe Default
|
|
19
|
-
|
|
20
|
-
If a table stores user-specific data, assume it needs RLS before it is queried from application code.
|
package/skills/testing-qa.md
DELETED
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
# Testing And QA Skill
|
|
2
|
-
|
|
3
|
-
## Use When
|
|
4
|
-
|
|
5
|
-
Adding or reviewing tests, smoke checks, regression coverage, or acceptance evidence.
|
|
6
|
-
|
|
7
|
-
## Checklist
|
|
8
|
-
|
|
9
|
-
- Core logic has unit tests.
|
|
10
|
-
- Preserved behavior has regression tests.
|
|
11
|
-
- Critical user flows have Playwright smoke tests.
|
|
12
|
-
- High-risk UI changes have screenshot or visual-regression evidence.
|
|
13
|
-
- Auth and data mutation paths are prioritized.
|
|
14
|
-
- Network failure, empty state, and error state behavior is covered.
|
|
15
|
-
- Test gaps are documented when infrastructure is missing.
|
|
@@ -1,96 +0,0 @@
|
|
|
1
|
-
# UI Improvement Harness Skill
|
|
2
|
-
|
|
3
|
-
## Use When
|
|
4
|
-
|
|
5
|
-
Running operational UI improvement loops for user-facing screens, dashboards, admin flows, app shells, onboarding, marketing surfaces, component systems, or authenticated product workflows.
|
|
6
|
-
|
|
7
|
-
Use this skill when a request asks for UI audit, polish, layout cleanup, responsive cleanup, accessibility pass, screenshot critique, visual distinctiveness, live browser QA, or repeatable frontend improvement workflows.
|
|
8
|
-
|
|
9
|
-
## Goal
|
|
10
|
-
|
|
11
|
-
Turn frontend quality guidance into repeatable commands. The harness should help agents move from screenshots and browser evidence to concrete fixes, then loop until deterministic detector findings and review findings pass for the release risk.
|
|
12
|
-
|
|
13
|
-
## Required Inputs
|
|
14
|
-
|
|
15
|
-
- Target surface: route, component, flow, or screenshot set.
|
|
16
|
-
- Product context from `DESIGN.md`, `STYLE_GUIDE.md`, and relevant `.agent-kit/design-briefs/*`.
|
|
17
|
-
- Auth and permission context for protected screens, including role, tenant, and fixture user assumptions.
|
|
18
|
-
- Desktop and mobile viewports for meaningful UI changes.
|
|
19
|
-
- State coverage requirements: default, loading, empty, error, disabled, success, permission, focus, and narrow viewport states where relevant.
|
|
20
|
-
- Existing visual QA tier from `TESTING.md`, or a proposed tier from `.agent-kit/prompts/visual-qa-plan.md`.
|
|
21
|
-
|
|
22
|
-
## Command Workflows
|
|
23
|
-
|
|
24
|
-
Use `.agent-kit/prompts/ui-command-index.md` as the command index. It defines these command-like workflows:
|
|
25
|
-
|
|
26
|
-
- UI audit: find blockers and major issues before implementation or release.
|
|
27
|
-
- UI polish: improve hierarchy, density, spacing, state feedback, and visual finish without changing product scope.
|
|
28
|
-
- Layout cleanup: remove clutter, nesting, overflow, weak grouping, and inconsistent spacing.
|
|
29
|
-
- Responsive/mobile cleanup: verify mobile hierarchy, tap targets, text fit, navigation, and critical actions.
|
|
30
|
-
- Accessibility pass: verify semantic structure, keyboard path, focus, labels, contrast, motion, and error feedback.
|
|
31
|
-
- Visual distinctiveness pass: prove product specificity and avoid generic AI/SaaS defaults.
|
|
32
|
-
- Screenshot critique: review desktop/mobile/state screenshots against product context and detector findings.
|
|
33
|
-
- Live browser QA loop: inspect the running app, capture evidence, apply scoped fixes, and repeat until acceptance criteria pass.
|
|
34
|
-
|
|
35
|
-
## Deterministic Detector Checklist
|
|
36
|
-
|
|
37
|
-
Use `.agent-kit/checklists/ui-detectors.md` before and after polish. Treat each finding as `blocker`, `major`, `minor`, or `not-applicable`.
|
|
38
|
-
|
|
39
|
-
Required detector areas:
|
|
40
|
-
|
|
41
|
-
- Crowded layout and excessive competing surfaces.
|
|
42
|
-
- Weak hierarchy or unclear primary action.
|
|
43
|
-
- Inconsistent spacing, density, typography, radius, or alignment.
|
|
44
|
-
- Poor mobile tap targets or unreachable critical actions.
|
|
45
|
-
- Truncation, overflow, overlap, or text that does not fit.
|
|
46
|
-
- Card-within-card patterns and decorative containers that obscure workflow.
|
|
47
|
-
- Generic SaaS or AI-site styling, including abstract decoration that hides missing content.
|
|
48
|
-
- Weak hover, pressed, selected, loading, success, empty, error, disabled, focus, and permission feedback.
|
|
49
|
-
- Missing loading, empty, error, disabled, success, permission, and mobile states where relevant.
|
|
50
|
-
- Accessibility and focus issues, including contrast, labels, landmarks, keyboard order, and motion.
|
|
51
|
-
|
|
52
|
-
## Acceptance Rubric
|
|
53
|
-
|
|
54
|
-
Use `.agent-kit/checklists/ui-acceptance-rubric.md`.
|
|
55
|
-
|
|
56
|
-
- Blocker findings must be fixed before release.
|
|
57
|
-
- Major findings must be fixed or explicitly accepted with rationale before high-risk UI changes ship.
|
|
58
|
-
- High-risk UI changes require desktop and mobile screenshots plus authenticated or permission-state evidence when the workflow requires login.
|
|
59
|
-
- Screenshot evidence must include the first viewport, primary workflow, and the highest-risk state affected by the change.
|
|
60
|
-
- Visual checks do not replace semantic, keyboard, auth, data-boundary, or regression tests.
|
|
61
|
-
|
|
62
|
-
## Live Browser QA Loop
|
|
63
|
-
|
|
64
|
-
For implemented UI:
|
|
65
|
-
|
|
66
|
-
1. Start or identify the app server and route.
|
|
67
|
-
2. Open the target route with the required auth state or test account.
|
|
68
|
-
3. Capture desktop and mobile screenshots.
|
|
69
|
-
4. Run the deterministic detector checklist.
|
|
70
|
-
5. Run screenshot critique and accessibility pass.
|
|
71
|
-
6. Apply the smallest scoped fixes.
|
|
72
|
-
7. Repeat until no blockers remain and major findings are resolved or documented.
|
|
73
|
-
8. Record evidence with `agent-kit session output` when Agent Studio is in use.
|
|
74
|
-
|
|
75
|
-
For authenticated screens, do not substitute a public landing page screenshot. Use a real signed-in state, a seeded local fixture, or an explicit limitation note that names the missing auth evidence.
|
|
76
|
-
|
|
77
|
-
## Reject By Default
|
|
78
|
-
|
|
79
|
-
- A UI pass based only on static prose with no screenshot or browser evidence when implementation exists.
|
|
80
|
-
- Desktop-only review for responsive or mobile-risk changes.
|
|
81
|
-
- Public-page review used as evidence for authenticated app screens.
|
|
82
|
-
- Vague polish requests that do not name detector findings or acceptance criteria.
|
|
83
|
-
- Fixes that add decorative cards, gradients, fake metrics, or generic copy instead of clarifying the workflow.
|
|
84
|
-
- Ignoring major detector findings without rationale.
|
|
85
|
-
|
|
86
|
-
## Review Output
|
|
87
|
-
|
|
88
|
-
Return:
|
|
89
|
-
|
|
90
|
-
- Target surface and auth state reviewed.
|
|
91
|
-
- Commands run or command-like workflows applied.
|
|
92
|
-
- Detector findings by severity.
|
|
93
|
-
- Screenshots and viewports reviewed.
|
|
94
|
-
- Accessibility, responsive, state, and distinctiveness verdicts.
|
|
95
|
-
- Fixes made or required before acceptance.
|
|
96
|
-
- Tests, browser checks, visual QA evidence, and gaps.
|
|
@@ -1,32 +0,0 @@
|
|
|
1
|
-
# Upgrade Maintenance Skill
|
|
2
|
-
|
|
3
|
-
## Use When
|
|
4
|
-
|
|
5
|
-
Upgrading Agent Kit, Next.js, Supabase, UI libraries, testing tools, release workflows, assistant adapters, or any shared package that can change project behavior.
|
|
6
|
-
|
|
7
|
-
## Goal
|
|
8
|
-
|
|
9
|
-
Make upgrades repeatable, reviewable, reversible, and evidence-backed.
|
|
10
|
-
|
|
11
|
-
## Required Checks
|
|
12
|
-
|
|
13
|
-
- Read `UPGRADE.md`, `CHANGELOG.md`, `ROADMAP.md`, and `DECISIONS.md` before changing versioned behavior.
|
|
14
|
-
- Run `agent-kit diff` before accepting template changes.
|
|
15
|
-
- Use `agent-kit update` only on a branch where conflicts can be reviewed.
|
|
16
|
-
- Preserve valid local overrides in `.agent-kit/overrides.json`.
|
|
17
|
-
- For Next.js upgrades, check official upgrade guidance and codemods.
|
|
18
|
-
- For Supabase upgrades, verify migration history, RLS impact, service-role exposure, generated types, and rollback risk.
|
|
19
|
-
- Run `agent-kit audit --min-readiness baseline-setup` after the upgrade.
|
|
20
|
-
- Use `agent-kit audit --min-readiness best-practice-candidate` only after project-specific evidence is complete.
|
|
21
|
-
- Record package versions, migration order, rollback notes, verification commands, owner, and date.
|
|
22
|
-
|
|
23
|
-
## Output
|
|
24
|
-
|
|
25
|
-
Return:
|
|
26
|
-
|
|
27
|
-
- Upgrade scope.
|
|
28
|
-
- Files and templates changed.
|
|
29
|
-
- Conflicts accepted, deferred, or rejected.
|
|
30
|
-
- Migration and rollback risk.
|
|
31
|
-
- Verification commands and results.
|
|
32
|
-
- Remaining warnings before best-practice readiness.
|
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
# Visual Regression QA Skill
|
|
2
|
-
|
|
3
|
-
## Use When
|
|
4
|
-
|
|
5
|
-
Reviewing or changing user-facing UI, reusable components, app shells, dashboards, marketing pages, visual design tokens, responsive layouts, image-heavy pages, or any screen where appearance is part of the acceptance criteria.
|
|
6
|
-
|
|
7
|
-
## Goal
|
|
8
|
-
|
|
9
|
-
Turn visual quality from subjective review into repeatable evidence. Capture important UI states, compare them across changes, and require intentional approval for visual diffs.
|
|
10
|
-
|
|
11
|
-
## Coverage Tiers
|
|
12
|
-
|
|
13
|
-
- Baseline: desktop and mobile screenshots reviewed with `prompts/screenshot-review.md`.
|
|
14
|
-
- Strong: Playwright screenshot checks for primary workflows and responsive breakpoints.
|
|
15
|
-
- Mature: Storybook stories for reusable component states plus visual regression in CI through a tool such as Chromatic, Argos, Loki, or Playwright snapshots.
|
|
16
|
-
|
|
17
|
-
## Required Checks
|
|
18
|
-
|
|
19
|
-
- Primary screens have screenshot evidence for desktop and mobile.
|
|
20
|
-
- Reusable components have meaningful state coverage: default, hover/focus where practical, loading, empty, error, disabled, success, permission-denied, and mobile.
|
|
21
|
-
- Dynamic data, animations, dates, avatars, ads, third-party widgets, and generated media are stabilized, mocked, or masked before visual comparison.
|
|
22
|
-
- Baseline updates are reviewed as product changes, not accepted automatically.
|
|
23
|
-
- Visual diffs are linked in PRs, CI artifacts, or review notes.
|
|
24
|
-
- Accessibility and interaction tests still run; visual diffs do not replace semantic checks.
|
|
25
|
-
|
|
26
|
-
## Reject By Default
|
|
27
|
-
|
|
28
|
-
- A single happy-path screenshot as final UI evidence.
|
|
29
|
-
- Visual baselines updated without rationale.
|
|
30
|
-
- Full-page visual snapshots that are flaky because dynamic content is uncontrolled.
|
|
31
|
-
- Screenshot tests that ignore mobile, long text, empty data, or error states.
|
|
32
|
-
- Treating a visual testing service as proof of good design without `DESIGN.md` and screenshot review.
|
|
33
|
-
|
|
34
|
-
## Review Output
|
|
35
|
-
|
|
36
|
-
Return:
|
|
37
|
-
|
|
38
|
-
- Visual surfaces covered and missing.
|
|
39
|
-
- Component states covered and missing.
|
|
40
|
-
- Baseline/diff evidence and where it can be reviewed.
|
|
41
|
-
- Flake risks and stabilization strategy.
|
|
42
|
-
- Whether the visual QA tier is appropriate for the change risk.
|
|
@@ -1,48 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"schemaVersion": 1,
|
|
3
|
-
"enabled": false,
|
|
4
|
-
"defaultWorkflow": "planning",
|
|
5
|
-
"defaultAlias": "balanced",
|
|
6
|
-
"databasePath": ".agent-kit/runtime/runtime.sqlite",
|
|
7
|
-
"providers": {},
|
|
8
|
-
"modelAliases": {},
|
|
9
|
-
"agentRoutes": {},
|
|
10
|
-
"agentExecutors": {},
|
|
11
|
-
"mutationAgents": [
|
|
12
|
-
"supabase-postgres-engineer",
|
|
13
|
-
"nextjs-engineer",
|
|
14
|
-
"frontend-design-lead",
|
|
15
|
-
"marketing-copy-lead",
|
|
16
|
-
"qa-engineer",
|
|
17
|
-
"docs-maintainer",
|
|
18
|
-
"deployment-observability-engineer"
|
|
19
|
-
],
|
|
20
|
-
"cursor": {
|
|
21
|
-
"enabled": false,
|
|
22
|
-
"command": "cursor-agent",
|
|
23
|
-
"args": ["--print", "--output-format", "stream-json", "--force"],
|
|
24
|
-
"timeoutMs": 900000
|
|
25
|
-
},
|
|
26
|
-
"mcpServers": {},
|
|
27
|
-
"sandbox": {
|
|
28
|
-
"provider": "docker",
|
|
29
|
-
"image": "node:22-bookworm-slim",
|
|
30
|
-
"network": "none",
|
|
31
|
-
"allowHostMutations": false,
|
|
32
|
-
"timeoutMs": 600000,
|
|
33
|
-
"memoryMb": 2048,
|
|
34
|
-
"cpus": 2
|
|
35
|
-
},
|
|
36
|
-
"approvals": {
|
|
37
|
-
"mode": "risk-tiered",
|
|
38
|
-
"requirePlan": true,
|
|
39
|
-
"requireFinalCommit": true
|
|
40
|
-
},
|
|
41
|
-
"limits": {
|
|
42
|
-
"maxSteps": 24,
|
|
43
|
-
"maxAgentVisits": 2,
|
|
44
|
-
"maxRetriesPerNode": 2,
|
|
45
|
-
"maxToolCallsPerAgent": 20,
|
|
46
|
-
"runTimeoutMs": 3600000
|
|
47
|
-
}
|
|
48
|
-
}
|
|
@@ -1,34 +0,0 @@
|
|
|
1
|
-
name: Agent Kit Audit
|
|
2
|
-
|
|
3
|
-
on:
|
|
4
|
-
pull_request:
|
|
5
|
-
push:
|
|
6
|
-
branches:
|
|
7
|
-
- main
|
|
8
|
-
workflow_dispatch:
|
|
9
|
-
|
|
10
|
-
permissions:
|
|
11
|
-
contents: read
|
|
12
|
-
|
|
13
|
-
jobs:
|
|
14
|
-
audit:
|
|
15
|
-
name: Agent kit readiness
|
|
16
|
-
# Automatic hosted CI is opt-in so unavailable Actions billing cannot block delivery.
|
|
17
|
-
# Set the repository variable AGENT_KIT_ACTIONS_ENABLED=true to enable push/PR runs.
|
|
18
|
-
if: ${{ github.event_name == 'workflow_dispatch' || vars.AGENT_KIT_ACTIONS_ENABLED == 'true' }}
|
|
19
|
-
runs-on: ubuntu-latest
|
|
20
|
-
timeout-minutes: 10
|
|
21
|
-
|
|
22
|
-
steps:
|
|
23
|
-
- name: Checkout
|
|
24
|
-
uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
|
|
25
|
-
with:
|
|
26
|
-
persist-credentials: false
|
|
27
|
-
|
|
28
|
-
- name: Setup Node
|
|
29
|
-
uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
|
|
30
|
-
with:
|
|
31
|
-
node-version: "24"
|
|
32
|
-
|
|
33
|
-
- name: Run baseline audit gate
|
|
34
|
-
run: npx --yes @appsforgood/next-supabase-kit@0.3.0 audit --json --min-readiness baseline-setup
|