@punks/cli 0.1.16 → 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 (508) hide show
  1. package/AGENTS.md +10 -0
  2. package/README.md +64 -0
  3. package/dist/data/AGENTS.md +123 -0
  4. package/dist/data/catalog/lint.ts +349 -0
  5. package/dist/data/catalog/packs.ts +44 -0
  6. package/dist/data/catalog/skills.ts +47 -0
  7. package/dist/data/catalog/tools.ts +22 -0
  8. package/dist/data/hooks/format-edited-file.mjs +554 -0
  9. package/dist/data/hooks/format-edited-file.py +157 -0
  10. package/dist/data/hooks/format-edited-file.sh +37 -0
  11. package/dist/data/hooks/require-tests-for-pr.mjs +144 -0
  12. package/dist/data/scripts/sync-subagents.mjs +420 -0
  13. package/dist/data/subagents/manifest.mjs +253 -0
  14. package/dist/index.js +46415 -0
  15. package/dist/skills/agnostic/backend/backend-domain-structure/SKILL.md +50 -0
  16. package/dist/skills/agnostic/backend/backend-domain-structure/agents/openai.yaml +4 -0
  17. package/dist/skills/agnostic/backend/backend-domain-structure/references/layout.md +167 -0
  18. package/dist/skills/agnostic/backend/backend-recoverable-actions/SKILL.md +49 -0
  19. package/dist/skills/agnostic/backend/backend-recoverable-actions/agents/openai.yaml +4 -0
  20. package/dist/skills/agnostic/backend/backend-recoverable-actions/references/strategy-matrix.md +34 -0
  21. package/dist/skills/agnostic/backend/backend-recoverable-actions/references/test-matrix.md +34 -0
  22. package/dist/skills/agnostic/docs/docs-maintenance/SKILL.md +193 -0
  23. package/dist/skills/agnostic/docs/docs-maintenance/agents/openai.yaml +4 -0
  24. package/dist/skills/agnostic/docs/docs-maintenance/references/concept-pages.md +48 -0
  25. package/dist/skills/agnostic/docs/docs-maintenance/references/flow-pages.md +41 -0
  26. package/dist/skills/agnostic/frontend/agent-browser/.clawdhub/origin.json +7 -0
  27. package/dist/skills/agnostic/frontend/agent-browser/SKILL.md +229 -0
  28. package/dist/skills/agnostic/frontend/agent-browser/references/authentication.md +202 -0
  29. package/dist/skills/agnostic/frontend/agent-browser/references/commands.md +259 -0
  30. package/dist/skills/agnostic/frontend/agent-browser/references/proxy-support.md +188 -0
  31. package/dist/skills/agnostic/frontend/agent-browser/references/session-management.md +193 -0
  32. package/dist/skills/agnostic/frontend/agent-browser/references/snapshot-refs.md +194 -0
  33. package/dist/skills/agnostic/frontend/agent-browser/references/video-recording.md +173 -0
  34. package/dist/skills/agnostic/frontend/agent-browser/templates/authenticated-session.sh +97 -0
  35. package/dist/skills/agnostic/frontend/agent-browser/templates/capture-workflow.sh +69 -0
  36. package/dist/skills/agnostic/frontend/agent-browser/templates/form-automation.sh +62 -0
  37. package/dist/skills/agnostic/frontend/design-taste-frontend/SKILL.md +226 -0
  38. package/dist/skills/agnostic/frontend/frontend-domain-structure/SKILL.md +55 -0
  39. package/dist/skills/agnostic/frontend/frontend-domain-structure/agents/openai.yaml +4 -0
  40. package/dist/skills/agnostic/frontend/frontend-domain-structure/references/react/structure.md +102 -0
  41. package/dist/skills/agnostic/frontend/frontend-domain-structure/references/structure.md +257 -0
  42. package/dist/skills/agnostic/frontend/gpt-taste/SKILL.md +74 -0
  43. package/dist/skills/agnostic/frontend/image-taste-frontend/SKILL.md +1102 -0
  44. package/dist/skills/agnostic/frontend/redesign-existing-projects/SKILL.md +178 -0
  45. package/dist/skills/agnostic/planning/create-plan/REFERENCE.md +37 -0
  46. package/dist/skills/agnostic/planning/create-plan/SKILL.md +69 -0
  47. package/dist/skills/agnostic/planning/create-plan/references/backlog-sync.md +44 -0
  48. package/dist/skills/agnostic/planning/create-plan/references/grill-phase.md +86 -0
  49. package/dist/skills/agnostic/planning/create-plan/references/plan-schema.md +66 -0
  50. package/dist/skills/agnostic/planning/create-plan/references/planner-phase.md +39 -0
  51. package/dist/skills/agnostic/planning/create-plan/references/stop-conditions.md +18 -0
  52. package/dist/skills/agnostic/planning/create-plan/references/tdd-phase.md +26 -0
  53. package/dist/skills/agnostic/planning/create-spec/SKILL.md +57 -0
  54. package/dist/skills/agnostic/planning/create-spec/assets/SPEC-TEMPLATE.md +91 -0
  55. package/dist/skills/agnostic/planning/create-spec/references/discovery.md +44 -0
  56. package/dist/skills/agnostic/planning/create-spec/references/folder-naming.md +27 -0
  57. package/dist/skills/agnostic/planning/create-spec/references/handoff.md +47 -0
  58. package/dist/skills/agnostic/planning/create-spec/references/questioning.md +41 -0
  59. package/dist/skills/agnostic/planning/create-spec/references/spec-quality-bar.md +58 -0
  60. package/dist/skills/agnostic/planning/create-spec/references/wiki-bookkeeping.md +26 -0
  61. package/dist/skills/agnostic/planning/grill-me/SKILL.md +28 -0
  62. package/dist/skills/agnostic/planning/implement-spec/SKILL.md +72 -0
  63. package/dist/skills/agnostic/planning/implement-spec/assets/IMPLEMENTATION-NOTES-TEMPLATE.md +47 -0
  64. package/dist/skills/agnostic/planning/implement-spec/references/lifecycle.md +149 -0
  65. package/dist/skills/agnostic/planning/implement-spec/references/parallel-orchestration.md +102 -0
  66. package/dist/skills/agnostic/planning/implement-spec/references/parallel-worker-brief.md +65 -0
  67. package/dist/skills/agnostic/planning/implement-spec/references/parallel.md +56 -0
  68. package/dist/skills/agnostic/planning/implement-spec/references/sequential.md +28 -0
  69. package/dist/skills/agnostic/planning/swarm-planner/SKILL.md +179 -0
  70. package/dist/skills/agnostic/quality/simplify/SKILL.md +14 -0
  71. package/dist/skills/agnostic/quality/tdd/SKILL.md +107 -0
  72. package/dist/skills/agnostic/quality/tdd/deep-modules.md +33 -0
  73. package/dist/skills/agnostic/quality/tdd/interface-design.md +31 -0
  74. package/dist/skills/agnostic/quality/tdd/mocking.md +59 -0
  75. package/dist/skills/agnostic/quality/tdd/refactoring.md +10 -0
  76. package/dist/skills/agnostic/quality/tdd/tests.md +61 -0
  77. package/dist/skills/agnostic/requirements/requirements-grill/SKILL.md +42 -0
  78. package/dist/skills/agnostic/requirements/requirements-grill/references/artifact-output.md +73 -0
  79. package/dist/skills/agnostic/requirements/requirements-grill/references/grilling-flow.md +57 -0
  80. package/dist/skills/agnostic/requirements/requirements-grill/references/wiki-output.md +94 -0
  81. package/dist/skills/agnostic/requirements/write-backlog/EXAMPLES.md +67 -0
  82. package/dist/skills/agnostic/requirements/write-backlog/REFERENCE.md +253 -0
  83. package/dist/skills/agnostic/requirements/write-backlog/SKILL.md +68 -0
  84. package/dist/skills/agnostic/requirements/write-backlog/assets/concepts/backlog-model.md +69 -0
  85. package/dist/skills/agnostic/requirements/write-backlog/assets/concepts/story-shape.md +66 -0
  86. package/dist/skills/agnostic/requirements/write-backlog/assets/providers/azure-devops-create-payload.md +63 -0
  87. package/dist/skills/agnostic/requirements/write-backlog/assets/providers/github-issues-create-payload.md +48 -0
  88. package/dist/skills/agnostic/requirements/write-backlog/assets/providers/linear-create-payload.md +76 -0
  89. package/dist/skills/agnostic/research/improve-codebase-architecture/REFERENCE.md +78 -0
  90. package/dist/skills/agnostic/research/improve-codebase-architecture/SKILL.md +76 -0
  91. package/dist/skills/agnostic/research/parallel-research/SKILL.md +68 -0
  92. package/dist/skills/agnostic/research/parallel-research/agents/openai.yaml +4 -0
  93. package/dist/skills/agnostic/subagents/swarm-planner/SKILL.md +179 -0
  94. package/dist/skills/agnostic/write-a-skill/SKILL.md +117 -0
  95. package/dist/skills/frameworks/better-auth/better-auth-best-practices/SKILL.md +166 -0
  96. package/dist/skills/frameworks/better-auth/better-auth-security-best-practices/SKILL.MD +432 -0
  97. package/dist/skills/frameworks/effect/effect-authoring/SKILL.md +116 -0
  98. package/dist/skills/frameworks/effect/effect-authoring/references/branded-types.md +98 -0
  99. package/dist/skills/frameworks/effect/effect-authoring/references/effect-atom-patterns.md +257 -0
  100. package/dist/skills/frameworks/effect/effect-authoring/references/effect-primitives.md +144 -0
  101. package/dist/skills/frameworks/effect/effect-authoring/references/error-patterns.md +156 -0
  102. package/dist/skills/frameworks/effect/effect-authoring/references/otel-patterns.md +113 -0
  103. package/dist/skills/frameworks/effect/effect-authoring/references/test-patterns.md +146 -0
  104. package/dist/skills/frameworks/effect/effect-backend-structure/SKILL.md +96 -0
  105. package/dist/skills/frameworks/effect/effect-backend-structure/agents/openai.yaml +4 -0
  106. package/dist/skills/frameworks/effect/effect-backend-structure/references/layout.md +68 -0
  107. package/dist/skills/frameworks/effect/effect-best-practices/SKILL.md +517 -0
  108. package/dist/skills/frameworks/effect/effect-best-practices/references/anti-patterns.md +392 -0
  109. package/dist/skills/frameworks/effect/effect-best-practices/references/effect-atom-patterns.md +653 -0
  110. package/dist/skills/frameworks/effect/effect-best-practices/references/error-patterns.md +464 -0
  111. package/dist/skills/frameworks/effect/effect-best-practices/references/language-server.md +287 -0
  112. package/dist/skills/frameworks/effect/effect-best-practices/references/layer-patterns.md +495 -0
  113. package/dist/skills/frameworks/effect/effect-best-practices/references/observability-patterns.md +342 -0
  114. package/dist/skills/frameworks/effect/effect-best-practices/references/rpc-cluster-patterns.md +418 -0
  115. package/dist/skills/frameworks/effect/effect-best-practices/references/schema-patterns.md +353 -0
  116. package/dist/skills/frameworks/effect/effect-best-practices/references/service-patterns.md +299 -0
  117. package/dist/skills/frameworks/effect/effect-recoverable-actions/SKILL.md +65 -0
  118. package/dist/skills/frameworks/effect/effect-recoverable-actions/agents/openai.yaml +4 -0
  119. package/dist/skills/frameworks/effect/effect-recoverable-actions/references/flow-examples.md +154 -0
  120. package/dist/skills/frameworks/effect/effect-recoverable-actions/references/source-backed-primitives.md +104 -0
  121. package/dist/skills/frameworks/effect/effect-recoverable-actions/references/strategy-matrix.md +34 -0
  122. package/dist/skills/frameworks/effect/effect-recoverable-actions/references/test-matrix.md +36 -0
  123. package/dist/skills/frameworks/elysia/elysiajs/SKILL.md +475 -0
  124. package/dist/skills/frameworks/elysia/elysiajs/examples/basic.ts +9 -0
  125. package/dist/skills/frameworks/elysia/elysiajs/examples/body-parser.ts +33 -0
  126. package/dist/skills/frameworks/elysia/elysiajs/examples/complex.ts +112 -0
  127. package/dist/skills/frameworks/elysia/elysiajs/examples/cookie.ts +45 -0
  128. package/dist/skills/frameworks/elysia/elysiajs/examples/error.ts +38 -0
  129. package/dist/skills/frameworks/elysia/elysiajs/examples/file.ts +10 -0
  130. package/dist/skills/frameworks/elysia/elysiajs/examples/guard.ts +34 -0
  131. package/dist/skills/frameworks/elysia/elysiajs/examples/map-response.ts +15 -0
  132. package/dist/skills/frameworks/elysia/elysiajs/examples/redirect.ts +6 -0
  133. package/dist/skills/frameworks/elysia/elysiajs/examples/rename.ts +32 -0
  134. package/dist/skills/frameworks/elysia/elysiajs/examples/schema.ts +61 -0
  135. package/dist/skills/frameworks/elysia/elysiajs/examples/state.ts +6 -0
  136. package/dist/skills/frameworks/elysia/elysiajs/examples/upload-file.ts +20 -0
  137. package/dist/skills/frameworks/elysia/elysiajs/examples/websocket.ts +25 -0
  138. package/dist/skills/frameworks/elysia/elysiajs/integrations/ai-sdk.md +92 -0
  139. package/dist/skills/frameworks/elysia/elysiajs/integrations/astro.md +59 -0
  140. package/dist/skills/frameworks/elysia/elysiajs/integrations/better-auth.md +117 -0
  141. package/dist/skills/frameworks/elysia/elysiajs/integrations/cloudflare-worker.md +95 -0
  142. package/dist/skills/frameworks/elysia/elysiajs/integrations/deno.md +34 -0
  143. package/dist/skills/frameworks/elysia/elysiajs/integrations/drizzle.md +258 -0
  144. package/dist/skills/frameworks/elysia/elysiajs/integrations/expo.md +95 -0
  145. package/dist/skills/frameworks/elysia/elysiajs/integrations/nextjs.md +103 -0
  146. package/dist/skills/frameworks/elysia/elysiajs/integrations/nodejs.md +64 -0
  147. package/dist/skills/frameworks/elysia/elysiajs/integrations/nuxt.md +67 -0
  148. package/dist/skills/frameworks/elysia/elysiajs/integrations/prisma.md +93 -0
  149. package/dist/skills/frameworks/elysia/elysiajs/integrations/react-email.md +134 -0
  150. package/dist/skills/frameworks/elysia/elysiajs/integrations/sveltekit.md +53 -0
  151. package/dist/skills/frameworks/elysia/elysiajs/integrations/tanstack-start.md +87 -0
  152. package/dist/skills/frameworks/elysia/elysiajs/integrations/vercel.md +55 -0
  153. package/dist/skills/frameworks/elysia/elysiajs/patterns/mvc.md +380 -0
  154. package/dist/skills/frameworks/elysia/elysiajs/plugins/bearer.md +30 -0
  155. package/dist/skills/frameworks/elysia/elysiajs/plugins/cors.md +141 -0
  156. package/dist/skills/frameworks/elysia/elysiajs/plugins/cron.md +265 -0
  157. package/dist/skills/frameworks/elysia/elysiajs/plugins/graphql-apollo.md +90 -0
  158. package/dist/skills/frameworks/elysia/elysiajs/plugins/graphql-yoga.md +87 -0
  159. package/dist/skills/frameworks/elysia/elysiajs/plugins/html.md +188 -0
  160. package/dist/skills/frameworks/elysia/elysiajs/plugins/jwt.md +197 -0
  161. package/dist/skills/frameworks/elysia/elysiajs/plugins/openapi.md +246 -0
  162. package/dist/skills/frameworks/elysia/elysiajs/plugins/opentelemetry.md +167 -0
  163. package/dist/skills/frameworks/elysia/elysiajs/plugins/server-timing.md +71 -0
  164. package/dist/skills/frameworks/elysia/elysiajs/plugins/static.md +84 -0
  165. package/dist/skills/frameworks/elysia/elysiajs/references/bun-fullstack-dev-server.md +129 -0
  166. package/dist/skills/frameworks/elysia/elysiajs/references/cookie.md +187 -0
  167. package/dist/skills/frameworks/elysia/elysiajs/references/deployment.md +413 -0
  168. package/dist/skills/frameworks/elysia/elysiajs/references/eden.md +158 -0
  169. package/dist/skills/frameworks/elysia/elysiajs/references/lifecycle.md +198 -0
  170. package/dist/skills/frameworks/elysia/elysiajs/references/macro.md +83 -0
  171. package/dist/skills/frameworks/elysia/elysiajs/references/plugin.md +207 -0
  172. package/dist/skills/frameworks/elysia/elysiajs/references/route.md +331 -0
  173. package/dist/skills/frameworks/elysia/elysiajs/references/testing.md +385 -0
  174. package/dist/skills/frameworks/elysia/elysiajs/references/validation.md +491 -0
  175. package/dist/skills/frameworks/elysia/elysiajs/references/websocket.md +250 -0
  176. package/dist/skills/frameworks/nestjs/nestjs-best-practices/.github/workflows/branch-protection.yml +24 -0
  177. package/dist/skills/frameworks/nestjs/nestjs-best-practices/.github/workflows/deploy.yml +61 -0
  178. package/dist/skills/frameworks/nestjs/nestjs-best-practices/AGENTS.md +5958 -0
  179. package/dist/skills/frameworks/nestjs/nestjs-best-practices/SKILL.md +130 -0
  180. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/api-use-dto-serialization.md +182 -0
  181. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/api-use-interceptors.md +202 -0
  182. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/api-use-pipes.md +205 -0
  183. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/api-versioning.md +191 -0
  184. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/arch-avoid-circular-deps.md +80 -0
  185. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/arch-feature-modules.md +82 -0
  186. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/arch-module-sharing.md +141 -0
  187. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/arch-single-responsibility.md +106 -0
  188. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/arch-use-events.md +108 -0
  189. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/arch-use-repository-pattern.md +97 -0
  190. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/db-avoid-n-plus-one.md +139 -0
  191. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/db-use-migrations.md +129 -0
  192. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/db-use-transactions.md +140 -0
  193. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/devops-graceful-shutdown.md +222 -0
  194. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/devops-use-config-module.md +167 -0
  195. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/devops-use-logging.md +232 -0
  196. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/di-avoid-service-locator.md +104 -0
  197. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/di-interface-segregation.md +165 -0
  198. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/di-liskov-substitution.md +221 -0
  199. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/di-prefer-constructor-injection.md +86 -0
  200. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/di-scope-awareness.md +94 -0
  201. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/di-use-interfaces-tokens.md +101 -0
  202. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/error-handle-async-errors.md +125 -0
  203. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/error-throw-http-exceptions.md +114 -0
  204. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/error-use-exception-filters.md +140 -0
  205. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/micro-use-health-checks.md +226 -0
  206. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/micro-use-patterns.md +167 -0
  207. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/micro-use-queues.md +252 -0
  208. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/perf-async-hooks.md +109 -0
  209. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/perf-lazy-loading.md +121 -0
  210. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/perf-optimize-database.md +131 -0
  211. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/perf-use-caching.md +128 -0
  212. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/security-auth-jwt.md +146 -0
  213. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/security-rate-limiting.md +125 -0
  214. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/security-sanitize-output.md +139 -0
  215. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/security-use-guards.md +135 -0
  216. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/security-validate-all-input.md +150 -0
  217. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/test-e2e-supertest.md +178 -0
  218. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/test-mock-external-services.md +179 -0
  219. package/dist/skills/frameworks/nestjs/nestjs-best-practices/rules/test-use-testing-module.md +153 -0
  220. package/dist/skills/frameworks/nestjs/nestjs-best-practices/scripts/build-agents.ts +299 -0
  221. package/dist/skills/frameworks/nestjs/nestjs-best-practices/scripts/build.sh +16 -0
  222. package/dist/skills/frameworks/nestjs/nestjs-best-practices/scripts/package-lock.json +237 -0
  223. package/dist/skills/frameworks/nestjs/nestjs-best-practices/scripts/package.json +15 -0
  224. package/dist/skills/frameworks/nestjs/nestjs-expert/SKILL.md +208 -0
  225. package/dist/skills/frameworks/nestjs/nestjs-expert/references/authentication.md +166 -0
  226. package/dist/skills/frameworks/nestjs/nestjs-expert/references/controllers-routing.md +111 -0
  227. package/dist/skills/frameworks/nestjs/nestjs-expert/references/dtos-validation.md +153 -0
  228. package/dist/skills/frameworks/nestjs/nestjs-expert/references/migration-from-express.md +1237 -0
  229. package/dist/skills/frameworks/nestjs/nestjs-expert/references/services-di.md +140 -0
  230. package/dist/skills/frameworks/nestjs/nestjs-expert/references/testing-patterns.md +186 -0
  231. package/dist/skills/frameworks/nextjs/next-best-practices/SKILL.md +153 -0
  232. package/dist/skills/frameworks/nextjs/next-best-practices/async-patterns.md +87 -0
  233. package/dist/skills/frameworks/nextjs/next-best-practices/bundling.md +180 -0
  234. package/dist/skills/frameworks/nextjs/next-best-practices/data-patterns.md +297 -0
  235. package/dist/skills/frameworks/nextjs/next-best-practices/debug-tricks.md +105 -0
  236. package/dist/skills/frameworks/nextjs/next-best-practices/directives.md +73 -0
  237. package/dist/skills/frameworks/nextjs/next-best-practices/error-handling.md +227 -0
  238. package/dist/skills/frameworks/nextjs/next-best-practices/file-conventions.md +140 -0
  239. package/dist/skills/frameworks/nextjs/next-best-practices/font.md +245 -0
  240. package/dist/skills/frameworks/nextjs/next-best-practices/functions.md +108 -0
  241. package/dist/skills/frameworks/nextjs/next-best-practices/hydration-error.md +91 -0
  242. package/dist/skills/frameworks/nextjs/next-best-practices/image.md +173 -0
  243. package/dist/skills/frameworks/nextjs/next-best-practices/metadata.md +301 -0
  244. package/dist/skills/frameworks/nextjs/next-best-practices/parallel-routes.md +287 -0
  245. package/dist/skills/frameworks/nextjs/next-best-practices/route-handlers.md +146 -0
  246. package/dist/skills/frameworks/nextjs/next-best-practices/rsc-boundaries.md +159 -0
  247. package/dist/skills/frameworks/nextjs/next-best-practices/runtime-selection.md +39 -0
  248. package/dist/skills/frameworks/nextjs/next-best-practices/scripts.md +141 -0
  249. package/dist/skills/frameworks/nextjs/next-best-practices/self-hosting.md +371 -0
  250. package/dist/skills/frameworks/nextjs/next-best-practices/suspense-boundaries.md +67 -0
  251. package/dist/skills/frameworks/nextjs/next-cache-components/SKILL.md +360 -0
  252. package/dist/skills/frameworks/react/async-react-patterns/SKILL.md +78 -0
  253. package/dist/skills/frameworks/react/vercel-composition-patterns/AGENTS.md +946 -0
  254. package/dist/skills/frameworks/react/vercel-composition-patterns/SKILL.md +89 -0
  255. package/dist/skills/frameworks/react/vercel-composition-patterns/rules/architecture-avoid-boolean-props.md +100 -0
  256. package/dist/skills/frameworks/react/vercel-composition-patterns/rules/architecture-compound-components.md +112 -0
  257. package/dist/skills/frameworks/react/vercel-composition-patterns/rules/patterns-children-over-render-props.md +87 -0
  258. package/dist/skills/frameworks/react/vercel-composition-patterns/rules/patterns-explicit-variants.md +100 -0
  259. package/dist/skills/frameworks/react/vercel-composition-patterns/rules/react19-no-forwardref.md +42 -0
  260. package/dist/skills/frameworks/react/vercel-composition-patterns/rules/state-context-interface.md +191 -0
  261. package/dist/skills/frameworks/react/vercel-composition-patterns/rules/state-decouple-implementation.md +113 -0
  262. package/dist/skills/frameworks/react/vercel-composition-patterns/rules/state-lift-state.md +125 -0
  263. package/dist/skills/frameworks/react/vercel-react-best-practices/AGENTS.md +3750 -0
  264. package/dist/skills/frameworks/react/vercel-react-best-practices/SKILL.md +148 -0
  265. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
  266. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  267. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
  268. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
  269. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/async-api-routes.md +38 -0
  270. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
  271. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/async-defer-await.md +82 -0
  272. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/async-dependencies.md +51 -0
  273. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/async-parallel.md +28 -0
  274. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
  275. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
  276. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
  277. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
  278. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  279. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/bundle-preload.md +50 -0
  280. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
  281. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
  282. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
  283. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
  284. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
  285. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
  286. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
  287. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
  288. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
  289. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/js-early-exit.md +50 -0
  290. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
  291. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
  292. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/js-index-maps.md +37 -0
  293. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
  294. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
  295. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
  296. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
  297. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
  298. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rendering-activity.md +26 -0
  299. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  300. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
  301. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
  302. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  303. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  304. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
  305. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
  306. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
  307. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
  308. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
  309. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
  310. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
  311. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
  312. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
  313. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
  314. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  315. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
  316. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rerender-memo.md +44 -0
  317. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
  318. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
  319. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
  320. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
  321. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
  322. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
  323. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
  324. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
  325. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
  326. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
  327. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/server-cache-react.md +76 -0
  328. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
  329. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
  330. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
  331. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
  332. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
  333. package/dist/skills/frameworks/react/vercel-react-best-practices/rules/server-serialization.md +38 -0
  334. package/dist/skills/frameworks/tanstack-query/tanstack-query/.claude-plugin/plugin.json +12 -0
  335. package/dist/skills/frameworks/tanstack-query/tanstack-query/SKILL.md +1058 -0
  336. package/dist/skills/frameworks/tanstack-query/tanstack-query/assets/example-template.txt +14 -0
  337. package/dist/skills/frameworks/tanstack-query/tanstack-query/references/best-practices.md +304 -0
  338. package/dist/skills/frameworks/tanstack-query/tanstack-query/references/common-patterns.md +271 -0
  339. package/dist/skills/frameworks/tanstack-query/tanstack-query/references/example-reference.md +26 -0
  340. package/dist/skills/frameworks/tanstack-query/tanstack-query/references/testing.md +282 -0
  341. package/dist/skills/frameworks/tanstack-query/tanstack-query/references/top-errors.md +332 -0
  342. package/dist/skills/frameworks/tanstack-query/tanstack-query/references/typescript-patterns.md +291 -0
  343. package/dist/skills/frameworks/tanstack-query/tanstack-query/references/v4-to-v5-migration.md +231 -0
  344. package/dist/skills/frameworks/tanstack-query/tanstack-query/rules/tanstack-query.md +126 -0
  345. package/dist/skills/frameworks/tanstack-query/tanstack-query/scripts/example-script.sh +15 -0
  346. package/dist/skills/frameworks/tanstack-query/tanstack-query/templates/custom-hooks-pattern.tsx +281 -0
  347. package/dist/skills/frameworks/tanstack-query/tanstack-query/templates/devtools-setup.tsx +248 -0
  348. package/dist/skills/frameworks/tanstack-query/tanstack-query/templates/error-boundary.tsx +243 -0
  349. package/dist/skills/frameworks/tanstack-query/tanstack-query/templates/package.json +31 -0
  350. package/dist/skills/frameworks/tanstack-query/tanstack-query/templates/provider-setup.tsx +50 -0
  351. package/dist/skills/frameworks/tanstack-query/tanstack-query/templates/query-client-config.ts +72 -0
  352. package/dist/skills/frameworks/tanstack-query/tanstack-query/templates/use-infinite-query.tsx +214 -0
  353. package/dist/skills/frameworks/tanstack-query/tanstack-query/templates/use-mutation-basic.tsx +201 -0
  354. package/dist/skills/frameworks/tanstack-query/tanstack-query/templates/use-mutation-optimistic.tsx +234 -0
  355. package/dist/skills/frameworks/tanstack-query/tanstack-query/templates/use-query-basic.tsx +119 -0
  356. package/dist/skills/frameworks/trpc/tanstack-query/.claude-plugin/plugin.json +12 -0
  357. package/dist/skills/frameworks/trpc/tanstack-query/SKILL.md +1058 -0
  358. package/dist/skills/frameworks/trpc/tanstack-query/assets/example-template.txt +14 -0
  359. package/dist/skills/frameworks/trpc/tanstack-query/references/best-practices.md +304 -0
  360. package/dist/skills/frameworks/trpc/tanstack-query/references/common-patterns.md +271 -0
  361. package/dist/skills/frameworks/trpc/tanstack-query/references/example-reference.md +26 -0
  362. package/dist/skills/frameworks/trpc/tanstack-query/references/testing.md +282 -0
  363. package/dist/skills/frameworks/trpc/tanstack-query/references/top-errors.md +332 -0
  364. package/dist/skills/frameworks/trpc/tanstack-query/references/typescript-patterns.md +291 -0
  365. package/dist/skills/frameworks/trpc/tanstack-query/references/v4-to-v5-migration.md +231 -0
  366. package/dist/skills/frameworks/trpc/tanstack-query/rules/tanstack-query.md +126 -0
  367. package/dist/skills/frameworks/trpc/tanstack-query/scripts/example-script.sh +15 -0
  368. package/dist/skills/frameworks/trpc/tanstack-query/templates/custom-hooks-pattern.tsx +281 -0
  369. package/dist/skills/frameworks/trpc/tanstack-query/templates/devtools-setup.tsx +248 -0
  370. package/dist/skills/frameworks/trpc/tanstack-query/templates/error-boundary.tsx +243 -0
  371. package/dist/skills/frameworks/trpc/tanstack-query/templates/package.json +31 -0
  372. package/dist/skills/frameworks/trpc/tanstack-query/templates/provider-setup.tsx +50 -0
  373. package/dist/skills/frameworks/trpc/tanstack-query/templates/query-client-config.ts +72 -0
  374. package/dist/skills/frameworks/trpc/tanstack-query/templates/use-infinite-query.tsx +214 -0
  375. package/dist/skills/frameworks/trpc/tanstack-query/templates/use-mutation-basic.tsx +201 -0
  376. package/dist/skills/frameworks/trpc/tanstack-query/templates/use-mutation-optimistic.tsx +234 -0
  377. package/dist/skills/frameworks/trpc/tanstack-query/templates/use-query-basic.tsx +119 -0
  378. package/dist/skills/frameworks/turborepo/turborepo/SKILL.md +914 -0
  379. package/dist/skills/frameworks/turborepo/turborepo/command/turborepo.md +70 -0
  380. package/dist/skills/frameworks/turborepo/turborepo/references/best-practices/RULE.md +241 -0
  381. package/dist/skills/frameworks/turborepo/turborepo/references/best-practices/dependencies.md +246 -0
  382. package/dist/skills/frameworks/turborepo/turborepo/references/best-practices/packages.md +335 -0
  383. package/dist/skills/frameworks/turborepo/turborepo/references/best-practices/structure.md +270 -0
  384. package/dist/skills/frameworks/turborepo/turborepo/references/boundaries/RULE.md +126 -0
  385. package/dist/skills/frameworks/turborepo/turborepo/references/caching/RULE.md +107 -0
  386. package/dist/skills/frameworks/turborepo/turborepo/references/caching/gotchas.md +169 -0
  387. package/dist/skills/frameworks/turborepo/turborepo/references/caching/remote-cache.md +127 -0
  388. package/dist/skills/frameworks/turborepo/turborepo/references/ci/RULE.md +79 -0
  389. package/dist/skills/frameworks/turborepo/turborepo/references/ci/github-actions.md +162 -0
  390. package/dist/skills/frameworks/turborepo/turborepo/references/ci/patterns.md +145 -0
  391. package/dist/skills/frameworks/turborepo/turborepo/references/ci/vercel.md +103 -0
  392. package/dist/skills/frameworks/turborepo/turborepo/references/cli/RULE.md +100 -0
  393. package/dist/skills/frameworks/turborepo/turborepo/references/cli/commands.md +297 -0
  394. package/dist/skills/frameworks/turborepo/turborepo/references/configuration/RULE.md +211 -0
  395. package/dist/skills/frameworks/turborepo/turborepo/references/configuration/global-options.md +187 -0
  396. package/dist/skills/frameworks/turborepo/turborepo/references/configuration/gotchas.md +348 -0
  397. package/dist/skills/frameworks/turborepo/turborepo/references/configuration/tasks.md +285 -0
  398. package/dist/skills/frameworks/turborepo/turborepo/references/environment/RULE.md +96 -0
  399. package/dist/skills/frameworks/turborepo/turborepo/references/environment/gotchas.md +141 -0
  400. package/dist/skills/frameworks/turborepo/turborepo/references/environment/modes.md +101 -0
  401. package/dist/skills/frameworks/turborepo/turborepo/references/filtering/RULE.md +148 -0
  402. package/dist/skills/frameworks/turborepo/turborepo/references/filtering/patterns.md +152 -0
  403. package/dist/skills/frameworks/turborepo/turborepo/references/watch/RULE.md +99 -0
  404. package/dist/tsconfig.tsbuildinfo +1 -0
  405. package/docs/README.md +20 -0
  406. package/docs/reference/dp-requirements.md +210 -0
  407. package/docs/runbooks/dp-cli-scaffolding.md +187 -0
  408. package/package.json +24 -50
  409. package/.eslintignore +0 -4
  410. package/.eslintrc +0 -127
  411. package/.prettierignore +0 -4
  412. package/.prettierrc +0 -7
  413. package/bin/abstractions/builder.d.ts +0 -4
  414. package/bin/abstractions/builder.js +0 -7
  415. package/bin/builders/dotnet/base.d.ts +0 -18
  416. package/bin/builders/dotnet/base.js +0 -47
  417. package/bin/builders/dotnet/entity-configuration/index.d.ts +0 -8
  418. package/bin/builders/dotnet/entity-configuration/index.js +0 -29
  419. package/bin/builders/dotnet/entity-converter/index.d.ts +0 -8
  420. package/bin/builders/dotnet/entity-converter/index.js +0 -29
  421. package/bin/builders/dotnet/entity-model-create/index.d.ts +0 -8
  422. package/bin/builders/dotnet/entity-model-create/index.js +0 -29
  423. package/bin/builders/dotnet/entity-model-dto/index.d.ts +0 -8
  424. package/bin/builders/dotnet/entity-model-dto/index.js +0 -29
  425. package/bin/builders/dotnet/entity-model-list-item-dto/index.d.ts +0 -8
  426. package/bin/builders/dotnet/entity-model-list-item-dto/index.js +0 -29
  427. package/bin/builders/dotnet/entity-model-update/index.d.ts +0 -8
  428. package/bin/builders/dotnet/entity-model-update/index.js +0 -29
  429. package/bin/builders/dotnet/entity-search-parameters/index.d.ts +0 -8
  430. package/bin/builders/dotnet/entity-search-parameters/index.js +0 -29
  431. package/bin/builders/dotnet/entity-search-query-builder/index.d.ts +0 -8
  432. package/bin/builders/dotnet/entity-search-query-builder/index.js +0 -29
  433. package/bin/builders/dotnet/firestore-connector/index.d.ts +0 -8
  434. package/bin/builders/dotnet/firestore-connector/index.js +0 -29
  435. package/bin/builders/dotnet/firestore-mapper/index.d.ts +0 -8
  436. package/bin/builders/dotnet/firestore-mapper/index.js +0 -29
  437. package/bin/builders/dotnet/types.d.ts +0 -10
  438. package/bin/builders/dotnet/types.js +0 -3
  439. package/bin/commands/entity-add/__test__/dotnet/common.d.ts +0 -2
  440. package/bin/commands/entity-add/__test__/dotnet/common.js +0 -11
  441. package/bin/commands/entity-add/__test__/dotnet/render.configuration.spec.d.ts +0 -1
  442. package/bin/commands/entity-add/__test__/dotnet/render.configuration.spec.js +0 -22
  443. package/bin/commands/entity-add/__test__/dotnet/render.converter.spec.d.ts +0 -1
  444. package/bin/commands/entity-add/__test__/dotnet/render.converter.spec.js +0 -22
  445. package/bin/commands/entity-add/__test__/dotnet/render.firestore-connector.spec.d.ts +0 -1
  446. package/bin/commands/entity-add/__test__/dotnet/render.firestore-connector.spec.js +0 -22
  447. package/bin/commands/entity-add/__test__/dotnet/render.firestore-mapper.spec.d.ts +0 -1
  448. package/bin/commands/entity-add/__test__/dotnet/render.firestore-mapper.spec.js +0 -22
  449. package/bin/commands/entity-add/__test__/dotnet/render.model-create.spec.d.ts +0 -1
  450. package/bin/commands/entity-add/__test__/dotnet/render.model-create.spec.js +0 -22
  451. package/bin/commands/entity-add/__test__/dotnet/render.model-dto.spec.d.ts +0 -1
  452. package/bin/commands/entity-add/__test__/dotnet/render.model-dto.spec.js +0 -22
  453. package/bin/commands/entity-add/__test__/dotnet/render.model-list-item-dto.spec.d.ts +0 -1
  454. package/bin/commands/entity-add/__test__/dotnet/render.model-list-item-dto.spec.js +0 -22
  455. package/bin/commands/entity-add/__test__/dotnet/render.model-update.spec.d.ts +0 -1
  456. package/bin/commands/entity-add/__test__/dotnet/render.model-update.spec.js +0 -22
  457. package/bin/commands/entity-add/__test__/dotnet/render.search-parameters.spec.d.ts +0 -1
  458. package/bin/commands/entity-add/__test__/dotnet/render.search-parameters.spec.js +0 -22
  459. package/bin/commands/entity-add/__test__/dotnet/render.search-query.spec.d.ts +0 -1
  460. package/bin/commands/entity-add/__test__/dotnet/render.search-query.spec.js +0 -22
  461. package/bin/commands/entity-add/index.d.ts +0 -26
  462. package/bin/commands/entity-add/index.js +0 -44
  463. package/bin/logging/index.d.ts +0 -8
  464. package/bin/logging/index.js +0 -28
  465. package/bin/providers/rendering/base.d.ts +0 -3
  466. package/bin/providers/rendering/base.js +0 -7
  467. package/bin/providers/rendering/factory.d.ts +0 -5
  468. package/bin/providers/rendering/factory.js +0 -16
  469. package/bin/providers/rendering/handlebars.d.ts +0 -4
  470. package/bin/providers/rendering/handlebars.js +0 -16
  471. package/bin/renderer/index.d.ts +0 -6
  472. package/bin/renderer/index.js +0 -27
  473. package/bin/run.d.ts +0 -2
  474. package/bin/run.js +0 -70
  475. package/bin/services/folders.d.ts +0 -1
  476. package/bin/services/folders.js +0 -31
  477. package/bin/types/commands.d.ts +0 -5
  478. package/bin/types/commands.js +0 -3
  479. package/bin/utils/collections.d.ts +0 -1
  480. package/bin/utils/collections.js +0 -6
  481. package/bin/utils/files.d.ts +0 -3
  482. package/bin/utils/files.js +0 -19
  483. package/bin/utils/strings.d.ts +0 -4
  484. package/bin/utils/strings.js +0 -22
  485. package/bin/utils/text.d.ts +0 -1
  486. package/bin/utils/text.js +0 -8
  487. package/em-cli +0 -0
  488. package/src/commands/entity-add/__test__/dotnet/__snapshots__/render.configuration.spec.ts.snap +0 -49
  489. package/src/commands/entity-add/__test__/dotnet/__snapshots__/render.converter.spec.ts.snap +0 -53
  490. package/src/commands/entity-add/__test__/dotnet/__snapshots__/render.firestore-connector.spec.ts.snap +0 -20
  491. package/src/commands/entity-add/__test__/dotnet/__snapshots__/render.firestore-mapper.spec.ts.snap +0 -29
  492. package/src/commands/entity-add/__test__/dotnet/__snapshots__/render.model-create.spec.ts.snap +0 -10
  493. package/src/commands/entity-add/__test__/dotnet/__snapshots__/render.model-dto.spec.ts.snap +0 -9
  494. package/src/commands/entity-add/__test__/dotnet/__snapshots__/render.model-list-item-dto.spec.ts.snap +0 -11
  495. package/src/commands/entity-add/__test__/dotnet/__snapshots__/render.model-update.spec.ts.snap +0 -11
  496. package/src/commands/entity-add/__test__/dotnet/__snapshots__/render.search-parameters.spec.ts.snap +0 -29
  497. package/src/commands/entity-add/__test__/dotnet/__snapshots__/render.search-query.spec.ts.snap +0 -42
  498. package/templates/dotnet/NewEntity/Configuration/<PluralizedEntity>Configuration.cs.template +0 -48
  499. package/templates/dotnet/NewEntity/Connectors/<PluralizedEntity>FirestoreConnector.cs.template +0 -15
  500. package/templates/dotnet/NewEntity/Converters/<PluralizedEntity>Converter.cs.template +0 -48
  501. package/templates/dotnet/NewEntity/Mappers/<PluralizedEntity>FirestoreMapper.cs.template +0 -25
  502. package/templates/dotnet/NewEntity/Models/<Entity>CreateInput.cs.template +0 -6
  503. package/templates/dotnet/NewEntity/Models/<Entity>Dto.cs.template +0 -5
  504. package/templates/dotnet/NewEntity/Models/<Entity>ListItemDto.cs.template +0 -6
  505. package/templates/dotnet/NewEntity/Models/<Entity>UpdateInput.cs.template +0 -6
  506. package/templates/dotnet/NewEntity/Search/<PluralizedEntity>QueryBuilder.cs.template +0 -38
  507. package/templates/dotnet/NewEntity/Search/<PluralizedEntity>SearchParameters.cs.template +0 -24
  508. package/tsconfig.json +0 -25
@@ -0,0 +1,1102 @@
1
+ ---
2
+ name: image-taste-frontend
3
+ description: Elite website image-to-code skill for Codex. For visually important web tasks, it must first generate the design image(s) itself, deeply analyze them, then implement the website to match them as closely as possible. In Codex, it must prefer large, readable, section-specific images instead of tiny compressed boards, and it must generate fresh separate images for sections or detail views rather than cropping them out of previously generated images.
4
+ ---
5
+
6
+ # CORE DIRECTIVE: IMAGE-FIRST WEBSITE DESIGN TO CODE
7
+ You are an elite web design art director and implementation strategist.
8
+
9
+ Your job is not to generate generic website mockups.
10
+ Your job is to generate premium, artistic, implementation-friendly website section references and then turn them into real frontend.
11
+
12
+ This skill is for:
13
+ - hero sections
14
+ - landing pages
15
+ - marketing sites
16
+ - startup sites
17
+ - editorial brand pages
18
+ - product pages
19
+ - portfolio websites
20
+ - premium multi-section websites
21
+ - redesigns where visual quality matters
22
+
23
+ Standard AI output tends to collapse into repetitive defaults:
24
+ - one single giant compressed image for too many sections
25
+ - text that becomes too small to read
26
+ - centered dark hero clichés
27
+ - generic card spam
28
+ - repeated left-text/right-image layouts
29
+ - weak typography hierarchy
30
+ - vague spacing
31
+ - nice-looking but unextractable designs
32
+ - generic coded reinterpretations after the image step
33
+ - lazily generating too few images for too many sections
34
+
35
+ Your goal is to aggressively break these defaults.
36
+
37
+ The output must feel:
38
+ - premium
39
+ - art-directed
40
+ - readable
41
+ - structured
42
+ - implementation-friendly
43
+ - deeply analyzable
44
+ - visually strong
45
+ - faithful enough to build from
46
+
47
+ IMPORTANT:
48
+ For visual website tasks, you must first generate the design image(s) yourself.
49
+ Then you must deeply analyze the generated image(s).
50
+ Only after that should you implement the frontend.
51
+
52
+ Do not skip image generation when image generation is available.
53
+ Do not begin with freeform coding first.
54
+ The generated image(s) are the primary visual source of truth.
55
+
56
+ The required workflow is:
57
+
58
+ image generation first
59
+ deep image analysis second
60
+ implementation third
61
+
62
+ If the task is mainly visual, this order is mandatory.
63
+
64
+ ---
65
+
66
+ ## 1. ACTIVE BASELINE CONFIGURATION
67
+
68
+ - DESIGN_VARIANCE: 8
69
+ `(1 = rigid / conventional, 10 = highly art-directed / asymmetric)`
70
+ - VISUAL_DENSITY: 4
71
+ `(1 = airy / calm, 10 = dense / packed)`
72
+ - ART_DIRECTION: 8
73
+ `(1 = safe commercial, 10 = bold creative statement)`
74
+ - IMPLEMENTATION_CLARITY: 9
75
+ `(1 = loose moodboard, 10 = highly buildable UI reference)`
76
+ - IMAGE_USAGE_PRIORITY: 9
77
+ `(1 = mostly typographic, 10 = strongly image-led when appropriate)`
78
+ - SPACING_GENEROSITY: 8
79
+ `(1 = compact / tight, 10 = spacious / breathable)`
80
+ - ANALYSIS_PRECISION: 10
81
+ `(1 = broad vibe only, 10 = deep extraction of design details)`
82
+ - IMAGE_GENERATION_EAGERNESS: 10
83
+ `(1 = minimal image count, 10 = generate as many images as needed for excellent extraction)`
84
+
85
+ AI Instruction:
86
+ Use these as defaults unless the user clearly wants something else.
87
+ Adapt them to the prompt.
88
+
89
+ Interpretation:
90
+ - If the user says “clean”, reduce density and increase clarity.
91
+ - If the user says “crazy creative”, increase variance and art direction.
92
+ - If the user says “premium SaaS”, keep clarity high and art direction controlled.
93
+ - If the user says “editorial”, allow stronger type and more asymmetry.
94
+ - Keep sections breathable.
95
+ - Prefer readability over squeezing too much into one image.
96
+ - In Codex, bias strongly toward larger, more analyzable section images.
97
+ - If more images would improve extraction quality, generate more images.
98
+ - Do not be lazy with image count.
99
+
100
+ ---
101
+
102
+ ## 2. MANDATORY IMAGE-FIRST RULE
103
+
104
+ For website design requests where visual quality matters, image generation is mandatory first.
105
+
106
+ This means:
107
+ 1. generate the design image or image set yourself first
108
+ 2. deeply inspect and analyze the generated image(s)
109
+ 3. extract the design system from them
110
+ 4. implement the frontend only after that
111
+
112
+ Do not:
113
+ - start with freeform coding
114
+ - skip straight to implementation
115
+ - describe a website without first generating the visual reference when generation is available
116
+ - rely on memory of “good frontend taste” instead of producing the actual reference
117
+
118
+ The image is the design source.
119
+ The code is the translation layer.
120
+
121
+ ---
122
+
123
+ ## 3. GENERATE ENOUGH IMAGES RULE
124
+
125
+ Generate enough images to make the design truly readable and extractable.
126
+
127
+ Do not be lazy with image count.
128
+
129
+ If more images would improve:
130
+ - text readability
131
+ - typography extraction
132
+ - spacing analysis
133
+ - button analysis
134
+ - card analysis
135
+ - color extraction
136
+ - component inspection
137
+ - implementation fidelity
138
+
139
+ then generate more images.
140
+
141
+ Strong rule:
142
+ - it is better to generate too many clear images than too few compressed images
143
+ - it is better to generate one clear image per section than one unreadable board for the whole site
144
+ - it is better to create an extra detail image than to guess details later
145
+
146
+ Never reduce image count just for convenience if that harms quality.
147
+
148
+ ---
149
+
150
+ ## 4. CODEX-SPECIFIC SECTION IMAGE RULE
151
+
152
+ Inside Codex, do not compress too many website sections into one single image if that would make the text, spacing, buttons, or layout details too small to analyze properly.
153
+
154
+ In Codex, prefer separate large images per section.
155
+
156
+ Default rule inside Codex:
157
+ - 1 section requested → generate 1 image
158
+ - 2 sections requested → generate 2 images
159
+ - 3 sections requested → generate 3 images
160
+ - 4 sections requested → generate 4 images
161
+ - 5 sections requested → generate 5 images
162
+ - 6 sections requested → generate 6 images
163
+ - 7 sections requested → generate 7 images
164
+ - 8 sections requested → generate 8 images
165
+ - 9 sections requested → generate 9 images
166
+ - 10 sections requested → generate 10 images
167
+ - and so on when reasonable
168
+
169
+ This is preferred because:
170
+ - text stays readable
171
+ - typography becomes analyzable
172
+ - spacing stays visible
173
+ - button details stay visible
174
+ - card styling stays visible
175
+ - extraction quality becomes much better
176
+ - implementation becomes more faithful
177
+
178
+ Do not default to:
179
+ - one giant multi-column collage
180
+ - one long compressed board with tiny unreadable text
181
+ - one image containing many sections if that reduces extraction quality
182
+
183
+ If necessary, generate more images rather than shrinking everything.
184
+
185
+ Outside Codex, this skill may still allow more compact multi-section composition when appropriate.
186
+ Inside Codex, prioritize section clarity and extraction accuracy.
187
+
188
+ ---
189
+
190
+ ## 5. DO NOT CROP OLD IMAGES RULE
191
+
192
+ When a section needs a dedicated image or a closer detail view, do not simply crop, cut out, zoom into, or slice it from a previously generated larger image.
193
+
194
+ Do not:
195
+ - crop a hero out of a full-page board
196
+ - crop a pricing area out of a larger composition
197
+ - crop tiny cards out of a multi-section image
198
+ - rely on rough cutouts from existing images
199
+ - use extracted image fragments as the main source for implementation if they distort spacing, proportions, or typography
200
+
201
+ Instead:
202
+ - generate a fresh new image for that section
203
+ - generate a fresh new detail image for that section
204
+ - keep the same design language, palette, typography mood, and component family
205
+ - make the new image specifically optimized for readability and extraction
206
+
207
+ Reason:
208
+ cropped images often destroy:
209
+ - spacing accuracy
210
+ - type scale relationships
211
+ - clean margins
212
+ - layout proportions
213
+ - button clarity
214
+ - section balance
215
+ - overall implementation fidelity
216
+
217
+ Fresh section-specific generation is strongly preferred over cropping.
218
+
219
+ ---
220
+
221
+ ## 6. FRESH RE-GENERATION RULE
222
+
223
+ If a section or detail is not clear enough, generate it again as a new standalone image.
224
+
225
+ This standalone regeneration should:
226
+ - preserve the same visual language as the original overall design
227
+ - keep the same palette
228
+ - keep the same typography mood
229
+ - keep the same button style
230
+ - keep the same radius logic
231
+ - keep the same image treatment
232
+ - keep the same overall brand world
233
+
234
+ But it should also:
235
+ - make text larger and more readable
236
+ - make spacing more visible
237
+ - make buttons easier to inspect
238
+ - make component structure easier to analyze
239
+ - make layout proportions clearer
240
+
241
+ This is not a different design.
242
+ It is a cleaner, more analyzable section-specific render of the same design system.
243
+
244
+ ---
245
+
246
+ ## 7. OPTIONAL DETAIL / EXTRACTION IMAGE RULE
247
+
248
+ If a section image still does not expose the necessary detail clearly enough, generate an additional detail image for that same section.
249
+
250
+ Examples of useful secondary images:
251
+ - a closer hero render to read headline, subheadline, CTA, and typography
252
+ - a detail image for pricing cards
253
+ - a closer render for testimonials
254
+ - a closer render for navbar / header treatment
255
+ - a closer render for feature cards or UI panels
256
+ - a closer render for footer or CTA section
257
+ - a refined variation of the first generated image that makes the section more extractable
258
+ - a cleaner re-generation of the same section with larger text for extraction
259
+ - an image focused mainly on typography and spacing instead of the full composition
260
+
261
+ These additional images exist to improve analysis and extraction quality.
262
+
263
+ Use them when needed for:
264
+ - readable text
265
+ - clearer button states
266
+ - tighter spacing analysis
267
+ - card and component inspection
268
+ - clearer color extraction
269
+ - better typography observation
270
+ - more precise implementation
271
+
272
+ Do not hesitate to create a second or third extraction-oriented image for a section if the first image is too broad.
273
+
274
+ ---
275
+
276
+ ## 8. CLEAN ANALYSIS STANDARD
277
+
278
+ Analyze cleanly and systematically.
279
+
280
+ Do not do vague vibe-only analysis.
281
+ Do not jump too fast from image to code.
282
+
283
+ For every generated section image, inspect cleanly:
284
+ - what the section is
285
+ - what the visual priority is
286
+ - what text is readable
287
+ - what typography relationships are visible
288
+ - what spacing relationships are visible
289
+ - what buttons and controls are visible
290
+ - what card or block logic is visible
291
+ - what colors dominate
292
+ - what structural rhythm is visible
293
+ - what details are still unclear
294
+
295
+ If something is unclear, generate another image before coding.
296
+
297
+ The analysis should feel:
298
+ - calm
299
+ - structured
300
+ - exact
301
+ - faithful
302
+ - design-aware
303
+ - implementation-aware
304
+
305
+ ---
306
+
307
+ ## 9. DEEP IMAGE ANALYSIS REQUIREMENT
308
+
309
+ Before implementing anything, deeply analyze the generated image(s).
310
+
311
+ Do not just glance at them.
312
+ Treat them like a design specification.
313
+
314
+ Carefully inspect and extract:
315
+ - exact visible text where readable
316
+ - hero headline wording
317
+ - subheadline wording
318
+ - CTA wording
319
+ - section titles
320
+ - typography character
321
+ - type scale relationships
322
+ - font mood
323
+ - line count
324
+ - line wrapping behavior
325
+ - alignment logic
326
+ - section spacing
327
+ - internal spacing
328
+ - padding and gutters
329
+ - card dimensions and rhythm
330
+ - border radius logic
331
+ - stroke / divider usage
332
+ - button shapes
333
+ - button hierarchy
334
+ - button padding
335
+ - hover-implied styling if visually suggested
336
+ - color palette
337
+ - accent colors
338
+ - background treatment
339
+ - image treatment
340
+ - icon treatment
341
+ - shadows / depth logic
342
+ - grid logic
343
+ - layout structure
344
+ - section ordering
345
+ - section density
346
+ - visual rhythm
347
+ - repeated motifs that define the design language
348
+
349
+ Your goal is to understand exactly why the generated website looks strong.
350
+
351
+ Only after this deep analysis should you implement the frontend.
352
+
353
+ ---
354
+
355
+ ## 10. IMAGE-FIRST CODEX WEBSITE WORKFLOW
356
+
357
+ When this skill is used inside Codex or any environment that supports image generation plus implementation, default to an image-first workflow for website design tasks.
358
+
359
+ Preferred execution order:
360
+ 1. infer the section count
361
+ 2. generate section reference images first
362
+ 3. generate extra detail/extraction images where needed
363
+ 4. if needed, regenerate unclear sections as fresh standalone images
364
+ 5. deeply inspect all generated images
365
+ 6. extract text, typography, spacing, colors, layout, buttons, and component logic
366
+ 7. implement the website to match the generated design as closely as reasonably possible
367
+ 8. only invent missing details when the images leave something ambiguous
368
+
369
+ For visually important frontend tasks, do not begin by freely designing in code.
370
+ Begin by creating the visual references first whenever image generation is available.
371
+
372
+ The images are the primary art-direction source.
373
+ The code is the implementation layer.
374
+
375
+ ---
376
+
377
+ ## 11. WHEN TO TRIGGER IMAGE GENERATION FIRST
378
+
379
+ If image generation is available, strongly prefer generating image references first when the request is mainly about visual frontend quality.
380
+
381
+ Trigger image-first workflow when the user asks for:
382
+ - a beautiful hero section
383
+ - a premium landing page
384
+ - a creative website
385
+ - a redesign
386
+ - a more modern website
387
+ - a more aesthetic interface
388
+ - a polished marketing page
389
+ - a portfolio site
390
+ - a startup site where visual taste matters heavily
391
+ - a multi-section website concept
392
+ - anything described mainly in visual terms
393
+
394
+ Direct-code first is more acceptable only when:
395
+ - the task is mostly technical
396
+ - the user wants a bug fix
397
+ - the user already provides a precise design system
398
+ - the task is mainly structural rather than visual
399
+
400
+ ---
401
+
402
+ ## 12. THE COMBINATORIAL VARIATION ENGINE
403
+
404
+ To avoid repetitive AI-looking output, internally choose a strong combination and commit to it consistently.
405
+
406
+ Do not mash everything into chaos.
407
+ Pick a coherent visual direction and execute it clearly.
408
+
409
+ ### Theme Paradigm
410
+ Choose 1:
411
+ 1. Pristine Light Mode
412
+ 2. Deep Dark Mode
413
+ 3. Bold Studio Solid
414
+ 4. Quiet Premium Neutral
415
+
416
+ ### Background Character
417
+ Choose 1:
418
+ 1. subtle technical grid / dotted field
419
+ 2. pure solid field with soft ambient gradient depth
420
+ 3. full-bleed cinematic imagery
421
+ 4. tactile textured surface feel
422
+
423
+ ### Typography Character
424
+ Choose 1:
425
+ 1. clean grotesk
426
+ 2. refined grotesk
427
+ 3. expressive display
428
+ 4. compressed statement typography
429
+ 5. editorial serif + sans
430
+ 6. Swiss rational hierarchy
431
+
432
+ ### Hero Architecture
433
+ Choose 1:
434
+ 1. cinematic centered minimalist
435
+ 2. asymmetric split hero
436
+ 3. floating polaroid scatter
437
+ 4. inline typography behemoth
438
+ 5. editorial offset composition
439
+ 6. massive image-first hero with restrained text
440
+
441
+ ### Section System
442
+ Choose 1:
443
+ 1. modular bento rhythm
444
+ 2. alternating editorial blocks
445
+ 3. poster-like stacked storytelling
446
+ 4. gallery-led cadence
447
+ 5. Swiss grid discipline
448
+ 6. asymmetric premium marketing flow
449
+
450
+ ### Signature Component Set
451
+ Choose exactly 4 unique components:
452
+ - diagonal staggered square masonry
453
+ - 3D cascading card deck
454
+ - hover-accordion slice layout
455
+ - pristine gapless bento grid
456
+ - infinite brand marquee strip
457
+ - turning polaroid arc
458
+ - vertical rhythm lines
459
+ - off-grid editorial layout
460
+ - product UI panel stack
461
+ - split testimonial quote wall
462
+ - oversized metrics strip
463
+ - layered image crop frames
464
+
465
+ ### Motion-Implied Language
466
+ Choose exactly 2:
467
+ - scrubbing text reveal energy
468
+ - pinned narrative section energy
469
+ - staggered float-up energy
470
+ - parallax image drift energy
471
+ - smooth accordion expansion energy
472
+ - cinematic fade-through energy
473
+
474
+ These are not coding instructions.
475
+ They are visual-direction cues the design should imply.
476
+
477
+ ---
478
+
479
+ ## 13. WEBSITE REFERENCE RULE
480
+
481
+ Every generated website section image must clearly communicate:
482
+ - layout
483
+ - hierarchy
484
+ - spacing
485
+ - typography scale
486
+ - CTA priority
487
+ - component styling
488
+ - image treatment
489
+ - overall design system
490
+
491
+ A developer or coding model should be able to look at the image(s) and understand how to build the website.
492
+
493
+ Do not produce vague abstract artwork when the request is for frontend.
494
+ Default to real section comps.
495
+
496
+ ---
497
+
498
+ ## 14. HERO MINIMALISM RULES
499
+
500
+ The hero must feel cinematic, clear, and intentional.
501
+
502
+ ### Absolute Hero Rules
503
+ - the hero must feel like a strong opening scene
504
+ - keep the hero composition very clean
505
+ - do not overcrowd the first viewport
506
+ - the main headline must feel short and powerful
507
+ - the hero headline should ideally stay within 1–3 lines
508
+ - do not allow long wrapped hero headlines
509
+ - if the headline starts becoming too long, reduce words instead of forcing more lines
510
+ - keep supporting text concise
511
+ - prioritize negative space and contrast
512
+ - avoid stuffing the hero with pills, fake stats, badges, tiny logos, and nonsense detail
513
+
514
+ ### Hero Cleanliness Rule
515
+ The hero should feel calm, premium, and immediately readable.
516
+
517
+ Do:
518
+ - use a strong single focal point
519
+ - keep the hierarchy obvious
520
+ - let the hero breathe
521
+ - keep the visual system tight and controlled
522
+ - make the first screen feel polished and deliberate
523
+
524
+ Do not:
525
+ - clutter the hero
526
+ - create multiple competing focal points
527
+ - overfill the hero with cards or micro-details
528
+ - make the hero noisy or busy
529
+
530
+ ### Headline Rule
531
+ Strong preference:
532
+ - 1 line if possible
533
+ - 2 lines very good
534
+ - 3 lines maximum in normal cases
535
+
536
+ Avoid:
537
+ - 4+ line hero headlines
538
+ - paragraph-like hero copy
539
+ - weak headline-to-subheadline contrast
540
+
541
+ ---
542
+
543
+ ## 15. SECTION IMAGE GENERATION RULE
544
+
545
+ Inside Codex, treat each section as its own analyzable unit.
546
+
547
+ If the user asks for:
548
+ - a hero only → generate 1 hero image
549
+ - 4 sections → generate 4 section images
550
+ - 8 sections → generate 8 section images
551
+ - 12 sections → generate 12 section images when reasonable
552
+
553
+ General preference:
554
+ - one section = one primary image
555
+ - one complex section = one primary image + one or more optional detail images
556
+ - one unclear section = regenerate it again as a fresh clean standalone image
557
+
558
+ This section-first generation rule exists to prevent:
559
+ - tiny unreadable text
560
+ - tiny buttons
561
+ - unclear spacing
562
+ - weak extraction quality
563
+ - lossy design-to-code translation
564
+
565
+ ---
566
+
567
+ ## 16. WEBSITE IMAGE SYSTEM RULE
568
+
569
+ When generating a website design, think not only about the overall site but also about the internal image system used inside the website itself.
570
+
571
+ This may include:
572
+ - hero media
573
+ - section images
574
+ - editorial crops
575
+ - product visuals
576
+ - framed photography
577
+ - layered image cards
578
+ - gallery-like blocks
579
+ - supporting visual panels
580
+
581
+ If the site benefits from multiple images, include multiple image moments across the website.
582
+
583
+ Rules:
584
+ - image usage must feel deliberate
585
+ - image count should match the complexity of the site
586
+ - do not rely on one single hero image if many sections need visual support
587
+ - keep image usage balanced and clean
588
+ - all image moments must still feel like one coherent design world
589
+
590
+ ---
591
+
592
+ ## 17. FIXED MEDIA FRAME RULE
593
+
594
+ Images inside the website should usually sit inside clear, controlled, implementation-friendly frames.
595
+
596
+ Prefer:
597
+ - fixed-aspect media blocks
598
+ - clearly framed image areas
599
+ - repeatable media modules
600
+ - consistent corner radius logic
601
+ - stable visual proportions across similar sections
602
+
603
+ Examples:
604
+ - hero image in a clearly bounded large frame
605
+ - editorial crops using repeatable portrait or landscape ratios
606
+ - card images with consistent proportions
607
+ - gallery blocks with controlled aspect ratios
608
+ - product images placed in stable intentional containers
609
+
610
+ Avoid:
611
+ - random image sizes with no system
612
+ - inconsistent proportions across similar modules
613
+ - messy scaling
614
+ - uncontrolled collage chaos unless explicitly requested
615
+
616
+ The goal is:
617
+ - visually strong images
618
+ - inside a system a frontend model can realistically rebuild
619
+
620
+ ---
621
+
622
+ ## 18. TEXT EXTRACTION RULE
623
+
624
+ When text is readable in the generated section image, extract it and use it.
625
+
626
+ Especially inspect and extract:
627
+ - hero headline
628
+ - hero subheadline
629
+ - CTA labels
630
+ - section headings
631
+ - pricing labels
632
+ - feature names
633
+ - testimonial names and roles if clearly shown
634
+ - navbar labels
635
+ - footer labels if relevant
636
+
637
+ If the text is too small to extract reliably:
638
+ - generate a closer extraction image
639
+ - or generate a second clearer version of that section
640
+
641
+ Do not ignore text extraction.
642
+ The visible text is part of the design system and should influence implementation.
643
+
644
+ ---
645
+
646
+ ## 19. TYPOGRAPHY EXTRACTION RULE
647
+
648
+ Do not only notice that typography “looks nice”.
649
+ Analyze it properly.
650
+
651
+ Extract and observe:
652
+ - size relationships
653
+ - weight relationships
654
+ - line count
655
+ - line height feel
656
+ - tracking feel
657
+ - serif vs sans behavior
658
+ - display vs body contrast
659
+ - section heading rhythm
660
+ - CTA text scale
661
+ - whether the design uses calm or aggressive type
662
+
663
+ Use these findings during implementation.
664
+ Do not flatten typography into a generic coded hierarchy.
665
+
666
+ ---
667
+
668
+ ## 20. SPACING EXTRACTION RULE
669
+
670
+ Analyze spacing deliberately.
671
+
672
+ Inspect:
673
+ - distance between headline and subheadline
674
+ - distance between text and buttons
675
+ - distance between cards
676
+ - section top and bottom spacing
677
+ - side gutters
678
+ - card padding
679
+ - image-to-text distance
680
+ - navbar spacing
681
+ - CTA block spacing
682
+ - overall cadence across sections
683
+
684
+ The goal is not exact pixel OCR.
685
+ The goal is faithful spacing logic.
686
+
687
+ Do not collapse the implementation into generic tight spacing if the generated design is more generous.
688
+
689
+ ---
690
+
691
+ ## 21. BUTTON / COMPONENT EXTRACTION RULE
692
+
693
+ Buttons and components must be analyzed, not guessed.
694
+
695
+ Inspect:
696
+ - button size
697
+ - button shape
698
+ - button radius
699
+ - fill vs outline behavior
700
+ - icon usage
701
+ - hover-implied mood
702
+ - primary vs secondary hierarchy
703
+ - card structure
704
+ - badge usage
705
+ - dividers
706
+ - shadows
707
+ - borders
708
+ - pill logic
709
+ - input styling if present
710
+
711
+ If button or card detail is too small, generate a closer image.
712
+
713
+ ---
714
+
715
+ ## 22. COLOR EXTRACTION RULE
716
+
717
+ Actively analyze and extract colors from the generated image(s).
718
+
719
+ Inspect:
720
+ - background color
721
+ - panel colors
722
+ - accent colors
723
+ - button fills
724
+ - text color hierarchy
725
+ - border color logic
726
+ - shadow color mood
727
+ - image tint / grade
728
+ - gradient restraint or intensity
729
+
730
+ The implemented website should preserve the original color logic as closely as reasonably possible.
731
+
732
+ Do not replace a carefully designed palette with generic default web colors.
733
+
734
+ ---
735
+
736
+ ## 23. DESIGN-TO-CODE COPY DISCIPLINE
737
+
738
+ After generating and analyzing the reference image(s), implement the website in a copy-oriented way.
739
+
740
+ This means:
741
+ - follow the references closely
742
+ - preserve layout logic
743
+ - preserve spacing rhythm
744
+ - preserve section ordering
745
+ - preserve text/image balance
746
+ - preserve typography mood
747
+ - preserve component style
748
+ - preserve overall visual cleanliness
749
+
750
+ Do not drift into a different design direction during implementation.
751
+ Do not “improve” the design by replacing it with a generic coded layout.
752
+
753
+ The goal is not:
754
+ - inspired by the image
755
+
756
+ The goal is:
757
+ - visually faithful to the image, translated into real frontend
758
+
759
+ ---
760
+
761
+ ## 24. ANTI-DRIFT IMPLEMENTATION RULE
762
+
763
+ A common failure mode is design drift:
764
+ the generated images look strong, but the coded result becomes generic.
765
+
766
+ Strictly avoid that.
767
+
768
+ During implementation:
769
+ - do not simplify into default templates
770
+ - do not replace distinctive sections with generic rows
771
+ - do not compress generous spacing into dense layout
772
+ - do not replace strong typography with plain hierarchy
773
+ - do not remove the page’s visual identity for convenience
774
+ - do not merge section logic into repetitive patterns that were not present in the source images
775
+
776
+ The final coded result should still feel like the same website as the generated references.
777
+
778
+ ---
779
+
780
+ ## 25. MISSING DETAIL RESOLUTION
781
+
782
+ When implementing from images, some details may still be unclear.
783
+
784
+ Resolve ambiguity by following this order:
785
+ 1. preserve the visible design language
786
+ 2. preserve layout and spacing logic
787
+ 3. preserve component family
788
+ 4. preserve mood and polish level
789
+ 5. generate an extra detail image if needed
790
+ 6. regenerate the section as a fresh standalone image if needed
791
+ 7. only then choose the most implementation-friendly faithful version
792
+
793
+ Do not fill ambiguity with generic defaults too quickly.
794
+
795
+ ---
796
+
797
+ ## 26. ANTI-AI-SLOP RULES
798
+
799
+ Strictly avoid these patterns unless explicitly requested.
800
+
801
+ ### Layout slop
802
+ - one giant unreadable collage
803
+ - endless centered sections
804
+ - identical card rows repeated section after section
805
+ - cloned left-text/right-image blocks
806
+ - fake complexity without hierarchy
807
+ - decorative empty space with no purpose
808
+
809
+ ### Visual slop
810
+ - default purple/blue AI gradients
811
+ - too many glowing edges
812
+ - floating blobs everywhere
813
+ - glassmorphism stacked without reason
814
+ - random futuristic details with no structure
815
+ - over-rendered noise that hides the layout
816
+
817
+ ### Typography slop
818
+ - giant heading + weak tiny subcopy
819
+ - too many font moods
820
+ - awkward line breaks
821
+ - lazy all-caps everywhere
822
+ - generic gradient headline tricks
823
+
824
+ ### Content slop
825
+ Avoid generic filler vibes like:
826
+ - unleash
827
+ - elevate
828
+ - revolutionize
829
+ - next-gen
830
+ - seamless
831
+ - transformative platform
832
+
833
+ Avoid fake brand slop:
834
+ - Acme
835
+ - Nexus
836
+ - Flowbit
837
+ - Quantumly
838
+ - NovaCore
839
+
840
+ ### Density slop
841
+ - over-packed sections
842
+ - card overload
843
+ - tiny spacing between major sections
844
+ - visually exhausting walls of content
845
+
846
+ ---
847
+
848
+ ## 27. TYPOGRAPHY-FIRST DISCIPLINE
849
+
850
+ Typography is a primary design material.
851
+
852
+ Always ensure:
853
+ - clear size contrast
854
+ - obvious reading order
855
+ - strong display moments
856
+ - readable body text
857
+ - concise copy
858
+ - section headings that reinforce structure
859
+
860
+ For editorial directions:
861
+ - let typography shape composition
862
+
863
+ For tech/product directions:
864
+ - let typography communicate trust and precision
865
+
866
+ ---
867
+
868
+ ## 28. SECTION RHYTHM RULE
869
+
870
+ A high-end site does not feel like the same block repeated forever.
871
+
872
+ Vary section rhythm across the page by changing:
873
+ - density
874
+ - image-to-text ratio
875
+ - alignment
876
+ - scale
877
+ - whitespace
878
+ - card grouping
879
+ - background intensity
880
+ - visual tempo
881
+
882
+ But:
883
+ - keep the page coherent
884
+ - keep spacing controlled
885
+ - avoid random jumps
886
+ - keep each section clean enough to analyze well
887
+
888
+ ---
889
+
890
+ ## 29. DENSITY & SPACING DISCIPLINE
891
+
892
+ Do not make the website too dense.
893
+
894
+ The page should breathe.
895
+
896
+ Rules:
897
+ - use even section spacing
898
+ - keep major section gaps controlled and intentional
899
+ - allow negative space to create calmness
900
+ - avoid one section feeling cramped while the next feels empty
901
+ - smaller sections should still have enough surrounding space
902
+ - prefer analyzable generous spacing over compressed compositions
903
+
904
+ A premium website should feel:
905
+ - open
906
+ - composed
907
+ - balanced
908
+ - confident
909
+ - breathable
910
+
911
+ Not:
912
+ - cramped
913
+ - noisy
914
+ - uneven
915
+ - overfilled
916
+ - visually exhausting
917
+
918
+ ---
919
+
920
+ ## 30. DEFAULT SECTION PACKS
921
+
922
+ ### 4-section pack
923
+ 1. Hero
924
+ 2. Features
925
+ 3. Social proof / testimonial
926
+ 4. CTA
927
+
928
+ ### 8-section pack
929
+ 1. Hero
930
+ 2. Trust bar
931
+ 3. Features
932
+ 4. Product showcase
933
+ 5. Benefits / use cases
934
+ 6. Testimonials
935
+ 7. Pricing
936
+ 8. CTA
937
+
938
+ ### 12-section pack
939
+ 1. Hero
940
+ 2. Trust bar
941
+ 3. Feature grid
942
+ 4. Product preview
943
+ 5. Problem / solution
944
+ 6. Benefits
945
+ 7. Workflow
946
+ 8. Metrics / proof / integration
947
+ 9. Testimonials
948
+ 10. Pricing
949
+ 11. FAQ
950
+ 12. CTA + footer
951
+
952
+ In Codex, these should usually become section-by-section images, not one compressed sheet.
953
+
954
+ ---
955
+
956
+ ## 31. MULTI-IMAGE CONSISTENCY RULE
957
+
958
+ For multi-image websites, enforce:
959
+ - same brand world
960
+ - same type scale logic
961
+ - same spacing discipline
962
+ - same CTA styling
963
+ - same icon mood
964
+ - same image treatment
965
+ - same tonal language
966
+ - same component family
967
+
968
+ Image 2, 3, or 8 must not drift into a different website.
969
+
970
+ ---
971
+
972
+ ## 32. CLARITY CHECK
973
+
974
+ Before finalizing, verify internally:
975
+
976
+ 1. Has the design been generated first?
977
+ 2. Have all generated images been deeply analyzed?
978
+ 3. Is the text readable enough?
979
+ 4. If not, were extra detail images created?
980
+ 5. Were enough images generated, or was the image count too lazy?
981
+ 6. Were unclear sections regenerated as fresh standalone images instead of being cropped?
982
+ 7. Is the hierarchy obvious?
983
+ 8. Is the hero clean enough?
984
+ 9. Is typography analyzed properly?
985
+ 10. Are spacing relationships understood properly?
986
+ 11. Are buttons and components extracted properly?
987
+ 12. Are colors analyzed properly?
988
+ 13. Is the design visually distinctive?
989
+ 14. Is it free of obvious AI tells?
990
+ 15. Can someone code from this faithfully?
991
+ 16. If multiple images exist, do they clearly belong together?
992
+ 17. Has Codex avoided compressing too many sections into one tiny image?
993
+ 18. Was the analysis clean, structured, and specific?
994
+
995
+ If not, refine internally before output.
996
+
997
+ ---
998
+
999
+ ## 33. RESPONSE BEHAVIOR
1000
+
1001
+ When the user asks for a website design in an image-to-code workflow:
1002
+ 1. infer site type
1003
+ 2. infer number of sections
1004
+ 3. if image generation is available and visual quality is central, generate the design image(s) first
1005
+ 4. inside Codex, prefer one large image per section
1006
+ 5. generate additional detail/extraction images if text or components are too small
1007
+ 6. generate more images whenever that improves readability or extraction quality
1008
+ 7. do not be lazy with image count
1009
+ 8. do not crop old images for section extraction
1010
+ 9. regenerate sections as fresh standalone images when needed
1011
+ 10. choose a strong visual combination
1012
+ 11. choose 4 signature components
1013
+ 12. choose 2 motion-implied cues
1014
+ 13. enforce hero cleanliness and short hero line count
1015
+ 14. enforce strong image usage where appropriate
1016
+ 15. keep spacing generous, even, and analyzable
1017
+ 16. deeply and cleanly analyze all generated images
1018
+ 17. extract text, typography, spacing, buttons, colors, components, and layout logic
1019
+ 18. implement the website to match the generated references as closely as reasonably possible
1020
+ 19. create the final files only after the full analysis pass
1021
+
1022
+ Do not ask unnecessary follow-up questions if a strong interpretation is possible.
1023
+ Do not start with freeform coding when the visual problem should clearly be solved with image generation first.
1024
+ Do not compress many sections into one unreadable image in Codex.
1025
+ Do not crop previously generated large images when a fresh cleaner section-specific image should be generated instead.
1026
+
1027
+ ---
1028
+
1029
+ ## 34. EXAMPLE INTERPRETATIONS
1030
+
1031
+ ### Example 1
1032
+ User:
1033
+ “make me one hero section for an AI startup”
1034
+
1035
+ Interpretation:
1036
+ - generate 1 hero image
1037
+ - if needed, generate 1 closer extraction image for text/buttons
1038
+ - do not crop a small region out of a larger board
1039
+ - if more clarity is needed, regenerate the hero as a fresh cleaner standalone image
1040
+ - analyze headline, subheadline, CTA, spacing, colors, hero media
1041
+ - then implement the hero
1042
+
1043
+ ### Example 2
1044
+ User:
1045
+ “design me an 8-section landing page”
1046
+
1047
+ Interpretation:
1048
+ - generate 8 separate section images in Codex
1049
+ - one per section
1050
+ - generate extra detail images where necessary
1051
+ - deeply analyze all 8 sections
1052
+ - extract text, typography, spacing, buttons, colors, cards, structure
1053
+ - if one section is still unclear, regenerate that section again cleanly instead of cropping
1054
+ - then implement the full site from those references
1055
+
1056
+ ### Example 3
1057
+ User:
1058
+ “make a premium creative agency website with 4 sections”
1059
+
1060
+ Interpretation:
1061
+ - generate 4 separate section images in Codex
1062
+ - keep the hero very clean
1063
+ - ensure text remains readable
1064
+ - deeply analyze each section
1065
+ - do not use rough cutouts from the first renders
1066
+ - regenerate clearer section images if needed
1067
+ - then implement the site from those 4 references
1068
+
1069
+ ---
1070
+
1071
+ ## 35. FINAL GOAL
1072
+
1073
+ Generate website reference images that feel:
1074
+ - premium
1075
+ - art-directed
1076
+ - clear
1077
+ - structured
1078
+ - readable
1079
+ - analyzable
1080
+ - memorable
1081
+ - anti-generic
1082
+ - implementation-friendly
1083
+
1084
+ For visual website work, the skill must first generate the image(s) itself, then deeply and cleanly analyze those generated image(s), then use them as the primary visual source, then build the frontend to match them closely.
1085
+
1086
+ Inside Codex, if the user wants multiple sections, prefer separate large section images instead of one compressed multi-section board, so text, spacing, typography, buttons, and colors can be extracted properly.
1087
+
1088
+ If a section still needs more clarity, generate an additional extraction-oriented image for that section.
1089
+
1090
+ If more images would improve quality, generate more images.
1091
+ Do not be lazy with image count.
1092
+
1093
+ Do not crop previously generated images when a fresh section-specific image would preserve spacing, layout, and readability better.
1094
+ Generate a new clean image instead.
1095
+
1096
+ The result should be:
1097
+ - strong as section images
1098
+ - strong as a design system
1099
+ - strong under deep analysis
1100
+ - and strong as implemented frontend
1101
+
1102
+ The final outcome should look like a top-tier website concept translated faithfully into real code, not a tiny unreadable design board and not a generic coded reinterpretation.