@jaimevalasek/aioson 1.8.0 → 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 (967) hide show
  1. package/CHANGELOG.md +595 -595
  2. package/CODE_OF_CONDUCT.md +12 -12
  3. package/CONTRIBUTING.md +13 -13
  4. package/LICENSE +661 -661
  5. package/README.md +919 -919
  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 -464
  41. package/docs/en/{i18n.md → 5-reference/i18n.md} +52 -52
  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 -126
  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 -66
  64. package/docs/en/{schemas → 5-reference/schemas}/parallel-doctor.schema.json +122 -122
  65. package/docs/en/{schemas → 5-reference/schemas}/parallel-guard.schema.json +63 -63
  66. package/docs/en/{schemas → 5-reference/schemas}/parallel-init.schema.json +53 -53
  67. package/docs/en/{schemas → 5-reference/schemas}/parallel-merge.schema.json +84 -84
  68. package/docs/en/{schemas → 5-reference/schemas}/parallel-status.schema.json +184 -184
  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 -94
  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 -290
  149. package/docs/pt/{comandos-cli.md → 5-referencia/comandos-cli.md} +1823 -1781
  150. package/docs/pt/{compress-agents.md → 5-referencia/compress-agents.md} +304 -304
  151. package/docs/pt/{design-docs-governance.md → 5-referencia/design-docs-governance.md} +59 -59
  152. package/docs/pt/{devlog-pipeline.md → 5-referencia/devlog-pipeline.md} +270 -270
  153. package/docs/pt/{feature-archive.md → 5-referencia/feature-archive.md} +199 -191
  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 -407
  157. package/docs/pt/{genome-distribution.md → 5-referencia/genome-distribution.md} +232 -232
  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/{motor-hardening.md → 5-referencia/motor-hardening.md} +493 -492
  163. package/docs/pt/{output-strategy-delivery.md → 5-referencia/output-strategy-delivery.md} +655 -655
  164. package/docs/pt/{runner-system.md → 5-referencia/runner-system.md} +113 -113
  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 -125
  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 -251
  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 -993
  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 -51
  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 -66
  221. package/src/agents.js +92 -92
  222. package/src/autonomy-policy.js +163 -139
  223. package/src/backup-local.js +74 -74
  224. package/src/backup-provider.js +303 -303
  225. package/src/brain-query.js +171 -161
  226. package/src/cli.js +77 -4
  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 -255
  231. package/src/commands/artifact-validate.js +218 -218
  232. package/src/commands/auth.js +298 -272
  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 -44
  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 -344
  239. package/src/commands/classify.js +256 -256
  240. package/src/commands/cloud.js +1767 -1767
  241. package/src/commands/commit-prepare.js +610 -547
  242. package/src/commands/compress-agents.js +416 -416
  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 -177
  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 -183
  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 -294
  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 -423
  263. package/src/commands/feature-archive.js +513 -513
  264. package/src/commands/feature-close.js +554 -270
  265. package/src/commands/gate-approve.js +198 -198
  266. package/src/commands/gate-check.js +247 -247
  267. package/src/commands/genome-doctor.js +489 -198
  268. package/src/commands/genome-migrate.js +49 -49
  269. package/src/commands/git-guard.js +170 -170
  270. package/src/commands/harness.js +307 -121
  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 -367
  276. package/src/commands/info.js +41 -41
  277. package/src/commands/init.js +120 -120
  278. package/src/commands/install.js +162 -111
  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 -2082
  285. package/src/commands/locale-apply.js +54 -54
  286. package/src/commands/locale-diff.js +25 -25
  287. package/src/commands/mcp-doctor.js +407 -407
  288. package/src/commands/mcp-init.js +373 -373
  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 -234
  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 -483
  298. package/src/commands/parallel-doctor.js +850 -850
  299. package/src/commands/parallel-guard.js +241 -241
  300. package/src/commands/parallel-init.js +311 -311
  301. package/src/commands/parallel-merge.js +299 -299
  302. package/src/commands/parallel-status.js +434 -434
  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 -267
  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 -166
  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 -235
  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 -188
  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 -275
  327. package/src/commands/security-scan.js +376 -376
  328. package/src/commands/self-implement-loop.js +306 -300
  329. package/src/commands/session-guard.js +218 -218
  330. package/src/commands/setup-context.js +699 -699
  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 -830
  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 -314
  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 -361
  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 -56
  360. package/src/commands/squad-score.js +311 -307
  361. package/src/commands/squad-status.js +481 -481
  362. package/src/commands/squad-tool-register.js +157 -157
  363. package/src/commands/squad-validate.js +438 -438
  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 -304
  369. package/src/commands/store-skill.js +247 -247
  370. package/src/commands/store-squad.js +431 -431
  371. package/src/commands/store-system.js +392 -392
  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 -63
  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 -612
  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 -730
  381. package/src/commands/workflow-harden.js +231 -231
  382. package/src/commands/workflow-heal.js +136 -136
  383. package/src/commands/workflow-next.js +1279 -1039
  384. package/src/commands/workflow-plan.js +108 -108
  385. package/src/commands/workflow-status.js +440 -440
  386. package/src/commands/workspace.js +144 -144
  387. package/src/constants.js +413 -384
  388. package/src/context-cache.js +159 -159
  389. package/src/context-memory.js +975 -966
  390. package/src/context-parse-reason.js +22 -22
  391. package/src/context-search.js +326 -326
  392. package/src/context-writer.js +197 -197
  393. package/src/context.js +247 -247
  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 -329
  398. package/src/dossier/codemap-store.js +267 -267
  399. package/src/dossier/dossier-bootstrap.js +222 -222
  400. package/src/dossier/dossier-compact.js +159 -159
  401. package/src/dossier/lock.js +128 -128
  402. package/src/dossier/research-index-store.js +233 -0
  403. package/src/dossier/revision-store.js +313 -313
  404. package/src/dossier/schema.js +162 -155
  405. package/src/dossier/scout-section.js +127 -0
  406. package/src/dossier/store.js +406 -400
  407. package/src/execution-gateway.js +464 -464
  408. package/src/friction-scanner.js +202 -202
  409. package/src/genome-files.js +198 -198
  410. package/src/genome-format.js +442 -442
  411. package/src/genome-schema.js +238 -238
  412. package/src/genomes/bindings.js +281 -281
  413. package/src/genomes.js +500 -500
  414. package/src/handoff-contract.js +417 -363
  415. package/src/handoff-validator.js +45 -45
  416. package/src/harness/circuit-breaker.js +135 -135
  417. package/src/i18n/index.js +103 -103
  418. package/src/i18n/messages/en.js +1541 -1434
  419. package/src/i18n/messages/es.js +1325 -1221
  420. package/src/i18n/messages/fr.js +1333 -1229
  421. package/src/i18n/messages/pt-BR.js +1561 -1457
  422. package/src/i18n/scaffold.js +64 -64
  423. package/src/install-animation.js +260 -260
  424. package/src/install-profile.js +127 -127
  425. package/src/install-wizard.js +475 -475
  426. package/src/installer-config-merge.js +207 -0
  427. package/src/installer.js +449 -358
  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 -691
  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 -167
  442. package/src/lib/security/exit-codes.js +51 -51
  443. package/src/lib/security/findings-writer.js +176 -176
  444. package/src/lib/security/runtime-events.js +77 -77
  445. package/src/lib/security/secrets-regex.js +115 -115
  446. package/src/lib/squads/genome-repair.js +49 -49
  447. package/src/lib/store/security-scan.js +175 -173
  448. package/src/lib/terminal-checkbox.js +135 -130
  449. package/src/lib/terminal-picker.js +447 -0
  450. package/src/lib/tmux-launcher.js +163 -163
  451. package/src/lib/tool-capabilities.js +102 -102
  452. package/src/lib/webhook-server.js +328 -328
  453. package/src/locales.js +88 -88
  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 -756
  463. package/src/parser.js +66 -66
  464. package/src/path-guard.js +47 -47
  465. package/src/permissions-generator.js +400 -0
  466. package/src/preflight-engine.js +654 -654
  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 -142
  477. package/src/session-handoff.js +295 -187
  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 -341
  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 -226
  517. package/src/tool-executor.js +94 -94
  518. package/src/updater.js +39 -39
  519. package/src/utils.js +49 -49
  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 -185
  524. package/template/.aioson/advisors/.gitkeep +1 -1
  525. package/template/.aioson/agents/analyst.md +333 -318
  526. package/template/.aioson/agents/architect.md +325 -305
  527. package/template/.aioson/agents/{cypher.md → briefing.md} +264 -252
  528. package/template/.aioson/agents/committer.md +161 -161
  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 -263
  532. package/template/.aioson/agents/deyvin.md +198 -87
  533. package/template/.aioson/agents/discover.md +235 -235
  534. package/template/.aioson/agents/discovery-design-doc.md +56 -29
  535. package/template/.aioson/agents/genome.md +1904 -364
  536. package/template/.aioson/agents/manifests/analyst.manifest.json +26 -26
  537. package/template/.aioson/agents/manifests/architect.manifest.json +23 -23
  538. package/template/.aioson/agents/manifests/committer.manifest.json +23 -23
  539. package/template/.aioson/agents/manifests/dev.manifest.json +54 -37
  540. package/template/.aioson/agents/manifests/deyvin.manifest.json +41 -0
  541. package/template/.aioson/agents/manifests/orchestrator.manifest.json +30 -30
  542. package/template/.aioson/agents/manifests/pentester.manifest.json +39 -39
  543. package/template/.aioson/agents/manifests/pm.manifest.json +26 -26
  544. package/template/.aioson/agents/manifests/product.manifest.json +23 -23
  545. package/template/.aioson/agents/manifests/qa.manifest.json +41 -25
  546. package/template/.aioson/agents/manifests/setup.manifest.json +20 -20
  547. package/template/.aioson/agents/manifests/ux-ui.manifest.json +24 -24
  548. package/template/.aioson/agents/neo.md +341 -231
  549. package/template/.aioson/agents/orache.md +430 -430
  550. package/template/.aioson/agents/orchestrator.md +274 -263
  551. package/template/.aioson/agents/pair.md +5 -5
  552. package/template/.aioson/agents/pentester.md +289 -235
  553. package/template/.aioson/agents/pm.md +141 -130
  554. package/template/.aioson/agents/product.md +351 -273
  555. package/template/.aioson/agents/profiler-enricher.md +331 -331
  556. package/template/.aioson/agents/profiler-forge.md +212 -212
  557. package/template/.aioson/agents/profiler-researcher.md +282 -282
  558. package/template/.aioson/agents/qa.md +432 -342
  559. package/template/.aioson/agents/setup.md +423 -423
  560. package/template/.aioson/agents/sheldon.md +259 -197
  561. package/template/.aioson/agents/site-forge.md +281 -281
  562. package/template/.aioson/agents/squad.md +160 -156
  563. package/template/.aioson/agents/tester.md +536 -473
  564. package/template/.aioson/agents/ux-ui.md +195 -162
  565. package/template/.aioson/agents/validator.md +101 -69
  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 -107
  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 -43
  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 -410
  577. package/template/.aioson/context/_archived/.gitkeep +0 -0
  578. package/template/.aioson/context/design-doc.md +136 -136
  579. package/template/.aioson/context/project-map.md +57 -57
  580. package/template/.aioson/context/project-pulse.md +34 -34
  581. package/template/.aioson/context/seeds/seed-example.md +27 -27
  582. package/template/.aioson/context/spec.md.template +54 -54
  583. package/template/.aioson/context/user-profile.md +42 -42
  584. package/template/.aioson/design-docs/code-reuse.md +48 -48
  585. package/template/.aioson/design-docs/componentization.md +47 -47
  586. package/template/.aioson/design-docs/file-size.md +52 -52
  587. package/template/.aioson/design-docs/folder-structure.md +51 -51
  588. package/template/.aioson/design-docs/naming.md +54 -54
  589. package/template/.aioson/docs/LAYERS.md +89 -89
  590. package/template/.aioson/docs/README.md +76 -76
  591. package/template/.aioson/docs/autonomy-protocol.md +80 -0
  592. package/template/.aioson/docs/briefing/briefing-craft.md +237 -0
  593. package/template/.aioson/docs/dev/execution-discipline.md +106 -106
  594. package/template/.aioson/docs/dev/stack-conventions.md +83 -83
  595. package/template/.aioson/docs/deyvin/continuity-recovery.md +57 -57
  596. package/template/.aioson/docs/deyvin/debugging-escalation.md +30 -30
  597. package/template/.aioson/docs/deyvin/pair-execution.md +44 -44
  598. package/template/.aioson/docs/deyvin/runtime-handoffs.md +36 -36
  599. package/template/.aioson/docs/example-external-api-context.md +72 -72
  600. package/template/.aioson/docs/pentester/app-playbooks.md +206 -0
  601. package/template/.aioson/docs/pentester/llm-supplychain.md +165 -0
  602. package/template/.aioson/docs/product/conversation-playbook.md +116 -116
  603. package/template/.aioson/docs/product/prd-contract.md +107 -107
  604. package/template/.aioson/docs/product/quality-lens.md +57 -57
  605. package/template/.aioson/docs/product/research-loop.md +65 -65
  606. package/template/.aioson/docs/sheldon/enrichment-paths.md +134 -134
  607. package/template/.aioson/docs/sheldon/harness-contract.md +118 -0
  608. package/template/.aioson/docs/sheldon/quality-lens.md +57 -57
  609. package/template/.aioson/docs/sheldon/research-loop.md +56 -56
  610. package/template/.aioson/docs/sheldon/web-intelligence.md +75 -75
  611. package/template/.aioson/docs/site-forge-build.md +195 -195
  612. package/template/.aioson/docs/site-forge-extraction.md +135 -135
  613. package/template/.aioson/docs/site-forge-qa.md +155 -155
  614. package/template/.aioson/docs/site-forge-recon.md +434 -434
  615. package/template/.aioson/docs/site-forge-transform.md +249 -249
  616. package/template/.aioson/docs/squad/content-output.md +91 -91
  617. package/template/.aioson/docs/squad/creation-flow.md +149 -135
  618. package/template/.aioson/docs/squad/domain-breadth.md +322 -0
  619. package/template/.aioson/docs/squad/domain-classification.md +117 -117
  620. package/template/.aioson/docs/squad/genome-bindings.md +47 -47
  621. package/template/.aioson/docs/squad/package-contract.md +260 -234
  622. package/template/.aioson/docs/squad/quality-lens.md +60 -56
  623. package/template/.aioson/docs/squad/research-loop.md +59 -59
  624. package/template/.aioson/docs/squad/session-operations.md +117 -117
  625. package/template/.aioson/docs/squad/workflow-quality.md +165 -165
  626. package/template/.aioson/docs/tester/coverage-quality.md +351 -0
  627. package/template/.aioson/docs/ux-ui/accessibility-audit.md +55 -55
  628. package/template/.aioson/docs/ux-ui/audit-mode.md +86 -86
  629. package/template/.aioson/docs/ux-ui/component-map.md +35 -35
  630. package/template/.aioson/docs/ux-ui/design-execution.md +111 -111
  631. package/template/.aioson/docs/ux-ui/design-gate.md +27 -27
  632. package/template/.aioson/docs/ux-ui/research-mode.md +39 -39
  633. package/template/.aioson/docs/ux-ui/site-delivery.md +156 -156
  634. package/template/.aioson/docs/ux-ui/token-contract.md +57 -57
  635. package/template/.aioson/genomes/INDEX.md +195 -0
  636. package/template/.aioson/genomes/copywriting/SKILL.md +137 -0
  637. package/template/.aioson/genomes/copywriting/manifest.json +140 -0
  638. package/template/.aioson/genomes/copywriting/references/application-notes.md +145 -0
  639. package/template/.aioson/genomes/copywriting/references/decision-weights.md +45 -0
  640. package/template/.aioson/genomes/copywriting/references/frameworks/5-act-narrative.md +184 -0
  641. package/template/.aioson/genomes/copywriting/references/frameworks/classical-formulas.md +164 -0
  642. package/template/.aioson/genomes/copywriting/references/frameworks/offer-stack.md +195 -0
  643. package/template/.aioson/genomes/copywriting/references/frameworks/one-belief.md +135 -0
  644. package/template/.aioson/genomes/copywriting/references/frameworks/pms-research.md +211 -0
  645. package/template/.aioson/genomes/copywriting/references/frameworks/two-paths-close.md +190 -0
  646. package/template/.aioson/genomes/copywriting/references/heuristics.md +114 -0
  647. package/template/.aioson/genomes/copywriting/references/meta-axioms.md +68 -0
  648. package/template/.aioson/genomes/copywriting/references/methodology.md +115 -0
  649. package/template/.aioson/genomes/copywriting-brunson/SKILL.md +133 -0
  650. package/template/.aioson/genomes/copywriting-brunson/manifest.json +152 -0
  651. package/template/.aioson/genomes/copywriting-brunson/references/application-notes.md +113 -0
  652. package/template/.aioson/genomes/copywriting-brunson/references/decision-weights.md +33 -0
  653. package/template/.aioson/genomes/copywriting-brunson/references/evidence-and-attribution.md +81 -0
  654. package/template/.aioson/genomes/copywriting-brunson/references/frameworks/6-part-structure.md +136 -0
  655. package/template/.aioson/genomes/copywriting-brunson/references/frameworks/origin-story.md +121 -0
  656. package/template/.aioson/genomes/copywriting-brunson/references/frameworks/perfect-webinar-script.md +139 -0
  657. package/template/.aioson/genomes/copywriting-brunson/references/frameworks/persuasive-storytelling-5-structures.md +164 -0
  658. package/template/.aioson/genomes/copywriting-brunson/references/frameworks/value-stack.md +136 -0
  659. package/template/.aioson/genomes/copywriting-brunson/references/frameworks/who-what-why-how.md +110 -0
  660. package/template/.aioson/genomes/copywriting-brunson/references/meta-axioms.md +36 -0
  661. package/template/.aioson/genomes/copywriting-brunson/references/methodology.md +112 -0
  662. package/template/.aioson/git-guard.json +12 -11
  663. package/template/.aioson/mcp/servers.md +23 -23
  664. package/template/.aioson/profiler-reports/.gitkeep +1 -1
  665. package/template/.aioson/rules/README.md +69 -69
  666. package/template/.aioson/rules/_archived/.gitkeep +0 -0
  667. package/template/.aioson/rules/agent-language-policy.md +93 -93
  668. package/template/.aioson/rules/aioson-context-boundary.md +63 -63
  669. package/template/.aioson/rules/canonical-path-contract.md +47 -47
  670. package/template/.aioson/rules/data-format-convention.md +74 -74
  671. package/template/.aioson/rules/disk-first-artifacts.md +44 -44
  672. package/template/.aioson/rules/example-monetary-values.md +30 -30
  673. package/template/.aioson/rules/output-brevity.md +44 -44
  674. package/template/.aioson/rules/prd-section-ownership.md +49 -49
  675. package/template/.aioson/rules/security-baseline.md +139 -139
  676. package/template/.aioson/rules/spec-level-ownership.md +61 -61
  677. package/template/.aioson/rules/squad/README.md +50 -50
  678. package/template/.aioson/rules/squad-driver-pattern.md +81 -81
  679. package/template/.aioson/schemas/content-blueprint.schema.json +30 -30
  680. package/template/.aioson/schemas/genome-meta.schema.json +150 -150
  681. package/template/.aioson/schemas/genome.schema.json +115 -115
  682. package/template/.aioson/schemas/readiness.schema.json +27 -27
  683. package/template/.aioson/schemas/squad-blueprint.schema.json +228 -228
  684. package/template/.aioson/schemas/squad-manifest.schema.json +874 -874
  685. package/template/.aioson/skills/design/aurora-command-ui/SKILL.md +243 -243
  686. package/template/.aioson/skills/design/aurora-command-ui/references/art-direction.md +293 -293
  687. package/template/.aioson/skills/design/aurora-command-ui/references/components.md +827 -827
  688. package/template/.aioson/skills/design/aurora-command-ui/references/dashboards.md +250 -250
  689. package/template/.aioson/skills/design/aurora-command-ui/references/design-tokens.md +585 -585
  690. package/template/.aioson/skills/design/aurora-command-ui/references/motion.md +365 -365
  691. package/template/.aioson/skills/design/aurora-command-ui/references/patterns.md +482 -482
  692. package/template/.aioson/skills/design/aurora-command-ui/references/websites.md +387 -387
  693. package/template/.aioson/skills/design/bold-editorial-ui/SKILL.md +205 -205
  694. package/template/.aioson/skills/design/bold-editorial-ui/references/art-direction.md +338 -338
  695. package/template/.aioson/skills/design/bold-editorial-ui/references/components.md +977 -977
  696. package/template/.aioson/skills/design/bold-editorial-ui/references/dashboards.md +218 -218
  697. package/template/.aioson/skills/design/bold-editorial-ui/references/design-tokens.md +326 -326
  698. package/template/.aioson/skills/design/bold-editorial-ui/references/motion.md +461 -461
  699. package/template/.aioson/skills/design/bold-editorial-ui/references/patterns.md +293 -293
  700. package/template/.aioson/skills/design/bold-editorial-ui/references/websites.md +352 -352
  701. package/template/.aioson/skills/design/clean-saas-ui/SKILL.md +210 -210
  702. package/template/.aioson/skills/design/clean-saas-ui/references/art-direction.md +319 -319
  703. package/template/.aioson/skills/design/clean-saas-ui/references/components.md +365 -365
  704. package/template/.aioson/skills/design/clean-saas-ui/references/dashboards.md +196 -196
  705. package/template/.aioson/skills/design/clean-saas-ui/references/design-tokens.md +244 -244
  706. package/template/.aioson/skills/design/clean-saas-ui/references/motion.md +235 -235
  707. package/template/.aioson/skills/design/clean-saas-ui/references/patterns.md +215 -215
  708. package/template/.aioson/skills/design/clean-saas-ui/references/websites.md +295 -295
  709. package/template/.aioson/skills/design/cognitive-core-ui/SKILL.md +203 -203
  710. package/template/.aioson/skills/design/cognitive-core-ui/references/art-direction.md +339 -339
  711. package/template/.aioson/skills/design/cognitive-core-ui/references/components.md +407 -407
  712. package/template/.aioson/skills/design/cognitive-core-ui/references/dashboards.md +272 -272
  713. package/template/.aioson/skills/design/cognitive-core-ui/references/design-tokens.md +524 -524
  714. package/template/.aioson/skills/design/cognitive-core-ui/references/motion.md +279 -279
  715. package/template/.aioson/skills/design/cognitive-core-ui/references/patterns.md +289 -289
  716. package/template/.aioson/skills/design/cognitive-core-ui/references/websites.md +437 -437
  717. package/template/.aioson/skills/design/glassmorphism-ui/SKILL.md +222 -222
  718. package/template/.aioson/skills/design/glassmorphism-ui/references/art-direction.md +159 -159
  719. package/template/.aioson/skills/design/glassmorphism-ui/references/components.md +498 -498
  720. package/template/.aioson/skills/design/glassmorphism-ui/references/dashboards.md +236 -236
  721. package/template/.aioson/skills/design/glassmorphism-ui/references/design-tokens.md +274 -274
  722. package/template/.aioson/skills/design/glassmorphism-ui/references/motion.md +355 -355
  723. package/template/.aioson/skills/design/glassmorphism-ui/references/patterns.md +198 -198
  724. package/template/.aioson/skills/design/glassmorphism-ui/references/websites.md +307 -307
  725. package/template/.aioson/skills/design/interface-design/SKILL.md +47 -47
  726. package/template/.aioson/skills/design/interface-design/references/components-and-states.md +105 -105
  727. package/template/.aioson/skills/design/interface-design/references/design-directions.md +101 -101
  728. package/template/.aioson/skills/design/interface-design/references/handoff-and-quality.md +71 -71
  729. package/template/.aioson/skills/design/interface-design/references/intent-and-domain.md +74 -74
  730. package/template/.aioson/skills/design/interface-design/references/tokens-and-depth.md +173 -173
  731. package/template/.aioson/skills/design/neo-brutalist-ui/SKILL.md +213 -213
  732. package/template/.aioson/skills/design/neo-brutalist-ui/references/art-direction.md +228 -228
  733. package/template/.aioson/skills/design/neo-brutalist-ui/references/components.md +855 -855
  734. package/template/.aioson/skills/design/neo-brutalist-ui/references/dashboards.md +334 -334
  735. package/template/.aioson/skills/design/neo-brutalist-ui/references/design-tokens.md +342 -342
  736. package/template/.aioson/skills/design/neo-brutalist-ui/references/motion.md +286 -286
  737. package/template/.aioson/skills/design/neo-brutalist-ui/references/patterns.md +458 -458
  738. package/template/.aioson/skills/design/neo-brutalist-ui/references/websites.md +723 -723
  739. package/template/.aioson/skills/design/premium-command-center-ui/SKILL.md +62 -62
  740. package/template/.aioson/skills/design/premium-command-center-ui/references/operations.md +74 -74
  741. package/template/.aioson/skills/design/premium-command-center-ui/references/patterns.md +116 -116
  742. package/template/.aioson/skills/design/premium-command-center-ui/references/validation.md +47 -47
  743. package/template/.aioson/skills/design/premium-command-center-ui/references/visual-system.md +215 -215
  744. package/template/.aioson/skills/design/pt.squarespace.com/.skill-meta.json +31 -31
  745. package/template/.aioson/skills/design/pt.squarespace.com/SKILL.md +66 -66
  746. package/template/.aioson/skills/design/pt.squarespace.com/references/components.md +368 -368
  747. package/template/.aioson/skills/design/pt.squarespace.com/references/design-tokens.md +150 -150
  748. package/template/.aioson/skills/design/pt.squarespace.com/references/motion.md +270 -270
  749. package/template/.aioson/skills/design/pt.squarespace.com/references/patterns.md +189 -189
  750. package/template/.aioson/skills/design/pt.squarespace.com/references/websites.md +165 -165
  751. package/template/.aioson/skills/design/warm-craft-ui/SKILL.md +209 -209
  752. package/template/.aioson/skills/design/warm-craft-ui/references/art-direction.md +324 -324
  753. package/template/.aioson/skills/design/warm-craft-ui/references/components.md +508 -508
  754. package/template/.aioson/skills/design/warm-craft-ui/references/dashboards.md +223 -223
  755. package/template/.aioson/skills/design/warm-craft-ui/references/design-tokens.md +374 -374
  756. package/template/.aioson/skills/design/warm-craft-ui/references/motion.md +356 -356
  757. package/template/.aioson/skills/design/warm-craft-ui/references/patterns.md +288 -288
  758. package/template/.aioson/skills/design/warm-craft-ui/references/websites.md +289 -289
  759. package/template/.aioson/skills/design-system/SKILL.md +92 -92
  760. package/template/.aioson/skills/design-system/components/SKILL.md +274 -274
  761. package/template/.aioson/skills/design-system/dashboards/SKILL.md +184 -184
  762. package/template/.aioson/skills/design-system/foundations/SKILL.md +250 -250
  763. package/template/.aioson/skills/design-system/motion/SKILL.md +197 -197
  764. package/template/.aioson/skills/design-system/patterns/SKILL.md +231 -231
  765. package/template/.aioson/skills/dynamic/README.md +30 -30
  766. package/template/.aioson/skills/dynamic/cardano-docs.md +16 -16
  767. package/template/.aioson/skills/dynamic/ethereum-docs.md +17 -17
  768. package/template/.aioson/skills/dynamic/flux-ui-docs.md +13 -13
  769. package/template/.aioson/skills/dynamic/laravel-docs.md +41 -41
  770. package/template/.aioson/skills/dynamic/npm-packages.md +16 -16
  771. package/template/.aioson/skills/dynamic/solana-docs.md +16 -16
  772. package/template/.aioson/skills/marketing/references/anti-patterns.md +254 -254
  773. package/template/.aioson/skills/marketing/references/cta-matrix.md +361 -0
  774. package/template/.aioson/skills/marketing/references/fascinations.md +192 -192
  775. package/template/.aioson/skills/marketing/references/five-acts.md +248 -248
  776. package/template/.aioson/skills/marketing/references/headline-matrix.md +358 -0
  777. package/template/.aioson/skills/marketing/references/market-intelligence.md +198 -198
  778. package/template/.aioson/skills/marketing/references/offer-structure.md +203 -203
  779. package/template/.aioson/skills/marketing/references/one-belief.md +149 -149
  780. package/template/.aioson/skills/marketing/references/patterns.md +218 -218
  781. package/template/.aioson/skills/marketing/references/platform-constraints.md +337 -0
  782. package/template/.aioson/skills/marketing/references/pms-research.md +193 -193
  783. package/template/.aioson/skills/marketing/vsl-craft.md +385 -385
  784. package/template/.aioson/skills/premium-visual-design/SKILL.md +83 -83
  785. package/template/.aioson/skills/premium-visual-design/components/agent-badge.md +92 -92
  786. package/template/.aioson/skills/premium-visual-design/components/dependency-node.md +102 -102
  787. package/template/.aioson/skills/premium-visual-design/components/mention-autocomplete.md +136 -136
  788. package/template/.aioson/skills/premium-visual-design/components/notification-center.md +136 -136
  789. package/template/.aioson/skills/premium-visual-design/components/review-action-bar.md +188 -188
  790. package/template/.aioson/skills/premium-visual-design/components/team-switcher.md +131 -131
  791. package/template/.aioson/skills/premium-visual-design/patterns/agent-message-thread.md +198 -198
  792. package/template/.aioson/skills/premium-visual-design/patterns/notification-panel.md +275 -275
  793. package/template/.aioson/skills/premium-visual-design/patterns/review-workflow-ui.md +234 -234
  794. package/template/.aioson/skills/premium-visual-design/patterns/task-dependency-graph.md +147 -147
  795. package/template/.aioson/skills/premium-visual-design/tokens/status-extended.md +142 -142
  796. package/template/.aioson/skills/process/aioson-spec-driven/SKILL.md +46 -46
  797. package/template/.aioson/skills/process/aioson-spec-driven/references/analyst.md +30 -30
  798. package/template/.aioson/skills/process/aioson-spec-driven/references/approval-gates.md +109 -109
  799. package/template/.aioson/skills/process/aioson-spec-driven/references/architect.md +23 -23
  800. package/template/.aioson/skills/process/aioson-spec-driven/references/artifact-map.md +44 -44
  801. package/template/.aioson/skills/process/aioson-spec-driven/references/classification-map.md +37 -37
  802. package/template/.aioson/skills/process/aioson-spec-driven/references/dev.md +47 -47
  803. package/template/.aioson/skills/process/aioson-spec-driven/references/deyvin.md +27 -27
  804. package/template/.aioson/skills/process/aioson-spec-driven/references/hardening-lane.md +49 -49
  805. package/template/.aioson/skills/process/aioson-spec-driven/references/maintenance-and-state.md +101 -101
  806. package/template/.aioson/skills/process/aioson-spec-driven/references/pm.md +30 -30
  807. package/template/.aioson/skills/process/aioson-spec-driven/references/product.md +25 -25
  808. package/template/.aioson/skills/process/aioson-spec-driven/references/qa.md +30 -30
  809. package/template/.aioson/skills/process/aioson-spec-driven/references/sheldon.md +25 -25
  810. package/template/.aioson/skills/process/aioson-spec-driven/references/ui-language.md +75 -75
  811. package/template/.aioson/skills/process/design-hybrid-forge/SKILL.md +147 -147
  812. package/template/.aioson/skills/process/design-hybrid-forge/references/crossover-protocol.md +221 -221
  813. package/template/.aioson/skills/process/design-hybrid-forge/references/naming-registry.md +88 -88
  814. package/template/.aioson/skills/process/design-hybrid-forge/references/output-contract.md +306 -306
  815. package/template/.aioson/skills/process/design-hybrid-forge/references/pair-compatibility.md +149 -149
  816. package/template/.aioson/skills/process/design-hybrid-forge/references/quality-gates.md +208 -208
  817. package/template/.aioson/skills/process/design-hybrid-forge/references/variation-library.md +125 -125
  818. package/template/.aioson/skills/process/secure-tdd/SKILL.md +97 -97
  819. package/template/.aioson/skills/process/simplify/SKILL.md +173 -173
  820. package/template/.aioson/skills/references/premium-command-center-ui/master-application-prompt.md +79 -79
  821. package/template/.aioson/skills/references/premium-command-center-ui/operational-ux-playbook.md +253 -253
  822. package/template/.aioson/skills/references/premium-command-center-ui/quality-validation-checklist.md +82 -82
  823. package/template/.aioson/skills/references/premium-command-center-ui/visual-system-and-component-patterns.md +270 -270
  824. package/template/.aioson/skills/squad/SKILL.md +58 -58
  825. package/template/.aioson/skills/squad/formats/catalog.json +15 -15
  826. package/template/.aioson/skills/squad/formats/content/blog-post.md +47 -47
  827. package/template/.aioson/skills/squad/formats/content/newsletter.md +47 -47
  828. package/template/.aioson/skills/squad/formats/creative/podcast-script.md +43 -43
  829. package/template/.aioson/skills/squad/formats/creative/video-script.md +41 -41
  830. package/template/.aioson/skills/squad/formats/social/instagram-feed.md +42 -42
  831. package/template/.aioson/skills/squad/formats/social/linkedin-post.md +42 -42
  832. package/template/.aioson/skills/squad/formats/social/tiktok.md +39 -39
  833. package/template/.aioson/skills/squad/formats/social/twitter-thread.md +39 -39
  834. package/template/.aioson/skills/squad/formats/social/youtube-long.md +47 -47
  835. package/template/.aioson/skills/squad/formats/social/youtube-shorts.md +39 -39
  836. package/template/.aioson/skills/squad/patterns/multi-platform-pattern.md +108 -108
  837. package/template/.aioson/skills/squad/patterns/persona-based-pattern.md +98 -98
  838. package/template/.aioson/skills/squad/patterns/pipeline-pattern.md +106 -106
  839. package/template/.aioson/skills/squad/patterns/review-loop-pattern.md +81 -81
  840. package/template/.aioson/skills/squad/references/checklist-templates.md +122 -122
  841. package/template/.aioson/skills/squad/references/executor-archetypes.md +123 -123
  842. package/template/.aioson/skills/squad/references/workflow-templates.md +169 -169
  843. package/template/.aioson/skills/static/context-budget-guide.md +46 -46
  844. package/template/.aioson/skills/static/debugging-protocol.md +42 -42
  845. package/template/.aioson/skills/static/django-patterns.md +342 -342
  846. package/template/.aioson/skills/static/fastapi-patterns.md +344 -344
  847. package/template/.aioson/skills/static/filament-patterns.md +267 -267
  848. package/template/.aioson/skills/static/flux-ui-components.md +262 -262
  849. package/template/.aioson/skills/static/git-conventions.md +227 -227
  850. package/template/.aioson/skills/static/git-worktrees.md +36 -36
  851. package/template/.aioson/skills/static/harness-sensors.md +74 -74
  852. package/template/.aioson/skills/static/harness-validate/SKILL.md +46 -46
  853. package/template/.aioson/skills/static/jetstream-setup.md +200 -200
  854. package/template/.aioson/skills/static/landing-page-deploy.md +192 -192
  855. package/template/.aioson/skills/static/landing-page-forge.md +730 -730
  856. package/template/.aioson/skills/static/laravel-conventions.md +491 -491
  857. package/template/.aioson/skills/static/multi-agent-patterns.md +43 -43
  858. package/template/.aioson/skills/static/nextjs-patterns.md +321 -321
  859. package/template/.aioson/skills/static/node-express-patterns.md +317 -317
  860. package/template/.aioson/skills/static/node-typescript-patterns.md +282 -282
  861. package/template/.aioson/skills/static/rails-conventions.md +307 -307
  862. package/template/.aioson/skills/static/react-motion-patterns.md +599 -599
  863. package/template/.aioson/skills/static/static-html-patterns/checklists.md +43 -43
  864. package/template/.aioson/skills/static/static-html-patterns/css-tokens.md +609 -609
  865. package/template/.aioson/skills/static/static-html-patterns/motion.md +193 -193
  866. package/template/.aioson/skills/static/static-html-patterns/premium.md +711 -711
  867. package/template/.aioson/skills/static/static-html-patterns/structure.md +209 -209
  868. package/template/.aioson/skills/static/static-html-patterns/utilities.md +190 -190
  869. package/template/.aioson/skills/static/static-html-patterns.md +80 -80
  870. package/template/.aioson/skills/static/tall-stack-patterns.md +286 -286
  871. package/template/.aioson/skills/static/threejs-patterns.md +929 -929
  872. package/template/.aioson/skills/static/ui-ux-modern.md +76 -76
  873. package/template/.aioson/skills/static/web-research-cache.md +115 -115
  874. package/template/.aioson/skills/static/web3-cardano-patterns.md +337 -337
  875. package/template/.aioson/skills/static/web3-ethereum-patterns.md +310 -310
  876. package/template/.aioson/skills/static/web3-security-checklist.md +284 -284
  877. package/template/.aioson/skills/static/web3-solana-patterns.md +324 -324
  878. package/template/.aioson/squads/memory.md +5 -5
  879. package/template/.aioson/tasks/implementation-plan.md +327 -327
  880. package/template/.aioson/tasks/squad-analyze.md +83 -83
  881. package/template/.aioson/tasks/squad-create.md +148 -148
  882. package/template/.aioson/tasks/squad-design.md +206 -206
  883. package/template/.aioson/tasks/squad-execution-plan.md +279 -279
  884. package/template/.aioson/tasks/squad-export.md +20 -20
  885. package/template/.aioson/tasks/squad-extend.md +68 -68
  886. package/template/.aioson/tasks/squad-investigate.md +57 -57
  887. package/template/.aioson/tasks/squad-learning-review.md +44 -44
  888. package/template/.aioson/tasks/squad-output-config.md +177 -177
  889. package/template/.aioson/tasks/squad-pipeline.md +122 -122
  890. package/template/.aioson/tasks/squad-profile.md +48 -48
  891. package/template/.aioson/tasks/squad-refresh.md +236 -0
  892. package/template/.aioson/tasks/squad-repair.md +85 -85
  893. package/template/.aioson/tasks/squad-review.md +61 -61
  894. package/template/.aioson/tasks/squad-task-decompose.md +66 -66
  895. package/template/.aioson/tasks/squad-validate.md +58 -58
  896. package/template/.aioson/templates/reflect-prompts/current-state.md +36 -0
  897. package/template/.aioson/templates/reflect-prompts/how-it-works.md +23 -0
  898. package/template/.aioson/templates/reflect-prompts/what-it-does.md +21 -0
  899. package/template/.aioson/templates/squads/content-basic/template.json +21 -21
  900. package/template/.aioson/templates/squads/digital-marketing-agency/template.json +96 -96
  901. package/template/.aioson/templates/squads/media-channel/template.json +24 -24
  902. package/template/.aioson/templates/squads/research-analysis/template.json +22 -22
  903. package/template/.aioson/templates/squads/software-delivery/template.json +21 -21
  904. package/template/.claude/commands/aioson/agent/analyst.md +5 -5
  905. package/template/.claude/commands/aioson/agent/architect.md +5 -5
  906. package/template/.claude/commands/aioson/agent/briefing.md +5 -0
  907. package/template/.claude/commands/aioson/agent/committer.md +5 -5
  908. package/template/.claude/commands/aioson/agent/copywriter.md +5 -5
  909. package/template/.claude/commands/aioson/agent/design-hybrid-forge.md +5 -5
  910. package/template/.claude/commands/aioson/agent/dev.md +5 -5
  911. package/template/.claude/commands/aioson/agent/deyvin.md +5 -5
  912. package/template/.claude/commands/aioson/agent/discover.md +5 -0
  913. package/template/.claude/commands/aioson/agent/discovery-design-doc.md +5 -5
  914. package/template/.claude/commands/aioson/agent/genome.md +5 -5
  915. package/template/.claude/commands/aioson/agent/neo.md +5 -5
  916. package/template/.claude/commands/aioson/agent/orache.md +5 -5
  917. package/template/.claude/commands/aioson/agent/orchestrator.md +5 -5
  918. package/template/.claude/commands/aioson/agent/pair.md +5 -5
  919. package/template/.claude/commands/aioson/agent/pentester.md +5 -0
  920. package/template/.claude/commands/aioson/agent/pm.md +5 -5
  921. package/template/.claude/commands/aioson/agent/product.md +5 -5
  922. package/template/.claude/commands/aioson/agent/profiler-enricher.md +5 -5
  923. package/template/.claude/commands/aioson/agent/profiler-forge.md +5 -5
  924. package/template/.claude/commands/aioson/agent/profiler-researcher.md +5 -5
  925. package/template/.claude/commands/aioson/agent/qa.md +5 -5
  926. package/template/.claude/commands/aioson/agent/setup.md +5 -5
  927. package/template/.claude/commands/aioson/agent/sheldon.md +5 -5
  928. package/template/.claude/commands/aioson/agent/site-forge.md +5 -5
  929. package/template/.claude/commands/aioson/agent/squad.md +5 -5
  930. package/template/.claude/commands/aioson/agent/tester.md +5 -5
  931. package/template/.claude/commands/aioson/agent/ux-ui.md +5 -5
  932. package/template/.claude/commands/aioson/agent/validator.md +5 -5
  933. package/template/.gemini/GEMINI.md +13 -13
  934. package/template/.gemini/commands/aios-analyst.toml +7 -7
  935. package/template/.gemini/commands/aios-architect.toml +8 -8
  936. package/template/.gemini/commands/aios-committer.toml +7 -7
  937. package/template/.gemini/commands/aios-copywriter.toml +7 -7
  938. package/template/.gemini/commands/aios-cypher.toml +7 -7
  939. package/template/.gemini/commands/aios-dev.toml +9 -9
  940. package/template/.gemini/commands/aios-deyvin.toml +7 -7
  941. package/template/.gemini/commands/aios-discover.toml +6 -0
  942. package/template/.gemini/commands/aios-discovery-design-doc.toml +7 -7
  943. package/template/.gemini/commands/aios-genome.toml +7 -7
  944. package/template/.gemini/commands/aios-neo.toml +6 -6
  945. package/template/.gemini/commands/aios-orache.toml +7 -7
  946. package/template/.gemini/commands/aios-orchestrator.toml +9 -9
  947. package/template/.gemini/commands/aios-pair.toml +7 -7
  948. package/template/.gemini/commands/aios-pm.toml +9 -9
  949. package/template/.gemini/commands/aios-product.toml +6 -6
  950. package/template/.gemini/commands/aios-qa.toml +7 -7
  951. package/template/.gemini/commands/aios-setup.toml +6 -6
  952. package/template/.gemini/commands/aios-sheldon.toml +7 -7
  953. package/template/.gemini/commands/aios-site-forge.toml +7 -7
  954. package/template/.gemini/commands/aios-squad.toml +7 -7
  955. package/template/.gemini/commands/aios-tester.toml +7 -7
  956. package/template/.gemini/commands/aios-ux-ui.toml +9 -9
  957. package/template/.gemini/commands/aios-validator.toml +7 -7
  958. package/template/AGENTS.md +184 -183
  959. package/template/CLAUDE.md +98 -97
  960. package/template/OPENCODE.md +35 -34
  961. package/template/aioson-models.json +40 -40
  962. package/template/.aioson/genomes/copywriting.md +0 -204
  963. package/template/.aioson/genomes/copywriting.meta.json +0 -48
  964. package/template/.aioson/skills/process/secure-tdd/references/nextjs.md +0 -81
  965. package/template/.aioson/skills/process/secure-tdd/references/node-express.md +0 -91
  966. package/template/.aioson/skills/process/secure-tdd/references/planned-stacks.md +0 -33
  967. package/template/.claude/commands/aioson/agent/cypher.md +0 -5
@@ -1,730 +1,730 @@
1
- ---
2
- name: landing-page-forge
3
- description: Advanced landing page production skill — animation libraries (GSAP, AnimeJS), high-impact motion patterns (horizontal scroll, magnetic mouse, hero sequences), performance checklist, SEO/LLMO setup, tracking integration. Load when building landing pages, sales pages, event pages, or any conversion-focused page.
4
- ---
5
-
6
- # Landing Page Forge
7
-
8
- Production playbook for landing pages that convert. Covers animation craft, performance, discoverability, and tracking — the full stack from visual to measurable.
9
-
10
- ---
11
-
12
- ## 1. Animation library choice
13
-
14
- ### GSAP (GreenSock Animation Platform)
15
- **Use when:** you need scroll-driven horizontal sections, magnetic mouse effects, SVG animations, or complex sequenced timelines.
16
-
17
- ```html
18
- <!-- CDN (free tier covers most needs) -->
19
- <script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/gsap.min.js"></script>
20
- <script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/ScrollTrigger.min.js"></script>
21
- ```
22
-
23
- ```js
24
- gsap.registerPlugin(ScrollTrigger);
25
- ```
26
-
27
- **npm:** `npm install gsap`
28
-
29
- ### AnimeJS
30
- **Use when:** you want lightweight, zero-dependency micro-animations — counters, SVG morphing, staggered list reveals, hover interactions.
31
-
32
- ```html
33
- <script src="https://cdnjs.cloudflare.com/ajax/libs/animejs/3.2.1/anime.min.js"></script>
34
- ```
35
-
36
- **npm:** `npm install animejs`
37
-
38
- ### When to use which
39
-
40
- | Effect | Library |
41
- |---|---|
42
- | Horizontal scroll section | GSAP + ScrollTrigger |
43
- | Magnetic mouse / cursor aura | GSAP |
44
- | Scroll-reveal stagger | Either (GSAP for precision, AnimeJS for light pages) |
45
- | Number count-up | AnimeJS |
46
- | SVG path drawing | AnimeJS |
47
- | Complex parallax | GSAP |
48
- | Simple fade-in sequence | CSS keyframes (no library needed) |
49
-
50
- ---
51
-
52
- ## 2. High-impact motion patterns
53
-
54
- ### 2.1 Horizontal scroll marquee (infinite ticker)
55
-
56
- Feature strip, client logos, testimonials — scrolls sideways while user scrolls down.
57
-
58
- ```html
59
- <section class="marquee-section">
60
- <div class="marquee-track">
61
- <div class="marquee-items" id="marqueeItems">
62
- <!-- items duplicated in JS -->
63
- </div>
64
- </div>
65
- </section>
66
- ```
67
-
68
- ```css
69
- .marquee-section { overflow: hidden; }
70
- .marquee-track { display: flex; }
71
- .marquee-items { display: flex; gap: 48px; white-space: nowrap; will-change: transform; }
72
- ```
73
-
74
- ```js
75
- // GSAP infinite marquee
76
- gsap.to("#marqueeItems", {
77
- x: "-50%",
78
- duration: 20,
79
- ease: "none",
80
- repeat: -1
81
- });
82
- // Clone items for seamless loop
83
- const items = document.getElementById("marqueeItems");
84
- items.innerHTML += items.innerHTML;
85
- ```
86
-
87
- ### 2.2 Horizontal scroll section (scroll → move sideways)
88
-
89
- Cards or features that slide horizontally as user scrolls vertically.
90
-
91
- ```html
92
- <section class="h-scroll-wrapper">
93
- <div class="h-scroll-pin">
94
- <div class="h-scroll-track" id="hTrack">
95
- <div class="h-scroll-card">...</div>
96
- <div class="h-scroll-card">...</div>
97
- <div class="h-scroll-card">...</div>
98
- </div>
99
- </div>
100
- </section>
101
- ```
102
-
103
- ```css
104
- .h-scroll-wrapper { height: 300vh; }
105
- .h-scroll-pin { position: sticky; top: 0; overflow: hidden; height: 100vh; }
106
- .h-scroll-track { display: flex; width: max-content; }
107
- .h-scroll-card { width: 80vw; flex-shrink: 0; margin-right: 32px; }
108
- ```
109
-
110
- ```js
111
- const track = document.getElementById("hTrack");
112
- const totalWidth = track.scrollWidth - window.innerWidth;
113
-
114
- gsap.to(track, {
115
- x: () => -totalWidth,
116
- ease: "none",
117
- scrollTrigger: {
118
- trigger: ".h-scroll-wrapper",
119
- start: "top top",
120
- end: "bottom top",
121
- scrub: 1,
122
- pin: ".h-scroll-pin",
123
- anticipatePin: 1
124
- }
125
- });
126
- ```
127
-
128
- ### 2.3 Magnetic mouse effect (cursor aura / hover field)
129
-
130
- Interactive element that subtly follows the cursor — gives premium tactile feel.
131
-
132
- ```html
133
- <div class="magnetic-btn" id="magneticBtn">
134
- <span>Get Started</span>
135
- </div>
136
- ```
137
-
138
- ```js
139
- const btn = document.getElementById("magneticBtn");
140
-
141
- btn.addEventListener("mousemove", (e) => {
142
- const rect = btn.getBoundingClientRect();
143
- const x = e.clientX - rect.left - rect.width / 2;
144
- const y = e.clientY - rect.top - rect.height / 2;
145
- const strength = 0.35;
146
-
147
- gsap.to(btn, {
148
- x: x * strength,
149
- y: y * strength,
150
- duration: 0.3,
151
- ease: "power2.out"
152
- });
153
- });
154
-
155
- btn.addEventListener("mouseleave", () => {
156
- gsap.to(btn, { x: 0, y: 0, duration: 0.5, ease: "elastic.out(1, 0.4)" });
157
- });
158
- ```
159
-
160
- **Cursor aura (glow that follows mouse globally):**
161
- ```html
162
- <div class="cursor-aura" id="cursorAura"></div>
163
- ```
164
-
165
- ```css
166
- .cursor-aura {
167
- position: fixed;
168
- width: 300px;
169
- height: 300px;
170
- border-radius: 50%;
171
- background: radial-gradient(circle, rgba(99,102,241,0.12) 0%, transparent 70%);
172
- pointer-events: none;
173
- transform: translate(-50%, -50%);
174
- z-index: 0;
175
- transition: opacity 0.3s;
176
- }
177
- ```
178
-
179
- ```js
180
- document.addEventListener("mousemove", (e) => {
181
- gsap.to("#cursorAura", {
182
- x: e.clientX,
183
- y: e.clientY,
184
- duration: 0.6,
185
- ease: "power2.out"
186
- });
187
- });
188
- ```
189
-
190
- ### 2.4 Scroll-reveal stagger (IntersectionObserver)
191
-
192
- Elements fade in as they enter the viewport — staggered per group.
193
-
194
- ```html
195
- <div class="reveal-group">
196
- <div class="reveal-item">...</div>
197
- <div class="reveal-item">...</div>
198
- <div class="reveal-item">...</div>
199
- </div>
200
- ```
201
-
202
- ```css
203
- .reveal-item {
204
- opacity: 0;
205
- transform: translateY(32px);
206
- transition: opacity 0.6s cubic-bezier(0.16, 1, 0.3, 1),
207
- transform 0.6s cubic-bezier(0.16, 1, 0.3, 1);
208
- }
209
- .reveal-item.visible {
210
- opacity: 1;
211
- transform: translateY(0);
212
- }
213
- ```
214
-
215
- ```js
216
- const observer = new IntersectionObserver((entries) => {
217
- entries.forEach((entry, i) => {
218
- if (entry.isIntersecting) {
219
- setTimeout(() => entry.target.classList.add("visible"), i * 80);
220
- observer.unobserve(entry.target);
221
- }
222
- });
223
- }, { threshold: 0.15 });
224
-
225
- document.querySelectorAll(".reveal-item").forEach(el => observer.observe(el));
226
- ```
227
-
228
- ### 2.5 Number counter animation (AnimeJS)
229
-
230
- Stats and metrics that count up when scrolled into view.
231
-
232
- ```html
233
- <span class="counter" data-target="200">0</span>
234
- ```
235
-
236
- ```js
237
- const counterObserver = new IntersectionObserver((entries) => {
238
- entries.forEach(entry => {
239
- if (!entry.isIntersecting) return;
240
- const el = entry.target;
241
- const target = +el.dataset.target;
242
- anime({
243
- targets: el,
244
- innerHTML: [0, target],
245
- round: 1,
246
- duration: 1800,
247
- easing: "easeOutExpo",
248
- update: () => { el.innerHTML = Math.round(el.innerHTML); }
249
- });
250
- counterObserver.unobserve(el);
251
- });
252
- }, { threshold: 0.5 });
253
-
254
- document.querySelectorAll(".counter").forEach(el => counterObserver.observe(el));
255
- ```
256
-
257
- ### 2.6 Hero entrance sequence
258
-
259
- Staggered load sequence for above-the-fold hero sections.
260
-
261
- ```js
262
- // GSAP timeline — fires on page load
263
- const heroTL = gsap.timeline({ defaults: { ease: "power3.out" } });
264
-
265
- heroTL
266
- .from(".hero-eyebrow", { y: 20, opacity: 0, duration: 0.6 })
267
- .from(".hero-heading", { y: 30, opacity: 0, duration: 0.8 }, "-=0.3")
268
- .from(".hero-sub", { y: 20, opacity: 0, duration: 0.6 }, "-=0.4")
269
- .from(".hero-cta", { y: 20, opacity: 0, duration: 0.5, stagger: 0.1 }, "-=0.3")
270
- .from(".hero-media", { scale: 0.96, opacity: 0, duration: 0.8 }, "-=0.5");
271
- ```
272
-
273
- ---
274
-
275
- ## 3. Performance checklist (< 2.5 s load target)
276
-
277
- ### Images
278
- - [ ] Use WebP format for all photography and illustrations
279
- - [ ] Set `loading="lazy"` on all images below the fold
280
- - [ ] Preload hero/above-the-fold image: `<link rel="preload" as="image" href="hero.webp">`
281
- - [ ] Specify `width` and `height` on every `<img>` to prevent layout shift
282
- - [ ] Use `srcset` for responsive image sizes
283
-
284
- ### Fonts
285
- - [ ] Self-host or use `font-display: swap`
286
- - [ ] Preconnect to font CDN: `<link rel="preconnect" href="https://fonts.googleapis.com">`
287
- - [ ] Preload critical font file: `<link rel="preload" as="font" type="font/woff2" crossorigin>`
288
- - [ ] Load only the weights actually used (400, 500, 600 typically sufficient)
289
-
290
- ### CSS / JS
291
- - [ ] No unused CSS (purge TailwindCSS or use inline critical CSS)
292
- - [ ] Defer non-critical JS: `<script defer src="..."></script>`
293
- - [ ] Load animation libraries only after hero is painted (use `defer` or dynamic import)
294
- - [ ] Minify all assets before deploy
295
-
296
- ### Animation performance
297
- - [ ] Use `transform` and `opacity` only — never animate `width`, `height`, `top`, `left`
298
- - [ ] Add `will-change: transform` to elements with heavy animation (sparingly)
299
- - [ ] Respect `prefers-reduced-motion`:
300
- ```css
301
- @media (prefers-reduced-motion: reduce) {
302
- *, *::before, *::after {
303
- animation-duration: 0.01ms !important;
304
- transition-duration: 0.01ms !important;
305
- }
306
- }
307
- ```
308
-
309
- ### Validation targets
310
- - PageSpeed Insights score: ≥ 90 mobile, ≥ 95 desktop
311
- - LCP (Largest Contentful Paint): < 2.5 s
312
- - CLS (Cumulative Layout Shift): < 0.1
313
- - FID/INP: < 200 ms
314
-
315
- ---
316
-
317
- ## 4. SEO / LLMO setup
318
-
319
- ### HTML head — minimum viable
320
-
321
- ```html
322
- <meta charset="UTF-8">
323
- <meta name="viewport" content="width=device-width, initial-scale=1">
324
- <title>Primary Keyword — Brand Name</title>
325
- <meta name="description" content="150–160 character description with primary keyword.">
326
- <link rel="canonical" href="https://yourdomain.com/page-slug">
327
-
328
- <!-- Open Graph -->
329
- <meta property="og:title" content="Page Title">
330
- <meta property="og:description" content="Description">
331
- <meta property="og:image" content="https://yourdomain.com/og-image.jpg"> <!-- 1200×630 -->
332
- <meta property="og:url" content="https://yourdomain.com/page-slug">
333
- <meta property="og:type" content="website">
334
-
335
- <!-- Twitter Card -->
336
- <meta name="twitter:card" content="summary_large_image">
337
- <meta name="twitter:title" content="Page Title">
338
- <meta name="twitter:description" content="Description">
339
- <meta name="twitter:image" content="https://yourdomain.com/og-image.jpg">
340
- ```
341
-
342
- ### H-tag hierarchy (one page = one H1)
343
-
344
- ```
345
- H1 — Primary keyword, page purpose (ONE per page)
346
- H2 — Major sections
347
- H3 — Sub-topics within sections
348
- ```
349
-
350
- ### JSON-LD schema (place before `</body>`)
351
-
352
- ```html
353
- <script type="application/ld+json">
354
- {
355
- "@context": "https://schema.org",
356
- "@type": "WebPage",
357
- "name": "Page Title",
358
- "description": "Page description",
359
- "url": "https://yourdomain.com/page-slug",
360
- "publisher": {
361
- "@type": "Organization",
362
- "name": "Brand Name",
363
- "url": "https://yourdomain.com"
364
- }
365
- }
366
- </script>
367
- ```
368
-
369
- For events:
370
- ```json
371
- {
372
- "@type": "Event",
373
- "name": "Event Name",
374
- "startDate": "2025-05-10T19:00",
375
- "location": { "@type": "Place", "name": "Venue" },
376
- "offers": { "@type": "Offer", "price": "997", "priceCurrency": "BRL" }
377
- }
378
- ```
379
-
380
- ### Sitemap and robots
381
-
382
- **`/sitemap.xml`:**
383
- ```xml
384
- <?xml version="1.0" encoding="UTF-8"?>
385
- <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
386
- <url>
387
- <loc>https://yourdomain.com/</loc>
388
- <lastmod>2025-04-01</lastmod>
389
- <priority>1.0</priority>
390
- </url>
391
- </urlset>
392
- ```
393
-
394
- **`/robots.txt`:**
395
- ```
396
- User-agent: *
397
- Allow: /
398
- Sitemap: https://yourdomain.com/sitemap.xml
399
- ```
400
-
401
- **`/llms.txt`** (LLMO — AI discoverability):
402
- ```markdown
403
- # Brand Name
404
-
405
- > One-line description of what this site/product is.
406
-
407
- ## What we offer
408
- - Feature or service 1
409
- - Feature or service 2
410
-
411
- ## Contact
412
- - Site: https://yourdomain.com
413
- - Email: contact@yourdomain.com
414
- ```
415
-
416
- ---
417
-
418
- ## 5. Tracking integration
419
-
420
- ### Meta Pixel + Advanced Matching
421
-
422
- Place in `<head>`, replace `PIXEL_ID`:
423
-
424
- ```html
425
- <script>
426
- !function(f,b,e,v,n,t,s){if(f.fbq)return;n=f.fbq=function(){n.callMethod?
427
- n.callMethod.apply(n,arguments):n.queue.push(arguments)};if(!f._fbq)f._fbq=n;
428
- n.push=n;n.loaded=!0;n.version='2.0';n.queue=[];t=b.createElement(e);t.async=!0;
429
- t.src=v;s=b.getElementsByTagName(e)[0];s.parentNode.insertBefore(t,s)}(window,
430
- document,'script','https://connect.facebook.net/en_US/fbevents.js');
431
-
432
- fbq('init', 'PIXEL_ID', {
433
- em: '<hashed_email_if_known>' // Advanced Matching — pass SHA256 hashed email
434
- });
435
- fbq('track', 'PageView');
436
- </script>
437
- <noscript>
438
- <img height="1" width="1" style="display:none"
439
- src="https://www.facebook.com/tr?id=PIXEL_ID&ev=PageView&noscript=1"/>
440
- </noscript>
441
- ```
442
-
443
- **Standard events to fire on key actions:**
444
- ```js
445
- // Lead capture form submit
446
- fbq('track', 'Lead', { content_name: 'Newsletter Signup' });
447
-
448
- // Checkout / purchase intent
449
- fbq('track', 'InitiateCheckout', { value: 997, currency: 'BRL' });
450
-
451
- // Purchase confirmed
452
- fbq('track', 'Purchase', { value: 997, currency: 'BRL' });
453
- ```
454
-
455
- ### Google Tag Manager
456
-
457
- ```html
458
- <!-- In <head> -->
459
- <script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
460
- new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
461
- j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
462
- 'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
463
- })(window,document,'script','dataLayer','GTM-XXXXXXX');</script>
464
-
465
- <!-- Immediately after <body> -->
466
- <noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-XXXXXXX"
467
- height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
468
- ```
469
-
470
- ### UTM capture and persistence
471
-
472
- Captures UTM parameters on landing and persists them through the session for downstream form submissions.
473
-
474
- ```js
475
- (function() {
476
- const params = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content'];
477
- const url = new URL(window.location.href);
478
-
479
- params.forEach(param => {
480
- const value = url.searchParams.get(param);
481
- if (value) {
482
- sessionStorage.setItem(param, value);
483
- // Also set cookie for cross-page persistence
484
- document.cookie = `${param}=${encodeURIComponent(value)};path=/;max-age=1800`;
485
- }
486
- });
487
-
488
- // Attach UTMs to all form submissions
489
- document.querySelectorAll('form').forEach(form => {
490
- form.addEventListener('submit', () => {
491
- params.forEach(param => {
492
- const value = sessionStorage.getItem(param);
493
- if (value) {
494
- const input = document.createElement('input');
495
- input.type = 'hidden';
496
- input.name = param;
497
- input.value = value;
498
- form.appendChild(input);
499
- }
500
- });
501
- });
502
- });
503
- })();
504
- ```
505
-
506
- ---
507
-
508
- ## 6. Mobile-first responsive rules for landing pages
509
-
510
- ```css
511
- /* Base: mobile (< 640px) */
512
- .hero-heading { font-size: clamp(2rem, 8vw, 4.5rem); }
513
- .section-padding { padding: 64px 24px; }
514
- .grid-cols { grid-template-columns: 1fr; }
515
-
516
- /* Tablet (≥ 768px) */
517
- @media (min-width: 768px) {
518
- .section-padding { padding: 96px 48px; }
519
- .grid-cols { grid-template-columns: repeat(2, 1fr); }
520
- }
521
-
522
- /* Desktop (≥ 1024px) */
523
- @media (min-width: 1024px) {
524
- .section-padding { padding: 128px 80px; }
525
- .grid-cols { grid-template-columns: repeat(3, 1fr); }
526
- }
527
- ```
528
-
529
- **Key landing page responsive rules:**
530
- - CTA buttons: minimum 48px height on mobile, full-width on < 480px
531
- - Horizontal scroll sections: disable on mobile, show vertical stack instead
532
- - Magnetic mouse effects: disable on touch devices (`@media (hover: none)`)
533
- - Font size: use `clamp()` for fluid scaling between breakpoints
534
- - Hero text: max 2 lines on mobile — truncate copy if needed
535
-
536
- ```js
537
- // Disable magnetic effects on touch
538
- const isTouchDevice = () => window.matchMedia("(hover: none)").matches;
539
- if (!isTouchDevice()) {
540
- // init magnetic effects
541
- }
542
- ```
543
-
544
- ---
545
-
546
- ## 7. Pre-launch validation checklist
547
-
548
- ### Visual
549
- - [ ] Renders correctly on iPhone SE (375px), iPhone 14 (390px), iPad (768px), Desktop (1280px)
550
- - [ ] All CTAs visible above fold on mobile
551
- - [ ] No horizontal overflow on any breakpoint
552
- - [ ] All images have `alt` text
553
-
554
- ### Functional
555
- - [ ] All CTA buttons and links work
556
- - [ ] Form submits correctly and shows success/error state
557
- - [ ] No console errors in Chrome, Firefox, Safari
558
-
559
- ### Performance
560
- - [ ] PageSpeed score ≥ 90 mobile
561
- - [ ] LCP < 2.5 s on mobile (test on throttled 3G in DevTools)
562
-
563
- ### Tracking
564
- - [ ] Meta Pixel fires PageView on load (verify in Meta Pixel Helper)
565
- - [ ] GTM fires on load (verify in Tag Assistant)
566
- - [ ] UTM params captured in sessionStorage when visiting with `?utm_source=test`
567
- - [ ] Lead event fires on form submit
568
-
569
- ### SEO / LLMO
570
- - [ ] Single H1 present
571
- - [ ] Meta description populated
572
- - [ ] Canonical URL correct
573
- - [ ] OG image renders correctly (test at opengraph.xyz)
574
- - [ ] /robots.txt accessible
575
- - [ ] /sitemap.xml accessible and valid
576
- - [ ] /llms.txt present
577
-
578
- ### SSL and deploy
579
- - [ ] HTTPS certificate active (no mixed content warnings)
580
- - [ ] Domain resolves correctly on all subdomains being used
581
- - [ ] Redirects from www/non-www consistent
582
-
583
- ---
584
-
585
- ## 8. Tech stack recommendations
586
-
587
- | Need | Recommended |
588
- |---|---|
589
- | Static HTML/CSS/JS page | Plain HTML + Vite for bundling |
590
- | React-based | Next.js (Static Export for max speed) |
591
- | Animation library | GSAP (complex) or AnimeJS (lightweight) |
592
- | Image generation | Google Imagen via API, or Flux |
593
- | Hosting (BRL-friendly) | Hostinger VPS (LiteSpeed) |
594
- | Hosting (automated deploy) | Vercel (Git-connected, CDN edge) |
595
- | DNS / CDN | Cloudflare (free tier covers most pages) |
596
- | Form backend | Formspree, Basin, or native webhook to CRM |
597
-
598
- ---
599
-
600
- ## 9. Production execution pattern — 3 parallel tracks
601
-
602
- The most common failure in AI-generated landing pages: the page looks good but doesn't have tracking, doesn't have SEO, and fails PageSpeed. These three tracks must run **simultaneously** during implementation — not as an afterthought checklist.
603
-
604
- ### How to execute in parallel
605
-
606
- When building a page, structure the implementation in two phases:
607
-
608
- **Phase 1 — Structure & visual** (sequential prerequisite)
609
- Build the HTML structure, CSS design system, content sections, and animations. Get the page looking correct on desktop and mobile.
610
-
611
- **Phase 2 — Production readiness** (3 tracks in parallel)
612
- Once Phase 1 is complete, execute all three tracks before considering the page done:
613
-
614
- ```
615
- Phase 2 — run all three simultaneously:
616
-
617
- ┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────────────┐
618
- │ Track A: SEO/LLMO │ │ Track B: Tracking │ │ Track C: Performance│
619
- ├─────────────────────┤ ├─────────────────────┤ ├─────────────────────┤
620
- │ • Single H1 │ │ • Meta Pixel init │ │ • Images → WebP │
621
- │ • Meta description │ │ • PageView event │ │ • lazy loading │
622
- │ • Canonical URL │ │ • Lead event (form) │ │ • Hero preload │
623
- │ • OG tags │ │ • GTM container │ │ • Defer JS │
624
- │ • JSON-LD schema │ │ • UTM capture │ │ • Remove unused CSS │
625
- │ • /robots.txt │ │ • UTM → form inject │ │ • will-change │
626
- │ • /sitemap.xml │ │ • Cookie consent │ │ • prefers-reduced- │
627
- │ • /llms.txt │ │ (LGPD if BR) │ │ motion fallback │
628
- └─────────────────────┘ └─────────────────────┘ └─────────────────────┘
629
- ↓ ↓ ↓
630
- └─────────────────────────┴─────────────────────────┘
631
-
632
- Phase 3 — Validation (sequential)
633
- • PageSpeed ≥ 90 mobile
634
- • Cross-browser check
635
- • CTAs and forms functional
636
- • Pixel fires on load (Pixel Helper)
637
- • Deploy
638
- ```
639
-
640
- ### Track A delivery checklist
641
- ```html
642
- <!-- SEO/LLMO minimum — all in <head> -->
643
- <title>Primary Keyword — Brand Name</title>
644
- <meta name="description" content="150–160 chars">
645
- <link rel="canonical" href="https://yourdomain.com/page">
646
- <meta property="og:title" content="...">
647
- <meta property="og:description" content="...">
648
- <meta property="og:image" content="..."> <!-- 1200×630 -->
649
- <meta property="og:url" content="...">
650
- ```
651
- ```
652
- # /robots.txt
653
- User-agent: *
654
- Allow: /
655
- Sitemap: https://yourdomain.com/sitemap.xml
656
- ```
657
- ```markdown
658
- # /llms.txt — brand summary for AI discoverability
659
- # [Brand Name]
660
- > [One-line description]
661
- ## Products/Services
662
- - [item]
663
- ## Contact
664
- - [url]
665
- ```
666
-
667
- ### Track B delivery checklist
668
- ```html
669
- <!-- Pixel in <head> — replace PIXEL_ID -->
670
- <script>
671
- !function(f,b,e,v,n,t,s){...}(window,document,'script',
672
- 'https://connect.facebook.net/en_US/fbevents.js');
673
- fbq('init', 'PIXEL_ID');
674
- fbq('track', 'PageView');
675
- </script>
676
-
677
- <!-- GTM in <head> — replace GTM-XXXXXXX -->
678
- <script>(function(w,d,s,l,i){...})(window,document,'script','dataLayer','GTM-XXXXXXX');</script>
679
-
680
- <!-- UTM capture — in <body> before </body> -->
681
- <script>
682
- (function() {
683
- const params = ['utm_source','utm_medium','utm_campaign','utm_term','utm_content'];
684
- const url = new URL(window.location.href);
685
- params.forEach(p => {
686
- const v = url.searchParams.get(p);
687
- if (v) { sessionStorage.setItem(p, v); document.cookie = `${p}=${encodeURIComponent(v)};path=/;max-age=1800`; }
688
- });
689
- document.querySelectorAll('form').forEach(form => {
690
- form.addEventListener('submit', () => {
691
- params.forEach(p => {
692
- const v = sessionStorage.getItem(p);
693
- if (v) { const i = document.createElement('input'); i.type='hidden'; i.name=p; i.value=v; form.appendChild(i); }
694
- });
695
- });
696
- });
697
- })();
698
- </script>
699
- ```
700
-
701
- ### Track C delivery checklist
702
- ```html
703
- <!-- Hero image preload — always first in <head> -->
704
- <link rel="preload" as="image" href="hero.webp">
705
-
706
- <!-- Font preconnect -->
707
- <link rel="preconnect" href="https://fonts.googleapis.com">
708
- <link rel="preload" as="font" type="font/woff2" href="/fonts/inter.woff2" crossorigin>
709
-
710
- <!-- Animation libraries — defer so they don't block render -->
711
- <script defer src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/gsap.min.js"></script>
712
- ```
713
- ```css
714
- /* Reduced motion fallback — always present */
715
- @media (prefers-reduced-motion: reduce) {
716
- *, *::before, *::after {
717
- animation-duration: 0.01ms !important;
718
- transition-duration: 0.01ms !important;
719
- }
720
- }
721
- /* will-change only on actively animated elements */
722
- .hero-bg { will-change: transform; }
723
- ```
724
-
725
- ### Why this matters (from production data)
726
- Pages without tracking have no conversion data → impossible to optimize → wasted ad spend.
727
- Pages without SEO/LLMO miss organic and AI-referred traffic → dead investment.
728
- Pages loading in 3+ seconds lose 40%+ of mobile traffic before the first CTA is seen.
729
-
730
- Running the three tracks in parallel (not as afterthought) means a page is truly production-ready when it launches, not just visually finished.
1
+ ---
2
+ name: landing-page-forge
3
+ description: Advanced landing page production skill — animation libraries (GSAP, AnimeJS), high-impact motion patterns (horizontal scroll, magnetic mouse, hero sequences), performance checklist, SEO/LLMO setup, tracking integration. Load when building landing pages, sales pages, event pages, or any conversion-focused page.
4
+ ---
5
+
6
+ # Landing Page Forge
7
+
8
+ Production playbook for landing pages that convert. Covers animation craft, performance, discoverability, and tracking — the full stack from visual to measurable.
9
+
10
+ ---
11
+
12
+ ## 1. Animation library choice
13
+
14
+ ### GSAP (GreenSock Animation Platform)
15
+ **Use when:** you need scroll-driven horizontal sections, magnetic mouse effects, SVG animations, or complex sequenced timelines.
16
+
17
+ ```html
18
+ <!-- CDN (free tier covers most needs) -->
19
+ <script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/gsap.min.js"></script>
20
+ <script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/ScrollTrigger.min.js"></script>
21
+ ```
22
+
23
+ ```js
24
+ gsap.registerPlugin(ScrollTrigger);
25
+ ```
26
+
27
+ **npm:** `npm install gsap`
28
+
29
+ ### AnimeJS
30
+ **Use when:** you want lightweight, zero-dependency micro-animations — counters, SVG morphing, staggered list reveals, hover interactions.
31
+
32
+ ```html
33
+ <script src="https://cdnjs.cloudflare.com/ajax/libs/animejs/3.2.1/anime.min.js"></script>
34
+ ```
35
+
36
+ **npm:** `npm install animejs`
37
+
38
+ ### When to use which
39
+
40
+ | Effect | Library |
41
+ |---|---|
42
+ | Horizontal scroll section | GSAP + ScrollTrigger |
43
+ | Magnetic mouse / cursor aura | GSAP |
44
+ | Scroll-reveal stagger | Either (GSAP for precision, AnimeJS for light pages) |
45
+ | Number count-up | AnimeJS |
46
+ | SVG path drawing | AnimeJS |
47
+ | Complex parallax | GSAP |
48
+ | Simple fade-in sequence | CSS keyframes (no library needed) |
49
+
50
+ ---
51
+
52
+ ## 2. High-impact motion patterns
53
+
54
+ ### 2.1 Horizontal scroll marquee (infinite ticker)
55
+
56
+ Feature strip, client logos, testimonials — scrolls sideways while user scrolls down.
57
+
58
+ ```html
59
+ <section class="marquee-section">
60
+ <div class="marquee-track">
61
+ <div class="marquee-items" id="marqueeItems">
62
+ <!-- items duplicated in JS -->
63
+ </div>
64
+ </div>
65
+ </section>
66
+ ```
67
+
68
+ ```css
69
+ .marquee-section { overflow: hidden; }
70
+ .marquee-track { display: flex; }
71
+ .marquee-items { display: flex; gap: 48px; white-space: nowrap; will-change: transform; }
72
+ ```
73
+
74
+ ```js
75
+ // GSAP infinite marquee
76
+ gsap.to("#marqueeItems", {
77
+ x: "-50%",
78
+ duration: 20,
79
+ ease: "none",
80
+ repeat: -1
81
+ });
82
+ // Clone items for seamless loop
83
+ const items = document.getElementById("marqueeItems");
84
+ items.innerHTML += items.innerHTML;
85
+ ```
86
+
87
+ ### 2.2 Horizontal scroll section (scroll → move sideways)
88
+
89
+ Cards or features that slide horizontally as user scrolls vertically.
90
+
91
+ ```html
92
+ <section class="h-scroll-wrapper">
93
+ <div class="h-scroll-pin">
94
+ <div class="h-scroll-track" id="hTrack">
95
+ <div class="h-scroll-card">...</div>
96
+ <div class="h-scroll-card">...</div>
97
+ <div class="h-scroll-card">...</div>
98
+ </div>
99
+ </div>
100
+ </section>
101
+ ```
102
+
103
+ ```css
104
+ .h-scroll-wrapper { height: 300vh; }
105
+ .h-scroll-pin { position: sticky; top: 0; overflow: hidden; height: 100vh; }
106
+ .h-scroll-track { display: flex; width: max-content; }
107
+ .h-scroll-card { width: 80vw; flex-shrink: 0; margin-right: 32px; }
108
+ ```
109
+
110
+ ```js
111
+ const track = document.getElementById("hTrack");
112
+ const totalWidth = track.scrollWidth - window.innerWidth;
113
+
114
+ gsap.to(track, {
115
+ x: () => -totalWidth,
116
+ ease: "none",
117
+ scrollTrigger: {
118
+ trigger: ".h-scroll-wrapper",
119
+ start: "top top",
120
+ end: "bottom top",
121
+ scrub: 1,
122
+ pin: ".h-scroll-pin",
123
+ anticipatePin: 1
124
+ }
125
+ });
126
+ ```
127
+
128
+ ### 2.3 Magnetic mouse effect (cursor aura / hover field)
129
+
130
+ Interactive element that subtly follows the cursor — gives premium tactile feel.
131
+
132
+ ```html
133
+ <div class="magnetic-btn" id="magneticBtn">
134
+ <span>Get Started</span>
135
+ </div>
136
+ ```
137
+
138
+ ```js
139
+ const btn = document.getElementById("magneticBtn");
140
+
141
+ btn.addEventListener("mousemove", (e) => {
142
+ const rect = btn.getBoundingClientRect();
143
+ const x = e.clientX - rect.left - rect.width / 2;
144
+ const y = e.clientY - rect.top - rect.height / 2;
145
+ const strength = 0.35;
146
+
147
+ gsap.to(btn, {
148
+ x: x * strength,
149
+ y: y * strength,
150
+ duration: 0.3,
151
+ ease: "power2.out"
152
+ });
153
+ });
154
+
155
+ btn.addEventListener("mouseleave", () => {
156
+ gsap.to(btn, { x: 0, y: 0, duration: 0.5, ease: "elastic.out(1, 0.4)" });
157
+ });
158
+ ```
159
+
160
+ **Cursor aura (glow that follows mouse globally):**
161
+ ```html
162
+ <div class="cursor-aura" id="cursorAura"></div>
163
+ ```
164
+
165
+ ```css
166
+ .cursor-aura {
167
+ position: fixed;
168
+ width: 300px;
169
+ height: 300px;
170
+ border-radius: 50%;
171
+ background: radial-gradient(circle, rgba(99,102,241,0.12) 0%, transparent 70%);
172
+ pointer-events: none;
173
+ transform: translate(-50%, -50%);
174
+ z-index: 0;
175
+ transition: opacity 0.3s;
176
+ }
177
+ ```
178
+
179
+ ```js
180
+ document.addEventListener("mousemove", (e) => {
181
+ gsap.to("#cursorAura", {
182
+ x: e.clientX,
183
+ y: e.clientY,
184
+ duration: 0.6,
185
+ ease: "power2.out"
186
+ });
187
+ });
188
+ ```
189
+
190
+ ### 2.4 Scroll-reveal stagger (IntersectionObserver)
191
+
192
+ Elements fade in as they enter the viewport — staggered per group.
193
+
194
+ ```html
195
+ <div class="reveal-group">
196
+ <div class="reveal-item">...</div>
197
+ <div class="reveal-item">...</div>
198
+ <div class="reveal-item">...</div>
199
+ </div>
200
+ ```
201
+
202
+ ```css
203
+ .reveal-item {
204
+ opacity: 0;
205
+ transform: translateY(32px);
206
+ transition: opacity 0.6s cubic-bezier(0.16, 1, 0.3, 1),
207
+ transform 0.6s cubic-bezier(0.16, 1, 0.3, 1);
208
+ }
209
+ .reveal-item.visible {
210
+ opacity: 1;
211
+ transform: translateY(0);
212
+ }
213
+ ```
214
+
215
+ ```js
216
+ const observer = new IntersectionObserver((entries) => {
217
+ entries.forEach((entry, i) => {
218
+ if (entry.isIntersecting) {
219
+ setTimeout(() => entry.target.classList.add("visible"), i * 80);
220
+ observer.unobserve(entry.target);
221
+ }
222
+ });
223
+ }, { threshold: 0.15 });
224
+
225
+ document.querySelectorAll(".reveal-item").forEach(el => observer.observe(el));
226
+ ```
227
+
228
+ ### 2.5 Number counter animation (AnimeJS)
229
+
230
+ Stats and metrics that count up when scrolled into view.
231
+
232
+ ```html
233
+ <span class="counter" data-target="200">0</span>
234
+ ```
235
+
236
+ ```js
237
+ const counterObserver = new IntersectionObserver((entries) => {
238
+ entries.forEach(entry => {
239
+ if (!entry.isIntersecting) return;
240
+ const el = entry.target;
241
+ const target = +el.dataset.target;
242
+ anime({
243
+ targets: el,
244
+ innerHTML: [0, target],
245
+ round: 1,
246
+ duration: 1800,
247
+ easing: "easeOutExpo",
248
+ update: () => { el.innerHTML = Math.round(el.innerHTML); }
249
+ });
250
+ counterObserver.unobserve(el);
251
+ });
252
+ }, { threshold: 0.5 });
253
+
254
+ document.querySelectorAll(".counter").forEach(el => counterObserver.observe(el));
255
+ ```
256
+
257
+ ### 2.6 Hero entrance sequence
258
+
259
+ Staggered load sequence for above-the-fold hero sections.
260
+
261
+ ```js
262
+ // GSAP timeline — fires on page load
263
+ const heroTL = gsap.timeline({ defaults: { ease: "power3.out" } });
264
+
265
+ heroTL
266
+ .from(".hero-eyebrow", { y: 20, opacity: 0, duration: 0.6 })
267
+ .from(".hero-heading", { y: 30, opacity: 0, duration: 0.8 }, "-=0.3")
268
+ .from(".hero-sub", { y: 20, opacity: 0, duration: 0.6 }, "-=0.4")
269
+ .from(".hero-cta", { y: 20, opacity: 0, duration: 0.5, stagger: 0.1 }, "-=0.3")
270
+ .from(".hero-media", { scale: 0.96, opacity: 0, duration: 0.8 }, "-=0.5");
271
+ ```
272
+
273
+ ---
274
+
275
+ ## 3. Performance checklist (< 2.5 s load target)
276
+
277
+ ### Images
278
+ - [ ] Use WebP format for all photography and illustrations
279
+ - [ ] Set `loading="lazy"` on all images below the fold
280
+ - [ ] Preload hero/above-the-fold image: `<link rel="preload" as="image" href="hero.webp">`
281
+ - [ ] Specify `width` and `height` on every `<img>` to prevent layout shift
282
+ - [ ] Use `srcset` for responsive image sizes
283
+
284
+ ### Fonts
285
+ - [ ] Self-host or use `font-display: swap`
286
+ - [ ] Preconnect to font CDN: `<link rel="preconnect" href="https://fonts.googleapis.com">`
287
+ - [ ] Preload critical font file: `<link rel="preload" as="font" type="font/woff2" crossorigin>`
288
+ - [ ] Load only the weights actually used (400, 500, 600 typically sufficient)
289
+
290
+ ### CSS / JS
291
+ - [ ] No unused CSS (purge TailwindCSS or use inline critical CSS)
292
+ - [ ] Defer non-critical JS: `<script defer src="..."></script>`
293
+ - [ ] Load animation libraries only after hero is painted (use `defer` or dynamic import)
294
+ - [ ] Minify all assets before deploy
295
+
296
+ ### Animation performance
297
+ - [ ] Use `transform` and `opacity` only — never animate `width`, `height`, `top`, `left`
298
+ - [ ] Add `will-change: transform` to elements with heavy animation (sparingly)
299
+ - [ ] Respect `prefers-reduced-motion`:
300
+ ```css
301
+ @media (prefers-reduced-motion: reduce) {
302
+ *, *::before, *::after {
303
+ animation-duration: 0.01ms !important;
304
+ transition-duration: 0.01ms !important;
305
+ }
306
+ }
307
+ ```
308
+
309
+ ### Validation targets
310
+ - PageSpeed Insights score: ≥ 90 mobile, ≥ 95 desktop
311
+ - LCP (Largest Contentful Paint): < 2.5 s
312
+ - CLS (Cumulative Layout Shift): < 0.1
313
+ - FID/INP: < 200 ms
314
+
315
+ ---
316
+
317
+ ## 4. SEO / LLMO setup
318
+
319
+ ### HTML head — minimum viable
320
+
321
+ ```html
322
+ <meta charset="UTF-8">
323
+ <meta name="viewport" content="width=device-width, initial-scale=1">
324
+ <title>Primary Keyword — Brand Name</title>
325
+ <meta name="description" content="150–160 character description with primary keyword.">
326
+ <link rel="canonical" href="https://yourdomain.com/page-slug">
327
+
328
+ <!-- Open Graph -->
329
+ <meta property="og:title" content="Page Title">
330
+ <meta property="og:description" content="Description">
331
+ <meta property="og:image" content="https://yourdomain.com/og-image.jpg"> <!-- 1200×630 -->
332
+ <meta property="og:url" content="https://yourdomain.com/page-slug">
333
+ <meta property="og:type" content="website">
334
+
335
+ <!-- Twitter Card -->
336
+ <meta name="twitter:card" content="summary_large_image">
337
+ <meta name="twitter:title" content="Page Title">
338
+ <meta name="twitter:description" content="Description">
339
+ <meta name="twitter:image" content="https://yourdomain.com/og-image.jpg">
340
+ ```
341
+
342
+ ### H-tag hierarchy (one page = one H1)
343
+
344
+ ```
345
+ H1 — Primary keyword, page purpose (ONE per page)
346
+ H2 — Major sections
347
+ H3 — Sub-topics within sections
348
+ ```
349
+
350
+ ### JSON-LD schema (place before `</body>`)
351
+
352
+ ```html
353
+ <script type="application/ld+json">
354
+ {
355
+ "@context": "https://schema.org",
356
+ "@type": "WebPage",
357
+ "name": "Page Title",
358
+ "description": "Page description",
359
+ "url": "https://yourdomain.com/page-slug",
360
+ "publisher": {
361
+ "@type": "Organization",
362
+ "name": "Brand Name",
363
+ "url": "https://yourdomain.com"
364
+ }
365
+ }
366
+ </script>
367
+ ```
368
+
369
+ For events:
370
+ ```json
371
+ {
372
+ "@type": "Event",
373
+ "name": "Event Name",
374
+ "startDate": "2025-05-10T19:00",
375
+ "location": { "@type": "Place", "name": "Venue" },
376
+ "offers": { "@type": "Offer", "price": "997", "priceCurrency": "BRL" }
377
+ }
378
+ ```
379
+
380
+ ### Sitemap and robots
381
+
382
+ **`/sitemap.xml`:**
383
+ ```xml
384
+ <?xml version="1.0" encoding="UTF-8"?>
385
+ <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
386
+ <url>
387
+ <loc>https://yourdomain.com/</loc>
388
+ <lastmod>2025-04-01</lastmod>
389
+ <priority>1.0</priority>
390
+ </url>
391
+ </urlset>
392
+ ```
393
+
394
+ **`/robots.txt`:**
395
+ ```
396
+ User-agent: *
397
+ Allow: /
398
+ Sitemap: https://yourdomain.com/sitemap.xml
399
+ ```
400
+
401
+ **`/llms.txt`** (LLMO — AI discoverability):
402
+ ```markdown
403
+ # Brand Name
404
+
405
+ > One-line description of what this site/product is.
406
+
407
+ ## What we offer
408
+ - Feature or service 1
409
+ - Feature or service 2
410
+
411
+ ## Contact
412
+ - Site: https://yourdomain.com
413
+ - Email: contact@yourdomain.com
414
+ ```
415
+
416
+ ---
417
+
418
+ ## 5. Tracking integration
419
+
420
+ ### Meta Pixel + Advanced Matching
421
+
422
+ Place in `<head>`, replace `PIXEL_ID`:
423
+
424
+ ```html
425
+ <script>
426
+ !function(f,b,e,v,n,t,s){if(f.fbq)return;n=f.fbq=function(){n.callMethod?
427
+ n.callMethod.apply(n,arguments):n.queue.push(arguments)};if(!f._fbq)f._fbq=n;
428
+ n.push=n;n.loaded=!0;n.version='2.0';n.queue=[];t=b.createElement(e);t.async=!0;
429
+ t.src=v;s=b.getElementsByTagName(e)[0];s.parentNode.insertBefore(t,s)}(window,
430
+ document,'script','https://connect.facebook.net/en_US/fbevents.js');
431
+
432
+ fbq('init', 'PIXEL_ID', {
433
+ em: '<hashed_email_if_known>' // Advanced Matching — pass SHA256 hashed email
434
+ });
435
+ fbq('track', 'PageView');
436
+ </script>
437
+ <noscript>
438
+ <img height="1" width="1" style="display:none"
439
+ src="https://www.facebook.com/tr?id=PIXEL_ID&ev=PageView&noscript=1"/>
440
+ </noscript>
441
+ ```
442
+
443
+ **Standard events to fire on key actions:**
444
+ ```js
445
+ // Lead capture form submit
446
+ fbq('track', 'Lead', { content_name: 'Newsletter Signup' });
447
+
448
+ // Checkout / purchase intent
449
+ fbq('track', 'InitiateCheckout', { value: 997, currency: 'BRL' });
450
+
451
+ // Purchase confirmed
452
+ fbq('track', 'Purchase', { value: 997, currency: 'BRL' });
453
+ ```
454
+
455
+ ### Google Tag Manager
456
+
457
+ ```html
458
+ <!-- In <head> -->
459
+ <script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
460
+ new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
461
+ j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
462
+ 'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
463
+ })(window,document,'script','dataLayer','GTM-XXXXXXX');</script>
464
+
465
+ <!-- Immediately after <body> -->
466
+ <noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-XXXXXXX"
467
+ height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
468
+ ```
469
+
470
+ ### UTM capture and persistence
471
+
472
+ Captures UTM parameters on landing and persists them through the session for downstream form submissions.
473
+
474
+ ```js
475
+ (function() {
476
+ const params = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content'];
477
+ const url = new URL(window.location.href);
478
+
479
+ params.forEach(param => {
480
+ const value = url.searchParams.get(param);
481
+ if (value) {
482
+ sessionStorage.setItem(param, value);
483
+ // Also set cookie for cross-page persistence
484
+ document.cookie = `${param}=${encodeURIComponent(value)};path=/;max-age=1800`;
485
+ }
486
+ });
487
+
488
+ // Attach UTMs to all form submissions
489
+ document.querySelectorAll('form').forEach(form => {
490
+ form.addEventListener('submit', () => {
491
+ params.forEach(param => {
492
+ const value = sessionStorage.getItem(param);
493
+ if (value) {
494
+ const input = document.createElement('input');
495
+ input.type = 'hidden';
496
+ input.name = param;
497
+ input.value = value;
498
+ form.appendChild(input);
499
+ }
500
+ });
501
+ });
502
+ });
503
+ })();
504
+ ```
505
+
506
+ ---
507
+
508
+ ## 6. Mobile-first responsive rules for landing pages
509
+
510
+ ```css
511
+ /* Base: mobile (< 640px) */
512
+ .hero-heading { font-size: clamp(2rem, 8vw, 4.5rem); }
513
+ .section-padding { padding: 64px 24px; }
514
+ .grid-cols { grid-template-columns: 1fr; }
515
+
516
+ /* Tablet (≥ 768px) */
517
+ @media (min-width: 768px) {
518
+ .section-padding { padding: 96px 48px; }
519
+ .grid-cols { grid-template-columns: repeat(2, 1fr); }
520
+ }
521
+
522
+ /* Desktop (≥ 1024px) */
523
+ @media (min-width: 1024px) {
524
+ .section-padding { padding: 128px 80px; }
525
+ .grid-cols { grid-template-columns: repeat(3, 1fr); }
526
+ }
527
+ ```
528
+
529
+ **Key landing page responsive rules:**
530
+ - CTA buttons: minimum 48px height on mobile, full-width on < 480px
531
+ - Horizontal scroll sections: disable on mobile, show vertical stack instead
532
+ - Magnetic mouse effects: disable on touch devices (`@media (hover: none)`)
533
+ - Font size: use `clamp()` for fluid scaling between breakpoints
534
+ - Hero text: max 2 lines on mobile — truncate copy if needed
535
+
536
+ ```js
537
+ // Disable magnetic effects on touch
538
+ const isTouchDevice = () => window.matchMedia("(hover: none)").matches;
539
+ if (!isTouchDevice()) {
540
+ // init magnetic effects
541
+ }
542
+ ```
543
+
544
+ ---
545
+
546
+ ## 7. Pre-launch validation checklist
547
+
548
+ ### Visual
549
+ - [ ] Renders correctly on iPhone SE (375px), iPhone 14 (390px), iPad (768px), Desktop (1280px)
550
+ - [ ] All CTAs visible above fold on mobile
551
+ - [ ] No horizontal overflow on any breakpoint
552
+ - [ ] All images have `alt` text
553
+
554
+ ### Functional
555
+ - [ ] All CTA buttons and links work
556
+ - [ ] Form submits correctly and shows success/error state
557
+ - [ ] No console errors in Chrome, Firefox, Safari
558
+
559
+ ### Performance
560
+ - [ ] PageSpeed score ≥ 90 mobile
561
+ - [ ] LCP < 2.5 s on mobile (test on throttled 3G in DevTools)
562
+
563
+ ### Tracking
564
+ - [ ] Meta Pixel fires PageView on load (verify in Meta Pixel Helper)
565
+ - [ ] GTM fires on load (verify in Tag Assistant)
566
+ - [ ] UTM params captured in sessionStorage when visiting with `?utm_source=test`
567
+ - [ ] Lead event fires on form submit
568
+
569
+ ### SEO / LLMO
570
+ - [ ] Single H1 present
571
+ - [ ] Meta description populated
572
+ - [ ] Canonical URL correct
573
+ - [ ] OG image renders correctly (test at opengraph.xyz)
574
+ - [ ] /robots.txt accessible
575
+ - [ ] /sitemap.xml accessible and valid
576
+ - [ ] /llms.txt present
577
+
578
+ ### SSL and deploy
579
+ - [ ] HTTPS certificate active (no mixed content warnings)
580
+ - [ ] Domain resolves correctly on all subdomains being used
581
+ - [ ] Redirects from www/non-www consistent
582
+
583
+ ---
584
+
585
+ ## 8. Tech stack recommendations
586
+
587
+ | Need | Recommended |
588
+ |---|---|
589
+ | Static HTML/CSS/JS page | Plain HTML + Vite for bundling |
590
+ | React-based | Next.js (Static Export for max speed) |
591
+ | Animation library | GSAP (complex) or AnimeJS (lightweight) |
592
+ | Image generation | Google Imagen via API, or Flux |
593
+ | Hosting (BRL-friendly) | Hostinger VPS (LiteSpeed) |
594
+ | Hosting (automated deploy) | Vercel (Git-connected, CDN edge) |
595
+ | DNS / CDN | Cloudflare (free tier covers most pages) |
596
+ | Form backend | Formspree, Basin, or native webhook to CRM |
597
+
598
+ ---
599
+
600
+ ## 9. Production execution pattern — 3 parallel tracks
601
+
602
+ The most common failure in AI-generated landing pages: the page looks good but doesn't have tracking, doesn't have SEO, and fails PageSpeed. These three tracks must run **simultaneously** during implementation — not as an afterthought checklist.
603
+
604
+ ### How to execute in parallel
605
+
606
+ When building a page, structure the implementation in two phases:
607
+
608
+ **Phase 1 — Structure & visual** (sequential prerequisite)
609
+ Build the HTML structure, CSS design system, content sections, and animations. Get the page looking correct on desktop and mobile.
610
+
611
+ **Phase 2 — Production readiness** (3 tracks in parallel)
612
+ Once Phase 1 is complete, execute all three tracks before considering the page done:
613
+
614
+ ```
615
+ Phase 2 — run all three simultaneously:
616
+
617
+ ┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────────────┐
618
+ │ Track A: SEO/LLMO │ │ Track B: Tracking │ │ Track C: Performance│
619
+ ├─────────────────────┤ ├─────────────────────┤ ├─────────────────────┤
620
+ │ • Single H1 │ │ • Meta Pixel init │ │ • Images → WebP │
621
+ │ • Meta description │ │ • PageView event │ │ • lazy loading │
622
+ │ • Canonical URL │ │ • Lead event (form) │ │ • Hero preload │
623
+ │ • OG tags │ │ • GTM container │ │ • Defer JS │
624
+ │ • JSON-LD schema │ │ • UTM capture │ │ • Remove unused CSS │
625
+ │ • /robots.txt │ │ • UTM → form inject │ │ • will-change │
626
+ │ • /sitemap.xml │ │ • Cookie consent │ │ • prefers-reduced- │
627
+ │ • /llms.txt │ │ (LGPD if BR) │ │ motion fallback │
628
+ └─────────────────────┘ └─────────────────────┘ └─────────────────────┘
629
+ ↓ ↓ ↓
630
+ └─────────────────────────┴─────────────────────────┘
631
+
632
+ Phase 3 — Validation (sequential)
633
+ • PageSpeed ≥ 90 mobile
634
+ • Cross-browser check
635
+ • CTAs and forms functional
636
+ • Pixel fires on load (Pixel Helper)
637
+ • Deploy
638
+ ```
639
+
640
+ ### Track A delivery checklist
641
+ ```html
642
+ <!-- SEO/LLMO minimum — all in <head> -->
643
+ <title>Primary Keyword — Brand Name</title>
644
+ <meta name="description" content="150–160 chars">
645
+ <link rel="canonical" href="https://yourdomain.com/page">
646
+ <meta property="og:title" content="...">
647
+ <meta property="og:description" content="...">
648
+ <meta property="og:image" content="..."> <!-- 1200×630 -->
649
+ <meta property="og:url" content="...">
650
+ ```
651
+ ```
652
+ # /robots.txt
653
+ User-agent: *
654
+ Allow: /
655
+ Sitemap: https://yourdomain.com/sitemap.xml
656
+ ```
657
+ ```markdown
658
+ # /llms.txt — brand summary for AI discoverability
659
+ # [Brand Name]
660
+ > [One-line description]
661
+ ## Products/Services
662
+ - [item]
663
+ ## Contact
664
+ - [url]
665
+ ```
666
+
667
+ ### Track B delivery checklist
668
+ ```html
669
+ <!-- Pixel in <head> — replace PIXEL_ID -->
670
+ <script>
671
+ !function(f,b,e,v,n,t,s){...}(window,document,'script',
672
+ 'https://connect.facebook.net/en_US/fbevents.js');
673
+ fbq('init', 'PIXEL_ID');
674
+ fbq('track', 'PageView');
675
+ </script>
676
+
677
+ <!-- GTM in <head> — replace GTM-XXXXXXX -->
678
+ <script>(function(w,d,s,l,i){...})(window,document,'script','dataLayer','GTM-XXXXXXX');</script>
679
+
680
+ <!-- UTM capture — in <body> before </body> -->
681
+ <script>
682
+ (function() {
683
+ const params = ['utm_source','utm_medium','utm_campaign','utm_term','utm_content'];
684
+ const url = new URL(window.location.href);
685
+ params.forEach(p => {
686
+ const v = url.searchParams.get(p);
687
+ if (v) { sessionStorage.setItem(p, v); document.cookie = `${p}=${encodeURIComponent(v)};path=/;max-age=1800`; }
688
+ });
689
+ document.querySelectorAll('form').forEach(form => {
690
+ form.addEventListener('submit', () => {
691
+ params.forEach(p => {
692
+ const v = sessionStorage.getItem(p);
693
+ if (v) { const i = document.createElement('input'); i.type='hidden'; i.name=p; i.value=v; form.appendChild(i); }
694
+ });
695
+ });
696
+ });
697
+ })();
698
+ </script>
699
+ ```
700
+
701
+ ### Track C delivery checklist
702
+ ```html
703
+ <!-- Hero image preload — always first in <head> -->
704
+ <link rel="preload" as="image" href="hero.webp">
705
+
706
+ <!-- Font preconnect -->
707
+ <link rel="preconnect" href="https://fonts.googleapis.com">
708
+ <link rel="preload" as="font" type="font/woff2" href="/fonts/inter.woff2" crossorigin>
709
+
710
+ <!-- Animation libraries — defer so they don't block render -->
711
+ <script defer src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/gsap.min.js"></script>
712
+ ```
713
+ ```css
714
+ /* Reduced motion fallback — always present */
715
+ @media (prefers-reduced-motion: reduce) {
716
+ *, *::before, *::after {
717
+ animation-duration: 0.01ms !important;
718
+ transition-duration: 0.01ms !important;
719
+ }
720
+ }
721
+ /* will-change only on actively animated elements */
722
+ .hero-bg { will-change: transform; }
723
+ ```
724
+
725
+ ### Why this matters (from production data)
726
+ Pages without tracking have no conversion data → impossible to optimize → wasted ad spend.
727
+ Pages without SEO/LLMO miss organic and AI-referred traffic → dead investment.
728
+ Pages loading in 3+ seconds lose 40%+ of mobile traffic before the first CTA is seen.
729
+
730
+ Running the three tracks in parallel (not as afterthought) means a page is truly production-ready when it launches, not just visually finished.