@jaimevalasek/aioson 1.7.0 → 1.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (383) hide show
  1. package/CHANGELOG.md +60 -0
  2. package/README.md +153 -10
  3. package/docs/en/cli-reference.md +56 -1
  4. package/docs/en/i18n.md +18 -18
  5. package/docs/en/schemas/index.json +10 -0
  6. package/docs/en/schemas/parallel-assign.schema.json +9 -0
  7. package/docs/en/schemas/parallel-doctor.schema.json +36 -0
  8. package/docs/en/schemas/parallel-guard.schema.json +63 -0
  9. package/docs/en/schemas/parallel-merge.schema.json +84 -0
  10. package/docs/en/schemas/parallel-status.schema.json +91 -1
  11. package/docs/integrations/apps-publish-marketplace.md +94 -0
  12. package/docs/pt/README.md +9 -0
  13. package/docs/pt/agentes.md +324 -3
  14. package/docs/pt/clientes-ai.md +7 -3
  15. package/docs/pt/comandos-cli.md +160 -13
  16. package/docs/pt/compress-agents.md +304 -0
  17. package/docs/pt/design-docs-governance.md +59 -0
  18. package/docs/pt/feature-archive.md +191 -0
  19. package/docs/pt/genome-3.0-spec.md +115 -4
  20. package/docs/pt/genome-distribution.md +232 -0
  21. package/docs/pt/inicio-rapido.md +1 -0
  22. package/docs/pt/motor-hardening.md +492 -0
  23. package/docs/pt/runner-system.md +113 -0
  24. package/package.json +2 -1
  25. package/src/agent-manifests.js +66 -0
  26. package/src/agents.js +27 -7
  27. package/src/autonomy-policy.js +139 -0
  28. package/src/brain-query.js +161 -0
  29. package/src/cli.js +1377 -1099
  30. package/src/commands/agents.js +102 -7
  31. package/src/commands/artifact-validate.js +33 -4
  32. package/src/commands/auth.js +272 -0
  33. package/src/commands/brain-query.js +44 -0
  34. package/src/commands/briefing.js +344 -0
  35. package/src/commands/commit-prepare.js +547 -0
  36. package/src/commands/compress-agents.js +416 -0
  37. package/src/commands/context-health.js +4 -2
  38. package/src/commands/context-trim.js +17 -11
  39. package/src/commands/design-hybrid-options.js +3 -3
  40. package/src/commands/devlog-process.js +6 -4
  41. package/src/commands/dossier.js +423 -0
  42. package/src/commands/feature-archive.js +513 -0
  43. package/src/commands/feature-close.js +123 -18
  44. package/src/commands/gate-approve.js +198 -0
  45. package/src/commands/gate-check.js +24 -5
  46. package/src/commands/genome-doctor.js +166 -9
  47. package/src/commands/git-guard.js +170 -0
  48. package/src/commands/harness.js +121 -0
  49. package/src/commands/implementation-plan.js +47 -20
  50. package/src/commands/init.js +6 -2
  51. package/src/commands/install.js +6 -2
  52. package/src/commands/live.js +497 -56
  53. package/src/commands/locale-apply.js +9 -6
  54. package/src/commands/locale-diff.js +11 -112
  55. package/src/commands/mcp-doctor.js +2 -1
  56. package/src/commands/mcp-init.js +4 -10
  57. package/src/commands/memory.js +234 -0
  58. package/src/commands/parallel-assign.js +107 -27
  59. package/src/commands/parallel-doctor.js +416 -3
  60. package/src/commands/parallel-guard.js +241 -0
  61. package/src/commands/parallel-init.js +66 -4
  62. package/src/commands/parallel-merge.js +299 -0
  63. package/src/commands/parallel-status.js +147 -3
  64. package/src/commands/preflight.js +63 -4
  65. package/src/commands/qa-init.js +10 -5
  66. package/src/commands/revision.js +235 -0
  67. package/src/commands/scaffold-complete.js +188 -0
  68. package/src/commands/security-audit.js +275 -0
  69. package/src/commands/security-scan.js +376 -0
  70. package/src/commands/self-implement-loop.js +46 -2
  71. package/src/commands/setup-context.js +11 -10
  72. package/src/commands/squad-agent-create.js +51 -9
  73. package/src/commands/squad-investigate.js +53 -0
  74. package/src/commands/squad-plan.js +33 -1
  75. package/src/commands/squad-scaffold.js +4 -3
  76. package/src/commands/squad-score.js +71 -14
  77. package/src/commands/squad-status.js +22 -1
  78. package/src/commands/squad-validate.js +93 -2
  79. package/src/commands/store-genome.js +304 -0
  80. package/src/commands/store-skill.js +247 -0
  81. package/src/commands/store-squad.js +431 -0
  82. package/src/commands/store-system.js +392 -0
  83. package/src/commands/tool-capabilities.js +63 -0
  84. package/src/commands/update.js +3 -3
  85. package/src/commands/verify-gate.js +40 -0
  86. package/src/commands/workflow-execute.js +644 -155
  87. package/src/commands/workflow-harden.js +231 -0
  88. package/src/commands/workflow-heal.js +136 -0
  89. package/src/commands/workflow-next.js +460 -22
  90. package/src/commands/workflow-status.js +328 -138
  91. package/src/commands/workspace.js +144 -0
  92. package/src/constants.js +55 -75
  93. package/src/context-memory.js +133 -4
  94. package/src/context-writer.js +2 -1
  95. package/src/context.js +32 -2
  96. package/src/doctor.js +46 -6
  97. package/src/dossier/codemap-store.js +267 -0
  98. package/src/dossier/dossier-bootstrap.js +222 -0
  99. package/src/dossier/dossier-compact.js +159 -0
  100. package/src/dossier/lock.js +128 -0
  101. package/src/dossier/revision-store.js +313 -0
  102. package/src/dossier/schema.js +155 -0
  103. package/src/dossier/store.js +400 -0
  104. package/src/execution-gateway.js +3 -0
  105. package/src/friction-scanner.js +202 -0
  106. package/src/genome-schema.js +24 -1
  107. package/src/genomes.js +33 -0
  108. package/src/handoff-contract.js +363 -0
  109. package/src/handoff-validator.js +45 -0
  110. package/src/harness/circuit-breaker.js +135 -0
  111. package/src/i18n/messages/en.js +317 -22
  112. package/src/i18n/messages/es.js +259 -18
  113. package/src/i18n/messages/fr.js +260 -18
  114. package/src/i18n/messages/pt-BR.js +313 -22
  115. package/src/install-profile.js +0 -16
  116. package/src/installer.js +70 -6
  117. package/src/lib/git-commit-guard.js +691 -0
  118. package/src/lib/security/artifact-reader.js +167 -0
  119. package/src/lib/security/exit-codes.js +51 -0
  120. package/src/lib/security/findings-writer.js +176 -0
  121. package/src/lib/security/runtime-events.js +77 -0
  122. package/src/lib/security/secrets-regex.js +115 -0
  123. package/src/lib/store/security-scan.js +173 -0
  124. package/src/lib/terminal-checkbox.js +130 -0
  125. package/src/lib/tmux-launcher.js +163 -0
  126. package/src/lib/tool-capabilities.js +102 -0
  127. package/src/locales.js +12 -8
  128. package/src/parallel-workspace.js +756 -0
  129. package/src/parser.js +8 -1
  130. package/src/path-guard.js +47 -0
  131. package/src/preflight-engine.js +237 -26
  132. package/src/self-healing.js +142 -0
  133. package/src/session-handoff.js +111 -1
  134. package/src/squad/squad-scaffold.js +183 -19
  135. package/src/test-briefing.js +226 -0
  136. package/src/updater.js +1 -1
  137. package/src/utils.js +3 -0
  138. package/src/workflow-gates.js +185 -0
  139. package/template/.aioson/agents/analyst.md +76 -130
  140. package/template/.aioson/agents/architect.md +53 -86
  141. package/template/.aioson/agents/committer.md +161 -0
  142. package/template/.aioson/agents/copywriter.md +463 -0
  143. package/template/.aioson/agents/cypher.md +252 -0
  144. package/template/.aioson/agents/dev.md +112 -600
  145. package/template/.aioson/agents/deyvin.md +33 -235
  146. package/template/.aioson/agents/discover.md +235 -0
  147. package/template/.aioson/agents/discovery-design-doc.md +17 -252
  148. package/template/.aioson/agents/genome.md +76 -26
  149. package/template/.aioson/agents/manifests/analyst.manifest.json +26 -0
  150. package/template/.aioson/agents/manifests/architect.manifest.json +23 -0
  151. package/template/.aioson/agents/manifests/committer.manifest.json +23 -0
  152. package/template/.aioson/agents/manifests/dev.manifest.json +37 -0
  153. package/template/.aioson/agents/manifests/orchestrator.manifest.json +30 -0
  154. package/template/.aioson/agents/manifests/pentester.manifest.json +39 -0
  155. package/template/.aioson/agents/manifests/pm.manifest.json +26 -0
  156. package/template/.aioson/agents/manifests/product.manifest.json +23 -0
  157. package/template/.aioson/agents/manifests/qa.manifest.json +25 -0
  158. package/template/.aioson/agents/manifests/setup.manifest.json +20 -0
  159. package/template/.aioson/agents/manifests/ux-ui.manifest.json +24 -0
  160. package/template/.aioson/agents/neo.md +10 -8
  161. package/template/.aioson/agents/orache.md +2 -6
  162. package/template/.aioson/agents/orchestrator.md +81 -182
  163. package/template/.aioson/agents/pentester.md +235 -0
  164. package/template/.aioson/agents/pm.md +40 -104
  165. package/template/.aioson/agents/product.md +99 -344
  166. package/template/.aioson/agents/profiler-enricher.md +57 -6
  167. package/template/.aioson/agents/profiler-forge.md +17 -7
  168. package/template/.aioson/agents/profiler-researcher.md +29 -6
  169. package/template/.aioson/agents/qa.md +165 -410
  170. package/template/.aioson/agents/setup.md +52 -262
  171. package/template/.aioson/agents/sheldon.md +122 -754
  172. package/template/.aioson/agents/site-forge.md +111 -1583
  173. package/template/.aioson/agents/squad.md +139 -1820
  174. package/template/.aioson/agents/tester.md +10 -0
  175. package/template/.aioson/agents/ux-ui.md +103 -645
  176. package/template/.aioson/agents/validator.md +69 -0
  177. package/template/.aioson/brains/scripts/query.js +5 -1
  178. package/template/.aioson/config/autonomy-protocol.json +43 -0
  179. package/template/.aioson/config.md +43 -15
  180. package/template/.aioson/constitution.md +36 -33
  181. package/template/.aioson/context/design-doc.md +136 -0
  182. package/template/.aioson/context/project-map.md +57 -0
  183. package/template/.aioson/design-docs/code-reuse.md +48 -0
  184. package/template/.aioson/design-docs/componentization.md +47 -0
  185. package/template/.aioson/design-docs/file-size.md +52 -0
  186. package/template/.aioson/design-docs/folder-structure.md +51 -0
  187. package/template/.aioson/design-docs/naming.md +54 -0
  188. package/template/.aioson/docs/LAYERS.md +12 -2
  189. package/template/.aioson/docs/dev/execution-discipline.md +106 -0
  190. package/template/.aioson/docs/dev/stack-conventions.md +83 -0
  191. package/template/.aioson/docs/deyvin/continuity-recovery.md +57 -0
  192. package/template/.aioson/docs/deyvin/debugging-escalation.md +30 -0
  193. package/template/.aioson/docs/deyvin/pair-execution.md +44 -0
  194. package/template/.aioson/docs/deyvin/runtime-handoffs.md +36 -0
  195. package/template/.aioson/docs/product/conversation-playbook.md +116 -0
  196. package/template/.aioson/docs/product/prd-contract.md +107 -0
  197. package/template/.aioson/docs/product/quality-lens.md +57 -0
  198. package/template/.aioson/docs/product/research-loop.md +65 -0
  199. package/template/.aioson/docs/sheldon/enrichment-paths.md +134 -0
  200. package/template/.aioson/docs/sheldon/quality-lens.md +57 -0
  201. package/template/.aioson/docs/sheldon/research-loop.md +56 -0
  202. package/template/.aioson/docs/sheldon/web-intelligence.md +75 -0
  203. package/template/.aioson/docs/site-forge-build.md +195 -0
  204. package/template/.aioson/docs/site-forge-extraction.md +135 -0
  205. package/template/.aioson/docs/site-forge-qa.md +155 -0
  206. package/template/.aioson/docs/site-forge-recon.md +434 -0
  207. package/template/.aioson/docs/site-forge-transform.md +249 -0
  208. package/template/.aioson/docs/squad/content-output.md +91 -0
  209. package/template/.aioson/docs/squad/creation-flow.md +135 -0
  210. package/template/.aioson/docs/squad/domain-classification.md +117 -0
  211. package/template/.aioson/docs/squad/genome-bindings.md +47 -0
  212. package/template/.aioson/docs/squad/package-contract.md +234 -0
  213. package/template/.aioson/docs/squad/quality-lens.md +56 -0
  214. package/template/.aioson/docs/squad/research-loop.md +59 -0
  215. package/template/.aioson/docs/squad/session-operations.md +117 -0
  216. package/template/.aioson/docs/squad/workflow-quality.md +165 -0
  217. package/template/.aioson/docs/ux-ui/accessibility-audit.md +55 -0
  218. package/template/.aioson/docs/ux-ui/audit-mode.md +86 -0
  219. package/template/.aioson/docs/ux-ui/component-map.md +35 -0
  220. package/template/.aioson/docs/ux-ui/design-execution.md +111 -0
  221. package/template/.aioson/docs/ux-ui/design-gate.md +27 -0
  222. package/template/.aioson/docs/ux-ui/research-mode.md +39 -0
  223. package/template/.aioson/docs/ux-ui/site-delivery.md +156 -0
  224. package/template/.aioson/docs/ux-ui/token-contract.md +57 -0
  225. package/template/.aioson/genomes/copywriting.md +204 -0
  226. package/template/.aioson/genomes/copywriting.meta.json +48 -0
  227. package/template/.aioson/git-guard.json +11 -0
  228. package/template/.aioson/mcp/servers.md +0 -1
  229. package/template/.aioson/rules/agent-language-policy.md +93 -0
  230. package/template/.aioson/rules/aioson-context-boundary.md +63 -0
  231. package/template/.aioson/rules/canonical-path-contract.md +47 -0
  232. package/template/.aioson/rules/data-format-convention.md +24 -86
  233. package/template/.aioson/rules/disk-first-artifacts.md +44 -0
  234. package/template/.aioson/rules/output-brevity.md +44 -0
  235. package/template/.aioson/rules/prd-section-ownership.md +49 -0
  236. package/template/.aioson/rules/security-baseline.md +139 -0
  237. package/template/.aioson/rules/spec-level-ownership.md +61 -0
  238. package/template/.aioson/rules/squad-driver-pattern.md +81 -0
  239. package/template/.aioson/schemas/squad-blueprint.schema.json +24 -0
  240. package/template/.aioson/schemas/squad-manifest.schema.json +44 -0
  241. package/template/.aioson/skills/design/cognitive-core-ui/references/motion.md +2 -0
  242. package/template/.aioson/skills/marketing/references/anti-patterns.md +254 -0
  243. package/template/.aioson/skills/marketing/references/fascinations.md +192 -0
  244. package/template/.aioson/skills/marketing/references/five-acts.md +248 -0
  245. package/template/.aioson/skills/marketing/references/market-intelligence.md +198 -0
  246. package/template/.aioson/skills/marketing/references/offer-structure.md +203 -0
  247. package/template/.aioson/skills/marketing/references/one-belief.md +149 -0
  248. package/template/.aioson/skills/marketing/references/patterns.md +218 -0
  249. package/template/.aioson/skills/marketing/references/pms-research.md +193 -0
  250. package/template/.aioson/skills/marketing/vsl-craft.md +385 -0
  251. package/template/.aioson/skills/process/aioson-spec-driven/references/pm.md +30 -0
  252. package/template/.aioson/skills/process/secure-tdd/SKILL.md +97 -0
  253. package/template/.aioson/skills/process/secure-tdd/references/nextjs.md +81 -0
  254. package/template/.aioson/skills/process/secure-tdd/references/node-express.md +91 -0
  255. package/template/.aioson/skills/process/secure-tdd/references/planned-stacks.md +33 -0
  256. package/template/.aioson/skills/static/harness-validate/SKILL.md +46 -0
  257. package/template/.aioson/skills/static/landing-page-deploy.md +192 -0
  258. package/template/.aioson/skills/static/landing-page-forge.md +730 -0
  259. package/template/.aioson/skills/static/ui-ux-modern.md +1 -0
  260. package/template/.aioson/skills/static/web-research-cache.md +3 -0
  261. package/template/.aioson/tasks/squad-create.md +56 -7
  262. package/template/.aioson/tasks/squad-design.md +80 -2
  263. package/template/.aioson/tasks/squad-investigate.md +14 -1
  264. package/template/.aioson/templates/squads/digital-marketing-agency/template.json +96 -0
  265. package/template/.claude/commands/aioson/agent/committer.md +5 -0
  266. package/template/.claude/commands/aioson/agent/copywriter.md +5 -0
  267. package/template/.claude/commands/aioson/agent/cypher.md +5 -0
  268. package/template/.claude/commands/aioson/agent/pair.md +5 -0
  269. package/template/.claude/commands/aioson/agent/validator.md +5 -0
  270. package/template/.gemini/commands/aios-analyst.toml +6 -3
  271. package/template/.gemini/commands/aios-architect.toml +7 -6
  272. package/template/.gemini/commands/aios-committer.toml +7 -0
  273. package/template/.gemini/commands/aios-copywriter.toml +7 -0
  274. package/template/.gemini/commands/aios-cypher.toml +7 -0
  275. package/template/.gemini/commands/aios-dev.toml +8 -7
  276. package/template/.gemini/commands/aios-deyvin.toml +6 -5
  277. package/template/.gemini/commands/aios-discovery-design-doc.toml +6 -3
  278. package/template/.gemini/commands/aios-genome.toml +7 -0
  279. package/template/.gemini/commands/aios-neo.toml +5 -3
  280. package/template/.gemini/commands/aios-orache.toml +7 -0
  281. package/template/.gemini/commands/aios-orchestrator.toml +8 -7
  282. package/template/.gemini/commands/aios-pair.toml +6 -5
  283. package/template/.gemini/commands/aios-pm.toml +8 -7
  284. package/template/.gemini/commands/aios-product.toml +5 -3
  285. package/template/.gemini/commands/aios-qa.toml +6 -5
  286. package/template/.gemini/commands/aios-setup.toml +5 -2
  287. package/template/.gemini/commands/aios-sheldon.toml +7 -0
  288. package/template/.gemini/commands/aios-site-forge.toml +7 -0
  289. package/template/.gemini/commands/aios-squad.toml +7 -0
  290. package/template/.gemini/commands/aios-tester.toml +6 -5
  291. package/template/.gemini/commands/aios-ux-ui.toml +8 -7
  292. package/template/.gemini/commands/aios-validator.toml +7 -0
  293. package/template/AGENTS.md +12 -1
  294. package/template/CLAUDE.md +6 -1
  295. package/template/.aioson/locales/en/agents/analyst.md +0 -244
  296. package/template/.aioson/locales/en/agents/architect.md +0 -245
  297. package/template/.aioson/locales/en/agents/dev.md +0 -397
  298. package/template/.aioson/locales/en/agents/deyvin.md +0 -137
  299. package/template/.aioson/locales/en/agents/discovery-design-doc.md +0 -27
  300. package/template/.aioson/locales/en/agents/genome.md +0 -212
  301. package/template/.aioson/locales/en/agents/neo.md +0 -8
  302. package/template/.aioson/locales/en/agents/orache.md +0 -6
  303. package/template/.aioson/locales/en/agents/orchestrator.md +0 -189
  304. package/template/.aioson/locales/en/agents/pair.md +0 -5
  305. package/template/.aioson/locales/en/agents/pm.md +0 -84
  306. package/template/.aioson/locales/en/agents/product.md +0 -378
  307. package/template/.aioson/locales/en/agents/profiler-enricher.md +0 -5
  308. package/template/.aioson/locales/en/agents/profiler-forge.md +0 -5
  309. package/template/.aioson/locales/en/agents/profiler-researcher.md +0 -5
  310. package/template/.aioson/locales/en/agents/qa.md +0 -270
  311. package/template/.aioson/locales/en/agents/setup.md +0 -421
  312. package/template/.aioson/locales/en/agents/sheldon.md +0 -455
  313. package/template/.aioson/locales/en/agents/squad.md +0 -449
  314. package/template/.aioson/locales/en/agents/tester.md +0 -6
  315. package/template/.aioson/locales/en/agents/ux-ui.md +0 -668
  316. package/template/.aioson/locales/es/agents/analyst.md +0 -225
  317. package/template/.aioson/locales/es/agents/architect.md +0 -245
  318. package/template/.aioson/locales/es/agents/dev.md +0 -370
  319. package/template/.aioson/locales/es/agents/deyvin.md +0 -99
  320. package/template/.aioson/locales/es/agents/discovery-design-doc.md +0 -21
  321. package/template/.aioson/locales/es/agents/genome.md +0 -104
  322. package/template/.aioson/locales/es/agents/neo.md +0 -50
  323. package/template/.aioson/locales/es/agents/orache.md +0 -105
  324. package/template/.aioson/locales/es/agents/orchestrator.md +0 -194
  325. package/template/.aioson/locales/es/agents/pair.md +0 -7
  326. package/template/.aioson/locales/es/agents/pm.md +0 -90
  327. package/template/.aioson/locales/es/agents/product.md +0 -372
  328. package/template/.aioson/locales/es/agents/profiler-enricher.md +0 -7
  329. package/template/.aioson/locales/es/agents/profiler-forge.md +0 -7
  330. package/template/.aioson/locales/es/agents/profiler-researcher.md +0 -7
  331. package/template/.aioson/locales/es/agents/qa.md +0 -198
  332. package/template/.aioson/locales/es/agents/setup.md +0 -405
  333. package/template/.aioson/locales/es/agents/sheldon.md +0 -309
  334. package/template/.aioson/locales/es/agents/squad.md +0 -532
  335. package/template/.aioson/locales/es/agents/tester.md +0 -9
  336. package/template/.aioson/locales/es/agents/ux-ui.md +0 -212
  337. package/template/.aioson/locales/fr/agents/analyst.md +0 -225
  338. package/template/.aioson/locales/fr/agents/architect.md +0 -245
  339. package/template/.aioson/locales/fr/agents/dev.md +0 -370
  340. package/template/.aioson/locales/fr/agents/deyvin.md +0 -99
  341. package/template/.aioson/locales/fr/agents/discovery-design-doc.md +0 -21
  342. package/template/.aioson/locales/fr/agents/genome.md +0 -104
  343. package/template/.aioson/locales/fr/agents/neo.md +0 -50
  344. package/template/.aioson/locales/fr/agents/orache.md +0 -106
  345. package/template/.aioson/locales/fr/agents/orchestrator.md +0 -194
  346. package/template/.aioson/locales/fr/agents/pair.md +0 -7
  347. package/template/.aioson/locales/fr/agents/pm.md +0 -90
  348. package/template/.aioson/locales/fr/agents/product.md +0 -372
  349. package/template/.aioson/locales/fr/agents/profiler-enricher.md +0 -7
  350. package/template/.aioson/locales/fr/agents/profiler-forge.md +0 -7
  351. package/template/.aioson/locales/fr/agents/profiler-researcher.md +0 -7
  352. package/template/.aioson/locales/fr/agents/qa.md +0 -198
  353. package/template/.aioson/locales/fr/agents/setup.md +0 -405
  354. package/template/.aioson/locales/fr/agents/sheldon.md +0 -309
  355. package/template/.aioson/locales/fr/agents/squad.md +0 -532
  356. package/template/.aioson/locales/fr/agents/tester.md +0 -9
  357. package/template/.aioson/locales/fr/agents/ux-ui.md +0 -212
  358. package/template/.aioson/locales/pt-BR/agents/analyst.md +0 -319
  359. package/template/.aioson/locales/pt-BR/agents/architect.md +0 -284
  360. package/template/.aioson/locales/pt-BR/agents/dev.md +0 -483
  361. package/template/.aioson/locales/pt-BR/agents/deyvin.md +0 -184
  362. package/template/.aioson/locales/pt-BR/agents/discovery-design-doc.md +0 -198
  363. package/template/.aioson/locales/pt-BR/agents/genome.md +0 -297
  364. package/template/.aioson/locales/pt-BR/agents/neo.md +0 -208
  365. package/template/.aioson/locales/pt-BR/agents/orache.md +0 -137
  366. package/template/.aioson/locales/pt-BR/agents/orchestrator.md +0 -324
  367. package/template/.aioson/locales/pt-BR/agents/pair.md +0 -5
  368. package/template/.aioson/locales/pt-BR/agents/pm.md +0 -182
  369. package/template/.aioson/locales/pt-BR/agents/product.md +0 -466
  370. package/template/.aioson/locales/pt-BR/agents/profiler-enricher.md +0 -5
  371. package/template/.aioson/locales/pt-BR/agents/profiler-forge.md +0 -5
  372. package/template/.aioson/locales/pt-BR/agents/profiler-researcher.md +0 -5
  373. package/template/.aioson/locales/pt-BR/agents/qa.md +0 -300
  374. package/template/.aioson/locales/pt-BR/agents/setup.md +0 -533
  375. package/template/.aioson/locales/pt-BR/agents/sheldon.md +0 -323
  376. package/template/.aioson/locales/pt-BR/agents/squad.md +0 -1330
  377. package/template/.aioson/locales/pt-BR/agents/tester.md +0 -449
  378. package/template/.aioson/locales/pt-BR/agents/ux-ui.md +0 -669
  379. package/template/.aioson/skills/design-system/components/SKILL.md:Zone.Identifier +0 -0
  380. package/template/.aioson/skills/design-system/dashboards/SKILL.md:Zone.Identifier +0 -0
  381. package/template/.aioson/skills/design-system/foundations/SKILL.md:Zone.Identifier +0 -0
  382. package/template/.aioson/skills/design-system/motion/SKILL.md:Zone.Identifier +0 -0
  383. package/template/.aioson/skills/design-system/patterns/SKILL.md:Zone.Identifier +0 -0
package/template/.aioson/docs/ux-ui/site-delivery.md ADDED
@@ -0,0 +1,156 @@
1
+ ---
2
+ description: "UI/UX site delivery — landing-page composition rules, hero law, motion standards, copy expectations, CSS techniques, and final HTML structure."
3
+ ---
4
+
5
+ # UX/UI Site Delivery
6
+
7
+ Use this module when `project_type=site` or the requested deliverable is full-page HTML.
8
+
9
+ ## Landing page mode
10
+
11
+ Activate this mode after the design direction is chosen.
12
+
13
+ ## Hero law
14
+
15
+ The hero is never a grid of cards or a list of steps.
16
+
17
+ The hero is:
18
+ - full viewport
19
+ - animated background mesh or full-bleed photo
20
+ - one large headline
21
+ - 1–2 supporting lines
22
+ - two buttons
23
+ - optional social-proof strip
24
+
25
+ Card grids, numbered steps, and feature lists belong below the hero.
26
+
27
+ ## Direction-specific motion
28
+
29
+ ### Bold & Cinematic
30
+
31
+ Apply all three:
32
+
33
+ 1. animated mesh background
34
+ 2. animated gradient text on the key headline phrase
35
+ 3. 3D card tilt on hover for non-touch devices with `prefers-reduced-motion` fallback
36
+
37
+ ### Clean & Luminous
38
+
39
+ Apply:
40
+
41
+ 1. card lift using shadow
42
+ 2. subtle hover scale
43
+ 3. restrained entrance motion rather than tilt
44
+
45
+ ## Content crafting
46
+
47
+ Write real content from the project description. No placeholders.
48
+
49
+ ### Hero
50
+ - headline: 6–10 words, action-oriented
51
+ - sub-headline: 1–2 sentences expanding the value proposition
52
+ - primary CTA: specific verb
53
+ - secondary CTA: lower commitment
54
+
55
+ ### Feature or benefit sections
56
+ - icon
57
+ - short title
58
+ - 2–3 sentence description
59
+ - outcome-focused copy, not feature-dump language
60
+
61
+ ### Social proof
62
+ - testimonial with quote, name, role, company
63
+ - or a lightweight "used by teams at..." strip when evidence is limited
64
+
65
+ ### Final CTA
66
+ - repeat the primary CTA with urgency or benefit reminder
67
+ - remove competing actions
68
+
69
+ ## Image sourcing
70
+
71
+ Provide usable Unsplash URLs in the format:
72
+
73
+ `https://images.unsplash.com/photo-{id}?w=1920&q=80&fit=crop`
74
+
75
+ Infer the domain and propose:
76
+ - the specific search query
77
+ - 2–3 suggested image IDs
78
+
79
+ ## Modern CSS arsenal
80
+
81
+ The output HTML/CSS should use these techniques where appropriate:
82
+
83
+ ### Always
84
+
85
+ ```css
86
+ :root {
87
+ --color-bg: hsl(...);
88
+ --color-text: hsl(...);
89
+ --color-accent: hsl(...);
90
+ --font-display: 'Font Name', sans-serif;
91
+ --font-body: 'Font Name', sans-serif;
92
+ --radius: Xpx;
93
+ --section-padding: Xpx;
94
+ }
95
+
96
+ * { box-sizing: border-box; margin: 0; }
97
+ img { max-width: 100%; display: block; object-fit: cover; }
98
+ ```
99
+
100
+ ### Bold & Cinematic examples
101
+
102
+ ```css
103
+ .hero-overlay {
104
+ background: linear-gradient(135deg,
105
+ hsla(240, 50%, 8%, 0.92) 0%,
106
+ hsla(270, 60%, 20%, 0.7) 60%,
107
+ hsla(300, 40%, 10%, 0.4) 100%
108
+ );
109
+ }
110
+
111
+ .header-glass {
112
+ backdrop-filter: blur(20px) saturate(180%);
113
+ background: hsla(240, 15%, 8%, 0.7);
114
+ border-bottom: 1px solid hsla(255, 100%, 90%, 0.08);
115
+ }
116
+
117
+ @keyframes fadeUp {
118
+ from { opacity: 0; transform: translateY(32px); }
119
+ to { opacity: 1; transform: translateY(0); }
120
+ }
121
+ ```
122
+
123
+ ### Clean & Luminous examples
124
+
125
+ ```css
126
+ .card {
127
+ background: white;
128
+ border: 1px solid hsl(220, 15%, 92%);
129
+ border-radius: var(--radius);
130
+ box-shadow: 0 1px 3px hsla(220, 30%, 10%, 0.06),
131
+ 0 8px 24px hsla(220, 30%, 10%, 0.04);
132
+ }
133
+
134
+ .section-title::after {
135
+ content: '';
136
+ display: block;
137
+ width: 48px;
138
+ height: 3px;
139
+ background: var(--color-accent);
140
+ border-radius: 2px;
141
+ margin-top: 12px;
142
+ }
143
+ ```
144
+
145
+ ## HTML structure
146
+
147
+ Produce a complete `index.html` in the project root with:
148
+ - `<head>` including fonts and CSS
149
+ - sticky `<header>` with logo, nav, and CTA
150
+ - full-viewport hero
151
+ - three feature or benefit sections
152
+ - social proof section
153
+ - final CTA section
154
+ - minimal footer
155
+ - responsive CSS with a mobile-first breakpoint strategy
156
+ - `@media (prefers-reduced-motion: reduce)` fallback
package/template/.aioson/docs/ux-ui/token-contract.md ADDED
@@ -0,0 +1,57 @@
1
+ ---
2
+ description: "UI/UX token contract mode — extraction and normalization of design tokens for colors, spacing, typography, and semantic ownership."
3
+ ---
4
+
5
+ # UX/UI Token Contract
6
+
7
+ Activate via `@ux-ui tokens`.
8
+
9
+ ## When to use
10
+
11
+ - when the project needs a shared token system between design and code
12
+ - when multiple developers or squads will implement UI from the same spec
13
+ - when migrating from hardcoded values to a token-based system
14
+
15
+ ## Step 1 — Analyze current state
16
+
17
+ - if UI code exists, extract hardcoded colors, spacing, radius, shadows, and typography
18
+ - if `ui-spec.md` exists, extract the token block
19
+ - if `design_skill` is set, load the skill token definitions as the source of truth
20
+
21
+ ## Step 2 — Build the contract
22
+
23
+ Use this structure:
24
+
25
+ ```markdown
26
+ ## Token Contract — [Project Name]
27
+
28
+ ### Primitive tokens
29
+ | Token | Value | Usage |
30
+ |---|---|---|
31
+ | `--color-slate-50` | `hsl(210, 40%, 98%)` | lightest background |
32
+
33
+ ### Semantic tokens
34
+ | Token | Light value | Dark value | Usage |
35
+ |---|---|---|---|
36
+ | `--color-bg-primary` | `var(--color-slate-50)` | `var(--color-slate-900)` | main background |
37
+
38
+ ### Spacing scale
39
+ | Token | Value |
40
+ |---|---|
41
+ | `--space-1` | `4px` |
42
+
43
+ ### Typography scale
44
+ | Token | Size | Weight | Line-height | Usage |
45
+ |---|---|---|---|---|
46
+ | `--text-xs` | `12px` | `400` | `1.5` | captions |
47
+
48
+ ### Token ownership
49
+ - `:root` → primitives + light-mode semantics
50
+ - `[data-theme="dark"]` → dark-mode semantic overrides
51
+ - component level → component-specific tokens only
52
+ ```
53
+
54
+ ## Output
55
+
56
+ - write to `.aioson/context/ui-tokens.md`
57
+ - if `ui-spec.md` exists, update its token block to reference `ui-tokens.md` as the source of truth
package/template/.aioson/genomes/copywriting.md ADDED
@@ -0,0 +1,204 @@
1
+ ---
2
+ name: copywriting
3
+ description: Generic direct response copywriting genome — mental models, frameworks, heuristics and methodologies for high-converting copy in any niche.
4
+ type: function
5
+ domain: copywriting
6
+ ---
7
+
8
+ # Genome: Copywriting (Direct Response)
9
+
10
+ ## Identity
11
+
12
+ This genome encodes the thinking patterns of direct response copywriting — the discipline of writing words that produce measurable action. It is niche-agnostic: the principles work for health, finance, education, SaaS, e-commerce, and any domain where conversion matters.
13
+
14
+ ---
15
+
16
+ ## Filosofias
17
+
18
+ ### 1. Copy is salesmanship in print
19
+ Copy is not creative writing. It's a salesperson who works 24/7 without breaks, sick days, or mood swings. Every sentence must advance the sale or be cut.
20
+
21
+ ### 2. The prospect is the hero, not the product
22
+ The product is a vehicle. The prospect is the protagonist. The copy's job is to show them a path from their current painful state to their desired future state — and the product is the bridge.
23
+
24
+ ### 3. Nothing is created, everything is modeled
25
+ Original copy comes from structured research, not imagination. Study what works (swipe files, competitor analysis, audience language), then adapt the structure, angle, and psychology to the specific product and audience.
26
+
27
+ ### 4. There is no long copy, only boring copy
28
+ Length doesn't kill conversion — boredom does. A 5,000-word sales page that maintains curiosity and relevance outperforms a 500-word page that's generic. Every paragraph must earn the next paragraph.
29
+
30
+ ### 5. The market dictates the message
31
+ You don't choose what to say — the market does. Research (PMS, competitor analysis, audience language) reveals what the prospect needs to hear. Your job is to organize and present it, not to invent it.
32
+
33
+ ### 6. Data beats opinion
34
+ If an element is converting, don't change it because it looks "ugly" or doesn't match your taste. Conversion data is the only judge. Aesthetic improvements that reduce conversion are failures, not improvements.
35
+
36
+ ---
37
+
38
+ ## Modelos mentais
39
+
40
+ ### The One Belief Model
41
+ Every page/VSL must establish one central belief:
42
+ > "Doing [New Opportunity] is the key to [Primary Benefit], and this is only possible through [Unique Mechanism]."
43
+
44
+ All copy elements serve this single thesis. If a section doesn't build the belief, it weakens it.
45
+
46
+ **Reference:** `.aioson/skills/marketing/references/one-belief.md`
47
+
48
+ ### The 5-Act Narrative Arc
49
+ Sales content follows a dramatic structure, not a flat feature list:
50
+ 1. **Lead** — hook attention, create curiosity
51
+ 2. **Background** — build authority and emotional connection
52
+ 3. **Mechanism** — explain WHY (problem cause + solution logic)
53
+ 4. **Offer** — present the product as the vehicle
54
+ 5. **Close** — manage emotions, drive action
55
+
56
+ **Reference:** `.aioson/skills/marketing/references/five-acts.md`
57
+
58
+ ### PMS (Problems, Myths, Dreams)
59
+ Before writing, map:
60
+ - **P** — Problems the audience faces (in their words)
61
+ - **M** — Myths/Lies they believe that keep them stuck
62
+ - **S** — Dreams they have (specific, emotional, visualizable)
63
+
64
+ Copy that mirrors PMS back to the prospect in their vocabulary converts.
65
+
66
+ **Reference:** `.aioson/skills/marketing/references/pms-research.md`
67
+
68
+ ### Market Sophistication Levels
69
+ Eugene Schwartz's 5 levels determine HOW to write:
70
+
71
+ | Level | State | Strategy |
72
+ |---|---|---|
73
+ | 1 | Unaware of the problem | Lead with problem discovery |
74
+ | 2 | Problem-aware, no solutions tried | Simple promise + mechanism |
75
+ | 3 | Solution-aware, tried things that failed | Invalidate old solutions first |
76
+ | 4 | Product-aware, knows your type exists | Hyper-specific unique mechanism |
77
+ | 5 | Most sophisticated, skeptical | Lead with proof, reverse-engineer belief |
78
+
79
+ ### The Awareness Spectrum
80
+ Where the prospect is determines the page structure:
81
+
82
+ - **Cold traffic** (never heard of you) → Full 5-act structure, longer copy, more proof needed
83
+ - **Warm traffic** (follows you, knows you) → Can shorten Acts 1-2, focus on mechanism + offer
84
+ - **Hot traffic** (ready to buy, needs the push) → Lead with offer + guarantee + urgency
85
+
86
+ ---
87
+
88
+ ## Heurísticas
89
+
90
+ ### H1: Headline decides 80% of the page's performance
91
+ If the headline doesn't stop the scroll, nothing else matters. Spend 40% of your writing time on the headline and subheadline.
92
+
93
+ ### H2: Every section must do one of three things
94
+ 1. Build the belief (One Belief)
95
+ 2. Prove the belief (social proof, mechanism, demonstration)
96
+ 3. Drive the action (CTA, urgency, guarantee)
97
+
98
+ If a section doesn't do any of these, cut it.
99
+
100
+ ### H3: The prospect's vocabulary is always better than yours
101
+ "I'm tired of the yo-yo cycle" > "Achieve sustainable weight management."
102
+ Use the words they use. Research gives you those words.
103
+
104
+ ### H4: Specificity creates credibility
105
+ "14,237 patients" > "thousands of patients"
106
+ "R$47M in combined revenue" > "millions in revenue"
107
+ "In 21 days" > "quickly"
108
+ The more specific the claim, the more believable it is.
109
+
110
+ ### H5: One CTA per decision point
111
+ Never give the prospect 5 things to click. One primary action. One secondary (lower commitment) if needed. That's it.
112
+
113
+ ### H6: Objections not addressed are objections that win
114
+ Every prospect has reasons to say no. Name them. Address them. Prove them wrong. Unaddressed objections compound into a silent "no."
115
+
116
+ ### H7: The guarantee is a conversion multiplier, not a risk
117
+ Strong guarantees increase conversion more than they increase refunds. A 30-day unconditional guarantee can increase sales by 20-30% while refund rates typically stay under 5%.
118
+
119
+ ### H8: Features are proof, not headlines
120
+ Features belong in supporting sections as evidence that the benefit is real. They never lead. Benefits lead, features support.
121
+
122
+ ### H9: Price is always relative
123
+ R$97 is expensive for a PDF. R$97 is cheap for solving a problem that costs R$5,000/year. The copy must frame the price against the alternative cost.
124
+
125
+ ### H10: Urgency must be real or absent
126
+ Fake urgency destroys trust faster than no urgency destroys conversion. If there's no real deadline, don't invent one. Use the Two Paths technique instead (emotional urgency, not manufactured scarcity).
127
+
128
+ ---
129
+
130
+ ## Frameworks
131
+
132
+ ### Framework 1: AIDA (classic)
133
+ **A**ttention → **I**nterest → **D**esire → **A**ction
134
+ Best for: short copy, email sequences, ad scripts.
135
+
136
+ ### Framework 2: PAS (Problem-Agitate-Solve)
137
+ **P**roblem (name it) → **A**gitate (make it feel urgent) → **S**olve (present the solution)
138
+ Best for: email subject lines, ad hooks, section openers.
139
+
140
+ ### Framework 3: BAB (Before-After-Bridge)
141
+ **B**efore (current painful state) → **A**fter (desired future state) → **B**ridge (the product connects them)
142
+ Best for: testimonial sections, hero copy, case studies.
143
+
144
+ ### Framework 4: The Two Paths (close technique)
145
+ Present two futures:
146
+ - **Path 1:** Stay the same (paint the pain of inaction with specific consequences)
147
+ - **Path 2:** Take the new opportunity (paint the dream outcome with specific details)
148
+
149
+ Best for: Act 5 (close), email sequences, retargeting pages.
150
+
151
+ ### Framework 5: The Irresistible Offer Stack
152
+ Value anchoring → Component stacking → Bonuses with purpose → Reason why → Guarantee → CTA
153
+ Best for: Act 4 (offer section).
154
+
155
+ **Reference:** `.aioson/skills/marketing/references/offer-structure.md`
156
+
157
+ ---
158
+
159
+ ## Metodologias
160
+
161
+ ### M1: Research before writing (always)
162
+ 1. PMS mapping (Problems, Myths, Dreams)
163
+ 2. Competitive scan (ads, pages, gaps)
164
+ 3. Audience language capture (exact quotes)
165
+ 4. Trend validation (Google Trends, social)
166
+
167
+ **Reference:** `.aioson/skills/marketing/references/market-intelligence.md`
168
+
169
+ ### M2: Write in blocks, not linearly
170
+ Write the headline LAST (after you know the mechanism and offer).
171
+ Write the mechanism FIRST (it determines the headline angle).
172
+ Order: Mechanism → Offer → Lead → Background → Close → Headline.
173
+
174
+ ### M3: Validate against anti-patterns
175
+ After writing, run every section through the anti-pattern checklist.
176
+ **Reference:** `.aioson/skills/marketing/references/anti-patterns.md`
177
+
178
+ ### M4: Test before perfecting
179
+ For VSLs: test with an "ugly" version (slides, text on screen) before investing in production.
180
+ For pages: test the headline and CTA before designing the full page.
181
+ Data validates — opinion guesses.
182
+
183
+ ---
184
+
185
+ ## Conditional reference loading
186
+
187
+ This genome references detailed files in `.aioson/skills/marketing/references/`. Load them on demand:
188
+
189
+ | When writing... | Load these references |
190
+ |---|---|
191
+ | Any marketing/sales page | `patterns.md` + `anti-patterns.md` |
192
+ | Offer/pricing section | `offer-structure.md` + `fascinations.md` |
193
+ | Research phase | `pms-research.md` + `market-intelligence.md` |
194
+ | Narrative structure | `five-acts.md` + `one-belief.md` |
195
+ | VSL script | All references + `.aioson/skills/marketing/vsl-craft.md` |
196
+
197
+ ---
198
+
199
+ ## What this genome does NOT cover
200
+
201
+ - **Brand-specific voice:** Use a `brand-voice-{slug}.md` genome for client-specific tone
202
+ - **Domain-specific knowledge:** Use domain genomes for industry-specific mental models
203
+ - **Visual design:** @ux-ui handles visual implementation — this genome handles the words
204
+ - **SEO/technical implementation:** `landing-page-forge.md` skill handles technical production
package/template/.aioson/genomes/copywriting.meta.json ADDED
@@ -0,0 +1,48 @@
1
+ {
2
+ "genome": "copywriting",
3
+ "schemaVersion": 2,
4
+ "slug": "copywriting",
5
+ "domain": "Copywriting (Direct Response)",
6
+ "type": "function",
7
+ "version": 2,
8
+ "format": "genome-v2",
9
+ "language": "en",
10
+ "depth": "deep",
11
+ "evidenceMode": "inferred",
12
+ "sourceCount": 0,
13
+ "counts": {
14
+ "knowledgeNodes": 0,
15
+ "philosophies": 6,
16
+ "mentalModels": 4,
17
+ "heuristics": 10,
18
+ "frameworks": 5,
19
+ "methodologies": 4,
20
+ "mentes": 0,
21
+ "skills": 0,
22
+ "cognitiveProfile": 0,
23
+ "communicationStyle": 0,
24
+ "biases": 0,
25
+ "conflictResolution": 0,
26
+ "evidence": 0,
27
+ "applicationNotes": 0
28
+ },
29
+ "dependencies": {
30
+ "skills": ["marketing"],
31
+ "genomes": []
32
+ },
33
+ "origin": {
34
+ "mode": "llm",
35
+ "sourceFiles": [],
36
+ "sourceUrls": []
37
+ },
38
+ "compat": {
39
+ "legacyMarkdownCompatible": true,
40
+ "synthesizedFromLegacy": false
41
+ },
42
+ "bindings": {
43
+ "squads": [],
44
+ "agents": []
45
+ },
46
+ "createdAt": "2026-03-01T00:00:00.000Z",
47
+ "updatedAt": "2026-04-07T00:00:00.000Z"
48
+ }
package/template/.aioson/git-guard.json ADDED
@@ -0,0 +1,11 @@
1
+ {
2
+ "version": 1,
3
+ "description": "Project-specific overrides for aioson git:guard. allowPaths suppress both path-based and content-based checks for listed paths.",
4
+ "allowPaths": [],
5
+ "blockPaths": [
6
+ "node_modules/**",
7
+ "aioson-logs/**"
8
+ ],
9
+ "allowExtensions": [],
10
+ "blockExtensions": []
11
+ }
package/template/.aioson/mcp/servers.md CHANGED
@@ -7,7 +7,6 @@
7
7
  - context7: up-to-date framework docs
8
8
  - database: schema inspection
9
9
  - web-search: market and reference research
10
- - makopy: content generation pipelines
11
10
 
12
11
  ## Local generation with AIOSON CLI
13
12
  Use:
package/template/.aioson/rules/agent-language-policy.md ADDED
@@ -0,0 +1,93 @@
1
+ ---
2
+ name: agent-language-policy
3
+ description: Agent files default to English for universal reuse. Locale-specific squads may declare a locale_scope to write agent files in their native language.
4
+ priority: 9
5
+ version: 1.1.0
6
+ agents: [squad, genome, orache, design-hybrid-forge, site-forge]
7
+ ---
8
+
9
+ # Agent Language Policy
10
+
11
+ Agent files are instruction code — default is English (maximizes LLM reasoning, universal reuse). Squads with `locale_scope` declared are the exception.
12
+
13
+ ## Language decision tree
14
+
15
+ ```
16
+ Squad novo ou existente
17
+ ├── ephemeral: true → qualquer idioma
18
+ └── ephemeral: false
19
+ ├── locale_scope: "universal" (ou ausente) → agent files em INGLÊS
20
+ └── locale_scope: "{locale}" declarado → agent files no idioma do locale
21
+ ```
22
+
23
+ ## Declaring locale_scope
24
+
25
+ In `squad.manifest.json`:
26
+
27
+ ```json
28
+ {
29
+ "slug": "atendimento-farmacia",
30
+ "locale_scope": "pt-BR",
31
+ "locale_rationale": "Domínio regulado pela ANVISA — legislação, receituário e interações são exclusivamente brasileiros."
32
+ }
33
+ ```
34
+
35
+ Valid values: `"universal"` (default) or any BCP-47 code: `"pt-BR"`, `"en-US"`, `"es-MX"`, `"fr-FR"`.
36
+
37
+ ## When locale_scope is legitimate — ALL criteria must be true
38
+
39
+ | Criterion | Question |
40
+ |---|---|
41
+ | Local regulation | Legislation governs a specific country? (ANVISA, OAB, NHS, FDA…) |
42
+ | Local end user | Users interact exclusively in that language? |
43
+ | No portability | Squad never reused in another country without full rewrite? |
44
+ | Native domain reasoning | Technical domain richer in native language? |
45
+
46
+ Justified: farmácia ANVISA, tributário eSocial, jurídico brasileiro, suporte nacional.
47
+ Not justified: marketing digital, software dev, YouTube creator, psicologia/coaching.
48
+
49
+ ## Rules by layer
50
+
51
+ ### Universal squad
52
+
53
+ | Layer | Language |
54
+ |---|---|
55
+ | Agent slug / name | English |
56
+ | Agent file (mission, focus, constraints) | English |
57
+ | Source code (vars, functions, classes) | English |
58
+ | Agent output to user | `interaction_language` (fallback: `conversation_language`) |
59
+ | Content docs (PRD, specs, plans) | Project language |
60
+
61
+ ### Locale-scoped squad
62
+
63
+ | Layer | Language |
64
+ |---|---|
65
+ | Agent slug / name | Locale language |
66
+ | Agent file (mission, focus, constraints) | Locale language |
67
+ | Source code | **English — no exception** |
68
+ | Agent output | Locale language |
69
+ | Content docs | Locale language |
70
+
71
+ ## Mandatory question during squad creation
72
+
73
+ Before generating any file:
74
+
75
+ ```
76
+ Este squad é para uso em um país/idioma específico ou deve ser universal?
77
+
78
+ 1. Universal (inglês) — reutilizável em qualquer projeto, publicável no aiosforge.com
79
+ 2. Locale específico — ex: só para o Brasil, só em português
80
+ ```
81
+
82
+ If (2): request locale code. If unclear: infer from domain and confirm.
83
+
84
+ **Auto-inference:**
85
+ - Domain with specific country legislation → suggest that country's locale
86
+ - Portuguese content with clearly Brazilian audience → suggest `pt-BR`
87
+ - Generic domain, no geographic reference → suggest universal
88
+
89
+ ## On file creation
90
+
91
+ - Universal → write in English, no prompt needed.
92
+ - Locale declared → write in locale language, no prompt needed.
93
+ - Ambiguous → ask the mandatory question before generating any file.
package/template/.aioson/rules/aioson-context-boundary.md ADDED
@@ -0,0 +1,63 @@
1
+ ---
2
+ name: aioson-context-boundary
3
+ description: .aioson/context/ is Markdown-first with explicit machine-readable exceptions
4
+ priority: 10
5
+ version: 1.0.0
6
+ agents: [product, analyst, architect, ux-ui, pm, dev, qa, sheldon]
7
+ ---
8
+
9
+ # Context Boundary: .aioson/context/
10
+
11
+ `.aioson/context/` is Markdown-first. Human-authored feature and project artifacts should be Markdown unless a file is one of the explicit machine-readable exceptions below.
12
+
13
+ Prohibited by default: `.json`, `.yaml`/`.yml`, `.js`, `.ts`, `.py`, any non-Markdown format.
14
+
15
+ Allowed machine-readable exceptions:
16
+
17
+ - `.aioson/context/conformance-{slug}.yaml`
18
+ - `.aioson/context/security-findings-{slug}.json`
19
+ - `.aioson/context/workflow.state.json`
20
+ - `.aioson/context/handoff-protocol.json`
21
+ - `.aioson/context/last-handoff.json`
22
+ - `.aioson/context/parallel/*.json`
23
+
24
+ ## Correct location by artifact type
25
+
26
+ | Artifact type | Correct location |
27
+ |---|---|
28
+ | Project configuration | `.aioson/config.md` |
29
+ | Conformance schema | `.aioson/context/conformance-{slug}.yaml` ← machine-readable exception |
30
+ | Security findings | `.aioson/context/security-findings-{slug}.json` ← machine-readable exception |
31
+ | Workflow handoff/runtime state | `.aioson/context/workflow.state.json`, `.aioson/context/handoff-protocol.json`, `.aioson/context/last-handoff.json` |
32
+ | Parallel coordination machine files | `.aioson/context/parallel/*.json` |
33
+ | Squad definitions | `.aioson/squads/{slug}/` |
34
+ | Skill manifests | `.aioson/skills/{category}/{slug}/SKILL.md` |
35
+ | Feature artifacts | `.aioson/context/{artifact}-{slug}.md` |
36
+ | Project artifacts | `.aioson/context/{artifact}.md` |
37
+
38
+ ## Valid artifacts in .aioson/context/
39
+
40
+ ```
41
+ project.context.md ← setup
42
+ discovery.md ← analyst
43
+ requirements-{slug}.md ← analyst
44
+ architecture.md ← architect
45
+ ui-spec-{slug}.md ← ux-ui
46
+ prd.md / prd-{slug}.md ← product
47
+ spec-{slug}.md ← dev
48
+ implementation-plan-{slug}.md ← pm
49
+ features.md ← product / pm
50
+ project-pulse.md ← all agents (update at session end)
51
+ conformance-{slug}.yaml ← conformance machine-readable exception
52
+ security-findings-{slug}.json ← pentester/qa security findings exception
53
+ workflow.state.json ← workflow runtime exception
54
+ handoff-protocol.json ← workflow handoff exception
55
+ last-handoff.json ← workflow handoff exception
56
+ parallel/*.json ← parallel coordination exception
57
+ ```
58
+
59
+ ## On violation detected
60
+
61
+ 1. Do not create the file.
62
+ 2. Identify correct format and location.
63
+ 3. Inform user: "`.aioson/context/` is Markdown-first. Non-Markdown is allowed only for the listed machine-readable exceptions. Creating `{artifact}` in `{correct-location}` instead."
package/template/.aioson/rules/canonical-path-contract.md ADDED
@@ -0,0 +1,47 @@
1
+ ---
2
+ name: canonical-path-contract
3
+ description: Distinção obrigatória entre plans/ root, .aioson/plans/{slug}/, docs/pt/ e implementation-plan. Todo agente que escreve artefatos deve consultar este contrato antes de criar arquivos.
4
+ priority: 10
5
+ version: 1.0.0
6
+ agents: []
7
+ ---
8
+
9
+ # Canonical Path Contract
10
+
11
+ Every agent that creates or writes files MUST resolve the target path using this contract before writing.
12
+
13
+ ## The three confusable directories
14
+
15
+ | Directory | Purpose | Write rule |
16
+ |---|---|---|
17
+ | `plans/` (root) | Pre-production research and source material only | READ-ONLY for agents. Exception: `plans/source-manifest.md` may be updated when consuming a source plan. |
18
+ | `.aioson/plans/{slug}/` | Active phased plan produced by `@sheldon` | Written by `@sheldon`. Consumed by `@dev` and `@qa` during execution. |
19
+ | `docs/pt/` | Public system documentation for implemented behavior | Written only after behavior is implemented. Never used as operational planning space or scratchpad. |
20
+
21
+ ## Operational artifact destinations
22
+
23
+ | Artifact | Correct destination | Owner |
24
+ |---|---|---|
25
+ | Operational feature plan (phased) | `.aioson/plans/{slug}/manifest.md` + phase files | `@sheldon` |
26
+ | MEDIUM execution plan | `.aioson/context/implementation-plan-{slug}.md` | `@pm` |
27
+ | PRD | `.aioson/context/prd-{slug}.md` | `@product` |
28
+ | Requirements | `.aioson/context/requirements-{slug}.md` | `@analyst` |
29
+ | Architecture | `.aioson/context/architecture.md` | `@architect` |
30
+ | Spec (living memory) | `.aioson/context/spec-{slug}.md` | `@dev` |
31
+ | QA report | `.aioson/context/qa-report-{slug}.md` | `@qa` |
32
+
33
+ ## Violation behaviors
34
+
35
+ - If an agent is about to write a plan to `docs/pt/`: stop, use `.aioson/plans/{slug}/` instead.
36
+ - If an agent is about to write an operational artifact to `plans/` root: stop, use the correct `.aioson/context/` or `.aioson/plans/{slug}/` path.
37
+ - If any agent creates a file outside its write scope: stop, identify the correct path, and confirm with the user before writing.
38
+ - Before creating any file, verify the path against `.aioson/context/project-map.md`.
39
+
40
+ ## When the user refers to a directory ambiguously
41
+
42
+ | User says | Agent resolves to |
43
+ |---|---|
44
+ | "plans" or "plans folder" | Ask: root `plans/` (pre-production) or `.aioson/plans/{slug}/` (feature plan)? |
45
+ | "docs" or "documentation" | Ask: `docs/` root (project docs) or `docs/pt/` (PT system docs) or `.aioson/docs/` (agent on-demand docs)? |
46
+ | "context" | `.aioson/context/` (framework artifacts) |
47
+ | "rules" | `.aioson/rules/` (agent rules) |