@jaimevalasek/aioson 1.7.2 → 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 (362) hide show
  1. package/CHANGELOG.md +35 -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 +42 -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/cypher.md +252 -0
  143. package/template/.aioson/agents/dev.md +112 -628
  144. package/template/.aioson/agents/deyvin.md +33 -236
  145. package/template/.aioson/agents/discover.md +235 -0
  146. package/template/.aioson/agents/discovery-design-doc.md +17 -252
  147. package/template/.aioson/agents/genome.md +76 -26
  148. package/template/.aioson/agents/manifests/analyst.manifest.json +26 -0
  149. package/template/.aioson/agents/manifests/architect.manifest.json +23 -0
  150. package/template/.aioson/agents/manifests/committer.manifest.json +23 -0
  151. package/template/.aioson/agents/manifests/dev.manifest.json +37 -0
  152. package/template/.aioson/agents/manifests/orchestrator.manifest.json +30 -0
  153. package/template/.aioson/agents/manifests/pentester.manifest.json +39 -0
  154. package/template/.aioson/agents/manifests/pm.manifest.json +26 -0
  155. package/template/.aioson/agents/manifests/product.manifest.json +23 -0
  156. package/template/.aioson/agents/manifests/qa.manifest.json +25 -0
  157. package/template/.aioson/agents/manifests/setup.manifest.json +20 -0
  158. package/template/.aioson/agents/manifests/ux-ui.manifest.json +24 -0
  159. package/template/.aioson/agents/neo.md +5 -7
  160. package/template/.aioson/agents/orache.md +2 -6
  161. package/template/.aioson/agents/orchestrator.md +81 -182
  162. package/template/.aioson/agents/pentester.md +235 -0
  163. package/template/.aioson/agents/pm.md +40 -104
  164. package/template/.aioson/agents/product.md +99 -344
  165. package/template/.aioson/agents/profiler-enricher.md +57 -6
  166. package/template/.aioson/agents/profiler-forge.md +17 -7
  167. package/template/.aioson/agents/profiler-researcher.md +29 -6
  168. package/template/.aioson/agents/qa.md +168 -514
  169. package/template/.aioson/agents/setup.md +52 -278
  170. package/template/.aioson/agents/sheldon.md +122 -754
  171. package/template/.aioson/agents/site-forge.md +111 -1583
  172. package/template/.aioson/agents/squad.md +139 -2010
  173. package/template/.aioson/agents/tester.md +10 -0
  174. package/template/.aioson/agents/ux-ui.md +104 -812
  175. package/template/.aioson/agents/validator.md +69 -0
  176. package/template/.aioson/brains/scripts/query.js +5 -1
  177. package/template/.aioson/config/autonomy-protocol.json +43 -0
  178. package/template/.aioson/config.md +43 -15
  179. package/template/.aioson/constitution.md +36 -33
  180. package/template/.aioson/context/design-doc.md +136 -0
  181. package/template/.aioson/context/project-map.md +57 -0
  182. package/template/.aioson/design-docs/code-reuse.md +48 -0
  183. package/template/.aioson/design-docs/componentization.md +47 -0
  184. package/template/.aioson/design-docs/file-size.md +52 -0
  185. package/template/.aioson/design-docs/folder-structure.md +51 -0
  186. package/template/.aioson/design-docs/naming.md +54 -0
  187. package/template/.aioson/docs/LAYERS.md +12 -2
  188. package/template/.aioson/docs/dev/execution-discipline.md +106 -0
  189. package/template/.aioson/docs/dev/stack-conventions.md +83 -0
  190. package/template/.aioson/docs/deyvin/continuity-recovery.md +57 -0
  191. package/template/.aioson/docs/deyvin/debugging-escalation.md +30 -0
  192. package/template/.aioson/docs/deyvin/pair-execution.md +44 -0
  193. package/template/.aioson/docs/deyvin/runtime-handoffs.md +36 -0
  194. package/template/.aioson/docs/product/conversation-playbook.md +116 -0
  195. package/template/.aioson/docs/product/prd-contract.md +107 -0
  196. package/template/.aioson/docs/product/quality-lens.md +57 -0
  197. package/template/.aioson/docs/product/research-loop.md +65 -0
  198. package/template/.aioson/docs/sheldon/enrichment-paths.md +134 -0
  199. package/template/.aioson/docs/sheldon/quality-lens.md +57 -0
  200. package/template/.aioson/docs/sheldon/research-loop.md +56 -0
  201. package/template/.aioson/docs/sheldon/web-intelligence.md +75 -0
  202. package/template/.aioson/docs/site-forge-build.md +195 -0
  203. package/template/.aioson/docs/site-forge-extraction.md +135 -0
  204. package/template/.aioson/docs/site-forge-qa.md +155 -0
  205. package/template/.aioson/docs/site-forge-recon.md +434 -0
  206. package/template/.aioson/docs/site-forge-transform.md +249 -0
  207. package/template/.aioson/docs/squad/content-output.md +91 -0
  208. package/template/.aioson/docs/squad/creation-flow.md +135 -0
  209. package/template/.aioson/docs/squad/domain-classification.md +117 -0
  210. package/template/.aioson/docs/squad/genome-bindings.md +47 -0
  211. package/template/.aioson/docs/squad/package-contract.md +234 -0
  212. package/template/.aioson/docs/squad/quality-lens.md +56 -0
  213. package/template/.aioson/docs/squad/research-loop.md +59 -0
  214. package/template/.aioson/docs/squad/session-operations.md +117 -0
  215. package/template/.aioson/docs/squad/workflow-quality.md +165 -0
  216. package/template/.aioson/docs/ux-ui/accessibility-audit.md +55 -0
  217. package/template/.aioson/docs/ux-ui/audit-mode.md +86 -0
  218. package/template/.aioson/docs/ux-ui/component-map.md +35 -0
  219. package/template/.aioson/docs/ux-ui/design-execution.md +111 -0
  220. package/template/.aioson/docs/ux-ui/design-gate.md +27 -0
  221. package/template/.aioson/docs/ux-ui/research-mode.md +39 -0
  222. package/template/.aioson/docs/ux-ui/site-delivery.md +156 -0
  223. package/template/.aioson/docs/ux-ui/token-contract.md +57 -0
  224. package/template/.aioson/genomes/copywriting.meta.json +48 -0
  225. package/template/.aioson/git-guard.json +11 -0
  226. package/template/.aioson/mcp/servers.md +0 -1
  227. package/template/.aioson/rules/agent-language-policy.md +93 -0
  228. package/template/.aioson/rules/aioson-context-boundary.md +63 -0
  229. package/template/.aioson/rules/canonical-path-contract.md +47 -0
  230. package/template/.aioson/rules/data-format-convention.md +24 -86
  231. package/template/.aioson/rules/disk-first-artifacts.md +44 -0
  232. package/template/.aioson/rules/output-brevity.md +44 -0
  233. package/template/.aioson/rules/prd-section-ownership.md +49 -0
  234. package/template/.aioson/rules/security-baseline.md +139 -0
  235. package/template/.aioson/rules/spec-level-ownership.md +61 -0
  236. package/template/.aioson/rules/squad-driver-pattern.md +81 -0
  237. package/template/.aioson/schemas/squad-blueprint.schema.json +24 -0
  238. package/template/.aioson/schemas/squad-manifest.schema.json +44 -0
  239. package/template/.aioson/skills/process/aioson-spec-driven/references/pm.md +30 -0
  240. package/template/.aioson/skills/process/secure-tdd/SKILL.md +97 -0
  241. package/template/.aioson/skills/process/secure-tdd/references/nextjs.md +81 -0
  242. package/template/.aioson/skills/process/secure-tdd/references/node-express.md +91 -0
  243. package/template/.aioson/skills/process/secure-tdd/references/planned-stacks.md +33 -0
  244. package/template/.aioson/skills/static/harness-validate/SKILL.md +46 -0
  245. package/template/.aioson/skills/static/web-research-cache.md +3 -0
  246. package/template/.aioson/tasks/squad-create.md +35 -8
  247. package/template/.aioson/tasks/squad-design.md +50 -2
  248. package/template/.aioson/tasks/squad-investigate.md +14 -1
  249. package/template/.claude/commands/aioson/agent/committer.md +5 -0
  250. package/template/.claude/commands/aioson/agent/copywriter.md +5 -0
  251. package/template/.claude/commands/aioson/agent/cypher.md +5 -0
  252. package/template/.claude/commands/aioson/agent/pair.md +5 -0
  253. package/template/.claude/commands/aioson/agent/validator.md +5 -0
  254. package/template/.gemini/commands/aios-analyst.toml +6 -3
  255. package/template/.gemini/commands/aios-architect.toml +7 -6
  256. package/template/.gemini/commands/aios-committer.toml +7 -0
  257. package/template/.gemini/commands/aios-copywriter.toml +7 -0
  258. package/template/.gemini/commands/aios-cypher.toml +7 -0
  259. package/template/.gemini/commands/aios-dev.toml +8 -7
  260. package/template/.gemini/commands/aios-deyvin.toml +6 -5
  261. package/template/.gemini/commands/aios-discovery-design-doc.toml +6 -3
  262. package/template/.gemini/commands/aios-genome.toml +7 -0
  263. package/template/.gemini/commands/aios-neo.toml +5 -3
  264. package/template/.gemini/commands/aios-orache.toml +7 -0
  265. package/template/.gemini/commands/aios-orchestrator.toml +8 -7
  266. package/template/.gemini/commands/aios-pair.toml +6 -5
  267. package/template/.gemini/commands/aios-pm.toml +8 -7
  268. package/template/.gemini/commands/aios-product.toml +5 -3
  269. package/template/.gemini/commands/aios-qa.toml +6 -5
  270. package/template/.gemini/commands/aios-setup.toml +5 -2
  271. package/template/.gemini/commands/aios-sheldon.toml +7 -0
  272. package/template/.gemini/commands/aios-site-forge.toml +7 -0
  273. package/template/.gemini/commands/aios-squad.toml +7 -0
  274. package/template/.gemini/commands/aios-tester.toml +6 -5
  275. package/template/.gemini/commands/aios-ux-ui.toml +8 -7
  276. package/template/.gemini/commands/aios-validator.toml +7 -0
  277. package/template/AGENTS.md +12 -1
  278. package/template/CLAUDE.md +5 -1
  279. package/template/.aioson/locales/en/agents/analyst.md +0 -244
  280. package/template/.aioson/locales/en/agents/architect.md +0 -245
  281. package/template/.aioson/locales/en/agents/dev.md +0 -397
  282. package/template/.aioson/locales/en/agents/deyvin.md +0 -137
  283. package/template/.aioson/locales/en/agents/discovery-design-doc.md +0 -27
  284. package/template/.aioson/locales/en/agents/genome.md +0 -212
  285. package/template/.aioson/locales/en/agents/neo.md +0 -8
  286. package/template/.aioson/locales/en/agents/orache.md +0 -6
  287. package/template/.aioson/locales/en/agents/orchestrator.md +0 -189
  288. package/template/.aioson/locales/en/agents/pair.md +0 -5
  289. package/template/.aioson/locales/en/agents/pm.md +0 -84
  290. package/template/.aioson/locales/en/agents/product.md +0 -378
  291. package/template/.aioson/locales/en/agents/profiler-enricher.md +0 -5
  292. package/template/.aioson/locales/en/agents/profiler-forge.md +0 -5
  293. package/template/.aioson/locales/en/agents/profiler-researcher.md +0 -5
  294. package/template/.aioson/locales/en/agents/qa.md +0 -270
  295. package/template/.aioson/locales/en/agents/setup.md +0 -421
  296. package/template/.aioson/locales/en/agents/sheldon.md +0 -455
  297. package/template/.aioson/locales/en/agents/squad.md +0 -449
  298. package/template/.aioson/locales/en/agents/tester.md +0 -6
  299. package/template/.aioson/locales/en/agents/ux-ui.md +0 -668
  300. package/template/.aioson/locales/es/agents/analyst.md +0 -225
  301. package/template/.aioson/locales/es/agents/architect.md +0 -245
  302. package/template/.aioson/locales/es/agents/dev.md +0 -370
  303. package/template/.aioson/locales/es/agents/deyvin.md +0 -99
  304. package/template/.aioson/locales/es/agents/discovery-design-doc.md +0 -21
  305. package/template/.aioson/locales/es/agents/genome.md +0 -104
  306. package/template/.aioson/locales/es/agents/neo.md +0 -50
  307. package/template/.aioson/locales/es/agents/orache.md +0 -105
  308. package/template/.aioson/locales/es/agents/orchestrator.md +0 -194
  309. package/template/.aioson/locales/es/agents/pair.md +0 -7
  310. package/template/.aioson/locales/es/agents/pm.md +0 -90
  311. package/template/.aioson/locales/es/agents/product.md +0 -372
  312. package/template/.aioson/locales/es/agents/profiler-enricher.md +0 -7
  313. package/template/.aioson/locales/es/agents/profiler-forge.md +0 -7
  314. package/template/.aioson/locales/es/agents/profiler-researcher.md +0 -7
  315. package/template/.aioson/locales/es/agents/qa.md +0 -198
  316. package/template/.aioson/locales/es/agents/setup.md +0 -405
  317. package/template/.aioson/locales/es/agents/sheldon.md +0 -309
  318. package/template/.aioson/locales/es/agents/squad.md +0 -532
  319. package/template/.aioson/locales/es/agents/tester.md +0 -9
  320. package/template/.aioson/locales/es/agents/ux-ui.md +0 -212
  321. package/template/.aioson/locales/fr/agents/analyst.md +0 -225
  322. package/template/.aioson/locales/fr/agents/architect.md +0 -245
  323. package/template/.aioson/locales/fr/agents/dev.md +0 -370
  324. package/template/.aioson/locales/fr/agents/deyvin.md +0 -99
  325. package/template/.aioson/locales/fr/agents/discovery-design-doc.md +0 -21
  326. package/template/.aioson/locales/fr/agents/genome.md +0 -104
  327. package/template/.aioson/locales/fr/agents/neo.md +0 -50
  328. package/template/.aioson/locales/fr/agents/orache.md +0 -106
  329. package/template/.aioson/locales/fr/agents/orchestrator.md +0 -194
  330. package/template/.aioson/locales/fr/agents/pair.md +0 -7
  331. package/template/.aioson/locales/fr/agents/pm.md +0 -90
  332. package/template/.aioson/locales/fr/agents/product.md +0 -372
  333. package/template/.aioson/locales/fr/agents/profiler-enricher.md +0 -7
  334. package/template/.aioson/locales/fr/agents/profiler-forge.md +0 -7
  335. package/template/.aioson/locales/fr/agents/profiler-researcher.md +0 -7
  336. package/template/.aioson/locales/fr/agents/qa.md +0 -198
  337. package/template/.aioson/locales/fr/agents/setup.md +0 -405
  338. package/template/.aioson/locales/fr/agents/sheldon.md +0 -309
  339. package/template/.aioson/locales/fr/agents/squad.md +0 -532
  340. package/template/.aioson/locales/fr/agents/tester.md +0 -9
  341. package/template/.aioson/locales/fr/agents/ux-ui.md +0 -212
  342. package/template/.aioson/locales/pt-BR/agents/analyst.md +0 -319
  343. package/template/.aioson/locales/pt-BR/agents/architect.md +0 -284
  344. package/template/.aioson/locales/pt-BR/agents/dev.md +0 -483
  345. package/template/.aioson/locales/pt-BR/agents/deyvin.md +0 -184
  346. package/template/.aioson/locales/pt-BR/agents/discovery-design-doc.md +0 -198
  347. package/template/.aioson/locales/pt-BR/agents/genome.md +0 -297
  348. package/template/.aioson/locales/pt-BR/agents/neo.md +0 -208
  349. package/template/.aioson/locales/pt-BR/agents/orache.md +0 -137
  350. package/template/.aioson/locales/pt-BR/agents/orchestrator.md +0 -324
  351. package/template/.aioson/locales/pt-BR/agents/pair.md +0 -5
  352. package/template/.aioson/locales/pt-BR/agents/pm.md +0 -182
  353. package/template/.aioson/locales/pt-BR/agents/product.md +0 -466
  354. package/template/.aioson/locales/pt-BR/agents/profiler-enricher.md +0 -5
  355. package/template/.aioson/locales/pt-BR/agents/profiler-forge.md +0 -5
  356. package/template/.aioson/locales/pt-BR/agents/profiler-researcher.md +0 -5
  357. package/template/.aioson/locales/pt-BR/agents/qa.md +0 -300
  358. package/template/.aioson/locales/pt-BR/agents/setup.md +0 -533
  359. package/template/.aioson/locales/pt-BR/agents/sheldon.md +0 -323
  360. package/template/.aioson/locales/pt-BR/agents/squad.md +0 -1330
  361. package/template/.aioson/locales/pt-BR/agents/tester.md +0 -449
  362. package/template/.aioson/locales/pt-BR/agents/ux-ui.md +0 -669
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.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) |
package/template/.aioson/rules/data-format-convention.md CHANGED
@@ -7,104 +7,52 @@ version: 1.0.0
7
7
 
8
8
  # Data Format Convention
9
9
 
10
- Use the right format for the right consumer. The same data structure reads very differently depending on who (or what) will consume it next.
10
+ ## Decision rule (apply in order)
11
11
 
12
- ## The three formats and their consumers
12
+ ```
13
+ Will a machine (CLI, API, webhook, dashboard) consume this? → JSON
14
+ Will human/agent read top-to-bottom as narrative? → Markdown
15
+ Will an agent reference specific fields to make decisions? → YAML
16
+ ```
13
17
 
14
- ### YAML — structured data consumed by agents
18
+ If uncertain: prefer Markdown. Only use YAML when structured fields are the point.
15
19
 
16
- Use `.yaml` when the output is structured reference data that **another agent or squad executor will read field-by-field** to make decisions or produce content.
20
+ ## The three formats
17
21
 
18
- LLMs read YAML more accurately than JSON for structured reference data because YAML allows comments, avoids excessive punctuation, and mirrors natural document structure.
22
+ ### YAML — structured data for agent field-by-field consumption
19
23
 
20
- **Use YAML for:**
21
- - ICP definitions, persona profiles, audience segments
22
- - Offer sheets, product definitions, pricing structures
23
- - Brand guidelines (structured parts: tone, values, vocabulary, positioning)
24
- - Competitive analysis snapshots (structured fields)
25
- - Briefing data that a copy squad or design squad will consume
26
- - Entity catalogs referenced across multiple sessions
24
+ LLMs read YAML more accurately than JSON for reference data (comments allowed, less punctuation).
27
25
 
28
- **Naming:** `{slug}.yaml` in the relevant squad output or context directory.
26
+ Use for: ICP profiles, persona profiles, audience segments, offer sheets, pricing structures, brand guidelines (structured parts), competitive analysis (structured), briefing data for copy/design squads.
29
27
 
30
- **Example — ICP profile (`icp-primary.yaml`):**
28
+ **Example (`icp-primary.yaml`):**
31
29
  ```yaml
32
- # ICP — Primary Audience
33
- # Created by: @research-squad | Updated: 2026-04-02
34
-
35
30
  profile:
36
31
  name: "Empreendedor Refém"
37
32
  description: "Dono de negócio que depende de agências ou devs externos"
38
-
39
33
  pain_points:
40
34
  - Perda de controle sobre o produto
41
35
  - Atrasos e custos imprevisíveis
42
- - Não consegue validar qualidade do que recebe
43
-
44
- desired_outcome: "Autonomia e velocidade — entregar sem depender de terceiros"
45
-
36
+ desired_outcome: "Autonomia e velocidade"
46
37
  buying_trigger: "Prazo vencendo ou fatura chegando de dev que atrasou"
47
-
48
38
  messaging:
49
39
  primary: "Retome o controle do seu produto"
50
- objection_1: "Não preciso saber programar?"
51
- objection_1_answer: "Não. Você vai orquestrar, não digitar código."
52
-
53
40
  channels: [instagram, linkedin, youtube]
54
41
  ```
55
42
 
56
- ---
43
+ ### Markdown — narrative for humans and linear agent reading
57
44
 
58
- ### Markdown — narrative content consumed by humans and agents linearly
45
+ Use for: reports, analyses, article drafts, scripts, agent instructions, specs, PRDs, discovery docs, README files, any output read top-to-bottom.
59
46
 
60
- Use `.md` when the output is narrative — content that flows as text and benefits from headers, lists, and prose.
47
+ Never use YAML or JSON for: articles, scripts, agent instructions, PRDs, analysis narratives.
61
48
 
62
- **Use Markdown for:**
63
- - Reports, analyses, article drafts
64
- - Scripts, hooks, copy blocks
65
- - Agent instructions and rules (this file is an example)
66
- - Specs, PRDs, discovery documents
67
- - Any output meant to be read from top to bottom
49
+ ### JSON — structured data for machine consumption
68
50
 
69
- **Never use YAML or JSON for:** articles, scripts, agent instructions, PRDs, analysis narratives, README files.
51
+ Use for: `squad.manifest.json`, `content.json`, API payloads, webhook responses, CLI config files.
70
52
 
71
- ---
72
-
73
- ### JSON — structured data consumed by machines
74
-
75
- Use `.json` when the output is consumed by code — CLIs, APIs, webhooks, dashboards, or configuration parsers.
76
-
77
- **Use JSON for:**
78
- - `squad.manifest.json` — consumed by the AIOSON CLI and dashboard
79
- - `content.json` — consumed by the webhook server and dashboard
80
- - API payloads and webhook responses
81
- - CLI configuration files
82
- - Any file that `JSON.parse()` will read programmatically
53
+ Never change to YAML: `squad.manifest.json`, `content.json`, `squad.json`, `aioson-models.json` — machine-consumed, must stay JSON for CLI compatibility.
83
54
 
84
- **Never change to YAML:** `squad.manifest.json`, `content.json`, `squad.json`, `aioson-models.json`. These are machine-consumed and must stay JSON for CLI compatibility.
85
-
86
- ---
87
-
88
- ## Decision rule (apply in this order)
89
-
90
- ```
91
- Will a machine (CLI, API, webhook, dashboard) consume this file?
92
- YES → JSON
93
-
94
- Will a human or agent read this top-to-bottom as narrative?
95
- YES → Markdown
96
-
97
- Will an agent reference specific fields to make decisions or produce content?
98
- YES → YAML
99
- ```
100
-
101
- If uncertain: prefer Markdown. Only use YAML when the structured fields are the point — not the prose.
102
-
103
- ---
104
-
105
- ## Squad executor guidance
106
-
107
- When a squad executor produces output, choose the format based on what happens next:
55
+ ## Squad executor output format
108
56
 
109
57
  | Output type | Format | Example |
110
58
  |---|---|---|
@@ -116,21 +64,11 @@ When a squad executor produces output, choose the format based on what happens n
116
64
  | Webhook payload, API response | `.json` | handled by `content.json` convention |
117
65
  | Squad manifest, config | `.json` | `squad.manifest.json` (do not change) |
118
66
 
119
- **Cross-squad consumption:** when Squad A produces data that Squad B will consume, prefer YAML for structured reference data. The receiving squad's executor can reference `output/squad-a/{file}.yaml` directly and access fields with precision — more reliable than parsing a Markdown table.
120
-
121
- ---
67
+ **Cross-squad consumption:** when Squad A produces data for Squad B, prefer YAML for structured reference — more reliable than parsing a Markdown table.
122
68
 
123
69
  ## What NOT to change
124
70
 
125
- - Files with `.json` extension consumed by the AIOSON CLI or dashboard
71
+ - `.json` files consumed by AIOSON CLI or dashboard
126
72
  - Agent instruction files (`agents/*.md`) — narrative, not data
127
- - Existing specs and context files (`spec-*.md`, `discovery.md`, `architecture.md`) — mixed narrative + structure, Markdown is correct
128
- - YAML frontmatter inside `.md` files — this is already the right pattern for metadata
129
-
130
- ---
131
-
132
- ## Why this matters
133
-
134
- The same structured content stored as JSON or Markdown loses precision when an agent reads it. A JSON blob requires the agent to mentally parse brackets and quotes while tracking field relationships. A Markdown table requires the agent to infer column semantics from headers. A YAML document makes field names, nesting, and relationships immediately legible — the LLM spends its attention on the content, not the syntax.
135
-
136
- For squads that pass structured data between executors across sessions, this compounds: each session starts fresh, and a YAML profile loads faster and more accurately into working context than an equivalent JSON or Markdown representation.
73
+ - Existing specs and context files — Markdown is correct
74
+ - YAML frontmatter inside `.md` files
package/template/.aioson/rules/disk-first-artifacts.md ADDED
@@ -0,0 +1,44 @@
1
+ ---
2
+ name: disk-first-artifacts
3
+ description: Todo artefato gerado por um agente deve ser gravado em disco antes do fim da sessão — nunca apenas exibido no chat
4
+ priority: 10
5
+ version: 1.0.0
6
+ ---
7
+
8
+ # Disk-First: Artifacts Always on Disk
9
+
10
+ Every artifact produced by an AIOSON agent MUST be written to disk before session end. Showing in chat does not count as delivery — the next agent starts without context and the work is lost.
11
+
12
+ ## Mandatory artifacts by agent
13
+
14
+ | Agent | Mandatory artifact | Path |
15
+ |---|---|---|
16
+ | `@product` | PRD | `.aioson/context/prd.md` or `prd-{slug}.md` |
17
+ | `@product` | features.md | `.aioson/context/features.md` |
18
+ | `@analyst` | Discovery | `.aioson/context/discovery.md` |
19
+ | `@analyst` | Requirements | `.aioson/context/requirements-{slug}.md` |
20
+ | `@architect` | Architecture | `.aioson/context/architecture.md` |
21
+ | `@ux-ui` | UI Spec | `.aioson/context/ui-spec-{slug}.md` |
22
+ | `@sheldon` | Manifest | `.aioson/plans/{slug}/manifest.md` |
23
+ | `@pm` | Implementation Plan | `.aioson/context/implementation-plan-{slug}.md` |
24
+ | `@dev` | Feature spec | `.aioson/context/spec-{slug}.md` |
25
+ | `@qa` | QA report | `.aioson/context/qa-report-{slug}.md` |
26
+ | `@squad` | Squad manifest | `.aioson/squads/{slug}/squad.manifest.json` |
27
+ | `@squad` | Agent prompts | `.aioson/squads/{slug}/agents/{agent}.md` |
28
+
29
+ ## Correct delivery pattern
30
+
31
+ ```
32
+ ✅ Write artifact to disk → inform user of path.
33
+ ❌ Show in chat → ask "Can I save?" → Do NOT do this.
34
+ ```
35
+
36
+ Exceptions: drafts shown mid-session for validation (before final save), artifacts explicitly cancelled by user.
37
+
38
+ `project-pulse.md` must be updated at session end regardless of other artifacts.
39
+
40
+ ## On violation detected
41
+
42
+ 1. Write the artifact before closing — never defer to next session.
43
+ 2. If content was shown in chat, use it to write the file now.
44
+ 3. Update `project-pulse.md`.