opencode-agent-kit 1.0.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 (361) hide show
  1. package/README.md +796 -0
  2. package/bin/commands/init.mjs +221 -0
  3. package/bin/init.mjs +21 -0
  4. package/package.json +22 -0
  5. package/template/.opencode/agent-docs/backend/README.md +0 -0
  6. package/template/.opencode/agent-docs/backend/node/BACKEND_PATTERNS.md +82 -0
  7. package/template/.opencode/agent-docs/backend/node/BACKEND_QUICK_START.md +49 -0
  8. package/template/.opencode/agent-docs/frontend/next/README.md +0 -0
  9. package/template/.opencode/agent-docs/frontend/nuxt/API_PATTERNS.md +807 -0
  10. package/template/.opencode/agent-docs/frontend/nuxt/CHEATSHEET.md +676 -0
  11. package/template/.opencode/agent-docs/frontend/nuxt/COMPLETION_REPORT.md +613 -0
  12. package/template/.opencode/agent-docs/frontend/nuxt/EXAMPLES.md +956 -0
  13. package/template/.opencode/agent-docs/frontend/nuxt/INDEX.md +596 -0
  14. package/template/.opencode/agent-docs/frontend/nuxt/MCP_GUIDE.md +881 -0
  15. package/template/.opencode/agent-docs/frontend/nuxt/MENTOR_CURRICULUM_30_DAYS.md +256 -0
  16. package/template/.opencode/agent-docs/frontend/nuxt/MENTOR_CURRICULUM_CHECKLIST.md +156 -0
  17. package/template/.opencode/agent-docs/frontend/nuxt/MENTOR_WEEKLY_ASSIGNMENTS.md +191 -0
  18. package/template/.opencode/agent-docs/frontend/nuxt/QUICK_START.md +509 -0
  19. package/template/.opencode/agent-docs/frontend/nuxt/README.md +506 -0
  20. package/template/.opencode/agent-docs/frontend/nuxt/README_AGENTS.md +140 -0
  21. package/template/.opencode/agent-docs/frontend/nuxt/README_DOCS.md +65 -0
  22. package/template/.opencode/agent-docs/frontend/nuxt/SUMMARY.md +474 -0
  23. package/template/.opencode/agent-docs/frontend/nuxt/TEAM_OPERATING_GUIDE.md +54 -0
  24. package/template/.opencode/agent-docs/frontend/nuxt/TESTING_GUIDE.md +904 -0
  25. package/template/.opencode/agent-docs/frontend/nuxt/WORKFLOWS.md +758 -0
  26. package/template/.opencode/agent-docs/frontend/react/API_PATTERNS.md +187 -0
  27. package/template/.opencode/agent-docs/frontend/react/CHEATSHEET.md +87 -0
  28. package/template/.opencode/agent-docs/frontend/react/INDEX.md +45 -0
  29. package/template/.opencode/agent-docs/frontend/react/QUICK_START.md +43 -0
  30. package/template/.opencode/agent-docs/frontend/react/README.md +159 -0
  31. package/template/.opencode/agent-docs/frontend/vue/README.md +0 -0
  32. package/template/.opencode/agent-docs/mobile/android/README.md +45 -0
  33. package/template/.opencode/agent-docs/mobile/flutter/README.md +44 -0
  34. package/template/.opencode/agents/android-developer.md +418 -0
  35. package/template/.opencode/agents/code-igniter-3-fullstack.md +345 -0
  36. package/template/.opencode/agents/code-reviewer.md +517 -0
  37. package/template/.opencode/agents/database-specialist.md +455 -0
  38. package/template/.opencode/agents/devops-specialist.md +562 -0
  39. package/template/.opencode/agents/flutter-developer.md +556 -0
  40. package/template/.opencode/agents/it-leader.md +911 -0
  41. package/template/.opencode/agents/laravel-advanced.md +691 -0
  42. package/template/.opencode/agents/node-backend-developer.md +343 -0
  43. package/template/.opencode/agents/nuxt-frontend-developer-mentor.md +402 -0
  44. package/template/.opencode/agents/nuxt-frontend-developer.md +1573 -0
  45. package/template/.opencode/agents/react-frontend-developer.md +1017 -0
  46. package/template/.opencode/agents/seo-specialist.md +681 -0
  47. package/template/.opencode/agents/ui-ux-designer.md +783 -0
  48. package/template/.opencode/commands/android-build/command.md +25 -0
  49. package/template/.opencode/commands/android-test/command.md +23 -0
  50. package/template/.opencode/commands/build-fix.md +29 -0
  51. package/template/.opencode/commands/checkpoint.md +74 -0
  52. package/template/.opencode/commands/code-review.md +40 -0
  53. package/template/.opencode/commands/e2e.md +363 -0
  54. package/template/.opencode/commands/eval.md +120 -0
  55. package/template/.opencode/commands/evolve.md +193 -0
  56. package/template/.opencode/commands/flutter-build/command.md +25 -0
  57. package/template/.opencode/commands/flutter-test/command.md +24 -0
  58. package/template/.opencode/commands/go-build.md +183 -0
  59. package/template/.opencode/commands/go-review.md +148 -0
  60. package/template/.opencode/commands/go-test.md +268 -0
  61. package/template/.opencode/commands/gpc-release/command.md +30 -0
  62. package/template/.opencode/commands/instinct-export.md +91 -0
  63. package/template/.opencode/commands/instinct-import.md +142 -0
  64. package/template/.opencode/commands/instinct-status.md +86 -0
  65. package/template/.opencode/commands/learn.md +70 -0
  66. package/template/.opencode/commands/multi-backend.md +158 -0
  67. package/template/.opencode/commands/multi-execute.md +310 -0
  68. package/template/.opencode/commands/multi-frontend.md +158 -0
  69. package/template/.opencode/commands/multi-plan.md +261 -0
  70. package/template/.opencode/commands/multi-workflow.md +183 -0
  71. package/template/.opencode/commands/orchestrate.md +172 -0
  72. package/template/.opencode/commands/plan.md +113 -0
  73. package/template/.opencode/commands/pm2.md +271 -0
  74. package/template/.opencode/commands/python-review.md +297 -0
  75. package/template/.opencode/commands/refactor-clean.md +28 -0
  76. package/template/.opencode/commands/sessions.md +305 -0
  77. package/template/.opencode/commands/setup-pm.md +80 -0
  78. package/template/.opencode/commands/skill-create.md +174 -0
  79. package/template/.opencode/commands/tdd.md +326 -0
  80. package/template/.opencode/commands/test-coverage.md +27 -0
  81. package/template/.opencode/commands/update-codemaps.md +17 -0
  82. package/template/.opencode/commands/update-docs.md +31 -0
  83. package/template/.opencode/commands/verify.md +59 -0
  84. package/template/.opencode/config.example.json +309 -0
  85. package/template/.opencode/config.json +341 -0
  86. package/template/.opencode/contexts/dev.md +20 -0
  87. package/template/.opencode/contexts/research.md +26 -0
  88. package/template/.opencode/contexts/review.md +22 -0
  89. package/template/.opencode/hooks/hooks.json +169 -0
  90. package/template/.opencode/instructions/INSTRUCTIONS.md +388 -0
  91. package/template/.opencode/package.json +5 -0
  92. package/template/.opencode/rules/README.md +82 -0
  93. package/template/.opencode/rules/android/gradle.md +62 -0
  94. package/template/.opencode/rules/android/testing.md +27 -0
  95. package/template/.opencode/rules/common/agents.md +49 -0
  96. package/template/.opencode/rules/common/coding-style.md +48 -0
  97. package/template/.opencode/rules/common/git-workflow.md +45 -0
  98. package/template/.opencode/rules/common/hooks.md +30 -0
  99. package/template/.opencode/rules/common/patterns.md +31 -0
  100. package/template/.opencode/rules/common/performance.md +55 -0
  101. package/template/.opencode/rules/common/security.md +29 -0
  102. package/template/.opencode/rules/common/testing.md +29 -0
  103. package/template/.opencode/rules/flutter/state-management.md +57 -0
  104. package/template/.opencode/rules/flutter/testing.md +42 -0
  105. package/template/.opencode/rules/golang/coding-style.md +26 -0
  106. package/template/.opencode/rules/golang/hooks.md +11 -0
  107. package/template/.opencode/rules/golang/patterns.md +39 -0
  108. package/template/.opencode/rules/golang/security.md +28 -0
  109. package/template/.opencode/rules/golang/testing.md +25 -0
  110. package/template/.opencode/rules/mobile/performance.md +36 -0
  111. package/template/.opencode/rules/python/coding-style.md +37 -0
  112. package/template/.opencode/rules/python/hooks.md +14 -0
  113. package/template/.opencode/rules/python/patterns.md +34 -0
  114. package/template/.opencode/rules/python/security.md +25 -0
  115. package/template/.opencode/rules/python/testing.md +33 -0
  116. package/template/.opencode/rules/typescript/coding-style.md +58 -0
  117. package/template/.opencode/rules/typescript/hooks.md +15 -0
  118. package/template/.opencode/rules/typescript/patterns.md +45 -0
  119. package/template/.opencode/rules/typescript/security.md +21 -0
  120. package/template/.opencode/rules/typescript/testing.md +11 -0
  121. package/template/.opencode/skills/api-documentation/SKILL.md +188 -0
  122. package/template/.opencode/skills/backend-patterns/SKILL.md +587 -0
  123. package/template/.opencode/skills/building-components/SKILL.md +37 -0
  124. package/template/.opencode/skills/building-components/references/accessibility.mdx +819 -0
  125. package/template/.opencode/skills/building-components/references/as-child.mdx +324 -0
  126. package/template/.opencode/skills/building-components/references/composition.mdx +239 -0
  127. package/template/.opencode/skills/building-components/references/data-attributes.mdx +413 -0
  128. package/template/.opencode/skills/building-components/references/definitions.mdx +258 -0
  129. package/template/.opencode/skills/building-components/references/design-tokens.mdx +57 -0
  130. package/template/.opencode/skills/building-components/references/docs.mdx +155 -0
  131. package/template/.opencode/skills/building-components/references/marketplaces.mdx +144 -0
  132. package/template/.opencode/skills/building-components/references/npm.mdx +166 -0
  133. package/template/.opencode/skills/building-components/references/polymorphism.mdx +583 -0
  134. package/template/.opencode/skills/building-components/references/principles.mdx +61 -0
  135. package/template/.opencode/skills/building-components/references/registry.mdx +169 -0
  136. package/template/.opencode/skills/building-components/references/state.mdx +99 -0
  137. package/template/.opencode/skills/building-components/references/styling.mdx +286 -0
  138. package/template/.opencode/skills/building-components/references/types.mdx +191 -0
  139. package/template/.opencode/skills/clickhouse-io/SKILL.md +429 -0
  140. package/template/.opencode/skills/coding-standards/SKILL.md +520 -0
  141. package/template/.opencode/skills/configure-ecc/SKILL.md +298 -0
  142. package/template/.opencode/skills/continuous-learning/SKILL.md +110 -0
  143. package/template/.opencode/skills/continuous-learning/config.json +18 -0
  144. package/template/.opencode/skills/continuous-learning/evaluate-session.sh +60 -0
  145. package/template/.opencode/skills/continuous-learning-v2/SKILL.md +284 -0
  146. package/template/.opencode/skills/continuous-learning-v2/agents/observer.md +137 -0
  147. package/template/.opencode/skills/continuous-learning-v2/agents/start-observer.sh +134 -0
  148. package/template/.opencode/skills/continuous-learning-v2/config.json +41 -0
  149. package/template/.opencode/skills/continuous-learning-v2/hooks/observe.sh +153 -0
  150. package/template/.opencode/skills/continuous-learning-v2/scripts/instinct-cli.py +489 -0
  151. package/template/.opencode/skills/continuous-learning-v2/scripts/test_parse_instinct.py +82 -0
  152. package/template/.opencode/skills/dart-add-unit-test/SKILL.md +122 -0
  153. package/template/.opencode/skills/dart-build-cli-app/SKILL.md +185 -0
  154. package/template/.opencode/skills/dart-collect-coverage/SKILL.md +141 -0
  155. package/template/.opencode/skills/dart-fix-runtime-errors/SKILL.md +166 -0
  156. package/template/.opencode/skills/dart-generate-test-mocks/SKILL.md +155 -0
  157. package/template/.opencode/skills/dart-migrate-to-checks-package/SKILL.md +126 -0
  158. package/template/.opencode/skills/dart-resolve-package-conflicts/SKILL.md +116 -0
  159. package/template/.opencode/skills/dart-run-static-analysis/SKILL.md +104 -0
  160. package/template/.opencode/skills/dart-use-pattern-matching/SKILL.md +146 -0
  161. package/template/.opencode/skills/django-patterns/SKILL.md +733 -0
  162. package/template/.opencode/skills/django-security/SKILL.md +592 -0
  163. package/template/.opencode/skills/django-tdd/SKILL.md +728 -0
  164. package/template/.opencode/skills/django-verification/SKILL.md +460 -0
  165. package/template/.opencode/skills/eval-harness/SKILL.md +227 -0
  166. package/template/.opencode/skills/firebase-basics/SKILL.md +103 -0
  167. package/template/.opencode/skills/firebase-basics/references/additional-skills.md +113 -0
  168. package/template/.opencode/skills/firebase-basics/references/cli-usage.md +31 -0
  169. package/template/.opencode/skills/firebase-basics/references/client-library-usage.md +45 -0
  170. package/template/.opencode/skills/firebase-basics/references/core-concepts.md +61 -0
  171. package/template/.opencode/skills/firebase-basics/references/iac-usage.md +40 -0
  172. package/template/.opencode/skills/firebase-basics/references/iam-security.md +74 -0
  173. package/template/.opencode/skills/firebase-basics/references/mcp-usage.md +63 -0
  174. package/template/.opencode/skills/flutter/SKILL.md +292 -0
  175. package/template/.opencode/skills/flutter-add-integration-test/SKILL.md +163 -0
  176. package/template/.opencode/skills/flutter-add-widget-preview/SKILL.md +145 -0
  177. package/template/.opencode/skills/flutter-add-widget-test/SKILL.md +154 -0
  178. package/template/.opencode/skills/flutter-apply-architecture-best-practices/SKILL.md +162 -0
  179. package/template/.opencode/skills/flutter-build-responsive-layout/SKILL.md +139 -0
  180. package/template/.opencode/skills/flutter-fix-layout-issues/SKILL.md +130 -0
  181. package/template/.opencode/skills/flutter-implement-json-serialization/SKILL.md +153 -0
  182. package/template/.opencode/skills/flutter-setup-declarative-routing/SKILL.md +255 -0
  183. package/template/.opencode/skills/flutter-setup-localization/SKILL.md +210 -0
  184. package/template/.opencode/skills/flutter-use-http-package/SKILL.md +174 -0
  185. package/template/.opencode/skills/frontend-design/SKILL.md +89 -0
  186. package/template/.opencode/skills/frontend-patterns/SKILL.md +631 -0
  187. package/template/.opencode/skills/golang-patterns/SKILL.md +673 -0
  188. package/template/.opencode/skills/golang-testing/SKILL.md +719 -0
  189. package/template/.opencode/skills/impeccable/SKILL.md +165 -0
  190. package/template/.opencode/skills/impeccable/agents/impeccable-asset-producer.md +101 -0
  191. package/template/.opencode/skills/impeccable/reference/adapt.md +190 -0
  192. package/template/.opencode/skills/impeccable/reference/animate.md +175 -0
  193. package/template/.opencode/skills/impeccable/reference/audit.md +133 -0
  194. package/template/.opencode/skills/impeccable/reference/bolder.md +113 -0
  195. package/template/.opencode/skills/impeccable/reference/brand.md +118 -0
  196. package/template/.opencode/skills/impeccable/reference/clarify.md +174 -0
  197. package/template/.opencode/skills/impeccable/reference/codex.md +105 -0
  198. package/template/.opencode/skills/impeccable/reference/cognitive-load.md +106 -0
  199. package/template/.opencode/skills/impeccable/reference/color-and-contrast.md +105 -0
  200. package/template/.opencode/skills/impeccable/reference/colorize.md +154 -0
  201. package/template/.opencode/skills/impeccable/reference/craft.md +123 -0
  202. package/template/.opencode/skills/impeccable/reference/critique.md +273 -0
  203. package/template/.opencode/skills/impeccable/reference/delight.md +302 -0
  204. package/template/.opencode/skills/impeccable/reference/distill.md +111 -0
  205. package/template/.opencode/skills/impeccable/reference/document.md +427 -0
  206. package/template/.opencode/skills/impeccable/reference/extract.md +69 -0
  207. package/template/.opencode/skills/impeccable/reference/harden.md +347 -0
  208. package/template/.opencode/skills/impeccable/reference/heuristics-scoring.md +234 -0
  209. package/template/.opencode/skills/impeccable/reference/interaction-design.md +195 -0
  210. package/template/.opencode/skills/impeccable/reference/layout.md +141 -0
  211. package/template/.opencode/skills/impeccable/reference/live.md +622 -0
  212. package/template/.opencode/skills/impeccable/reference/motion-design.md +109 -0
  213. package/template/.opencode/skills/impeccable/reference/onboard.md +234 -0
  214. package/template/.opencode/skills/impeccable/reference/optimize.md +258 -0
  215. package/template/.opencode/skills/impeccable/reference/overdrive.md +130 -0
  216. package/template/.opencode/skills/impeccable/reference/personas.md +179 -0
  217. package/template/.opencode/skills/impeccable/reference/polish.md +242 -0
  218. package/template/.opencode/skills/impeccable/reference/product.md +62 -0
  219. package/template/.opencode/skills/impeccable/reference/quieter.md +99 -0
  220. package/template/.opencode/skills/impeccable/reference/responsive-design.md +114 -0
  221. package/template/.opencode/skills/impeccable/reference/shape.md +165 -0
  222. package/template/.opencode/skills/impeccable/reference/spatial-design.md +100 -0
  223. package/template/.opencode/skills/impeccable/reference/teach.md +156 -0
  224. package/template/.opencode/skills/impeccable/reference/typeset.md +124 -0
  225. package/template/.opencode/skills/impeccable/reference/typography.md +159 -0
  226. package/template/.opencode/skills/impeccable/reference/ux-writing.md +107 -0
  227. package/template/.opencode/skills/impeccable/scripts/cleanup-deprecated.mjs +284 -0
  228. package/template/.opencode/skills/impeccable/scripts/command-metadata.json +94 -0
  229. package/template/.opencode/skills/impeccable/scripts/critique-storage.mjs +242 -0
  230. package/template/.opencode/skills/impeccable/scripts/design-parser.mjs +820 -0
  231. package/template/.opencode/skills/impeccable/scripts/detect-csp.mjs +198 -0
  232. package/template/.opencode/skills/impeccable/scripts/detect.mjs +21 -0
  233. package/template/.opencode/skills/impeccable/scripts/impeccable-paths.mjs +110 -0
  234. package/template/.opencode/skills/impeccable/scripts/is-generated.mjs +69 -0
  235. package/template/.opencode/skills/impeccable/scripts/live-accept.mjs +595 -0
  236. package/template/.opencode/skills/impeccable/scripts/live-browser-session.js +123 -0
  237. package/template/.opencode/skills/impeccable/scripts/live-browser.js +4860 -0
  238. package/template/.opencode/skills/impeccable/scripts/live-complete.mjs +75 -0
  239. package/template/.opencode/skills/impeccable/scripts/live-completion.mjs +18 -0
  240. package/template/.opencode/skills/impeccable/scripts/live-inject.mjs +446 -0
  241. package/template/.opencode/skills/impeccable/scripts/live-poll.mjs +200 -0
  242. package/template/.opencode/skills/impeccable/scripts/live-resume.mjs +48 -0
  243. package/template/.opencode/skills/impeccable/scripts/live-server.mjs +838 -0
  244. package/template/.opencode/skills/impeccable/scripts/live-session-store.mjs +254 -0
  245. package/template/.opencode/skills/impeccable/scripts/live-status.mjs +47 -0
  246. package/template/.opencode/skills/impeccable/scripts/live-wrap.mjs +632 -0
  247. package/template/.opencode/skills/impeccable/scripts/live.mjs +247 -0
  248. package/template/.opencode/skills/impeccable/scripts/load-context.mjs +141 -0
  249. package/template/.opencode/skills/impeccable/scripts/modern-screenshot.umd.js +14 -0
  250. package/template/.opencode/skills/impeccable/scripts/pin.mjs +214 -0
  251. package/template/.opencode/skills/iterative-retrieval/SKILL.md +202 -0
  252. package/template/.opencode/skills/java-coding-standards/SKILL.md +138 -0
  253. package/template/.opencode/skills/jetpack-compose/.skillfish.json +10 -0
  254. package/template/.opencode/skills/jetpack-compose/SKILL.md +420 -0
  255. package/template/.opencode/skills/jpa-patterns/SKILL.md +141 -0
  256. package/template/.opencode/skills/nutrient-document-processing/SKILL.md +165 -0
  257. package/template/.opencode/skills/nuxt-ui/SKILL.md +334 -0
  258. package/template/.opencode/skills/nuxt-ui/references/components.md +377 -0
  259. package/template/.opencode/skills/nuxt-ui/references/composables.md +127 -0
  260. package/template/.opencode/skills/nuxt-ui/references/layouts/chat.md +266 -0
  261. package/template/.opencode/skills/nuxt-ui/references/layouts/dashboard.md +220 -0
  262. package/template/.opencode/skills/nuxt-ui/references/layouts/docs.md +141 -0
  263. package/template/.opencode/skills/nuxt-ui/references/layouts/editor.md +168 -0
  264. package/template/.opencode/skills/nuxt-ui/references/layouts/page.md +260 -0
  265. package/template/.opencode/skills/nuxt-ui/references/theming.md +427 -0
  266. package/template/.opencode/skills/postgres-patterns/SKILL.md +146 -0
  267. package/template/.opencode/skills/project-guidelines-example/SKILL.md +345 -0
  268. package/template/.opencode/skills/python-patterns/SKILL.md +749 -0
  269. package/template/.opencode/skills/python-testing/SKILL.md +815 -0
  270. package/template/.opencode/skills/security-review/SKILL.md +494 -0
  271. package/template/.opencode/skills/security-review/cloud-infrastructure-security.md +361 -0
  272. package/template/.opencode/skills/shadcn-ui/README.md +248 -0
  273. package/template/.opencode/skills/shadcn-ui/SKILL.md +326 -0
  274. package/template/.opencode/skills/shadcn-ui/examples/auth-layout.tsx +177 -0
  275. package/template/.opencode/skills/shadcn-ui/examples/data-table.tsx +313 -0
  276. package/template/.opencode/skills/shadcn-ui/examples/form-pattern.tsx +177 -0
  277. package/template/.opencode/skills/shadcn-ui/resources/component-catalog.md +481 -0
  278. package/template/.opencode/skills/shadcn-ui/resources/customization-guide.md +516 -0
  279. package/template/.opencode/skills/shadcn-ui/resources/migration-guide.md +463 -0
  280. package/template/.opencode/skills/shadcn-ui/resources/setup-guide.md +412 -0
  281. package/template/.opencode/skills/shadcn-ui/scripts/verify-setup.sh +134 -0
  282. package/template/.opencode/skills/springboot-patterns/SKILL.md +304 -0
  283. package/template/.opencode/skills/springboot-security/SKILL.md +119 -0
  284. package/template/.opencode/skills/springboot-tdd/SKILL.md +157 -0
  285. package/template/.opencode/skills/springboot-verification/SKILL.md +100 -0
  286. package/template/.opencode/skills/strategic-compact/SKILL.md +63 -0
  287. package/template/.opencode/skills/strategic-compact/suggest-compact.sh +52 -0
  288. package/template/.opencode/skills/tdd-workflow/SKILL.md +409 -0
  289. package/template/.opencode/skills/vercel-composition-patterns/AGENTS.md +946 -0
  290. package/template/.opencode/skills/vercel-composition-patterns/SKILL.md +89 -0
  291. package/template/.opencode/skills/vercel-composition-patterns/rules/architecture-avoid-boolean-props.md +100 -0
  292. package/template/.opencode/skills/vercel-composition-patterns/rules/architecture-compound-components.md +112 -0
  293. package/template/.opencode/skills/vercel-composition-patterns/rules/patterns-children-over-render-props.md +87 -0
  294. package/template/.opencode/skills/vercel-composition-patterns/rules/patterns-explicit-variants.md +100 -0
  295. package/template/.opencode/skills/vercel-composition-patterns/rules/react19-no-forwardref.md +42 -0
  296. package/template/.opencode/skills/vercel-composition-patterns/rules/state-context-interface.md +191 -0
  297. package/template/.opencode/skills/vercel-composition-patterns/rules/state-decouple-implementation.md +113 -0
  298. package/template/.opencode/skills/vercel-composition-patterns/rules/state-lift-state.md +125 -0
  299. package/template/.opencode/skills/vercel-react-best-practices/AGENTS.md +2934 -0
  300. package/template/.opencode/skills/vercel-react-best-practices/SKILL.md +136 -0
  301. package/template/.opencode/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  302. package/template/.opencode/skills/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
  303. package/template/.opencode/skills/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
  304. package/template/.opencode/skills/vercel-react-best-practices/rules/async-api-routes.md +38 -0
  305. package/template/.opencode/skills/vercel-react-best-practices/rules/async-defer-await.md +80 -0
  306. package/template/.opencode/skills/vercel-react-best-practices/rules/async-dependencies.md +51 -0
  307. package/template/.opencode/skills/vercel-react-best-practices/rules/async-parallel.md +28 -0
  308. package/template/.opencode/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
  309. package/template/.opencode/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +59 -0
  310. package/template/.opencode/skills/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
  311. package/template/.opencode/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
  312. package/template/.opencode/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  313. package/template/.opencode/skills/vercel-react-best-practices/rules/bundle-preload.md +50 -0
  314. package/template/.opencode/skills/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
  315. package/template/.opencode/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
  316. package/template/.opencode/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
  317. package/template/.opencode/skills/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
  318. package/template/.opencode/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
  319. package/template/.opencode/skills/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
  320. package/template/.opencode/skills/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
  321. package/template/.opencode/skills/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
  322. package/template/.opencode/skills/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
  323. package/template/.opencode/skills/vercel-react-best-practices/rules/js-early-exit.md +50 -0
  324. package/template/.opencode/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
  325. package/template/.opencode/skills/vercel-react-best-practices/rules/js-index-maps.md +37 -0
  326. package/template/.opencode/skills/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
  327. package/template/.opencode/skills/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
  328. package/template/.opencode/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
  329. package/template/.opencode/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
  330. package/template/.opencode/skills/vercel-react-best-practices/rules/rendering-activity.md +26 -0
  331. package/template/.opencode/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  332. package/template/.opencode/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
  333. package/template/.opencode/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
  334. package/template/.opencode/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  335. package/template/.opencode/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  336. package/template/.opencode/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
  337. package/template/.opencode/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
  338. package/template/.opencode/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
  339. package/template/.opencode/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
  340. package/template/.opencode/skills/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
  341. package/template/.opencode/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
  342. package/template/.opencode/skills/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
  343. package/template/.opencode/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
  344. package/template/.opencode/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  345. package/template/.opencode/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
  346. package/template/.opencode/skills/vercel-react-best-practices/rules/rerender-memo.md +44 -0
  347. package/template/.opencode/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
  348. package/template/.opencode/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
  349. package/template/.opencode/skills/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
  350. package/template/.opencode/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
  351. package/template/.opencode/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
  352. package/template/.opencode/skills/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
  353. package/template/.opencode/skills/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
  354. package/template/.opencode/skills/vercel-react-best-practices/rules/server-cache-react.md +76 -0
  355. package/template/.opencode/skills/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
  356. package/template/.opencode/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
  357. package/template/.opencode/skills/vercel-react-best-practices/rules/server-serialization.md +38 -0
  358. package/template/.opencode/skills/verification-loop/SKILL.md +120 -0
  359. package/template/.opencode/skills/web-design-guidelines/SKILL.md +39 -0
  360. package/template/AGENTS.md +32 -0
  361. package/template/opencode.json +354 -0
@@ -0,0 +1,313 @@
1
+ // Example: Data Table with Sorting and Filtering
2
+ // Demonstrates: Table composition, TanStack Table integration, responsive design
3
+
4
+ "use client"
5
+
6
+ import {
7
+ ColumnDef,
8
+ ColumnFiltersState,
9
+ flexRender,
10
+ getCoreRowModel,
11
+ getFilteredRowModel,
12
+ getPaginationRowModel,
13
+ getSortedRowModel,
14
+ SortingState,
15
+ useReactTable,
16
+ } from "@tanstack/react-table"
17
+ import { ArrowUpDown, ChevronDown, MoreHorizontal } from "lucide-react"
18
+ import * as React from "react"
19
+
20
+ import { Button } from "@/components/ui/button"
21
+ import {
22
+ DropdownMenu,
23
+ DropdownMenuCheckboxItem,
24
+ DropdownMenuContent,
25
+ DropdownMenuItem,
26
+ DropdownMenuLabel,
27
+ DropdownMenuSeparator,
28
+ DropdownMenuTrigger,
29
+ } from "@/components/ui/dropdown-menu"
30
+ import { Input } from "@/components/ui/input"
31
+ import {
32
+ Table,
33
+ TableBody,
34
+ TableCell,
35
+ TableHead,
36
+ TableHeader,
37
+ TableRow,
38
+ } from "@/components/ui/table"
39
+
40
+ // Define data type
41
+ export type User = {
42
+ id: string
43
+ name: string
44
+ email: string
45
+ role: "admin" | "user" | "viewer"
46
+ status: "active" | "inactive"
47
+ }
48
+
49
+ // Sample data
50
+ const data: User[] = [
51
+ {
52
+ id: "1",
53
+ name: "Alice Johnson",
54
+ email: "alice@example.com",
55
+ role: "admin",
56
+ status: "active",
57
+ },
58
+ {
59
+ id: "2",
60
+ name: "Bob Smith",
61
+ email: "bob@example.com",
62
+ role: "user",
63
+ status: "active",
64
+ },
65
+ {
66
+ id: "3",
67
+ name: "Carol White",
68
+ email: "carol@example.com",
69
+ role: "viewer",
70
+ status: "inactive",
71
+ },
72
+ ]
73
+
74
+ // Define columns
75
+ export const columns: ColumnDef<User>[] = [
76
+ {
77
+ accessorKey: "name",
78
+ header: ({ column }) => {
79
+ return (
80
+ <Button
81
+ variant="ghost"
82
+ onClick={() => column.toggleSorting(column.getIsSorted() === "asc")}
83
+ >
84
+ Name
85
+ <ArrowUpDown className="ml-2 h-4 w-4" />
86
+ </Button>
87
+ )
88
+ },
89
+ cell: ({ row }) => <div className="capitalize">{row.getValue("name")}</div>,
90
+ },
91
+ {
92
+ accessorKey: "email",
93
+ header: ({ column }) => {
94
+ return (
95
+ <Button
96
+ variant="ghost"
97
+ onClick={() => column.toggleSorting(column.getIsSorted() === "asc")}
98
+ >
99
+ Email
100
+ <ArrowUpDown className="ml-2 h-4 w-4" />
101
+ </Button>
102
+ )
103
+ },
104
+ cell: ({ row }) => <div className="lowercase">{row.getValue("email")}</div>,
105
+ },
106
+ {
107
+ accessorKey: "role",
108
+ header: "Role",
109
+ cell: ({ row }) => (
110
+ <div className="capitalize">{row.getValue("role")}</div>
111
+ ),
112
+ },
113
+ {
114
+ accessorKey: "status",
115
+ header: "Status",
116
+ cell: ({ row }) => (
117
+ <div className="capitalize">{row.getValue("status")}</div>
118
+ ),
119
+ },
120
+ {
121
+ id: "actions",
122
+ enableHiding: false,
123
+ cell: ({ row }) => {
124
+ const user = row.original
125
+
126
+ return (
127
+ <DropdownMenu>
128
+ <DropdownMenuTrigger asChild>
129
+ <Button variant="ghost" className="h-8 w-8 p-0">
130
+ <span className="sr-only">Open menu</span>
131
+ <MoreHorizontal className="h-4 w-4" />
132
+ </Button>
133
+ </DropdownMenuTrigger>
134
+ <DropdownMenuContent align="end">
135
+ <DropdownMenuLabel>Actions</DropdownMenuLabel>
136
+ <DropdownMenuItem
137
+ onClick={() => navigator.clipboard.writeText(user.id)}
138
+ >
139
+ Copy user ID
140
+ </DropdownMenuItem>
141
+ <DropdownMenuSeparator />
142
+ <DropdownMenuItem>View user</DropdownMenuItem>
143
+ <DropdownMenuItem>Edit user</DropdownMenuItem>
144
+ </DropdownMenuContent>
145
+ </DropdownMenu>
146
+ )
147
+ },
148
+ },
149
+ ]
150
+
151
+ export function DataTableExample() {
152
+ const [sorting, setSorting] = React.useState<SortingState>([])
153
+ const [columnFilters, setColumnFilters] = React.useState<ColumnFiltersState>([])
154
+ const [columnVisibility, setColumnVisibility] = React.useState({})
155
+ const [rowSelection, setRowSelection] = React.useState({})
156
+
157
+ const table = useReactTable({
158
+ data,
159
+ columns,
160
+ onSortingChange: setSorting,
161
+ onColumnFiltersChange: setColumnFilters,
162
+ getCoreRowModel: getCoreRowModel(),
163
+ getPaginationRowModel: getPaginationRowModel(),
164
+ getSortedRowModel: getSortedRowModel(),
165
+ getFilteredRowModel: getFilteredRowModel(),
166
+ onColumnVisibilityChange: setColumnVisibility,
167
+ onRowSelectionChange: setRowSelection,
168
+ state: {
169
+ sorting,
170
+ columnFilters,
171
+ columnVisibility,
172
+ rowSelection,
173
+ },
174
+ })
175
+
176
+ return (
177
+ <div className="w-full">
178
+ <div className="flex items-center py-4">
179
+ <Input
180
+ placeholder="Filter names..."
181
+ value={(table.getColumn("name")?.getFilterValue() as string) ?? ""}
182
+ onChange={(event) =>
183
+ table.getColumn("name")?.setFilterValue(event.target.value)
184
+ }
185
+ className="max-w-sm"
186
+ />
187
+ <DropdownMenu>
188
+ <DropdownMenuTrigger asChild>
189
+ <Button variant="outline" className="ml-auto">
190
+ Columns <ChevronDown className="ml-2 h-4 w-4" />
191
+ </Button>
192
+ </DropdownMenuTrigger>
193
+ <DropdownMenuContent align="end">
194
+ {table
195
+ .getAllColumns()
196
+ .filter((column) => column.getCanHide())
197
+ .map((column) => {
198
+ return (
199
+ <DropdownMenuCheckboxItem
200
+ key={column.id}
201
+ className="capitalize"
202
+ checked={column.getIsVisible()}
203
+ onCheckedChange={(value) =>
204
+ column.toggleVisibility(!!value)
205
+ }
206
+ >
207
+ {column.id}
208
+ </DropdownMenuCheckboxItem>
209
+ )
210
+ })}
211
+ </DropdownMenuContent>
212
+ </DropdownMenu>
213
+ </div>
214
+ <div className="rounded-md border">
215
+ <Table>
216
+ <TableHeader>
217
+ {table.getHeaderGroups().map((headerGroup) => (
218
+ <TableRow key={headerGroup.id}>
219
+ {headerGroup.headers.map((header) => {
220
+ return (
221
+ <TableHead key={header.id}>
222
+ {header.isPlaceholder
223
+ ? null
224
+ : flexRender(
225
+ header.column.columnDef.header,
226
+ header.getContext()
227
+ )}
228
+ </TableHead>
229
+ )
230
+ })}
231
+ </TableRow>
232
+ ))}
233
+ </TableHeader>
234
+ <TableBody>
235
+ {table.getRowModel().rows?.length ? (
236
+ table.getRowModel().rows.map((row) => (
237
+ <TableRow
238
+ key={row.id}
239
+ data-state={row.getIsSelected() && "selected"}
240
+ >
241
+ {row.getVisibleCells().map((cell) => (
242
+ <TableCell key={cell.id}>
243
+ {flexRender(
244
+ cell.column.columnDef.cell,
245
+ cell.getContext()
246
+ )}
247
+ </TableCell>
248
+ ))}
249
+ </TableRow>
250
+ ))
251
+ ) : (
252
+ <TableRow>
253
+ <TableCell
254
+ colSpan={columns.length}
255
+ className="h-24 text-center"
256
+ >
257
+ No results.
258
+ </TableCell>
259
+ </TableRow>
260
+ )}
261
+ </TableBody>
262
+ </Table>
263
+ </div>
264
+ <div className="flex items-center justify-end space-x-2 py-4">
265
+ <div className="flex-1 text-sm text-muted-foreground">
266
+ {table.getFilteredSelectedRowModel().rows.length} of{" "}
267
+ {table.getFilteredRowModel().rows.length} row(s) selected.
268
+ </div>
269
+ <div className="space-x-2">
270
+ <Button
271
+ variant="outline"
272
+ size="sm"
273
+ onClick={() => table.previousPage()}
274
+ disabled={!table.getCanPreviousPage()}
275
+ >
276
+ Previous
277
+ </Button>
278
+ <Button
279
+ variant="outline"
280
+ size="sm"
281
+ onClick={() => table.nextPage()}
282
+ disabled={!table.getCanNextPage()}
283
+ >
284
+ Next
285
+ </Button>
286
+ </div>
287
+ </div>
288
+ </div>
289
+ )
290
+ }
291
+
292
+ /**
293
+ * Key Patterns Demonstrated:
294
+ *
295
+ * 1. TanStack Table Integration: Using @tanstack/react-table with shadcn/ui
296
+ * 2. Sorting: Click headers to sort ascending/descending
297
+ * 3. Filtering: Text input to filter table data
298
+ * 4. Column Visibility: Toggle columns via dropdown menu
299
+ * 5. Pagination: Built-in pagination controls
300
+ * 6. Row Actions: Dropdown menu per row for context actions
301
+ * 7. Responsive Design: Table adapts to different screen sizes
302
+ *
303
+ * Required Dependencies:
304
+ * - @tanstack/react-table
305
+ * - lucide-react
306
+ *
307
+ * Installation:
308
+ * npx shadcn@latest add table
309
+ * npx shadcn@latest add button
310
+ * npx shadcn@latest add input
311
+ * npx shadcn@latest add dropdown-menu
312
+ * npm install @tanstack/react-table lucide-react
313
+ */
@@ -0,0 +1,177 @@
1
+ // Example: Form Pattern with shadcn/ui components
2
+ // Demonstrates: Form building, validation, and composition
3
+
4
+ "use client"
5
+
6
+ import { Button } from "@/components/ui/button"
7
+ import {
8
+ Form,
9
+ FormControl,
10
+ FormDescription,
11
+ FormField,
12
+ FormItem,
13
+ FormLabel,
14
+ FormMessage,
15
+ } from "@/components/ui/form"
16
+ import { Input } from "@/components/ui/input"
17
+ import {
18
+ Select,
19
+ SelectContent,
20
+ SelectItem,
21
+ SelectTrigger,
22
+ SelectValue,
23
+ } from "@/components/ui/select"
24
+ import { Textarea } from "@/components/ui/textarea"
25
+ import { toast } from "@/components/ui/use-toast"
26
+ import { zodResolver } from "@hookform/resolvers/zod"
27
+ import { useForm } from "react-hook-form"
28
+ import * as z from "zod"
29
+
30
+ // Define form schema with zod
31
+ const formSchema = z.object({
32
+ username: z.string().min(2, {
33
+ message: "Username must be at least 2 characters.",
34
+ }),
35
+ email: z.string().email({
36
+ message: "Please enter a valid email address.",
37
+ }),
38
+ role: z.enum(["admin", "user", "viewer"], {
39
+ required_error: "Please select a role.",
40
+ }),
41
+ bio: z.string().max(160, {
42
+ message: "Bio must not be longer than 160 characters.",
43
+ }).optional(),
44
+ })
45
+
46
+ type FormValues = z.infer<typeof formSchema>
47
+
48
+ export function UserProfileForm() {
49
+ // Initialize form with react-hook-form and zod validation
50
+ const form = useForm<FormValues>({
51
+ resolver: zodResolver(formSchema),
52
+ defaultValues: {
53
+ username: "",
54
+ email: "",
55
+ bio: "",
56
+ },
57
+ })
58
+
59
+ // Handle form submission
60
+ function onSubmit(values: FormValues) {
61
+ // In a real app, send to API
62
+ console.log(values)
63
+
64
+ toast({
65
+ title: "Profile updated",
66
+ description: "Your profile has been successfully updated.",
67
+ })
68
+ }
69
+
70
+ return (
71
+ <Form {...form}>
72
+ <form onSubmit={form.handleSubmit(onSubmit)} className="space-y-8">
73
+ <FormField
74
+ control={form.control}
75
+ name="username"
76
+ render={({ field }) => (
77
+ <FormItem>
78
+ <FormLabel>Username</FormLabel>
79
+ <FormControl>
80
+ <Input placeholder="johndoe" {...field} />
81
+ </FormControl>
82
+ <FormDescription>
83
+ This is your public display name.
84
+ </FormDescription>
85
+ <FormMessage />
86
+ </FormItem>
87
+ )}
88
+ />
89
+
90
+ <FormField
91
+ control={form.control}
92
+ name="email"
93
+ render={({ field }) => (
94
+ <FormItem>
95
+ <FormLabel>Email</FormLabel>
96
+ <FormControl>
97
+ <Input type="email" placeholder="john@example.com" {...field} />
98
+ </FormControl>
99
+ <FormMessage />
100
+ </FormItem>
101
+ )}
102
+ />
103
+
104
+ <FormField
105
+ control={form.control}
106
+ name="role"
107
+ render={({ field }) => (
108
+ <FormItem>
109
+ <FormLabel>Role</FormLabel>
110
+ <Select onValueChange={field.onChange} defaultValue={field.value}>
111
+ <FormControl>
112
+ <SelectTrigger>
113
+ <SelectValue placeholder="Select a role" />
114
+ </SelectTrigger>
115
+ </FormControl>
116
+ <SelectContent>
117
+ <SelectItem value="admin">Admin</SelectItem>
118
+ <SelectItem value="user">User</SelectItem>
119
+ <SelectItem value="viewer">Viewer</SelectItem>
120
+ </SelectContent>
121
+ </Select>
122
+ <FormDescription>
123
+ Your role determines your access level.
124
+ </FormDescription>
125
+ <FormMessage />
126
+ </FormItem>
127
+ )}
128
+ />
129
+
130
+ <FormField
131
+ control={form.control}
132
+ name="bio"
133
+ render={({ field }) => (
134
+ <FormItem>
135
+ <FormLabel>Bio</FormLabel>
136
+ <FormControl>
137
+ <Textarea
138
+ placeholder="Tell us about yourself"
139
+ className="resize-none"
140
+ {...field}
141
+ />
142
+ </FormControl>
143
+ <FormDescription>
144
+ Optional. Maximum 160 characters.
145
+ </FormDescription>
146
+ <FormMessage />
147
+ </FormItem>
148
+ )}
149
+ />
150
+
151
+ <Button type="submit">Update profile</Button>
152
+ </form>
153
+ </Form>
154
+ )
155
+ }
156
+
157
+ /**
158
+ * Key Patterns Demonstrated:
159
+ *
160
+ * 1. Form Composition: Using shadcn/ui's Form components with react-hook-form
161
+ * 2. Validation: Zod schema for type-safe validation
162
+ * 3. Error Handling: Automatic error messages via FormMessage
163
+ * 4. Accessibility: All fields properly labeled with descriptions
164
+ * 5. Type Safety: TypeScript types inferred from Zod schema
165
+ *
166
+ * Required Dependencies:
167
+ * - react-hook-form
168
+ * - @hookform/resolvers
169
+ * - zod
170
+ *
171
+ * Installation:
172
+ * npx shadcn@latest add form
173
+ * npx shadcn@latest add input
174
+ * npx shadcn@latest add select
175
+ * npx shadcn@latest add textarea
176
+ * npx shadcn@latest add button
177
+ */