@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.
Files changed (323) hide show
  1. package/CHANGELOG.md +9 -0
  2. package/README.md +22 -555
  3. package/UPGRADE.md +11 -77
  4. package/USER_GUIDE.md +181 -0
  5. package/agents/app-engineer/agent.md +32 -0
  6. package/agents/copy/agent.md +27 -0
  7. package/agents/design/agent.md +27 -0
  8. package/agents/optional/deploy/agent.md +12 -0
  9. package/agents/optional/docs/agent.md +12 -0
  10. package/agents/optional/lead-architect/agent.md +12 -0
  11. package/agents/optional/research/agent.md +12 -0
  12. package/agents/planner/agent.md +29 -0
  13. package/agents/qa/agent.md +35 -0
  14. package/agents/security/agent.md +28 -0
  15. package/assistant-adapters/cursor-agent-kit.mdc +5 -26
  16. package/catalog.json +20 -0
  17. package/dist/index.js +892 -8251
  18. package/dist/index.js.map +1 -1
  19. package/examples/next-supabase-installed/.agent-kit/config.json +22 -26
  20. package/examples/next-supabase-installed/.agent-kit/manifest.json +78 -222
  21. package/examples/next-supabase-installed/.antigravity/agent-kit/commands/browser-qa.toml +6 -0
  22. package/examples/next-supabase-installed/.antigravity/agent-kit/commands/copy.toml +6 -0
  23. package/examples/next-supabase-installed/.antigravity/agent-kit/commands/frontend.toml +6 -0
  24. package/examples/next-supabase-installed/.antigravity/agent-kit/commands/plan.toml +6 -0
  25. package/examples/next-supabase-installed/.antigravity/agent-kit/commands/security.toml +6 -0
  26. package/examples/next-supabase-installed/.antigravity/agent-kit/commands/ship.toml +6 -0
  27. package/examples/next-supabase-installed/.antigravity/agent-kit/commands/test.toml +6 -0
  28. package/examples/next-supabase-installed/.antigravity/agent-kit/plugin.json +12 -0
  29. package/examples/next-supabase-installed/.antigravity/runtime-skills/accessibility-wcag/SKILL.md +26 -0
  30. package/examples/next-supabase-installed/.antigravity/runtime-skills/browser-qa/SKILL.md +67 -0
  31. package/examples/next-supabase-installed/.antigravity/runtime-skills/frontend-design/SKILL.md +26 -0
  32. package/examples/next-supabase-installed/.antigravity/runtime-skills/nextjs-app-router/SKILL.md +23 -0
  33. package/examples/next-supabase-installed/.antigravity/runtime-skills/owasp-security-review/SKILL.md +23 -0
  34. package/examples/next-supabase-installed/.antigravity/runtime-skills/planning/SKILL.md +25 -0
  35. package/examples/next-supabase-installed/.antigravity/runtime-skills/postgres-migrations/SKILL.md +21 -0
  36. package/examples/next-supabase-installed/.antigravity/runtime-skills/product-copy/SKILL.md +22 -0
  37. package/examples/next-supabase-installed/.antigravity/runtime-skills/ship/SKILL.md +22 -0
  38. package/examples/next-supabase-installed/.antigravity/runtime-skills/supabase-auth-rls/SKILL.md +23 -0
  39. package/examples/next-supabase-installed/.antigravity/runtime-skills/testing-qa/SKILL.md +27 -0
  40. package/examples/next-supabase-installed/.claude/agents/app-engineer.md +32 -0
  41. package/examples/next-supabase-installed/.claude/agents/copy.md +27 -0
  42. package/examples/next-supabase-installed/.claude/agents/design.md +27 -0
  43. package/examples/next-supabase-installed/.claude/agents/planner.md +29 -0
  44. package/examples/next-supabase-installed/.claude/agents/qa.md +35 -0
  45. package/examples/next-supabase-installed/.claude/agents/security.md +28 -0
  46. package/examples/next-supabase-installed/.codex/agents/app-engineer.toml +39 -0
  47. package/examples/next-supabase-installed/.codex/agents/copy.toml +34 -0
  48. package/examples/next-supabase-installed/.codex/agents/design.toml +34 -0
  49. package/examples/next-supabase-installed/.codex/agents/planner.toml +36 -0
  50. package/examples/next-supabase-installed/.codex/agents/qa.toml +42 -0
  51. package/examples/next-supabase-installed/.codex/agents/security.toml +35 -0
  52. package/examples/next-supabase-installed/.cursor/agents/app-engineer.md +32 -0
  53. package/examples/next-supabase-installed/.cursor/agents/copy.md +27 -0
  54. package/examples/next-supabase-installed/.cursor/agents/design.md +27 -0
  55. package/examples/next-supabase-installed/.cursor/agents/planner.md +29 -0
  56. package/examples/next-supabase-installed/.cursor/agents/qa.md +35 -0
  57. package/examples/next-supabase-installed/.cursor/agents/security.md +28 -0
  58. package/examples/next-supabase-installed/.cursor/rules/cursor-agent-kit.mdc +12 -0
  59. package/examples/next-supabase-installed/.cursor/skills/accessibility-wcag/SKILL.md +26 -0
  60. package/examples/next-supabase-installed/.cursor/skills/browser-qa/SKILL.md +67 -0
  61. package/examples/next-supabase-installed/.cursor/skills/frontend-design/SKILL.md +26 -0
  62. package/examples/next-supabase-installed/.cursor/skills/nextjs-app-router/SKILL.md +23 -0
  63. package/examples/next-supabase-installed/.cursor/skills/owasp-security-review/SKILL.md +23 -0
  64. package/examples/next-supabase-installed/.cursor/skills/planning/SKILL.md +25 -0
  65. package/examples/next-supabase-installed/.cursor/skills/postgres-migrations/SKILL.md +21 -0
  66. package/examples/next-supabase-installed/.cursor/skills/product-copy/SKILL.md +22 -0
  67. package/examples/next-supabase-installed/.cursor/skills/ship/SKILL.md +22 -0
  68. package/examples/next-supabase-installed/.cursor/skills/supabase-auth-rls/SKILL.md +23 -0
  69. package/examples/next-supabase-installed/.cursor/skills/testing-qa/SKILL.md +27 -0
  70. package/examples/next-supabase-installed/.github/copilot-instructions.md +23 -0
  71. package/examples/next-supabase-installed/AGENTS.md +30 -0
  72. package/examples/next-supabase-installed/CLAUDE.md +7 -0
  73. package/examples/next-supabase-installed/README.md +2 -14
  74. package/examples/next-supabase-installed/USER_GUIDE.md +181 -0
  75. package/examples/next-supabase-installed/skills/accessibility-wcag/SKILL.md +26 -0
  76. package/examples/next-supabase-installed/skills/browser-qa/SKILL.md +67 -0
  77. package/examples/next-supabase-installed/skills/frontend-design/SKILL.md +26 -0
  78. package/examples/next-supabase-installed/skills/nextjs-app-router/SKILL.md +23 -0
  79. package/examples/next-supabase-installed/skills/owasp-security-review/SKILL.md +23 -0
  80. package/examples/next-supabase-installed/skills/planning/SKILL.md +25 -0
  81. package/examples/next-supabase-installed/skills/postgres-migrations/SKILL.md +21 -0
  82. package/examples/next-supabase-installed/skills/product-copy/SKILL.md +22 -0
  83. package/examples/next-supabase-installed/skills/ship/SKILL.md +22 -0
  84. package/examples/next-supabase-installed/skills/supabase-auth-rls/SKILL.md +23 -0
  85. package/examples/next-supabase-installed/skills/testing-qa/SKILL.md +27 -0
  86. package/examples/next-supabase-installed/tree.txt +57 -42
  87. package/package.json +15 -43
  88. package/research/agent-skill-gap-report.md +128 -0
  89. package/skills/accessibility-wcag/SKILL.md +26 -0
  90. package/skills/browser-qa/SKILL.md +67 -0
  91. package/skills/frontend-design/SKILL.md +26 -0
  92. package/skills/nextjs-app-router/SKILL.md +23 -0
  93. package/skills/optional/debug/SKILL.md +11 -0
  94. package/skills/optional/docs/SKILL.md +10 -0
  95. package/skills/optional/ui-polish/SKILL.md +10 -0
  96. package/skills/optional/upgrade/SKILL.md +10 -0
  97. package/skills/owasp-security-review/SKILL.md +23 -0
  98. package/skills/planning/SKILL.md +25 -0
  99. package/skills/postgres-migrations/SKILL.md +21 -0
  100. package/skills/product-copy/SKILL.md +22 -0
  101. package/skills/ship/SKILL.md +22 -0
  102. package/skills/supabase-auth-rls/SKILL.md +23 -0
  103. package/skills/testing-qa/SKILL.md +27 -0
  104. package/templates/next-supabase/AGENTS.md +19 -129
  105. package/templates/next-supabase/CLAUDE.md +4 -36
  106. package/BEST_PRACTICE_EVIDENCE.md +0 -45
  107. package/DOGFOOD.md +0 -201
  108. package/GOVERNANCE.md +0 -45
  109. package/LOOP_CODING.md +0 -107
  110. package/MAINTAINER_RELEASE.md +0 -100
  111. package/REPOSITORY_SETTINGS.md +0 -83
  112. package/RESEARCH_CITATION_POLICY.md +0 -26
  113. package/SUPPLY_CHAIN.md +0 -57
  114. package/agents/deployment-observability-engineer.md +0 -13
  115. package/agents/docs-maintainer.md +0 -17
  116. package/agents/frontend-design-lead.md +0 -22
  117. package/agents/lead-architect.md +0 -25
  118. package/agents/marketing-copy-lead.md +0 -20
  119. package/agents/nextjs-engineer.md +0 -20
  120. package/agents/planner.md +0 -20
  121. package/agents/qa-engineer.md +0 -19
  122. package/agents/research-analyst.md +0 -13
  123. package/agents/security-reviewer.md +0 -16
  124. package/agents/supabase-postgres-engineer.md +0 -19
  125. package/antigravity/commands/accessibility-pass.toml +0 -16
  126. package/antigravity/commands/audit.toml +0 -16
  127. package/antigravity/commands/browser-qa.toml +0 -18
  128. package/antigravity/commands/copy.toml +0 -16
  129. package/antigravity/commands/distinctiveness-pass.toml +0 -16
  130. package/antigravity/commands/frontend.toml +0 -18
  131. package/antigravity/commands/handoff.toml +0 -16
  132. package/antigravity/commands/layout-cleanup.toml +0 -16
  133. package/antigravity/commands/plan.toml +0 -18
  134. package/antigravity/commands/responsive-cleanup.toml +0 -16
  135. package/antigravity/commands/review.toml +0 -16
  136. package/antigravity/commands/screenshot-critique.toml +0 -16
  137. package/antigravity/commands/security.toml +0 -16
  138. package/antigravity/commands/setup.toml +0 -16
  139. package/antigravity/commands/ship.toml +0 -17
  140. package/antigravity/commands/spec.toml +0 -17
  141. package/antigravity/commands/test.toml +0 -17
  142. package/antigravity/commands/ui-audit.toml +0 -17
  143. package/antigravity/commands/ui-polish.toml +0 -17
  144. package/antigravity/commands/upgrade.toml +0 -17
  145. package/antigravity/plugin.json +0 -70
  146. package/assistant-adapters/antigravity.md +0 -65
  147. package/assistant-adapters/claude-code-subagents.md +0 -38
  148. package/assistant-adapters/codex-agents.md +0 -53
  149. package/assistant-adapters/cursor-frontend.mdc +0 -16
  150. package/assistant-adapters/cursor-planner.mdc +0 -14
  151. package/assistant-adapters/cursor-security.mdc +0 -18
  152. package/assistant-adapters/github-copilot-instructions.md +0 -35
  153. package/assistant-adapters/github-next-supabase.instructions.md +0 -28
  154. package/assistant-adapters/model-selection/claude-code-subagents-with-models.md +0 -32
  155. package/assistant-adapters/model-selection/codex-config.example.toml +0 -32
  156. package/assistant-adapters/model-selection/cursor-model-selection.mdc +0 -24
  157. package/assistant-adapters/model-selection/github-copilot-model-selection.md +0 -20
  158. package/assistant-adapters/orchestrator-runtime.md +0 -39
  159. package/checklists/accessibility.md +0 -12
  160. package/checklists/agent-council.md +0 -13
  161. package/checklists/brand-content.md +0 -15
  162. package/checklists/deployment.md +0 -10
  163. package/checklists/design-critique.md +0 -13
  164. package/checklists/frontend-distinctiveness.md +0 -12
  165. package/checklists/frontend-product-quality.md +0 -13
  166. package/checklists/frontend-quality.md +0 -21
  167. package/checklists/marketing-copy.md +0 -11
  168. package/checklists/owasp.md +0 -12
  169. package/checklists/rls.md +0 -10
  170. package/checklists/testing.md +0 -12
  171. package/checklists/ui-acceptance-rubric.md +0 -58
  172. package/checklists/ui-detectors.md +0 -81
  173. package/checklists/upgrade.md +0 -13
  174. package/checklists/visual-regression.md +0 -11
  175. package/design-adapters/claude-design.prompt.md +0 -27
  176. package/design-adapters/figma.prompt.md +0 -18
  177. package/design-adapters/google-stitch.prompt.md +0 -36
  178. package/design-adapters/human-designer-brief.prompt.md +0 -36
  179. package/design-briefs/admin-dashboard.md +0 -21
  180. package/design-briefs/ai-workflow-product.md +0 -25
  181. package/design-briefs/community-social.md +0 -26
  182. package/design-briefs/content-app.md +0 -21
  183. package/design-briefs/ecommerce.md +0 -25
  184. package/design-briefs/education-course.md +0 -25
  185. package/design-briefs/marketplace.md +0 -21
  186. package/design-briefs/portfolio-venue.md +0 -25
  187. package/design-briefs/saas.md +0 -21
  188. package/design-briefs/tool.md +0 -21
  189. package/examples/next-supabase-installed/.agent-kit/agent-roster.json +0 -267
  190. package/examples/next-supabase-installed/.agent-kit/model-routing.json +0 -171
  191. package/examples/next-supabase-installed/.agent-kit/overrides.json +0 -3
  192. package/examples/next-supabase-installed/audit-output.json +0 -405
  193. package/model-routing/default-model-routing.json +0 -171
  194. package/profiles/admin-app.md +0 -17
  195. package/profiles/content-app.md +0 -17
  196. package/profiles/marketplace.md +0 -17
  197. package/profiles/saas.md +0 -17
  198. package/profiles/stack-next-firebase.md +0 -25
  199. package/profiles/stack-next-postgres.md +0 -24
  200. package/profiles/stack-remix-supabase.md +0 -24
  201. package/prompts/audit-project-setup.md +0 -28
  202. package/prompts/brand-content-intake.md +0 -17
  203. package/prompts/copy-review.md +0 -15
  204. package/prompts/council-session-review.md +0 -17
  205. package/prompts/creative-direction-matrix.md +0 -22
  206. package/prompts/design-critique-gate.md +0 -28
  207. package/prompts/docs-update.md +0 -16
  208. package/prompts/frontend-design-review.md +0 -35
  209. package/prompts/frontend-distinctiveness-benchmark.md +0 -32
  210. package/prompts/frontend-product-quality-scorecard.md +0 -35
  211. package/prompts/implement-feature.md +0 -14
  212. package/prompts/lifecycle-command-index.md +0 -180
  213. package/prompts/migration-review.md +0 -14
  214. package/prompts/screenshot-review.md +0 -28
  215. package/prompts/security-review.md +0 -17
  216. package/prompts/ui-command-index.md +0 -124
  217. package/prompts/upgrade-review.md +0 -18
  218. package/prompts/visual-qa-plan.md +0 -16
  219. package/research/proposed-updates.md +0 -70
  220. package/research/scan-config.json +0 -261
  221. package/research/scan-plan.md +0 -24
  222. package/research/summaries/.gitkeep +0 -1
  223. package/research/summaries/agent-workflow-patterns.md +0 -37
  224. package/research/summaries/agentic-engineering-maturity-levels.md +0 -54
  225. package/research/summaries/creative-design-patterns.md +0 -38
  226. package/research/summaries/design-critique-patterns.md +0 -34
  227. package/research/summaries/docs-and-agent-patterns.md +0 -64
  228. package/research/summaries/dogfood-adoption-patterns.md +0 -33
  229. package/research/summaries/frontend-design-patterns.md +0 -64
  230. package/research/summaries/frontend-distinctiveness-benchmark-patterns.md +0 -38
  231. package/research/summaries/frontend-product-quality-rubric-patterns.md +0 -37
  232. package/research/summaries/maturity-model-patterns.md +0 -29
  233. package/research/summaries/nextjs-patterns.md +0 -65
  234. package/research/summaries/repo-health-patterns.md +0 -41
  235. package/research/summaries/scan-overview.md +0 -46
  236. package/research/summaries/security-patterns.md +0 -64
  237. package/research/summaries/supabase-rls-patterns.md +0 -54
  238. package/research/summaries/supply-chain-patterns.md +0 -38
  239. package/research/summaries/testing-patterns.md +0 -63
  240. package/research/summaries/upgrade-lifecycle-patterns.md +0 -26
  241. package/research/summaries/visual-qa-patterns.md +0 -39
  242. package/rosters/next-supabase-default-council.json +0 -267
  243. package/runtime-skills/README.md +0 -7
  244. package/runtime-skills/accessibility-wcag/SKILL.md +0 -8
  245. package/runtime-skills/agent-handoff-tracing/SKILL.md +0 -8
  246. package/runtime-skills/best-practice-maturity-review/SKILL.md +0 -8
  247. package/runtime-skills/content-first-design/SKILL.md +0 -8
  248. package/runtime-skills/conversion-copywriting/SKILL.md +0 -8
  249. package/runtime-skills/deployment-observability/SKILL.md +0 -8
  250. package/runtime-skills/docs-maintainer/SKILL.md +0 -8
  251. package/runtime-skills/frontend-design-system/SKILL.md +0 -8
  252. package/runtime-skills/frontend-distinctiveness-benchmark/SKILL.md +0 -8
  253. package/runtime-skills/frontend-product-quality-rubric/SKILL.md +0 -8
  254. package/runtime-skills/landing-page-copy/SKILL.md +0 -8
  255. package/runtime-skills/nextjs-app-router/SKILL.md +0 -8
  256. package/runtime-skills/onboarding-empty-state-copy/SKILL.md +0 -8
  257. package/runtime-skills/owasp-security-review/SKILL.md +0 -8
  258. package/runtime-skills/planning-council/SKILL.md +0 -8
  259. package/runtime-skills/positioning-messaging/SKILL.md +0 -8
  260. package/runtime-skills/postgres-migrations/SKILL.md +0 -8
  261. package/runtime-skills/product-voice-tone/SKILL.md +0 -8
  262. package/runtime-skills/reference-led-design-critique/SKILL.md +0 -8
  263. package/runtime-skills/supabase-auth-rls/SKILL.md +0 -8
  264. package/runtime-skills/testing-qa/SKILL.md +0 -8
  265. package/runtime-skills/ui-improvement-harness/SKILL.md +0 -12
  266. package/runtime-skills/upgrade-maintenance/SKILL.md +0 -8
  267. package/runtime-skills/visual-regression-qa/SKILL.md +0 -8
  268. package/schemas/agent-roster.schema.json +0 -54
  269. package/schemas/agentic-level.schema.json +0 -47
  270. package/schemas/audit-report-v2.schema.json +0 -71
  271. package/schemas/audit-report.schema.json +0 -50
  272. package/schemas/correction-rules.schema.json +0 -32
  273. package/schemas/council-session.schema.json +0 -65
  274. package/schemas/model-routing.schema.json +0 -72
  275. package/schemas/onboarding-state.schema.json +0 -36
  276. package/schemas/orchestrator.schema.json +0 -167
  277. package/schemas/project-context.schema.json +0 -94
  278. package/schemas/runtime-event.schema.json +0 -66
  279. package/schemas/runtime-run.schema.json +0 -58
  280. package/schemas/session-event.schema.json +0 -48
  281. package/schemas/studio-session.schema.json +0 -48
  282. package/skills/accessibility-wcag.md +0 -15
  283. package/skills/agent-handoff-tracing.md +0 -44
  284. package/skills/best-practice-maturity-review.md +0 -26
  285. package/skills/content-first-design.md +0 -50
  286. package/skills/conversion-copywriting.md +0 -38
  287. package/skills/deployment-observability.md +0 -14
  288. package/skills/docs-maintainer.md +0 -19
  289. package/skills/frontend-design-system.md +0 -68
  290. package/skills/frontend-distinctiveness-benchmark.md +0 -40
  291. package/skills/frontend-product-quality-rubric.md +0 -59
  292. package/skills/landing-page-copy.md +0 -29
  293. package/skills/nextjs-app-router.md +0 -18
  294. package/skills/onboarding-empty-state-copy.md +0 -37
  295. package/skills/owasp-security-review.md +0 -19
  296. package/skills/planning-council.md +0 -21
  297. package/skills/positioning-messaging.md +0 -42
  298. package/skills/postgres-migrations.md +0 -14
  299. package/skills/product-voice-tone.md +0 -35
  300. package/skills/reference-led-design-critique.md +0 -48
  301. package/skills/supabase-auth-rls.md +0 -20
  302. package/skills/testing-qa.md +0 -15
  303. package/skills/ui-improvement-harness.md +0 -96
  304. package/skills/upgrade-maintenance.md +0 -32
  305. package/skills/visual-regression-qa.md +0 -42
  306. package/templates/next-supabase/.agent-kit/orchestrator.json +0 -48
  307. package/templates/next-supabase/.agent-kit/runtime/gitignore.template +0 -2
  308. package/templates/next-supabase/.github/workflows/agent-kit-audit.yml +0 -34
  309. package/templates/next-supabase/AGENT_ROSTER.md +0 -101
  310. package/templates/next-supabase/ASSISTANT_ADAPTERS.md +0 -146
  311. package/templates/next-supabase/COUNCIL.md +0 -54
  312. package/templates/next-supabase/DECISIONS.md +0 -87
  313. package/templates/next-supabase/DEPLOYMENT.md +0 -51
  314. package/templates/next-supabase/DESIGN.md +0 -180
  315. package/templates/next-supabase/DOCS.md +0 -80
  316. package/templates/next-supabase/LOOP_CODING.md +0 -98
  317. package/templates/next-supabase/MESSAGING.md +0 -81
  318. package/templates/next-supabase/MODEL_ROUTING.md +0 -130
  319. package/templates/next-supabase/QUALITY_GATES.md +0 -98
  320. package/templates/next-supabase/SKILLS.md +0 -235
  321. package/templates/next-supabase/SPEC.md +0 -122
  322. package/templates/next-supabase/STYLE_GUIDE.md +0 -121
  323. package/templates/next-supabase/TESTING.md +0 -107
@@ -1,18 +0,0 @@
1
- name = "plan"
2
- description = "Create an implementation-ready Agent Kit plan through Planner and Lead Architect routing."
3
-
4
- prompt = """
5
- Run the planning workflow.
6
-
7
- Canonical sources: AGENTS.md, AGENT_ROSTER.md, .agent-kit/agent-roster.json, MODEL_ROUTING.md, .agent-kit/model-routing.json, .agent-kit/project-context.md, .agent-kit/corrections/project-rules.json, COUNCIL.md, and QUALITY_GATES.md.
8
-
9
- Workflow:
10
- 1. Start with Planner.
11
- 2. Name the active workflow and maturity target from QUALITY_GATES.md.
12
- 3. Map affected layers: data, business logic, presentation, auth, deployment, docs, and tests.
13
- 4. Name preserved behavior and compatibility constraints.
14
- 5. Route core changes through Lead Architect before implementation.
15
- 6. Record decision, risk, next handoff, and required outputs with `agent-kit session ...` when available.
16
-
17
- Required outputs: goal, affected layers, preserved capabilities, implementation sequence, risks, tests, docs, handoffs, acceptance criteria.
18
- """
@@ -1,16 +0,0 @@
1
- name = "responsive-cleanup"
2
- description = "Verify and repair mobile and responsive UI behavior with required desktop and mobile evidence."
3
-
4
- prompt = """
5
- Run the responsive cleanup workflow.
6
-
7
- Canonical sources: DESIGN.md, STYLE_GUIDE.md, TESTING.md, QUALITY_GATES.md, .agent-kit/agent-roster.json, .agent-kit/skills/ui-improvement-harness.md, .agent-kit/checklists/ui-detectors.md, .agent-kit/checklists/ui-acceptance-rubric.md, and .agent-kit/prompts/ui-command-index.md.
8
-
9
- Workflow:
10
- 1. Review mobile width, desktop width, and project-specific breakpoint assumptions.
11
- 2. Verify tap targets, text fit, navigation, primary action visibility, sticky UI, scroll behavior, and viewport-safe spacing.
12
- 3. Verify relevant loading, empty, error, disabled, success, permission, and focus states on mobile.
13
- 4. Capture or request desktop and mobile screenshots before acceptance.
14
-
15
- Required outputs: viewports checked, responsive findings, fixes made or proposed, screenshots, remaining risks.
16
- """
@@ -1,16 +0,0 @@
1
- name = "review"
2
- description = "Run pre-merge code health review with QA and conditional Security Reviewer routing."
3
-
4
- prompt = """
5
- Run the code-review workflow.
6
-
7
- Canonical sources: TESTING.md, SECURITY.md, QUALITY_GATES.md, AGENTS.md, .agent-kit/agent-roster.json, .agent-kit/skills/testing-qa.md, .agent-kit/skills/owasp-security-review.md, and .agent-kit/prompts/lifecycle-command-index.md.
8
-
9
- Workflow:
10
- 1. Route through QA Engineer for behavior, regression, and test evidence.
11
- 2. Include Security Reviewer when auth, RLS, data mutation, dependency, secret, or external-call boundaries changed.
12
- 3. Return findings by severity with concrete remediation.
13
- 4. Distinguish this from release GO/NO-GO, which belongs to `/ship`.
14
-
15
- Required outputs: reviewed scope, findings by severity, required fixes, security notes when applicable, merge recommendation.
16
- """
@@ -1,16 +0,0 @@
1
- name = "screenshot-critique"
2
- description = "Critique desktop, mobile, state, and authenticated screenshots against design and detector rules."
3
-
4
- prompt = """
5
- Run the screenshot critique workflow.
6
-
7
- Canonical sources: DESIGN.md, STYLE_GUIDE.md, TESTING.md, QUALITY_GATES.md, .agent-kit/agent-roster.json, .agent-kit/skills/ui-improvement-harness.md, .agent-kit/checklists/ui-detectors.md, .agent-kit/checklists/ui-acceptance-rubric.md, .agent-kit/prompts/screenshot-review.md, and .agent-kit/prompts/ui-command-index.md.
8
-
9
- Workflow:
10
- 1. Name each screenshot, viewport, route, auth state, data state, and UI state.
11
- 2. Run screenshot review, detector checklist, and accessibility risk scan.
12
- 3. Compare against DESIGN.md, STYLE_GUIDE.md, and selected creative direction.
13
- 4. Return concrete fixes and missing screenshot evidence.
14
-
15
- Required outputs: screenshot inventory, blockers, high-value fixes, accepted areas, missing screenshots, release verdict.
16
- """
@@ -1,16 +0,0 @@
1
- name = "security"
2
- description = "Run OWASP, auth, RLS, dependency, secret, and external-call review before acceptance."
3
-
4
- prompt = """
5
- Run the security-review workflow.
6
-
7
- Canonical sources: SECURITY.md, .agent-kit/checklists/owasp.md, .agent-kit/checklists/rls.md, .agent-kit/skills/owasp-security-review.md, AGENTS.md, and .agent-kit/agent-roster.json.
8
-
9
- Workflow:
10
- 1. Route through Security Reviewer for auth, RLS, API, Server Action, data mutation, dependency, secret, external-call, upload, or release-risk changes.
11
- 2. Check OWASP Top 10, IDOR, SSRF, injection, broken auth, unsafe output rendering, secret leakage, and vulnerable dependencies.
12
- 3. Verify service-role access stays server-only.
13
- 4. Record findings with severity, exploit path, affected behavior, and remediation.
14
-
15
- Required outputs: reviewed boundaries, findings, severity, exploit path, mitigation, negative authorization tests or skipped rationale.
16
- """
@@ -1,16 +0,0 @@
1
- name = "setup"
2
- description = "Onboard the project into Agent Kit context and verify runtime adapter setup."
3
-
4
- prompt = """
5
- Run Agent Kit setup as a runtime command.
6
-
7
- Canonical sources: AGENTS.md, AGENT_ROSTER.md, .agent-kit/agent-roster.json, MODEL_ROUTING.md, .agent-kit/model-routing.json, QUALITY_GATES.md, and ASSISTANT_ADAPTERS.md.
8
-
9
- Workflow:
10
- 1. Run or recommend `agent-kit setup --open` when project context is missing.
11
- 2. Validate context with `agent-kit context validate`.
12
- 3. Confirm adapter evidence in ASSISTANT_ADAPTERS.md.
13
- 4. Record setup evidence in an Agent Studio session when meaningful work starts.
14
-
15
- Required outputs: project context status, active IDE/runtime surface, model-selection status, remaining setup gaps, verification command.
16
- """
@@ -1,17 +0,0 @@
1
- name = "ship"
2
- description = "Make a GO/NO-GO release call from council, security, QA, docs, deployment, and rollback evidence."
3
-
4
- prompt = """
5
- Run the ship workflow.
6
-
7
- Canonical sources: QUALITY_GATES.md, TESTING.md, SECURITY.md, DEPLOYMENT.md, UPGRADE.md, COUNCIL.md, .agent-kit/council-sessions/, and .agent-kit/agent-roster.json.
8
-
9
- Workflow:
10
- 1. Confirm implementation scope and preserved behavior.
11
- 2. Require code review, Security Reviewer signoff, QA/test evidence, accessibility evidence when UI changed, docs evidence, deployment/observability review, and rollback plan.
12
- 3. Run the project release gate, normally `npm run release:check` for this package or the project-specific equivalent.
13
- 4. Record verification with `agent-kit session verify`.
14
- 5. Return GO only when required outputs are complete or explicitly not-applicable.
15
-
16
- Required outputs: code review, security review, QA/test review, accessibility/doc/deployment checks, rollback plan, release command, GO/NO-GO verdict.
17
- """
@@ -1,17 +0,0 @@
1
- name = "spec"
2
- description = "Define or update SPEC.md with acceptance criteria before implementation."
3
-
4
- prompt = """
5
- Run the spec workflow.
6
-
7
- Canonical sources: SPEC.md, AGENTS.md, AGENT_ROSTER.md, .agent-kit/agent-roster.json, .agent-kit/project-context.md, .agent-kit/corrections/project-rules.json, QUALITY_GATES.md, and .agent-kit/prompts/lifecycle-command-index.md.
8
-
9
- Workflow:
10
- 1. Route through Planner and Documentation Maintainer.
11
- 2. Read project context and active correction rules before drafting or updating the spec.
12
- 3. Capture goal, user/workflow, acceptance criteria, preserved behavior, non-goals, and docs impact.
13
- 4. Map affected layers: data, business logic, presentation, auth, deployment, and tests.
14
- 5. Record decision, risk, and next handoff with `agent-kit session ...` when a session is active.
15
-
16
- Required outputs: spec delta or draft, acceptance criteria, preserved capabilities, non-goals, verification plan, next handoff.
17
- """
@@ -1,17 +0,0 @@
1
- name = "test"
2
- description = "Add or run tests and produce acceptance evidence per TESTING.md and QUALITY_GATES.md."
3
-
4
- prompt = """
5
- Run the test workflow.
6
-
7
- Canonical sources: TESTING.md, QUALITY_GATES.md, AGENTS.md, .agent-kit/agent-roster.json, .agent-kit/skills/testing-qa.md, and .agent-kit/prompts/lifecycle-command-index.md.
8
-
9
- Workflow:
10
- 1. Route through QA Engineer.
11
- 2. Name unit, regression, smoke, and visual QA gaps for the change scope.
12
- 3. Prioritize auth and data mutation paths.
13
- 4. Run project test commands and capture results.
14
- 5. Record verification with `agent-kit session verify` when a session is active.
15
-
16
- Required outputs: test plan, commands run, pass/fail summary, coverage gaps, skipped-test rationale.
17
- """
@@ -1,17 +0,0 @@
1
- name = "ui-audit"
2
- description = "Run a deterministic UI audit with severity-based detector findings and release evidence."
3
-
4
- prompt = """
5
- Run the UI audit workflow.
6
-
7
- Canonical sources: DESIGN.md, STYLE_GUIDE.md, TESTING.md, QUALITY_GATES.md, .agent-kit/agent-roster.json, .agent-kit/skills/ui-improvement-harness.md, .agent-kit/checklists/ui-detectors.md, .agent-kit/checklists/ui-acceptance-rubric.md, and .agent-kit/prompts/ui-command-index.md.
8
-
9
- Workflow:
10
- 1. Identify target route, component, workflow, auth state, data state, and risk tier.
11
- 2. Load product/design context and relevant design brief.
12
- 3. Review desktop and mobile evidence, or state which evidence must still be captured.
13
- 4. Run the UI detector checklist and classify blockers, majors, minors, passes, and not-applicable items.
14
- 5. Return required fixes, accepted exceptions, preserved capabilities, and pass/fail verdict.
15
-
16
- Required outputs: target surface, risk tier, detector findings by severity, missing evidence, release verdict.
17
- """
@@ -1,17 +0,0 @@
1
- name = "ui-polish"
2
- description = "Improve UI hierarchy, spacing, state feedback, and visual finish through detector-guided polish."
3
-
4
- prompt = """
5
- Run the UI polish workflow.
6
-
7
- Canonical sources: DESIGN.md, STYLE_GUIDE.md, TESTING.md, QUALITY_GATES.md, .agent-kit/agent-roster.json, .agent-kit/skills/ui-improvement-harness.md, .agent-kit/checklists/ui-detectors.md, .agent-kit/checklists/ui-acceptance-rubric.md, and .agent-kit/prompts/ui-command-index.md.
8
-
9
- Workflow:
10
- 1. Start from detector findings, screenshots, or a named target surface.
11
- 2. Preserve product behavior, auth boundaries, copy claims, data contracts, and existing component patterns.
12
- 3. Improve hierarchy, spacing, density, alignment, component states, and interaction feedback.
13
- 4. Remove decorative clutter and generic SaaS or AI-site defaults.
14
- 5. Re-run detector and screenshot critique after the scoped polish pass.
15
-
16
- Required outputs: polish goals, changes made or proposed, detector deltas, screenshot evidence, residual risks.
17
- """
@@ -1,17 +0,0 @@
1
- name = "upgrade"
2
- description = "Plan and verify Agent Kit, framework, dependency, and adapter upgrades with rollback evidence."
3
-
4
- prompt = """
5
- Run the upgrade-maintenance workflow.
6
-
7
- Canonical sources: UPGRADE.md, CHANGELOG.md, DECISIONS.md, DEPLOYMENT.md, .agent-kit/skills/upgrade-maintenance.md, and QUALITY_GATES.md.
8
-
9
- Workflow:
10
- 1. Run `agent-kit diff` before accepting template changes.
11
- 2. Preserve local overrides and review `.agent-kit/conflicts/`.
12
- 3. Check framework release notes, codemods, migrations, generated types, RLS impact, and rollback risk when applicable.
13
- 4. Run `agent-kit audit --min-readiness baseline-setup` after update.
14
- 5. Record version, migration impact, verification, owner, and rollback evidence.
15
-
16
- Required outputs: version change, conflict review, migration impact, generated files/types, audit result, rollback plan, owner/date.
17
- """
@@ -1,70 +0,0 @@
1
- {
2
- "schemaVersion": 1,
3
- "name": "agent-kit-next-supabase",
4
- "displayName": "Agent Kit Next/Supabase",
5
- "version": "0.1.8",
6
- "description": "Runtime commands and portable skills for the Agent Kit Next/Supabase council workflow.",
7
- "homepage": "https://github.com/lukey662/agentsandskills",
8
- "sourceOfTruth": [
9
- "AGENTS.md",
10
- "AGENT_ROSTER.md",
11
- ".agent-kit/agent-roster.json",
12
- "MODEL_ROUTING.md",
13
- ".agent-kit/model-routing.json",
14
- "QUALITY_GATES.md",
15
- "COUNCIL.md",
16
- ".agent-kit/council-sessions/"
17
- ],
18
- "commands": [
19
- { "name": "setup", "path": "commands/setup.toml" },
20
- { "name": "spec", "path": "commands/spec.toml" },
21
- { "name": "audit", "path": "commands/audit.toml" },
22
- { "name": "plan", "path": "commands/plan.toml" },
23
- { "name": "handoff", "path": "commands/handoff.toml" },
24
- { "name": "frontend", "path": "commands/frontend.toml" },
25
- { "name": "ui-audit", "path": "commands/ui-audit.toml" },
26
- { "name": "ui-polish", "path": "commands/ui-polish.toml" },
27
- { "name": "layout-cleanup", "path": "commands/layout-cleanup.toml" },
28
- { "name": "responsive-cleanup", "path": "commands/responsive-cleanup.toml" },
29
- { "name": "accessibility-pass", "path": "commands/accessibility-pass.toml" },
30
- { "name": "distinctiveness-pass", "path": "commands/distinctiveness-pass.toml" },
31
- { "name": "screenshot-critique", "path": "commands/screenshot-critique.toml" },
32
- { "name": "browser-qa", "path": "commands/browser-qa.toml" },
33
- { "name": "test", "path": "commands/test.toml" },
34
- { "name": "review", "path": "commands/review.toml" },
35
- { "name": "security", "path": "commands/security.toml" },
36
- { "name": "copy", "path": "commands/copy.toml" },
37
- { "name": "ship", "path": "commands/ship.toml" },
38
- { "name": "upgrade", "path": "commands/upgrade.toml" }
39
- ],
40
- "skills": [
41
- { "name": "accessibility-wcag", "path": "../runtime-skills/accessibility-wcag/SKILL.md" },
42
- { "name": "agent-handoff-tracing", "path": "../runtime-skills/agent-handoff-tracing/SKILL.md" },
43
- { "name": "best-practice-maturity-review", "path": "../runtime-skills/best-practice-maturity-review/SKILL.md" },
44
- { "name": "content-first-design", "path": "../runtime-skills/content-first-design/SKILL.md" },
45
- { "name": "conversion-copywriting", "path": "../runtime-skills/conversion-copywriting/SKILL.md" },
46
- { "name": "deployment-observability", "path": "../runtime-skills/deployment-observability/SKILL.md" },
47
- { "name": "docs-maintainer", "path": "../runtime-skills/docs-maintainer/SKILL.md" },
48
- { "name": "frontend-design-system", "path": "../runtime-skills/frontend-design-system/SKILL.md" },
49
- { "name": "frontend-distinctiveness-benchmark", "path": "../runtime-skills/frontend-distinctiveness-benchmark/SKILL.md" },
50
- { "name": "frontend-product-quality-rubric", "path": "../runtime-skills/frontend-product-quality-rubric/SKILL.md" },
51
- { "name": "landing-page-copy", "path": "../runtime-skills/landing-page-copy/SKILL.md" },
52
- { "name": "ui-improvement-harness", "path": "../runtime-skills/ui-improvement-harness/SKILL.md" },
53
- { "name": "nextjs-app-router", "path": "../runtime-skills/nextjs-app-router/SKILL.md" },
54
- { "name": "onboarding-empty-state-copy", "path": "../runtime-skills/onboarding-empty-state-copy/SKILL.md" },
55
- { "name": "owasp-security-review", "path": "../runtime-skills/owasp-security-review/SKILL.md" },
56
- { "name": "planning-council", "path": "../runtime-skills/planning-council/SKILL.md" },
57
- { "name": "positioning-messaging", "path": "../runtime-skills/positioning-messaging/SKILL.md" },
58
- { "name": "postgres-migrations", "path": "../runtime-skills/postgres-migrations/SKILL.md" },
59
- { "name": "product-voice-tone", "path": "../runtime-skills/product-voice-tone/SKILL.md" },
60
- { "name": "reference-led-design-critique", "path": "../runtime-skills/reference-led-design-critique/SKILL.md" },
61
- { "name": "supabase-auth-rls", "path": "../runtime-skills/supabase-auth-rls/SKILL.md" },
62
- { "name": "testing-qa", "path": "../runtime-skills/testing-qa/SKILL.md" },
63
- { "name": "upgrade-maintenance", "path": "../runtime-skills/upgrade-maintenance/SKILL.md" },
64
- { "name": "visual-regression-qa", "path": "../runtime-skills/visual-regression-qa/SKILL.md" }
65
- ],
66
- "validation": {
67
- "agentKit": "agent-kit adapter validate antigravity",
68
- "nativeOptional": "agy plugin validate"
69
- }
70
- }
@@ -1,65 +0,0 @@
1
- # Antigravity Adapter
2
-
3
- This adapter packages Agent Kit as native Antigravity-style plugin assets while keeping the Agent Kit council contract canonical.
4
-
5
- ## Source Of Truth
6
-
7
- - `AGENTS.md`
8
- - `AGENT_ROSTER.md`
9
- - `.agent-kit/agent-roster.json`
10
- - `MODEL_ROUTING.md`
11
- - `.agent-kit/model-routing.json`
12
- - `.agent-kit/project-context.json`
13
- - `.agent-kit/project-context.md`
14
- - `.agent-kit/corrections/project-rules.json`
15
- - `.agent-kit/corrections/agent-rules.json`
16
- - `COUNCIL.md`
17
- - `.agent-kit/council-sessions/`
18
- - `QUALITY_GATES.md`
19
-
20
- Runtime command files must wrap those files. Do not fork role definitions, security policy, frontend quality rules, release gates, or session evidence rules into command prompts.
21
-
22
- Antigravity commands are instruction adapters. They do not replace or prove execution by `@appsforgood/agent-kit-runtime`; use `agent-kit orchestrate status` and exported run evidence for that claim.
23
-
24
- ## Activation
25
-
26
- ```bash
27
- agent-kit init --activate antigravity
28
- agent-kit adapter validate antigravity
29
- ```
30
-
31
- This installs:
32
-
33
- - `.antigravity/agent-kit/plugin.json`
34
- - `.antigravity/agent-kit/commands/*.toml`
35
- - `.antigravity/runtime-skills/*/SKILL.md`
36
- - `.antigravity/agent-kit/README.md`
37
-
38
- If the `agy` CLI is available, teams may additionally run its native plugin validation. Agent Kit only requires structural validation because many projects will not have Antigravity installed locally.
39
-
40
- ## Command Contract
41
-
42
- Commands expose short runtime entrypoints:
43
-
44
- - `/setup`
45
- - `/spec`
46
- - `/audit`
47
- - `/plan`
48
- - `/handoff`
49
- - `/frontend`
50
- - `/test`
51
- - `/review`
52
- - `/security`
53
- - `/copy`
54
- - `/ship`
55
- - `/upgrade`
56
-
57
- UI harness commands (`/ui-audit`, `/ui-polish`, `/layout-cleanup`, `/responsive-cleanup`, `/accessibility-pass`, `/distinctiveness-pass`, `/screenshot-critique`, `/browser-qa`) are documented in `.agent-kit/prompts/ui-command-index.md`.
58
-
59
- Delivery lifecycle commands are documented in `.agent-kit/prompts/lifecycle-command-index.md`.
60
-
61
- Each command must load project context and correction rules when present, select the appropriate roster workflow, record required outputs with `agent-kit session output`, and render sessions when evidence changes.
62
-
63
- ## Security
64
-
65
- Do not place tokens, credentials, private URLs, database URLs, customer data, or hidden model reasoning in Antigravity plugin files, command files, or runtime skills.
@@ -1,38 +0,0 @@
1
- # Claude Code Subagent Adapter
2
-
3
- Claude Code projects can activate Agent Kit by creating project subagents that point back to the canonical council files.
4
-
5
- Use `MODEL_ROUTING.md` and `.agent-kit/model-routing.json` when adding model comments or frontmatter to those subagents.
6
-
7
- ## Suggested Project Layout
8
-
9
- ```text
10
- .claude/
11
- agents/
12
- planner.md
13
- lead-architect.md
14
- frontend-design-lead.md
15
- security-reviewer.md
16
- qa-engineer.md
17
- ```
18
-
19
- ## Subagent Frontmatter Pattern
20
-
21
- ```md
22
- ---
23
- name: planner
24
- description: Use for planning, phasing, scope breakdown, workflow routing, and council setup in this repository.
25
- ---
26
-
27
- Read `AGENTS.md`, `AGENT_ROSTER.md`, `.agent-kit/agent-roster.json`, `.agent-kit/project-context.json`, `.agent-kit/project-context.md`, `.agent-kit/agent-briefs.md` when present, `.agent-kit/corrections/project-rules.json`, `.agent-kit/corrections/agent-rules.json`, `COUNCIL.md`, `.agent-kit/council-sessions/`, and `QUALITY_GATES.md` before making routing decisions.
28
-
29
- Start with the Planner workflow. For core changes, hand off to Lead Architect. For frontend changes, require Frontend Design Lead evidence. For auth, RLS, secrets, dependency, external-call, or release-risk changes, require Security Reviewer. Record meaningful decisions, risks, handoffs, human corrections, artifacts, evidence, and verification through Agent Studio session files when available.
30
- ```
31
-
32
- ## Guardrails
33
-
34
- - Keep detailed role behavior in `AGENTS.md` and `AGENT_ROSTER.md`; subagent files should be focused entry points.
35
- - Document active subagents and verification evidence in `ASSISTANT_ADAPTERS.md`.
36
- - Record model-selection evidence and limitations in `ASSISTANT_ADAPTERS.md`.
37
- - Avoid giving a subagent broader tool access than its role needs.
38
- - Treat Claude subagents as instruction adapters. Use `agent-kit orchestrate ...` and its run evidence when the task requires the executable checkpointed council.
@@ -1,53 +0,0 @@
1
- # Codex / AGENTS.md Adapter
2
-
3
- Use `AGENTS.md` as the primary project instruction surface.
4
-
5
- ## Required References
6
-
7
- - `AGENTS.md`
8
- - `AGENT_ROSTER.md`
9
- - `.agent-kit/agent-roster.json`
10
- - `MODEL_ROUTING.md`
11
- - `.agent-kit/model-routing.json`
12
- - `.agent-kit/project-context.json`
13
- - `.agent-kit/project-context.md`
14
- - `.agent-kit/agent-briefs.md` when present
15
- - `.agent-kit/corrections/project-rules.json`
16
- - `.agent-kit/corrections/agent-rules.json`
17
- - `COUNCIL.md`
18
- - `.agent-kit/council-sessions/`
19
- - `QUALITY_GATES.md`
20
-
21
- ## Council Custom Agents
22
-
23
- After `agent-kit init --activate codex`, council specialists live in `.codex/agents/*.toml`.
24
-
25
- Spawn a dedicated custom agent instead of role-playing the whole council in one thread:
26
-
27
- - **Planning / scope:** `.codex/agents/planner.toml`
28
- - **Security / RLS / secrets:** `.codex/agents/security-reviewer.toml` (high reasoning effort)
29
- - **Frontend UI:** `.codex/agents/frontend-design-lead.toml`
30
- - **QA / tests:** `.codex/agents/qa-engineer.toml`
31
-
32
- Each file sets `model_reasoning_effort` from `.agent-kit/model-routing.json`. Verify model names in your Codex environment against `MODEL_ROUTING.md`.
33
-
34
- ## Operating Rule
35
-
36
- When a task is planning-oriented, ambiguous, risky, frontend-facing, security-sensitive, or release-related, start from the roster workflow instead of treating the request as a single generic implementation pass.
37
-
38
- Use `MODEL_ROUTING.md` to choose the model profile or reasoning effort for the active role. Exact model names belong in dated config comments, not in the role definitions.
39
-
40
- Before meaningful work, load project context, agent briefs when present, and active correction rules. For meaningful handoffs, record visible decisions and evidence with `agent-kit session checkpoint --file <json>` or individual `agent-kit session ...` commands, then run `agent-kit session render`.
41
-
42
- ## Verification
43
-
44
- Record in `ASSISTANT_ADAPTERS.md`:
45
-
46
- - The tool/version or environment where `AGENTS.md` was observed.
47
- - The command, session, or screenshot that proves the instructions loaded.
48
- - The model-selection setting or profile used for the active role.
49
- - Any known limitations or manual invocation steps.
50
-
51
- Run `agent-kit adapter validate codex` after activation.
52
-
53
- Codex custom agents are instruction adapters. Use `agent-kit orchestrate validate`, `plan`, `run`, and `status` when a task requires the executable checkpointed council; do not infer graph execution from a delegated IDE thread.
@@ -1,16 +0,0 @@
1
- ---
2
- description: Require Frontend Design Lead evidence for significant UI and component work.
3
- globs:
4
- - "src/app/**"
5
- - "src/components/**"
6
- - "**/*.css"
7
- alwaysApply: false
8
- ---
9
-
10
- # Frontend design gate reminders
11
-
12
- Significant UI changes require **Frontend Design Lead** review: brand/content intake, creative-direction rationale, reference-led critique, product-quality scorecard, accessibility, and visual QA evidence.
13
-
14
- Delegate to `@frontend-design-lead` in `.cursor/agents/frontend-design-lead.md` for isolated design review context.
15
-
16
- Reject generic AI-looking UI that is not specific to the product workflow and content model.
@@ -1,14 +0,0 @@
1
- ---
2
- description: Route ambiguous, planning, and cross-layer requests through the Planner workflow first.
3
- globs:
4
- - "**/*"
5
- alwaysApply: false
6
- ---
7
-
8
- # Planner routing
9
-
10
- When a request is ambiguous, planning-oriented, roadmap-related, or spans multiple layers, start with the **Planner** workflow before implementation.
11
-
12
- Delegate to the `@planner` subagent in `.cursor/agents/planner.md` when the task needs isolated planning context.
13
-
14
- Read `AGENTS.md`, `.agent-kit/agent-roster.json`, `MODEL_ROUTING.md`, project context, and active corrections before choosing a workflow.
@@ -1,18 +0,0 @@
1
- ---
2
- description: Require Security Reviewer for auth, RLS, secrets, API mutations, and external calls.
3
- globs:
4
- - "supabase/**"
5
- - "**/auth/**"
6
- - "**/api/**"
7
- - "**/middleware.ts"
8
- - "**/proxy.ts"
9
- alwaysApply: false
10
- ---
11
-
12
- # Security gate reminders
13
-
14
- Auth, RLS, data mutation, dependency, secret, external-call, and release-risk changes require **Security Reviewer** review before acceptance.
15
-
16
- Delegate to `@security-reviewer` in `.cursor/agents/security-reviewer.md` or Task `security-review` for isolated review context.
17
-
18
- Verify OWASP Top 10, IDOR, SSRF, injection, broken auth, and least-privilege boundaries.
@@ -1,35 +0,0 @@
1
- # Repository Instructions
2
-
3
- This repository uses Agent Kit. Treat `AGENTS.md`, `AGENT_ROSTER.md`, `.agent-kit/agent-roster.json`, `MODEL_ROUTING.md`, `.agent-kit/model-routing.json`, `.agent-kit/project-context.json`, `.agent-kit/project-context.md`, `.agent-kit/agent-briefs.md` when present, `.agent-kit/corrections/project-rules.json`, `.agent-kit/corrections/agent-rules.json`, `COUNCIL.md`, `.agent-kit/council-sessions/`, and `QUALITY_GATES.md` as the source of truth for agent routing, project context, correction rules, model profiles, quality gates, and handoff evidence.
4
-
5
- ## Workflows
6
-
7
- - Planning, phased roadmap, or ambiguous work starts with Planner.
8
- - Core changes require Lead Architect before implementation.
9
- - Frontend changes require Frontend Design Lead, brand/content intake, creative-direction rationale, visual QA evidence, state coverage, accessibility checks, and desktop/mobile verification.
10
- - Auth, RLS, data mutations, dependency changes, external calls, secrets, and release risk require Security Reviewer.
11
- - Behavior changes require QA evidence.
12
- - Significant changes require Documentation Maintainer updates.
13
- - Meaningful work should read local project context and active correction rules before implementation.
14
- - User corrections should be recorded before continuing, then applied to future sessions when durable.
15
- - Meaningful multi-agent work should record visible decisions, handoffs, artifacts, and verification in Agent Studio session files when available.
16
-
17
- ## Validation
18
-
19
- Before proposing completion, run the repo's documented checks. For projects installed from this kit, the minimum setup check is:
20
-
21
- ```sh
22
- agent-kit audit --min-readiness baseline-setup
23
- ```
24
-
25
- Use a stronger gate before claiming best-practice readiness:
26
-
27
- ```sh
28
- agent-kit audit --min-readiness best-practice-candidate
29
- ```
30
-
31
- Do not claim best-practice readiness while starter placeholders remain in `COUNCIL.md`, `SPEC.md`, `DESIGN.md`, `SECURITY.md`, `TESTING.md`, `DEPLOYMENT.md`, or `ASSISTANT_ADAPTERS.md`.
32
-
33
- ## Model Selection
34
-
35
- Use the active Copilot model selector or organization policy with `MODEL_ROUTING.md`. Repository instructions advise model choice but should not be treated as hard enforcement where Copilot keeps model selection user-controlled.
@@ -1,28 +0,0 @@
1
- ---
2
- applyTo: "app/**/*.{ts,tsx},src/app/**/*.{ts,tsx},pages/**/*.{ts,tsx},src/pages/**/*.{ts,tsx},components/**/*.{ts,tsx},lib/**/*.{ts,tsx},utils/**/*.{ts,tsx},supabase/**/*,*.sql"
3
- ---
4
-
5
- # Next.js + Supabase Agent Kit Instructions
6
-
7
- Follow `AGENTS.md`, `AGENT_ROSTER.md`, `.agent-kit/agent-roster.json`, `MODEL_ROUTING.md`, `.agent-kit/model-routing.json`, `.agent-kit/project-context.json`, `.agent-kit/project-context.md`, `.agent-kit/agent-briefs.md` when present, `.agent-kit/corrections/project-rules.json`, `.agent-kit/corrections/agent-rules.json`, `COUNCIL.md`, `.agent-kit/council-sessions/`, and `QUALITY_GATES.md`.
8
-
9
- ## Next.js
10
-
11
- - Keep Server Component, Client Component, Route Handler, and Server Action boundaries explicit.
12
- - Do not expose secrets, service-role keys, privileged queries, or admin-only data to client bundles.
13
- - Preserve loading, empty, error, disabled, success, focus, and mobile states for user-facing changes.
14
-
15
- ## Supabase
16
-
17
- - Enforce authorization with Postgres RLS where applicable.
18
- - Treat service-role access as server-only.
19
- - Document migration order, rollback risk, indexes, constraints, and policy changes.
20
-
21
- ## Council Routing
22
-
23
- - Schema, auth, RLS, API behavior, dependency, and release changes require Lead Architect and Security Reviewer handoff.
24
- - UI changes require Frontend Design Lead evidence before implementation is accepted.
25
- - Behavior changes require QA evidence and living-doc updates.
26
- - Use the model profile in `MODEL_ROUTING.md`; treat Copilot model selection as advisory unless the active tool surface can enforce it.
27
- - Read project context and active corrections before changing behavior.
28
- - Record visible decisions, handoffs, human corrections, artifacts, and verification with Agent Studio session commands when available.
@@ -1,32 +0,0 @@
1
- # Claude Code Subagents With Model Notes
2
-
3
- Use this as a starter for `.claude/agents/*.md` files. Keep the canonical role definitions in `AGENTS.md` and `AGENT_ROSTER.md`.
4
-
5
- ```md
6
- ---
7
- name: lead-architect
8
- description: Use for core architecture, cross-layer changes, package behavior, and technical decisions.
9
- # June 2026 Agent Kit suggestion:
10
- # model: opus
11
- # effort: high
12
- ---
13
-
14
- Read `AGENTS.md`, `AGENT_ROSTER.md`, `MODEL_ROUTING.md`, `.agent-kit/agent-roster.json`, and `.agent-kit/model-routing.json`.
15
-
16
- Review affected layers, preserved behavior, security impact, test plan, docs impact, and required council handoffs before implementation.
17
- ```
18
-
19
- ```md
20
- ---
21
- name: frontend-design-lead
22
- description: Use for creative direction, reference-led critique, frontend distinctiveness, product-quality scorecards, and visual QA.
23
- # June 2026 Agent Kit suggestion:
24
- # model: opus
25
- # effort: high
26
- ---
27
-
28
- Use `DESIGN.md`, `STYLE_GUIDE.md`, `MODEL_ROUTING.md`, and the frontend skills before accepting significant UI work.
29
- Reject generic AI-looking UI that is not specific to the product content, workflow, audience, and state model.
30
- ```
31
-
32
- Record the actual Claude Code behavior, model field support, date, and owner in `ASSISTANT_ADAPTERS.md`.
@@ -1,32 +0,0 @@
1
- # Codex model-selection example for Agent Kit.
2
- # Copy the relevant comments into ~/.codex/config.toml or a trusted project .codex/config.toml.
3
- # Verify current model availability in your Codex environment before uncommenting.
4
- #
5
- # Custom council agents generated by agent-kit live under .codex/agents/*.toml.
6
- # Run `agent-kit init --activate codex` to create them from the project roster.
7
-
8
- # June 2026 Agent Kit suggested baseline:
9
- # model = "gpt-5.5"
10
- # model_reasoning_effort = "medium"
11
-
12
- # Use high reasoning for Lead Architect, Security Reviewer, and Supabase/Postgres Engineer
13
- # when spawning custom Codex agents or starting dedicated review threads.
14
- # model_reasoning_effort = "high"
15
-
16
- # Optional custom-agent files can live under .codex/agents/*.toml.
17
- # Keep each custom agent narrow and point it back to:
18
- # - AGENTS.md
19
- # - AGENT_ROSTER.md
20
- # - .agent-kit/agent-roster.json
21
- # - MODEL_ROUTING.md
22
- # - .agent-kit/model-routing.json
23
-
24
- # Example custom-agent fragment:
25
- # name = "lead-architect"
26
- # description = "Architecture and core-change council review."
27
- # model = "gpt-5.5"
28
- # model_reasoning_effort = "high"
29
- # developer_instructions = """
30
- # Read AGENTS.md, AGENT_ROSTER.md, MODEL_ROUTING.md, and .agent-kit/agent-roster.json.
31
- # Review affected layers, preserved behavior, tradeoffs, security impact, test plan, and docs impact.
32
- # """