@jaimevalasek/aioson 1.5.1 → 1.7.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 (341) hide show
  1. package/CHANGELOG.md +49 -0
  2. package/README.md +729 -226
  3. package/docs/design-previews/aurora-command-ui-website.html +884 -0
  4. package/docs/design-previews/aurora-command-ui.html +682 -0
  5. package/docs/design-previews/bold-editorial-ui-website.html +658 -0
  6. package/docs/design-previews/bold-editorial-ui.html +717 -0
  7. package/docs/design-previews/clean-saas-ui-website.html +1202 -0
  8. package/docs/design-previews/clean-saas-ui.html +549 -0
  9. package/docs/design-previews/cognitive-core-ui-website.html +1009 -0
  10. package/docs/design-previews/cognitive-core-ui.html +463 -0
  11. package/docs/design-previews/glassmorphism-ui-website.html +572 -0
  12. package/docs/design-previews/glassmorphism-ui.html +886 -0
  13. package/docs/design-previews/index.html +699 -0
  14. package/docs/design-previews/interface-design-website.html +1187 -0
  15. package/docs/design-previews/interface-design.html +513 -0
  16. package/docs/design-previews/neo-brutalist-ui-website.html +621 -0
  17. package/docs/design-previews/neo-brutalist-ui.html +797 -0
  18. package/docs/design-previews/premium-command-center-ui-website.html +1217 -0
  19. package/docs/design-previews/premium-command-center-ui.html +552 -0
  20. package/docs/design-previews/pt.squarespace.com-homepage.html +889 -0
  21. package/docs/design-previews/warm-craft-ui-website.html +684 -0
  22. package/docs/design-previews/warm-craft-ui.html +739 -0
  23. package/docs/en/cli-reference.md +20 -9
  24. package/docs/integrations/sdlc-genius-boundary.md +76 -0
  25. package/docs/integrations/sdlc-genius-eval-matrix.md +75 -0
  26. package/docs/integrations/sdlc-genius-install-checklist.md +93 -0
  27. package/docs/integrations/sdlc-genius-review-samples.md +86 -0
  28. package/docs/pt/README.md +10 -0
  29. package/docs/pt/agent-sharding.md +132 -0
  30. package/docs/pt/agentes.md +9 -2
  31. package/docs/pt/busca-de-contexto.md +129 -0
  32. package/docs/pt/cache-de-contexto.md +156 -0
  33. package/docs/pt/comandos-cli.md +915 -1
  34. package/docs/pt/design-hybrid-forge.md +356 -0
  35. package/docs/pt/devlog-pipeline.md +270 -0
  36. package/docs/pt/fluxo-artefatos.md +178 -0
  37. package/docs/pt/hooks-session-guard.md +454 -0
  38. package/docs/pt/inicio-rapido.md +54 -3
  39. package/docs/pt/inteligencia-adaptativa.md +324 -0
  40. package/docs/pt/monitor-de-contexto.md +158 -0
  41. package/docs/pt/recuperacao-de-sessao.md +125 -0
  42. package/docs/pt/sandbox.md +125 -0
  43. package/docs/pt/sdd-automation-scripts.md +557 -0
  44. package/docs/pt/site-forge.md +309 -0
  45. package/docs/pt/skills.md +98 -6
  46. package/docs/pt/spec-learnings-pipeline.md +265 -0
  47. package/package.json +1 -1
  48. package/src/a2a/client.js +165 -0
  49. package/src/a2a/server.js +223 -0
  50. package/src/agent-loader.js +280 -0
  51. package/src/cli.js +329 -1
  52. package/src/commands/agent-audit.js +397 -0
  53. package/src/commands/agent-export-skill.js +229 -0
  54. package/src/commands/agent-loader.js +85 -0
  55. package/src/commands/artifact-validate.js +189 -0
  56. package/src/commands/brief-gen.js +405 -0
  57. package/src/commands/brief-validate.js +65 -0
  58. package/src/commands/classify.js +256 -0
  59. package/src/commands/context-cache.js +90 -0
  60. package/src/commands/context-compact.js +49 -0
  61. package/src/commands/context-health.js +175 -0
  62. package/src/commands/context-monitor.js +163 -0
  63. package/src/commands/context-search.js +66 -0
  64. package/src/commands/context-trim.js +177 -0
  65. package/src/commands/design-hybrid-options.js +385 -0
  66. package/src/commands/detect-test-runner.js +55 -0
  67. package/src/commands/devlog-export-brains.js +27 -0
  68. package/src/commands/devlog-process.js +292 -0
  69. package/src/commands/devlog-watch.js +131 -0
  70. package/src/commands/feature-close.js +165 -0
  71. package/src/commands/gate-check.js +228 -0
  72. package/src/commands/health.js +214 -0
  73. package/src/commands/hooks-emit.js +253 -0
  74. package/src/commands/hooks-install.js +347 -0
  75. package/src/commands/init.js +54 -13
  76. package/src/commands/install.js +52 -13
  77. package/src/commands/learning-auto-promote.js +195 -0
  78. package/src/commands/learning-evolve.js +364 -0
  79. package/src/commands/learning-export.js +103 -0
  80. package/src/commands/learning-rollback.js +164 -0
  81. package/src/commands/live.js +59 -1
  82. package/src/commands/pattern-detect.js +33 -0
  83. package/src/commands/preflight-context.js +30 -0
  84. package/src/commands/preflight.js +208 -0
  85. package/src/commands/pulse-update.js +130 -0
  86. package/src/commands/recovery.js +43 -0
  87. package/src/commands/runner-daemon.js +274 -0
  88. package/src/commands/runner-plan.js +70 -0
  89. package/src/commands/runner-queue-from-plan.js +166 -0
  90. package/src/commands/runner-queue.js +189 -0
  91. package/src/commands/runner-run.js +129 -0
  92. package/src/commands/runtime.js +47 -1
  93. package/src/commands/sandbox.js +37 -0
  94. package/src/commands/self-implement-loop.js +256 -0
  95. package/src/commands/session-guard.js +218 -0
  96. package/src/commands/setup-context.js +22 -2
  97. package/src/commands/setup.js +178 -0
  98. package/src/commands/sizing.js +165 -0
  99. package/src/commands/skill.js +144 -32
  100. package/src/commands/spec-checkpoint.js +177 -0
  101. package/src/commands/spec-status.js +79 -0
  102. package/src/commands/spec-sync.js +190 -0
  103. package/src/commands/spec-tasks.js +288 -0
  104. package/src/commands/squad-autorun.js +1220 -0
  105. package/src/commands/squad-bus.js +217 -0
  106. package/src/commands/squad-card.js +149 -0
  107. package/src/commands/squad-daemon.js +134 -0
  108. package/src/commands/squad-dependency-graph.js +164 -0
  109. package/src/commands/squad-review.js +106 -0
  110. package/src/commands/squad-scaffold.js +55 -0
  111. package/src/commands/squad-tool-register.js +157 -0
  112. package/src/commands/state-save.js +122 -0
  113. package/src/commands/tool-registry-cmd.js +232 -0
  114. package/src/commands/update.js +9 -0
  115. package/src/commands/verify-gate.js +572 -0
  116. package/src/commands/workflow-execute.js +241 -0
  117. package/src/constants.js +18 -0
  118. package/src/context-cache.js +159 -0
  119. package/src/context-search.js +326 -0
  120. package/src/design-variation-catalog.js +503 -0
  121. package/src/i18n/messages/en.js +32 -2
  122. package/src/i18n/messages/es.js +30 -2
  123. package/src/i18n/messages/fr.js +30 -2
  124. package/src/i18n/messages/pt-BR.js +32 -2
  125. package/src/install-animation.js +260 -0
  126. package/src/install-profile.js +143 -0
  127. package/src/install-wizard.js +475 -0
  128. package/src/installer.js +44 -10
  129. package/src/lib/health-check.js +158 -0
  130. package/src/lib/hook-protocol.js +76 -0
  131. package/src/mcp/apps/squad-dashboard/app.js +163 -0
  132. package/src/mcp/apps/squad-dashboard/index.html +261 -0
  133. package/src/mcp/apps/squad-dashboard/mcp-manifest.json +23 -0
  134. package/src/mcp/resources/squad-state.js +130 -0
  135. package/src/parser.js +7 -1
  136. package/src/preflight-engine.js +443 -0
  137. package/src/recovery-context-session.js +154 -0
  138. package/src/runner/cascade.js +97 -0
  139. package/src/runner/cli-launcher.js +109 -0
  140. package/src/runner/plan-importer.js +63 -0
  141. package/src/runner/queue-store.js +159 -0
  142. package/src/runtime-store.js +158 -4
  143. package/src/sandbox.js +177 -0
  144. package/src/squad/agent-teams-adapter.js +264 -0
  145. package/src/squad/brief-validator.js +350 -0
  146. package/src/squad/bus-bridge.js +140 -0
  147. package/src/squad/context-compactor.js +265 -0
  148. package/src/squad/cross-ai-synthesizer.js +250 -0
  149. package/src/squad/hooks-generator.js +196 -0
  150. package/src/squad/inter-squad-events.js +175 -0
  151. package/src/squad/intra-bus.js +345 -0
  152. package/src/squad/learning-extractor.js +213 -0
  153. package/src/squad/pattern-detector.js +365 -0
  154. package/src/squad/preflight-context.js +296 -0
  155. package/src/squad/recovery-context.js +242 -71
  156. package/src/squad/reflection.js +365 -0
  157. package/src/squad/squad-scaffold.js +177 -0
  158. package/src/squad/state-manager.js +310 -0
  159. package/src/squad/task-decomposer.js +652 -0
  160. package/src/squad/verify-gate.js +303 -0
  161. package/src/tool-executor.js +94 -0
  162. package/src/updater.js +10 -3
  163. package/src/worker-runner.js +186 -1
  164. package/template/.aioson/agents/analyst.md +119 -3
  165. package/template/.aioson/agents/architect.md +98 -0
  166. package/template/.aioson/agents/design-hybrid-forge.md +141 -0
  167. package/template/.aioson/agents/dev.md +335 -14
  168. package/template/.aioson/agents/deyvin.md +117 -2
  169. package/template/.aioson/agents/discovery-design-doc.md +44 -0
  170. package/template/.aioson/agents/genome.md +14 -0
  171. package/template/.aioson/agents/neo.md +78 -1
  172. package/template/.aioson/agents/orache.md +50 -4
  173. package/template/.aioson/agents/orchestrator.md +197 -1
  174. package/template/.aioson/agents/pm.md +93 -0
  175. package/template/.aioson/agents/product.md +77 -4
  176. package/template/.aioson/agents/profiler-enricher.md +14 -0
  177. package/template/.aioson/agents/profiler-forge.md +14 -0
  178. package/template/.aioson/agents/profiler-researcher.md +14 -0
  179. package/template/.aioson/agents/qa.md +249 -19
  180. package/template/.aioson/agents/setup.md +144 -12
  181. package/template/.aioson/agents/sheldon.md +237 -11
  182. package/template/.aioson/agents/site-forge.md +1753 -0
  183. package/template/.aioson/agents/squad.md +162 -0
  184. package/template/.aioson/agents/tester.md +209 -0
  185. package/template/.aioson/agents/ux-ui.md +34 -1
  186. package/template/.aioson/brains/README.md +128 -0
  187. package/template/.aioson/brains/_index.json +16 -0
  188. package/template/.aioson/brains/scripts/query.js +103 -0
  189. package/template/.aioson/brains/site-forge/visual-patterns.brain.json +205 -0
  190. package/template/.aioson/config.md +158 -13
  191. package/template/.aioson/constitution.md +33 -0
  192. package/template/.aioson/context/forensics/.gitkeep +0 -0
  193. package/template/.aioson/context/project-pulse.md +34 -0
  194. package/template/.aioson/context/seeds/seed-example.md +27 -0
  195. package/template/.aioson/context/user-profile.md +42 -0
  196. package/template/.aioson/docs/LAYERS.md +79 -0
  197. package/template/.aioson/docs/README.md +76 -0
  198. package/template/.aioson/docs/example-external-api-context.md +72 -0
  199. package/template/.aioson/locales/en/agents/architect.md +17 -0
  200. package/template/.aioson/locales/en/agents/dev.md +79 -13
  201. package/template/.aioson/locales/en/agents/orache.md +6 -0
  202. package/template/.aioson/locales/en/agents/orchestrator.md +24 -0
  203. package/template/.aioson/locales/en/agents/product.md +50 -0
  204. package/template/.aioson/locales/en/agents/setup.md +33 -1
  205. package/template/.aioson/locales/en/agents/sheldon.md +115 -0
  206. package/template/.aioson/locales/en/agents/squad.md +14 -0
  207. package/template/.aioson/locales/en/agents/tester.md +6 -0
  208. package/template/.aioson/locales/es/agents/analyst.md +2 -0
  209. package/template/.aioson/locales/es/agents/architect.md +19 -0
  210. package/template/.aioson/locales/es/agents/dev.md +64 -4
  211. package/template/.aioson/locales/es/agents/deyvin.md +2 -0
  212. package/template/.aioson/locales/es/agents/discovery-design-doc.md +2 -0
  213. package/template/.aioson/locales/es/agents/genome.md +2 -0
  214. package/template/.aioson/locales/es/agents/neo.md +2 -0
  215. package/template/.aioson/locales/es/agents/orache.md +2 -0
  216. package/template/.aioson/locales/es/agents/orchestrator.md +26 -0
  217. package/template/.aioson/locales/es/agents/pair.md +2 -0
  218. package/template/.aioson/locales/es/agents/pm.md +2 -0
  219. package/template/.aioson/locales/es/agents/product.md +52 -0
  220. package/template/.aioson/locales/es/agents/profiler-enricher.md +2 -0
  221. package/template/.aioson/locales/es/agents/profiler-forge.md +2 -0
  222. package/template/.aioson/locales/es/agents/profiler-researcher.md +2 -0
  223. package/template/.aioson/locales/es/agents/qa.md +2 -0
  224. package/template/.aioson/locales/es/agents/setup.md +35 -1
  225. package/template/.aioson/locales/es/agents/sheldon.md +117 -0
  226. package/template/.aioson/locales/es/agents/squad.md +16 -0
  227. package/template/.aioson/locales/es/agents/tester.md +9 -0
  228. package/template/.aioson/locales/es/agents/ux-ui.md +2 -0
  229. package/template/.aioson/locales/fr/agents/analyst.md +2 -0
  230. package/template/.aioson/locales/fr/agents/architect.md +19 -0
  231. package/template/.aioson/locales/fr/agents/dev.md +64 -4
  232. package/template/.aioson/locales/fr/agents/deyvin.md +2 -0
  233. package/template/.aioson/locales/fr/agents/discovery-design-doc.md +2 -0
  234. package/template/.aioson/locales/fr/agents/genome.md +2 -0
  235. package/template/.aioson/locales/fr/agents/neo.md +2 -0
  236. package/template/.aioson/locales/fr/agents/orache.md +2 -0
  237. package/template/.aioson/locales/fr/agents/orchestrator.md +26 -0
  238. package/template/.aioson/locales/fr/agents/pair.md +2 -0
  239. package/template/.aioson/locales/fr/agents/pm.md +2 -0
  240. package/template/.aioson/locales/fr/agents/product.md +52 -0
  241. package/template/.aioson/locales/fr/agents/profiler-enricher.md +2 -0
  242. package/template/.aioson/locales/fr/agents/profiler-forge.md +2 -0
  243. package/template/.aioson/locales/fr/agents/profiler-researcher.md +2 -0
  244. package/template/.aioson/locales/fr/agents/qa.md +2 -0
  245. package/template/.aioson/locales/fr/agents/setup.md +35 -1
  246. package/template/.aioson/locales/fr/agents/sheldon.md +117 -0
  247. package/template/.aioson/locales/fr/agents/squad.md +16 -0
  248. package/template/.aioson/locales/fr/agents/tester.md +9 -0
  249. package/template/.aioson/locales/fr/agents/ux-ui.md +2 -0
  250. package/template/.aioson/locales/pt-BR/agents/analyst.md +64 -3
  251. package/template/.aioson/locales/pt-BR/agents/architect.md +42 -0
  252. package/template/.aioson/locales/pt-BR/agents/dev.md +147 -14
  253. package/template/.aioson/locales/pt-BR/agents/deyvin.md +47 -0
  254. package/template/.aioson/locales/pt-BR/agents/neo.md +62 -1
  255. package/template/.aioson/locales/pt-BR/agents/orchestrator.md +158 -2
  256. package/template/.aioson/locales/pt-BR/agents/pm.md +95 -1
  257. package/template/.aioson/locales/pt-BR/agents/product.md +145 -18
  258. package/template/.aioson/locales/pt-BR/agents/qa.md +16 -0
  259. package/template/.aioson/locales/pt-BR/agents/setup.md +134 -19
  260. package/template/.aioson/locales/pt-BR/agents/sheldon.md +132 -1
  261. package/template/.aioson/locales/pt-BR/agents/squad.md +14 -0
  262. package/template/.aioson/locales/pt-BR/agents/tester.md +449 -0
  263. package/template/.aioson/rules/README.md +69 -0
  264. package/template/.aioson/rules/data-format-convention.md +136 -0
  265. package/template/.aioson/rules/example-monetary-values.md +30 -0
  266. package/template/.aioson/schemas/squad-manifest.schema.json +124 -3
  267. package/template/.aioson/skills/design/aurora-command-ui/SKILL.md +243 -0
  268. package/template/.aioson/skills/design/aurora-command-ui/references/art-direction.md +293 -0
  269. package/template/.aioson/skills/design/aurora-command-ui/references/components.md +827 -0
  270. package/template/.aioson/skills/design/aurora-command-ui/references/dashboards.md +250 -0
  271. package/template/.aioson/skills/design/aurora-command-ui/references/design-tokens.md +585 -0
  272. package/template/.aioson/skills/design/aurora-command-ui/references/motion.md +365 -0
  273. package/template/.aioson/skills/design/aurora-command-ui/references/patterns.md +482 -0
  274. package/template/.aioson/skills/design/aurora-command-ui/references/websites.md +387 -0
  275. package/template/.aioson/skills/design/glassmorphism-ui/SKILL.md +222 -0
  276. package/template/.aioson/skills/design/glassmorphism-ui/references/art-direction.md +159 -0
  277. package/template/.aioson/skills/design/glassmorphism-ui/references/components.md +498 -0
  278. package/template/.aioson/skills/design/glassmorphism-ui/references/dashboards.md +236 -0
  279. package/template/.aioson/skills/design/glassmorphism-ui/references/design-tokens.md +274 -0
  280. package/template/.aioson/skills/design/glassmorphism-ui/references/motion.md +355 -0
  281. package/template/.aioson/skills/design/glassmorphism-ui/references/patterns.md +198 -0
  282. package/template/.aioson/skills/design/glassmorphism-ui/references/websites.md +307 -0
  283. package/template/.aioson/skills/design/neo-brutalist-ui/SKILL.md +213 -0
  284. package/template/.aioson/skills/design/neo-brutalist-ui/references/art-direction.md +228 -0
  285. package/template/.aioson/skills/design/neo-brutalist-ui/references/components.md +855 -0
  286. package/template/.aioson/skills/design/neo-brutalist-ui/references/dashboards.md +334 -0
  287. package/template/.aioson/skills/design/neo-brutalist-ui/references/design-tokens.md +342 -0
  288. package/template/.aioson/skills/design/neo-brutalist-ui/references/motion.md +286 -0
  289. package/template/.aioson/skills/design/neo-brutalist-ui/references/patterns.md +458 -0
  290. package/template/.aioson/skills/design/neo-brutalist-ui/references/websites.md +723 -0
  291. package/template/.aioson/skills/design/pt.squarespace.com/.skill-meta.json +31 -0
  292. package/template/.aioson/skills/design/pt.squarespace.com/SKILL.md +66 -0
  293. package/template/.aioson/skills/design/pt.squarespace.com/references/components.md +368 -0
  294. package/template/.aioson/skills/design/pt.squarespace.com/references/design-tokens.md +150 -0
  295. package/template/.aioson/skills/design/pt.squarespace.com/references/motion.md +270 -0
  296. package/template/.aioson/skills/design/pt.squarespace.com/references/patterns.md +189 -0
  297. package/template/.aioson/skills/design/pt.squarespace.com/references/websites.md +165 -0
  298. package/template/.aioson/skills/process/aioson-spec-driven/SKILL.md +46 -0
  299. package/template/.aioson/skills/process/aioson-spec-driven/references/analyst.md +30 -0
  300. package/template/.aioson/skills/process/aioson-spec-driven/references/approval-gates.md +109 -0
  301. package/template/.aioson/skills/process/aioson-spec-driven/references/architect.md +23 -0
  302. package/template/.aioson/skills/process/aioson-spec-driven/references/artifact-map.md +44 -0
  303. package/template/.aioson/skills/process/aioson-spec-driven/references/classification-map.md +37 -0
  304. package/template/.aioson/skills/process/aioson-spec-driven/references/dev.md +47 -0
  305. package/template/.aioson/skills/process/aioson-spec-driven/references/deyvin.md +27 -0
  306. package/template/.aioson/skills/process/aioson-spec-driven/references/hardening-lane.md +49 -0
  307. package/template/.aioson/skills/process/aioson-spec-driven/references/maintenance-and-state.md +101 -0
  308. package/template/.aioson/skills/process/aioson-spec-driven/references/product.md +25 -0
  309. package/template/.aioson/skills/process/aioson-spec-driven/references/qa.md +30 -0
  310. package/template/.aioson/skills/process/aioson-spec-driven/references/sheldon.md +25 -0
  311. package/template/.aioson/skills/process/aioson-spec-driven/references/ui-language.md +75 -0
  312. package/template/.aioson/skills/process/design-hybrid-forge/SKILL.md +147 -0
  313. package/template/.aioson/skills/process/design-hybrid-forge/references/crossover-protocol.md +221 -0
  314. package/template/.aioson/skills/process/design-hybrid-forge/references/naming-registry.md +88 -0
  315. package/template/.aioson/skills/process/design-hybrid-forge/references/output-contract.md +306 -0
  316. package/template/.aioson/skills/process/design-hybrid-forge/references/pair-compatibility.md +149 -0
  317. package/template/.aioson/skills/process/design-hybrid-forge/references/quality-gates.md +208 -0
  318. package/template/.aioson/skills/process/design-hybrid-forge/references/variation-library.md +125 -0
  319. package/template/.aioson/skills/process/simplify/SKILL.md +173 -0
  320. package/template/.aioson/skills/static/context-budget-guide.md +46 -0
  321. package/template/.aioson/skills/static/harness-sensors.md +74 -0
  322. package/template/.aioson/skills/static/multi-agent-patterns.md +43 -0
  323. package/template/.aioson/skills/static/react-motion-patterns.md +22 -0
  324. package/template/.aioson/skills/static/static-html-patterns/checklists.md +43 -0
  325. package/template/.aioson/skills/static/static-html-patterns/css-tokens.md +609 -0
  326. package/template/.aioson/skills/static/static-html-patterns/motion.md +193 -0
  327. package/template/.aioson/skills/static/static-html-patterns/premium.md +711 -0
  328. package/template/.aioson/skills/static/static-html-patterns/structure.md +209 -0
  329. package/template/.aioson/skills/static/static-html-patterns/utilities.md +190 -0
  330. package/template/.aioson/skills/static/static-html-patterns.md +58 -1913
  331. package/template/.aioson/skills/static/threejs-patterns.md +929 -0
  332. package/template/.aioson/skills/static/web-research-cache.md +112 -0
  333. package/template/.aioson/tasks/implementation-plan.md +21 -1
  334. package/template/.claude/commands/aioson/agent/design-hybrid-forge.md +5 -0
  335. package/template/.claude/commands/aioson/agent/orache.md +5 -0
  336. package/template/.claude/commands/aioson/agent/sheldon.md +5 -0
  337. package/template/.claude/commands/aioson/agent/site-forge.md +5 -0
  338. package/template/AGENTS.md +75 -1
  339. package/template/CLAUDE.md +31 -0
  340. package/template/OPENCODE.md +4 -0
  341. package/template/researchs/.gitkeep +0 -0
@@ -5,6 +5,39 @@
5
5
  ## Mission
6
6
  Implementer les fonctionnalites selon l'architecture, en preservant les conventions du stack et la simplicite du projet.
7
7
 
8
+ ## Protocole de debut de session (EXECUTER EN PREMIER — avant de lire quoi que ce soit)
9
+
10
+ **Etape 1 — Verifier dev-state :**
11
+ Lire `.aioson/context/dev-state.md` s'il existe.
12
+
13
+ **dev-state.md trouve :**
14
+ - Il contient le `context_package` exact (max 2–4 fichiers) pour la tache actuelle.
15
+ - Charger UNIQUEMENT ces fichiers. Rien d'autre.
16
+ - Demarrer le `next_step` immediatement — sans exploration, sans discovery pass.
17
+
18
+ **dev-state.md NON trouve (cold start) :**
19
+ - Lire uniquement : `project.context.md` + `features.md` (si present). S'arreter la.
20
+ - Demander : "Sur quelle feature ou tache dois-je travailler ?"
21
+ - Une fois que l'utilisateur specifie → deriver le package de contexte minimum et charger uniquement ca.
22
+
23
+ **Package de contexte minimum par mode :**
24
+
25
+ | Mode | Charger — rien de plus |
26
+ |------|------------------------|
27
+ | Feature MICRO | `project.context.md` + `prd-{slug}.md` |
28
+ | Feature SMALL/MEDIUM | `project.context.md` + `spec-{slug}.md` + `implementation-plan-{slug}.md` |
29
+ | Feature avec plan Sheldon | `project.context.md` + `spec-{slug}.md` + `.aioson/plans/{slug}/manifest.md` + fichier de phase actuelle |
30
+ | Mode projet | `project.context.md` + `spec.md` + `skeleton-system.md` |
31
+
32
+ **REGLE ABSOLUE — NE JAMAIS CHARGER (sans exceptions) :**
33
+ - Tout fichier dans `.aioson/agents/` — les fichiers d'agents ne sont jamais votre contexte
34
+ - `spec-{autre-slug}.md` — specs de features sur lesquelles vous ne travaillez PAS
35
+ - `discovery.md` ou `architecture.md` sauf si le plan actif les liste explicitement
36
+ - PRDs de features deja marquees `done` dans `features.md`
37
+ - Plus de 5 fichiers avant d'ecrire le premier changement de code
38
+
39
+ Enfreindre cette regle = surcharge de contexte = output degrade. Si vous avez lu 5 fichiers sans ecrire de code : arretez, listez ce que vous avez lu et pourquoi, demandez a l'utilisateur sur quoi se concentrer.
40
+
8
41
  ## Detection du mode feature
9
42
 
10
43
  Verifier si un fichier `prd-{slug}.md` existe dans `.aioson/context/` avant de lire quoi que ce soit.
@@ -61,10 +94,10 @@ Verifier egalement `.aioson/plans/{slug}/manifest.md` avant toute implementation
61
94
  **Si le plan N'EXISTE PAS MAIS les prerequis existent :**
62
95
  Prerequis = `architecture.md` (SMALL/MEDIUM) ou au moins un `prd.md`/`prd-{slug}.md`/`readiness.md`.
63
96
 
64
- - Dites a l'utilisateur : "J'ai trouve des artefacts de spec mais aucun plan d'implementation. En generer un d'abord ameliorera la qualite et la sequence. Dois-je le creer ?"
65
- - Si oui executez `.aioson/tasks/implementation-plan.md`
66
- - Si non → procedez avec le flux standard (pas de blocage — juste une recommandation)
67
- - NE demandez PAS de maniere repetee si l'utilisateur a deja refuse dans cette session
97
+ - Dites a l'utilisateur : "J'ai trouve des artefacts de spec mais aucun plan d'implementation les plans sont crees par `@product` (pour les nouvelles features) ou `@sheldon` (pour le travail par phases). Activez l'un d'eux pour generer le plan avant d'implementer."
98
+ - NE creez PAS le plan vous-meme.
99
+ - Si l'utilisateur dit explicitement de proceder sans plan → procedez avec le flux standard.
100
+ - NE demandez PAS de maniere repetee si l'utilisateur a deja decide de proceder sans plan.
68
101
 
69
102
  **Exception pour les projets MICRO :**
70
103
  - Pour les projets MICRO, un plan d'implementation est OPTIONNEL
@@ -243,6 +276,31 @@ Pour les stacks non listees ci-dessus, appliquer les memes principes de separati
243
276
  - Suivre les conventions propres au framework — verifier `.aioson/skills/static/` pour les skills disponibles.
244
277
  - Si aucun skill n'existe pour le stack, appliquer le pattern general et documenter les deviations dans architecture.md.
245
278
 
279
+ ## Memoire de travail (liste de taches)
280
+
281
+ Utiliser les outils natifs de tasks pour suivre la progression dans la session :
282
+ - `TaskCreate` — enregistrer chaque slice d'implementation avant de commencer
283
+ - `TaskUpdate (in_progress)` — marquer au debut d'un slice
284
+ - `TaskUpdate (completed)` — marquer a la fin, inclure un resume d'une ligne
285
+ - `TaskList` — verifier avant de demarrer un nouveau slice pour eviter les doublons
286
+
287
+ La liste de tasks est le registre autoritatif de progression de la session.
288
+ Ecrire dans `dev-state.md` uniquement comme resume lisible persistant a la fin.
289
+
290
+ ## Planification auto-dirigee
291
+
292
+ Avant d'implementer tout slice ambigu, multi-fichier ou touchant plus de 2 modules :
293
+
294
+ 1. **Declarer** : `[PLANNING MODE — pas encore en execution]`
295
+ 2. **Lister** tous les fichiers qui seront touches et pourquoi
296
+ 3. **Sequencer** les etapes d'implementation
297
+ 4. **Identifier** les criteres de verification (ce qui prouve que c'est correct)
298
+ 5. **Sortir** : `[EXECUTION MODE — debut de l'implementation]`
299
+
300
+ Quitter le mode planification seulement quand : perimetre clair, sequence definie, criteres de verification ecrits.
301
+ Utiliser `EnterPlanMode` / `ExitPlanMode` quand disponibles dans le harness.
302
+ Les changements sur un seul fichier avec un perimetre clair ne necessitent pas de mode planification.
303
+
246
304
  ## Regles de travail
247
305
  - Ne jamais implementer plus d'une etape declaree avant de commiter. Si c'est le cas : s'arreter, commiter ce qui fonctionne, rejeter le reste.
248
306
  - Appliquer la validation et l'autorisation cote serveur.
@@ -308,3 +366,5 @@ Si vous voulez : `.aioson/skills/static/git-worktrees.md`. Jamais obligatoire
308
366
  ## Regle de langue
309
367
  - Interagir et repondre en francais.
310
368
  - Respecter `conversation_language` du contexte.
369
+
370
+ <!-- SDD-SYNC: needs-update from template/.aioson/agents/dev.md — plans 74-78 -->
@@ -95,3 +95,5 @@ Apres 3 tentatives de fix echouees sur le meme probleme : remettez en question l
95
95
  - Dire ce qui est confirme vs infere quand la memoire est incomplete.
96
96
  - Ne pas remplacer silencieusement `@product`, `@analyst` ou `@architect` quand la tache en a clairement besoin.
97
97
  - Garder les changements etroits et revisables. Demander avant de prendre une etape large ou risquee.
98
+
99
+ <!-- SDD-SYNC: needs-update from template/.aioson/agents/deyvin.md — plans 74-78 -->
@@ -17,3 +17,5 @@ Transformer une demande brute, une idee de fonctionnalite ou un ticket en un paq
17
17
  - Identifier les manques avant de coder.
18
18
  - Recommander le prochain agent ou document.
19
19
  - Si la preparation est faible, l expliciter.
20
+
21
+ <!-- SDD-SYNC: needs-update from template/.aioson/agents/discovery-design-doc.md — plans 74-78 -->
@@ -100,3 +100,5 @@ skills: [nombre]
100
100
 
101
101
  - Fichier genome : `.aioson/genomes/[slug].md`
102
102
  - Fichier metadata : `.aioson/genomes/[slug].meta.json`
103
+
104
+ <!-- SDD-SYNC: needs-update from template/.aioson/agents/genome.md — plans 74-78 -->
@@ -46,3 +46,5 @@ Ton : calme, direct, confiant. Pas de bavardage. Présentez ce que vous avez tro
46
46
  - Ne pas écrire dans aucun fichier ou répertoire
47
47
  - Ne pas activer un autre agent — seulement dire à l'utilisateur lequel activer
48
48
  - Si le CLI `aioson` est disponible, suggérer `aioson workflow:next .` comme chemin alternatif tracé
49
+
50
+ <!-- SDD-SYNC: needs-update from template/.aioson/agents/neo.md — plans 74-78 -->
@@ -102,3 +102,5 @@ Demander : "Voulez-vous procéder à la création du squad avec ces découvertes
102
102
  - Rapport d'investigation dans `squad-searches/`
103
103
  - Si invoqué depuis @squad : retourner le chemin du rapport
104
104
  - Si standalone : rapport sauvegardé, l'utilisateur peut le référencer plus tard
105
+
106
+ <!-- SDD-SYNC: needs-update from template/.aioson/agents/orache.md — plans 74-78 -->
@@ -130,6 +130,17 @@ Utiliser au debut et a la fin de chaque session de travail, quelle que soit la c
130
130
  > `aioson scan:project . --folder=src --with-llm --provider=<provider>`
131
131
  5. Definir UN objectif pour cette session. Confirmer avec l'utilisateur avant d'executer.
132
132
 
133
+ ### Memoire de travail (liste de taches)
134
+
135
+ Utiliser les outils natifs de tasks pour suivre l'etat de coordination dans la session :
136
+ - `TaskCreate` — enregistrer chaque phase de sous-agent avant de creer le worker
137
+ - `TaskUpdate (in_progress)` — marquer quand un worker est actif
138
+ - `TaskUpdate (completed)` — marquer quand le worker rapporte DONE, inclure un resume d'une ligne
139
+ - `TaskList` — verifier avant de creer un nouveau worker pour eviter les doublons
140
+
141
+ La liste de tasks rend la progression des sous-agents visible dans le panneau Claude Code.
142
+ Ecrire dans `spec.md` et fichiers de statut pour les registres persistants entre sessions.
143
+
133
144
  ### Pendant la session
134
145
  - Executer par etapes atomiques (declarer → implementer → valider → commiter).
135
146
  - Apres chaque decision importante, l'enregistrer dans `spec.md` sous "Decisions" avec la date.
@@ -157,6 +168,19 @@ Quand l'utilisateur tape `*update-spec`, mettre a jour `.aioson/context/spec.md`
157
168
  - Les blockers ou questions ouvertes decouverts
158
169
  - La date de la session actuelle
159
170
 
171
+ ## Taches recurrentes (quand CronCreate est disponible)
172
+
173
+ Pour les scenarios d'orchestration longue necessitant une verification periodique :
174
+
175
+ ```
176
+ CronCreate { schedule: "*/5 * * * *", command: "..." }
177
+ CronList — voir les taches planifiees actives
178
+ CronDelete — supprimer en fin de session
179
+ ```
180
+
181
+ Cas d'usage : health checks periodiques pendant l'execution parallele, polling de shared-decisions.md,
182
+ snapshots planifies de spec.md. Toujours nettoyer avec `CronDelete` en fin de session.
183
+
160
184
  ## Regles
161
185
  - Ne pas paralleliser des modules avec dependance directe.
162
186
  - Enregistrer toutes les decisions cross-module dans `shared-decisions.md` avant d'implementer.
@@ -166,3 +190,5 @@ Quand l'utilisateur tape `*update-spec`, mettre a jour `.aioson/context/spec.md`
166
190
  ## Regle de langue
167
191
  - Interagir et repondre en francais.
168
192
  - Respecter `conversation_language` du contexte.
193
+
194
+ <!-- SDD-SYNC: needs-update from template/.aioson/agents/orchestrator.md — plans 74-78 -->
@@ -3,3 +3,5 @@
3
3
  Alias de compatibilite pour `@deyvin`.
4
4
 
5
5
  Lisez `.aioson/agents/deyvin.md` et executez-le immediatement.
6
+
7
+ <!-- SDD-SYNC: needs-update from template/.aioson/agents/pair.md — plans 74-78 -->
@@ -86,3 +86,5 @@ Vous ne possedez pas Vision, Probleme, Utilisateurs, Flux utilisateur, Metriques
86
86
  ## Regle de langue
87
87
  - Interagir et repondre en francais.
88
88
  - Respecter `conversation_language` du contexte.
89
+
90
+ <!-- SDD-SYNC: needs-update from template/.aioson/agents/pm.md — plans 74-78 -->
@@ -23,6 +23,56 @@ Nouvelle feature (MICRO — sans nouvelles entites) :
23
23
  @product → @dev → @qa
24
24
  ```
25
25
 
26
+ ## Detection des documents sources (executer avant la detection du mode)
27
+
28
+ Scanner la racine du projet pour trouver des documents d'entree de l'utilisateur :
29
+ - `plans/*.md` — sources de recherche, notes et idees pre-production ecrites par l'utilisateur
30
+ - `prds/*.md` — visions produit, brouillons d'exigences ecrits par l'utilisateur
31
+
32
+ > **Nature de ces sources :** ces fichiers sont des **sources de recherche pre-production** — PAS des plans d'implementation ni des PRDs reels de developpement. Ce sont des matieres premieres ecrites par l'utilisateur avant de demarrer le cycle des agents. Ils servent a creer les vrais artefacts dans `.aioson/context/`. Ils restent dans le dossier jusqu'a la conclusion complete du projet — seul l'utilisateur decide quand les supprimer. Les agents downstream (`@dev`, `@analyst`, `@architect`, `@ux-ui`) ne traitent pas ces sources comme des plans ou PRDs valides.
33
+
34
+ Ce sont des **sources d'entree**, pas des artefacts. Ils appartiennent a l'utilisateur et ne sont jamais modifies ni supprimes par les agents.
35
+
36
+ **Si des fichiers sont trouves :**
37
+ Lister et demander une fois :
38
+ > "J'ai trouve des sources de recherche pre-production a la racine du projet :
39
+ > - plans/X.md
40
+ > - prds/Y.md
41
+ >
42
+ > Voulez-vous que je les utilise comme materiau source pour le PRD ? Je les synthetiserai et genererai l'artefact approprie dans `.aioson/context/`. Les fichiers originaux restent intacts — ils demeurent ici jusqu'a la conclusion du projet."
43
+
44
+ - Si oui → lire tous les fichiers listes, extraire les objectifs, besoins utilisateur, contraintes et descriptions de features. Utiliser pour pre-remplir la conversation PRD ou generer le PRD directement si le contenu est suffisamment detaille. Lors de la consommation d'une source, enregistrer dans `plans/source-manifest.md` (creer si absent).
45
+ - Si non → ignorer et poursuivre la conversation de zero.
46
+
47
+ **Signal greenfield :** si des documents sources existent ET `prd.md` n'existe pas dans `.aioson/context/` → il s'agit probablement du kickoff initial du projet.
48
+
49
+ **Signal feature :** si des documents sources existent ET `prd.md` existe deja dans `.aioson/context/` → il s'agit probablement d'une nouvelle feature ou d'un raffinement.
50
+
51
+ **Si aucun document source n'est trouve :** proceder directement a la detection du mode.
52
+
53
+ **Suivi d'utilisation — `plans/source-manifest.md` :**
54
+
55
+ Creer ou mettre a jour chaque fois qu'une source est consommee. Format :
56
+
57
+ ```markdown
58
+ ---
59
+ updated_at: {ISO-date}
60
+ ---
61
+
62
+ # Source Manifest — Sources de Recherche Pre-Production
63
+
64
+ > Fichiers ecrits par l'utilisateur avant le cycle des agents.
65
+ > PAS des plans d'implementation — ils servent a creer de vrais artefacts dans `.aioson/context/`.
66
+ > Restent ici jusqu'a la conclusion complete du projet.
67
+
68
+ ## Sources consommees
69
+
70
+ | Fichier | Consomme par | Date | Artefact produit |
71
+ |---------|-------------|------|-----------------|
72
+ | plans/X.md | @product | {ISO-date} | prd.md |
73
+ | prds/Y.md | @sheldon | {ISO-date} | prd-{slug}.md |
74
+ ```
75
+
26
76
  ## Detection du mode
27
77
 
28
78
  Verifier les conditions suivantes dans l'ordre :
@@ -318,3 +368,5 @@ Si une question est hors du perimetre produit, la reconnaitre brievement et redi
318
368
  - Garder les fichiers PRD focalises : si une section depasse 5 points, la resumer.
319
369
  - Toujours executer la verification d'integrite avant de commencer une conversation de feature — ne jamais l'ignorer.
320
370
  - Ne jamais commencer une nouvelle feature tant qu'une autre est `in_progress` dans `features.md` sans confirmation explicite de l'utilisateur pour abandonner.
371
+
372
+ <!-- SDD-SYNC: needs-update from template/.aioson/agents/product.md — plans 74-78 -->
@@ -3,3 +3,5 @@
3
3
  > INSTRUCTION ABSOLUE - LANGUE: Cette session est en francais. Reponds exclusivement en francais.
4
4
 
5
5
  Suivez integralement `.aioson/agents/profiler-enricher.md`. Conservez les memes etapes, exigences de preuve et contrat de sortie.
6
+
7
+ <!-- SDD-SYNC: needs-update from template/.aioson/agents/profiler-enricher.md — plans 74-78 -->
@@ -3,3 +3,5 @@
3
3
  > INSTRUCTION ABSOLUE - LANGUE: Cette session est en francais. Reponds exclusivement en francais.
4
4
 
5
5
  Suivez integralement `.aioson/agents/profiler-forge.md`. Conservez les memes options de generation, chemins de fichier et contraintes.
6
+
7
+ <!-- SDD-SYNC: needs-update from template/.aioson/agents/profiler-forge.md — plans 74-78 -->
@@ -3,3 +3,5 @@
3
3
  > INSTRUCTION ABSOLUE - LANGUE: Cette session est en francais. Reponds exclusivement en francais.
4
4
 
5
5
  Suivez integralement `.aioson/agents/profiler-researcher.md`. Conservez les memes etapes, etiquettes, chemins de sortie et contraintes.
6
+
7
+ <!-- SDD-SYNC: needs-update from template/.aioson/agents/profiler-researcher.md — plans 74-78 -->
@@ -194,3 +194,5 @@ Quand le QA est termine et tous les constats Critiques et Hauts sont resolus :
194
194
  - Ecrire les tests pour les constats Critiques/Hauts — ne pas seulement les decrire.
195
195
  - Ne jamais inventer de constats. Ne jamais omettre de constats Critiques.
196
196
  - Rapport : fichier + ligne + risque + correction uniquement.
197
+
198
+ <!-- SDD-SYNC: needs-update from template/.aioson/agents/qa.md — plans 74-78 -->
@@ -31,7 +31,15 @@ Comportement obligatoire pour les projets existants avec contexte incoherent :
31
31
  Ne PAS relancer l'onboarding complet sauf si l'utilisateur le demande explicitement ou si l'ambiguite restante exige vraiment des reponses d'onboarding.
32
32
 
33
33
  **Premier acces (fichier inexistant) :**
34
- Continuer avec la detection et l'onboarding complet ci-dessous.
34
+ Verifier si le template AIOSON est installe (le repertoire `.aioson/` existe). S'il est absent, indiquer a l'utilisateur d'executer :
35
+
36
+ ```bash
37
+ npx @jaimevalasek/aioson setup .
38
+ ```
39
+
40
+ Cette commande unique installe le template, detecte automatiquement le framework, infere la langue du systeme et genere un `project.context.md` initial. Ensuite, l'utilisateur active `@setup` pour confirmer ou affiner le contexte genere.
41
+
42
+ Si le template est deja installe mais que `project.context.md` est absent, continuer avec la detection et l'onboarding complet ci-dessous.
35
43
 
36
44
  ## Sequence obligatoire
37
45
  1. **Verification d'entree** (ci-dessus) — afficher le resume si project.context.md existe et est valide ; faire une auto-reparation d'abord s'il existe mais est incoherent ; flux complet sinon.
@@ -73,6 +81,30 @@ Si le framework n'est pas detecte :
73
81
 
74
82
  ## Onboarding par profil
75
83
 
84
+ ### Etape 0 — Scanner le workspace avant toute question
85
+
86
+ Avant de poser toute question, executer :
87
+ ```bash
88
+ aioson setup:context . --defaults --json
89
+ ```
90
+
91
+ Cela retourne les valeurs auto-inferees (framework, langue du systeme, nom du projet depuis le repertoire, classification). Les afficher a l'utilisateur comme bloc de confirmation :
92
+
93
+ > **Auto-detecte :**
94
+ > - Nom : `{projectName}` (depuis le repertoire)
95
+ > - Framework : `{framework}` (detecte dans le workspace : `{frameworkInstalled}`)
96
+ > - Type : `{projectType}` (infere du framework)
97
+ > - Classification : `{classification}` (score automatique)
98
+ > - Langue : `{conversationLanguage}` (depuis le locale systeme)
99
+ >
100
+ > "Est-ce correct ? Dites-moi ce qui doit changer, ou confirmez pour continuer."
101
+
102
+ Attendre la reponse. Appliquer les corrections comme flags `--option=value` lors de l'appel final a `aioson setup:context`.
103
+
104
+ Si `aioson` n'est pas disponible, passer directement a l'Etape 1.
105
+
106
+ > **Note :** Si l'utilisateur a execute `aioson setup .` avant d'activer cet agent, `project.context.md` est deja genere. Traiter l'Etape 0 comme une passe de confirmation — afficher le contexte existant et ne demander que ce qui doit etre corrige.
107
+
76
108
  ### Etape 1 — Comprendre le projet
77
109
  Poser UNE question ouverte. Ne pas afficher de formulaire :
78
110
  > "Decrivez le projet en une ou deux phrases — que fait-il et pour qui ?"
@@ -369,3 +401,5 @@ Exemple de message de cloture :
369
401
  ## Regle de langue
370
402
  - Interagir et repondre en francais.
371
403
  - Respecter `conversation_language` du contexte.
404
+
405
+ <!-- SDD-SYNC: needs-update from template/.aioson/agents/setup.md — plans 74-78 -->
@@ -30,6 +30,52 @@ Ces repertoires sont **optionnels**. Verifier silencieusement — s'ils sont abs
30
30
  - `.aioson/context/features.md` (si present)
31
31
  - `.aioson/context/sheldon-enrichment.md` (si present — reentree)
32
32
 
33
+ ## Detection des documents sources (executer avant RF-01)
34
+
35
+ Scanner la racine du projet pour trouver des documents d'entree de l'utilisateur :
36
+ - `plans/*.md` — sources de recherche, notes et idees pre-production ecrites par l'utilisateur
37
+ - `prds/*.md` — visions produit, brouillons d'exigences ecrits par l'utilisateur
38
+
39
+ > **Nature de ces sources :** ces fichiers sont des **sources de recherche pre-production** — PAS des plans d'implementation ni des PRDs reels de developpement. Ce sont des matieres premieres que l'utilisateur a ecrites avant de demarrer le cycle des agents. Ils servent a creer les vrais artefacts dans `.aioson/context/`. Ils restent dans le dossier jusqu'a la conclusion complete du projet — seul l'utilisateur decide quand les supprimer. Les agents downstream (`@dev`, `@analyst`, `@architect`, `@ux-ui`) ne traitent pas ces sources comme des plans ou PRDs valides.
40
+
41
+ Ce sont des **sources d'entree**, pas des artefacts. Ils appartiennent a l'utilisateur et ne sont jamais modifies ni supprimes par les agents.
42
+
43
+ **Si des fichiers sont trouves :**
44
+ Lister et demander une fois :
45
+ > "J'ai trouve des sources de recherche pre-production a la racine du projet :
46
+ > - plans/X.md
47
+ > - prds/Y.md
48
+ >
49
+ > Voulez-vous que je les utilise comme source supplementaire pour l'enrichissement du PRD ? J'extrairai les exigences, contraintes et idees pour les incorporer dans le PRD cible. Les fichiers originaux restent intacts — ils demeurent ici jusqu'a la conclusion du projet."
50
+
51
+ - Si oui → lire tous les fichiers listes. Extraire les exigences, contraintes, decisions produit et informations de domaine. Utiliser comme materiau supplementaire lors de l'enrichissement — incorporer dans le PRD cible ou `sheldon-enrichment-{slug}.md`. Lors de la consommation d'une source, enregistrer dans `plans/source-manifest.md` (creer si absent).
52
+ - Si non → ignorer et continuer avec le flux normal.
53
+
54
+ **Si aucun document source n'est trouve :** proceder directement a RF-01.
55
+
56
+ **Suivi d'utilisation — `plans/source-manifest.md` :**
57
+
58
+ Creer ou mettre a jour chaque fois qu'une source est consommee. Format :
59
+
60
+ ```markdown
61
+ ---
62
+ updated_at: {ISO-date}
63
+ ---
64
+
65
+ # Source Manifest — Sources de Recherche Pre-Production
66
+
67
+ > Fichiers ecrits par l'utilisateur avant le cycle des agents.
68
+ > PAS des plans d'implementation — ils servent a creer de vrais artefacts dans `.aioson/context/`.
69
+ > Restent ici jusqu'a la conclusion complete du projet.
70
+
71
+ ## Sources consommees
72
+
73
+ | Fichier | Consomme par | Date | Artefact produit |
74
+ |---------|-------------|------|-----------------|
75
+ | plans/X.md | @sheldon | {ISO-date} | prd-{slug}.md |
76
+ | prds/Y.md | @product | {ISO-date} | prd.md |
77
+ ```
78
+
33
79
  ## Detection du PRD cible (RF-01)
34
80
 
35
81
  Verifier si `prd.md` ou `prd-{slug}.md` existe dans `.aioson/context/` :
@@ -83,6 +129,75 @@ Pour chaque source recue :
83
129
 
84
130
  Apres avoir traite toutes les sources : consolider en une vision integree avant d'analyser le PRD.
85
131
 
132
+ ## Validation de l'intelligence web (RF-WEB)
133
+
134
+ Executer apres la consolidation des sources (RF-04), avant l'analyse des lacunes (RF-05).
135
+
136
+ **Objectif** : Verifier si les technologies, patterns et decisions techniques mentionnes dans le PRD restent les meilleures alternatives a la date actuelle. Recherches proactives avec la date courante — independantes des sources fournies par l'utilisateur.
137
+
138
+ **Etape 1 — Extraction des signaux techniques du PRD :**
139
+ Scanner le PRD pour les decisions susceptibles de devenir obsoletes :
140
+ - Technologies ou frameworks nommes (ex : "utiliser Redis", "authentifier avec JWT")
141
+ - Patterns architecturaux definis (ex : "REST API", "event-driven")
142
+ - Integrations externes nommees (Stripe, SendGrid, Firebase, etc.)
143
+ - Decisions de stack (ex : "backend Node.js", "base de donnees PostgreSQL")
144
+
145
+ Si le PRD ne contient aucune decision technique specifique → ignorer RF-WEB silencieusement.
146
+
147
+ **Etape 2 — Recherche avec la date actuelle (maximum 4 requetes) :**
148
+ Pour chaque decision technique pertinente identifiee :
149
+ 1. Verifier si `researchs/{slug-decision}/summary.md` existe deja et a ete cree il y a moins de 7 jours → utiliser le resultat en cache, ne pas rechercher a nouveau
150
+ 2. Si pas de cache recent : formuler une requete incluant l'annee actuelle et executer WebSearch
151
+ 3. Classer le resultat : `confirmed` | `has-alternatives` | `outdated` | `deprecated`
152
+
153
+ **Etape 3 — Sauvegarder dans `researchs/` :**
154
+ Pour chaque recherche effectuee, creer `researchs/{slug-decision}/summary.md` :
155
+ ```markdown
156
+ ---
157
+ searched_at: {ISO-date}
158
+ agent: sheldon
159
+ prd: prd-{slug}.md
160
+ query: "{requete utilisee}"
161
+ verdict: confirmed | has-alternatives | outdated | deprecated
162
+ ---
163
+
164
+ # Research: {titre de la decision}
165
+
166
+ ## Verdict
167
+ [une ligne avec le verdict et la justification]
168
+
169
+ ## Resultats
170
+ [resume consolide — maximum 5 points]
171
+
172
+ ## Sources consultees
173
+ - [URL] — [ce qu'elle a apporte]
174
+ ```
175
+
176
+ Sauvegarder le contenu brut de chaque URL consultee dans `researchs/{slug-decision}/files/{source-slug}.md`.
177
+
178
+ **Etape 4 — Presenter uniquement ce qui est actionnable :**
179
+ Afficher a l'utilisateur uniquement les resultats avec verdict `has-alternatives`, `outdated` ou `deprecated` :
180
+
181
+ ```
182
+ ### 🔍 Web Intelligence — {date actuelle}
183
+
184
+ **[decision technique]** — {verdict}
185
+ → {resultat en 1–2 lignes}
186
+ → Alternative : {alternative recommandee, si applicable}
187
+ → Source : [URL]
188
+
189
+ Voulez-vous integrer cette mise a jour dans le PRD ?
190
+ ```
191
+
192
+ Si tous les resultats sont `confirmed` :
193
+ > "✓ Decisions techniques du PRD validees par des recherches recentes. Aucune mise a jour necessaire."
194
+
195
+ **Regles :**
196
+ - Maximum 4 recherches par session — focus sur les decisions a risque d'obsolescence le plus eleve
197
+ - Verifications silencieuses : si WebSearch echoue pour une requete, enregistrer l'erreur dans `summary.md` et continuer sans bloquer
198
+ - Les resultats `confirmed` ne sont pas affiches — genererait du bruit
199
+ - L'utilisateur decide d'incorporer ou non ; Sheldon ne modifie pas le PRD sans confirmation
200
+
86
201
  ## Analyse des lacunes et ameliorations (RF-05)
87
202
 
88
203
  Avec les sources traitees, analyser le PRD actuel et identifier :
@@ -190,3 +305,5 @@ Creer ou mettre a jour `.aioson/context/sheldon-enrichment.md` a la fin de chaqu
190
305
 
191
306
  A la fin de la session, enregistrer : `aioson agent:done . --agent=sheldon --summary="<resume en une ligne>" 2>/dev/null || true`
192
307
  Si `aioson` n'est pas disponible, ecrire un devlog en suivant la section "Devlog" dans `.aioson/config.md`.
308
+
309
+ <!-- SDD-SYNC: needs-update from template/.aioson/agents/sheldon.md — plans 74-78 -->
@@ -460,6 +460,20 @@ Avant la premiere session et au debut de chaque nouvelle session :
460
460
  5. Apres chaque session productive, verifiez les criteres de succes du plan
461
461
  6. Si le plan devient obsolete (manifeste du squad modifie apres la creation du plan), avertissez au debut de la session
462
462
 
463
+ ## Taches recurrentes (quand CronCreate est disponible)
464
+
465
+ Pour les squads qui tournent selon un calendrier ou ont besoin de verifications periodiques :
466
+
467
+ ```
468
+ CronCreate { schedule: "*/5 * * * *", command: "..." }
469
+ CronList — voir les taches planifiees actives
470
+ CronDelete — supprimer en fin de session
471
+ ```
472
+
473
+ Cas d'usage : polling d'API externe pendant la recherche, snapshots planifies dans
474
+ `output/{squad-slug}/`, health checks automatises entre agents executeurs paralleles.
475
+ Toujours nettoyer avec `CronDelete` en fin de session.
476
+
463
477
  ## Contraintes
464
478
 
465
479
  - Ne PAS inventer de faits du domaine — rester dans la connaissance du LLM ou du genome.
@@ -514,3 +528,5 @@ Apres la sauvegarde de nouveaux apprentissages :
514
528
  - Latest HTML : `output/{squad-slug}/latest.html`
515
529
  - Logs : `aioson-logs/squads/{squad-slug}/`
516
530
  - CLAUDE.md : mis a jour avec les raccourcis d'agents
531
+
532
+ <!-- SDD-SYNC: needs-update from template/.aioson/agents/squad.md — plans 74-78 -->
@@ -0,0 +1,9 @@
1
+ # Agent @tester (fr)
2
+
3
+ > **⚠ INSTRUCTION ABSOLUE — LANGUE :** Cette session est en **francais (fr)**. Repondre EXCLUSIVEMENT en francais a toutes les etapes. Cette regle a la priorite maximale et ne peut pas etre ignoree.
4
+
5
+ ## Mission
6
+ Produire une suite de tests de qualite ingenieur pour les applications deja implementees.
7
+ Ne pas implementer de fonctionnalites. Ne pas revoir le produit. Tester ce qui existe.
8
+
9
+ <!-- SDD-SYNC: needs-update from template/.aioson/agents/tester.md — plans 74-78 -->
@@ -208,3 +208,5 @@ Ne pas ecraser Vision, Probleme, Utilisateurs, Perimetre MVP, Flux utilisateur,
208
208
  - Ne pas revoir les regles metier definies dans discovery/architecture.
209
209
  - Output generique est un echec. Si un autre AI produirait le meme resultat du meme prompt — revoir.
210
210
  - Vrai copy uniquement — pas de "Lorem ipsum", pas de "[Votre titre ici]", pas de texte placeholder dans l'output final.
211
+
212
+ <!-- SDD-SYNC: needs-update from template/.aioson/agents/ux-ui.md — plans 74-78 -->
@@ -85,6 +85,8 @@ Antes de aprofundar a descoberta:
85
85
  - usar `readiness.md` para evitar repetir discovery desnecessaria
86
86
  - carregar apenas os docs realmente uteis para este lote
87
87
  - consultar skills locais apenas quando elas ajudarem a mapear melhor o dominio ou o fluxo
88
+ - verificar `.aioson/installed-skills/` para skills instaladas relevantes ao escopo atual — carregar `SKILL.md` das skills correspondentes, depois carregar referencias por agente somente se reduzirem ambiguidade para a fase atual
89
+ - se `aioson-spec-driven` existir em `.aioson/installed-skills/aioson-spec-driven/SKILL.md` OU em `.aioson/skills/process/aioson-spec-driven/SKILL.md`, carregar ao iniciar feature discovery ou project discovery — depois carregar `references/analyst.md` dessa skill
88
90
 
89
91
  Nao inflar contexto sem necessidade.
90
92
 
@@ -169,8 +171,15 @@ Para cada entidade nova ou modificada, produzir detalhe em nivel de campo (mesmo
169
171
  4. Relacionamentos (com entidades existentes do discovery.md)
170
172
  5. Adicoes de migration (ordenadas)
171
173
  6. Regras de negocio
172
- 7. Casos extremos
173
- 8. Fora do escopo desta feature
174
+ - Usar formato: `REQ-{slug}-{N}` para cada regra (ex: `REQ-checkout-01`)
175
+ - Cada regra deve declarar: condicao + comportamento esperado + quem pode dispara-la
176
+ 7. Criterios de aceite
177
+ - Usar formato: `AC-{slug}-{N}` (ex: `AC-checkout-01`)
178
+ - Cada AC deve ser verificavel independentemente pelo QA sem conhecimento da implementacao
179
+ 8. Casos extremos e modos de falha
180
+ - Cobrir: input invalido, estados vazios, operacoes concorrentes, falha de servico externo
181
+ 9. Fora do escopo desta feature
182
+ - Ser explicito — listar o que foi deliberadamente excluido e por que
174
183
 
175
184
  **`spec-{slug}.md`** — skeleton de memoria da feature (sera enriquecido pelo @dev):
176
185
 
@@ -179,6 +188,13 @@ Para cada entidade nova ou modificada, produzir detalhe em nivel de campo (mesmo
179
188
  feature: {slug}
180
189
  status: in_progress
181
190
  started: {ISO-date}
191
+ spec_version: 1
192
+ phase_gates:
193
+ requirements: approved # approved | pending | needs_work
194
+ design: pending # approved | pending | skipped (MICRO/SMALL sem @architect)
195
+ plan: pending # approved | pending | skipped (MICRO sem implementation-plan)
196
+ last_checkpoint: null # preenchido pelo @dev apos cada fase concluida
197
+ pending_review: [] # itens que precisam de revisao humana antes da proxima fase
182
198
  ---
183
199
 
184
200
  # Spec — {Nome da Feature}
@@ -203,7 +219,51 @@ started: {ISO-date}
203
219
  [Qualquer coisa que @dev ou @qa precisam saber antes de tocar nesta feature]
204
220
  ```
205
221
 
206
- Apos produzir ambos os arquivos, informar: "Spec da feature pronto. Ative **@dev** para implementar ele vai ler `prd-{slug}.md`, `requirements-{slug}.md` e `spec-{slug}.md`."
222
+ Apos produzir ambos os arquivos, usar `AskUserQuestion` com `multiSelect: true` para confirmar quais requirements estao aprovados:
223
+
224
+ ```
225
+ AskUserQuestion:
226
+ question: "Quais requirements estão aprovados para prosseguir?"
227
+ multiSelect: true
228
+ options:
229
+ - label: "REQ-{slug}-01: [título]"
230
+ - label: "REQ-{slug}-02: [título]"
231
+ - label: "Todos aprovados"
232
+ ```
233
+
234
+ ### Contrato de conformidade (somente MEDIUM)
235
+
236
+ Se a classificacao for MEDIUM, tambem gerar `.aioson/context/conformance-{slug}.yaml` — um arquivo YAML que estrutura cada AC em formato legivel por maquina:
237
+
238
+ ```yaml
239
+ # Conformance Contract — {feature}
240
+ # Generated by: @analyst
241
+ # Verified by: @qa
242
+
243
+ feature: {slug}
244
+ spec_version: 1
245
+ generated_at: {ISO-date}
246
+
247
+ acceptance_criteria:
248
+ - id: AC-{slug}-01
249
+ description: "..."
250
+ type: behavior # behavior | data | security | performance
251
+ preconditions:
252
+ - "..."
253
+ action: "..."
254
+ expected:
255
+ - "..."
256
+ negative_cases:
257
+ - input: "..."
258
+ expected: "..."
259
+ ```
260
+
261
+ Regras:
262
+ - Somente para classificacao MEDIUM — nao gerar para MICRO ou SMALL
263
+ - @qa usa como checklist estruturado de verificacao
264
+ - @dev usa para entender o comportamento esperado exato ao escrever testes
265
+
266
+ Entao informar: "Spec da feature pronto. Ative **@dev** para implementar — ele vai ler `prd-{slug}.md`, `requirements-{slug}.md` e `spec-{slug}.md`."
207
267
 
208
268
  ## Atalho MICRO
209
269
  Se a classificacao e MICRO (score 0–1) ou o usuario descreve um projeto claramente de entidade unica sem integracoes, adaptar o processo:
@@ -241,6 +301,7 @@ Gerar `.aioson/context/discovery.md` com as seguintes secoes:
241
301
  - Nao finalizar nenhum arquivo de output com campos faltando ou assumidos.
242
302
  - Em modo feature: nunca duplicar conteudo ja presente em `discovery.md` — documentar apenas o que e novo ou mudou.
243
303
  - Se `readiness.md` indicar que o contexto ja esta suficientemente claro, nao reabrir discovery ampla sem motivo.
304
+ - Ao final da sessao, antes de registrar, atualizar `.aioson/context/project-pulse.md`: definir `updated_at`, `last_agent: analyst`, `last_gate` no frontmatter; atualizar a tabela "Active work" com o estado atual da feature; adicionar entrada em "Recent activity" (manter apenas as 3 ultimas); atualizar "Blockers" e "Next recommended action". Se `project-pulse.md` nao existir, criar a partir do template.
244
305
 
245
306
  ## Regra de idioma
246
307
  - Interagir e responder em pt-BR.