@jaimevalasek/aioson 1.7.2 → 1.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1049) hide show
  1. package/CHANGELOG.md +595 -560
  2. package/CODE_OF_CONDUCT.md +12 -12
  3. package/CONTRIBUTING.md +13 -13
  4. package/LICENSE +661 -661
  5. package/README.md +919 -776
  6. package/bin/aioson.js +4 -4
  7. package/docs/design-previews/aurora-command-ui-website.html +884 -884
  8. package/docs/design-previews/aurora-command-ui.html +682 -682
  9. package/docs/design-previews/bold-editorial-ui-website.html +658 -658
  10. package/docs/design-previews/bold-editorial-ui.html +717 -717
  11. package/docs/design-previews/clean-saas-ui-website.html +1202 -1202
  12. package/docs/design-previews/clean-saas-ui.html +549 -549
  13. package/docs/design-previews/cognitive-core-ui-website.html +1009 -1009
  14. package/docs/design-previews/cognitive-core-ui.html +463 -463
  15. package/docs/design-previews/glassmorphism-ui-website.html +572 -572
  16. package/docs/design-previews/glassmorphism-ui.html +886 -886
  17. package/docs/design-previews/index.html +699 -699
  18. package/docs/design-previews/interface-design-website.html +1187 -1187
  19. package/docs/design-previews/interface-design.html +513 -513
  20. package/docs/design-previews/neo-brutalist-ui-website.html +621 -621
  21. package/docs/design-previews/neo-brutalist-ui.html +797 -797
  22. package/docs/design-previews/premium-command-center-ui-website.html +1217 -1217
  23. package/docs/design-previews/premium-command-center-ui.html +552 -552
  24. package/docs/design-previews/pt.squarespace.com-homepage.html +889 -889
  25. package/docs/design-previews/warm-craft-ui-website.html +684 -684
  26. package/docs/design-previews/warm-craft-ui.html +739 -739
  27. package/docs/en/1-understand/ecosystem-map.md +228 -0
  28. package/docs/en/1-understand/glossary.md +288 -0
  29. package/docs/en/1-understand/what-is-aioson.md +94 -0
  30. package/docs/en/1-understand/why-it-exists.md +106 -0
  31. package/docs/en/2-start/existing-project.md +246 -0
  32. package/docs/en/2-start/first-project.md +307 -0
  33. package/docs/en/2-start/initial-decisions.md +223 -0
  34. package/docs/en/3-recipes/README.md +28 -0
  35. package/docs/en/3-recipes/continuity-between-sessions.md +303 -0
  36. package/docs/en/3-recipes/from-idea-to-prd-via-briefing.md +235 -0
  37. package/docs/en/3-recipes/full-feature-with-sheldon.md +338 -0
  38. package/docs/en/4-agents/README.md +56 -0
  39. package/docs/en/5-reference/README.md +60 -0
  40. package/docs/en/{cli-reference.md → 5-reference/cli-reference.md} +639 -409
  41. package/docs/en/5-reference/i18n.md +52 -0
  42. package/docs/en/{json-schemas.md → 5-reference/json-schemas.md} +41 -41
  43. package/docs/en/{mcp.md → 5-reference/mcp.md} +56 -56
  44. package/docs/en/{parallel.md → 5-reference/parallel.md} +82 -82
  45. package/docs/en/{qa-browser.md → 5-reference/qa-browser.md} +339 -339
  46. package/docs/en/{release-flow.md → 5-reference/release-flow.md} +22 -22
  47. package/docs/en/{release-notes-template.md → 5-reference/release-notes-template.md} +41 -41
  48. package/docs/en/{release.md → 5-reference/release.md} +28 -28
  49. package/docs/en/{schemas → 5-reference/schemas}/agent-prompt.schema.json +17 -17
  50. package/docs/en/{schemas → 5-reference/schemas}/agents.schema.json +32 -32
  51. package/docs/en/{schemas → 5-reference/schemas}/context-validate.schema.json +36 -36
  52. package/docs/en/{schemas → 5-reference/schemas}/doctor.schema.json +89 -89
  53. package/docs/en/{schemas → 5-reference/schemas}/error.schema.json +24 -24
  54. package/docs/en/{schemas → 5-reference/schemas}/i18n-add.schema.json +15 -15
  55. package/docs/en/{schemas → 5-reference/schemas}/index.json +126 -116
  56. package/docs/en/{schemas → 5-reference/schemas}/info.schema.json +39 -39
  57. package/docs/en/{schemas → 5-reference/schemas}/init.schema.json +48 -48
  58. package/docs/en/{schemas → 5-reference/schemas}/install.schema.json +60 -60
  59. package/docs/en/{schemas → 5-reference/schemas}/locale-apply.schema.json +30 -30
  60. package/docs/en/{schemas → 5-reference/schemas}/mcp-doctor.schema.json +95 -95
  61. package/docs/en/{schemas → 5-reference/schemas}/mcp-init.schema.json +122 -122
  62. package/docs/en/{schemas → 5-reference/schemas}/package-test.schema.json +24 -24
  63. package/docs/en/{schemas → 5-reference/schemas}/parallel-assign.schema.json +66 -57
  64. package/docs/en/{schemas → 5-reference/schemas}/parallel-doctor.schema.json +122 -86
  65. package/docs/en/5-reference/schemas/parallel-guard.schema.json +63 -0
  66. package/docs/en/{schemas → 5-reference/schemas}/parallel-init.schema.json +53 -53
  67. package/docs/en/5-reference/schemas/parallel-merge.schema.json +84 -0
  68. package/docs/en/5-reference/schemas/parallel-status.schema.json +184 -0
  69. package/docs/en/{schemas → 5-reference/schemas}/setup-context.schema.json +39 -39
  70. package/docs/en/{schemas → 5-reference/schemas}/smoke.schema.json +23 -23
  71. package/docs/en/{schemas → 5-reference/schemas}/update.schema.json +48 -48
  72. package/docs/en/{schemas → 5-reference/schemas}/workflow-plan.schema.json +30 -30
  73. package/docs/en/{squad-dashboard.md → 5-reference/squad-dashboard.md} +372 -372
  74. package/docs/en/{web3.md → 5-reference/web3.md} +54 -54
  75. package/docs/en/README.md +115 -0
  76. package/docs/en/active-learning-loop/README.md +117 -0
  77. package/docs/en/active-learning-loop/active-learning-loop.md +117 -0
  78. package/docs/en/active-learning-loop/cli-commands.md +320 -0
  79. package/docs/en/active-learning-loop/diagrams.md +225 -0
  80. package/docs/en/active-learning-loop/doctor-checks.md +151 -0
  81. package/docs/en/active-learning-loop/how-to-use.md +313 -0
  82. package/docs/en/active-learning-loop/troubleshooting.md +283 -0
  83. package/docs/en/deyvin-subtask-scout/README.md +109 -0
  84. package/docs/en/deyvin-subtask-scout/cli-commands.md +248 -0
  85. package/docs/en/deyvin-subtask-scout/diagrams.md +124 -0
  86. package/docs/en/deyvin-subtask-scout/how-to-use.md +221 -0
  87. package/docs/en/deyvin-subtask-scout/sub-task-scout.md +115 -0
  88. package/docs/en/deyvin-subtask-scout/troubleshooting.md +184 -0
  89. package/docs/integrations/apps-publish-marketplace.md +94 -0
  90. package/docs/integrations/sdlc-genius-boundary.md +76 -76
  91. package/docs/integrations/sdlc-genius-eval-matrix.md +75 -75
  92. package/docs/integrations/sdlc-genius-install-checklist.md +93 -93
  93. package/docs/integrations/sdlc-genius-review-samples.md +86 -86
  94. package/docs/openclaw-bridge.md +308 -308
  95. package/docs/pt/1-entender/glossario.md +288 -0
  96. package/docs/pt/1-entender/mapa-do-ecossistema.md +228 -0
  97. package/docs/pt/1-entender/o-que-e-aioson.md +94 -0
  98. package/docs/pt/1-entender/por-que-existe.md +107 -0
  99. package/docs/pt/2-comecar/decisoes-iniciais.md +223 -0
  100. package/docs/pt/2-comecar/primeiro-projeto.md +307 -0
  101. package/docs/pt/2-comecar/projeto-existente.md +245 -0
  102. package/docs/pt/3-receitas/README.md +28 -0
  103. package/docs/pt/3-receitas/app-saas-do-zero.md +324 -0
  104. package/docs/pt/3-receitas/auditoria-seguranca.md +254 -0
  105. package/docs/pt/3-receitas/clonar-design-de-site.md +211 -0
  106. package/docs/pt/3-receitas/continuidade-entre-sessoes.md +303 -0
  107. package/docs/pt/3-receitas/da-ideia-ao-prd-via-briefing.md +234 -0
  108. package/docs/pt/3-receitas/feature-completa-com-sheldon.md +338 -0
  109. package/docs/pt/3-receitas/integracao-em-codebase-grande.md +243 -0
  110. package/docs/pt/3-receitas/landing-page.md +281 -0
  111. package/docs/pt/3-receitas/plans-externos-para-product.md +191 -0
  112. package/docs/pt/3-receitas/publicar-no-aioson-com.md +219 -0
  113. package/docs/pt/3-receitas/refatoracao-grande.md +251 -0
  114. package/docs/pt/4-agentes/README.md +65 -0
  115. package/docs/pt/4-agentes/analyst.md +111 -0
  116. package/docs/pt/4-agentes/architect.md +113 -0
  117. package/docs/pt/4-agentes/briefing.md +95 -0
  118. package/docs/pt/4-agentes/committer.md +108 -0
  119. package/docs/pt/4-agentes/copywriter.md +279 -0
  120. package/docs/pt/4-agentes/design-hybrid-forge.md +116 -0
  121. package/docs/pt/4-agentes/dev.md +136 -0
  122. package/docs/pt/4-agentes/deyvin.md +99 -0
  123. package/docs/pt/4-agentes/discover.md +122 -0
  124. package/docs/pt/4-agentes/discovery-design-doc.md +91 -0
  125. package/docs/pt/4-agentes/genome.md +115 -0
  126. package/docs/pt/4-agentes/neo.md +93 -0
  127. package/docs/pt/4-agentes/orache.md +107 -0
  128. package/docs/pt/4-agentes/orchestrator.md +118 -0
  129. package/docs/pt/4-agentes/pentester.md +131 -0
  130. package/docs/pt/4-agentes/pm.md +97 -0
  131. package/docs/pt/4-agentes/product.md +114 -0
  132. package/docs/pt/4-agentes/profiler-enricher.md +93 -0
  133. package/docs/pt/4-agentes/profiler-forge.md +93 -0
  134. package/docs/pt/4-agentes/profiler-researcher.md +98 -0
  135. package/docs/pt/4-agentes/qa.md +124 -0
  136. package/docs/pt/4-agentes/setup.md +104 -0
  137. package/docs/pt/4-agentes/sheldon.md +95 -0
  138. package/docs/pt/4-agentes/site-forge.md +104 -0
  139. package/docs/pt/4-agentes/squad.md +127 -0
  140. package/docs/pt/4-agentes/tester.md +105 -0
  141. package/docs/pt/4-agentes/ux-ui.md +110 -0
  142. package/docs/pt/4-agentes/validator.md +118 -0
  143. package/docs/pt/5-referencia/README.md +88 -0
  144. package/docs/pt/5-referencia/agent-chain-continuity.md +124 -0
  145. package/docs/pt/{agent-sharding.md → 5-referencia/agent-sharding.md} +132 -132
  146. package/docs/pt/5-referencia/aioson-com-store.md +119 -0
  147. package/docs/pt/{automacao-squads.md → 5-referencia/automacao-squads.md} +407 -407
  148. package/docs/pt/{clientes-ai.md → 5-referencia/clientes-ai.md} +300 -286
  149. package/docs/pt/{comandos-cli.md → 5-referencia/comandos-cli.md} +1823 -1634
  150. package/docs/pt/5-referencia/compress-agents.md +304 -0
  151. package/docs/pt/5-referencia/design-docs-governance.md +59 -0
  152. package/docs/pt/{devlog-pipeline.md → 5-referencia/devlog-pipeline.md} +270 -270
  153. package/docs/pt/5-referencia/feature-archive.md +199 -0
  154. package/docs/pt/5-referencia/feature-dossier.md +121 -0
  155. package/docs/pt/{fluxo-artefatos.md → 5-referencia/fluxo-artefatos.md} +179 -178
  156. package/docs/pt/{genome-3.0-spec.md → 5-referencia/genome-4.0-spec.md} +407 -296
  157. package/docs/pt/5-referencia/genome-distribution.md +232 -0
  158. package/docs/pt/{hooks-session-guard.md → 5-referencia/hooks-session-guard.md} +454 -454
  159. package/docs/pt/{inteligencia-adaptativa.md → 5-referencia/inteligencia-adaptativa.md} +324 -324
  160. package/docs/pt/5-referencia/live-sessions.md +144 -0
  161. package/docs/pt/5-referencia/memoria-e-contexto.md +340 -0
  162. package/docs/pt/5-referencia/motor-hardening.md +493 -0
  163. package/docs/pt/{output-strategy-delivery.md → 5-referencia/output-strategy-delivery.md} +655 -655
  164. package/docs/pt/5-referencia/runner-system.md +113 -0
  165. package/docs/pt/{runtime-observability.md → 5-referencia/runtime-observability.md} +76 -76
  166. package/docs/pt/{sandbox.md → 5-referencia/sandbox.md} +125 -125
  167. package/docs/pt/{sdd-automation-scripts.md → 5-referencia/sdd-automation-scripts.md} +559 -557
  168. package/docs/pt/5-referencia/sdd-framework.md +115 -0
  169. package/docs/pt/5-referencia/sdd-planos-e-estrutura.md +321 -0
  170. package/docs/pt/5-referencia/secure-by-default.md +117 -0
  171. package/docs/pt/{skills.md → 5-referencia/skills.md} +275 -267
  172. package/docs/pt/{spec-learnings-pipeline.md → 5-referencia/spec-learnings-pipeline.md} +265 -265
  173. package/docs/pt/{squad-dashboard.md → 5-referencia/squad-dashboard.md} +373 -373
  174. package/docs/pt/{web3.md → 5-referencia/web3.md} +797 -797
  175. package/docs/pt/README.md +111 -116
  176. package/docs/pt/_arquivo/README.md +130 -0
  177. package/docs/pt/{advisor-spec.md → _arquivo/advisor-spec.md} +343 -335
  178. package/docs/pt/{agentes-customizados.md → _arquivo/agentes-customizados.md} +678 -670
  179. package/docs/pt/{busca-de-contexto.md → _arquivo/busca-de-contexto.md} +136 -129
  180. package/docs/pt/{cache-de-contexto.md → _arquivo/cache-de-contexto.md} +163 -156
  181. package/docs/pt/{cenarios.md → _arquivo/cenarios.md} +1282 -1274
  182. package/docs/pt/{design-hybrid-forge.md → _arquivo/design-hybrid-forge.md} +365 -356
  183. package/docs/pt/{deyvin.md → _arquivo/deyvin.md} +123 -115
  184. package/docs/pt/{guia-engineer.md → _arquivo/guia-engineer.md} +234 -226
  185. package/docs/pt/{inicio-rapido.md → _arquivo/inicio-rapido.md} +261 -250
  186. package/docs/pt/{memoria-contexto.md → _arquivo/memoria-contexto.md} +262 -255
  187. package/docs/pt/{monitor-de-contexto.md → _arquivo/monitor-de-contexto.md} +165 -158
  188. package/docs/pt/{profiler-system.md → _arquivo/profiler-system.md} +222 -214
  189. package/docs/pt/{recuperacao-de-sessao.md → _arquivo/recuperacao-de-sessao.md} +134 -125
  190. package/docs/pt/{site-forge.md → _arquivo/site-forge.md} +318 -309
  191. package/docs/pt/{squad-genome.md → _arquivo/squad-genome.md} +793 -783
  192. package/docs/pt/active-learning-loop/README.md +117 -0
  193. package/docs/pt/active-learning-loop/ativo-learning-loop.md +117 -0
  194. package/docs/pt/active-learning-loop/comandos-cli.md +320 -0
  195. package/docs/pt/active-learning-loop/como-usar.md +313 -0
  196. package/docs/pt/active-learning-loop/diagramas.md +225 -0
  197. package/docs/pt/active-learning-loop/doctor-checks.md +151 -0
  198. package/docs/pt/active-learning-loop/troubleshooting.md +283 -0
  199. package/docs/pt/agentes.md +996 -672
  200. package/docs/pt/deyvin-subtask-scout/README.md +109 -0
  201. package/docs/pt/deyvin-subtask-scout/comandos-cli.md +248 -0
  202. package/docs/pt/deyvin-subtask-scout/como-usar.md +221 -0
  203. package/docs/pt/deyvin-subtask-scout/diagramas.md +124 -0
  204. package/docs/pt/deyvin-subtask-scout/sub-task-scout.md +113 -0
  205. package/docs/pt/deyvin-subtask-scout/troubleshooting.md +184 -0
  206. package/docs/pt/living-memory/README.md +81 -0
  207. package/docs/pt/living-memory/autonomy-contract.md +206 -0
  208. package/docs/pt/living-memory/diagramas.md +365 -0
  209. package/docs/pt/living-memory/memoria-viva.md +141 -0
  210. package/docs/pt/living-memory/notificacoes-info.md +142 -0
  211. package/docs/pt/living-memory/reflexao-in-harness.md +218 -0
  212. package/docs/pt/living-memory/troubleshooting.md +286 -0
  213. package/docs/testing/genome-2.0-manual-regression.md +23 -23
  214. package/docs/testing/genome-2.0-matrix.md +36 -36
  215. package/docs/testing/genome-2.0-rollout.md +184 -184
  216. package/package.json +51 -50
  217. package/src/a2a/client.js +165 -165
  218. package/src/a2a/server.js +223 -223
  219. package/src/agent-loader.js +280 -280
  220. package/src/agent-manifests.js +86 -0
  221. package/src/agents.js +92 -72
  222. package/src/autonomy-policy.js +163 -0
  223. package/src/backup-local.js +74 -74
  224. package/src/backup-provider.js +303 -303
  225. package/src/brain-query.js +171 -0
  226. package/src/cli.js +1450 -1099
  227. package/src/commands/agent-audit.js +397 -397
  228. package/src/commands/agent-export-skill.js +229 -229
  229. package/src/commands/agent-loader.js +85 -85
  230. package/src/commands/agents.js +273 -160
  231. package/src/commands/artifact-validate.js +218 -189
  232. package/src/commands/auth.js +298 -0
  233. package/src/commands/backup-local-cmd.js +25 -25
  234. package/src/commands/backup.js +533 -533
  235. package/src/commands/brain-query.js +44 -0
  236. package/src/commands/brief-gen.js +405 -405
  237. package/src/commands/brief-validate.js +65 -65
  238. package/src/commands/briefing.js +344 -0
  239. package/src/commands/classify.js +256 -256
  240. package/src/commands/cloud.js +1767 -1767
  241. package/src/commands/commit-prepare.js +610 -0
  242. package/src/commands/compress-agents.js +416 -0
  243. package/src/commands/config.js +90 -90
  244. package/src/commands/context-cache.js +90 -90
  245. package/src/commands/context-compact.js +49 -49
  246. package/src/commands/context-health.js +187 -175
  247. package/src/commands/context-load.js +219 -0
  248. package/src/commands/context-monitor.js +163 -163
  249. package/src/commands/context-pack.js +45 -45
  250. package/src/commands/context-search.js +66 -66
  251. package/src/commands/context-trim.js +183 -177
  252. package/src/commands/context-validate.js +91 -91
  253. package/src/commands/design-hybrid-options.js +385 -385
  254. package/src/commands/detect-test-runner.js +55 -55
  255. package/src/commands/dev-resume.js +32 -0
  256. package/src/commands/devlog-export-brains.js +27 -27
  257. package/src/commands/devlog-process.js +294 -292
  258. package/src/commands/devlog-watch.js +131 -131
  259. package/src/commands/doctor.js +123 -123
  260. package/src/commands/dossier-add-research.js +114 -0
  261. package/src/commands/dossier-audit.js +222 -0
  262. package/src/commands/dossier.js +423 -0
  263. package/src/commands/feature-archive.js +513 -0
  264. package/src/commands/feature-close.js +554 -165
  265. package/src/commands/gate-approve.js +198 -0
  266. package/src/commands/gate-check.js +247 -228
  267. package/src/commands/genome-doctor.js +489 -41
  268. package/src/commands/genome-migrate.js +49 -49
  269. package/src/commands/git-guard.js +170 -0
  270. package/src/commands/harness.js +307 -0
  271. package/src/commands/health.js +214 -214
  272. package/src/commands/hooks-emit.js +253 -253
  273. package/src/commands/hooks-install.js +347 -347
  274. package/src/commands/i18n-add.js +56 -56
  275. package/src/commands/implementation-plan.js +367 -340
  276. package/src/commands/info.js +41 -41
  277. package/src/commands/init.js +120 -116
  278. package/src/commands/install.js +162 -107
  279. package/src/commands/learning-auto-promote.js +197 -195
  280. package/src/commands/learning-evolve.js +364 -364
  281. package/src/commands/learning-export.js +103 -103
  282. package/src/commands/learning-rollback.js +164 -164
  283. package/src/commands/learning.js +134 -134
  284. package/src/commands/live.js +2101 -1641
  285. package/src/commands/locale-apply.js +54 -51
  286. package/src/commands/locale-diff.js +25 -126
  287. package/src/commands/mcp-doctor.js +407 -406
  288. package/src/commands/mcp-init.js +373 -379
  289. package/src/commands/memory-archive.js +193 -0
  290. package/src/commands/memory-reflect-commit.js +148 -0
  291. package/src/commands/memory-reflect-prepare.js +97 -0
  292. package/src/commands/memory-restore.js +177 -0
  293. package/src/commands/memory-search.js +135 -0
  294. package/src/commands/memory.js +299 -0
  295. package/src/commands/notify.js +68 -0
  296. package/src/commands/package-e2e.js +273 -273
  297. package/src/commands/parallel-assign.js +483 -403
  298. package/src/commands/parallel-doctor.js +850 -437
  299. package/src/commands/parallel-guard.js +241 -0
  300. package/src/commands/parallel-init.js +311 -249
  301. package/src/commands/parallel-merge.js +299 -0
  302. package/src/commands/parallel-status.js +434 -290
  303. package/src/commands/pattern-detect.js +33 -33
  304. package/src/commands/preflight-context.js +30 -30
  305. package/src/commands/preflight.js +267 -208
  306. package/src/commands/pulse-update.js +130 -130
  307. package/src/commands/qa-doctor.js +185 -185
  308. package/src/commands/qa-init.js +166 -161
  309. package/src/commands/qa-report.js +58 -58
  310. package/src/commands/qa-run.js +873 -873
  311. package/src/commands/qa-scan.js +337 -337
  312. package/src/commands/recovery.js +43 -43
  313. package/src/commands/revision.js +235 -0
  314. package/src/commands/runner-daemon.js +274 -274
  315. package/src/commands/runner-plan.js +70 -70
  316. package/src/commands/runner-queue-from-plan.js +166 -166
  317. package/src/commands/runner-queue.js +189 -189
  318. package/src/commands/runner-run.js +129 -129
  319. package/src/commands/runtime.js +2086 -2067
  320. package/src/commands/sandbox.js +37 -37
  321. package/src/commands/scaffold-complete.js +188 -0
  322. package/src/commands/scan-project.js +1371 -1371
  323. package/src/commands/scout-commit.js +163 -0
  324. package/src/commands/scout-prep.js +214 -0
  325. package/src/commands/scout-validate.js +112 -0
  326. package/src/commands/security-audit.js +275 -0
  327. package/src/commands/security-scan.js +376 -0
  328. package/src/commands/self-implement-loop.js +306 -256
  329. package/src/commands/session-guard.js +218 -218
  330. package/src/commands/setup-context.js +699 -698
  331. package/src/commands/setup.js +178 -178
  332. package/src/commands/sizing.js +165 -165
  333. package/src/commands/skill.js +670 -670
  334. package/src/commands/smoke.js +426 -426
  335. package/src/commands/spec-checkpoint.js +177 -177
  336. package/src/commands/spec-status.js +79 -79
  337. package/src/commands/spec-sync.js +190 -190
  338. package/src/commands/spec-tasks.js +288 -288
  339. package/src/commands/squad-agent-create.js +830 -788
  340. package/src/commands/squad-autorun.js +1220 -1220
  341. package/src/commands/squad-bus.js +217 -217
  342. package/src/commands/squad-card.js +149 -149
  343. package/src/commands/squad-daemon.js +343 -343
  344. package/src/commands/squad-dashboard.js +39 -39
  345. package/src/commands/squad-dependency-graph.js +164 -164
  346. package/src/commands/squad-deploy.js +64 -64
  347. package/src/commands/squad-doctor.js +460 -460
  348. package/src/commands/squad-export.js +77 -46
  349. package/src/commands/squad-investigate.js +314 -261
  350. package/src/commands/squad-learning.js +209 -209
  351. package/src/commands/squad-mcp.js +270 -270
  352. package/src/commands/squad-pipeline.js +343 -343
  353. package/src/commands/squad-plan.js +361 -329
  354. package/src/commands/squad-processes.js +56 -56
  355. package/src/commands/squad-recovery.js +42 -42
  356. package/src/commands/squad-repair-genomes.js +39 -39
  357. package/src/commands/squad-review.js +106 -106
  358. package/src/commands/squad-roi.js +291 -291
  359. package/src/commands/squad-scaffold.js +56 -55
  360. package/src/commands/squad-score.js +311 -250
  361. package/src/commands/squad-status.js +481 -460
  362. package/src/commands/squad-tool-register.js +157 -157
  363. package/src/commands/squad-validate.js +438 -347
  364. package/src/commands/squad-webhook.js +160 -160
  365. package/src/commands/squad-worker.js +191 -191
  366. package/src/commands/squad-worktrees.js +75 -75
  367. package/src/commands/state-save.js +122 -122
  368. package/src/commands/store-genome.js +667 -0
  369. package/src/commands/store-skill.js +247 -0
  370. package/src/commands/store-squad.js +431 -0
  371. package/src/commands/store-system.js +392 -0
  372. package/src/commands/sync-agents-preflight.js +176 -0
  373. package/src/commands/test-agents.js +199 -199
  374. package/src/commands/tool-capabilities.js +63 -0
  375. package/src/commands/tool-registry-cmd.js +232 -232
  376. package/src/commands/update.js +64 -64
  377. package/src/commands/verify-gate.js +612 -572
  378. package/src/commands/web-map.js +70 -70
  379. package/src/commands/web-scrape.js +71 -71
  380. package/src/commands/workflow-execute.js +730 -241
  381. package/src/commands/workflow-harden.js +231 -0
  382. package/src/commands/workflow-heal.js +136 -0
  383. package/src/commands/workflow-next.js +1279 -601
  384. package/src/commands/workflow-plan.js +108 -108
  385. package/src/commands/workflow-status.js +440 -250
  386. package/src/commands/workspace.js +144 -0
  387. package/src/constants.js +413 -417
  388. package/src/context-cache.js +159 -159
  389. package/src/context-memory.js +975 -837
  390. package/src/context-parse-reason.js +22 -22
  391. package/src/context-search.js +326 -326
  392. package/src/context-writer.js +197 -196
  393. package/src/context.js +247 -217
  394. package/src/delivery-runner.js +319 -319
  395. package/src/design-variation-catalog.js +503 -503
  396. package/src/detector.js +261 -261
  397. package/src/doctor.js +760 -289
  398. package/src/dossier/codemap-store.js +267 -0
  399. package/src/dossier/dossier-bootstrap.js +222 -0
  400. package/src/dossier/dossier-compact.js +159 -0
  401. package/src/dossier/lock.js +128 -0
  402. package/src/dossier/research-index-store.js +233 -0
  403. package/src/dossier/revision-store.js +313 -0
  404. package/src/dossier/schema.js +162 -0
  405. package/src/dossier/scout-section.js +127 -0
  406. package/src/dossier/store.js +406 -0
  407. package/src/execution-gateway.js +464 -461
  408. package/src/friction-scanner.js +202 -0
  409. package/src/genome-files.js +198 -198
  410. package/src/genome-format.js +442 -442
  411. package/src/genome-schema.js +238 -215
  412. package/src/genomes/bindings.js +281 -281
  413. package/src/genomes.js +500 -467
  414. package/src/handoff-contract.js +417 -0
  415. package/src/handoff-validator.js +45 -0
  416. package/src/harness/circuit-breaker.js +135 -0
  417. package/src/i18n/index.js +103 -103
  418. package/src/i18n/messages/en.js +1541 -1139
  419. package/src/i18n/messages/es.js +1325 -980
  420. package/src/i18n/messages/fr.js +1333 -987
  421. package/src/i18n/messages/pt-BR.js +1561 -1166
  422. package/src/i18n/scaffold.js +64 -64
  423. package/src/install-animation.js +260 -260
  424. package/src/install-profile.js +127 -143
  425. package/src/install-wizard.js +475 -475
  426. package/src/installer-config-merge.js +207 -0
  427. package/src/installer.js +449 -294
  428. package/src/learning-loop-archive.js +595 -0
  429. package/src/learning-loop-doctor.js +217 -0
  430. package/src/learning-loop-engine.js +254 -0
  431. package/src/learning-loop-fts5.js +132 -0
  432. package/src/learning-loop-migration.js +163 -0
  433. package/src/lib/dev-resume.js +140 -0
  434. package/src/lib/dossier-telemetry.js +36 -0
  435. package/src/lib/genomes/compat.js +206 -206
  436. package/src/lib/genomes/migrate.js +90 -90
  437. package/src/lib/git-commit-guard.js +751 -0
  438. package/src/lib/health-check.js +158 -158
  439. package/src/lib/hook-protocol.js +76 -76
  440. package/src/lib/llm-content-sanitizer.js +44 -0
  441. package/src/lib/security/artifact-reader.js +167 -0
  442. package/src/lib/security/exit-codes.js +51 -0
  443. package/src/lib/security/findings-writer.js +176 -0
  444. package/src/lib/security/runtime-events.js +77 -0
  445. package/src/lib/security/secrets-regex.js +115 -0
  446. package/src/lib/squads/genome-repair.js +49 -49
  447. package/src/lib/store/security-scan.js +175 -0
  448. package/src/lib/terminal-checkbox.js +135 -0
  449. package/src/lib/terminal-picker.js +447 -0
  450. package/src/lib/tmux-launcher.js +163 -0
  451. package/src/lib/tool-capabilities.js +102 -0
  452. package/src/lib/webhook-server.js +328 -328
  453. package/src/locales.js +88 -84
  454. package/src/mcp/apps/squad-dashboard/app.js +163 -163
  455. package/src/mcp/apps/squad-dashboard/index.html +261 -261
  456. package/src/mcp/apps/squad-dashboard/mcp-manifest.json +23 -23
  457. package/src/mcp/resources/squad-state.js +130 -130
  458. package/src/mcp-connectors/registry.js +602 -602
  459. package/src/memory-reflect-engine.js +359 -0
  460. package/src/notify-renderer.js +32 -0
  461. package/src/onboarding.js +305 -305
  462. package/src/parallel-workspace.js +756 -0
  463. package/src/parser.js +66 -59
  464. package/src/path-guard.js +47 -0
  465. package/src/permissions-generator.js +400 -0
  466. package/src/preflight-engine.js +654 -443
  467. package/src/prompt-tool.js +20 -20
  468. package/src/qa-html-report.js +472 -472
  469. package/src/recovery-context-session.js +154 -154
  470. package/src/runner/cascade.js +97 -97
  471. package/src/runner/cli-launcher.js +109 -109
  472. package/src/runner/plan-importer.js +63 -63
  473. package/src/runner/queue-store.js +159 -159
  474. package/src/runtime-store.js +2720 -2676
  475. package/src/sandbox.js +194 -177
  476. package/src/self-healing.js +142 -0
  477. package/src/session-handoff.js +295 -77
  478. package/src/squad/agent-teams-adapter.js +270 -264
  479. package/src/squad/brief-validator.js +350 -350
  480. package/src/squad/bus-bridge.js +140 -140
  481. package/src/squad/context-compactor.js +265 -265
  482. package/src/squad/cross-ai-synthesizer.js +250 -250
  483. package/src/squad/external-session.js +180 -180
  484. package/src/squad/hooks-generator.js +196 -196
  485. package/src/squad/inter-squad-events.js +175 -175
  486. package/src/squad/inter-squad.js +74 -74
  487. package/src/squad/intra-bus.js +345 -345
  488. package/src/squad/learning-extractor.js +213 -213
  489. package/src/squad/pattern-detector.js +365 -365
  490. package/src/squad/preflight-context.js +296 -296
  491. package/src/squad/recovery-context.js +372 -372
  492. package/src/squad/reflection.js +365 -365
  493. package/src/squad/squad-scaffold.js +341 -177
  494. package/src/squad/state-manager.js +310 -310
  495. package/src/squad/task-decomposer.js +652 -652
  496. package/src/squad/verify-gate.js +303 -303
  497. package/src/squad/worktree-manager.js +114 -114
  498. package/src/squad-daemon.js +490 -490
  499. package/src/squad-dashboard/api.js +223 -223
  500. package/src/squad-dashboard/attachment-handler.js +93 -93
  501. package/src/squad-dashboard/context-monitor.js +157 -157
  502. package/src/squad-dashboard/execution-logs.js +115 -115
  503. package/src/squad-dashboard/hunk-review.js +209 -209
  504. package/src/squad-dashboard/metrics.js +133 -133
  505. package/src/squad-dashboard/process-monitor.js +125 -125
  506. package/src/squad-dashboard/renderer.js +858 -858
  507. package/src/squad-dashboard/server.js +232 -232
  508. package/src/squad-dashboard/styles.js +525 -525
  509. package/src/squad-dashboard/token-tracker.js +99 -99
  510. package/src/squads/apply-genome.js +21 -21
  511. package/src/squads/genome-binding-service.js +154 -154
  512. package/src/sub-task-engine.js +415 -0
  513. package/src/sub-task-schemas.js +150 -0
  514. package/src/sub-task-state.js +152 -0
  515. package/src/sub-task-telemetry.js +69 -0
  516. package/src/test-briefing.js +226 -0
  517. package/src/tool-executor.js +94 -94
  518. package/src/updater.js +39 -39
  519. package/src/utils.js +49 -46
  520. package/src/version.js +50 -50
  521. package/src/web.js +284 -284
  522. package/src/worker-runner.js +541 -524
  523. package/src/workflow-gates.js +185 -0
  524. package/template/.aioson/advisors/.gitkeep +1 -1
  525. package/template/.aioson/agents/analyst.md +333 -372
  526. package/template/.aioson/agents/architect.md +325 -338
  527. package/template/.aioson/agents/briefing.md +264 -0
  528. package/template/.aioson/agents/committer.md +161 -0
  529. package/template/.aioson/agents/copywriter.md +937 -463
  530. package/template/.aioson/agents/design-hybrid-forge.md +141 -141
  531. package/template/.aioson/agents/dev.md +295 -779
  532. package/template/.aioson/agents/deyvin.md +198 -290
  533. package/template/.aioson/agents/discover.md +235 -0
  534. package/template/.aioson/agents/discovery-design-doc.md +56 -264
  535. package/template/.aioson/agents/genome.md +1904 -314
  536. package/template/.aioson/agents/manifests/analyst.manifest.json +26 -0
  537. package/template/.aioson/agents/manifests/architect.manifest.json +23 -0
  538. package/template/.aioson/agents/manifests/committer.manifest.json +23 -0
  539. package/template/.aioson/agents/manifests/dev.manifest.json +54 -0
  540. package/template/.aioson/agents/manifests/deyvin.manifest.json +41 -0
  541. package/template/.aioson/agents/manifests/orchestrator.manifest.json +30 -0
  542. package/template/.aioson/agents/manifests/pentester.manifest.json +39 -0
  543. package/template/.aioson/agents/manifests/pm.manifest.json +26 -0
  544. package/template/.aioson/agents/manifests/product.manifest.json +23 -0
  545. package/template/.aioson/agents/manifests/qa.manifest.json +41 -0
  546. package/template/.aioson/agents/manifests/setup.manifest.json +20 -0
  547. package/template/.aioson/agents/manifests/ux-ui.manifest.json +24 -0
  548. package/template/.aioson/agents/neo.md +341 -233
  549. package/template/.aioson/agents/orache.md +430 -434
  550. package/template/.aioson/agents/orchestrator.md +274 -364
  551. package/template/.aioson/agents/pair.md +5 -5
  552. package/template/.aioson/agents/pentester.md +289 -0
  553. package/template/.aioson/agents/pm.md +141 -194
  554. package/template/.aioson/agents/product.md +351 -518
  555. package/template/.aioson/agents/profiler-enricher.md +331 -280
  556. package/template/.aioson/agents/profiler-forge.md +212 -202
  557. package/template/.aioson/agents/profiler-researcher.md +282 -259
  558. package/template/.aioson/agents/qa.md +432 -688
  559. package/template/.aioson/agents/setup.md +423 -649
  560. package/template/.aioson/agents/sheldon.md +259 -829
  561. package/template/.aioson/agents/site-forge.md +281 -1753
  562. package/template/.aioson/agents/squad.md +160 -2027
  563. package/template/.aioson/agents/tester.md +536 -463
  564. package/template/.aioson/agents/ux-ui.md +195 -870
  565. package/template/.aioson/agents/validator.md +101 -0
  566. package/template/.aioson/brains/README.md +132 -128
  567. package/template/.aioson/brains/_archived/.gitkeep +0 -0
  568. package/template/.aioson/brains/_index.json +34 -16
  569. package/template/.aioson/brains/dev/patterns.brain.json +79 -0
  570. package/template/.aioson/brains/scripts/query.js +107 -103
  571. package/template/.aioson/brains/sheldon/architecture-decisions.brain.json +79 -0
  572. package/template/.aioson/brains/site-forge/visual-patterns.brain.json +205 -205
  573. package/template/.aioson/config/autonomy-protocol.json +125 -0
  574. package/template/.aioson/config/learning-loop.json +10 -0
  575. package/template/.aioson/config/scout-engine.json +1 -0
  576. package/template/.aioson/config.md +410 -382
  577. package/template/.aioson/constitution.md +36 -33
  578. package/template/.aioson/context/_archived/.gitkeep +0 -0
  579. package/template/.aioson/context/design-doc.md +136 -0
  580. package/template/.aioson/context/project-map.md +57 -0
  581. package/template/.aioson/context/project-pulse.md +34 -34
  582. package/template/.aioson/context/seeds/seed-example.md +27 -27
  583. package/template/.aioson/context/spec.md.template +54 -54
  584. package/template/.aioson/context/user-profile.md +42 -42
  585. package/template/.aioson/design-docs/code-reuse.md +48 -0
  586. package/template/.aioson/design-docs/componentization.md +47 -0
  587. package/template/.aioson/design-docs/file-size.md +52 -0
  588. package/template/.aioson/design-docs/folder-structure.md +51 -0
  589. package/template/.aioson/design-docs/naming.md +54 -0
  590. package/template/.aioson/docs/LAYERS.md +89 -79
  591. package/template/.aioson/docs/README.md +76 -76
  592. package/template/.aioson/docs/autonomy-protocol.md +80 -0
  593. package/template/.aioson/docs/briefing/briefing-craft.md +237 -0
  594. package/template/.aioson/docs/dev/execution-discipline.md +106 -0
  595. package/template/.aioson/docs/dev/stack-conventions.md +83 -0
  596. package/template/.aioson/docs/deyvin/continuity-recovery.md +57 -0
  597. package/template/.aioson/docs/deyvin/debugging-escalation.md +30 -0
  598. package/template/.aioson/docs/deyvin/pair-execution.md +44 -0
  599. package/template/.aioson/docs/deyvin/runtime-handoffs.md +36 -0
  600. package/template/.aioson/docs/example-external-api-context.md +72 -72
  601. package/template/.aioson/docs/pentester/app-playbooks.md +206 -0
  602. package/template/.aioson/docs/pentester/llm-supplychain.md +165 -0
  603. package/template/.aioson/docs/product/conversation-playbook.md +116 -0
  604. package/template/.aioson/docs/product/prd-contract.md +107 -0
  605. package/template/.aioson/docs/product/quality-lens.md +57 -0
  606. package/template/.aioson/docs/product/research-loop.md +65 -0
  607. package/template/.aioson/docs/sheldon/enrichment-paths.md +134 -0
  608. package/template/.aioson/docs/sheldon/harness-contract.md +118 -0
  609. package/template/.aioson/docs/sheldon/quality-lens.md +57 -0
  610. package/template/.aioson/docs/sheldon/research-loop.md +56 -0
  611. package/template/.aioson/docs/sheldon/web-intelligence.md +75 -0
  612. package/template/.aioson/docs/site-forge-build.md +195 -0
  613. package/template/.aioson/docs/site-forge-extraction.md +135 -0
  614. package/template/.aioson/docs/site-forge-qa.md +155 -0
  615. package/template/.aioson/docs/site-forge-recon.md +434 -0
  616. package/template/.aioson/docs/site-forge-transform.md +249 -0
  617. package/template/.aioson/docs/squad/content-output.md +91 -0
  618. package/template/.aioson/docs/squad/creation-flow.md +149 -0
  619. package/template/.aioson/docs/squad/domain-breadth.md +322 -0
  620. package/template/.aioson/docs/squad/domain-classification.md +117 -0
  621. package/template/.aioson/docs/squad/genome-bindings.md +47 -0
  622. package/template/.aioson/docs/squad/package-contract.md +260 -0
  623. package/template/.aioson/docs/squad/quality-lens.md +60 -0
  624. package/template/.aioson/docs/squad/research-loop.md +59 -0
  625. package/template/.aioson/docs/squad/session-operations.md +117 -0
  626. package/template/.aioson/docs/squad/workflow-quality.md +165 -0
  627. package/template/.aioson/docs/tester/coverage-quality.md +351 -0
  628. package/template/.aioson/docs/ux-ui/accessibility-audit.md +55 -0
  629. package/template/.aioson/docs/ux-ui/audit-mode.md +86 -0
  630. package/template/.aioson/docs/ux-ui/component-map.md +35 -0
  631. package/template/.aioson/docs/ux-ui/design-execution.md +111 -0
  632. package/template/.aioson/docs/ux-ui/design-gate.md +27 -0
  633. package/template/.aioson/docs/ux-ui/research-mode.md +39 -0
  634. package/template/.aioson/docs/ux-ui/site-delivery.md +156 -0
  635. package/template/.aioson/docs/ux-ui/token-contract.md +57 -0
  636. package/template/.aioson/genomes/INDEX.md +195 -0
  637. package/template/.aioson/genomes/copywriting/SKILL.md +137 -0
  638. package/template/.aioson/genomes/copywriting/manifest.json +140 -0
  639. package/template/.aioson/genomes/copywriting/references/application-notes.md +145 -0
  640. package/template/.aioson/genomes/copywriting/references/decision-weights.md +45 -0
  641. package/template/.aioson/genomes/copywriting/references/frameworks/5-act-narrative.md +184 -0
  642. package/template/.aioson/genomes/copywriting/references/frameworks/classical-formulas.md +164 -0
  643. package/template/.aioson/genomes/copywriting/references/frameworks/offer-stack.md +195 -0
  644. package/template/.aioson/genomes/copywriting/references/frameworks/one-belief.md +135 -0
  645. package/template/.aioson/genomes/copywriting/references/frameworks/pms-research.md +211 -0
  646. package/template/.aioson/genomes/copywriting/references/frameworks/two-paths-close.md +190 -0
  647. package/template/.aioson/genomes/copywriting/references/heuristics.md +114 -0
  648. package/template/.aioson/genomes/copywriting/references/meta-axioms.md +68 -0
  649. package/template/.aioson/genomes/copywriting/references/methodology.md +115 -0
  650. package/template/.aioson/genomes/copywriting-brunson/SKILL.md +133 -0
  651. package/template/.aioson/genomes/copywriting-brunson/manifest.json +152 -0
  652. package/template/.aioson/genomes/copywriting-brunson/references/application-notes.md +113 -0
  653. package/template/.aioson/genomes/copywriting-brunson/references/decision-weights.md +33 -0
  654. package/template/.aioson/genomes/copywriting-brunson/references/evidence-and-attribution.md +81 -0
  655. package/template/.aioson/genomes/copywriting-brunson/references/frameworks/6-part-structure.md +136 -0
  656. package/template/.aioson/genomes/copywriting-brunson/references/frameworks/origin-story.md +121 -0
  657. package/template/.aioson/genomes/copywriting-brunson/references/frameworks/perfect-webinar-script.md +139 -0
  658. package/template/.aioson/genomes/copywriting-brunson/references/frameworks/persuasive-storytelling-5-structures.md +164 -0
  659. package/template/.aioson/genomes/copywriting-brunson/references/frameworks/value-stack.md +136 -0
  660. package/template/.aioson/genomes/copywriting-brunson/references/frameworks/who-what-why-how.md +110 -0
  661. package/template/.aioson/genomes/copywriting-brunson/references/meta-axioms.md +36 -0
  662. package/template/.aioson/genomes/copywriting-brunson/references/methodology.md +112 -0
  663. package/template/.aioson/git-guard.json +12 -0
  664. package/template/.aioson/mcp/servers.md +23 -24
  665. package/template/.aioson/profiler-reports/.gitkeep +1 -1
  666. package/template/.aioson/rules/README.md +69 -69
  667. package/template/.aioson/rules/_archived/.gitkeep +0 -0
  668. package/template/.aioson/rules/agent-language-policy.md +93 -0
  669. package/template/.aioson/rules/aioson-context-boundary.md +63 -0
  670. package/template/.aioson/rules/canonical-path-contract.md +47 -0
  671. package/template/.aioson/rules/data-format-convention.md +74 -136
  672. package/template/.aioson/rules/disk-first-artifacts.md +44 -0
  673. package/template/.aioson/rules/example-monetary-values.md +30 -30
  674. package/template/.aioson/rules/output-brevity.md +44 -0
  675. package/template/.aioson/rules/prd-section-ownership.md +49 -0
  676. package/template/.aioson/rules/security-baseline.md +139 -0
  677. package/template/.aioson/rules/spec-level-ownership.md +61 -0
  678. package/template/.aioson/rules/squad/README.md +50 -50
  679. package/template/.aioson/rules/squad-driver-pattern.md +81 -0
  680. package/template/.aioson/schemas/content-blueprint.schema.json +30 -30
  681. package/template/.aioson/schemas/genome-meta.schema.json +150 -150
  682. package/template/.aioson/schemas/genome.schema.json +115 -115
  683. package/template/.aioson/schemas/readiness.schema.json +27 -27
  684. package/template/.aioson/schemas/squad-blueprint.schema.json +228 -204
  685. package/template/.aioson/schemas/squad-manifest.schema.json +874 -830
  686. package/template/.aioson/skills/design/aurora-command-ui/SKILL.md +243 -243
  687. package/template/.aioson/skills/design/aurora-command-ui/references/art-direction.md +293 -293
  688. package/template/.aioson/skills/design/aurora-command-ui/references/components.md +827 -827
  689. package/template/.aioson/skills/design/aurora-command-ui/references/dashboards.md +250 -250
  690. package/template/.aioson/skills/design/aurora-command-ui/references/design-tokens.md +585 -585
  691. package/template/.aioson/skills/design/aurora-command-ui/references/motion.md +365 -365
  692. package/template/.aioson/skills/design/aurora-command-ui/references/patterns.md +482 -482
  693. package/template/.aioson/skills/design/aurora-command-ui/references/websites.md +387 -387
  694. package/template/.aioson/skills/design/bold-editorial-ui/SKILL.md +205 -205
  695. package/template/.aioson/skills/design/bold-editorial-ui/references/art-direction.md +338 -338
  696. package/template/.aioson/skills/design/bold-editorial-ui/references/components.md +977 -977
  697. package/template/.aioson/skills/design/bold-editorial-ui/references/dashboards.md +218 -218
  698. package/template/.aioson/skills/design/bold-editorial-ui/references/design-tokens.md +326 -326
  699. package/template/.aioson/skills/design/bold-editorial-ui/references/motion.md +461 -461
  700. package/template/.aioson/skills/design/bold-editorial-ui/references/patterns.md +293 -293
  701. package/template/.aioson/skills/design/bold-editorial-ui/references/websites.md +352 -352
  702. package/template/.aioson/skills/design/clean-saas-ui/SKILL.md +210 -210
  703. package/template/.aioson/skills/design/clean-saas-ui/references/art-direction.md +319 -319
  704. package/template/.aioson/skills/design/clean-saas-ui/references/components.md +365 -365
  705. package/template/.aioson/skills/design/clean-saas-ui/references/dashboards.md +196 -196
  706. package/template/.aioson/skills/design/clean-saas-ui/references/design-tokens.md +244 -244
  707. package/template/.aioson/skills/design/clean-saas-ui/references/motion.md +235 -235
  708. package/template/.aioson/skills/design/clean-saas-ui/references/patterns.md +215 -215
  709. package/template/.aioson/skills/design/clean-saas-ui/references/websites.md +295 -295
  710. package/template/.aioson/skills/design/cognitive-core-ui/SKILL.md +203 -203
  711. package/template/.aioson/skills/design/cognitive-core-ui/references/art-direction.md +339 -339
  712. package/template/.aioson/skills/design/cognitive-core-ui/references/components.md +407 -407
  713. package/template/.aioson/skills/design/cognitive-core-ui/references/dashboards.md +272 -272
  714. package/template/.aioson/skills/design/cognitive-core-ui/references/design-tokens.md +524 -524
  715. package/template/.aioson/skills/design/cognitive-core-ui/references/motion.md +279 -279
  716. package/template/.aioson/skills/design/cognitive-core-ui/references/patterns.md +289 -289
  717. package/template/.aioson/skills/design/cognitive-core-ui/references/websites.md +437 -437
  718. package/template/.aioson/skills/design/glassmorphism-ui/SKILL.md +222 -222
  719. package/template/.aioson/skills/design/glassmorphism-ui/references/art-direction.md +159 -159
  720. package/template/.aioson/skills/design/glassmorphism-ui/references/components.md +498 -498
  721. package/template/.aioson/skills/design/glassmorphism-ui/references/dashboards.md +236 -236
  722. package/template/.aioson/skills/design/glassmorphism-ui/references/design-tokens.md +274 -274
  723. package/template/.aioson/skills/design/glassmorphism-ui/references/motion.md +355 -355
  724. package/template/.aioson/skills/design/glassmorphism-ui/references/patterns.md +198 -198
  725. package/template/.aioson/skills/design/glassmorphism-ui/references/websites.md +307 -307
  726. package/template/.aioson/skills/design/interface-design/SKILL.md +47 -47
  727. package/template/.aioson/skills/design/interface-design/references/components-and-states.md +105 -105
  728. package/template/.aioson/skills/design/interface-design/references/design-directions.md +101 -101
  729. package/template/.aioson/skills/design/interface-design/references/handoff-and-quality.md +71 -71
  730. package/template/.aioson/skills/design/interface-design/references/intent-and-domain.md +74 -74
  731. package/template/.aioson/skills/design/interface-design/references/tokens-and-depth.md +173 -173
  732. package/template/.aioson/skills/design/neo-brutalist-ui/SKILL.md +213 -213
  733. package/template/.aioson/skills/design/neo-brutalist-ui/references/art-direction.md +228 -228
  734. package/template/.aioson/skills/design/neo-brutalist-ui/references/components.md +855 -855
  735. package/template/.aioson/skills/design/neo-brutalist-ui/references/dashboards.md +334 -334
  736. package/template/.aioson/skills/design/neo-brutalist-ui/references/design-tokens.md +342 -342
  737. package/template/.aioson/skills/design/neo-brutalist-ui/references/motion.md +286 -286
  738. package/template/.aioson/skills/design/neo-brutalist-ui/references/patterns.md +458 -458
  739. package/template/.aioson/skills/design/neo-brutalist-ui/references/websites.md +723 -723
  740. package/template/.aioson/skills/design/premium-command-center-ui/SKILL.md +62 -62
  741. package/template/.aioson/skills/design/premium-command-center-ui/references/operations.md +74 -74
  742. package/template/.aioson/skills/design/premium-command-center-ui/references/patterns.md +116 -116
  743. package/template/.aioson/skills/design/premium-command-center-ui/references/validation.md +47 -47
  744. package/template/.aioson/skills/design/premium-command-center-ui/references/visual-system.md +215 -215
  745. package/template/.aioson/skills/design/pt.squarespace.com/.skill-meta.json +31 -31
  746. package/template/.aioson/skills/design/pt.squarespace.com/SKILL.md +66 -66
  747. package/template/.aioson/skills/design/pt.squarespace.com/references/components.md +368 -368
  748. package/template/.aioson/skills/design/pt.squarespace.com/references/design-tokens.md +150 -150
  749. package/template/.aioson/skills/design/pt.squarespace.com/references/motion.md +270 -270
  750. package/template/.aioson/skills/design/pt.squarespace.com/references/patterns.md +189 -189
  751. package/template/.aioson/skills/design/pt.squarespace.com/references/websites.md +165 -165
  752. package/template/.aioson/skills/design/warm-craft-ui/SKILL.md +209 -209
  753. package/template/.aioson/skills/design/warm-craft-ui/references/art-direction.md +324 -324
  754. package/template/.aioson/skills/design/warm-craft-ui/references/components.md +508 -508
  755. package/template/.aioson/skills/design/warm-craft-ui/references/dashboards.md +223 -223
  756. package/template/.aioson/skills/design/warm-craft-ui/references/design-tokens.md +374 -374
  757. package/template/.aioson/skills/design/warm-craft-ui/references/motion.md +356 -356
  758. package/template/.aioson/skills/design/warm-craft-ui/references/patterns.md +288 -288
  759. package/template/.aioson/skills/design/warm-craft-ui/references/websites.md +289 -289
  760. package/template/.aioson/skills/design-system/SKILL.md +92 -92
  761. package/template/.aioson/skills/design-system/components/SKILL.md +274 -274
  762. package/template/.aioson/skills/design-system/dashboards/SKILL.md +184 -184
  763. package/template/.aioson/skills/design-system/foundations/SKILL.md +250 -250
  764. package/template/.aioson/skills/design-system/motion/SKILL.md +197 -197
  765. package/template/.aioson/skills/design-system/patterns/SKILL.md +231 -231
  766. package/template/.aioson/skills/dynamic/README.md +30 -30
  767. package/template/.aioson/skills/dynamic/cardano-docs.md +16 -16
  768. package/template/.aioson/skills/dynamic/ethereum-docs.md +17 -17
  769. package/template/.aioson/skills/dynamic/flux-ui-docs.md +13 -13
  770. package/template/.aioson/skills/dynamic/laravel-docs.md +41 -41
  771. package/template/.aioson/skills/dynamic/npm-packages.md +16 -16
  772. package/template/.aioson/skills/dynamic/solana-docs.md +16 -16
  773. package/template/.aioson/skills/marketing/references/anti-patterns.md +254 -254
  774. package/template/.aioson/skills/marketing/references/cta-matrix.md +361 -0
  775. package/template/.aioson/skills/marketing/references/fascinations.md +192 -192
  776. package/template/.aioson/skills/marketing/references/five-acts.md +248 -248
  777. package/template/.aioson/skills/marketing/references/headline-matrix.md +358 -0
  778. package/template/.aioson/skills/marketing/references/market-intelligence.md +198 -198
  779. package/template/.aioson/skills/marketing/references/offer-structure.md +203 -203
  780. package/template/.aioson/skills/marketing/references/one-belief.md +149 -149
  781. package/template/.aioson/skills/marketing/references/patterns.md +218 -218
  782. package/template/.aioson/skills/marketing/references/platform-constraints.md +337 -0
  783. package/template/.aioson/skills/marketing/references/pms-research.md +193 -193
  784. package/template/.aioson/skills/marketing/vsl-craft.md +385 -385
  785. package/template/.aioson/skills/premium-visual-design/SKILL.md +83 -83
  786. package/template/.aioson/skills/premium-visual-design/components/agent-badge.md +92 -92
  787. package/template/.aioson/skills/premium-visual-design/components/dependency-node.md +102 -102
  788. package/template/.aioson/skills/premium-visual-design/components/mention-autocomplete.md +136 -136
  789. package/template/.aioson/skills/premium-visual-design/components/notification-center.md +136 -136
  790. package/template/.aioson/skills/premium-visual-design/components/review-action-bar.md +188 -188
  791. package/template/.aioson/skills/premium-visual-design/components/team-switcher.md +131 -131
  792. package/template/.aioson/skills/premium-visual-design/patterns/agent-message-thread.md +198 -198
  793. package/template/.aioson/skills/premium-visual-design/patterns/notification-panel.md +275 -275
  794. package/template/.aioson/skills/premium-visual-design/patterns/review-workflow-ui.md +234 -234
  795. package/template/.aioson/skills/premium-visual-design/patterns/task-dependency-graph.md +147 -147
  796. package/template/.aioson/skills/premium-visual-design/tokens/status-extended.md +142 -142
  797. package/template/.aioson/skills/process/aioson-spec-driven/SKILL.md +46 -46
  798. package/template/.aioson/skills/process/aioson-spec-driven/references/analyst.md +30 -30
  799. package/template/.aioson/skills/process/aioson-spec-driven/references/approval-gates.md +109 -109
  800. package/template/.aioson/skills/process/aioson-spec-driven/references/architect.md +23 -23
  801. package/template/.aioson/skills/process/aioson-spec-driven/references/artifact-map.md +44 -44
  802. package/template/.aioson/skills/process/aioson-spec-driven/references/classification-map.md +37 -37
  803. package/template/.aioson/skills/process/aioson-spec-driven/references/dev.md +47 -47
  804. package/template/.aioson/skills/process/aioson-spec-driven/references/deyvin.md +27 -27
  805. package/template/.aioson/skills/process/aioson-spec-driven/references/hardening-lane.md +49 -49
  806. package/template/.aioson/skills/process/aioson-spec-driven/references/maintenance-and-state.md +101 -101
  807. package/template/.aioson/skills/process/aioson-spec-driven/references/pm.md +30 -0
  808. package/template/.aioson/skills/process/aioson-spec-driven/references/product.md +25 -25
  809. package/template/.aioson/skills/process/aioson-spec-driven/references/qa.md +30 -30
  810. package/template/.aioson/skills/process/aioson-spec-driven/references/sheldon.md +25 -25
  811. package/template/.aioson/skills/process/aioson-spec-driven/references/ui-language.md +75 -75
  812. package/template/.aioson/skills/process/design-hybrid-forge/SKILL.md +147 -147
  813. package/template/.aioson/skills/process/design-hybrid-forge/references/crossover-protocol.md +221 -221
  814. package/template/.aioson/skills/process/design-hybrid-forge/references/naming-registry.md +88 -88
  815. package/template/.aioson/skills/process/design-hybrid-forge/references/output-contract.md +306 -306
  816. package/template/.aioson/skills/process/design-hybrid-forge/references/pair-compatibility.md +149 -149
  817. package/template/.aioson/skills/process/design-hybrid-forge/references/quality-gates.md +208 -208
  818. package/template/.aioson/skills/process/design-hybrid-forge/references/variation-library.md +125 -125
  819. package/template/.aioson/skills/process/secure-tdd/SKILL.md +97 -0
  820. package/template/.aioson/skills/process/simplify/SKILL.md +173 -173
  821. package/template/.aioson/skills/references/premium-command-center-ui/master-application-prompt.md +79 -79
  822. package/template/.aioson/skills/references/premium-command-center-ui/operational-ux-playbook.md +253 -253
  823. package/template/.aioson/skills/references/premium-command-center-ui/quality-validation-checklist.md +82 -82
  824. package/template/.aioson/skills/references/premium-command-center-ui/visual-system-and-component-patterns.md +270 -270
  825. package/template/.aioson/skills/squad/SKILL.md +58 -58
  826. package/template/.aioson/skills/squad/formats/catalog.json +15 -15
  827. package/template/.aioson/skills/squad/formats/content/blog-post.md +47 -47
  828. package/template/.aioson/skills/squad/formats/content/newsletter.md +47 -47
  829. package/template/.aioson/skills/squad/formats/creative/podcast-script.md +43 -43
  830. package/template/.aioson/skills/squad/formats/creative/video-script.md +41 -41
  831. package/template/.aioson/skills/squad/formats/social/instagram-feed.md +42 -42
  832. package/template/.aioson/skills/squad/formats/social/linkedin-post.md +42 -42
  833. package/template/.aioson/skills/squad/formats/social/tiktok.md +39 -39
  834. package/template/.aioson/skills/squad/formats/social/twitter-thread.md +39 -39
  835. package/template/.aioson/skills/squad/formats/social/youtube-long.md +47 -47
  836. package/template/.aioson/skills/squad/formats/social/youtube-shorts.md +39 -39
  837. package/template/.aioson/skills/squad/patterns/multi-platform-pattern.md +108 -108
  838. package/template/.aioson/skills/squad/patterns/persona-based-pattern.md +98 -98
  839. package/template/.aioson/skills/squad/patterns/pipeline-pattern.md +106 -106
  840. package/template/.aioson/skills/squad/patterns/review-loop-pattern.md +81 -81
  841. package/template/.aioson/skills/squad/references/checklist-templates.md +122 -122
  842. package/template/.aioson/skills/squad/references/executor-archetypes.md +123 -123
  843. package/template/.aioson/skills/squad/references/workflow-templates.md +169 -169
  844. package/template/.aioson/skills/static/context-budget-guide.md +46 -46
  845. package/template/.aioson/skills/static/debugging-protocol.md +42 -42
  846. package/template/.aioson/skills/static/django-patterns.md +342 -342
  847. package/template/.aioson/skills/static/fastapi-patterns.md +344 -344
  848. package/template/.aioson/skills/static/filament-patterns.md +267 -267
  849. package/template/.aioson/skills/static/flux-ui-components.md +262 -262
  850. package/template/.aioson/skills/static/git-conventions.md +227 -227
  851. package/template/.aioson/skills/static/git-worktrees.md +36 -36
  852. package/template/.aioson/skills/static/harness-sensors.md +74 -74
  853. package/template/.aioson/skills/static/harness-validate/SKILL.md +46 -0
  854. package/template/.aioson/skills/static/jetstream-setup.md +200 -200
  855. package/template/.aioson/skills/static/landing-page-deploy.md +192 -192
  856. package/template/.aioson/skills/static/landing-page-forge.md +730 -730
  857. package/template/.aioson/skills/static/laravel-conventions.md +491 -491
  858. package/template/.aioson/skills/static/multi-agent-patterns.md +43 -43
  859. package/template/.aioson/skills/static/nextjs-patterns.md +321 -321
  860. package/template/.aioson/skills/static/node-express-patterns.md +317 -317
  861. package/template/.aioson/skills/static/node-typescript-patterns.md +282 -282
  862. package/template/.aioson/skills/static/rails-conventions.md +307 -307
  863. package/template/.aioson/skills/static/react-motion-patterns.md +599 -599
  864. package/template/.aioson/skills/static/static-html-patterns/checklists.md +43 -43
  865. package/template/.aioson/skills/static/static-html-patterns/css-tokens.md +609 -609
  866. package/template/.aioson/skills/static/static-html-patterns/motion.md +193 -193
  867. package/template/.aioson/skills/static/static-html-patterns/premium.md +711 -711
  868. package/template/.aioson/skills/static/static-html-patterns/structure.md +209 -209
  869. package/template/.aioson/skills/static/static-html-patterns/utilities.md +190 -190
  870. package/template/.aioson/skills/static/static-html-patterns.md +80 -80
  871. package/template/.aioson/skills/static/tall-stack-patterns.md +286 -286
  872. package/template/.aioson/skills/static/threejs-patterns.md +929 -929
  873. package/template/.aioson/skills/static/ui-ux-modern.md +76 -76
  874. package/template/.aioson/skills/static/web-research-cache.md +115 -112
  875. package/template/.aioson/skills/static/web3-cardano-patterns.md +337 -337
  876. package/template/.aioson/skills/static/web3-ethereum-patterns.md +310 -310
  877. package/template/.aioson/skills/static/web3-security-checklist.md +284 -284
  878. package/template/.aioson/skills/static/web3-solana-patterns.md +324 -324
  879. package/template/.aioson/squads/memory.md +5 -5
  880. package/template/.aioson/tasks/implementation-plan.md +327 -327
  881. package/template/.aioson/tasks/squad-analyze.md +83 -83
  882. package/template/.aioson/tasks/squad-create.md +148 -121
  883. package/template/.aioson/tasks/squad-design.md +206 -158
  884. package/template/.aioson/tasks/squad-execution-plan.md +279 -279
  885. package/template/.aioson/tasks/squad-export.md +20 -20
  886. package/template/.aioson/tasks/squad-extend.md +68 -68
  887. package/template/.aioson/tasks/squad-investigate.md +57 -44
  888. package/template/.aioson/tasks/squad-learning-review.md +44 -44
  889. package/template/.aioson/tasks/squad-output-config.md +177 -177
  890. package/template/.aioson/tasks/squad-pipeline.md +122 -122
  891. package/template/.aioson/tasks/squad-profile.md +48 -48
  892. package/template/.aioson/tasks/squad-refresh.md +236 -0
  893. package/template/.aioson/tasks/squad-repair.md +85 -85
  894. package/template/.aioson/tasks/squad-review.md +61 -61
  895. package/template/.aioson/tasks/squad-task-decompose.md +66 -66
  896. package/template/.aioson/tasks/squad-validate.md +58 -58
  897. package/template/.aioson/templates/reflect-prompts/current-state.md +36 -0
  898. package/template/.aioson/templates/reflect-prompts/how-it-works.md +23 -0
  899. package/template/.aioson/templates/reflect-prompts/what-it-does.md +21 -0
  900. package/template/.aioson/templates/squads/content-basic/template.json +21 -21
  901. package/template/.aioson/templates/squads/digital-marketing-agency/template.json +96 -96
  902. package/template/.aioson/templates/squads/media-channel/template.json +24 -24
  903. package/template/.aioson/templates/squads/research-analysis/template.json +22 -22
  904. package/template/.aioson/templates/squads/software-delivery/template.json +21 -21
  905. package/template/.claude/commands/aioson/agent/analyst.md +5 -5
  906. package/template/.claude/commands/aioson/agent/architect.md +5 -5
  907. package/template/.claude/commands/aioson/agent/briefing.md +5 -0
  908. package/template/.claude/commands/aioson/agent/committer.md +5 -0
  909. package/template/.claude/commands/aioson/agent/copywriter.md +5 -0
  910. package/template/.claude/commands/aioson/agent/design-hybrid-forge.md +5 -5
  911. package/template/.claude/commands/aioson/agent/dev.md +5 -5
  912. package/template/.claude/commands/aioson/agent/deyvin.md +5 -5
  913. package/template/.claude/commands/aioson/agent/discover.md +5 -0
  914. package/template/.claude/commands/aioson/agent/discovery-design-doc.md +5 -5
  915. package/template/.claude/commands/aioson/agent/genome.md +5 -5
  916. package/template/.claude/commands/aioson/agent/neo.md +5 -5
  917. package/template/.claude/commands/aioson/agent/orache.md +5 -5
  918. package/template/.claude/commands/aioson/agent/orchestrator.md +5 -5
  919. package/template/.claude/commands/aioson/agent/pair.md +5 -0
  920. package/template/.claude/commands/aioson/agent/pentester.md +5 -0
  921. package/template/.claude/commands/aioson/agent/pm.md +5 -5
  922. package/template/.claude/commands/aioson/agent/product.md +5 -5
  923. package/template/.claude/commands/aioson/agent/profiler-enricher.md +5 -5
  924. package/template/.claude/commands/aioson/agent/profiler-forge.md +5 -5
  925. package/template/.claude/commands/aioson/agent/profiler-researcher.md +5 -5
  926. package/template/.claude/commands/aioson/agent/qa.md +5 -5
  927. package/template/.claude/commands/aioson/agent/setup.md +5 -5
  928. package/template/.claude/commands/aioson/agent/sheldon.md +5 -5
  929. package/template/.claude/commands/aioson/agent/site-forge.md +5 -5
  930. package/template/.claude/commands/aioson/agent/squad.md +5 -5
  931. package/template/.claude/commands/aioson/agent/tester.md +5 -5
  932. package/template/.claude/commands/aioson/agent/ux-ui.md +5 -5
  933. package/template/.claude/commands/aioson/agent/validator.md +5 -0
  934. package/template/.gemini/GEMINI.md +13 -13
  935. package/template/.gemini/commands/aios-analyst.toml +7 -4
  936. package/template/.gemini/commands/aios-architect.toml +8 -7
  937. package/template/.gemini/commands/aios-committer.toml +7 -0
  938. package/template/.gemini/commands/aios-copywriter.toml +7 -0
  939. package/template/.gemini/commands/aios-cypher.toml +7 -0
  940. package/template/.gemini/commands/aios-dev.toml +9 -8
  941. package/template/.gemini/commands/aios-deyvin.toml +7 -6
  942. package/template/.gemini/commands/aios-discover.toml +6 -0
  943. package/template/.gemini/commands/aios-discovery-design-doc.toml +7 -4
  944. package/template/.gemini/commands/aios-genome.toml +7 -0
  945. package/template/.gemini/commands/aios-neo.toml +6 -4
  946. package/template/.gemini/commands/aios-orache.toml +7 -0
  947. package/template/.gemini/commands/aios-orchestrator.toml +9 -8
  948. package/template/.gemini/commands/aios-pair.toml +7 -6
  949. package/template/.gemini/commands/aios-pm.toml +9 -8
  950. package/template/.gemini/commands/aios-product.toml +6 -4
  951. package/template/.gemini/commands/aios-qa.toml +7 -6
  952. package/template/.gemini/commands/aios-setup.toml +6 -3
  953. package/template/.gemini/commands/aios-sheldon.toml +7 -0
  954. package/template/.gemini/commands/aios-site-forge.toml +7 -0
  955. package/template/.gemini/commands/aios-squad.toml +7 -0
  956. package/template/.gemini/commands/aios-tester.toml +7 -6
  957. package/template/.gemini/commands/aios-ux-ui.toml +9 -8
  958. package/template/.gemini/commands/aios-validator.toml +7 -0
  959. package/template/AGENTS.md +184 -172
  960. package/template/CLAUDE.md +98 -93
  961. package/template/OPENCODE.md +35 -34
  962. package/template/aioson-models.json +40 -40
  963. package/docs/en/i18n.md +0 -52
  964. package/docs/en/schemas/parallel-status.schema.json +0 -94
  965. package/template/.aioson/genomes/copywriting.md +0 -204
  966. package/template/.aioson/locales/en/agents/analyst.md +0 -244
  967. package/template/.aioson/locales/en/agents/architect.md +0 -245
  968. package/template/.aioson/locales/en/agents/dev.md +0 -397
  969. package/template/.aioson/locales/en/agents/deyvin.md +0 -137
  970. package/template/.aioson/locales/en/agents/discovery-design-doc.md +0 -27
  971. package/template/.aioson/locales/en/agents/genome.md +0 -212
  972. package/template/.aioson/locales/en/agents/neo.md +0 -8
  973. package/template/.aioson/locales/en/agents/orache.md +0 -6
  974. package/template/.aioson/locales/en/agents/orchestrator.md +0 -189
  975. package/template/.aioson/locales/en/agents/pair.md +0 -5
  976. package/template/.aioson/locales/en/agents/pm.md +0 -84
  977. package/template/.aioson/locales/en/agents/product.md +0 -378
  978. package/template/.aioson/locales/en/agents/profiler-enricher.md +0 -5
  979. package/template/.aioson/locales/en/agents/profiler-forge.md +0 -5
  980. package/template/.aioson/locales/en/agents/profiler-researcher.md +0 -5
  981. package/template/.aioson/locales/en/agents/qa.md +0 -270
  982. package/template/.aioson/locales/en/agents/setup.md +0 -421
  983. package/template/.aioson/locales/en/agents/sheldon.md +0 -455
  984. package/template/.aioson/locales/en/agents/squad.md +0 -449
  985. package/template/.aioson/locales/en/agents/tester.md +0 -6
  986. package/template/.aioson/locales/en/agents/ux-ui.md +0 -668
  987. package/template/.aioson/locales/es/agents/analyst.md +0 -225
  988. package/template/.aioson/locales/es/agents/architect.md +0 -245
  989. package/template/.aioson/locales/es/agents/dev.md +0 -370
  990. package/template/.aioson/locales/es/agents/deyvin.md +0 -99
  991. package/template/.aioson/locales/es/agents/discovery-design-doc.md +0 -21
  992. package/template/.aioson/locales/es/agents/genome.md +0 -104
  993. package/template/.aioson/locales/es/agents/neo.md +0 -50
  994. package/template/.aioson/locales/es/agents/orache.md +0 -105
  995. package/template/.aioson/locales/es/agents/orchestrator.md +0 -194
  996. package/template/.aioson/locales/es/agents/pair.md +0 -7
  997. package/template/.aioson/locales/es/agents/pm.md +0 -90
  998. package/template/.aioson/locales/es/agents/product.md +0 -372
  999. package/template/.aioson/locales/es/agents/profiler-enricher.md +0 -7
  1000. package/template/.aioson/locales/es/agents/profiler-forge.md +0 -7
  1001. package/template/.aioson/locales/es/agents/profiler-researcher.md +0 -7
  1002. package/template/.aioson/locales/es/agents/qa.md +0 -198
  1003. package/template/.aioson/locales/es/agents/setup.md +0 -405
  1004. package/template/.aioson/locales/es/agents/sheldon.md +0 -309
  1005. package/template/.aioson/locales/es/agents/squad.md +0 -532
  1006. package/template/.aioson/locales/es/agents/tester.md +0 -9
  1007. package/template/.aioson/locales/es/agents/ux-ui.md +0 -212
  1008. package/template/.aioson/locales/fr/agents/analyst.md +0 -225
  1009. package/template/.aioson/locales/fr/agents/architect.md +0 -245
  1010. package/template/.aioson/locales/fr/agents/dev.md +0 -370
  1011. package/template/.aioson/locales/fr/agents/deyvin.md +0 -99
  1012. package/template/.aioson/locales/fr/agents/discovery-design-doc.md +0 -21
  1013. package/template/.aioson/locales/fr/agents/genome.md +0 -104
  1014. package/template/.aioson/locales/fr/agents/neo.md +0 -50
  1015. package/template/.aioson/locales/fr/agents/orache.md +0 -106
  1016. package/template/.aioson/locales/fr/agents/orchestrator.md +0 -194
  1017. package/template/.aioson/locales/fr/agents/pair.md +0 -7
  1018. package/template/.aioson/locales/fr/agents/pm.md +0 -90
  1019. package/template/.aioson/locales/fr/agents/product.md +0 -372
  1020. package/template/.aioson/locales/fr/agents/profiler-enricher.md +0 -7
  1021. package/template/.aioson/locales/fr/agents/profiler-forge.md +0 -7
  1022. package/template/.aioson/locales/fr/agents/profiler-researcher.md +0 -7
  1023. package/template/.aioson/locales/fr/agents/qa.md +0 -198
  1024. package/template/.aioson/locales/fr/agents/setup.md +0 -405
  1025. package/template/.aioson/locales/fr/agents/sheldon.md +0 -309
  1026. package/template/.aioson/locales/fr/agents/squad.md +0 -532
  1027. package/template/.aioson/locales/fr/agents/tester.md +0 -9
  1028. package/template/.aioson/locales/fr/agents/ux-ui.md +0 -212
  1029. package/template/.aioson/locales/pt-BR/agents/analyst.md +0 -319
  1030. package/template/.aioson/locales/pt-BR/agents/architect.md +0 -284
  1031. package/template/.aioson/locales/pt-BR/agents/dev.md +0 -483
  1032. package/template/.aioson/locales/pt-BR/agents/deyvin.md +0 -184
  1033. package/template/.aioson/locales/pt-BR/agents/discovery-design-doc.md +0 -198
  1034. package/template/.aioson/locales/pt-BR/agents/genome.md +0 -297
  1035. package/template/.aioson/locales/pt-BR/agents/neo.md +0 -208
  1036. package/template/.aioson/locales/pt-BR/agents/orache.md +0 -137
  1037. package/template/.aioson/locales/pt-BR/agents/orchestrator.md +0 -324
  1038. package/template/.aioson/locales/pt-BR/agents/pair.md +0 -5
  1039. package/template/.aioson/locales/pt-BR/agents/pm.md +0 -182
  1040. package/template/.aioson/locales/pt-BR/agents/product.md +0 -466
  1041. package/template/.aioson/locales/pt-BR/agents/profiler-enricher.md +0 -5
  1042. package/template/.aioson/locales/pt-BR/agents/profiler-forge.md +0 -5
  1043. package/template/.aioson/locales/pt-BR/agents/profiler-researcher.md +0 -5
  1044. package/template/.aioson/locales/pt-BR/agents/qa.md +0 -300
  1045. package/template/.aioson/locales/pt-BR/agents/setup.md +0 -533
  1046. package/template/.aioson/locales/pt-BR/agents/sheldon.md +0 -323
  1047. package/template/.aioson/locales/pt-BR/agents/squad.md +0 -1330
  1048. package/template/.aioson/locales/pt-BR/agents/tester.md +0 -449
  1049. package/template/.aioson/locales/pt-BR/agents/ux-ui.md +0 -669
package/template/.aioson/skills/static/threejs-patterns.md CHANGED
@@ -1,929 +1,929 @@
1
- # Three.js Patterns — WebGL Landing Page Production Guide
2
-
3
- > Read this skill when the user explicitly asks for 3D, WebGL, particles, Three.js scenes,
4
- > holographic effects, or spatial visuals. This is on-demand — never auto-loaded.
5
- > CDN-only. No build step. No npm install required for basic patterns.
6
-
7
- ---
8
-
9
- ## When to apply this skill
10
-
11
- Apply this skill when the user requests:
12
- - "3D", "WebGL", "three.js", "Three.js"
13
- - "partículas", "particles", "sistema de partículas"
14
- - "cena 3D", "3D scene", "objeto 3D interativo"
15
- - "holográfico", "holographic", "hologram effect"
16
- - "floating 3D", "3D objects", "interactive 3D"
17
- - "hero 3D", "3D background", "particle background"
18
- - `design_skill: threejs-spatial` set in `project.context.md`
19
- - Three.js as a hybrid modifier in `@design-hybrid-forge`
20
-
21
- Do NOT apply this skill for: card tilt CSS, scroll reveals, gradient text, or any
22
- pattern already covered by `static-html-patterns.md`. Those are CSS-only and faster.
23
-
24
- **Stack rule:** This skill produces standalone `index.html` with CDN imports.
25
- For React/Vue/Next.js projects, adapt the patterns to framework conventions
26
- (React Three Fiber, TresJS, etc.) — the visual outcome is the same.
27
-
28
- ---
29
-
30
- ## Dependencies — CDN-only (no npm)
31
-
32
- ```html
33
- <!-- Importmap for clean ES module imports -->
34
- <script type="importmap">
35
- {
36
- "imports": {
37
- "three": "https://unpkg.com/three@0.160.0/build/three.module.js",
38
- "three/addons/": "https://unpkg.com/three@0.160.0/examples/jsm/"
39
- }
40
- }
41
- </script>
42
-
43
- <!-- OrbitControls (optional, for interactive scenes) -->
44
- <script type="module">
45
- import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
46
- </script>
47
-
48
- <!-- No GSAP needed — Three.js has its own animation system via requestAnimationFrame -->
49
- ```
50
-
51
- ---
52
-
53
- ## Performance Rules
54
-
55
- 1. **Always check WebGL support first** — fallback to CSS aurora gradient if unavailable
56
- 2. **`prefers-reduced-motion: reduce`** — skip entire canvas, show static image or CSS fallback
57
- 3. **Mobile: reduced particle count** — detect mobile, cut particles to 30% of desktop
58
- 4. **Lazy initialization** — don't init the renderer until the canvas is in viewport
59
- 5. **Dispose on unmount** — always call `renderer.dispose()` and dispose geometries/materials/textures
60
- 6. **Use `IntersectionObserver`** — only run render loop when canvas is visible
61
-
62
- ---
63
-
64
- ## 1. Particle Aurora Hero Background
65
-
66
- **For:** Bold & Cinematic hero sections, crypto/AI/SaaS landing pages
67
- **Complexity:** Low. ~80 lines of JS. Works on mobile with reduced count.
68
- **Visual:** 3,000–8,000 particles drifting in aurora gradient colors, responding subtly to mouse.
69
-
70
- ```html
71
- <!DOCTYPE html>
72
- <html lang="en">
73
- <head>
74
- <meta charset="UTF-8">
75
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
76
- <title>Product — Hero</title>
77
- <style>
78
- *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
79
- html, body { width: 100%; height: 100%; overflow: hidden; }
80
- body { background: #060910; font-family: system-ui, sans-serif; }
81
-
82
- #hero-canvas {
83
- position: fixed;
84
- inset: 0;
85
- width: 100%;
86
- height: 100%;
87
- z-index: 0;
88
- }
89
-
90
- .hero-content {
91
- position: relative;
92
- z-index: 10;
93
- display: flex;
94
- flex-direction: column;
95
- align-items: center;
96
- justify-content: center;
97
- height: 100vh;
98
- text-align: center;
99
- color: #f0f4ff;
100
- }
101
-
102
- .hero-content h1 {
103
- font-size: clamp(2.5rem, 8vw, 5rem);
104
- font-weight: 800;
105
- letter-spacing: -0.03em;
106
- line-height: 1.1;
107
- max-width: 900px;
108
- padding: 0 2rem;
109
- }
110
-
111
- .hero-content p {
112
- font-size: clamp(1rem, 2.5vw, 1.25rem);
113
- color: rgba(240, 244, 255, 0.7);
114
- margin-top: 1.5rem;
115
- max-width: 540px;
116
- padding: 0 2rem;
117
- }
118
-
119
- .hero-cta {
120
- margin-top: 2.5rem;
121
- display: flex;
122
- gap: 1rem;
123
- }
124
-
125
- .hero-cta a {
126
- padding: 0.875rem 2rem;
127
- border-radius: 8px;
128
- font-weight: 600;
129
- font-size: 1rem;
130
- text-decoration: none;
131
- transition: transform 150ms ease, box-shadow 150ms ease;
132
- }
133
-
134
- .hero-cta a:hover {
135
- transform: translateY(-2px);
136
- }
137
-
138
- .btn-primary {
139
- background: linear-gradient(135deg, #00C8E8, #7C3AED);
140
- color: #fff;
141
- box-shadow: 0 4px 20px rgba(0, 200, 232, 0.3);
142
- }
143
-
144
- .btn-ghost {
145
- background: rgba(255, 255, 255, 0.08);
146
- color: #f0f4ff;
147
- border: 1px solid rgba(255, 255, 255, 0.15);
148
- backdrop-filter: blur(8px);
149
- }
150
-
151
- @media (prefers-reduced-motion: reduce) {
152
- #hero-canvas { display: none; }
153
- body { background: linear-gradient(135deg, #060910 0%, #0A0818 30%, #060C1A 70%, #08060F 100%); }
154
- }
155
- </style>
156
- </head>
157
- <body>
158
-
159
- <canvas id="hero-canvas"></canvas>
160
-
161
- <section class="hero-content">
162
- <h1>Bold Headline That <em style="background: linear-gradient(135deg, #00C8E8, #7C3AED); -webkit-background-clip: text; -webkit-text-fill-color: transparent;">Changes Everything</em></h1>
163
- <p>Supporting text that adds real context — who benefits, how fast, what outcome.</p>
164
- <div class="hero-cta">
165
- <a href="#cta" class="btn-primary">Get started</a>
166
- <a href="#features" class="btn-ghost">Learn more</a>
167
- </div>
168
- </section>
169
-
170
- <script type="importmap">
171
- {
172
- "imports": {
173
- "three": "https://unpkg.com/three@0.160.0/build/three.module.js"
174
- }
175
- }
176
- </script>
177
-
178
- <script type="module">
179
- import * as THREE from 'three';
180
-
181
- // ─── WebGL Support Check ───────────────────────────────────────────────────
182
- const canvas = document.getElementById('hero-canvas');
183
- const gl = canvas.getContext('webgl') || canvas.getContext('webgl2');
184
- if (!gl) {
185
- canvas.style.display = 'none';
186
- document.body.style.background = 'linear-gradient(135deg, #060910 0%, #0A0818 30%, #060C1A 70%, #08060F 100%)';
187
- }
188
-
189
- // ─── prefers-reduced-motion ───────────────────────────────────────────────
190
- const prefersReducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
191
- if (prefersReducedMotion) {
192
- canvas.style.display = 'none';
193
- document.body.style.background = 'linear-gradient(135deg, #060910 0%, #0A0818 30%, #060C1A 70%, #08060F 100%)';
194
- }
195
-
196
- // ─── Scene Setup ─────────────────────────────────────────────────────────
197
- const scene = new THREE.Scene();
198
- const camera = new THREE.PerspectiveCamera(75, window.innerWidth / window.innerHeight, 0.1, 1000);
199
- camera.position.z = 50;
200
-
201
- const renderer = new THREE.WebGLRenderer({
202
- canvas,
203
- alpha: true,
204
- antialias: true,
205
- powerPreference: 'high-performance'
206
- });
207
- renderer.setSize(window.innerWidth, window.innerHeight);
208
- renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
209
- renderer.setClearColor(0x000000, 0);
210
-
211
- // ─── Particles ────────────────────────────────────────────────────────────
212
- const isMobile = /iPhone|iPad|iPod|Android/i.test(navigator.userAgent);
213
- const PARTICLE_COUNT = isMobile ? 1500 : 6000;
214
-
215
- const geometry = new THREE.BufferGeometry();
216
- const positions = new Float32Array(PARTICLE_COUNT * 3);
217
- const colors = new Float32Array(PARTICLE_COUNT * 3);
218
- const sizes = new Float32Array(PARTICLE_COUNT);
219
-
220
- // Aurora colors: teal (#00C8E8), violet (#7C3AED), blue (#3B82F6), pink (#EC4899)
221
- const palette = [
222
- new THREE.Color('#00C8E8'),
223
- new THREE.Color('#7C3AED'),
224
- new THREE.Color('#3B82F6'),
225
- new THREE.Color('#06B6D4'),
226
- new THREE.Color('#8B5CF6'),
227
- ];
228
-
229
- for (let i = 0; i < PARTICLE_COUNT; i++) {
230
- positions[i * 3] = (Math.random() - 0.5) * 120;
231
- positions[i * 3 + 1] = (Math.random() - 0.5) * 80;
232
- positions[i * 3 + 2] = (Math.random() - 0.5) * 60;
233
-
234
- const color = palette[Math.floor(Math.random() * palette.length)];
235
- colors[i * 3] = color.r;
236
- colors[i * 3 + 1] = color.g;
237
- colors[i * 3 + 2] = color.b;
238
-
239
- sizes[i] = Math.random() * 0.8 + 0.2;
240
- }
241
-
242
- geometry.setAttribute('position', new THREE.BufferAttribute(positions, 3));
243
- geometry.setAttribute('color', new THREE.BufferAttribute(colors, 3));
244
- geometry.setAttribute('size', new THREE.BufferAttribute(sizes, 1));
245
-
246
- // ─── Shader Material ─────────────────────────────────────────────────────
247
- const vertexShader = `
248
- attribute float size;
249
- varying vec3 vColor;
250
-
251
- void main() {
252
- vColor = color;
253
- vec4 mvPosition = modelViewMatrix * vec4(position, 1.0);
254
- gl_PointSize = size * (300.0 / -mvPosition.z);
255
- gl_Position = projectionMatrix * mvPosition;
256
- }
257
- `;
258
-
259
- const fragmentShader = `
260
- varying vec3 vColor;
261
-
262
- void main() {
263
- float dist = length(gl_PointCoord - vec2(0.5));
264
- if (dist > 0.5) discard;
265
- float alpha = 1.0 - smoothstep(0.2, 0.5, dist);
266
- gl_FragColor = vec4(vColor, alpha * 0.8);
267
- }
268
- `;
269
-
270
- const material = new THREE.ShaderMaterial({
271
- uniforms: {
272
- uTime: { value: 0 },
273
- },
274
- vertexShader,
275
- fragmentShader,
276
- transparent: true,
277
- vertexColors: true,
278
- depthWrite: false,
279
- blending: THREE.AdditiveBlending,
280
- });
281
-
282
- const points = new THREE.Points(geometry, material);
283
- scene.add(points);
284
-
285
- // ─── Mouse Interaction ────────────────────────────────────────────────────
286
- const mouse = new THREE.Vector2(0, 0);
287
- const targetMouse = new THREE.Vector2(0, 0);
288
-
289
- document.addEventListener('mousemove', (e) => {
290
- targetMouse.x = (e.clientX / window.innerWidth) * 2 - 1;
291
- targetMouse.y = -(e.clientY / window.innerHeight) * 2 + 1;
292
- });
293
-
294
- // ─── Animation Loop ───────────────────────────────────────────────────────
295
- const clock = new THREE.Clock();
296
- let animFrameId = null;
297
-
298
- function animate() {
299
- if (prefersReducedMotion) return;
300
-
301
- animFrameId = requestAnimationFrame(animate);
302
-
303
- const elapsed = clock.getElapsedTime();
304
-
305
- // Smooth mouse follow
306
- mouse.x += (targetMouse.x - mouse.x) * 0.02;
307
- mouse.y += (targetMouse.y - mouse.y) * 0.02;
308
-
309
- // Particle drift
310
- const positions = geometry.attributes.position.array;
311
- for (let i = 0; i < PARTICLE_COUNT; i++) {
312
- positions[i * 3 + 1] += Math.sin(elapsed * 0.3 + i * 0.01) * 0.01;
313
- positions[i * 3] += Math.cos(elapsed * 0.2 + i * 0.005) * 0.008;
314
- }
315
- geometry.attributes.position.needsUpdate = true;
316
-
317
- // Camera sway (subtle)
318
- camera.position.x = mouse.x * 3;
319
- camera.position.y = mouse.y * 2;
320
- camera.lookAt(scene.position);
321
-
322
- // Particle rotation (very slow)
323
- points.rotation.y = elapsed * 0.02;
324
- points.rotation.x = Math.sin(elapsed * 0.1) * 0.05;
325
-
326
- material.uniforms.uTime.value = elapsed;
327
- renderer.render(scene, camera);
328
- }
329
-
330
- // ─── VisibilityObserver: only run when in viewport ─────────────────────
331
- const observer = new IntersectionObserver((entries) => {
332
- entries.forEach(entry => {
333
- if (entry.isIntersecting) {
334
- if (!animFrameId) animate();
335
- } else {
336
- cancelAnimationFrame(animFrameId);
337
- animFrameId = null;
338
- }
339
- });
340
- }, { threshold: 0 });
341
- observer.observe(canvas);
342
-
343
- // ─── Resize Handler ───────────────────────────────────────────────────────
344
- window.addEventListener('resize', () => {
345
- camera.aspect = window.innerWidth / window.innerHeight;
346
- camera.updateProjectionMatrix();
347
- renderer.setSize(window.innerWidth, window.innerHeight);
348
- });
349
-
350
- // ─── Cleanup on page unload ───────────────────────────────────────────────
351
- window.addEventListener('beforeunload', () => {
352
- renderer.dispose();
353
- geometry.dispose();
354
- material.dispose();
355
- });
356
- </script>
357
- </body>
358
- </html>
359
- ```
360
-
361
- ---
362
-
363
- ## 2. Interactive 3D Object Showcase
364
-
365
- **For:** Product features, 3D product display, interactive demos
366
- **Complexity:** Medium. ~120 lines of JS. Includes OrbitControls.
367
- **Visual:** A single 3D object (torus knot, icosahedron, or custom geometry) that the user can drag to rotate. Hover highlights with glow.
368
-
369
- ```html
370
- <!-- In your landing page, after the hero section -->
371
- <section class="showcase-3d" id="showcase">
372
- <div class="showcase-container">
373
- <canvas id="showcase-canvas"></canvas>
374
- <div class="showcase-content">
375
- <span class="section-label">Interactive</span>
376
- <h2>Explore the architecture</h2>
377
- <p>Drag to rotate. Scroll to zoom. Every detail rendered in real-time 3D.</p>
378
- </div>
379
- </div>
380
- </section>
381
-
382
- <style>
383
- .showcase-3d { min-height: 100vh; display: flex; align-items: center; justify-content: center; }
384
- .showcase-container { display: grid; grid-template-columns: 1fr 1fr; gap: 4rem; align-items: center; max-width: 1200px; margin: 0 auto; padding: 4rem 2rem; }
385
- #showcase-canvas { width: 100%; height: 500px; border-radius: 16px; background: transparent; cursor: grab; }
386
- #showcase-canvas:active { cursor: grabbing; }
387
- .showcase-content h2 { font-size: clamp(1.75rem, 4vw, 2.5rem); font-weight: 700; letter-spacing: -0.02em; }
388
- .showcase-content p { margin-top: 1rem; color: rgba(240,244,255,0.65); line-height: 1.7; }
389
- @media (max-width: 768px) { .showcase-container { grid-template-columns: 1fr; } }
390
- @media (prefers-reduced-motion: reduce) { #showcase-canvas { display: none; } }
391
- </style>
392
-
393
- <script type="importmap">
394
- {
395
- "imports": {
396
- "three": "https://unpkg.com/three@0.160.0/build/three.module.js",
397
- "three/addons/": "https://unpkg.com/three@0.160.0/examples/jsm/"
398
- }
399
- }
400
- </script>
401
-
402
- <script type="module">
403
- import * as THREE from 'three';
404
- import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
405
- import { EffectComposer } from 'three/addons/postprocessing/EffectComposer.js';
406
- import { RenderPass } from 'three/addons/postprocessing/RenderPass.js';
407
- import { UnrealBloomPass } from 'three/addons/postprocessing/UnrealBloomPass.js';
408
-
409
- const canvas = document.getElementById('showcase-canvas');
410
- const gl = canvas.getContext('webgl') || canvas.getContext('webgl2');
411
- if (!gl || window.matchMedia('(prefers-reduced-motion: reduce)').matches) {
412
- canvas.style.display = 'none';
413
- }
414
-
415
- // Scene
416
- const scene = new THREE.Scene();
417
- const camera = new THREE.PerspectiveCamera(45, canvas.clientWidth / canvas.clientHeight, 0.1, 100);
418
- camera.position.set(0, 0, 6);
419
-
420
- const renderer = new THREE.WebGLRenderer({ canvas, alpha: true, antialias: true });
421
- renderer.setSize(canvas.clientWidth, canvas.clientHeight);
422
- renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
423
- renderer.setClearColor(0x000000, 0);
424
- renderer.toneMapping = THREE.ACESFilmicToneMapping;
425
- renderer.toneMappingExposure = 1.2;
426
-
427
- // Bloom post-processing
428
- const composer = new EffectComposer(renderer);
429
- composer.addPass(new RenderPass(scene, camera));
430
- const bloomPass = new UnrealBloomPass(
431
- new THREE.Vector2(canvas.clientWidth, canvas.clientHeight),
432
- 0.8, 0.4, 0.85
433
- );
434
- composer.addPass(bloomPass);
435
-
436
- // Object: TorusKnot with glass-like material
437
- const geometry = new THREE.TorusKnotGeometry(1.5, 0.4, 128, 32, 2, 3);
438
- const material = new THREE.MeshPhysicalMaterial({
439
- color: new THREE.Color('#00C8E8'),
440
- metalness: 0.1,
441
- roughness: 0.1,
442
- transmission: 0.6,
443
- thickness: 1.5,
444
- envMapIntensity: 1,
445
- clearcoat: 1,
446
- clearcoatRoughness: 0.1,
447
- transparent: true,
448
- opacity: 0.9,
449
- });
450
- const mesh = new THREE.Mesh(geometry, material);
451
- scene.add(mesh);
452
-
453
- // Lights
454
- const ambientLight = new THREE.AmbientLight(0xffffff, 0.5);
455
- scene.add(ambientLight);
456
-
457
- const pointLight1 = new THREE.PointLight(0x00C8E8, 2, 50);
458
- pointLight1.position.set(5, 5, 5);
459
- scene.add(pointLight1);
460
-
461
- const pointLight2 = new THREE.PointLight(0x7C3AED, 2, 50);
462
- pointLight2.position.set(-5, -5, 5);
463
- scene.add(pointLight2);
464
-
465
- // OrbitControls
466
- const controls = new OrbitControls(camera, renderer.domElement);
467
- controls.enableDamping = true;
468
- controls.dampingFactor = 0.05;
469
- controls.enableZoom = true;
470
- controls.enablePan = false;
471
- controls.minDistance = 3;
472
- controls.maxDistance = 10;
473
- controls.autoRotate = true;
474
- controls.autoRotateSpeed = 0.8;
475
-
476
- // Subtle float animation
477
- const clock = new THREE.Clock();
478
- function animate() {
479
- requestAnimationFrame(animate);
480
- const elapsed = clock.getElapsedTime();
481
- mesh.position.y = Math.sin(elapsed * 0.5) * 0.15;
482
- controls.update();
483
- composer.render();
484
- }
485
-
486
- // Only start when visible
487
- const observer = new IntersectionObserver((entries) => {
488
- entries.forEach(entry => {
489
- if (entry.isIntersecting) {
490
- animate();
491
- observer.disconnect();
492
- }
493
- });
494
- }, { threshold: 0.1 });
495
- observer.observe(canvas);
496
-
497
- window.addEventListener('resize', () => {
498
- const w = canvas.clientWidth;
499
- const h = canvas.clientHeight;
500
- camera.aspect = w / h;
501
- camera.updateProjectionMatrix();
502
- renderer.setSize(w, h);
503
- composer.setSize(w, h);
504
- });
505
- </script>
506
- ```
507
-
508
- ---
509
-
510
- ## 3. Scroll-Driven 3D Parallax Layers
511
-
512
- **For:** Landing pages where scrolling moves the camera through a 3D scene
513
- **Complexity:** Medium. Uses scroll event + camera interpolation.
514
- **Visual:** Multiple 3D planes positioned at different depths scroll at different rates.
515
-
516
- ```html
517
- <section class="parallax-3d-section" id="features-3d">
518
- <canvas id="parallax-canvas"></canvas>
519
-
520
- <div class="parallax-content" data-depth="0.1">
521
- <h2>First Feature</h2>
522
- <p>Content that moves with the scene.</p>
523
- </div>
524
-
525
- <div class="parallax-content" data-depth="0.3">
526
- <h2>Second Feature</h2>
527
- <p>Deeper layer, moves faster.</p>
528
- </div>
529
-
530
- <div class="parallax-content" data-depth="0.6">
531
- <h2>Third Feature</h2>
532
- <p>Closest layer, fastest parallax.</p>
533
- </div>
534
- </section>
535
-
536
- <script type="importmap">{ "imports": { "three": "https://unpkg.com/three@0.160.0/build/three.module.js" } }</script>
537
-
538
- <script type="module">
539
- import * as THREE from 'three';
540
-
541
- const canvas = document.getElementById('parallax-canvas');
542
- if (!canvas.getContext('webgl') || window.matchMedia('(prefers-reduced-motion: reduce)').matches) {
543
- canvas.style.display = 'none';
544
- }
545
-
546
- const scene = new THREE.Scene();
547
- const camera = new THREE.PerspectiveCamera(60, window.innerWidth / window.innerHeight, 0.1, 1000);
548
- camera.position.z = 50;
549
-
550
- const renderer = new THREE.WebGLRenderer({ canvas, alpha: true, antialias: true });
551
- renderer.setSize(window.innerWidth, window.innerHeight);
552
- renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
553
- renderer.setClearColor(0x000000, 0);
554
-
555
- // Background particles (stars)
556
- const starGeometry = new THREE.BufferGeometry();
557
- const starCount = 2000;
558
- const starPositions = new Float32Array(starCount * 3);
559
- for (let i = 0; i < starCount * 3; i++) {
560
- starPositions[i] = (Math.random() - 0.5) * 200;
561
- }
562
- starGeometry.setAttribute('position', new THREE.BufferAttribute(starPositions, 3));
563
- const starMaterial = new THREE.PointsMaterial({ color: 0xffffff, size: 0.15, transparent: true, opacity: 0.6 });
564
- const stars = new THREE.Points(starGeometry, starMaterial);
565
- scene.add(stars);
566
-
567
- // Scroll-driven camera + parallax layers
568
- const scrollContainer = document.getElementById('features-3d');
569
- const parallaxElements = document.querySelectorAll('.parallax-content');
570
- let scrollProgress = 0;
571
-
572
- window.addEventListener('scroll', () => {
573
- const rect = scrollContainer.getBoundingClientRect();
574
- const viewportHeight = window.innerHeight;
575
- scrollProgress = Math.max(0, Math.min(1, -rect.top / (rect.height - viewportHeight)));
576
- }, { passive: true });
577
-
578
- const clock = new THREE.Clock();
579
- let parallaxFrameId = null;
580
-
581
- function animate() {
582
- parallaxFrameId = requestAnimationFrame(animate);
583
-
584
- // Camera moves forward on scroll
585
- camera.position.z = 50 - scrollProgress * 30;
586
- camera.position.x = Math.sin(scrollProgress * Math.PI) * 5;
587
-
588
- // Parallax layers
589
- parallaxElements.forEach(el => {
590
- const depth = parseFloat(el.dataset.depth);
591
- el.style.transform = `translateY(${-scrollProgress * 100 * depth}px)`;
592
- });
593
-
594
- // Stars drift
595
- stars.rotation.y = scrollProgress * 0.3;
596
- stars.rotation.x = clock.getElapsedTime() * 0.01;
597
-
598
- renderer.render(scene, camera);
599
- }
600
-
601
- // Only run when section is in viewport
602
- const parallaxObserver = new IntersectionObserver((entries) => {
603
- entries.forEach(entry => {
604
- if (entry.isIntersecting) {
605
- if (!parallaxFrameId) animate();
606
- } else {
607
- cancelAnimationFrame(parallaxFrameId);
608
- parallaxFrameId = null;
609
- }
610
- });
611
- }, { threshold: 0 });
612
- parallaxObserver.observe(document.getElementById('features-3d'));
613
-
614
- window.addEventListener('resize', () => {
615
- camera.aspect = window.innerWidth / window.innerHeight;
616
- camera.updateProjectionMatrix();
617
- renderer.setSize(window.innerWidth, window.innerHeight);
618
- });
619
- </script>
620
-
621
- <style>
622
- .parallax-3d-section { position: relative; height: 300vh; background: #060910; overflow: hidden; }
623
- #parallax-canvas { position: sticky; top: 0; width: 100%; height: 100vh; z-index: 0; }
624
- .parallax-content {
625
- position: relative;
626
- z-index: 10;
627
- padding: 4rem 2rem;
628
- max-width: 600px;
629
- margin: 0 auto;
630
- text-align: center;
631
- color: #f0f4ff;
632
- }
633
- .parallax-content h2 { font-size: 2rem; font-weight: 700; }
634
- .parallax-content p { color: rgba(240,244,255,0.65); margin-top: 0.75rem; }
635
- </style>
636
- ```
637
-
638
- ---
639
-
640
- ## 4. Holographic Glass Object
641
-
642
- **For:** Premium dashboards, futuristic product pages, tech/SaaS
643
- **Complexity:** Medium. Uses MeshPhysicalMaterial transmission + bloom.
644
- **Visual:** A glass-like 3D object with holographic iridescence, floating in space.
645
-
646
- ```html
647
- <canvas id="holo-canvas"></canvas>
648
-
649
- <script type="importmap">
650
- {
651
- "imports": {
652
- "three": "https://unpkg.com/three@0.160.0/build/three.module.js",
653
- "three/addons/": "https://unpkg.com/three@0.160.0/examples/jsm/"
654
- }
655
- }
656
- </script>
657
-
658
- <script type="module">
659
- import * as THREE from 'three';
660
- import { EffectComposer } from 'three/addons/postprocessing/EffectComposer.js';
661
- import { RenderPass } from 'three/addons/postprocessing/RenderPass.js';
662
- import { UnrealBloomPass } from 'three/addons/postprocessing/UnrealBloomPass.js';
663
-
664
- const canvas = document.getElementById('holo-canvas');
665
- const prefersReducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
666
-
667
- if (!canvas.getContext('webgl') || prefersReducedMotion) {
668
- canvas.style.display = 'none';
669
- document.body.style.background = 'linear-gradient(135deg, #060910, #0A0818)';
670
- }
671
-
672
- // Scene
673
- const scene = new THREE.Scene();
674
- const camera = new THREE.PerspectiveCamera(45, window.innerWidth / window.innerHeight, 0.1, 100);
675
- camera.position.set(0, 0, 6);
676
-
677
- const renderer = new THREE.WebGLRenderer({ canvas, alpha: true, antialias: true });
678
- renderer.setSize(window.innerWidth, window.innerHeight);
679
- renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
680
- renderer.toneMapping = THREE.ACESFilmicToneMapping;
681
- renderer.toneMappingExposure = 1.3;
682
-
683
- // Bloom
684
- const composer = new EffectComposer(renderer);
685
- composer.addPass(new RenderPass(scene, camera));
686
- const bloomPass = new UnrealBloomPass(
687
- new THREE.Vector2(window.innerWidth, window.innerHeight), 1.2, 0.5, 0.7
688
- );
689
- composer.addPass(bloomPass);
690
-
691
- // Holographic material
692
- const holoMaterial = new THREE.MeshPhysicalMaterial({
693
- color: new THREE.Color('#00C8E8'),
694
- metalness: 0.9,
695
- roughness: 0.05,
696
- transmission: 0.4,
697
- thickness: 0.5,
698
- envMapIntensity: 2,
699
- clearcoat: 1,
700
- clearcoatRoughness: 0.05,
701
- iridescence: 1,
702
- iridescenceIOR: 1.5,
703
- iridescenceThicknessRange: [100, 400],
704
- transparent: true,
705
- opacity: 0.85,
706
- });
707
-
708
- // Object: Icosahedron
709
- const geometry = new THREE.IcosahedronGeometry(1.8, 1);
710
- const mesh = new THREE.Mesh(geometry, holoMaterial);
711
- scene.add(mesh);
712
-
713
- // Wireframe overlay
714
- const wireframeMaterial = new THREE.MeshBasicMaterial({
715
- color: new THREE.Color('#00C8E8'),
716
- wireframe: true,
717
- transparent: true,
718
- opacity: 0.15,
719
- });
720
- const wireframe = new THREE.Mesh(geometry, wireframeMaterial);
721
- mesh.add(wireframe);
722
-
723
- // Lights
724
- scene.add(new THREE.AmbientLight(0xffffff, 0.3));
725
- const light1 = new THREE.PointLight(0x00C8E8, 3, 20);
726
- light1.position.set(3, 3, 3);
727
- scene.add(light1);
728
- const light2 = new THREE.PointLight(0x7C3AED, 3, 20);
729
- light2.position.set(-3, -3, 3);
730
- scene.add(light2);
731
-
732
- // Mouse interaction (rotation)
733
- const mouse = new THREE.Vector2(0, 0);
734
- document.addEventListener('mousemove', (e) => {
735
- mouse.x = (e.clientX / window.innerWidth) * 2 - 1;
736
- mouse.y = -(e.clientY / window.innerHeight) * 2 + 1;
737
- }, { passive: true });
738
-
739
- const clock = new THREE.Clock();
740
- function animate() {
741
- requestAnimationFrame(animate);
742
- const elapsed = clock.getElapsedTime();
743
-
744
- mesh.rotation.x = elapsed * 0.15 + mouse.y * 0.3;
745
- mesh.rotation.y = elapsed * 0.2 + mouse.x * 0.5;
746
-
747
- // Pulse the iridescence via thickness range
748
- const pulse = 200 + Math.sin(elapsed * 2) * 100;
749
- holoMaterial.iridescenceThicknessRange = [pulse * 0.5, pulse];
750
- holoMaterial.needsUpdate = true;
751
-
752
- composer.render();
753
- }
754
- animate();
755
-
756
- window.addEventListener('resize', () => {
757
- camera.aspect = window.innerWidth / window.innerHeight;
758
- camera.updateProjectionMatrix();
759
- renderer.setSize(window.innerWidth, window.innerHeight);
760
- composer.setSize(window.innerWidth, window.innerHeight);
761
- });
762
- </script>
763
-
764
- <style>
765
- #holo-canvas { position: fixed; inset: 0; width: 100%; height: 100%; z-index: 0; }
766
- body > *:not(#holo-canvas) { position: relative; z-index: 10; }
767
- </style>
768
- ```
769
-
770
- ---
771
-
772
- ## 5. Floating Object Array (Dashboard Cards as 3D Objects)
773
-
774
- **For:** Premium command centers, product showcases, animated dashboard cards
775
- **Complexity:** Medium-High. Multiple meshes with individual animations.
776
- **Visual:** A grid of floating cards (as thin 3D boxes) that drift and respond to mouse.
777
-
778
- ```html
779
- <section class="floating-cards-section" id="dashboard-3d">
780
- <canvas id="cards-canvas"></canvas>
781
- <div class="cards-overlay">
782
- <h2>Command everything</h2>
783
- <p>Every metric, every system, every alert — unified in one spatial interface.</p>
784
- </div>
785
- </section>
786
-
787
- <script type="importmap">{ "imports": { "three": "https://unpkg.com/three@0.160.0/build/three.module.js" } }</script>
788
-
789
- <script type="module">
790
- import * as THREE from 'three';
791
-
792
- const canvas = document.getElementById('cards-canvas');
793
- const prefersReducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
794
-
795
- if (!canvas.getContext('webgl') || prefersReducedMotion) {
796
- canvas.style.display = 'none';
797
- }
798
-
799
- const scene = new THREE.Scene();
800
- const camera = new THREE.PerspectiveCamera(50, window.innerWidth / window.innerHeight, 0.1, 100);
801
- camera.position.set(0, 0, 12);
802
-
803
- const renderer = new THREE.WebGLRenderer({ canvas, alpha: true, antialias: true });
804
- renderer.setSize(window.innerWidth, window.innerHeight);
805
- renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
806
-
807
- // Card count
808
- const isMobile = /iPhone|iPad|iPod|Android/i.test(navigator.userAgent);
809
- const CARD_COUNT = isMobile ? 6 : 12;
810
- const COLS = isMobile ? 3 : 4;
811
-
812
- // Cards as thin boxes
813
- const cards = [];
814
- const cardGeometry = new THREE.BoxGeometry(2.2, 1.4, 0.08);
815
- const basePositions = [];
816
-
817
- for (let i = 0; i < CARD_COUNT; i++) {
818
- const col = i % COLS;
819
- const row = Math.floor(i / COLS);
820
- const x = (col - (COLS - 1) / 2) * 2.6;
821
- const y = (row - (Math.ceil(CARD_COUNT / COLS) - 1) / 2) * -1.8;
822
- basePositions.push({ x, y });
823
-
824
- // Glass-like material
825
- const hue = (i / CARD_COUNT) * 0.3 + 0.5; // teal to violet range
826
- const material = new THREE.MeshPhysicalMaterial({
827
- color: new THREE.Color().setHSL(hue, 0.7, 0.3),
828
- metalness: 0.1,
829
- roughness: 0.2,
830
- transmission: 0.3,
831
- thickness: 0.5,
832
- transparent: true,
833
- opacity: 0.8,
834
- clearcoat: 0.5,
835
- });
836
-
837
- const card = new THREE.Mesh(cardGeometry, material);
838
- card.position.set(x, y, 0);
839
- card.userData = {
840
- baseY: y,
841
- phase: Math.random() * Math.PI * 2,
842
- floatSpeed: 0.5 + Math.random() * 0.5,
843
- };
844
- scene.add(card);
845
- cards.push(card);
846
- }
847
-
848
- // Lighting
849
- scene.add(new THREE.AmbientLight(0xffffff, 0.6));
850
- const pointLight = new THREE.PointLight(0x00C8E8, 1.5, 30);
851
- pointLight.position.set(5, 5, 5);
852
- scene.add(pointLight);
853
-
854
- // Mouse influence
855
- const mouse = new THREE.Vector2(0, 0);
856
- document.addEventListener('mousemove', (e) => {
857
- mouse.x = (e.clientX / window.innerWidth) * 2 - 1;
858
- mouse.y = -(e.clientY / window.innerHeight) * 2 + 1;
859
- }, { passive: true });
860
-
861
- const clock = new THREE.Clock();
862
- function animate() {
863
- requestAnimationFrame(animate);
864
- const elapsed = clock.getElapsedTime();
865
-
866
- cards.forEach((card, i) => {
867
- // Float animation
868
- card.position.y = card.userData.baseY + Math.sin(elapsed * card.userData.floatSpeed + card.userData.phase) * 0.15;
869
-
870
- // Subtle rotation toward mouse
871
- card.rotation.x = (mouse.y * 0.1) + Math.sin(elapsed * 0.3 + i) * 0.03;
872
- card.rotation.y = (mouse.x * 0.15) + Math.cos(elapsed * 0.4 + i) * 0.03;
873
-
874
- // Hover: elevate toward camera
875
- const targetZ = (card.position.x * mouse.x + card.position.y * mouse.y) * 0.1;
876
- card.position.z += (targetZ - card.position.z) * 0.05;
877
- });
878
-
879
- renderer.render(scene, camera);
880
- }
881
- animate();
882
-
883
- window.addEventListener('resize', () => {
884
- camera.aspect = window.innerWidth / window.innerHeight;
885
- camera.updateProjectionMatrix();
886
- renderer.setSize(window.innerWidth, window.innerHeight);
887
- });
888
- </script>
889
-
890
- <style>
891
- .floating-cards-section { position: relative; min-height: 100vh; background: #060910; overflow: hidden; }
892
- #cards-canvas { width: 100%; height: 100vh; }
893
- .cards-overlay {
894
- position: absolute;
895
- bottom: 4rem;
896
- left: 50%;
897
- transform: translateX(-50%);
898
- text-align: center;
899
- color: #f0f4ff;
900
- z-index: 10;
901
- }
902
- .cards-overlay h2 { font-size: clamp(1.5rem, 4vw, 2.5rem); font-weight: 700; }
903
- .cards-overlay p { color: rgba(240,244,255,0.6); margin-top: 0.75rem; }
904
- </style>
905
- ```
906
-
907
- ---
908
-
909
- ## Anti-Generic Rules
910
-
911
- 1. **Never generate a generic particle starfield** — starfields are overused. Use aurora-inspired palettes and drift patterns that feel organic, not space-themed.
912
- 2. **Three.js is enhancement, not replacement** — the content (headline, copy, CTA) still needs to be strong. A beautiful 3D scene with no message is as bad as no 3D.
913
- 3. **Color discipline** — use the accent palette from the design skill. Do not introduce random neon colors.
914
- 4. **No Rube Goldberg visuals** — complex choreography, bouncing, elastic physics, and elaborate animation sequences are visual noise. Subtle drift and gentle rotation communicate premium quality.
915
- 5. **Fallback mandatory** — every pattern above includes a WebGL support check and `prefers-reduced-motion` guard. The CSS fallback must look intentional, not broken.
916
-
917
- ---
918
-
919
- ## Pre-delivery Checklist
920
-
921
- - [ ] WebGL support check with graceful CSS fallback
922
- - [ ] `prefers-reduced-motion: reduce` disables all Three.js content
923
- - [ ] Mobile detection reduces particle count to 30% or hides canvas
924
- - [ ] `IntersectionObserver` stops render loop when canvas is off-screen
925
- - [ ] All geometries and materials disposed on `beforeunload`
926
- - [ ] Canvas is `alpha: true` so CSS gradient background shows through
927
- - [ ] Bloom post-processing adds glow without washing out content
928
- - [ ] No network requests other than Three.js CDN (no external textures/models)
929
- - [ ] Lighthouse Performance score ≥ 85 on desktop (canvas is GPU-heavy — acceptable)
1
+ # Three.js Patterns — WebGL Landing Page Production Guide
2
+
3
+ > Read this skill when the user explicitly asks for 3D, WebGL, particles, Three.js scenes,
4
+ > holographic effects, or spatial visuals. This is on-demand — never auto-loaded.
5
+ > CDN-only. No build step. No npm install required for basic patterns.
6
+
7
+ ---
8
+
9
+ ## When to apply this skill
10
+
11
+ Apply this skill when the user requests:
12
+ - "3D", "WebGL", "three.js", "Three.js"
13
+ - "partículas", "particles", "sistema de partículas"
14
+ - "cena 3D", "3D scene", "objeto 3D interativo"
15
+ - "holográfico", "holographic", "hologram effect"
16
+ - "floating 3D", "3D objects", "interactive 3D"
17
+ - "hero 3D", "3D background", "particle background"
18
+ - `design_skill: threejs-spatial` set in `project.context.md`
19
+ - Three.js as a hybrid modifier in `@design-hybrid-forge`
20
+
21
+ Do NOT apply this skill for: card tilt CSS, scroll reveals, gradient text, or any
22
+ pattern already covered by `static-html-patterns.md`. Those are CSS-only and faster.
23
+
24
+ **Stack rule:** This skill produces standalone `index.html` with CDN imports.
25
+ For React/Vue/Next.js projects, adapt the patterns to framework conventions
26
+ (React Three Fiber, TresJS, etc.) — the visual outcome is the same.
27
+
28
+ ---
29
+
30
+ ## Dependencies — CDN-only (no npm)
31
+
32
+ ```html
33
+ <!-- Importmap for clean ES module imports -->
34
+ <script type="importmap">
35
+ {
36
+ "imports": {
37
+ "three": "https://unpkg.com/three@0.160.0/build/three.module.js",
38
+ "three/addons/": "https://unpkg.com/three@0.160.0/examples/jsm/"
39
+ }
40
+ }
41
+ </script>
42
+
43
+ <!-- OrbitControls (optional, for interactive scenes) -->
44
+ <script type="module">
45
+ import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
46
+ </script>
47
+
48
+ <!-- No GSAP needed — Three.js has its own animation system via requestAnimationFrame -->
49
+ ```
50
+
51
+ ---
52
+
53
+ ## Performance Rules
54
+
55
+ 1. **Always check WebGL support first** — fallback to CSS aurora gradient if unavailable
56
+ 2. **`prefers-reduced-motion: reduce`** — skip entire canvas, show static image or CSS fallback
57
+ 3. **Mobile: reduced particle count** — detect mobile, cut particles to 30% of desktop
58
+ 4. **Lazy initialization** — don't init the renderer until the canvas is in viewport
59
+ 5. **Dispose on unmount** — always call `renderer.dispose()` and dispose geometries/materials/textures
60
+ 6. **Use `IntersectionObserver`** — only run render loop when canvas is visible
61
+
62
+ ---
63
+
64
+ ## 1. Particle Aurora Hero Background
65
+
66
+ **For:** Bold & Cinematic hero sections, crypto/AI/SaaS landing pages
67
+ **Complexity:** Low. ~80 lines of JS. Works on mobile with reduced count.
68
+ **Visual:** 3,000–8,000 particles drifting in aurora gradient colors, responding subtly to mouse.
69
+
70
+ ```html
71
+ <!DOCTYPE html>
72
+ <html lang="en">
73
+ <head>
74
+ <meta charset="UTF-8">
75
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
76
+ <title>Product — Hero</title>
77
+ <style>
78
+ *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
79
+ html, body { width: 100%; height: 100%; overflow: hidden; }
80
+ body { background: #060910; font-family: system-ui, sans-serif; }
81
+
82
+ #hero-canvas {
83
+ position: fixed;
84
+ inset: 0;
85
+ width: 100%;
86
+ height: 100%;
87
+ z-index: 0;
88
+ }
89
+
90
+ .hero-content {
91
+ position: relative;
92
+ z-index: 10;
93
+ display: flex;
94
+ flex-direction: column;
95
+ align-items: center;
96
+ justify-content: center;
97
+ height: 100vh;
98
+ text-align: center;
99
+ color: #f0f4ff;
100
+ }
101
+
102
+ .hero-content h1 {
103
+ font-size: clamp(2.5rem, 8vw, 5rem);
104
+ font-weight: 800;
105
+ letter-spacing: -0.03em;
106
+ line-height: 1.1;
107
+ max-width: 900px;
108
+ padding: 0 2rem;
109
+ }
110
+
111
+ .hero-content p {
112
+ font-size: clamp(1rem, 2.5vw, 1.25rem);
113
+ color: rgba(240, 244, 255, 0.7);
114
+ margin-top: 1.5rem;
115
+ max-width: 540px;
116
+ padding: 0 2rem;
117
+ }
118
+
119
+ .hero-cta {
120
+ margin-top: 2.5rem;
121
+ display: flex;
122
+ gap: 1rem;
123
+ }
124
+
125
+ .hero-cta a {
126
+ padding: 0.875rem 2rem;
127
+ border-radius: 8px;
128
+ font-weight: 600;
129
+ font-size: 1rem;
130
+ text-decoration: none;
131
+ transition: transform 150ms ease, box-shadow 150ms ease;
132
+ }
133
+
134
+ .hero-cta a:hover {
135
+ transform: translateY(-2px);
136
+ }
137
+
138
+ .btn-primary {
139
+ background: linear-gradient(135deg, #00C8E8, #7C3AED);
140
+ color: #fff;
141
+ box-shadow: 0 4px 20px rgba(0, 200, 232, 0.3);
142
+ }
143
+
144
+ .btn-ghost {
145
+ background: rgba(255, 255, 255, 0.08);
146
+ color: #f0f4ff;
147
+ border: 1px solid rgba(255, 255, 255, 0.15);
148
+ backdrop-filter: blur(8px);
149
+ }
150
+
151
+ @media (prefers-reduced-motion: reduce) {
152
+ #hero-canvas { display: none; }
153
+ body { background: linear-gradient(135deg, #060910 0%, #0A0818 30%, #060C1A 70%, #08060F 100%); }
154
+ }
155
+ </style>
156
+ </head>
157
+ <body>
158
+
159
+ <canvas id="hero-canvas"></canvas>
160
+
161
+ <section class="hero-content">
162
+ <h1>Bold Headline That <em style="background: linear-gradient(135deg, #00C8E8, #7C3AED); -webkit-background-clip: text; -webkit-text-fill-color: transparent;">Changes Everything</em></h1>
163
+ <p>Supporting text that adds real context — who benefits, how fast, what outcome.</p>
164
+ <div class="hero-cta">
165
+ <a href="#cta" class="btn-primary">Get started</a>
166
+ <a href="#features" class="btn-ghost">Learn more</a>
167
+ </div>
168
+ </section>
169
+
170
+ <script type="importmap">
171
+ {
172
+ "imports": {
173
+ "three": "https://unpkg.com/three@0.160.0/build/three.module.js"
174
+ }
175
+ }
176
+ </script>
177
+
178
+ <script type="module">
179
+ import * as THREE from 'three';
180
+
181
+ // ─── WebGL Support Check ───────────────────────────────────────────────────
182
+ const canvas = document.getElementById('hero-canvas');
183
+ const gl = canvas.getContext('webgl') || canvas.getContext('webgl2');
184
+ if (!gl) {
185
+ canvas.style.display = 'none';
186
+ document.body.style.background = 'linear-gradient(135deg, #060910 0%, #0A0818 30%, #060C1A 70%, #08060F 100%)';
187
+ }
188
+
189
+ // ─── prefers-reduced-motion ───────────────────────────────────────────────
190
+ const prefersReducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
191
+ if (prefersReducedMotion) {
192
+ canvas.style.display = 'none';
193
+ document.body.style.background = 'linear-gradient(135deg, #060910 0%, #0A0818 30%, #060C1A 70%, #08060F 100%)';
194
+ }
195
+
196
+ // ─── Scene Setup ─────────────────────────────────────────────────────────
197
+ const scene = new THREE.Scene();
198
+ const camera = new THREE.PerspectiveCamera(75, window.innerWidth / window.innerHeight, 0.1, 1000);
199
+ camera.position.z = 50;
200
+
201
+ const renderer = new THREE.WebGLRenderer({
202
+ canvas,
203
+ alpha: true,
204
+ antialias: true,
205
+ powerPreference: 'high-performance'
206
+ });
207
+ renderer.setSize(window.innerWidth, window.innerHeight);
208
+ renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
209
+ renderer.setClearColor(0x000000, 0);
210
+
211
+ // ─── Particles ────────────────────────────────────────────────────────────
212
+ const isMobile = /iPhone|iPad|iPod|Android/i.test(navigator.userAgent);
213
+ const PARTICLE_COUNT = isMobile ? 1500 : 6000;
214
+
215
+ const geometry = new THREE.BufferGeometry();
216
+ const positions = new Float32Array(PARTICLE_COUNT * 3);
217
+ const colors = new Float32Array(PARTICLE_COUNT * 3);
218
+ const sizes = new Float32Array(PARTICLE_COUNT);
219
+
220
+ // Aurora colors: teal (#00C8E8), violet (#7C3AED), blue (#3B82F6), pink (#EC4899)
221
+ const palette = [
222
+ new THREE.Color('#00C8E8'),
223
+ new THREE.Color('#7C3AED'),
224
+ new THREE.Color('#3B82F6'),
225
+ new THREE.Color('#06B6D4'),
226
+ new THREE.Color('#8B5CF6'),
227
+ ];
228
+
229
+ for (let i = 0; i < PARTICLE_COUNT; i++) {
230
+ positions[i * 3] = (Math.random() - 0.5) * 120;
231
+ positions[i * 3 + 1] = (Math.random() - 0.5) * 80;
232
+ positions[i * 3 + 2] = (Math.random() - 0.5) * 60;
233
+
234
+ const color = palette[Math.floor(Math.random() * palette.length)];
235
+ colors[i * 3] = color.r;
236
+ colors[i * 3 + 1] = color.g;
237
+ colors[i * 3 + 2] = color.b;
238
+
239
+ sizes[i] = Math.random() * 0.8 + 0.2;
240
+ }
241
+
242
+ geometry.setAttribute('position', new THREE.BufferAttribute(positions, 3));
243
+ geometry.setAttribute('color', new THREE.BufferAttribute(colors, 3));
244
+ geometry.setAttribute('size', new THREE.BufferAttribute(sizes, 1));
245
+
246
+ // ─── Shader Material ─────────────────────────────────────────────────────
247
+ const vertexShader = `
248
+ attribute float size;
249
+ varying vec3 vColor;
250
+
251
+ void main() {
252
+ vColor = color;
253
+ vec4 mvPosition = modelViewMatrix * vec4(position, 1.0);
254
+ gl_PointSize = size * (300.0 / -mvPosition.z);
255
+ gl_Position = projectionMatrix * mvPosition;
256
+ }
257
+ `;
258
+
259
+ const fragmentShader = `
260
+ varying vec3 vColor;
261
+
262
+ void main() {
263
+ float dist = length(gl_PointCoord - vec2(0.5));
264
+ if (dist > 0.5) discard;
265
+ float alpha = 1.0 - smoothstep(0.2, 0.5, dist);
266
+ gl_FragColor = vec4(vColor, alpha * 0.8);
267
+ }
268
+ `;
269
+
270
+ const material = new THREE.ShaderMaterial({
271
+ uniforms: {
272
+ uTime: { value: 0 },
273
+ },
274
+ vertexShader,
275
+ fragmentShader,
276
+ transparent: true,
277
+ vertexColors: true,
278
+ depthWrite: false,
279
+ blending: THREE.AdditiveBlending,
280
+ });
281
+
282
+ const points = new THREE.Points(geometry, material);
283
+ scene.add(points);
284
+
285
+ // ─── Mouse Interaction ────────────────────────────────────────────────────
286
+ const mouse = new THREE.Vector2(0, 0);
287
+ const targetMouse = new THREE.Vector2(0, 0);
288
+
289
+ document.addEventListener('mousemove', (e) => {
290
+ targetMouse.x = (e.clientX / window.innerWidth) * 2 - 1;
291
+ targetMouse.y = -(e.clientY / window.innerHeight) * 2 + 1;
292
+ });
293
+
294
+ // ─── Animation Loop ───────────────────────────────────────────────────────
295
+ const clock = new THREE.Clock();
296
+ let animFrameId = null;
297
+
298
+ function animate() {
299
+ if (prefersReducedMotion) return;
300
+
301
+ animFrameId = requestAnimationFrame(animate);
302
+
303
+ const elapsed = clock.getElapsedTime();
304
+
305
+ // Smooth mouse follow
306
+ mouse.x += (targetMouse.x - mouse.x) * 0.02;
307
+ mouse.y += (targetMouse.y - mouse.y) * 0.02;
308
+
309
+ // Particle drift
310
+ const positions = geometry.attributes.position.array;
311
+ for (let i = 0; i < PARTICLE_COUNT; i++) {
312
+ positions[i * 3 + 1] += Math.sin(elapsed * 0.3 + i * 0.01) * 0.01;
313
+ positions[i * 3] += Math.cos(elapsed * 0.2 + i * 0.005) * 0.008;
314
+ }
315
+ geometry.attributes.position.needsUpdate = true;
316
+
317
+ // Camera sway (subtle)
318
+ camera.position.x = mouse.x * 3;
319
+ camera.position.y = mouse.y * 2;
320
+ camera.lookAt(scene.position);
321
+
322
+ // Particle rotation (very slow)
323
+ points.rotation.y = elapsed * 0.02;
324
+ points.rotation.x = Math.sin(elapsed * 0.1) * 0.05;
325
+
326
+ material.uniforms.uTime.value = elapsed;
327
+ renderer.render(scene, camera);
328
+ }
329
+
330
+ // ─── VisibilityObserver: only run when in viewport ─────────────────────
331
+ const observer = new IntersectionObserver((entries) => {
332
+ entries.forEach(entry => {
333
+ if (entry.isIntersecting) {
334
+ if (!animFrameId) animate();
335
+ } else {
336
+ cancelAnimationFrame(animFrameId);
337
+ animFrameId = null;
338
+ }
339
+ });
340
+ }, { threshold: 0 });
341
+ observer.observe(canvas);
342
+
343
+ // ─── Resize Handler ───────────────────────────────────────────────────────
344
+ window.addEventListener('resize', () => {
345
+ camera.aspect = window.innerWidth / window.innerHeight;
346
+ camera.updateProjectionMatrix();
347
+ renderer.setSize(window.innerWidth, window.innerHeight);
348
+ });
349
+
350
+ // ─── Cleanup on page unload ───────────────────────────────────────────────
351
+ window.addEventListener('beforeunload', () => {
352
+ renderer.dispose();
353
+ geometry.dispose();
354
+ material.dispose();
355
+ });
356
+ </script>
357
+ </body>
358
+ </html>
359
+ ```
360
+
361
+ ---
362
+
363
+ ## 2. Interactive 3D Object Showcase
364
+
365
+ **For:** Product features, 3D product display, interactive demos
366
+ **Complexity:** Medium. ~120 lines of JS. Includes OrbitControls.
367
+ **Visual:** A single 3D object (torus knot, icosahedron, or custom geometry) that the user can drag to rotate. Hover highlights with glow.
368
+
369
+ ```html
370
+ <!-- In your landing page, after the hero section -->
371
+ <section class="showcase-3d" id="showcase">
372
+ <div class="showcase-container">
373
+ <canvas id="showcase-canvas"></canvas>
374
+ <div class="showcase-content">
375
+ <span class="section-label">Interactive</span>
376
+ <h2>Explore the architecture</h2>
377
+ <p>Drag to rotate. Scroll to zoom. Every detail rendered in real-time 3D.</p>
378
+ </div>
379
+ </div>
380
+ </section>
381
+
382
+ <style>
383
+ .showcase-3d { min-height: 100vh; display: flex; align-items: center; justify-content: center; }
384
+ .showcase-container { display: grid; grid-template-columns: 1fr 1fr; gap: 4rem; align-items: center; max-width: 1200px; margin: 0 auto; padding: 4rem 2rem; }
385
+ #showcase-canvas { width: 100%; height: 500px; border-radius: 16px; background: transparent; cursor: grab; }
386
+ #showcase-canvas:active { cursor: grabbing; }
387
+ .showcase-content h2 { font-size: clamp(1.75rem, 4vw, 2.5rem); font-weight: 700; letter-spacing: -0.02em; }
388
+ .showcase-content p { margin-top: 1rem; color: rgba(240,244,255,0.65); line-height: 1.7; }
389
+ @media (max-width: 768px) { .showcase-container { grid-template-columns: 1fr; } }
390
+ @media (prefers-reduced-motion: reduce) { #showcase-canvas { display: none; } }
391
+ </style>
392
+
393
+ <script type="importmap">
394
+ {
395
+ "imports": {
396
+ "three": "https://unpkg.com/three@0.160.0/build/three.module.js",
397
+ "three/addons/": "https://unpkg.com/three@0.160.0/examples/jsm/"
398
+ }
399
+ }
400
+ </script>
401
+
402
+ <script type="module">
403
+ import * as THREE from 'three';
404
+ import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
405
+ import { EffectComposer } from 'three/addons/postprocessing/EffectComposer.js';
406
+ import { RenderPass } from 'three/addons/postprocessing/RenderPass.js';
407
+ import { UnrealBloomPass } from 'three/addons/postprocessing/UnrealBloomPass.js';
408
+
409
+ const canvas = document.getElementById('showcase-canvas');
410
+ const gl = canvas.getContext('webgl') || canvas.getContext('webgl2');
411
+ if (!gl || window.matchMedia('(prefers-reduced-motion: reduce)').matches) {
412
+ canvas.style.display = 'none';
413
+ }
414
+
415
+ // Scene
416
+ const scene = new THREE.Scene();
417
+ const camera = new THREE.PerspectiveCamera(45, canvas.clientWidth / canvas.clientHeight, 0.1, 100);
418
+ camera.position.set(0, 0, 6);
419
+
420
+ const renderer = new THREE.WebGLRenderer({ canvas, alpha: true, antialias: true });
421
+ renderer.setSize(canvas.clientWidth, canvas.clientHeight);
422
+ renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
423
+ renderer.setClearColor(0x000000, 0);
424
+ renderer.toneMapping = THREE.ACESFilmicToneMapping;
425
+ renderer.toneMappingExposure = 1.2;
426
+
427
+ // Bloom post-processing
428
+ const composer = new EffectComposer(renderer);
429
+ composer.addPass(new RenderPass(scene, camera));
430
+ const bloomPass = new UnrealBloomPass(
431
+ new THREE.Vector2(canvas.clientWidth, canvas.clientHeight),
432
+ 0.8, 0.4, 0.85
433
+ );
434
+ composer.addPass(bloomPass);
435
+
436
+ // Object: TorusKnot with glass-like material
437
+ const geometry = new THREE.TorusKnotGeometry(1.5, 0.4, 128, 32, 2, 3);
438
+ const material = new THREE.MeshPhysicalMaterial({
439
+ color: new THREE.Color('#00C8E8'),
440
+ metalness: 0.1,
441
+ roughness: 0.1,
442
+ transmission: 0.6,
443
+ thickness: 1.5,
444
+ envMapIntensity: 1,
445
+ clearcoat: 1,
446
+ clearcoatRoughness: 0.1,
447
+ transparent: true,
448
+ opacity: 0.9,
449
+ });
450
+ const mesh = new THREE.Mesh(geometry, material);
451
+ scene.add(mesh);
452
+
453
+ // Lights
454
+ const ambientLight = new THREE.AmbientLight(0xffffff, 0.5);
455
+ scene.add(ambientLight);
456
+
457
+ const pointLight1 = new THREE.PointLight(0x00C8E8, 2, 50);
458
+ pointLight1.position.set(5, 5, 5);
459
+ scene.add(pointLight1);
460
+
461
+ const pointLight2 = new THREE.PointLight(0x7C3AED, 2, 50);
462
+ pointLight2.position.set(-5, -5, 5);
463
+ scene.add(pointLight2);
464
+
465
+ // OrbitControls
466
+ const controls = new OrbitControls(camera, renderer.domElement);
467
+ controls.enableDamping = true;
468
+ controls.dampingFactor = 0.05;
469
+ controls.enableZoom = true;
470
+ controls.enablePan = false;
471
+ controls.minDistance = 3;
472
+ controls.maxDistance = 10;
473
+ controls.autoRotate = true;
474
+ controls.autoRotateSpeed = 0.8;
475
+
476
+ // Subtle float animation
477
+ const clock = new THREE.Clock();
478
+ function animate() {
479
+ requestAnimationFrame(animate);
480
+ const elapsed = clock.getElapsedTime();
481
+ mesh.position.y = Math.sin(elapsed * 0.5) * 0.15;
482
+ controls.update();
483
+ composer.render();
484
+ }
485
+
486
+ // Only start when visible
487
+ const observer = new IntersectionObserver((entries) => {
488
+ entries.forEach(entry => {
489
+ if (entry.isIntersecting) {
490
+ animate();
491
+ observer.disconnect();
492
+ }
493
+ });
494
+ }, { threshold: 0.1 });
495
+ observer.observe(canvas);
496
+
497
+ window.addEventListener('resize', () => {
498
+ const w = canvas.clientWidth;
499
+ const h = canvas.clientHeight;
500
+ camera.aspect = w / h;
501
+ camera.updateProjectionMatrix();
502
+ renderer.setSize(w, h);
503
+ composer.setSize(w, h);
504
+ });
505
+ </script>
506
+ ```
507
+
508
+ ---
509
+
510
+ ## 3. Scroll-Driven 3D Parallax Layers
511
+
512
+ **For:** Landing pages where scrolling moves the camera through a 3D scene
513
+ **Complexity:** Medium. Uses scroll event + camera interpolation.
514
+ **Visual:** Multiple 3D planes positioned at different depths scroll at different rates.
515
+
516
+ ```html
517
+ <section class="parallax-3d-section" id="features-3d">
518
+ <canvas id="parallax-canvas"></canvas>
519
+
520
+ <div class="parallax-content" data-depth="0.1">
521
+ <h2>First Feature</h2>
522
+ <p>Content that moves with the scene.</p>
523
+ </div>
524
+
525
+ <div class="parallax-content" data-depth="0.3">
526
+ <h2>Second Feature</h2>
527
+ <p>Deeper layer, moves faster.</p>
528
+ </div>
529
+
530
+ <div class="parallax-content" data-depth="0.6">
531
+ <h2>Third Feature</h2>
532
+ <p>Closest layer, fastest parallax.</p>
533
+ </div>
534
+ </section>
535
+
536
+ <script type="importmap">{ "imports": { "three": "https://unpkg.com/three@0.160.0/build/three.module.js" } }</script>
537
+
538
+ <script type="module">
539
+ import * as THREE from 'three';
540
+
541
+ const canvas = document.getElementById('parallax-canvas');
542
+ if (!canvas.getContext('webgl') || window.matchMedia('(prefers-reduced-motion: reduce)').matches) {
543
+ canvas.style.display = 'none';
544
+ }
545
+
546
+ const scene = new THREE.Scene();
547
+ const camera = new THREE.PerspectiveCamera(60, window.innerWidth / window.innerHeight, 0.1, 1000);
548
+ camera.position.z = 50;
549
+
550
+ const renderer = new THREE.WebGLRenderer({ canvas, alpha: true, antialias: true });
551
+ renderer.setSize(window.innerWidth, window.innerHeight);
552
+ renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
553
+ renderer.setClearColor(0x000000, 0);
554
+
555
+ // Background particles (stars)
556
+ const starGeometry = new THREE.BufferGeometry();
557
+ const starCount = 2000;
558
+ const starPositions = new Float32Array(starCount * 3);
559
+ for (let i = 0; i < starCount * 3; i++) {
560
+ starPositions[i] = (Math.random() - 0.5) * 200;
561
+ }
562
+ starGeometry.setAttribute('position', new THREE.BufferAttribute(starPositions, 3));
563
+ const starMaterial = new THREE.PointsMaterial({ color: 0xffffff, size: 0.15, transparent: true, opacity: 0.6 });
564
+ const stars = new THREE.Points(starGeometry, starMaterial);
565
+ scene.add(stars);
566
+
567
+ // Scroll-driven camera + parallax layers
568
+ const scrollContainer = document.getElementById('features-3d');
569
+ const parallaxElements = document.querySelectorAll('.parallax-content');
570
+ let scrollProgress = 0;
571
+
572
+ window.addEventListener('scroll', () => {
573
+ const rect = scrollContainer.getBoundingClientRect();
574
+ const viewportHeight = window.innerHeight;
575
+ scrollProgress = Math.max(0, Math.min(1, -rect.top / (rect.height - viewportHeight)));
576
+ }, { passive: true });
577
+
578
+ const clock = new THREE.Clock();
579
+ let parallaxFrameId = null;
580
+
581
+ function animate() {
582
+ parallaxFrameId = requestAnimationFrame(animate);
583
+
584
+ // Camera moves forward on scroll
585
+ camera.position.z = 50 - scrollProgress * 30;
586
+ camera.position.x = Math.sin(scrollProgress * Math.PI) * 5;
587
+
588
+ // Parallax layers
589
+ parallaxElements.forEach(el => {
590
+ const depth = parseFloat(el.dataset.depth);
591
+ el.style.transform = `translateY(${-scrollProgress * 100 * depth}px)`;
592
+ });
593
+
594
+ // Stars drift
595
+ stars.rotation.y = scrollProgress * 0.3;
596
+ stars.rotation.x = clock.getElapsedTime() * 0.01;
597
+
598
+ renderer.render(scene, camera);
599
+ }
600
+
601
+ // Only run when section is in viewport
602
+ const parallaxObserver = new IntersectionObserver((entries) => {
603
+ entries.forEach(entry => {
604
+ if (entry.isIntersecting) {
605
+ if (!parallaxFrameId) animate();
606
+ } else {
607
+ cancelAnimationFrame(parallaxFrameId);
608
+ parallaxFrameId = null;
609
+ }
610
+ });
611
+ }, { threshold: 0 });
612
+ parallaxObserver.observe(document.getElementById('features-3d'));
613
+
614
+ window.addEventListener('resize', () => {
615
+ camera.aspect = window.innerWidth / window.innerHeight;
616
+ camera.updateProjectionMatrix();
617
+ renderer.setSize(window.innerWidth, window.innerHeight);
618
+ });
619
+ </script>
620
+
621
+ <style>
622
+ .parallax-3d-section { position: relative; height: 300vh; background: #060910; overflow: hidden; }
623
+ #parallax-canvas { position: sticky; top: 0; width: 100%; height: 100vh; z-index: 0; }
624
+ .parallax-content {
625
+ position: relative;
626
+ z-index: 10;
627
+ padding: 4rem 2rem;
628
+ max-width: 600px;
629
+ margin: 0 auto;
630
+ text-align: center;
631
+ color: #f0f4ff;
632
+ }
633
+ .parallax-content h2 { font-size: 2rem; font-weight: 700; }
634
+ .parallax-content p { color: rgba(240,244,255,0.65); margin-top: 0.75rem; }
635
+ </style>
636
+ ```
637
+
638
+ ---
639
+
640
+ ## 4. Holographic Glass Object
641
+
642
+ **For:** Premium dashboards, futuristic product pages, tech/SaaS
643
+ **Complexity:** Medium. Uses MeshPhysicalMaterial transmission + bloom.
644
+ **Visual:** A glass-like 3D object with holographic iridescence, floating in space.
645
+
646
+ ```html
647
+ <canvas id="holo-canvas"></canvas>
648
+
649
+ <script type="importmap">
650
+ {
651
+ "imports": {
652
+ "three": "https://unpkg.com/three@0.160.0/build/three.module.js",
653
+ "three/addons/": "https://unpkg.com/three@0.160.0/examples/jsm/"
654
+ }
655
+ }
656
+ </script>
657
+
658
+ <script type="module">
659
+ import * as THREE from 'three';
660
+ import { EffectComposer } from 'three/addons/postprocessing/EffectComposer.js';
661
+ import { RenderPass } from 'three/addons/postprocessing/RenderPass.js';
662
+ import { UnrealBloomPass } from 'three/addons/postprocessing/UnrealBloomPass.js';
663
+
664
+ const canvas = document.getElementById('holo-canvas');
665
+ const prefersReducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
666
+
667
+ if (!canvas.getContext('webgl') || prefersReducedMotion) {
668
+ canvas.style.display = 'none';
669
+ document.body.style.background = 'linear-gradient(135deg, #060910, #0A0818)';
670
+ }
671
+
672
+ // Scene
673
+ const scene = new THREE.Scene();
674
+ const camera = new THREE.PerspectiveCamera(45, window.innerWidth / window.innerHeight, 0.1, 100);
675
+ camera.position.set(0, 0, 6);
676
+
677
+ const renderer = new THREE.WebGLRenderer({ canvas, alpha: true, antialias: true });
678
+ renderer.setSize(window.innerWidth, window.innerHeight);
679
+ renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
680
+ renderer.toneMapping = THREE.ACESFilmicToneMapping;
681
+ renderer.toneMappingExposure = 1.3;
682
+
683
+ // Bloom
684
+ const composer = new EffectComposer(renderer);
685
+ composer.addPass(new RenderPass(scene, camera));
686
+ const bloomPass = new UnrealBloomPass(
687
+ new THREE.Vector2(window.innerWidth, window.innerHeight), 1.2, 0.5, 0.7
688
+ );
689
+ composer.addPass(bloomPass);
690
+
691
+ // Holographic material
692
+ const holoMaterial = new THREE.MeshPhysicalMaterial({
693
+ color: new THREE.Color('#00C8E8'),
694
+ metalness: 0.9,
695
+ roughness: 0.05,
696
+ transmission: 0.4,
697
+ thickness: 0.5,
698
+ envMapIntensity: 2,
699
+ clearcoat: 1,
700
+ clearcoatRoughness: 0.05,
701
+ iridescence: 1,
702
+ iridescenceIOR: 1.5,
703
+ iridescenceThicknessRange: [100, 400],
704
+ transparent: true,
705
+ opacity: 0.85,
706
+ });
707
+
708
+ // Object: Icosahedron
709
+ const geometry = new THREE.IcosahedronGeometry(1.8, 1);
710
+ const mesh = new THREE.Mesh(geometry, holoMaterial);
711
+ scene.add(mesh);
712
+
713
+ // Wireframe overlay
714
+ const wireframeMaterial = new THREE.MeshBasicMaterial({
715
+ color: new THREE.Color('#00C8E8'),
716
+ wireframe: true,
717
+ transparent: true,
718
+ opacity: 0.15,
719
+ });
720
+ const wireframe = new THREE.Mesh(geometry, wireframeMaterial);
721
+ mesh.add(wireframe);
722
+
723
+ // Lights
724
+ scene.add(new THREE.AmbientLight(0xffffff, 0.3));
725
+ const light1 = new THREE.PointLight(0x00C8E8, 3, 20);
726
+ light1.position.set(3, 3, 3);
727
+ scene.add(light1);
728
+ const light2 = new THREE.PointLight(0x7C3AED, 3, 20);
729
+ light2.position.set(-3, -3, 3);
730
+ scene.add(light2);
731
+
732
+ // Mouse interaction (rotation)
733
+ const mouse = new THREE.Vector2(0, 0);
734
+ document.addEventListener('mousemove', (e) => {
735
+ mouse.x = (e.clientX / window.innerWidth) * 2 - 1;
736
+ mouse.y = -(e.clientY / window.innerHeight) * 2 + 1;
737
+ }, { passive: true });
738
+
739
+ const clock = new THREE.Clock();
740
+ function animate() {
741
+ requestAnimationFrame(animate);
742
+ const elapsed = clock.getElapsedTime();
743
+
744
+ mesh.rotation.x = elapsed * 0.15 + mouse.y * 0.3;
745
+ mesh.rotation.y = elapsed * 0.2 + mouse.x * 0.5;
746
+
747
+ // Pulse the iridescence via thickness range
748
+ const pulse = 200 + Math.sin(elapsed * 2) * 100;
749
+ holoMaterial.iridescenceThicknessRange = [pulse * 0.5, pulse];
750
+ holoMaterial.needsUpdate = true;
751
+
752
+ composer.render();
753
+ }
754
+ animate();
755
+
756
+ window.addEventListener('resize', () => {
757
+ camera.aspect = window.innerWidth / window.innerHeight;
758
+ camera.updateProjectionMatrix();
759
+ renderer.setSize(window.innerWidth, window.innerHeight);
760
+ composer.setSize(window.innerWidth, window.innerHeight);
761
+ });
762
+ </script>
763
+
764
+ <style>
765
+ #holo-canvas { position: fixed; inset: 0; width: 100%; height: 100%; z-index: 0; }
766
+ body > *:not(#holo-canvas) { position: relative; z-index: 10; }
767
+ </style>
768
+ ```
769
+
770
+ ---
771
+
772
+ ## 5. Floating Object Array (Dashboard Cards as 3D Objects)
773
+
774
+ **For:** Premium command centers, product showcases, animated dashboard cards
775
+ **Complexity:** Medium-High. Multiple meshes with individual animations.
776
+ **Visual:** A grid of floating cards (as thin 3D boxes) that drift and respond to mouse.
777
+
778
+ ```html
779
+ <section class="floating-cards-section" id="dashboard-3d">
780
+ <canvas id="cards-canvas"></canvas>
781
+ <div class="cards-overlay">
782
+ <h2>Command everything</h2>
783
+ <p>Every metric, every system, every alert — unified in one spatial interface.</p>
784
+ </div>
785
+ </section>
786
+
787
+ <script type="importmap">{ "imports": { "three": "https://unpkg.com/three@0.160.0/build/three.module.js" } }</script>
788
+
789
+ <script type="module">
790
+ import * as THREE from 'three';
791
+
792
+ const canvas = document.getElementById('cards-canvas');
793
+ const prefersReducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
794
+
795
+ if (!canvas.getContext('webgl') || prefersReducedMotion) {
796
+ canvas.style.display = 'none';
797
+ }
798
+
799
+ const scene = new THREE.Scene();
800
+ const camera = new THREE.PerspectiveCamera(50, window.innerWidth / window.innerHeight, 0.1, 100);
801
+ camera.position.set(0, 0, 12);
802
+
803
+ const renderer = new THREE.WebGLRenderer({ canvas, alpha: true, antialias: true });
804
+ renderer.setSize(window.innerWidth, window.innerHeight);
805
+ renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
806
+
807
+ // Card count
808
+ const isMobile = /iPhone|iPad|iPod|Android/i.test(navigator.userAgent);
809
+ const CARD_COUNT = isMobile ? 6 : 12;
810
+ const COLS = isMobile ? 3 : 4;
811
+
812
+ // Cards as thin boxes
813
+ const cards = [];
814
+ const cardGeometry = new THREE.BoxGeometry(2.2, 1.4, 0.08);
815
+ const basePositions = [];
816
+
817
+ for (let i = 0; i < CARD_COUNT; i++) {
818
+ const col = i % COLS;
819
+ const row = Math.floor(i / COLS);
820
+ const x = (col - (COLS - 1) / 2) * 2.6;
821
+ const y = (row - (Math.ceil(CARD_COUNT / COLS) - 1) / 2) * -1.8;
822
+ basePositions.push({ x, y });
823
+
824
+ // Glass-like material
825
+ const hue = (i / CARD_COUNT) * 0.3 + 0.5; // teal to violet range
826
+ const material = new THREE.MeshPhysicalMaterial({
827
+ color: new THREE.Color().setHSL(hue, 0.7, 0.3),
828
+ metalness: 0.1,
829
+ roughness: 0.2,
830
+ transmission: 0.3,
831
+ thickness: 0.5,
832
+ transparent: true,
833
+ opacity: 0.8,
834
+ clearcoat: 0.5,
835
+ });
836
+
837
+ const card = new THREE.Mesh(cardGeometry, material);
838
+ card.position.set(x, y, 0);
839
+ card.userData = {
840
+ baseY: y,
841
+ phase: Math.random() * Math.PI * 2,
842
+ floatSpeed: 0.5 + Math.random() * 0.5,
843
+ };
844
+ scene.add(card);
845
+ cards.push(card);
846
+ }
847
+
848
+ // Lighting
849
+ scene.add(new THREE.AmbientLight(0xffffff, 0.6));
850
+ const pointLight = new THREE.PointLight(0x00C8E8, 1.5, 30);
851
+ pointLight.position.set(5, 5, 5);
852
+ scene.add(pointLight);
853
+
854
+ // Mouse influence
855
+ const mouse = new THREE.Vector2(0, 0);
856
+ document.addEventListener('mousemove', (e) => {
857
+ mouse.x = (e.clientX / window.innerWidth) * 2 - 1;
858
+ mouse.y = -(e.clientY / window.innerHeight) * 2 + 1;
859
+ }, { passive: true });
860
+
861
+ const clock = new THREE.Clock();
862
+ function animate() {
863
+ requestAnimationFrame(animate);
864
+ const elapsed = clock.getElapsedTime();
865
+
866
+ cards.forEach((card, i) => {
867
+ // Float animation
868
+ card.position.y = card.userData.baseY + Math.sin(elapsed * card.userData.floatSpeed + card.userData.phase) * 0.15;
869
+
870
+ // Subtle rotation toward mouse
871
+ card.rotation.x = (mouse.y * 0.1) + Math.sin(elapsed * 0.3 + i) * 0.03;
872
+ card.rotation.y = (mouse.x * 0.15) + Math.cos(elapsed * 0.4 + i) * 0.03;
873
+
874
+ // Hover: elevate toward camera
875
+ const targetZ = (card.position.x * mouse.x + card.position.y * mouse.y) * 0.1;
876
+ card.position.z += (targetZ - card.position.z) * 0.05;
877
+ });
878
+
879
+ renderer.render(scene, camera);
880
+ }
881
+ animate();
882
+
883
+ window.addEventListener('resize', () => {
884
+ camera.aspect = window.innerWidth / window.innerHeight;
885
+ camera.updateProjectionMatrix();
886
+ renderer.setSize(window.innerWidth, window.innerHeight);
887
+ });
888
+ </script>
889
+
890
+ <style>
891
+ .floating-cards-section { position: relative; min-height: 100vh; background: #060910; overflow: hidden; }
892
+ #cards-canvas { width: 100%; height: 100vh; }
893
+ .cards-overlay {
894
+ position: absolute;
895
+ bottom: 4rem;
896
+ left: 50%;
897
+ transform: translateX(-50%);
898
+ text-align: center;
899
+ color: #f0f4ff;
900
+ z-index: 10;
901
+ }
902
+ .cards-overlay h2 { font-size: clamp(1.5rem, 4vw, 2.5rem); font-weight: 700; }
903
+ .cards-overlay p { color: rgba(240,244,255,0.6); margin-top: 0.75rem; }
904
+ </style>
905
+ ```
906
+
907
+ ---
908
+
909
+ ## Anti-Generic Rules
910
+
911
+ 1. **Never generate a generic particle starfield** — starfields are overused. Use aurora-inspired palettes and drift patterns that feel organic, not space-themed.
912
+ 2. **Three.js is enhancement, not replacement** — the content (headline, copy, CTA) still needs to be strong. A beautiful 3D scene with no message is as bad as no 3D.
913
+ 3. **Color discipline** — use the accent palette from the design skill. Do not introduce random neon colors.
914
+ 4. **No Rube Goldberg visuals** — complex choreography, bouncing, elastic physics, and elaborate animation sequences are visual noise. Subtle drift and gentle rotation communicate premium quality.
915
+ 5. **Fallback mandatory** — every pattern above includes a WebGL support check and `prefers-reduced-motion` guard. The CSS fallback must look intentional, not broken.
916
+
917
+ ---
918
+
919
+ ## Pre-delivery Checklist
920
+
921
+ - [ ] WebGL support check with graceful CSS fallback
922
+ - [ ] `prefers-reduced-motion: reduce` disables all Three.js content
923
+ - [ ] Mobile detection reduces particle count to 30% or hides canvas
924
+ - [ ] `IntersectionObserver` stops render loop when canvas is off-screen
925
+ - [ ] All geometries and materials disposed on `beforeunload`
926
+ - [ ] Canvas is `alpha: true` so CSS gradient background shows through
927
+ - [ ] Bloom post-processing adds glow without washing out content
928
+ - [ ] No network requests other than Three.js CDN (no external textures/models)
929
+ - [ ] Lighthouse Performance score ≥ 85 on desktop (canvas is GPU-heavy — acceptable)