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,63 @@
1
+ > **Prerequisite:** know the product’s allowed emotional range.
2
+
3
+ Earned personality at meaningful beats—not generic whimsy. Character shows up in useful interactions, humane copy, and considered details.
4
+
5
+ ---
6
+
7
+ ## Visitor mode
8
+
9
+ - **Persuade + Experience:** voice, layout, motion, discovery may carry character if the artifact stays central.
10
+ - **Operate + Read:** invest charm in first use, completion, recovery, mastery; elsewhere optimize reliability.
11
+
12
+ ## Spot the beat
13
+
14
+ Review target, DESIGN.md, voice, repeat frequency, emotional stakes:
15
+
16
+ - effort deserving acknowledgment;
17
+ - waits that can inform;
18
+ - empty/first-use moments that orient;
19
+ - errors needing empathy;
20
+ - interactions whose feedback could feel on-brand;
21
+ - capabilities worth discovering.
22
+
23
+ Skip celebrations for routine clicks. Ask when emotional range or stakes are unknown.
24
+
25
+ ## One-line thesis
26
+
27
+ State what the user should feel and why it fits this product. Pick the smallest delivery:
28
+
29
+ - distinctive feedback on meaningful action;
30
+ - clarifying copy with voice;
31
+ - motion/material with recognizable behavior;
32
+ - illustration, sound, haptic, or environmental detail rooted in the world;
33
+ - discovery that exposes real utility.
34
+
35
+ Derive from mechanism and world—not a template library.
36
+
37
+ ## Moment-by-moment
38
+
39
+ - **Success:** scale to effort; big wins may expand; routine saves stay quiet and sure.
40
+ - **Waiting:** honest progress or context—never fake latency for show.
41
+ - **Empty/first use:** clarify next step before ornament.
42
+ - **Errors:** problem + path forward first; warmth OK; no jokes on money, privacy, loss, or blocked work.
43
+ - **Repeat use:** still satisfying at high frequency; variation only if predictable.
44
+ - **Discovery:** curiosity rewarded; required paths stay obvious.
45
+
46
+ Use product vocabulary—generic whimsy loses to clear neutral copy.
47
+
48
+ ## Guardrails
49
+
50
+ Must not: block primary tasks; break platform or a11y norms; invent facts; play audio without consent; force unskippable loops; add heavy deps for a small beat.
51
+
52
+ Authored motion → [animate.md](animate.md). Respect SR, keyboard, touch, i18n, culture. Stop decorative loops offscreen. Match intensity to frequency and stakes.
53
+
54
+ ## Verify
55
+
56
+ - Another product couldn’t reuse unchanged.
57
+ - Helps comprehension, confidence, motivation, or recovery.
58
+ - Still fast and obvious without flourish.
59
+ - Repetition stays pleasant.
60
+ - Muted, keyboard, touch, i18n paths OK.
61
+ - Feels like the chosen world.
62
+
63
+ Then `/ui-design polish`.
@@ -0,0 +1,98 @@
1
+ Remove what does not earn its place: redundant UI, repeated information, decorative noise, cosmetic complexity.
2
+
3
+ ---
4
+
5
+ ## Assess
6
+
7
+ What makes it feel cluttered?
8
+
9
+ 1. **Sources**
10
+ - competing controls, duplicate info, visual clutter;
11
+ - gratuitous color/font/size variation;
12
+ - everything visible—no progressive disclosure;
13
+ - borders, shadows, backgrounds without job;
14
+ - unclear priority;
15
+ - option overload, too many paths.
16
+
17
+ 2. **Essence**
18
+ - single primary user goal;
19
+ - necessary vs nice-to-have;
20
+ - hide, remove, or merge candidates;
21
+ - the 20% that delivers 80%.
22
+
23
+ If unclear, STOP and AskUserQuestion.
24
+
25
+ **CRITICAL:** Simplicity removes obstacles to goals—not features by default. Every element must justify itself.
26
+
27
+ ## Plan
28
+
29
+ - ONE outcome this surface must achieve;
30
+ - minimal elements to get there;
31
+ - what hides until needed;
32
+ - what merges or combines.
33
+
34
+ Simplification means saying no to good ideas for great execution.
35
+
36
+ ## Simplify
37
+
38
+ ### Information architecture
39
+
40
+ - Cut secondary actions, optional noise, repetition.
41
+ - Progressive disclosure: accordions, modals, steps.
42
+ - Merge similar actions; group related content.
43
+ - ONE primary action; few secondaries; rest tertiary or hidden.
44
+ - Say it once—no duplicate copy elsewhere.
45
+
46
+ ### Visual
47
+
48
+ - 1–2 colors + neutrals, not a rainbow.
49
+ - One family; 3–4 sizes; 2–3 weights max.
50
+ - Drop decorative borders/shadows/backgrounds.
51
+ - Flatten nesting; no cards inside cards.
52
+ - Prefer spacing over card chrome.
53
+ - One spacing scale—no arbitrary gaps.
54
+
55
+ ### Layout
56
+
57
+ - Simple vertical flow over complex grids when possible.
58
+ - Inline or hide sidebar content.
59
+ - Use width generously.
60
+ - Consistent alignment (left or center).
61
+ - Whitespace over packing.
62
+
63
+ ### Interaction
64
+
65
+ - Fewer choices; clearer default path.
66
+ - Smart defaults; ask only when needed.
67
+ - Inline edit vs modal where viable.
68
+ - Remove a step if possible.
69
+ - ONE obvious next action.
70
+
71
+ ### Content
72
+
73
+ - Halve copy twice where possible.
74
+ - Active voice.
75
+ - Plain language.
76
+ - Scannable structure.
77
+ - Essential facts only—no fluff, hedging, redundant headers.
78
+
79
+ ### Code
80
+
81
+ - Dead CSS, unused components, orphans.
82
+ - Shallower component trees.
83
+ - Consolidated styles; consistent utilities.
84
+ - Fewer variants—3 often beat 12.
85
+
86
+ **NEVER:** strip needed functionality; hurt a11y; mystery minimalism; hide decision-critical info; erase all hierarchy; oversimplify genuinely complex domains.
87
+
88
+ ## Verify
89
+
90
+ - Faster tasks?
91
+ - Lower cognitive load?
92
+ - Necessary features still reachable?
93
+ - Clear priority?
94
+ - Performance improved?
95
+
96
+ Document removed features: why, alternate access, feedback to watch.
97
+
98
+ Then `/ui-design polish`.
@@ -0,0 +1,49 @@
1
+ # Doctor
2
+
3
+ Report and repair drift between project **ui-design artifacts** and what the installed engine reads: `PRODUCT.md`, `DESIGN.md`, `.impeccable/design.json`, `.impeccable/config.json`, surface briefs, design hook.
4
+
5
+ Maintenance only—no redesign, no files outside the report, no other commands as side effects.
6
+
7
+ ## Drift kinds
8
+
9
+ - **Tool version** — `UPDATE_AVAILABLE` from context; package maintainers own updates—not doctor.
10
+ - **Schema drift** — retired fields/locations; doctor `--fix` handles most.
11
+ - **Truth drift** — code moved on; `document` / `init` own updates; doctor surfaces gaps.
12
+
13
+ ## Step 1: Run
14
+
15
+ ```bash
16
+ <skill-dir>/scripts/ui-design doctor --json
17
+ ```
18
+
19
+ `--target <path>` in monorepos when user named a workspace/route.
20
+
21
+ Output: `findings[]` (`id`, `artifact`, `path`, `severity`, `summary`, `fix`); optional `workspaces`. `ruleRegistryAvailable: false` → say ignored-rule validation was skipped.
22
+
23
+ Empty findings → one-line OK and stop.
24
+
25
+ ## Step 2: Severities
26
+
27
+ - **`auto`** — run `doctor --fix` once without asking; report moves in one line
28
+ - **`mention`** — tell user; no decision now
29
+ - **`route`** — name command + gap; run only if user asks this turn
30
+
31
+ ## Step 3: Deprecated fields
32
+
33
+ Deprecated sections (e.g. retired `## Register`) are **absent for decisions**—offer deletion.
34
+
35
+ ## Step 4: Truth drift restraint
36
+
37
+ `design-md-drift` = commit count since DESIGN.md edit—not proof of wrong doc. Report number; if user wants truth, compare tokens/components manually.
38
+
39
+ `workspace-context-inherited` — behavior by design; multi-app fit is a user question.
40
+
41
+ ## Monorepo notes
42
+
43
+ - **workspace-platform-native-evidence** — native files + inherited web `PRODUCT.md` → child `PRODUCT.md` with correct platform
44
+ - **config-project-roots-match-nothing** — report globs; ask intended roots
45
+ - **config-invalid-build-path** / **config-build-path-unset** — `buildPath` `comp`|`code` in engine state config; unset offer only when image generation exists
46
+
47
+ ## Boot check opt-out
48
+
49
+ `"stalenessCheck": false` in `.impeccable/config.json` or `IMPECCABLE_NO_STALENESS_CHECK=1` for one session. Doctor still works when boot check off.
@@ -0,0 +1,273 @@
1
+ # Document
2
+
3
+ Produce root **`DESIGN.md`**: machine-readable tokens plus human guidance so new UI stays on-brand.
4
+
5
+ **Format:** optional YAML frontmatter (normative tokens) + up to eight markdown sections in fixed order. Prose explains usage; **frontmatter wins** on conflicts.
6
+
7
+ ## Frontmatter schema
8
+
9
+ ```yaml
10
+ ---
11
+ name: <project title>
12
+ description: <one-line tagline>
13
+ colors:
14
+ primary: "#b8422e"
15
+ neutral-bg: "#faf7f2"
16
+ typography:
17
+ display:
18
+ fontFamily: "Cormorant Garamond, Georgia, serif"
19
+ fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
20
+ fontWeight: 300
21
+ lineHeight: 1
22
+ rounded:
23
+ sm: "4px"
24
+ spacing:
25
+ md: "16px"
26
+ components:
27
+ button-primary:
28
+ backgroundColor: "{colors.primary}"
29
+ textColor: "{colors.neutral-bg}"
30
+ rounded: "{rounded.sm}"
31
+ padding: "16px 48px"
32
+ ---
33
+ ```
34
+
35
+ **Rules:**
36
+
37
+ - Token refs: `{colors.primary}`, `{rounded.md}` — components may reference primitives; primitives never reference each other.
38
+ - Colors: any valid CSS string; preserve incumbent `oklch()` / `hsl()` when normative.
39
+ - Component entries: max eight props — `backgroundColor`, `textColor`, `typography`, `rounded`, `padding`, `size`, `height`, `width`. Shadows, motion, focus rings → sidecar.
40
+ - Scale names follow the project (`oxblood-deep`, not forced Material names).
41
+ - Variants as sibling keys: `button-primary-hover`, etc.
42
+
43
+ ## Body sections (exact headings, this order)
44
+
45
+ 1. `## Overview` — north star metaphor, philosophy, key characteristics
46
+ 2. `## Colors` — roles (primary/secondary/tertiary/neutral), named rules
47
+ 3. `## Typography` — stacks, hierarchy, named rules
48
+ 4. `## Layout` — grid, containers, rhythm, responsive behavior
49
+ 5. `## Elevation & Depth` — shadows or tonal layering
50
+ 6. `## Shapes` — radius, borders, silhouettes
51
+ 7. `## Components` — per-component behavior and states
52
+ 8. `## Do's and Don'ts` — durable guardrails
53
+
54
+ Omit empty sections; never rename headers tooling parses.
55
+
56
+ ## When to run
57
+
58
+ - Coherent incumbent system, no `DESIGN.md`
59
+ - First build of a new world needs carbonizing
60
+ - Stale `DESIGN.md` vs code
61
+ - Pre-redesign snapshot
62
+
63
+ Existing file → show user; AskUserQuestion: refresh, overwrite, or merge.
64
+
65
+ ## Paths
66
+
67
+ | Mode | When |
68
+ |------|------|
69
+ | **Scan** (default) | Tokens/components/rendered UI exist |
70
+ | **Seed** | Pre-code; needs `PRODUCT.md` + new-work workshop |
71
+
72
+ `/ui-design document --seed` runs workshop—it does **not** replace coherent code; identity replacement goes through new-work.
73
+
74
+ ## Scan mode
75
+
76
+ ### Step 1 · Discover assets (priority order)
77
+
78
+ 1. **CSS variables** — grep `--color-`, `--font-`, `--spacing-`, `--radius-`, `--shadow-`, `--ease-`, `--duration-` in stylesheets; record name, value, defining file.
79
+ 2. **Tailwind** — `tailwind.config.*` → `theme.extend` colors, fonts, spacing, radii, shadows.
80
+ 3. **CSS-in-JS themes** — `theme.ts`, `tokens.ts`, etc.
81
+ 4. **Token JSON** — Style Dictionary / W3C community formats.
82
+ 5. **Component library** — button, card, input, nav, dialog variants.
83
+ 6. **Global CSS** — base type and color assignments.
84
+ 7. **Live sample** (optional) — computed styles on body, headings, links, buttons, cards.
85
+
86
+ ### Step 2 · Structured draft
87
+
88
+ - **Colors:** primary/secondary/tertiary/neutral roles; omit empty roles.
89
+ - **Typography:** display/headline/title/body/label mapping + scale ratio.
90
+ - **Elevation:** shadow vocabulary or explicit flat/tonal system.
91
+ - **Components:** shape, color, hover/focus, padding per common primitive.
92
+ - **Layout / shapes:** grid, breakpoints, rhythm, radius language.
93
+
94
+ ### Step 2b · Stage frontmatter
95
+
96
+ One slug per color; typography objects with real props only; component variants using `{token}` refs; overflow props → sidecar.
97
+
98
+ ### Step 3 · Qualitative rounds
99
+
100
+ Two rounds, ≤3 questions each (wait between): Creative North Star metaphor; overview voice; descriptive color names; elevation philosophy; component feel. Pull from `PRODUCT.md` only binding brand constraints.
101
+
102
+ ### Step 4 · Write DESIGN.md
103
+
104
+ Frontmatter + canonical sections. Use **Named Rules**: `**The [Name] Rule.**` one-line doctrine. Lead with descriptive language; put exact values in parentheses.
105
+
106
+ ### Step 4b · Sidecar `.impeccable/design.json`
107
+
108
+ Extensions only — not a duplicate of frontmatter primitives.
109
+
110
+ ```json
111
+ {
112
+ "schemaVersion": 2,
113
+ "generatedAt": "ISO-8601",
114
+ "title": "Design System: [Project Title]",
115
+ "extensions": {
116
+ "colorMeta": {
117
+ "primary": {
118
+ "role": "primary",
119
+ "displayName": "Editorial Magenta",
120
+ "canonical": "oklch(60% 0.25 350)",
121
+ "tonalRamp": ["...", "..."]
122
+ }
123
+ },
124
+ "typographyMeta": {
125
+ "display": { "displayName": "Display", "purpose": "Hero headlines only." }
126
+ },
127
+ "shadows": [
128
+ { "name": "ambient-low", "value": "0 4px 24px rgba(0,0,0,0.12)", "purpose": "Hover glow under accents." }
129
+ ],
130
+ "motion": [
131
+ { "name": "ease-standard", "value": "cubic-bezier(0.4, 0, 0.2, 1)", "purpose": "Default transition easing." }
132
+ ],
133
+ "breakpoints": [
134
+ { "name": "sm", "value": "640px" }
135
+ ]
136
+ },
137
+ "components": [
138
+ {
139
+ "name": "Primary Button",
140
+ "kind": "button",
141
+ "refersTo": "button-primary",
142
+ "description": "One-line when-to-use.",
143
+ "html": "<button class=\"ds-btn-primary\">SAVE</button>",
144
+ "css": ".ds-btn-primary { ... expanded literal CSS ... }"
145
+ }
146
+ ],
147
+ "narrative": {
148
+ "northStar": "...",
149
+ "overview": "...",
150
+ "keyCharacteristics": ["..."],
151
+ "rules": [{ "name": "The One Voice Rule", "body": "...", "section": "colors" }],
152
+ "dos": ["Do ..."],
153
+ "donts": ["Don't ..."]
154
+ }
155
+ }
156
+ ```
157
+
158
+ **schemaVersion 2:** primitives live in YAML frontmatter; sidecar holds ramps, shadows, motion, breakpoints, full HTML/CSS snippets, narrative mirror.
159
+
160
+ **Component snippet rules:** expand Tailwind to literal CSS; use `var(--token)` when tokens live on `:root`; inline SVG icons; include `:hover` and `:focus-visible`; prefix classes `ds-`; skip global resets.
161
+
162
+ Include **5–10** representative components; synthesize primitives on day-zero if needed. Tonal ramps ~8 steps OKLCH unless project defines a scale. Map narrative fields from DESIGN.md without rewording (panel copy).
163
+
164
+ Regenerate sidecar whenever DESIGN.md regenerates; refresh sidecar alone when user asks—keep DESIGN.md untouched.
165
+
166
+ ### Step 5 · Confirm
167
+
168
+ Show DESIGN.md; note sidecar for live panel; offer section revisions.
169
+
170
+ ## Seed mode
171
+
172
+ 1. Missing `PRODUCT.md` → [init.md](init.md). Else [new-work.md](new-work.md) through world workshop + **Commit the world** for named first surface—stop at seed + surface brief.
173
+ 2. Write seed with marker:
174
+
175
+ ```markdown
176
+ <!-- SEED: established before implementation; re-run /ui-design document after code exists. -->
177
+ ```
178
+
179
+ Minimal frontmatter (`name`, `description` only). Sections carry thesis; placeholders `[to be resolved during implementation]` for unknown tokens. **Components** omitted. No sidecar until scan.
180
+
181
+ 3. Confirm seed status; user re-runs document after implementation.
182
+
183
+ ## Section-by-section scan guidance
184
+
185
+ | Section | Capture |
186
+ |---------|---------|
187
+ | **Overview** | North star metaphor, 2–3 paragraphs on personality/density, **Key Characteristics** bullets, confirmed anti-references only |
188
+ | **Colors** | Role groups, descriptive names, where/why each swatch appears, optional **Named Rules** (≤10% accent doctrine, etc.) |
189
+ | **Typography** | Display/body/label stacks, hierarchy ladder with weights/sizes/line-height, measure guidance (e.g. 65–75ch body) |
190
+ | **Layout** | Grid model, max widths, breakpoint behavior, vertical rhythm—observed values in parentheses |
191
+ | **Elevation & Depth** | Shadow tokens or explicit flat/tonal strategy; shadow vocabulary list if applicable |
192
+ | **Shapes** | Radius language, borders, clipping habits, recurring silhouettes |
193
+ | **Components** | Buttons, inputs, nav, chips, cards—character line plus states (hover/focus/error) |
194
+ | **Do's and Don'ts** | Lead with **Do** / **Don't**; ground in incumbent code, not one-off page choices |
195
+
196
+ ### Overview — writing template
197
+
198
+ Open with a metaphor that explains *why* the UI feels the way it does (studio bench, editorial desk, instrument panel). Follow with density stance (airy vs packed), motion temperament, and trust posture. **Key Characteristics** = 4–7 bullets a new contributor could verify in code. Anti-references only when the user or `PRODUCT.md` named them—never invent rival brands.
199
+
200
+ ### Colors — writing template
201
+
202
+ Group swatches by **role**, not file order: primary action, secondary/support, neutrals (bg/surface/border), semantic (success/warn/danger). Give each swatch a **display name** in prose; park exact values in frontmatter or parentheses. Named Rules encode doctrine (`**The Restraint Rule.**` one sentence). Document dark-mode pairs when observed.
203
+
204
+ ### Typography — writing template
205
+
206
+ Map roles: display, headline, title, body, label, mono (if any). For each: family stack, weight habit, size step, line-height, letter-spacing if distinctive. Note measure targets and when to avoid display faces in dense tables.
207
+
208
+ ### Layout — writing template
209
+
210
+ Describe grid (columns, gutters, max content width), sticky regions, scroll behavior, and breakpoint flips. Quote observed spacing steps from `--spacing-*` or Tailwind scale. Call out full-bleed vs contained sections.
211
+
212
+ ### Elevation & Depth — writing template
213
+
214
+ Either list shadow tokens with intent (hover vs modal) or declare a **flat/tonal** system using surface steps only. Sidecar `extensions.shadows` holds long values; prose explains when to use each tier.
215
+
216
+ ### Shapes — writing template
217
+
218
+ Radius ladder (`--radius-*`), border weights, pill vs square buttons, clip habits. Tie shapes to brand metaphor where helpful.
219
+
220
+ ### Components — writing template
221
+
222
+ One subsection per primitive: purpose, anatomy, default + hover + focus + disabled + error. Reference frontmatter keys (`button-primary`) instead of duplicating hex. Sidecar may carry expanded HTML/CSS snippets for live panel consumers.
223
+
224
+ ### Do's and Don'ts — writing template
225
+
226
+ Minimum six lines, balanced. Each **Do** ties to an observed good pattern; each **Don't** blocks a regression you saw in code or critique—not hypothetical trends.
227
+
228
+ ---
229
+
230
+ ## Token discovery grep cheatsheet
231
+
232
+ When scanning CSS sources, prioritize prefixes (record file + line):
233
+
234
+ | Prefix | Typical meaning |
235
+ |--------|-----------------|
236
+ | `--color-*` | Semantic and brand fills |
237
+ | `--radius-*` | Corner language |
238
+ | `--spacing-*` | Rhythm scale |
239
+ | `--shadow-*` | Elevation |
240
+ | `--ease-*` | Motion curves |
241
+ | `--duration-*` | Transition timing |
242
+ | `--font-*` | Family/size shortcuts when present |
243
+
244
+ Tailwind: mine `theme.extend` for the same roles. CSS-in-JS: flatten nested theme objects into the frontmatter schema.
245
+
246
+ ---
247
+
248
+ ## Sidecar vs frontmatter split
249
+
250
+ | Lives in YAML frontmatter | Lives in `.impeccable/design.json` |
251
+ |---------------------------|-------------------------------------|
252
+ | Primitive colors, type scales, radii, spacing keys | Tonal ramps, extra shadow/motion/breakpoint entries |
253
+ | Up to 8 props per component variant | Full HTML/CSS exemplars, `refersTo` linkage |
254
+ | `{token}` references among components | `narrative` mirror (northStar, rules, dos/donts) |
255
+
256
+ Regenerate both together on full document runs; `--sidecar-only` refresh (user request) touches JSON without rewriting DESIGN.md body.
257
+
258
+ ---
259
+
260
+ ## Scan workflow timing
261
+
262
+ 1. **Discover** — run grep/Tailwind/token JSON passes; dedupe by token name.
263
+ 2. **Draft frontmatter** — primitives first, then component variants referencing them.
264
+ 3. **Qualitative rounds** — two passes, ≤3 questions each; wait for answers between passes.
265
+ 4. **Write DESIGN.md** — canonical section order; Named Rules where doctrine helps.
266
+ 5. **Emit sidecar** — mirror narrative fields verbatim; expand components to literal CSS.
267
+ 6. **Confirm** — show user both files; offer section-level revision loop.
268
+
269
+ On **seed** runs, stop after placeholder sections—no sidecar until a post-implementation scan replaces `[to be resolved…]` markers.
270
+
271
+ ## Style & pitfalls
272
+
273
+ Frontmatter normative—no duplicate hex in prose. Named Rules 1–3 per section where useful. No raw class dumps. No top-level frontmatter groups for motion/breakpoints/shadows (sidecar only). Do not invent components; do not silently overwrite existing DESIGN.md. Do not rename canonical section headers.
@@ -0,0 +1,52 @@
1
+ # Extract flow
2
+
3
+ Find reusable patterns, tokens, and components; consolidate into the design system.
4
+
5
+ ## Step 1: Locate the system
6
+
7
+ Find the component library or shared UI directory. Learn structure, naming, token layout, import conventions.
8
+
9
+ **No design system yet:** STOP—AskUserQuestion for preferred location/structure before creating one.
10
+
11
+ ## Step 2: Spot candidates
12
+
13
+ In the target area:
14
+
15
+ - Components repeated 3+ times with same intent
16
+ - Hard-coded color, space, type, shadow → tokenize
17
+ - Inconsistent duplicates of one concept
18
+ - Repeated layout/interaction patterns
19
+ - Repeated type stacks or motion recipes
20
+
21
+ Extract only **3+ uses, same intent**. Premature abstraction loses.
22
+
23
+ ## Step 3: Plan
24
+
25
+ - Components to extract; tokens to create; variants needed
26
+ - Names aligned with existing conventions
27
+ - Migration: how existing call sites switch over
28
+
29
+ Grow incrementally—clear wins now, not hypothetical futures.
30
+
31
+ ## Step 4: Extract
32
+
33
+ - **Components:** clear props, variants, a11y (ARIA, keyboard, focus), brief usage notes
34
+ - **Tokens:** primitive vs semantic naming, documented when-to-use
35
+ - **Patterns:** when to apply, examples, variations
36
+
37
+ ## Step 5: Migrate
38
+
39
+ Search instances; replace systematically; verify parity; delete dead implementations.
40
+
41
+ ## Step 6: Document
42
+
43
+ Update library docs, token tables, Storybook/catalog if present.
44
+
45
+ ## Never
46
+
47
+ - Extract one-offs without generalization
48
+ - Over-generic components
49
+ - Ignore existing conventions
50
+ - Skip types/prop docs
51
+ - Tokenize every literal
52
+ - Merge controls that differ in intent
@@ -0,0 +1,122 @@
1
+ Interfaces that only work with perfect demo data are not production-ready. Harden against real inputs, failures, locales, and networks.
2
+
3
+ ## Assess needs
4
+
5
+ 1. **Extreme inputs**
6
+ - very long/short/empty text;
7
+ - emoji, RTL, accents;
8
+ - huge numbers; 1000+ list items; 50+ options;
9
+ - empty datasets.
10
+
11
+ 2. **Errors**
12
+ - offline, slow, timeout;
13
+ - API 400/401/403/404/500;
14
+ - validation, permission, rate limit;
15
+ - concurrent ops.
16
+
17
+ 3. **i18n**
18
+ - long translations (~30% over English);
19
+ - RTL; CJK; emoji byte width;
20
+ - date/number/currency formats.
21
+
22
+ **CRITICAL:** Design for messy reality, not the happy path.
23
+
24
+ ## Dimensions
25
+
26
+ ### Text overflow
27
+
28
+ ```css
29
+ .truncate {
30
+ overflow: hidden;
31
+ text-overflow: ellipsis;
32
+ white-space: nowrap;
33
+ }
34
+ .line-clamp {
35
+ display: -webkit-box;
36
+ -webkit-line-clamp: 3;
37
+ -webkit-box-orient: vertical;
38
+ overflow: hidden;
39
+ }
40
+ .wrap {
41
+ word-wrap: break-word;
42
+ overflow-wrap: break-word;
43
+ hyphens: auto;
44
+ }
45
+ ```
46
+
47
+ Flex/grid: `min-width: 0` (and `min-height: 0` on grid) so items can shrink.
48
+
49
+ Responsive type: `clamp()`; 16px body floor on mobile (14px only for truly secondary; iOS zooms focused inputs under 16px); test 200% zoom; containers grow with text.
50
+
51
+ ### i18n
52
+
53
+ - Budget 30–40% extra space; flexible layouts; test German; avoid fixed text widths.
54
+
55
+ ```jsx
56
+ // ❌ fixed width assumes short English
57
+ <button className="w-24">Submit</button>
58
+ // ✅ content-sized
59
+ <button className="px-4 py-2">Submit</button>
60
+ ```
61
+
62
+ RTL: logical properties (`margin-inline-start`, `padding-inline`, `border-inline-end`) or `[dir="rtl"]` transforms.
63
+
64
+ UTF-8 everywhere; test CJK and emoji.
65
+
66
+ ```javascript
67
+ new Intl.DateTimeFormat('de-DE').format(date);
68
+ new Intl.NumberFormat('en-US', { style: 'currency', currency: 'USD' }).format(n);
69
+ ```
70
+
71
+ Pluralization via i18n library, not English-only string hacks.
72
+
73
+ ### Errors
74
+
75
+ Network: clear message, retry, explain, offline mode if applicable.
76
+
77
+ Forms: inline errors, specific guidance, preserve input.
78
+
79
+ API: status-appropriate UX (400 validation, 401 login, 403 permission, 404 not found, 429 rate limit, 500 generic + support).
80
+
81
+ Graceful degradation: core path without JS where possible; alt text; progressive enhancement.
82
+
83
+ ### Edge cases
84
+
85
+ Empty, loading (named operation, estimates), large data (pagination/virtual scroll), double-submit guards, race handling, optimistic rollback, permission states with explanation, browser feature detection + polyfills.
86
+
87
+ ### Validation
88
+
89
+ Client hints + **always** server validate/sanitize; rate limits.
90
+
91
+ ```html
92
+ <input maxlength="100" pattern="[A-Za-z0-9]+" required aria-describedby="username-hint" />
93
+ ```
94
+
95
+ ### a11y resilience
96
+
97
+ Keyboard-complete flows; focus in modals; skip links; ARIA and live regions; high-contrast testing; non-color cues.
98
+
99
+ ### Performance resilience
100
+
101
+ Slow net: progressive images, skeletons, optimistic UI, service workers.
102
+
103
+ Cleanup listeners, subscriptions, timers; abort fetches on unmount.
104
+
105
+ ```javascript
106
+ const debouncedSearch = debounce(handleSearch, 300);
107
+ const throttledScroll = throttle(handleScroll, 100);
108
+ ```
109
+
110
+ ## Testing
111
+
112
+ Manual: extremes, locales, offline, 3G throttle, screen reader, keyboard-only, old browsers.
113
+
114
+ Automated: unit edge cases, integration errors, E2E critical paths, visual regression, axe/WAVE.
115
+
116
+ **NEVER:** assume perfect input; ignore i18n; generic “Error occurred”; forget offline; client-only validation; fixed text widths; English-length assumptions; whole UI blocked on one component error.
117
+
118
+ ## Verify
119
+
120
+ 100+ char names, emoji fields, RTL, CJK, throttled net, 1000+ rows, rapid double-submit, forced API errors, empty data.
121
+
122
+ Then `/ui-design polish`.