@jaimevalasek/aioson 1.8.0 → 1.9.1

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 (974) 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 +85 -5
  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 +220 -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 +68 -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 +417 -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 +812 -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/gateway-pointer-merge.js +101 -0
  410. package/src/genome-files.js +198 -198
  411. package/src/genome-format.js +442 -442
  412. package/src/genome-schema.js +238 -238
  413. package/src/genomes/bindings.js +281 -281
  414. package/src/genomes.js +500 -500
  415. package/src/handoff-contract.js +417 -363
  416. package/src/handoff-validator.js +45 -45
  417. package/src/harness/circuit-breaker.js +135 -135
  418. package/src/i18n/index.js +103 -103
  419. package/src/i18n/messages/en.js +1548 -1434
  420. package/src/i18n/messages/es.js +1332 -1221
  421. package/src/i18n/messages/fr.js +1340 -1229
  422. package/src/i18n/messages/pt-BR.js +1568 -1457
  423. package/src/i18n/scaffold.js +64 -64
  424. package/src/install-animation.js +260 -260
  425. package/src/install-profile.js +127 -127
  426. package/src/install-wizard.js +475 -475
  427. package/src/installer-config-merge.js +207 -0
  428. package/src/installer.js +487 -358
  429. package/src/jargon-leak-doctor.js +257 -0
  430. package/src/learning-loop-archive.js +595 -0
  431. package/src/learning-loop-doctor.js +217 -0
  432. package/src/learning-loop-engine.js +254 -0
  433. package/src/learning-loop-fts5.js +132 -0
  434. package/src/learning-loop-migration.js +163 -0
  435. package/src/lib/dev-resume.js +140 -0
  436. package/src/lib/dossier-telemetry.js +36 -0
  437. package/src/lib/genomes/compat.js +206 -206
  438. package/src/lib/genomes/migrate.js +90 -90
  439. package/src/lib/git-commit-guard.js +751 -691
  440. package/src/lib/health-check.js +158 -158
  441. package/src/lib/hook-protocol.js +76 -76
  442. package/src/lib/llm-content-sanitizer.js +44 -0
  443. package/src/lib/security/artifact-reader.js +167 -167
  444. package/src/lib/security/exit-codes.js +51 -51
  445. package/src/lib/security/findings-writer.js +176 -176
  446. package/src/lib/security/runtime-events.js +77 -77
  447. package/src/lib/security/secrets-regex.js +115 -115
  448. package/src/lib/squads/genome-repair.js +49 -49
  449. package/src/lib/store/security-scan.js +175 -173
  450. package/src/lib/terminal-checkbox.js +135 -130
  451. package/src/lib/terminal-picker.js +447 -0
  452. package/src/lib/tmux-launcher.js +163 -163
  453. package/src/lib/tool-capabilities.js +102 -102
  454. package/src/lib/webhook-server.js +328 -328
  455. package/src/locales.js +88 -88
  456. package/src/mcp/apps/squad-dashboard/app.js +163 -163
  457. package/src/mcp/apps/squad-dashboard/index.html +261 -261
  458. package/src/mcp/apps/squad-dashboard/mcp-manifest.json +23 -23
  459. package/src/mcp/resources/squad-state.js +130 -130
  460. package/src/mcp-connectors/registry.js +602 -602
  461. package/src/memory-reflect-engine.js +359 -0
  462. package/src/migrations/profile-rename.js +66 -0
  463. package/src/notify-renderer.js +32 -0
  464. package/src/onboarding.js +307 -305
  465. package/src/parallel-workspace.js +756 -756
  466. package/src/parser.js +74 -66
  467. package/src/path-guard.js +47 -47
  468. package/src/permissions-generator.js +400 -0
  469. package/src/preflight-engine.js +654 -654
  470. package/src/prompt-tool.js +20 -20
  471. package/src/qa-html-report.js +472 -472
  472. package/src/recovery-context-session.js +154 -154
  473. package/src/runner/cascade.js +97 -97
  474. package/src/runner/cli-launcher.js +109 -109
  475. package/src/runner/plan-importer.js +63 -63
  476. package/src/runner/queue-store.js +159 -159
  477. package/src/runtime-store.js +2720 -2676
  478. package/src/sandbox.js +194 -177
  479. package/src/self-healing.js +142 -142
  480. package/src/session-handoff.js +295 -187
  481. package/src/squad/agent-teams-adapter.js +270 -264
  482. package/src/squad/brief-validator.js +350 -350
  483. package/src/squad/bus-bridge.js +140 -140
  484. package/src/squad/context-compactor.js +265 -265
  485. package/src/squad/cross-ai-synthesizer.js +250 -250
  486. package/src/squad/external-session.js +180 -180
  487. package/src/squad/hooks-generator.js +196 -196
  488. package/src/squad/inter-squad-events.js +175 -175
  489. package/src/squad/inter-squad.js +74 -74
  490. package/src/squad/intra-bus.js +345 -345
  491. package/src/squad/learning-extractor.js +213 -213
  492. package/src/squad/pattern-detector.js +365 -365
  493. package/src/squad/preflight-context.js +296 -296
  494. package/src/squad/recovery-context.js +372 -372
  495. package/src/squad/reflection.js +365 -365
  496. package/src/squad/squad-scaffold.js +341 -341
  497. package/src/squad/state-manager.js +310 -310
  498. package/src/squad/task-decomposer.js +652 -652
  499. package/src/squad/verify-gate.js +303 -303
  500. package/src/squad/worktree-manager.js +114 -114
  501. package/src/squad-daemon.js +490 -490
  502. package/src/squad-dashboard/api.js +223 -223
  503. package/src/squad-dashboard/attachment-handler.js +93 -93
  504. package/src/squad-dashboard/context-monitor.js +157 -157
  505. package/src/squad-dashboard/execution-logs.js +115 -115
  506. package/src/squad-dashboard/hunk-review.js +209 -209
  507. package/src/squad-dashboard/metrics.js +133 -133
  508. package/src/squad-dashboard/process-monitor.js +125 -125
  509. package/src/squad-dashboard/renderer.js +858 -858
  510. package/src/squad-dashboard/server.js +232 -232
  511. package/src/squad-dashboard/styles.js +525 -525
  512. package/src/squad-dashboard/token-tracker.js +99 -99
  513. package/src/squads/apply-genome.js +21 -21
  514. package/src/squads/genome-binding-service.js +154 -154
  515. package/src/sub-task-engine.js +415 -0
  516. package/src/sub-task-schemas.js +150 -0
  517. package/src/sub-task-state.js +152 -0
  518. package/src/sub-task-telemetry.js +69 -0
  519. package/src/test-briefing.js +226 -226
  520. package/src/tool-executor.js +94 -94
  521. package/src/updater.js +52 -39
  522. package/src/utils.js +49 -49
  523. package/src/version.js +50 -50
  524. package/src/web.js +284 -284
  525. package/src/worker-runner.js +541 -524
  526. package/src/workflow-gates.js +185 -185
  527. package/template/.aioson/advisors/.gitkeep +1 -1
  528. package/template/.aioson/agents/analyst.md +345 -318
  529. package/template/.aioson/agents/architect.md +325 -305
  530. package/template/.aioson/agents/{cypher.md → briefing.md} +264 -252
  531. package/template/.aioson/agents/committer.md +161 -161
  532. package/template/.aioson/agents/copywriter.md +937 -463
  533. package/template/.aioson/agents/design-hybrid-forge.md +141 -141
  534. package/template/.aioson/agents/dev.md +298 -263
  535. package/template/.aioson/agents/deyvin.md +200 -87
  536. package/template/.aioson/agents/discover.md +235 -235
  537. package/template/.aioson/agents/discovery-design-doc.md +56 -29
  538. package/template/.aioson/agents/genome.md +1904 -364
  539. package/template/.aioson/agents/manifests/analyst.manifest.json +26 -26
  540. package/template/.aioson/agents/manifests/architect.manifest.json +23 -23
  541. package/template/.aioson/agents/manifests/committer.manifest.json +23 -23
  542. package/template/.aioson/agents/manifests/dev.manifest.json +54 -37
  543. package/template/.aioson/agents/manifests/deyvin.manifest.json +41 -0
  544. package/template/.aioson/agents/manifests/orchestrator.manifest.json +30 -30
  545. package/template/.aioson/agents/manifests/pentester.manifest.json +39 -39
  546. package/template/.aioson/agents/manifests/pm.manifest.json +26 -26
  547. package/template/.aioson/agents/manifests/product.manifest.json +23 -23
  548. package/template/.aioson/agents/manifests/qa.manifest.json +41 -25
  549. package/template/.aioson/agents/manifests/setup.manifest.json +20 -20
  550. package/template/.aioson/agents/manifests/ux-ui.manifest.json +24 -24
  551. package/template/.aioson/agents/neo.md +356 -231
  552. package/template/.aioson/agents/orache.md +430 -430
  553. package/template/.aioson/agents/orchestrator.md +274 -263
  554. package/template/.aioson/agents/pair.md +5 -5
  555. package/template/.aioson/agents/pentester.md +289 -235
  556. package/template/.aioson/agents/pm.md +141 -130
  557. package/template/.aioson/agents/product.md +367 -273
  558. package/template/.aioson/agents/profiler-enricher.md +331 -331
  559. package/template/.aioson/agents/profiler-forge.md +212 -212
  560. package/template/.aioson/agents/profiler-researcher.md +282 -282
  561. package/template/.aioson/agents/qa.md +432 -342
  562. package/template/.aioson/agents/setup.md +425 -423
  563. package/template/.aioson/agents/sheldon.md +259 -197
  564. package/template/.aioson/agents/site-forge.md +281 -281
  565. package/template/.aioson/agents/squad.md +160 -156
  566. package/template/.aioson/agents/tester.md +536 -473
  567. package/template/.aioson/agents/ux-ui.md +195 -162
  568. package/template/.aioson/agents/validator.md +101 -69
  569. package/template/.aioson/brains/README.md +132 -128
  570. package/template/.aioson/brains/_archived/.gitkeep +0 -0
  571. package/template/.aioson/brains/_index.json +34 -16
  572. package/template/.aioson/brains/dev/patterns.brain.json +79 -0
  573. package/template/.aioson/brains/scripts/query.js +107 -107
  574. package/template/.aioson/brains/sheldon/architecture-decisions.brain.json +79 -0
  575. package/template/.aioson/brains/site-forge/visual-patterns.brain.json +205 -205
  576. package/template/.aioson/config/autonomy-protocol.json +125 -43
  577. package/template/.aioson/config/learning-loop.json +10 -0
  578. package/template/.aioson/config/scout-engine.json +1 -0
  579. package/template/.aioson/config.md +410 -410
  580. package/template/.aioson/context/_archived/.gitkeep +0 -0
  581. package/template/.aioson/context/design-doc.md +136 -136
  582. package/template/.aioson/context/project-map.md +57 -57
  583. package/template/.aioson/context/project-pulse.md +34 -34
  584. package/template/.aioson/context/seeds/seed-example.md +27 -27
  585. package/template/.aioson/context/spec.md.template +54 -54
  586. package/template/.aioson/context/user-profile.md +42 -42
  587. package/template/.aioson/design-docs/code-reuse.md +48 -48
  588. package/template/.aioson/design-docs/componentization.md +47 -47
  589. package/template/.aioson/design-docs/file-size.md +52 -52
  590. package/template/.aioson/design-docs/folder-structure.md +51 -51
  591. package/template/.aioson/design-docs/naming.md +54 -54
  592. package/template/.aioson/docs/LAYERS.md +89 -89
  593. package/template/.aioson/docs/README.md +76 -76
  594. package/template/.aioson/docs/autonomy-protocol.md +80 -0
  595. package/template/.aioson/docs/briefing/briefing-craft.md +237 -0
  596. package/template/.aioson/docs/dev/execution-discipline.md +106 -106
  597. package/template/.aioson/docs/dev/stack-conventions.md +83 -83
  598. package/template/.aioson/docs/deyvin/continuity-recovery.md +57 -57
  599. package/template/.aioson/docs/deyvin/debugging-escalation.md +30 -30
  600. package/template/.aioson/docs/deyvin/pair-execution.md +44 -44
  601. package/template/.aioson/docs/deyvin/runtime-handoffs.md +42 -36
  602. package/template/.aioson/docs/example-external-api-context.md +72 -72
  603. package/template/.aioson/docs/handoff-persistence.md +94 -0
  604. package/template/.aioson/docs/pentester/app-playbooks.md +206 -0
  605. package/template/.aioson/docs/pentester/llm-supplychain.md +165 -0
  606. package/template/.aioson/docs/product/conversation-playbook.md +116 -116
  607. package/template/.aioson/docs/product/prd-contract.md +107 -107
  608. package/template/.aioson/docs/product/quality-lens.md +57 -57
  609. package/template/.aioson/docs/product/research-loop.md +65 -65
  610. package/template/.aioson/docs/sheldon/enrichment-paths.md +134 -134
  611. package/template/.aioson/docs/sheldon/harness-contract.md +118 -0
  612. package/template/.aioson/docs/sheldon/quality-lens.md +57 -57
  613. package/template/.aioson/docs/sheldon/research-loop.md +56 -56
  614. package/template/.aioson/docs/sheldon/web-intelligence.md +75 -75
  615. package/template/.aioson/docs/site-forge-build.md +195 -195
  616. package/template/.aioson/docs/site-forge-extraction.md +135 -135
  617. package/template/.aioson/docs/site-forge-qa.md +155 -155
  618. package/template/.aioson/docs/site-forge-recon.md +434 -434
  619. package/template/.aioson/docs/site-forge-transform.md +249 -249
  620. package/template/.aioson/docs/squad/content-output.md +91 -91
  621. package/template/.aioson/docs/squad/creation-flow.md +149 -135
  622. package/template/.aioson/docs/squad/domain-breadth.md +322 -0
  623. package/template/.aioson/docs/squad/domain-classification.md +117 -117
  624. package/template/.aioson/docs/squad/genome-bindings.md +47 -47
  625. package/template/.aioson/docs/squad/package-contract.md +260 -234
  626. package/template/.aioson/docs/squad/quality-lens.md +60 -56
  627. package/template/.aioson/docs/squad/research-loop.md +59 -59
  628. package/template/.aioson/docs/squad/session-operations.md +117 -117
  629. package/template/.aioson/docs/squad/workflow-quality.md +165 -165
  630. package/template/.aioson/docs/tester/coverage-quality.md +351 -0
  631. package/template/.aioson/docs/ux-ui/accessibility-audit.md +55 -55
  632. package/template/.aioson/docs/ux-ui/audit-mode.md +86 -86
  633. package/template/.aioson/docs/ux-ui/component-map.md +35 -35
  634. package/template/.aioson/docs/ux-ui/design-execution.md +111 -111
  635. package/template/.aioson/docs/ux-ui/design-gate.md +27 -27
  636. package/template/.aioson/docs/ux-ui/research-mode.md +39 -39
  637. package/template/.aioson/docs/ux-ui/site-delivery.md +156 -156
  638. package/template/.aioson/docs/ux-ui/token-contract.md +57 -57
  639. package/template/.aioson/genomes/INDEX.md +195 -0
  640. package/template/.aioson/genomes/copywriting/SKILL.md +137 -0
  641. package/template/.aioson/genomes/copywriting/manifest.json +140 -0
  642. package/template/.aioson/genomes/copywriting/references/application-notes.md +145 -0
  643. package/template/.aioson/genomes/copywriting/references/decision-weights.md +45 -0
  644. package/template/.aioson/genomes/copywriting/references/frameworks/5-act-narrative.md +184 -0
  645. package/template/.aioson/genomes/copywriting/references/frameworks/classical-formulas.md +164 -0
  646. package/template/.aioson/genomes/copywriting/references/frameworks/offer-stack.md +195 -0
  647. package/template/.aioson/genomes/copywriting/references/frameworks/one-belief.md +135 -0
  648. package/template/.aioson/genomes/copywriting/references/frameworks/pms-research.md +211 -0
  649. package/template/.aioson/genomes/copywriting/references/frameworks/two-paths-close.md +190 -0
  650. package/template/.aioson/genomes/copywriting/references/heuristics.md +114 -0
  651. package/template/.aioson/genomes/copywriting/references/meta-axioms.md +68 -0
  652. package/template/.aioson/genomes/copywriting/references/methodology.md +115 -0
  653. package/template/.aioson/genomes/copywriting-brunson/SKILL.md +133 -0
  654. package/template/.aioson/genomes/copywriting-brunson/manifest.json +152 -0
  655. package/template/.aioson/genomes/copywriting-brunson/references/application-notes.md +113 -0
  656. package/template/.aioson/genomes/copywriting-brunson/references/decision-weights.md +33 -0
  657. package/template/.aioson/genomes/copywriting-brunson/references/evidence-and-attribution.md +81 -0
  658. package/template/.aioson/genomes/copywriting-brunson/references/frameworks/6-part-structure.md +136 -0
  659. package/template/.aioson/genomes/copywriting-brunson/references/frameworks/origin-story.md +121 -0
  660. package/template/.aioson/genomes/copywriting-brunson/references/frameworks/perfect-webinar-script.md +139 -0
  661. package/template/.aioson/genomes/copywriting-brunson/references/frameworks/persuasive-storytelling-5-structures.md +164 -0
  662. package/template/.aioson/genomes/copywriting-brunson/references/frameworks/value-stack.md +136 -0
  663. package/template/.aioson/genomes/copywriting-brunson/references/frameworks/who-what-why-how.md +110 -0
  664. package/template/.aioson/genomes/copywriting-brunson/references/meta-axioms.md +36 -0
  665. package/template/.aioson/genomes/copywriting-brunson/references/methodology.md +112 -0
  666. package/template/.aioson/git-guard.json +12 -11
  667. package/template/.aioson/mcp/servers.md +23 -23
  668. package/template/.aioson/profiler-reports/.gitkeep +1 -1
  669. package/template/.aioson/rules/README.md +69 -69
  670. package/template/.aioson/rules/_archived/.gitkeep +0 -0
  671. package/template/.aioson/rules/agent-language-policy.md +93 -93
  672. package/template/.aioson/rules/aioson-context-boundary.md +63 -63
  673. package/template/.aioson/rules/canonical-path-contract.md +47 -47
  674. package/template/.aioson/rules/data-format-convention.md +74 -74
  675. package/template/.aioson/rules/disk-first-artifacts.md +44 -44
  676. package/template/.aioson/rules/example-monetary-values.md +30 -30
  677. package/template/.aioson/rules/output-brevity.md +44 -44
  678. package/template/.aioson/rules/prd-section-ownership.md +49 -49
  679. package/template/.aioson/rules/security-baseline.md +139 -139
  680. package/template/.aioson/rules/spec-level-ownership.md +61 -61
  681. package/template/.aioson/rules/squad/README.md +50 -50
  682. package/template/.aioson/rules/squad-driver-pattern.md +81 -81
  683. package/template/.aioson/schemas/content-blueprint.schema.json +30 -30
  684. package/template/.aioson/schemas/genome-meta.schema.json +150 -150
  685. package/template/.aioson/schemas/genome.schema.json +115 -115
  686. package/template/.aioson/schemas/readiness.schema.json +27 -27
  687. package/template/.aioson/schemas/squad-blueprint.schema.json +228 -228
  688. package/template/.aioson/schemas/squad-manifest.schema.json +874 -874
  689. package/template/.aioson/skills/design/aurora-command-ui/SKILL.md +243 -243
  690. package/template/.aioson/skills/design/aurora-command-ui/references/art-direction.md +293 -293
  691. package/template/.aioson/skills/design/aurora-command-ui/references/components.md +827 -827
  692. package/template/.aioson/skills/design/aurora-command-ui/references/dashboards.md +250 -250
  693. package/template/.aioson/skills/design/aurora-command-ui/references/design-tokens.md +585 -585
  694. package/template/.aioson/skills/design/aurora-command-ui/references/motion.md +365 -365
  695. package/template/.aioson/skills/design/aurora-command-ui/references/patterns.md +482 -482
  696. package/template/.aioson/skills/design/aurora-command-ui/references/websites.md +387 -387
  697. package/template/.aioson/skills/design/bold-editorial-ui/SKILL.md +205 -205
  698. package/template/.aioson/skills/design/bold-editorial-ui/references/art-direction.md +338 -338
  699. package/template/.aioson/skills/design/bold-editorial-ui/references/components.md +977 -977
  700. package/template/.aioson/skills/design/bold-editorial-ui/references/dashboards.md +218 -218
  701. package/template/.aioson/skills/design/bold-editorial-ui/references/design-tokens.md +326 -326
  702. package/template/.aioson/skills/design/bold-editorial-ui/references/motion.md +461 -461
  703. package/template/.aioson/skills/design/bold-editorial-ui/references/patterns.md +293 -293
  704. package/template/.aioson/skills/design/bold-editorial-ui/references/websites.md +352 -352
  705. package/template/.aioson/skills/design/clean-saas-ui/SKILL.md +210 -210
  706. package/template/.aioson/skills/design/clean-saas-ui/references/art-direction.md +319 -319
  707. package/template/.aioson/skills/design/clean-saas-ui/references/components.md +365 -365
  708. package/template/.aioson/skills/design/clean-saas-ui/references/dashboards.md +196 -196
  709. package/template/.aioson/skills/design/clean-saas-ui/references/design-tokens.md +244 -244
  710. package/template/.aioson/skills/design/clean-saas-ui/references/motion.md +235 -235
  711. package/template/.aioson/skills/design/clean-saas-ui/references/patterns.md +215 -215
  712. package/template/.aioson/skills/design/clean-saas-ui/references/websites.md +295 -295
  713. package/template/.aioson/skills/design/cognitive-core-ui/SKILL.md +203 -203
  714. package/template/.aioson/skills/design/cognitive-core-ui/references/art-direction.md +339 -339
  715. package/template/.aioson/skills/design/cognitive-core-ui/references/components.md +407 -407
  716. package/template/.aioson/skills/design/cognitive-core-ui/references/dashboards.md +272 -272
  717. package/template/.aioson/skills/design/cognitive-core-ui/references/design-tokens.md +524 -524
  718. package/template/.aioson/skills/design/cognitive-core-ui/references/motion.md +279 -279
  719. package/template/.aioson/skills/design/cognitive-core-ui/references/patterns.md +289 -289
  720. package/template/.aioson/skills/design/cognitive-core-ui/references/websites.md +437 -437
  721. package/template/.aioson/skills/design/glassmorphism-ui/SKILL.md +222 -222
  722. package/template/.aioson/skills/design/glassmorphism-ui/references/art-direction.md +159 -159
  723. package/template/.aioson/skills/design/glassmorphism-ui/references/components.md +498 -498
  724. package/template/.aioson/skills/design/glassmorphism-ui/references/dashboards.md +236 -236
  725. package/template/.aioson/skills/design/glassmorphism-ui/references/design-tokens.md +274 -274
  726. package/template/.aioson/skills/design/glassmorphism-ui/references/motion.md +355 -355
  727. package/template/.aioson/skills/design/glassmorphism-ui/references/patterns.md +198 -198
  728. package/template/.aioson/skills/design/glassmorphism-ui/references/websites.md +307 -307
  729. package/template/.aioson/skills/design/interface-design/SKILL.md +47 -47
  730. package/template/.aioson/skills/design/interface-design/references/components-and-states.md +105 -105
  731. package/template/.aioson/skills/design/interface-design/references/design-directions.md +101 -101
  732. package/template/.aioson/skills/design/interface-design/references/handoff-and-quality.md +71 -71
  733. package/template/.aioson/skills/design/interface-design/references/intent-and-domain.md +74 -74
  734. package/template/.aioson/skills/design/interface-design/references/tokens-and-depth.md +173 -173
  735. package/template/.aioson/skills/design/neo-brutalist-ui/SKILL.md +213 -213
  736. package/template/.aioson/skills/design/neo-brutalist-ui/references/art-direction.md +228 -228
  737. package/template/.aioson/skills/design/neo-brutalist-ui/references/components.md +855 -855
  738. package/template/.aioson/skills/design/neo-brutalist-ui/references/dashboards.md +334 -334
  739. package/template/.aioson/skills/design/neo-brutalist-ui/references/design-tokens.md +342 -342
  740. package/template/.aioson/skills/design/neo-brutalist-ui/references/motion.md +286 -286
  741. package/template/.aioson/skills/design/neo-brutalist-ui/references/patterns.md +458 -458
  742. package/template/.aioson/skills/design/neo-brutalist-ui/references/websites.md +723 -723
  743. package/template/.aioson/skills/design/premium-command-center-ui/SKILL.md +62 -62
  744. package/template/.aioson/skills/design/premium-command-center-ui/references/operations.md +74 -74
  745. package/template/.aioson/skills/design/premium-command-center-ui/references/patterns.md +116 -116
  746. package/template/.aioson/skills/design/premium-command-center-ui/references/validation.md +47 -47
  747. package/template/.aioson/skills/design/premium-command-center-ui/references/visual-system.md +215 -215
  748. package/template/.aioson/skills/design/pt.squarespace.com/.skill-meta.json +31 -31
  749. package/template/.aioson/skills/design/pt.squarespace.com/SKILL.md +66 -66
  750. package/template/.aioson/skills/design/pt.squarespace.com/references/components.md +368 -368
  751. package/template/.aioson/skills/design/pt.squarespace.com/references/design-tokens.md +150 -150
  752. package/template/.aioson/skills/design/pt.squarespace.com/references/motion.md +270 -270
  753. package/template/.aioson/skills/design/pt.squarespace.com/references/patterns.md +189 -189
  754. package/template/.aioson/skills/design/pt.squarespace.com/references/websites.md +165 -165
  755. package/template/.aioson/skills/design/warm-craft-ui/SKILL.md +209 -209
  756. package/template/.aioson/skills/design/warm-craft-ui/references/art-direction.md +324 -324
  757. package/template/.aioson/skills/design/warm-craft-ui/references/components.md +508 -508
  758. package/template/.aioson/skills/design/warm-craft-ui/references/dashboards.md +223 -223
  759. package/template/.aioson/skills/design/warm-craft-ui/references/design-tokens.md +374 -374
  760. package/template/.aioson/skills/design/warm-craft-ui/references/motion.md +356 -356
  761. package/template/.aioson/skills/design/warm-craft-ui/references/patterns.md +288 -288
  762. package/template/.aioson/skills/design/warm-craft-ui/references/websites.md +289 -289
  763. package/template/.aioson/skills/design-system/SKILL.md +92 -92
  764. package/template/.aioson/skills/design-system/components/SKILL.md +274 -274
  765. package/template/.aioson/skills/design-system/dashboards/SKILL.md +184 -184
  766. package/template/.aioson/skills/design-system/foundations/SKILL.md +250 -250
  767. package/template/.aioson/skills/design-system/motion/SKILL.md +197 -197
  768. package/template/.aioson/skills/design-system/patterns/SKILL.md +231 -231
  769. package/template/.aioson/skills/dynamic/README.md +30 -30
  770. package/template/.aioson/skills/dynamic/cardano-docs.md +16 -16
  771. package/template/.aioson/skills/dynamic/ethereum-docs.md +17 -17
  772. package/template/.aioson/skills/dynamic/flux-ui-docs.md +13 -13
  773. package/template/.aioson/skills/dynamic/laravel-docs.md +41 -41
  774. package/template/.aioson/skills/dynamic/npm-packages.md +16 -16
  775. package/template/.aioson/skills/dynamic/solana-docs.md +16 -16
  776. package/template/.aioson/skills/marketing/references/anti-patterns.md +254 -254
  777. package/template/.aioson/skills/marketing/references/cta-matrix.md +361 -0
  778. package/template/.aioson/skills/marketing/references/fascinations.md +192 -192
  779. package/template/.aioson/skills/marketing/references/five-acts.md +248 -248
  780. package/template/.aioson/skills/marketing/references/headline-matrix.md +358 -0
  781. package/template/.aioson/skills/marketing/references/market-intelligence.md +198 -198
  782. package/template/.aioson/skills/marketing/references/offer-structure.md +203 -203
  783. package/template/.aioson/skills/marketing/references/one-belief.md +149 -149
  784. package/template/.aioson/skills/marketing/references/patterns.md +218 -218
  785. package/template/.aioson/skills/marketing/references/platform-constraints.md +337 -0
  786. package/template/.aioson/skills/marketing/references/pms-research.md +193 -193
  787. package/template/.aioson/skills/marketing/vsl-craft.md +385 -385
  788. package/template/.aioson/skills/premium-visual-design/SKILL.md +83 -83
  789. package/template/.aioson/skills/premium-visual-design/components/agent-badge.md +92 -92
  790. package/template/.aioson/skills/premium-visual-design/components/dependency-node.md +102 -102
  791. package/template/.aioson/skills/premium-visual-design/components/mention-autocomplete.md +136 -136
  792. package/template/.aioson/skills/premium-visual-design/components/notification-center.md +136 -136
  793. package/template/.aioson/skills/premium-visual-design/components/review-action-bar.md +188 -188
  794. package/template/.aioson/skills/premium-visual-design/components/team-switcher.md +131 -131
  795. package/template/.aioson/skills/premium-visual-design/patterns/agent-message-thread.md +198 -198
  796. package/template/.aioson/skills/premium-visual-design/patterns/notification-panel.md +275 -275
  797. package/template/.aioson/skills/premium-visual-design/patterns/review-workflow-ui.md +234 -234
  798. package/template/.aioson/skills/premium-visual-design/patterns/task-dependency-graph.md +147 -147
  799. package/template/.aioson/skills/premium-visual-design/tokens/status-extended.md +142 -142
  800. package/template/.aioson/skills/process/aioson-spec-driven/SKILL.md +46 -46
  801. package/template/.aioson/skills/process/aioson-spec-driven/references/analyst.md +30 -30
  802. package/template/.aioson/skills/process/aioson-spec-driven/references/approval-gates.md +109 -109
  803. package/template/.aioson/skills/process/aioson-spec-driven/references/architect.md +23 -23
  804. package/template/.aioson/skills/process/aioson-spec-driven/references/artifact-map.md +44 -44
  805. package/template/.aioson/skills/process/aioson-spec-driven/references/classification-map.md +37 -37
  806. package/template/.aioson/skills/process/aioson-spec-driven/references/dev.md +47 -47
  807. package/template/.aioson/skills/process/aioson-spec-driven/references/deyvin.md +27 -27
  808. package/template/.aioson/skills/process/aioson-spec-driven/references/hardening-lane.md +49 -49
  809. package/template/.aioson/skills/process/aioson-spec-driven/references/maintenance-and-state.md +101 -101
  810. package/template/.aioson/skills/process/aioson-spec-driven/references/pm.md +30 -30
  811. package/template/.aioson/skills/process/aioson-spec-driven/references/product.md +25 -25
  812. package/template/.aioson/skills/process/aioson-spec-driven/references/qa.md +30 -30
  813. package/template/.aioson/skills/process/aioson-spec-driven/references/sheldon.md +25 -25
  814. package/template/.aioson/skills/process/aioson-spec-driven/references/ui-language.md +75 -75
  815. package/template/.aioson/skills/process/decision-presentation/SKILL.md +119 -0
  816. package/template/.aioson/skills/process/decision-presentation/references/jargon-map.en.yaml +108 -0
  817. package/template/.aioson/skills/process/decision-presentation/references/jargon-map.pt-BR.yaml +108 -0
  818. package/template/.aioson/skills/process/design-hybrid-forge/SKILL.md +147 -147
  819. package/template/.aioson/skills/process/design-hybrid-forge/references/crossover-protocol.md +221 -221
  820. package/template/.aioson/skills/process/design-hybrid-forge/references/naming-registry.md +88 -88
  821. package/template/.aioson/skills/process/design-hybrid-forge/references/output-contract.md +306 -306
  822. package/template/.aioson/skills/process/design-hybrid-forge/references/pair-compatibility.md +149 -149
  823. package/template/.aioson/skills/process/design-hybrid-forge/references/quality-gates.md +208 -208
  824. package/template/.aioson/skills/process/design-hybrid-forge/references/variation-library.md +125 -125
  825. package/template/.aioson/skills/process/secure-tdd/SKILL.md +97 -97
  826. package/template/.aioson/skills/process/simplify/SKILL.md +173 -173
  827. package/template/.aioson/skills/references/premium-command-center-ui/master-application-prompt.md +79 -79
  828. package/template/.aioson/skills/references/premium-command-center-ui/operational-ux-playbook.md +253 -253
  829. package/template/.aioson/skills/references/premium-command-center-ui/quality-validation-checklist.md +82 -82
  830. package/template/.aioson/skills/references/premium-command-center-ui/visual-system-and-component-patterns.md +270 -270
  831. package/template/.aioson/skills/squad/SKILL.md +58 -58
  832. package/template/.aioson/skills/squad/formats/catalog.json +15 -15
  833. package/template/.aioson/skills/squad/formats/content/blog-post.md +47 -47
  834. package/template/.aioson/skills/squad/formats/content/newsletter.md +47 -47
  835. package/template/.aioson/skills/squad/formats/creative/podcast-script.md +43 -43
  836. package/template/.aioson/skills/squad/formats/creative/video-script.md +41 -41
  837. package/template/.aioson/skills/squad/formats/social/instagram-feed.md +42 -42
  838. package/template/.aioson/skills/squad/formats/social/linkedin-post.md +42 -42
  839. package/template/.aioson/skills/squad/formats/social/tiktok.md +39 -39
  840. package/template/.aioson/skills/squad/formats/social/twitter-thread.md +39 -39
  841. package/template/.aioson/skills/squad/formats/social/youtube-long.md +47 -47
  842. package/template/.aioson/skills/squad/formats/social/youtube-shorts.md +39 -39
  843. package/template/.aioson/skills/squad/patterns/multi-platform-pattern.md +108 -108
  844. package/template/.aioson/skills/squad/patterns/persona-based-pattern.md +98 -98
  845. package/template/.aioson/skills/squad/patterns/pipeline-pattern.md +106 -106
  846. package/template/.aioson/skills/squad/patterns/review-loop-pattern.md +81 -81
  847. package/template/.aioson/skills/squad/references/checklist-templates.md +122 -122
  848. package/template/.aioson/skills/squad/references/executor-archetypes.md +123 -123
  849. package/template/.aioson/skills/squad/references/workflow-templates.md +169 -169
  850. package/template/.aioson/skills/static/context-budget-guide.md +46 -46
  851. package/template/.aioson/skills/static/debugging-protocol.md +42 -42
  852. package/template/.aioson/skills/static/django-patterns.md +342 -342
  853. package/template/.aioson/skills/static/fastapi-patterns.md +344 -344
  854. package/template/.aioson/skills/static/filament-patterns.md +267 -267
  855. package/template/.aioson/skills/static/flux-ui-components.md +262 -262
  856. package/template/.aioson/skills/static/git-conventions.md +227 -227
  857. package/template/.aioson/skills/static/git-worktrees.md +36 -36
  858. package/template/.aioson/skills/static/harness-sensors.md +74 -74
  859. package/template/.aioson/skills/static/harness-validate/SKILL.md +46 -46
  860. package/template/.aioson/skills/static/jetstream-setup.md +200 -200
  861. package/template/.aioson/skills/static/landing-page-deploy.md +192 -192
  862. package/template/.aioson/skills/static/landing-page-forge.md +730 -730
  863. package/template/.aioson/skills/static/laravel-conventions.md +491 -491
  864. package/template/.aioson/skills/static/multi-agent-patterns.md +43 -43
  865. package/template/.aioson/skills/static/nextjs-patterns.md +321 -321
  866. package/template/.aioson/skills/static/node-express-patterns.md +317 -317
  867. package/template/.aioson/skills/static/node-typescript-patterns.md +282 -282
  868. package/template/.aioson/skills/static/rails-conventions.md +307 -307
  869. package/template/.aioson/skills/static/react-motion-patterns.md +599 -599
  870. package/template/.aioson/skills/static/static-html-patterns/checklists.md +43 -43
  871. package/template/.aioson/skills/static/static-html-patterns/css-tokens.md +609 -609
  872. package/template/.aioson/skills/static/static-html-patterns/motion.md +193 -193
  873. package/template/.aioson/skills/static/static-html-patterns/premium.md +711 -711
  874. package/template/.aioson/skills/static/static-html-patterns/structure.md +209 -209
  875. package/template/.aioson/skills/static/static-html-patterns/utilities.md +190 -190
  876. package/template/.aioson/skills/static/static-html-patterns.md +80 -80
  877. package/template/.aioson/skills/static/tall-stack-patterns.md +286 -286
  878. package/template/.aioson/skills/static/threejs-patterns.md +929 -929
  879. package/template/.aioson/skills/static/ui-ux-modern.md +76 -76
  880. package/template/.aioson/skills/static/web-research-cache.md +115 -115
  881. package/template/.aioson/skills/static/web3-cardano-patterns.md +337 -337
  882. package/template/.aioson/skills/static/web3-ethereum-patterns.md +310 -310
  883. package/template/.aioson/skills/static/web3-security-checklist.md +284 -284
  884. package/template/.aioson/skills/static/web3-solana-patterns.md +324 -324
  885. package/template/.aioson/squads/memory.md +5 -5
  886. package/template/.aioson/tasks/implementation-plan.md +327 -327
  887. package/template/.aioson/tasks/squad-analyze.md +83 -83
  888. package/template/.aioson/tasks/squad-create.md +148 -148
  889. package/template/.aioson/tasks/squad-design.md +206 -206
  890. package/template/.aioson/tasks/squad-execution-plan.md +279 -279
  891. package/template/.aioson/tasks/squad-export.md +20 -20
  892. package/template/.aioson/tasks/squad-extend.md +68 -68
  893. package/template/.aioson/tasks/squad-investigate.md +57 -57
  894. package/template/.aioson/tasks/squad-learning-review.md +44 -44
  895. package/template/.aioson/tasks/squad-output-config.md +177 -177
  896. package/template/.aioson/tasks/squad-pipeline.md +122 -122
  897. package/template/.aioson/tasks/squad-profile.md +48 -48
  898. package/template/.aioson/tasks/squad-refresh.md +236 -0
  899. package/template/.aioson/tasks/squad-repair.md +85 -85
  900. package/template/.aioson/tasks/squad-review.md +61 -61
  901. package/template/.aioson/tasks/squad-task-decompose.md +66 -66
  902. package/template/.aioson/tasks/squad-validate.md +58 -58
  903. package/template/.aioson/templates/reflect-prompts/current-state.md +36 -0
  904. package/template/.aioson/templates/reflect-prompts/how-it-works.md +23 -0
  905. package/template/.aioson/templates/reflect-prompts/what-it-does.md +21 -0
  906. package/template/.aioson/templates/squads/content-basic/template.json +21 -21
  907. package/template/.aioson/templates/squads/digital-marketing-agency/template.json +96 -96
  908. package/template/.aioson/templates/squads/media-channel/template.json +24 -24
  909. package/template/.aioson/templates/squads/research-analysis/template.json +22 -22
  910. package/template/.aioson/templates/squads/software-delivery/template.json +21 -21
  911. package/template/.claude/commands/aioson/agent/analyst.md +5 -5
  912. package/template/.claude/commands/aioson/agent/architect.md +5 -5
  913. package/template/.claude/commands/aioson/agent/briefing.md +5 -0
  914. package/template/.claude/commands/aioson/agent/committer.md +5 -5
  915. package/template/.claude/commands/aioson/agent/copywriter.md +5 -5
  916. package/template/.claude/commands/aioson/agent/design-hybrid-forge.md +5 -5
  917. package/template/.claude/commands/aioson/agent/dev.md +5 -5
  918. package/template/.claude/commands/aioson/agent/deyvin.md +5 -5
  919. package/template/.claude/commands/aioson/agent/discover.md +5 -0
  920. package/template/.claude/commands/aioson/agent/discovery-design-doc.md +5 -5
  921. package/template/.claude/commands/aioson/agent/genome.md +5 -5
  922. package/template/.claude/commands/aioson/agent/neo.md +5 -5
  923. package/template/.claude/commands/aioson/agent/orache.md +5 -5
  924. package/template/.claude/commands/aioson/agent/orchestrator.md +5 -5
  925. package/template/.claude/commands/aioson/agent/pair.md +5 -5
  926. package/template/.claude/commands/aioson/agent/pentester.md +5 -0
  927. package/template/.claude/commands/aioson/agent/pm.md +5 -5
  928. package/template/.claude/commands/aioson/agent/product.md +5 -5
  929. package/template/.claude/commands/aioson/agent/profiler-enricher.md +5 -5
  930. package/template/.claude/commands/aioson/agent/profiler-forge.md +5 -5
  931. package/template/.claude/commands/aioson/agent/profiler-researcher.md +5 -5
  932. package/template/.claude/commands/aioson/agent/qa.md +5 -5
  933. package/template/.claude/commands/aioson/agent/setup.md +5 -5
  934. package/template/.claude/commands/aioson/agent/sheldon.md +5 -5
  935. package/template/.claude/commands/aioson/agent/site-forge.md +5 -5
  936. package/template/.claude/commands/aioson/agent/squad.md +5 -5
  937. package/template/.claude/commands/aioson/agent/tester.md +5 -5
  938. package/template/.claude/commands/aioson/agent/ux-ui.md +5 -5
  939. package/template/.claude/commands/aioson/agent/validator.md +5 -5
  940. package/template/.gemini/GEMINI.md +13 -13
  941. package/template/.gemini/commands/aios-analyst.toml +7 -7
  942. package/template/.gemini/commands/aios-architect.toml +8 -8
  943. package/template/.gemini/commands/aios-committer.toml +7 -7
  944. package/template/.gemini/commands/aios-copywriter.toml +7 -7
  945. package/template/.gemini/commands/aios-cypher.toml +7 -7
  946. package/template/.gemini/commands/aios-dev.toml +9 -9
  947. package/template/.gemini/commands/aios-deyvin.toml +7 -7
  948. package/template/.gemini/commands/aios-discover.toml +6 -0
  949. package/template/.gemini/commands/aios-discovery-design-doc.toml +7 -7
  950. package/template/.gemini/commands/aios-genome.toml +7 -7
  951. package/template/.gemini/commands/aios-neo.toml +6 -6
  952. package/template/.gemini/commands/aios-orache.toml +7 -7
  953. package/template/.gemini/commands/aios-orchestrator.toml +9 -9
  954. package/template/.gemini/commands/aios-pair.toml +7 -7
  955. package/template/.gemini/commands/aios-pm.toml +9 -9
  956. package/template/.gemini/commands/aios-product.toml +6 -6
  957. package/template/.gemini/commands/aios-qa.toml +7 -7
  958. package/template/.gemini/commands/aios-setup.toml +6 -6
  959. package/template/.gemini/commands/aios-sheldon.toml +7 -7
  960. package/template/.gemini/commands/aios-site-forge.toml +7 -7
  961. package/template/.gemini/commands/aios-squad.toml +7 -7
  962. package/template/.gemini/commands/aios-tester.toml +7 -7
  963. package/template/.gemini/commands/aios-ux-ui.toml +9 -9
  964. package/template/.gemini/commands/aios-validator.toml +7 -7
  965. package/template/AGENTS.md +184 -183
  966. package/template/CLAUDE.md +98 -97
  967. package/template/OPENCODE.md +35 -34
  968. package/template/aioson-models.json +40 -40
  969. package/template/.aioson/genomes/copywriting.md +0 -204
  970. package/template/.aioson/genomes/copywriting.meta.json +0 -48
  971. package/template/.aioson/skills/process/secure-tdd/references/nextjs.md +0 -81
  972. package/template/.aioson/skills/process/secure-tdd/references/node-express.md +0 -91
  973. package/template/.aioson/skills/process/secure-tdd/references/planned-stacks.md +0 -33
  974. package/template/.claude/commands/aioson/agent/cypher.md +0 -5
@@ -1,385 +1,385 @@
1
- ---
2
- name: vsl-craft
3
- description: Video Sales Letter production skill — script structure, hook formulas, retention techniques, testing methodology, and production specs. Loaded by @copywriter when Mode 5 (VSL) is active.
4
- ---
5
-
6
- # VSL Craft — Video Sales Letter Production
7
-
8
- ## When to load this skill
9
-
10
- - User requests a VSL script
11
- - User requests a video sales page (page with embedded sales video)
12
- - User requests an advertorial video
13
- - @copywriter Mode 5 is activated
14
- - Squad executor with VSL deliverable
15
-
16
- ---
17
-
18
- ## 1. What is a VSL?
19
-
20
- A Video Sales Letter is a scripted video (typically 10-45 minutes) designed to convert cold traffic into buyers. It replaces the live salesperson with a pre-recorded, optimized sales presentation.
21
-
22
- **Key differences from a written sales page:**
23
- - The viewer can't scan — they must watch sequentially
24
- - Retention is everything — if they leave at minute 3, the offer at minute 20 never gets seen
25
- - Audio + visual = two channels to reinforce the message
26
- - Pacing, pauses, and emotional tone are scripted, not left to chance
27
-
28
- ---
29
-
30
- ## 2. VSL formats
31
-
32
- ### 2.1 Traditional VSL (horizontal)
33
- - 16:9 format, presenter or slides
34
- - Duration: 15-45 minutes
35
- - Best for: sophisticated offers, higher ticket (R$297+), cold traffic from YouTube/Facebook
36
- - Production: can be "ugly" (slides only) or "cinematic" (B-roll, editing)
37
-
38
- ### 2.2 Vertical VSL (mobile-native)
39
- - 9:16 format, looks like organic content
40
- - Duration: 3-15 minutes
41
- - Best for: TikTok/Reels traffic, lower ticket, younger audiences
42
- - Production: phone-filmed, fast cuts, captions mandatory
43
-
44
- ### 2.3 Hybrid (advertorial + VSL)
45
- - Written advertorial page with embedded video at the mechanism section
46
- - The text does Act 1-2, the video does Act 3-5
47
- - Best for: sophisticated audiences who want to read before watching
48
-
49
- ---
50
-
51
- ## 3. The VSL script structure (5 Acts adapted for video)
52
-
53
- ### Act 1 — The Hook (0:00 to 0:30)
54
-
55
- **Goal:** Stop the scroll and keep them watching for the next 30 seconds.
56
-
57
- **The 3-second rule:** If the first 3 seconds aren't arresting, the viewer leaves.
58
-
59
- **Hook formulas for VSL:**
60
-
61
- **Formula 1: The Discovery Hook**
62
- > "What you're about to see in the next [X] minutes could change the way you [desired outcome] forever. I'm going to show you [specific discovery] that [specific proof]."
63
-
64
- **Formula 2: The Proof-First Hook**
65
- > "[Name], [age], from [city], lost [specific result] in [specific time]. And she did it without [painful thing]. Today I'm going to show you exactly how — and why it works even if [objection]."
66
-
67
- **Formula 3: The Paradox Hook**
68
- > "Why do [specific group] [achieve result] while [audience group] [fail despite effort]? The answer has nothing to do with [obvious thing] — and everything to do with [curiosity element]."
69
-
70
- **Formula 4: The Warning Hook**
71
- > "If you're [doing common thing], stop immediately. A [authority/study] just revealed that [counterintuitive finding] — and it's costing you [consequence]. Stay with me for [time] and I'll show you [solution]."
72
-
73
- **Formula 5: The Story Hook**
74
- > "Last [day], [specific person] sent me this message: [screenshot/quote]. [X time] ago, they were [painful situation]. Today they [desired outcome]. This is their story — and it starts with [curiosity element]."
75
-
76
- **Anti-pattern hooks:**
77
- - "Hey everyone, welcome to my channel..." → Zero curiosity
78
- - "In this video I'm going to talk about..." → Passive, no hook
79
- - "So, I've been getting a lot of questions about..." → About you, not them
80
-
81
- ### Act 2 — The Background (0:30 to 3:00)
82
-
83
- **Goal:** Build authority and emotional connection quickly.
84
-
85
- **For expert-led VSL:**
86
- > "[Credentials in one sentence]. But what matters more than my degrees is this: I've helped [specific number] of people [achieve result], and what I discovered along the way is the reason you're watching this video."
87
-
88
- **For avatar transformation:**
89
- > "I know what it's like to [specific pain]. [Time] ago, I was [painful situation — specific details]. I tried [what they've tried]. Nothing worked. Until [discovery moment]."
90
-
91
- **Key rule:** Act 2 must be SHORT in a VSL. On a written page, you can have a long background section. On video, 1-2 minutes max. Get to the mechanism fast.
92
-
93
- ### Act 3 — The Mechanism (3:00 to 12:00)
94
-
95
- **Goal:** Create the "Aha!" moment. This is where the One Belief is built.
96
-
97
- **Structure:**
98
-
99
- **Part A — Why nothing else worked (2-4 minutes)**
100
- 1. Name what they've tried (validate their experience)
101
- 2. Reveal the hidden reason it failed (the enemy — not them)
102
- 3. Use a visual metaphor or diagram to make the concept tangible
103
-
104
- **Part B — How [Mechanism Name] works (3-5 minutes)**
105
- 1. Introduce the mechanism by name
106
- 2. Explain it at surface level (simple enough for a 12-year-old)
107
- 3. Show ONE proof point (study, case study, demonstration)
108
- 4. Use B-roll or diagrams to illustrate — never just talk over static slides for more than 30 seconds
109
-
110
- **Retention techniques for Act 3:**
111
- - **Pattern interrupt every 60-90 seconds:** Change the visual, show a diagram, cut to B-roll, display a quote
112
- - **Open loops:** "In a moment I'll show you the third step — but first you need to understand why..."
113
- - **Micro-fascinations:** Drop curiosity bullets throughout: "The ingredient I'm about to mention is in 90% of Brazilian homes but nobody knows it does THIS..."
114
- - **Density escalation:** Each minute should be MORE interesting than the last, not less
115
-
116
- ### Act 4 — The Offer (12:00 to 18:00)
117
-
118
- **Goal:** Transition from education to sale without breaking trust.
119
-
120
- **The transition bridge:**
121
- > "So now you understand WHY [mechanism] works and HOW it produces [result]. The question is: how do YOU implement it? That's exactly why I created [Product Name]."
122
-
123
- **VSL-specific offer rules:**
124
- - Never call it a "course" — use Protocol, System, Blueprint, Accelerator
125
- - Show each component visually (mockup, icon, or slide)
126
- - Read the fascinations with enthusiasm — pacing matters
127
- - Pause after stating the price — let it sink in
128
- - Show the guarantee prominently (text on screen + verbal)
129
-
130
- **Reference:** `.aioson/skills/marketing/references/offer-structure.md`
131
-
132
- ### Act 5 — The Close (18:00 to 22:00)
133
-
134
- **Goal:** Push the fence-sitters over the edge.
135
-
136
- **The Two Paths technique (optimized for video):**
137
- > "Right now, you're at a fork in the road.
138
- > [Pause — 2 seconds]
139
- > Path one: you close this video. You go back to [specific pain]. Tomorrow feels the same as today. Next month, same. Next year...
140
- > [Pause — 3 seconds]
141
- > Path two: you click the button below. You start [Product Name] today. In [timeframe], you [specific visualizable result].
142
- > [Pause — 2 seconds]
143
- > Which path makes more sense?"
144
-
145
- **Recovery techniques (the "Kenyan Village" strategy):**
146
- - **Pause thumbnail:** When the viewer pauses, a thumbnail appears with a hook to resume
147
- - **Exit-intent popup:** On the page, when cursor moves to close — offer a discount or bonus
148
- - **Post-VSL autoplay:** After the main VSL, play a shorter 3-minute "for those still deciding" video
149
- - **SMS/email retargeting:** Capture email early (before VSL starts) and send follow-up sequence
150
-
151
- ---
152
-
153
- ## 4. VSL script format
154
-
155
- When writing a VSL script, use this format:
156
-
157
- ```markdown
158
- # VSL Script: [Product Name]
159
-
160
- ## Metadata
161
- - Duration target: [X] minutes
162
- - Format: Horizontal / Vertical
163
- - Traffic temperature: Cold / Warm / Hot
164
- - One Belief: "[New Opportunity] is the key to [Benefit] through [Mechanism]"
165
- - Awareness level: [1-5]
166
-
167
- ---
168
-
169
- ## ACT 1 — HOOK (0:00–0:30)
170
-
171
- ### VISUAL:
172
- [What appears on screen]
173
-
174
- ### AUDIO:
175
- [What is said — scripted word-for-word]
176
-
177
- ### NOTES:
178
- [Production notes: B-roll, text overlay, music cue]
179
-
180
- ---
181
-
182
- ## ACT 2 — BACKGROUND (0:30–3:00)
183
-
184
- ### VISUAL:
185
- [Screen description]
186
-
187
- ### AUDIO:
188
- [Script]
189
-
190
- ### NOTES:
191
- [Production notes]
192
-
193
- ---
194
-
195
- ## ACT 3 — MECHANISM (3:00–12:00)
196
-
197
- ### 3A — Why nothing else worked
198
-
199
- #### VISUAL:
200
- [Screen]
201
-
202
- #### AUDIO:
203
- [Script]
204
-
205
- #### PATTERN INTERRUPT at [timestamp]:
206
- [Visual change / diagram / B-roll description]
207
-
208
- ### 3B — How [Mechanism] works
209
-
210
- #### VISUAL:
211
- [Screen]
212
-
213
- #### AUDIO:
214
- [Script]
215
-
216
- #### PROOF POINT:
217
- [Study / case study / demonstration]
218
-
219
- ---
220
-
221
- ## ACT 4 — OFFER (12:00–18:00)
222
-
223
- ### TRANSITION:
224
-
225
- #### AUDIO:
226
- [Bridge sentence]
227
-
228
- ### COMPONENT STACK:
229
-
230
- #### VISUAL:
231
- [Mockup / slide of each component]
232
-
233
- #### AUDIO:
234
- [Component name, benefit, value, fascination]
235
-
236
- ### PRICE REVEAL:
237
-
238
- #### VISUAL:
239
- [Anchoring → crossed out prices → final price]
240
-
241
- #### AUDIO:
242
- [Not paying X. Not even Y. Today: Z. Reason why.]
243
-
244
- ### GUARANTEE:
245
-
246
- #### VISUAL:
247
- [Guarantee badge / text on screen]
248
-
249
- #### AUDIO:
250
- [Full guarantee statement]
251
-
252
- ---
253
-
254
- ## ACT 5 — CLOSE (18:00–22:00)
255
-
256
- ### TWO PATHS:
257
-
258
- #### AUDIO:
259
- [Path 1 → Path 2 → Which makes more sense?]
260
-
261
- ### FINAL CTA:
262
-
263
- #### VISUAL:
264
- [Button, URL, QR code on screen]
265
-
266
- #### AUDIO:
267
- [Click the button below / link in description]
268
-
269
- ### RECOVERY ELEMENTS:
270
- - Pause thumbnail text: [text]
271
- - Exit-intent offer: [discount/bonus]
272
- - Post-VSL summary video: [Y/N]
273
- ```
274
-
275
- ---
276
-
277
- ## 5. Testing methodology
278
-
279
- ### Phase 1 — Validate the thesis (before production)
280
- Create an "ugly" VSL:
281
- - White background, black text on slides
282
- - Presenter reads from teleprompter (or text-to-speech for testing)
283
- - No B-roll, no editing, no music
284
- - Duration: 10-15 minutes (condensed version)
285
-
286
- Run R$500-R$1,000 in cold traffic. Measure:
287
- - **Hook retention:** % watching past 30 seconds (target: >50%)
288
- - **Mechanism retention:** % watching past Act 3 (target: >25%)
289
- - **Offer conversion:** % who reach offer AND click CTA (target: >2%)
290
-
291
- If the ugly version converts → invest in production.
292
- If it doesn't → rewrite the script before spending on video production.
293
-
294
- ### Phase 2 — Optimize the hook
295
- Create 3-5 hook variations (first 30 seconds only).
296
- Run equal traffic to each. The winning hook gets 2-3x more budget.
297
-
298
- **Hook metrics:**
299
- - 3-second retention rate
300
- - 15-second retention rate
301
- - 30-second retention rate
302
-
303
- ### Phase 3 — Scale with production
304
- Once the script is validated:
305
- - Add B-roll and visual elements
306
- - Professional audio recording
307
- - Add pattern interrupts and visual variety
308
- - Consider vertical format for mobile-first traffic
309
-
310
- ---
311
-
312
- ## 6. VSL page structure
313
-
314
- The page that hosts the VSL should be minimal:
315
-
316
- ```html
317
- <!-- Above the fold — ONLY the video -->
318
- <section class="vsl-hero">
319
- <div class="video-container">
320
- <!-- Video player (VTurb, Wistia, or custom) -->
321
- <!-- CTA button appears ONLY after offer section plays -->
322
- </div>
323
- </section>
324
-
325
- <!-- Below the fold — revealed after video plays past offer -->
326
- <section class="vsl-offer">
327
- <!-- Component stack (text version of what's in the video) -->
328
- <!-- Guarantee -->
329
- <!-- CTA button -->
330
- <!-- FAQ -->
331
- <!-- Testimonials -->
332
- </section>
333
- ```
334
-
335
- **Key rules:**
336
- - **No navigation menu** — remove all escape routes
337
- - **CTA button hidden until the offer section plays** — don't let them see the price before the mechanism
338
- - **Video auto-plays on mute with captions** — most mobile traffic has sound off
339
- - **Exit-intent popup** — "Wait! Before you go..." with a discount or bonus
340
- - **Timer optional** — only if the offer has a real deadline
341
-
342
- ---
343
-
344
- ## 7. Production specifications
345
-
346
- ### Audio
347
- - Clear, professional recording (condenser mic, treated room)
348
- - Pacing: 150-170 words per minute (conversational speed)
349
- - Consider 1.1x-1.3x playback speed for higher engagement
350
- - Music: subtle background only, never competing with voice
351
-
352
- ### Video
353
- - Resolution: minimum 1080p
354
- - B-roll: 2-3 second clips every 60-90 seconds in Act 3
355
- - Text overlays: key claims and proof points on screen while spoken
356
- - Captions: always (auto-generated + manually corrected)
357
-
358
- ### Hosting
359
- - VTurb (Brazilian market — best heatmap and button reveal features)
360
- - Wistia (international — CTA tools built in)
361
- - Custom player (maximum control — no platform branding)
362
-
363
- ---
364
-
365
- ## 8. Conditional reference loading
366
-
367
- When writing a VSL script, the @copywriter agent should load:
368
-
369
- | Phase | Load |
370
- |---|---|
371
- | Research | `pms-research.md` + `market-intelligence.md` |
372
- | Script — hook | `one-belief.md` + `patterns.md` (headline formulas adapt to hooks) |
373
- | Script — mechanism | `five-acts.md` (Acts 3 focus) |
374
- | Script — offer | `offer-structure.md` + `fascinations.md` |
375
- | Script — validation | `anti-patterns.md` |
376
-
377
- ---
378
-
379
- ## 9. Output contract
380
-
381
- VSL script saves to: `.aioson/context/vsl-script-{slug}.md`
382
- VSL page spec saves to: `.aioson/context/vsl-page-{slug}.md` (if page design is needed)
383
-
384
- If invoked from @ux-ui: return the page spec for visual implementation.
385
- If invoked from a squad: save to the squad's output directory.
1
+ ---
2
+ name: vsl-craft
3
+ description: Video Sales Letter production skill — script structure, hook formulas, retention techniques, testing methodology, and production specs. Loaded by @copywriter when Mode 5 (VSL) is active.
4
+ ---
5
+
6
+ # VSL Craft — Video Sales Letter Production
7
+
8
+ ## When to load this skill
9
+
10
+ - User requests a VSL script
11
+ - User requests a video sales page (page with embedded sales video)
12
+ - User requests an advertorial video
13
+ - @copywriter Mode 5 is activated
14
+ - Squad executor with VSL deliverable
15
+
16
+ ---
17
+
18
+ ## 1. What is a VSL?
19
+
20
+ A Video Sales Letter is a scripted video (typically 10-45 minutes) designed to convert cold traffic into buyers. It replaces the live salesperson with a pre-recorded, optimized sales presentation.
21
+
22
+ **Key differences from a written sales page:**
23
+ - The viewer can't scan — they must watch sequentially
24
+ - Retention is everything — if they leave at minute 3, the offer at minute 20 never gets seen
25
+ - Audio + visual = two channels to reinforce the message
26
+ - Pacing, pauses, and emotional tone are scripted, not left to chance
27
+
28
+ ---
29
+
30
+ ## 2. VSL formats
31
+
32
+ ### 2.1 Traditional VSL (horizontal)
33
+ - 16:9 format, presenter or slides
34
+ - Duration: 15-45 minutes
35
+ - Best for: sophisticated offers, higher ticket (R$297+), cold traffic from YouTube/Facebook
36
+ - Production: can be "ugly" (slides only) or "cinematic" (B-roll, editing)
37
+
38
+ ### 2.2 Vertical VSL (mobile-native)
39
+ - 9:16 format, looks like organic content
40
+ - Duration: 3-15 minutes
41
+ - Best for: TikTok/Reels traffic, lower ticket, younger audiences
42
+ - Production: phone-filmed, fast cuts, captions mandatory
43
+
44
+ ### 2.3 Hybrid (advertorial + VSL)
45
+ - Written advertorial page with embedded video at the mechanism section
46
+ - The text does Act 1-2, the video does Act 3-5
47
+ - Best for: sophisticated audiences who want to read before watching
48
+
49
+ ---
50
+
51
+ ## 3. The VSL script structure (5 Acts adapted for video)
52
+
53
+ ### Act 1 — The Hook (0:00 to 0:30)
54
+
55
+ **Goal:** Stop the scroll and keep them watching for the next 30 seconds.
56
+
57
+ **The 3-second rule:** If the first 3 seconds aren't arresting, the viewer leaves.
58
+
59
+ **Hook formulas for VSL:**
60
+
61
+ **Formula 1: The Discovery Hook**
62
+ > "What you're about to see in the next [X] minutes could change the way you [desired outcome] forever. I'm going to show you [specific discovery] that [specific proof]."
63
+
64
+ **Formula 2: The Proof-First Hook**
65
+ > "[Name], [age], from [city], lost [specific result] in [specific time]. And she did it without [painful thing]. Today I'm going to show you exactly how — and why it works even if [objection]."
66
+
67
+ **Formula 3: The Paradox Hook**
68
+ > "Why do [specific group] [achieve result] while [audience group] [fail despite effort]? The answer has nothing to do with [obvious thing] — and everything to do with [curiosity element]."
69
+
70
+ **Formula 4: The Warning Hook**
71
+ > "If you're [doing common thing], stop immediately. A [authority/study] just revealed that [counterintuitive finding] — and it's costing you [consequence]. Stay with me for [time] and I'll show you [solution]."
72
+
73
+ **Formula 5: The Story Hook**
74
+ > "Last [day], [specific person] sent me this message: [screenshot/quote]. [X time] ago, they were [painful situation]. Today they [desired outcome]. This is their story — and it starts with [curiosity element]."
75
+
76
+ **Anti-pattern hooks:**
77
+ - "Hey everyone, welcome to my channel..." → Zero curiosity
78
+ - "In this video I'm going to talk about..." → Passive, no hook
79
+ - "So, I've been getting a lot of questions about..." → About you, not them
80
+
81
+ ### Act 2 — The Background (0:30 to 3:00)
82
+
83
+ **Goal:** Build authority and emotional connection quickly.
84
+
85
+ **For expert-led VSL:**
86
+ > "[Credentials in one sentence]. But what matters more than my degrees is this: I've helped [specific number] of people [achieve result], and what I discovered along the way is the reason you're watching this video."
87
+
88
+ **For avatar transformation:**
89
+ > "I know what it's like to [specific pain]. [Time] ago, I was [painful situation — specific details]. I tried [what they've tried]. Nothing worked. Until [discovery moment]."
90
+
91
+ **Key rule:** Act 2 must be SHORT in a VSL. On a written page, you can have a long background section. On video, 1-2 minutes max. Get to the mechanism fast.
92
+
93
+ ### Act 3 — The Mechanism (3:00 to 12:00)
94
+
95
+ **Goal:** Create the "Aha!" moment. This is where the One Belief is built.
96
+
97
+ **Structure:**
98
+
99
+ **Part A — Why nothing else worked (2-4 minutes)**
100
+ 1. Name what they've tried (validate their experience)
101
+ 2. Reveal the hidden reason it failed (the enemy — not them)
102
+ 3. Use a visual metaphor or diagram to make the concept tangible
103
+
104
+ **Part B — How [Mechanism Name] works (3-5 minutes)**
105
+ 1. Introduce the mechanism by name
106
+ 2. Explain it at surface level (simple enough for a 12-year-old)
107
+ 3. Show ONE proof point (study, case study, demonstration)
108
+ 4. Use B-roll or diagrams to illustrate — never just talk over static slides for more than 30 seconds
109
+
110
+ **Retention techniques for Act 3:**
111
+ - **Pattern interrupt every 60-90 seconds:** Change the visual, show a diagram, cut to B-roll, display a quote
112
+ - **Open loops:** "In a moment I'll show you the third step — but first you need to understand why..."
113
+ - **Micro-fascinations:** Drop curiosity bullets throughout: "The ingredient I'm about to mention is in 90% of Brazilian homes but nobody knows it does THIS..."
114
+ - **Density escalation:** Each minute should be MORE interesting than the last, not less
115
+
116
+ ### Act 4 — The Offer (12:00 to 18:00)
117
+
118
+ **Goal:** Transition from education to sale without breaking trust.
119
+
120
+ **The transition bridge:**
121
+ > "So now you understand WHY [mechanism] works and HOW it produces [result]. The question is: how do YOU implement it? That's exactly why I created [Product Name]."
122
+
123
+ **VSL-specific offer rules:**
124
+ - Never call it a "course" — use Protocol, System, Blueprint, Accelerator
125
+ - Show each component visually (mockup, icon, or slide)
126
+ - Read the fascinations with enthusiasm — pacing matters
127
+ - Pause after stating the price — let it sink in
128
+ - Show the guarantee prominently (text on screen + verbal)
129
+
130
+ **Reference:** `.aioson/skills/marketing/references/offer-structure.md`
131
+
132
+ ### Act 5 — The Close (18:00 to 22:00)
133
+
134
+ **Goal:** Push the fence-sitters over the edge.
135
+
136
+ **The Two Paths technique (optimized for video):**
137
+ > "Right now, you're at a fork in the road.
138
+ > [Pause — 2 seconds]
139
+ > Path one: you close this video. You go back to [specific pain]. Tomorrow feels the same as today. Next month, same. Next year...
140
+ > [Pause — 3 seconds]
141
+ > Path two: you click the button below. You start [Product Name] today. In [timeframe], you [specific visualizable result].
142
+ > [Pause — 2 seconds]
143
+ > Which path makes more sense?"
144
+
145
+ **Recovery techniques (the "Kenyan Village" strategy):**
146
+ - **Pause thumbnail:** When the viewer pauses, a thumbnail appears with a hook to resume
147
+ - **Exit-intent popup:** On the page, when cursor moves to close — offer a discount or bonus
148
+ - **Post-VSL autoplay:** After the main VSL, play a shorter 3-minute "for those still deciding" video
149
+ - **SMS/email retargeting:** Capture email early (before VSL starts) and send follow-up sequence
150
+
151
+ ---
152
+
153
+ ## 4. VSL script format
154
+
155
+ When writing a VSL script, use this format:
156
+
157
+ ```markdown
158
+ # VSL Script: [Product Name]
159
+
160
+ ## Metadata
161
+ - Duration target: [X] minutes
162
+ - Format: Horizontal / Vertical
163
+ - Traffic temperature: Cold / Warm / Hot
164
+ - One Belief: "[New Opportunity] is the key to [Benefit] through [Mechanism]"
165
+ - Awareness level: [1-5]
166
+
167
+ ---
168
+
169
+ ## ACT 1 — HOOK (0:00–0:30)
170
+
171
+ ### VISUAL:
172
+ [What appears on screen]
173
+
174
+ ### AUDIO:
175
+ [What is said — scripted word-for-word]
176
+
177
+ ### NOTES:
178
+ [Production notes: B-roll, text overlay, music cue]
179
+
180
+ ---
181
+
182
+ ## ACT 2 — BACKGROUND (0:30–3:00)
183
+
184
+ ### VISUAL:
185
+ [Screen description]
186
+
187
+ ### AUDIO:
188
+ [Script]
189
+
190
+ ### NOTES:
191
+ [Production notes]
192
+
193
+ ---
194
+
195
+ ## ACT 3 — MECHANISM (3:00–12:00)
196
+
197
+ ### 3A — Why nothing else worked
198
+
199
+ #### VISUAL:
200
+ [Screen]
201
+
202
+ #### AUDIO:
203
+ [Script]
204
+
205
+ #### PATTERN INTERRUPT at [timestamp]:
206
+ [Visual change / diagram / B-roll description]
207
+
208
+ ### 3B — How [Mechanism] works
209
+
210
+ #### VISUAL:
211
+ [Screen]
212
+
213
+ #### AUDIO:
214
+ [Script]
215
+
216
+ #### PROOF POINT:
217
+ [Study / case study / demonstration]
218
+
219
+ ---
220
+
221
+ ## ACT 4 — OFFER (12:00–18:00)
222
+
223
+ ### TRANSITION:
224
+
225
+ #### AUDIO:
226
+ [Bridge sentence]
227
+
228
+ ### COMPONENT STACK:
229
+
230
+ #### VISUAL:
231
+ [Mockup / slide of each component]
232
+
233
+ #### AUDIO:
234
+ [Component name, benefit, value, fascination]
235
+
236
+ ### PRICE REVEAL:
237
+
238
+ #### VISUAL:
239
+ [Anchoring → crossed out prices → final price]
240
+
241
+ #### AUDIO:
242
+ [Not paying X. Not even Y. Today: Z. Reason why.]
243
+
244
+ ### GUARANTEE:
245
+
246
+ #### VISUAL:
247
+ [Guarantee badge / text on screen]
248
+
249
+ #### AUDIO:
250
+ [Full guarantee statement]
251
+
252
+ ---
253
+
254
+ ## ACT 5 — CLOSE (18:00–22:00)
255
+
256
+ ### TWO PATHS:
257
+
258
+ #### AUDIO:
259
+ [Path 1 → Path 2 → Which makes more sense?]
260
+
261
+ ### FINAL CTA:
262
+
263
+ #### VISUAL:
264
+ [Button, URL, QR code on screen]
265
+
266
+ #### AUDIO:
267
+ [Click the button below / link in description]
268
+
269
+ ### RECOVERY ELEMENTS:
270
+ - Pause thumbnail text: [text]
271
+ - Exit-intent offer: [discount/bonus]
272
+ - Post-VSL summary video: [Y/N]
273
+ ```
274
+
275
+ ---
276
+
277
+ ## 5. Testing methodology
278
+
279
+ ### Phase 1 — Validate the thesis (before production)
280
+ Create an "ugly" VSL:
281
+ - White background, black text on slides
282
+ - Presenter reads from teleprompter (or text-to-speech for testing)
283
+ - No B-roll, no editing, no music
284
+ - Duration: 10-15 minutes (condensed version)
285
+
286
+ Run R$500-R$1,000 in cold traffic. Measure:
287
+ - **Hook retention:** % watching past 30 seconds (target: >50%)
288
+ - **Mechanism retention:** % watching past Act 3 (target: >25%)
289
+ - **Offer conversion:** % who reach offer AND click CTA (target: >2%)
290
+
291
+ If the ugly version converts → invest in production.
292
+ If it doesn't → rewrite the script before spending on video production.
293
+
294
+ ### Phase 2 — Optimize the hook
295
+ Create 3-5 hook variations (first 30 seconds only).
296
+ Run equal traffic to each. The winning hook gets 2-3x more budget.
297
+
298
+ **Hook metrics:**
299
+ - 3-second retention rate
300
+ - 15-second retention rate
301
+ - 30-second retention rate
302
+
303
+ ### Phase 3 — Scale with production
304
+ Once the script is validated:
305
+ - Add B-roll and visual elements
306
+ - Professional audio recording
307
+ - Add pattern interrupts and visual variety
308
+ - Consider vertical format for mobile-first traffic
309
+
310
+ ---
311
+
312
+ ## 6. VSL page structure
313
+
314
+ The page that hosts the VSL should be minimal:
315
+
316
+ ```html
317
+ <!-- Above the fold — ONLY the video -->
318
+ <section class="vsl-hero">
319
+ <div class="video-container">
320
+ <!-- Video player (VTurb, Wistia, or custom) -->
321
+ <!-- CTA button appears ONLY after offer section plays -->
322
+ </div>
323
+ </section>
324
+
325
+ <!-- Below the fold — revealed after video plays past offer -->
326
+ <section class="vsl-offer">
327
+ <!-- Component stack (text version of what's in the video) -->
328
+ <!-- Guarantee -->
329
+ <!-- CTA button -->
330
+ <!-- FAQ -->
331
+ <!-- Testimonials -->
332
+ </section>
333
+ ```
334
+
335
+ **Key rules:**
336
+ - **No navigation menu** — remove all escape routes
337
+ - **CTA button hidden until the offer section plays** — don't let them see the price before the mechanism
338
+ - **Video auto-plays on mute with captions** — most mobile traffic has sound off
339
+ - **Exit-intent popup** — "Wait! Before you go..." with a discount or bonus
340
+ - **Timer optional** — only if the offer has a real deadline
341
+
342
+ ---
343
+
344
+ ## 7. Production specifications
345
+
346
+ ### Audio
347
+ - Clear, professional recording (condenser mic, treated room)
348
+ - Pacing: 150-170 words per minute (conversational speed)
349
+ - Consider 1.1x-1.3x playback speed for higher engagement
350
+ - Music: subtle background only, never competing with voice
351
+
352
+ ### Video
353
+ - Resolution: minimum 1080p
354
+ - B-roll: 2-3 second clips every 60-90 seconds in Act 3
355
+ - Text overlays: key claims and proof points on screen while spoken
356
+ - Captions: always (auto-generated + manually corrected)
357
+
358
+ ### Hosting
359
+ - VTurb (Brazilian market — best heatmap and button reveal features)
360
+ - Wistia (international — CTA tools built in)
361
+ - Custom player (maximum control — no platform branding)
362
+
363
+ ---
364
+
365
+ ## 8. Conditional reference loading
366
+
367
+ When writing a VSL script, the @copywriter agent should load:
368
+
369
+ | Phase | Load |
370
+ |---|---|
371
+ | Research | `pms-research.md` + `market-intelligence.md` |
372
+ | Script — hook | `one-belief.md` + `patterns.md` (headline formulas adapt to hooks) |
373
+ | Script — mechanism | `five-acts.md` (Acts 3 focus) |
374
+ | Script — offer | `offer-structure.md` + `fascinations.md` |
375
+ | Script — validation | `anti-patterns.md` |
376
+
377
+ ---
378
+
379
+ ## 9. Output contract
380
+
381
+ VSL script saves to: `.aioson/context/vsl-script-{slug}.md`
382
+ VSL page spec saves to: `.aioson/context/vsl-page-{slug}.md` (if page design is needed)
383
+
384
+ If invoked from @ux-ui: return the page spec for visual implementation.
385
+ If invoked from a squad: save to the squad's output directory.