exonous 0.0.0-stage → 2.10.4

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 (385) hide show
  1. package/README.md +100 -2
  2. package/assets/THIRD-PARTY-NOTICES.md +29 -0
  3. package/assets/adapters/opencode/exonous.js +54 -0
  4. package/assets/agents/exo-backend.md +22 -0
  5. package/assets/agents/exo-cto.md +22 -0
  6. package/assets/agents/exo-data-ai.md +22 -0
  7. package/assets/agents/exo-designer.md +22 -0
  8. package/assets/agents/exo-devops.md +22 -0
  9. package/assets/agents/exo-frontend.md +22 -0
  10. package/assets/agents/exo-infra.md +22 -0
  11. package/assets/agents/exo-mobile.md +22 -0
  12. package/assets/agents/exo-pm.md +22 -0
  13. package/assets/agents/exo-qa.md +22 -0
  14. package/assets/agents/exo-researcher.md +22 -0
  15. package/assets/agents/exo-security.md +22 -0
  16. package/assets/agents/roster.json +209 -0
  17. package/assets/agents/taxis.js +189 -0
  18. package/assets/editors/cursor/frontend-skills.mdc +27 -0
  19. package/assets/editors/hooks/cursor/hooks.json +11 -0
  20. package/assets/machine/PR-TEMPLATE.md +21 -0
  21. package/assets/machine/hooks/anamnesis.cjs +61 -0
  22. package/assets/machine/hooks/ethos.cjs +48 -0
  23. package/assets/machine/hooks/kairos.cjs +46 -0
  24. package/assets/machine/hooks/lib/cli-options.cjs +133 -0
  25. package/assets/machine/hooks/lib/memory.cjs +488 -0
  26. package/assets/machine/hooks/lib/metron.cjs +52 -0
  27. package/assets/machine/hooks/lib/paths.cjs +99 -0
  28. package/assets/machine/hooks/lib/payload.cjs +81 -0
  29. package/assets/machine/hooks/lib/pr-template-validate.cjs +103 -0
  30. package/assets/machine/hooks/lib/release.cjs +58 -0
  31. package/assets/machine/hooks/lib/repo.cjs +138 -0
  32. package/assets/machine/hooks/lib/sanitize.cjs +37 -0
  33. package/assets/machine/hooks/lib/selfupdate.cjs +354 -0
  34. package/assets/machine/hooks/lib/shell.cjs +722 -0
  35. package/assets/machine/hooks/lib/template.cjs +70 -0
  36. package/assets/machine/hooks/lib/token.cjs +110 -0
  37. package/assets/machine/hooks/lib/validate-pr-body.cjs +21 -0
  38. package/assets/machine/hooks/pyle.cjs +302 -0
  39. package/assets/rules/nomos.md +59 -0
  40. package/assets/rules/praxis.md +38 -0
  41. package/assets/skills/code-review/SKILL.md +124 -0
  42. package/assets/skills/commit-changes/SKILL.md +49 -0
  43. package/assets/skills/deliver/SKILL.md +114 -0
  44. package/assets/skills/deliver/references/parallel.md +37 -0
  45. package/assets/skills/doc/SKILL.md +140 -0
  46. package/assets/skills/doc/doc.mjs +277 -0
  47. package/assets/skills/issue-board/SKILL.md +84 -0
  48. package/assets/skills/issue-board/board.mjs +389 -0
  49. package/assets/skills/issue-board/config.example.json +9 -0
  50. package/assets/skills/issue-board/render.py +189 -0
  51. package/assets/skills/make-pr/SKILL.md +24 -0
  52. package/assets/skills/native-ui/SKILL.md +67 -0
  53. package/assets/skills/native-ui/reference/apple.md +180 -0
  54. package/assets/skills/native-ui/reference/mobile-feel.md +221 -0
  55. package/assets/skills/native-ui/reference/swift.md +289 -0
  56. package/assets/skills/project-memory/SKILL.md +59 -0
  57. package/assets/skills/project-memory/config.example.json +4 -0
  58. package/assets/skills/project-memory/project-memory.mjs +478 -0
  59. package/assets/skills/security-review/SKILL.md +102 -0
  60. package/assets/skills/session-handoff/SKILL.md +23 -0
  61. package/assets/skills/session-handoff/config.example.json +3 -0
  62. package/assets/skills/ui-design/SKILL.md +75 -0
  63. package/assets/skills/ui-design/reference/adapt.md +151 -0
  64. package/assets/skills/ui-design/reference/adapt.native.md +35 -0
  65. package/assets/skills/ui-design/reference/android.md +50 -0
  66. package/assets/skills/ui-design/reference/animate.md +87 -0
  67. package/assets/skills/ui-design/reference/audit.md +76 -0
  68. package/assets/skills/ui-design/reference/audit.native.md +126 -0
  69. package/assets/skills/ui-design/reference/bolder.md +33 -0
  70. package/assets/skills/ui-design/reference/clarify.md +84 -0
  71. package/assets/skills/ui-design/reference/colorize.md +86 -0
  72. package/assets/skills/ui-design/reference/craft-floor.md +25 -0
  73. package/assets/skills/ui-design/reference/critique.md +345 -0
  74. package/assets/skills/ui-design/reference/degraded/asset-producer.md +35 -0
  75. package/assets/skills/ui-design/reference/degraded/documenter.md +23 -0
  76. package/assets/skills/ui-design/reference/degraded/finish-reviewer.md +43 -0
  77. package/assets/skills/ui-design/reference/degraded/manual-edit-applier.md +56 -0
  78. package/assets/skills/ui-design/reference/delight.md +63 -0
  79. package/assets/skills/ui-design/reference/distill.md +98 -0
  80. package/assets/skills/ui-design/reference/doctor.md +49 -0
  81. package/assets/skills/ui-design/reference/document.md +273 -0
  82. package/assets/skills/ui-design/reference/extract.md +52 -0
  83. package/assets/skills/ui-design/reference/harden.md +122 -0
  84. package/assets/skills/ui-design/reference/hooks.md +114 -0
  85. package/assets/skills/ui-design/reference/init.md +47 -0
  86. package/assets/skills/ui-design/reference/ios.md +55 -0
  87. package/assets/skills/ui-design/reference/layout.md +81 -0
  88. package/assets/skills/ui-design/reference/live-setup.md +75 -0
  89. package/assets/skills/ui-design/reference/live.md +326 -0
  90. package/assets/skills/ui-design/reference/new-work.md +350 -0
  91. package/assets/skills/ui-design/reference/onboard.md +85 -0
  92. package/assets/skills/ui-design/reference/operate.md +29 -0
  93. package/assets/skills/ui-design/reference/optimize.md +101 -0
  94. package/assets/skills/ui-design/reference/overdrive.md +83 -0
  95. package/assets/skills/ui-design/reference/polish.md +77 -0
  96. package/assets/skills/ui-design/reference/quieter.md +95 -0
  97. package/assets/skills/ui-design/reference/routing.md +37 -0
  98. package/assets/skills/ui-design/reference/shape.md +43 -0
  99. package/assets/skills/ui-design/reference/styles/brutalist.md +45 -0
  100. package/assets/skills/ui-design/reference/styles/design-md.md +70 -0
  101. package/assets/skills/ui-design/reference/styles/direction.md +95 -0
  102. package/assets/skills/ui-design/reference/styles/full-output.md +42 -0
  103. package/assets/skills/ui-design/reference/styles/minimalist.md +64 -0
  104. package/assets/skills/ui-design/reference/styles/premium.md +65 -0
  105. package/assets/skills/ui-design/reference/styles/redesign.md +59 -0
  106. package/assets/skills/ui-design/reference/typeset.md +73 -0
  107. package/assets/skills/ui-design/reference/visualize.md +156 -0
  108. package/assets/skills/ui-design/scripts/ENGINE-LICENSE +191 -0
  109. package/assets/skills/ui-design/scripts/VERSION +1 -0
  110. package/assets/skills/ui-design/scripts/bin/darwin-arm64/impeccable +0 -0
  111. package/assets/skills/ui-design/scripts/command-metadata.json +94 -0
  112. package/assets/skills/ui-design/scripts/data/font-index-failures.json +121 -0
  113. package/assets/skills/ui-design/scripts/data/font-index.json +1 -0
  114. package/assets/skills/ui-design/scripts/impeccable +206 -0
  115. package/assets/skills/ui-design/scripts/impeccable.cmd +214 -0
  116. package/assets/skills/ui-design/scripts/live-browser-dom.js +167 -0
  117. package/assets/skills/ui-design/scripts/live-browser-ignores.js +242 -0
  118. package/assets/skills/ui-design/scripts/live-browser-session.js +144 -0
  119. package/assets/skills/ui-design/scripts/live-browser.js +12990 -0
  120. package/assets/skills/ui-design/scripts/modern-screenshot.umd.js +14 -0
  121. package/assets/skills/ui-design/scripts/ui-design +6 -0
  122. package/assets/skills/ui-design/scripts/ui-design.cmd +3 -0
  123. package/assets/skills/ui-design/scripts/ui-design.mjs +124 -0
  124. package/assets/skills/ui-mockup/SKILL.md +68 -0
  125. package/assets/skills/ui-mockup/reference/brandkit.md +101 -0
  126. package/assets/skills/ui-mockup/reference/image-to-code.md +83 -0
  127. package/assets/skills/ui-mockup/reference/mobile-comps.md +94 -0
  128. package/assets/skills/ui-mockup/reference/web-comps.md +83 -0
  129. package/assets/skills/ui-motion/SKILL.md +112 -0
  130. package/assets/skills/ui-motion/reference/expo.md +224 -0
  131. package/assets/skills/ui-motion/reference/opportunities.md +81 -0
  132. package/assets/skills/ui-motion/reference/prototype.md +238 -0
  133. package/assets/skills/ui-motion/reference/review.md +163 -0
  134. package/assets/skills/ui-motion/reference/toasts.md +144 -0
  135. package/assets/skills/ui-motion/reference/ui-libraries.md +71 -0
  136. package/assets/skills/ui-motion/reference/vocabulary.md +130 -0
  137. package/assets/skills/ui-motion/reference/web.md +294 -0
  138. package/assets/skills/ui-patterns/SKILL.md +105 -0
  139. package/assets/skills/ui-patterns/references/stacks/html-tailwind.md +40 -0
  140. package/assets/skills/ui-patterns/references/stacks/nextjs.md +52 -0
  141. package/assets/skills/ui-patterns/references/stacks/nuxt.md +100 -0
  142. package/assets/skills/ui-patterns/references/stacks/react-native.md +48 -0
  143. package/assets/skills/ui-patterns/references/stacks/react.md +49 -0
  144. package/assets/skills/ui-patterns/references/stacks/shadcn.md +57 -0
  145. package/assets/skills/ui-patterns/references/stacks/vue.md +37 -0
  146. package/assets/techne/.claude-plugin/marketplace.json +31 -0
  147. package/assets/techne/.claude-plugin/plugin.json +24 -0
  148. package/assets/techne/.mcp.json +8 -0
  149. package/assets/techne/commands/build-fix.md +48 -0
  150. package/assets/techne/commands/refactor-clean.md +46 -0
  151. package/assets/techne/commands/test-coverage.md +42 -0
  152. package/assets/techne/hooks/hooks.json +49 -0
  153. package/assets/techne/rules/angular/coding-style.md +49 -0
  154. package/assets/techne/rules/angular/hooks.md +23 -0
  155. package/assets/techne/rules/angular/patterns.md +48 -0
  156. package/assets/techne/rules/angular/security.md +26 -0
  157. package/assets/techne/rules/angular/testing.md +46 -0
  158. package/assets/techne/rules/arkts/coding-style.md +63 -0
  159. package/assets/techne/rules/arkts/hooks.md +38 -0
  160. package/assets/techne/rules/arkts/patterns.md +42 -0
  161. package/assets/techne/rules/arkts/security.md +35 -0
  162. package/assets/techne/rules/arkts/testing.md +39 -0
  163. package/assets/techne/rules/common/agents.md +6 -0
  164. package/assets/techne/rules/common/code-review.md +15 -0
  165. package/assets/techne/rules/common/coding-style.md +13 -0
  166. package/assets/techne/rules/common/development-workflow.md +5 -0
  167. package/assets/techne/rules/common/git-workflow.md +30 -0
  168. package/assets/techne/rules/common/hooks.md +7 -0
  169. package/assets/techne/rules/common/patterns.md +3 -0
  170. package/assets/techne/rules/common/performance.md +3 -0
  171. package/assets/techne/rules/common/security.md +5 -0
  172. package/assets/techne/rules/common/testing.md +3 -0
  173. package/assets/techne/rules/cpp/coding-style.md +31 -0
  174. package/assets/techne/rules/cpp/hooks.md +26 -0
  175. package/assets/techne/rules/cpp/patterns.md +31 -0
  176. package/assets/techne/rules/cpp/security.md +37 -0
  177. package/assets/techne/rules/cpp/testing.md +31 -0
  178. package/assets/techne/rules/csharp/coding-style.md +30 -0
  179. package/assets/techne/rules/csharp/hooks.md +24 -0
  180. package/assets/techne/rules/csharp/patterns.md +28 -0
  181. package/assets/techne/rules/csharp/security.md +32 -0
  182. package/assets/techne/rules/csharp/testing.md +27 -0
  183. package/assets/techne/rules/dart/coding-style.md +47 -0
  184. package/assets/techne/rules/dart/hooks.md +26 -0
  185. package/assets/techne/rules/dart/patterns.md +38 -0
  186. package/assets/techne/rules/dart/security.md +44 -0
  187. package/assets/techne/rules/dart/testing.md +39 -0
  188. package/assets/techne/rules/fsharp/coding-style.md +34 -0
  189. package/assets/techne/rules/fsharp/hooks.md +25 -0
  190. package/assets/techne/rules/fsharp/patterns.md +43 -0
  191. package/assets/techne/rules/fsharp/security.md +32 -0
  192. package/assets/techne/rules/fsharp/testing.md +27 -0
  193. package/assets/techne/rules/golang/coding-style.md +30 -0
  194. package/assets/techne/rules/golang/hooks.md +17 -0
  195. package/assets/techne/rules/golang/patterns.md +43 -0
  196. package/assets/techne/rules/golang/security.md +33 -0
  197. package/assets/techne/rules/golang/testing.md +20 -0
  198. package/assets/techne/rules/java/coding-style.md +51 -0
  199. package/assets/techne/rules/java/hooks.md +18 -0
  200. package/assets/techne/rules/java/patterns.md +55 -0
  201. package/assets/techne/rules/java/security.md +33 -0
  202. package/assets/techne/rules/java/testing.md +33 -0
  203. package/assets/techne/rules/kotlin/coding-style.md +50 -0
  204. package/assets/techne/rules/kotlin/hooks.md +17 -0
  205. package/assets/techne/rules/kotlin/patterns.md +44 -0
  206. package/assets/techne/rules/kotlin/security.md +34 -0
  207. package/assets/techne/rules/kotlin/testing.md +38 -0
  208. package/assets/techne/rules/nuxt/coding-style.md +20 -0
  209. package/assets/techne/rules/nuxt/hooks.md +16 -0
  210. package/assets/techne/rules/nuxt/patterns.md +46 -0
  211. package/assets/techne/rules/nuxt/security.md +19 -0
  212. package/assets/techne/rules/nuxt/testing.md +15 -0
  213. package/assets/techne/rules/perl/coding-style.md +33 -0
  214. package/assets/techne/rules/perl/hooks.md +22 -0
  215. package/assets/techne/rules/perl/patterns.md +43 -0
  216. package/assets/techne/rules/perl/security.md +39 -0
  217. package/assets/techne/rules/perl/testing.md +42 -0
  218. package/assets/techne/rules/php/coding-style.md +30 -0
  219. package/assets/techne/rules/php/hooks.md +24 -0
  220. package/assets/techne/rules/php/patterns.md +26 -0
  221. package/assets/techne/rules/php/security.md +27 -0
  222. package/assets/techne/rules/php/testing.md +28 -0
  223. package/assets/techne/rules/python/coding-style.md +38 -0
  224. package/assets/techne/rules/python/fastapi.md +57 -0
  225. package/assets/techne/rules/python/hooks.md +19 -0
  226. package/assets/techne/rules/python/patterns.md +37 -0
  227. package/assets/techne/rules/python/security.md +26 -0
  228. package/assets/techne/rules/python/testing.md +32 -0
  229. package/assets/techne/rules/react/coding-style.md +24 -0
  230. package/assets/techne/rules/react/hooks.md +62 -0
  231. package/assets/techne/rules/react/patterns.md +48 -0
  232. package/assets/techne/rules/react/security.md +45 -0
  233. package/assets/techne/rules/react/testing.md +42 -0
  234. package/assets/techne/rules/react-native/accessibility.md +14 -0
  235. package/assets/techne/rules/react-native/coding-style.md +16 -0
  236. package/assets/techne/rules/react-native/hooks.md +16 -0
  237. package/assets/techne/rules/react-native/patterns.md +18 -0
  238. package/assets/techne/rules/react-native/performance.md +14 -0
  239. package/assets/techne/rules/react-native/production-readiness.md +16 -0
  240. package/assets/techne/rules/react-native/security.md +16 -0
  241. package/assets/techne/rules/react-native/testing.md +14 -0
  242. package/assets/techne/rules/ruby/coding-style.md +40 -0
  243. package/assets/techne/rules/ruby/hooks.md +33 -0
  244. package/assets/techne/rules/ruby/patterns.md +33 -0
  245. package/assets/techne/rules/ruby/security.md +39 -0
  246. package/assets/techne/rules/ruby/testing.md +35 -0
  247. package/assets/techne/rules/rust/coding-style.md +41 -0
  248. package/assets/techne/rules/rust/hooks.md +16 -0
  249. package/assets/techne/rules/rust/patterns.md +42 -0
  250. package/assets/techne/rules/rust/security.md +33 -0
  251. package/assets/techne/rules/rust/testing.md +30 -0
  252. package/assets/techne/rules/swift/coding-style.md +30 -0
  253. package/assets/techne/rules/swift/hooks.md +20 -0
  254. package/assets/techne/rules/swift/patterns.md +30 -0
  255. package/assets/techne/rules/swift/security.md +22 -0
  256. package/assets/techne/rules/swift/testing.md +28 -0
  257. package/assets/techne/rules/typescript/coding-style.md +38 -0
  258. package/assets/techne/rules/typescript/hooks.md +14 -0
  259. package/assets/techne/rules/typescript/patterns.md +12 -0
  260. package/assets/techne/rules/typescript/security.md +14 -0
  261. package/assets/techne/rules/typescript/testing.md +12 -0
  262. package/assets/techne/rules/vue/coding-style.md +19 -0
  263. package/assets/techne/rules/vue/hooks.md +13 -0
  264. package/assets/techne/rules/vue/patterns.md +29 -0
  265. package/assets/techne/rules/vue/security.md +11 -0
  266. package/assets/techne/rules/vue/testing.md +11 -0
  267. package/assets/techne/rules/web/coding-style.md +25 -0
  268. package/assets/techne/rules/web/design-quality.md +21 -0
  269. package/assets/techne/rules/web/hooks.md +39 -0
  270. package/assets/techne/rules/web/patterns.md +23 -0
  271. package/assets/techne/rules/web/performance.md +25 -0
  272. package/assets/techne/rules/web/security.md +23 -0
  273. package/assets/techne/rules/web/testing.md +21 -0
  274. package/assets/techne/scripts/hooks/config-guard.js +50 -0
  275. package/assets/techne/scripts/hooks/edit-tracker.js +26 -0
  276. package/assets/techne/scripts/hooks/lib/shell.js +204 -0
  277. package/assets/techne/scripts/hooks/no-verify-guard.js +205 -0
  278. package/assets/techne/scripts/hooks/run.js +92 -0
  279. package/assets/techne/scripts/hooks/stop-checks.js +136 -0
  280. package/assets/techne/skills/angular/SKILL.md +34 -0
  281. package/assets/techne/skills/angular/reference/components-and-templates.md +63 -0
  282. package/assets/techne/skills/angular/reference/dependency-injection.md +44 -0
  283. package/assets/techne/skills/angular/reference/forms.md +97 -0
  284. package/assets/techne/skills/angular/reference/routing.md +50 -0
  285. package/assets/techne/skills/angular/reference/signals-and-state.md +59 -0
  286. package/assets/techne/skills/angular/reference/styling-motion-a11y.md +54 -0
  287. package/assets/techne/skills/angular/reference/testing.md +52 -0
  288. package/assets/techne/skills/angular/reference/tooling.md +31 -0
  289. package/assets/techne/skills/cpp/SKILL.md +27 -0
  290. package/assets/techne/skills/cpp/reference/coding-standards.md +160 -0
  291. package/assets/techne/skills/databases/SKILL.md +35 -0
  292. package/assets/techne/skills/databases/reference/clickhouse.md +102 -0
  293. package/assets/techne/skills/databases/reference/migrations.md +94 -0
  294. package/assets/techne/skills/databases/reference/mysql.md +101 -0
  295. package/assets/techne/skills/databases/reference/postgres.md +72 -0
  296. package/assets/techne/skills/databases/reference/prisma.md +105 -0
  297. package/assets/techne/skills/databases/reference/redis.md +108 -0
  298. package/assets/techne/skills/delivery/SKILL.md +35 -0
  299. package/assets/techne/skills/delivery/reference/deployment-patterns.md +58 -0
  300. package/assets/techne/skills/delivery/reference/docker-patterns.md +77 -0
  301. package/assets/techne/skills/delivery/reference/git-workflow.md +64 -0
  302. package/assets/techne/skills/delivery/reference/github-ops.md +67 -0
  303. package/assets/techne/skills/delivery/reference/jira-integration.md +53 -0
  304. package/assets/techne/skills/delivery/reference/kubernetes-patterns.md +67 -0
  305. package/assets/techne/skills/dotnet/SKILL.md +27 -0
  306. package/assets/techne/skills/dotnet/reference/dotnet-core.md +131 -0
  307. package/assets/techne/skills/flutter/SKILL.md +29 -0
  308. package/assets/techne/skills/flutter/reference/code-review.md +76 -0
  309. package/assets/techne/skills/flutter/reference/patterns.md +201 -0
  310. package/assets/techne/skills/go/SKILL.md +28 -0
  311. package/assets/techne/skills/go/reference/patterns.md +87 -0
  312. package/assets/techne/skills/go/reference/testing.md +142 -0
  313. package/assets/techne/skills/java/SKILL.md +29 -0
  314. package/assets/techne/skills/java/reference/java-standards.md +117 -0
  315. package/assets/techne/skills/java/reference/springboot.md +108 -0
  316. package/assets/techne/skills/kotlin/SKILL.md +35 -0
  317. package/assets/techne/skills/kotlin/reference/android-clean-architecture.md +115 -0
  318. package/assets/techne/skills/kotlin/reference/compose-multiplatform-patterns.md +113 -0
  319. package/assets/techne/skills/kotlin/reference/kotlin-coroutines-flows.md +93 -0
  320. package/assets/techne/skills/kotlin/reference/kotlin-patterns.md +74 -0
  321. package/assets/techne/skills/kotlin/reference/kotlin-testing.md +115 -0
  322. package/assets/techne/skills/ml/SKILL.md +34 -0
  323. package/assets/techne/skills/ml/reference/ai-regression-testing.md +99 -0
  324. package/assets/techne/skills/ml/reference/cost-aware-llm-pipeline.md +133 -0
  325. package/assets/techne/skills/ml/reference/eval-harness.md +94 -0
  326. package/assets/techne/skills/ml/reference/mle-workflow.md +177 -0
  327. package/assets/techne/skills/ml/reference/prompt-optimizer.md +107 -0
  328. package/assets/techne/skills/ml/reference/pytorch-patterns.md +164 -0
  329. package/assets/techne/skills/php/SKILL.md +27 -0
  330. package/assets/techne/skills/php/reference/laravel.md +142 -0
  331. package/assets/techne/skills/python/SKILL.md +33 -0
  332. package/assets/techne/skills/python/reference/django.md +104 -0
  333. package/assets/techne/skills/python/reference/fastapi.md +118 -0
  334. package/assets/techne/skills/python/reference/python-core.md +88 -0
  335. package/assets/techne/skills/python/reference/python-testing.md +105 -0
  336. package/assets/techne/skills/quality/SKILL.md +34 -0
  337. package/assets/techne/skills/quality/reference/benchmark.md +55 -0
  338. package/assets/techne/skills/quality/reference/browser-qa.md +60 -0
  339. package/assets/techne/skills/quality/reference/coding-standards.md +88 -0
  340. package/assets/techne/skills/quality/reference/e2e-testing.md +99 -0
  341. package/assets/techne/skills/quality/reference/tdd-workflow.md +89 -0
  342. package/assets/techne/skills/quality/reference/verification-loop.md +80 -0
  343. package/assets/techne/skills/react/SKILL.md +30 -0
  344. package/assets/techne/skills/react/reference/nextjs-turbopack.md +42 -0
  345. package/assets/techne/skills/react/reference/react-patterns.md +139 -0
  346. package/assets/techne/skills/react/reference/react-performance.md +101 -0
  347. package/assets/techne/skills/react/reference/react-testing.md +139 -0
  348. package/assets/techne/skills/react-native/SKILL.md +28 -0
  349. package/assets/techne/skills/react-native/reference/expo-patterns.md +196 -0
  350. package/assets/techne/skills/research/SKILL.md +35 -0
  351. package/assets/techne/skills/research/reference/architecture-decision-records.md +65 -0
  352. package/assets/techne/skills/research/reference/codebase-onboarding.md +44 -0
  353. package/assets/techne/skills/research/reference/deep-research.md +50 -0
  354. package/assets/techne/skills/research/reference/iterative-retrieval.md +62 -0
  355. package/assets/techne/skills/research/reference/product-lens.md +38 -0
  356. package/assets/techne/skills/research/reference/search-first.md +50 -0
  357. package/assets/techne/skills/rust/SKILL.md +28 -0
  358. package/assets/techne/skills/rust/reference/patterns.md +108 -0
  359. package/assets/techne/skills/rust/reference/testing.md +142 -0
  360. package/assets/techne/skills/services/SKILL.md +32 -0
  361. package/assets/techne/skills/services/reference/api-contracts.md +139 -0
  362. package/assets/techne/skills/services/reference/backend-layers.md +95 -0
  363. package/assets/techne/skills/services/reference/errors-and-resilience.md +146 -0
  364. package/assets/techne/skills/services/reference/hexagonal-boundaries.md +93 -0
  365. package/assets/techne/skills/services/reference/mcp-servers.md +50 -0
  366. package/assets/techne/skills/services/reference/nestjs.md +96 -0
  367. package/assets/techne/skills/swift/SKILL.md +29 -0
  368. package/assets/techne/skills/swift/reference/concurrency.md +83 -0
  369. package/assets/techne/skills/swift/reference/swiftui.md +139 -0
  370. package/assets/techne/skills/vue/SKILL.md +29 -0
  371. package/assets/techne/skills/vue/reference/nuxt4-patterns.md +90 -0
  372. package/assets/techne/skills/vue/reference/ui-to-vue.md +90 -0
  373. package/assets/techne/skills/vue/reference/vue-patterns.md +151 -0
  374. package/assets/techne/skills/web/SKILL.md +30 -0
  375. package/assets/techne/skills/web/reference/bun-runtime.md +55 -0
  376. package/assets/techne/skills/web/reference/frontend-patterns.md +54 -0
  377. package/assets/techne/skills/web/reference/seo.md +77 -0
  378. package/assets/techne/skills/web/reference/vite-patterns.md +96 -0
  379. package/bin/native.cjs +30 -0
  380. package/native/aarch64-apple-darwin/exonous +0 -0
  381. package/native/aarch64-unknown-linux-gnu/exonous +0 -0
  382. package/native/x86_64-apple-darwin/exonous +0 -0
  383. package/native/x86_64-pc-windows-msvc/exonous.exe +0 -0
  384. package/native/x86_64-unknown-linux-gnu/exonous +0 -0
  385. package/package.json +1 -6
@@ -0,0 +1,77 @@
1
+ > **Gather:** quality bar and ship constraints.
2
+
3
+ Refinement only—never a disguised redesign. Keep the current visual language, copy, behavior, and anything out of scope. When the concept is wrong, say so and route to redesign or `bolder` instead of swapping direction quietly.
4
+
5
+ Detector hits are hints; judge the rendered UI and real interaction paths yourself.
6
+
7
+ ## Anchor in the system
8
+
9
+
10
+ ```polish-protocol
11
+ Read DESIGN.md plus tokens, shared components, patterns, and neighboring flows. Without a formal system, follow stable project conventions.
12
+
13
+ Before fixing drift, label it:
14
+
15
+ - **missing token** — needs a reusable value in the system;
16
+ - **one-off** — should use an existing shared component or pattern;
17
+ - **IA mismatch** — flow or hierarchy diverges from peer areas;
18
+ - **local defect** — incomplete or inconsistent implementation.
19
+
20
+ Fix at the narrowest correct layer. Ask when a binding system rule is unclear.
21
+
22
+ ## Collect evidence
23
+
24
+ Exercise the feature at representative sizes: desktop and mobile on web; on native (`ios` / `android` / `adaptive`), shipped device classes on simulator, emulator, or hardware per platform build verification. Establish:
25
+
26
+ - functional completeness;
27
+ - target quality bar and time budget;
28
+ - known constraints or intentional gaps;
29
+ - states, content lengths, roles, and input modes users will hit.
30
+
31
+ When a prior critique exists, treat it as one input:
32
+
33
+ ```bash
34
+ <skill-dir>/scripts/ui-design critique-storage latest "<resolved target>" --json
35
+ ```
36
+
37
+ Exit 0 returns JSON with snapshot `body` and exact `snapshot_file`. Retain `snapshot_file` through the pass. Local files: helper compares current fingerprint to critique’s; unchanged staged/unstaged/untracked content stays current; any byte change, deletion, or non-file replacement closes that backlog while keeping trend history (exit 2). URL targets stay current until explicitly closed. When current, apply relevant P0/P1 items from `body` and cite the snapshot. Exit 2 means none exists or the target moved. Independent pass either way.
38
+
39
+ ## Triage order
40
+
41
+ 1. broken tasks, data loss, misleading state, blocked accessibility paths;
42
+ 2. missing loading, empty, error, success, disabled, permission states;
43
+ 3. flow, hierarchy, responsive, and design-system drift;
44
+ 4. visual and motion inconsistencies;
45
+ 5. code and asset cleanup.
46
+
47
+ Do not polish one corner while the rest of the path lags.
48
+
49
+ ## Whole-path checklist
50
+
51
+ **Flow and hierarchy:** match neighbor mental models, terminology, disclosure, routing, saves, optimistic/pessimistic patterns; make primary task and state obvious without flattening everything; connect arrival, transition, empty, and recovery paths.
52
+
53
+ **Layout and type:** honor grid and spacing; fix optical and math alignment; group related content tightly; keep same-role typography consistent; test measure, wrap, i18n expansion, zoom, font loading; every supported viewport—not just the current frame.
54
+
55
+ **Color, imagery, icons:** semantic tokens; stable color meanings; contrast in all states; coherent icon family and sizing; no image layout shift; correct aspects, responsive sources, meaningful alt text.
56
+
57
+ **Interaction:** full control states; keyboard focus and tab order; platform touch targets; coherent, interruptible motion—no animation for show; exercise long, missing, localized, offline, slow, and permission-limited content where applicable.
58
+
59
+ **Content and code:** consistent terminology and factual copy (ask before changing claims); remove debug noise and polish-only duplication; prefer shared components; promote reusable values to tokens—don’t abstract one-offs.
60
+
61
+ ## Close the pass
62
+
63
+ Re-walk with mouse, keyboard, and touch. Check layouts across breakpoints/device classes; key states; zoom, contrast, focus, screen readers; console errors, CLS, latency; DESIGN.md alignment and user scope.
64
+
65
+ Follow `ui-design context` and hooks; other QA as needed. Manual scan only when no automatic detector runs—do not add another detector pass. Document narrow intentional exceptions; clean scans ≠ visual sign-off.
66
+
67
+ Diff sources: drop accidental churn and temp artifacts. Ship when functionally complete and evenly finished.
68
+
69
+ When all Priority Issues from a read snapshot are cleared:
70
+
71
+ ```bash
72
+ <skill-dir>/scripts/ui-design critique-storage close "<resolved target>" "<snapshot_file from latest>"
73
+ ```
74
+
75
+ Closes only the processed snapshot. Do not close without a read snapshot, without retained `snapshot_file`, or with Priority Issues left open.
76
+
77
+ ```
@@ -0,0 +1,95 @@
1
+ Restraint demands precision. Lower visual intensity on loud, aggressive, or overstimulating UI without erasing personality or sliding into generic.
2
+
3
+ ---
4
+
5
+ ## Visitor mode
6
+
7
+ **Persuade + Experience:** quieter → restrained palette, more whitespace, typographic air. Less drama, same POV.
8
+
9
+ **Operate + Read:** quieter → less visual noise. Fewer accents, flatter cards, less color and motion. The tool fades into the task.
10
+
11
+ ---
12
+
13
+ ## Assess
14
+
15
+ Find what drives intensity:
16
+
17
+ 1. **Sources**
18
+ - saturated or overly bright color;
19
+ - extreme high-contrast pairings;
20
+ - too many bold, heavy elements competing;
21
+ - excess motion or dramatic animation;
22
+ - decorative clutter, patterns, ornaments;
23
+ - uniform large scale with weak hierarchy.
24
+
25
+ 2. **Context**
26
+ - purpose (marketing vs tool vs reading);
27
+ - audience (some contexts need energy);
28
+ - what already works;
29
+ - core message to preserve.
30
+
31
+ If unclear from the codebase, STOP and AskUserQuestion.
32
+
33
+ **CRITICAL:** Quieter ≠ boring. Refined and easier on the eyes—luxury, not laziness.
34
+
35
+ ## Plan
36
+
37
+ Strategy to reduce intensity while keeping impact:
38
+
39
+ - color: desaturate or shift to restrained tones?
40
+ - hierarchy: what stays bold (few), what recedes?
41
+ - simplification: what can go entirely?
42
+ - sophistication: quality through restraint?
43
+
44
+ Subtlety without intent becomes generic.
45
+
46
+ ## Refine
47
+
48
+ ### Color
49
+
50
+ - Saturation toward 70–85% vs full punch.
51
+ - Muted tones over bright primaries.
52
+ - Fewer hues, used deliberately.
53
+ - Neutrals carry weight; color as ~10% accent.
54
+ - High contrast only where it matters.
55
+ - Warm/cool tinted grays vs flat gray.
56
+ - On colored surfaces: darker shade of that hue or transparency—not gray-on-color.
57
+
58
+ ### Weight
59
+
60
+ - Lighten weights (900→600, 700→500); shrink sizes where hierarchy allows.
61
+ - Hierarchy via weight, size, space—not only color/bold.
62
+ - More whitespace; less density.
63
+ - Thinner, softer, or removed borders.
64
+
65
+ ### Simplification
66
+
67
+ - Drop purposeless gradients, shadows, patterns, textures.
68
+ - Moderate radius; simpler shapes.
69
+ - Flatter layering where possible.
70
+ - Reduce blur, glow, stacked shadows.
71
+
72
+ ### Motion
73
+
74
+ - Shorter travel (10–20px vs 40px); gentler easing.
75
+ - Keep functional motion; drop decorative loops.
76
+ - Gentle micro-feedback vs dramatic effects.
77
+ - ease-out-quart for understated motion; avoid bounce/elastic.
78
+ - Remove motion with no clear job.
79
+
80
+ ### Composition
81
+
82
+ - Smaller size jumps between levels.
83
+ - Grid-align strays.
84
+ - Even spacing rhythm vs wild swings.
85
+
86
+ **NEVER:** flat hierarchy; all-gray palette; zero personality; usability sacrificed; everything tiny and light.
87
+
88
+ ## Verify
89
+
90
+ - Tasks still easy?
91
+ - Still distinctive?
92
+ - Better for extended reading?
93
+ - POV survives the cuts?
94
+
95
+ Then `/ui-design polish`.
@@ -0,0 +1,37 @@
1
+ # Command guidance
2
+
3
+ ## Workflow questions
4
+
5
+ Answer without executing commands. The no-argument menu below is only for bare `/ui-design` invocations. Pull prerequisites from command references as needed. If the user also wants execution, follow that request.
6
+
7
+ ## No-argument routing: context-aware menu
8
+
9
+ Use when the user invokes `/ui-design` with no argument—they want “what should I do next?”
10
+
11
+ Setup already ran `ui-design context`.
12
+
13
+ - If output included `NO_PRODUCT_MD`, lead with `/ui-design init` (one line why) and still show the full menu below—do not silently run init.
14
+ - Otherwise run `<skill-dir>/scripts/ui-design signals` once, read JSON, and lead with **2–3 highest-value commands** (one-line reason each from signals), then the full Commands table from SKILL.md grouped by category. **Never auto-run; suggestions only.**
15
+
16
+ Reason over signals—no fixed score:
17
+
18
+ | Signal | Suggestion |
19
+ |--------|------------|
20
+ | `setup.hasDesign` false, `setup.hasCode` true | `document`—capture the visual system |
21
+ | `critique.latest` null | First critique on a real surface: `/ui-design critique <surface>` |
22
+ | Low `critique.latest.score` or non-zero `p0`/`p1` | `polish` (reads snapshot as backlog) |
23
+ | `git.changedFiles` on one surface | Scope `audit` or `polish` to those files by name |
24
+ | `devServer.running` true | `live` for in-browser iteration (web only) |
25
+ | `setup.platform` ios/android/adaptive | Do not lead with `live` or bundled HTML detector |
26
+
27
+ Otherwise group by intent (build / improve / iterate) for current surface and platform.
28
+
29
+ **Detector assist (web only):** When `scan.targets` is non-empty and platform is not native, run once:
30
+
31
+ ```bash
32
+ <skill-dir>/scripts/ui-design detect --json <targets...>
33
+ ```
34
+
35
+ `scan.via` explains the set (`git-changes`, `source-dir`, `html`, `root`). Fold hits into picks: quality/contrast → `audit` or `polish`; slop families → matching refine command (gradient text → `quieter`/`typeset`, flat gray → `colorize`, etc.). On error or huge trees, skip and suggest manual `audit`—never block the menu.
36
+
37
+ Keep the lede to 2–3 exact commands to type; full table stays fallback.
@@ -0,0 +1,43 @@
1
+ # Shape
2
+
3
+ Planning-only command: output a **confirmed brief**, zero implementation.
4
+
5
+ ## Discovery (no visuals yet)
6
+
7
+ Hold code and world selection. Prefer the structured question tool; otherwise ask once and pause.
8
+
9
+ | Cadence rule | Detail |
10
+ |--------------|--------|
11
+ | Batch size | 2–3 linked questions, then stop for answers |
12
+ | Rounds | Default 1; round 2 only if answers expose a gap |
13
+ | Style | Infer likely answers; invite correction—no surveys |
14
+
15
+ **Round A — outcome:** Pick the highest-leverage unknowns among purpose, audience mindset, success criteria, and claims only this product can make.
16
+
17
+ **Round B — material:** Only if still open: asset ranges, critical states (empty/error/permission), fidelity target, forbidden changes, hard constraints (platform, a11y, locale, perf).
18
+
19
+ Visual lanes and CSS numbers belong in the new-work playbook, not here.
20
+
21
+ ## Direction handoff
22
+
23
+ Greenfield, rebrand, or new surface identity: walk the new-work playbook through authority + concept selection, then **return** before writing contracts or code. Inside a locked world, run concept exploration only when layout or interaction is still undecided.
24
+
25
+ ## Brief skeleton
26
+
27
+ | Block | Content |
28
+ |-------|---------|
29
+ | Audience & mode | Who, context, visitor mode |
30
+ | Proof | Task, success signals, evidence |
31
+ | Direction | Thesis, focal moment, build implications |
32
+ | Fence | Scope, anti-goals, untouched areas |
33
+ | Data | Content ranges, state matrix |
34
+ | Layout intent | Hierarchy & topology (not properties) |
35
+ | Open items | Explicit decisions builders must not guess |
36
+
37
+ Short briefs get bullets; messy multi-screen asks get the full table. No transcript replay.
38
+
39
+ ## Exit
40
+
41
+ User confirms (or one revision pass) → **stop**. Shape never ships code or persists direction contracts.
42
+
43
+ Unattended: list assumptions inline in the brief, deliver, stop.
@@ -0,0 +1,45 @@
1
+ # Industrial brutalist UI
2
+
3
+ Use when the interface should feel like Swiss print manuals or tactical telemetry: rigid grids, extreme type scale, utilitarian color, simulated analog degradation.
4
+
5
+ ## Choose one archetype (do not mix)
6
+
7
+ ### Swiss industrial print (light)
8
+
9
+ Newsprint substrates (`#F4F4F0`, `#EAE8E3`), carbon ink text (`#050505`–`#111`), aviation red accent (`#E61919` / `#FF2A2A`) only. Visible grid lines, oversized numerals bleeding viewport edges, heavy neo-grotesk in uppercase blocks.
10
+
11
+ ### Tactical telemetry (dark)
12
+
13
+ CRT black (`#0A0A0A`, `#121212`), phosphor white text (`#EAEAEA`), same red accent. Optional terminal green (`#4AF626`) on **one** semantic element—not general body copy. Monospace dominance, ASCII framing, scanline/grain effects.
14
+
15
+ ## Typography
16
+
17
+ **Macro (structure):** Black/heavy sans at fluid scale `clamp(4rem, 10vw, 15rem)`; tracking −0.03em to −0.06em; line-height 0.85–0.95; uppercase. Candidates: Neue Haas Grotesk Black, Archivo Black, Monument Extended, heavy grotesk flex variants.
18
+
19
+ **Micro (data):** Mono 10–14px; tracking +0.05em to +0.1em; uppercase metadata, nav, coordinates. JetBrains Mono, IBM Plex Mono, Space Mono, VT323.
20
+
21
+ **Contrast serif (rare):** High-contrast serif splashes only with halftone/dither treatment—never clean vector luxury pairing by default.
22
+
23
+ ## Color discipline
24
+
25
+ No gradients, soft drops, or modern glass. One substrate mode per project—never light and dark sections alternating casually.
26
+
27
+ ## Layout
28
+
29
+ Blueprint grid: elements anchor to tracks, not float. Compartmentalize with 1–2px solid rules; full-width `<hr>` between operational blocks. Bimodal density: tight metadata clusters vs vast negative space around macro type. **Border-radius: 0** everywhere.
30
+
31
+ ## Symbology & components
32
+
33
+ Frame labels with ASCII brackets: `[ SYSTEM ]`, `< UNIT >`. Directional markers `>>>`, `///`. Registration/copyright glyphs as geometry. Crosshairs at intersections, barcode stripes, revision strings (`REV 2.6`, `UNIT / D-01`).
34
+
35
+ ## Texture (CSS/SVG)
36
+
37
+ - Halftone / 1-bit dither on imagery or serif blocks (`mix-blend-mode: multiply` + dot SVG)
38
+ - CRT scanlines: repeating horizontal gradient lines on dark mode
39
+ - Global low-opacity noise filter on root for unified grain
40
+
41
+ ## Engineering
42
+
43
+ - `display: grid; gap: 1px` with contrasting parent/child backgrounds for hairline dividers
44
+ - Semantic tags: `<data>`, `<samp>`, `<kbd>`, `<output>`, `<dl>`
45
+ - Macro sizes via `clamp()` only
@@ -0,0 +1,70 @@
1
+ # DESIGN.md format
2
+
3
+ Use when authoring or updating a project `DESIGN.md` so agents and the ui-design engine share one semantic design-system document (visual atmosphere, tokens, components, motion intent, bans).
4
+
5
+ ## Purpose
6
+
7
+ `DESIGN.md` is the single source of truth for how new screens should look and behave before code exists. Write in natural language **plus** exact values (hex, rem, px, spring constants). Name colors by role, not only hue.
8
+
9
+ ## Authoring workflow
10
+
11
+ 1. **Atmosphere** — Mood, density, variance, motion intent on 1–10 scales; default creative baseline often variance 8, motion 6, density 4 unless the product demands calm or cockpit modes
12
+ 2. **Palette** — Named swatches with hex and role; max one accent (<80% saturation); off-black not `#000`; ban default violet-neon slop; one gray temperature
13
+ 3. **Typography** — Display, body, mono stacks; scale via `clamp`; Inter discouraged for premium marketing; serif only with editorial justification; dashboards sans+mono; density >7 → mono numerals
14
+ 4. **Hero** — Inline image typography allowed at high variance; no overlap clutter; no scroll-hint chrome; asymmetric when variance >4; one primary CTA
15
+ 5. **Components** — Buttons (tactile active), cards (only if elevation matters), forms (label above, error below), nav, loaders (skeleton not spinner), empty/error patterns
16
+ 6. **Layout** — Grid-first, max-width ~1400px, `min-h-[100dvh]`, no three equal feature columns, no flex `%` hacks, clean spatial separation
17
+ 7. **Responsive** — Collapse to one column <768px; no horizontal overflow; 44px touch targets; test 375 / 768 / 1440
18
+ 8. **Motion (intent)** — Spring `stiffness: 100`, `damping: 20`; staggered mounts; perpetual micro-loops only where live UI warrants; transform/opacity only; grain on fixed layers
19
+ 9. **Anti-patterns** — Explicit NEVER list (emojis, generic fonts, pure black, neon glow, 3-col cards, placeholder names, hype copy, broken images, default component library skin, `h-screen`, spinners)
20
+
21
+ ## DESIGN.md format template
22
+
23
+ ```markdown
24
+ # Design System: [Project Title]
25
+
26
+ ## 1. Visual Theme & Atmosphere
27
+ (Evocative paragraph: density, variance, motion levels, emotional read.)
28
+
29
+ ## 2. Color Palette & Roles
30
+ - **Name** (#HEX) — functional role
31
+ (One accent max; banned hues noted.)
32
+
33
+ ## 3. Typography Rules
34
+ - **Display:** family, tracking, scale, weight hierarchy
35
+ - **Body:** family, leading, max measure, secondary color
36
+ - **Mono:** usage rules
37
+ - **Banned:** fonts/contexts
38
+
39
+ ## 4. Component Stylings
40
+ * Buttons, cards, inputs, navigation, loaders, empty/error — shape, color, shadow, interaction
41
+
42
+ ## 5. Layout Principles
43
+ (Grid, asymmetry rules, containment, hero/feature patterns.)
44
+
45
+ ## 6. Motion & Interaction
46
+ (Spring defaults, stagger, loops, performance isolation.)
47
+
48
+ ## 7. Anti-Patterns (Banned)
49
+ (Explicit list aligned with ui-design direction module.)
50
+ ```
51
+
52
+ Optional dial table at top when projects tune creativity/density/variance/motion explicitly.
53
+
54
+ ## Quality bar
55
+
56
+ - Descriptive names tied to function (“Charcoal Ink” not “dark gray”)
57
+ - Every swatch has hex (or rgba) and role
58
+ - Consistent terminology across sections
59
+ - Opinionated—neutral “any style” docs fail agents
60
+ - Anti-pattern section as long as rules section—bans prevent regression
61
+
62
+ ## Pitfalls
63
+
64
+ - Tailwind class names without human-readable translation
65
+ - Names without hex
66
+ - Vague atmosphere with no measurable tokens
67
+ - Omitting responsive and motion intent
68
+ - Safe generic aesthetics that contradict premium direction
69
+
70
+ Engine artifacts (`DESIGN.md`, `PRODUCT.md`, the engine state directory) use literal paths and names the ui-design CLI expects—do not rename those files when following this format.
@@ -0,0 +1,95 @@
1
+ # Art direction (marketing & editorial UI)
2
+
3
+ Use when building landing pages, portfolios, marketing sites, or editorial surfaces under `ui-design`; dashboards and dense product tools follow **ui-design Operate mode** instead of this module.
4
+
5
+ ## Read the brief first
6
+
7
+ Before code or dial tuning, infer intent from: page type, vibe words, references, audience, existing brand assets, and hard constraints (accessibility, regulated sectors, trust-first commerce). State a single-sentence **design read** naming page type, audience, mood, and whether you will lean on an official system or a custom aesthetic. If the brief truly forks (e.g. minimal vs experimental), ask **one** question; otherwise publish the read and proceed.
8
+
9
+ Reject LLM defaults: violet mesh heroes, centered dark gradients, three equal feature cards, glass on everything, infinite micro-loops on every tile, Inter + slate-900 as the whole identity.
10
+
11
+ ## Three tunable dials
12
+
13
+ Global variables—use these names only:
14
+
15
+ | Dial | Default | Meaning |
16
+ |------|---------|---------|
17
+ | `DESIGN_VARIANCE` | 8 | 1 symmetric grids → 10 chaotic asymmetry |
18
+ | `MOTION_INTENSITY` | 6 | 1 static → 10 cinematic scroll choreography |
19
+ | `VISUAL_DENSITY` | 4 | 1 gallery whitespace → 10 cockpit data packing |
20
+
21
+ Override from the design read (examples): calm product-marketing pages dial variance and motion down and density slightly up; experimental agency pages push variance and motion high while keeping density moderate; civic or compliance sites favor low motion and predictable grids; when refreshing an existing brand without a visual reboot, keep variance and density near what you audited and nudge motion up one step; full visual reboots bump variance and motion two steps while holding density steady.
22
+
23
+ ### Dial behavior (quick reference)
24
+
25
+ **Variance:** 1–3 symmetrical 12-col grids; 4–7 overlaps, mixed aspect ratios; 8–10 masonry, `2fr 1fr 1fr`, large empty zones. Above `md`, asymmetric layouts must collapse to single column (`w-full`, `px-4`, `py-8`) below 768px.
26
+
27
+ **Motion:** 1–3 hover/active only; 4–7 CSS transitions `cubic-bezier(0.16, 1, 0.3, 1)` on transform/opacity; 8–10 scroll-linked reveals via Motion, GSAP ScrollTrigger, or CSS scroll-driven animations—never `window` scroll listeners in React state.
28
+
29
+ **Density:** 1–3 huge section gaps (`py-32`–`py-48`); 4–7 standard marketing rhythm; 8–10 tight padding, dividers not cards, monospace for all numeric readouts.
30
+
31
+ ## Foundation choice
32
+
33
+ When the brief matches an official design system (Fluent, Carbon, Material Web, Polaris, Atlaskit, Primer, GOV.UK, USWDS, Radix Themes, shadcn with customization), install and use it—do not hand-clone its CSS. One system per project. For aesthetic-only briefs (bento, editorial, brutalist, glass, kinetic type), build with Tailwind + native CSS + Motion; label approximations honestly (e.g. web “glass” is not a platform-native material).
34
+
35
+ ## Stack defaults (when no system wins)
36
+
37
+ React/Next with RSC; interactivity in isolated `'use client'` leaves. Tailwind v4 unless the repo is v3-locked. Motion from `motion/react`; continuous pointer/scroll values via `useMotionValue` / `useTransform` / `useScroll`, not `useState` per frame. Verify `package.json` before any new dependency; print install commands when missing. Icons: Phosphor, HugeIcons, Radix, or Tabler—one family, fixed stroke width; no hand-drawn SVG icons. Fonts via `next/font` or self-hosted `@font-face`. Page shell: `max-w-[1400px]` or `max-w-7xl`; full viewport height uses `min-h-[100dvh]`, never `h-screen`. Structure with CSS Grid, not flex percentage hacks.
38
+
39
+ ## Typography
40
+
41
+ Display default: tight tracking, controlled scale (`text-4xl md:text-6xl` as a starting point—not a mandate to shout). Body: ~65ch, relaxed leading, muted secondary color. Discourage Inter as the default sans; prefer Geist, Outfit, Cabinet Grotesk, Satoshi unless the brief wants neutral/system UI. Serif is **not** the default “creative” move—use sans display unless the brand or editorial brief justifies serif; never default Fraunces/Instrument Serif; no random serif word inside a sans headline (use italic/bold of the same family). Dashboards and software chrome: sans + mono only. Italic display with descenders (`y g j p q`): minimum `leading-[1.1]` and bottom padding reserve.
42
+
43
+ ## Color
44
+
45
+ One accent, saturation under 80% unless brand dictates. Neutral bases (zinc/slate/stone); ban the generic “AI violet glow” default—purple is fine when the brand owns it. Lock one gray temperature per project. No pure `#000000`; use off-black. Premium-consumer briefs: rotate palette families—do not default to warm cream + brass + oxblood + espresso on every artisan brief.
46
+
47
+ ## Layout & hero
48
+
49
+ When `DESIGN_VARIANCE > 4`, avoid centered hero monoliths; prefer split, left-weighted, or asymmetric whitespace. Hero must fit first viewport: headline ≤2 lines desktop, subcopy ≤20 words and ≤4 lines, primary CTA visible without scroll; top padding cap ~`pt-24` desktop; max four hero text layers (optional eyebrow, headline, subtext, CTAs)—no logo walls, pricing teasers, or feature lists inside hero. Trust logos sit in the next section. Nav: one line at desktop, height ≤80px. Wide headline containers so H1 stays 2–3 lines, not six (`max-w-5xl`–`6xl`, sensible `clamp`). Section layout families: each family at most once per page; max two consecutive image/text zigzags; bento cell count equals content count (`grid-flow-dense`, no dead cells); eyebrows capped at one per three sections (count `uppercase tracking` micro-labels). No split-header default (big left title + tiny right paragraph). Page theme: one light/dark/auto for the whole scroll—no random inverted band mid-page.
50
+
51
+ ## AIDA & page rhythm (marketing flows)
52
+
53
+ Structure long pages as chapters with generous vertical padding (`py-32 md:py-48`): **Attention** (hero + nav), **Interest** (features/bento), **Desire** (scroll media, pinned galleries), **Action** (pricing/footer CTA). Wrap root in `overflow-x-hidden` when horizontal motion exists.
54
+
55
+ ## Variance without repetition
56
+
57
+ Before implementation, commit to a deterministic layout pick (seed from brief length or hash) so consecutive outputs do not clone: one hero archetype, one type stack, several component patterns, two motion paradigms. Banned cheap chrome: meta labels like “SECTION 01”, “QUESTION 05”, scroll-chevrons, duplicate contact CTAs on one page, wrapped primary button labels at desktop.
58
+
59
+ ## Motion rules
60
+
61
+ If `MOTION_INTENSITY > 4`, ship visible motion (hero enter, section reveals, CTA hover)—or lower the dial and stay static. Every animation needs a one-sentence purpose (hierarchy, story, feedback, state). Max one horizontal marquee per page. GSAP pin/scrub: `start: "top top"`, cleanup in `useEffect`. Honor `prefers-reduced-motion` for intensity >3. No mixing GSAP/Three with Motion in one component tree. Spring default when using Motion: `stiffness: 100`, `damping: 20`. Grain/noise only on fixed `pointer-events-none` overlays.
62
+
63
+ ## States & forms
64
+
65
+ Ship loading (layout-matched skeletons), empty, error, hover, active (`scale-[0.98]` or slight translate), and focus rings. Labels above inputs; errors below; WCAG AA contrast on buttons and forms. One primary label per intent sitewide (“contact”, “signup”, “portfolio”).
66
+
67
+ ## Assets
68
+
69
+ Landings are visual: prefer project image tools, then seeded placeholder photography (`picsum.photos/seed/{topic}/{w}/{h}`), never div-built fake dashboards. Logo walls use real SVG marks (e.g. simple-icons CDN) or invented monogram SVGs—not plain text faux logos; no category subtitles under logos. Minimal briefs still need real photography in key slots.
70
+
71
+ ## Content bans
72
+
73
+ No em-dash or en-dash as prose punctuation—hyphen or restructure sentences. No generic names, Acme-style brands, filler verbs (“elevate”, “seamless”, “unleash”), fake round stats, version stamps in hero, section-number eyebrows, locale/weather strips, scroll hints, pills on photos, decorative photo credits, v1.4.2 footers on marketing pages, or Jane-Doe avatars. Quotes ≤3 lines; clean attribution. Copy self-audit: fix broken or “performed humility” strings.
74
+
75
+ ## AI visual tells (summary)
76
+
77
+ Neon outer glows, gradient-filled giant headlines, custom cursors, three equal feature columns, hand-rolled decorative SVGs, broken stock URLs, default shadcn skin, decorative status dots, filled progress-bar comparisons, long spec tables with a hairline on every row—replace with grouped specs, cards, or disclosures.
78
+
79
+ ## Performance & a11y
80
+
81
+ Animate transform/opacity only. Dark mode designed up front with paired tokens. Target LCP <2.5s, INP <200ms, CLS <0.1. Document z-index layers; do not spam arbitrary high z-index. Cards only when elevation means hierarchy; tint shadows to background hue; one radius system per page.
82
+
83
+ ## Internal plan (before UI code)
84
+
85
+ Document briefly: chosen dials and why; AIDA sections present; hero width/line math; bento grid coverage; label/button contrast sweep; motion list with purpose; reduced-motion path. Then implement.
86
+
87
+ ## Pre-delivery checklist
88
+
89
+ - Design read stated; dials explicit; system or aesthetic named; redesign audited if brownfield
90
+ - Zero em-dashes; single page theme; locked accent and radius system
91
+ - Hero viewport, nav, eyebrow, zigzag, CTA, and form contrast rules pass
92
+ - Bento/images/logos/marquee/motion/GSAP rules pass; no scroll listeners in state
93
+ - Mobile collapse, `min-h-[100dvh]`, cleanup on effects, empty/load/error states
94
+ - Content and Section 9-style tells absent; dependencies verified; one icon family
95
+ - Dashboards/tools: stop—use Operate mode and official dense UI systems instead
@@ -0,0 +1,42 @@
1
+ # Full output enforcement
2
+
3
+ Use when a task requires complete deliverables—full files, every component, every section—with no truncation or placeholder gaps.
4
+
5
+ ## Baseline
6
+
7
+ Treat output as production-bound. Partial work is broken work. If the user asked for five components, ship five finished components. Do not shorten to save tokens.
8
+
9
+ ## Hard failures (never emit)
10
+
11
+ **Code blocks:** ellipsis comments, stub markers, deferred implementation notes, duplicated “copy the pattern above” notes, or literal `...` where statements belong
12
+
13
+ **Narrative:** prompts to request continuation, claims that detail was withheld to save space, hand-wavy references to “the same approach elsewhere”, or instructing the reader to finish the work
14
+
15
+ **Shape:** Outline-level artifacts when implementation was requested; showing only bookends while omitting the middle; a single specimen plus verbal recipe for repeated structures; narrating behavior instead of supplying source
16
+
17
+ ## Process
18
+
19
+ 1. **Scope** — Count deliverables (files, functions, answers). Lock the count.
20
+ 2. **Build** — Produce each item completely.
21
+ 3. **Cross-check** — Re-read the request; add anything missing before sending.
22
+
23
+ ## Long responses
24
+
25
+ When nearing the token ceiling:
26
+
27
+ - Do not compress remaining parts into summaries
28
+ - Do not jump to a premature conclusion
29
+ - Stop at a clean boundary (end of function, file, or section)
30
+ - End with:
31
+
32
+ ```
33
+ [PAUSED — X of Y complete. Send "continue" to resume from: next section name]
34
+ ```
35
+
36
+ On “continue”, resume exactly there—no recap, no duplicate content.
37
+
38
+ ## Final verify
39
+
40
+ - No omission shortcuts from the hard-failure list
41
+ - Every requested item present and runnable where code was asked
42
+ - No space-saving shortcuts
@@ -0,0 +1,64 @@
1
+ # Utilitarian minimal UI
2
+
3
+ Use when the product should read like a calm document workspace: warm monochrome, typographic hierarchy, flat bento, muted pastels—no spectacle gradients or heavy elevation.
4
+
5
+ ## Banned defaults
6
+
7
+ - Inter, Roboto, Open Sans as primary voice
8
+ - Default Lucide/Feather/Heroicons as the only icon language
9
+ - Tailwind `shadow-md` / `shadow-lg` without extreme diffusion (<0.05 opacity)
10
+ - Large saturated hero backgrounds (bright blue/green/red fields)
11
+ - Gradients, neon, heavy glass (except subtle nav blur)
12
+ - `rounded-full` on large cards or primary buttons
13
+ - Emojis in UI copy or markup
14
+ - Placeholder names (John Doe, Acme) and hype verbs (“elevate”, “seamless”, “delve”)
15
+
16
+ ## Typography
17
+
18
+ Contrast drives the UI:
19
+
20
+ - **UI sans:** SF Pro Display, Geist Sans, Helvetica Neue, Switzer—geometric, calm
21
+ - **Editorial serif:** Lyon Text, Newsreader, Playfair, Instrument Serif—for hero/quotes only; tight tracking (`-0.02em` to `-0.04em`), line-height ~1.1
22
+ - **Mono:** Geist Mono, SF Mono, JetBrains—for code and meta
23
+ - Body never pure black; use `#111` / `#2F3437`, leading ~1.6; secondary `#787774`
24
+
25
+ ## Palette
26
+
27
+ Scarce color; semantic pastels only:
28
+
29
+ | Role | Values |
30
+ |------|--------|
31
+ | Canvas | `#FFFFFF`, `#F7F6F3`, `#FBFBFA` |
32
+ | Surface | `#FFFFFF`, `#F9F9F8` |
33
+ | Border | `#EAEAEA`, `rgba(0,0,0,0.06)` |
34
+ | Pastel tags | Red `#FDEBEC` / `#9F2F2D`; Blue `#E1F3FE` / `#1F6C9F`; Green `#EDF3EC` / `#346538`; Yellow `#FBF3DB` / `#956400` |
35
+
36
+ ## Components
37
+
38
+ - **Bento:** Asymmetric grid; cards `1px solid #EAEAEA`; radius 8–12px; padding 24–40px
39
+ - **Primary button:** `#111` fill, white text, radius 4–6px, no shadow; hover `#333` or `scale(0.98)`
40
+ - **Tags:** Small uppercase pills with pastel fills
41
+ - **FAQ:** No boxes—`border-bottom` separators; `+` / `−` toggles
42
+ - **Shortcuts:** `<kbd>` with 1px border, `#F7F6F3` fill, mono
43
+ - **App chrome mock:** White title bar with three light gray window dots
44
+
45
+ ## Imagery
46
+
47
+ Phosphor Bold/Fill or Radix icons—consistent stroke. Illustrations: monochrome line art + one pastel geometric accent. Photos desaturated, warm; subtle grain overlay (~4%). Placeholders: `picsum.photos/seed/{context}/1200/800`. Section backgrounds: ultra-low opacity imagery, warm radial spots (~3%), or faint line patterns—never empty flat voids.
48
+
49
+ ## Motion (quiet)
50
+
51
+ - Enter: `translateY(12px)` + opacity over 600ms, `cubic-bezier(0.16, 1, 0.3, 1)` via `IntersectionObserver`
52
+ - Card hover: shadow `0 2px 8px rgba(0,0,0,0.04)` over 200ms
53
+ - Lists: stagger `calc(var(--index) * 80ms)`
54
+ - Optional fixed-layer ambient gradient drift 20s+, opacity 0.02–0.04
55
+ - Transform/opacity only; sparing `will-change`
56
+
57
+ ## Build order
58
+
59
+ 1. Macro whitespace (`py-24`–`py-32`)
60
+ 2. Content width `max-w-4xl`–`5xl`
61
+ 3. Type + monochrome tokens
62
+ 4. Uniform 1px borders
63
+ 5. Scroll entry on major blocks
64
+ 6. Depth via imagery/texture, not decoration noise
@@ -0,0 +1,65 @@
1
+ # Premium agency-grade UI
2
+
3
+ Use when the brief asks for high-end consumer SaaS, luxury marketing, or award-tier spatial rhythm with haptic depth and choreographed motion.
4
+
5
+ ## Mandate
6
+
7
+ Ship interfaces that feel machined and intentional—not template-plus-font swaps. Vary layout archetype and texture profile per project while staying in a refined “product-marketing elite” language (deep blacks, diffused light, editorial type, spring-based motion).
8
+
9
+ ## Hard anti-patterns
10
+
11
+ Instant fail if present by default:
12
+
13
+ - System sans defaults: Inter, Roboto, Arial, Open Sans, Helvetica as the hero voice
14
+ - Heavy generic icon sets with chunky strokes; prefer light precise strokes (Phosphor Light, Remix Line style)
15
+ - Flat gray 1px borders and harsh `shadow-md`-style drops
16
+ - Edge-glued full-width nav with no breathing room; symmetric three-column Bootstrap grids without whitespace tension
17
+ - `linear` / plain `ease-in-out` as the only motion language
18
+
19
+ ## Variance engine (pick once per page)
20
+
21
+ **Texture / vibe (one):**
22
+
23
+ 1. **Deep glass tech** — near-OLED base (`#050505`), subtle radial mesh orbs, frosted panels with white/10 hairlines, wide grotesk display type
24
+ 2. **Editorial luxury** — warm paper (`#FDFBF7`), muted sage or espresso, variable serif headlines, film grain at ~3% opacity
25
+ 3. **Soft structural** — silver or white field, bold grotesk, floating modules with ultra-diffuse ambient shadow
26
+
27
+ **Layout (one):**
28
+
29
+ 1. **Asymmetric bento** — mixed `col-span` / `row-span`; mobile → single column, spans reset
30
+ 2. **Z-axis cascade** — stacked cards with slight rotation/overlap; mobile → no overlap, vertical stack
31
+ 3. **Editorial split** — half-width type, half interactive gallery or pill strip; mobile → type block then content
32
+
33
+ Universal mobile: below 768px use `w-full`, `px-4`, `py-8`; full height via `min-h-[100dvh]`.
34
+
35
+ ## Component craft
36
+
37
+ **Double-bezel nesting:** Outer shell (muted fill, hairline ring, padding `p-1.5`–`p-2`, large radius e.g. `rounded-[2rem]`). Inner core (distinct fill, inset highlight, inner radius `calc(outer − padding)`).
38
+
39
+ **Primary CTAs:** Full pill buttons; trailing arrow lives inside its own nested circle flush to the inner edge, not floating beside label.
40
+
41
+ **Spatial rhythm:** Section padding at least `py-24`, often `py-32`–`py-40`. Optional microscopic eyebrow pill before major headings (`text-[10px] uppercase tracking-[0.2em]`).
42
+
43
+ ## Motion choreography
44
+
45
+ Custom easing e.g. `cubic-bezier(0.32, 0.72, 0, 1)` over 700ms+. Floating nav pill detached from top (`mt-6`, `rounded-full`, `w-max`). Hamburger morphs to X with rotated lines, not vanish. Menu overlay: heavy blur + staggered link rise (`translate-y-12` → `0`). Buttons: slight press on active; inner icon circle shifts diagonally on group hover. Scroll entry: fade-up from blur (`translate-y-16 blur-md opacity-0` → clear) over 800ms+; use `IntersectionObserver` or Motion `whileInView`, not raw scroll listeners.
46
+
47
+ ## Performance
48
+
49
+ Transform and opacity only for animation. `backdrop-blur` on fixed/sticky layers only—not scrolling bodies. Noise on fixed, non-interactive overlay. Z-index reserved for nav, modal, overlay, tooltip tiers.
50
+
51
+ ## Execution sequence
52
+
53
+ 1. Select vibe + layout archetypes silently
54
+ 2. Scaffold background texture, macro spacing, display scale
55
+ 3. Build major surfaces with double-bezel and squircle radii (~`2rem`)
56
+ 4. Inject easing, nav reveal, button-in-button physics
57
+ 5. Ship complete implementation—no skeleton placeholders
58
+
59
+ ## Pre-output checks
60
+
61
+ - Banned patterns absent; archetypes applied deliberately
62
+ - Major cards use nested shell/core; CTAs use nested icon treatment where arrows exist
63
+ - Section padding ≥ `py-24`; custom beziers everywhere
64
+ - Scroll entries present; mobile collapse clean
65
+ - Blur scope correct; overall reads bespoke agency, not theme demo