@flaviogarrido/reversa 0.0.0-stage → 1.3.7

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 (421) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +487 -2
  3. package/agents/fg-backlog/SKILL.md +129 -0
  4. package/agents/fg-backlog/agents/openai.yaml +5 -0
  5. package/agents/fg-backlog/references/backlog-template.md +60 -0
  6. package/agents/fg-backlog/references/priorizacao.md +41 -0
  7. package/agents/impeccable/LICENSE +191 -0
  8. package/agents/impeccable/NOTICE.md +11 -0
  9. package/agents/impeccable/SKILL.md +88 -0
  10. package/agents/impeccable/agents/impeccable_asset_producer.toml +47 -0
  11. package/agents/impeccable/agents/impeccable_documenter.toml +27 -0
  12. package/agents/impeccable/agents/impeccable_finish_reviewer.toml +41 -0
  13. package/agents/impeccable/agents/impeccable_manual_edit_applier.toml +95 -0
  14. package/agents/impeccable/agents/openai.yaml +4 -0
  15. package/agents/impeccable/reference/adapt.md +318 -0
  16. package/agents/impeccable/reference/adapt.native.md +58 -0
  17. package/agents/impeccable/reference/android.md +46 -0
  18. package/agents/impeccable/reference/animate.md +89 -0
  19. package/agents/impeccable/reference/audit.md +139 -0
  20. package/agents/impeccable/reference/audit.native.md +139 -0
  21. package/agents/impeccable/reference/bolder.md +33 -0
  22. package/agents/impeccable/reference/clarify.md +94 -0
  23. package/agents/impeccable/reference/colorize.md +86 -0
  24. package/agents/impeccable/reference/component-review.md +63 -0
  25. package/agents/impeccable/reference/craft-floor.md +44 -0
  26. package/agents/impeccable/reference/craft.md +5 -0
  27. package/agents/impeccable/reference/critique.md +819 -0
  28. package/agents/impeccable/reference/degraded/asset-producer.md +42 -0
  29. package/agents/impeccable/reference/degraded/documenter.md +24 -0
  30. package/agents/impeccable/reference/degraded/finish-reviewer.md +38 -0
  31. package/agents/impeccable/reference/degraded/manual-edit-applier.md +92 -0
  32. package/agents/impeccable/reference/delight.md +70 -0
  33. package/agents/impeccable/reference/distill.md +111 -0
  34. package/agents/impeccable/reference/doctor.md +54 -0
  35. package/agents/impeccable/reference/document.md +416 -0
  36. package/agents/impeccable/reference/extract.md +69 -0
  37. package/agents/impeccable/reference/generate.md +101 -0
  38. package/agents/impeccable/reference/harden.md +343 -0
  39. package/agents/impeccable/reference/hooks.md +113 -0
  40. package/agents/impeccable/reference/init.md +131 -0
  41. package/agents/impeccable/reference/ios.md +51 -0
  42. package/agents/impeccable/reference/layout.md +84 -0
  43. package/agents/impeccable/reference/live-setup.md +104 -0
  44. package/agents/impeccable/reference/live.md +325 -0
  45. package/agents/impeccable/reference/mode-operate.md +21 -0
  46. package/agents/impeccable/reference/mode-persuade.md +19 -0
  47. package/agents/impeccable/reference/mode-read.md +21 -0
  48. package/agents/impeccable/reference/new-work.md +154 -0
  49. package/agents/impeccable/reference/onboard.md +234 -0
  50. package/agents/impeccable/reference/operate.md +61 -0
  51. package/agents/impeccable/reference/optimize.md +258 -0
  52. package/agents/impeccable/reference/overdrive.md +127 -0
  53. package/agents/impeccable/reference/polish.md +105 -0
  54. package/agents/impeccable/reference/quieter.md +99 -0
  55. package/agents/impeccable/reference/region-map.md +26 -0
  56. package/agents/impeccable/reference/routing.md +24 -0
  57. package/agents/impeccable/reference/shape.md +59 -0
  58. package/agents/impeccable/reference/typeset.md +90 -0
  59. package/agents/impeccable/reference/visualize.md +47 -0
  60. package/agents/impeccable/reversa-bundle.json +16 -0
  61. package/agents/impeccable/scripts/VERSION +1 -0
  62. package/agents/impeccable/scripts/command-metadata.json +98 -0
  63. package/agents/impeccable/scripts/data/font-index-failures.json +121 -0
  64. package/agents/impeccable/scripts/data/font-index.json +1 -0
  65. package/agents/impeccable/scripts/impeccable +212 -0
  66. package/agents/impeccable/scripts/impeccable.cmd +239 -0
  67. package/agents/impeccable/scripts/live-browser-dom.js +320 -0
  68. package/agents/impeccable/scripts/live-browser-ignores.js +242 -0
  69. package/agents/impeccable/scripts/live-browser-session.js +180 -0
  70. package/agents/impeccable/scripts/live-browser.js +13557 -0
  71. package/agents/impeccable/scripts/modern-screenshot.umd.js +14 -0
  72. package/agents/reversa/SKILL.md +135 -0
  73. package/agents/reversa/agents/openai.yaml +3 -0
  74. package/agents/reversa/references/checkpoint-guide.md +106 -0
  75. package/agents/reversa/references/state-schema.md +80 -0
  76. package/agents/reversa/references/step-01-first-run.md +63 -0
  77. package/agents/reversa/references/step-02-resume.md +88 -0
  78. package/agents/reversa/references/step-03-specs-organization.md +145 -0
  79. package/agents/reversa/references/step-04-regression-check.md +94 -0
  80. package/agents/reversa-add/SKILL.md +131 -0
  81. package/agents/reversa-add/agents/openai.yaml +5 -0
  82. package/agents/reversa-agents-help/SKILL.md +211 -0
  83. package/agents/reversa-agents-help/agents/openai.yaml +3 -0
  84. package/agents/reversa-arbiter/SKILL.md +140 -0
  85. package/agents/reversa-arbiter/agents/openai.yaml +5 -0
  86. package/agents/reversa-archaeologist/SKILL.md +95 -0
  87. package/agents/reversa-archaeologist/agents/openai.yaml +5 -0
  88. package/agents/reversa-archaeologist/references/modules-schema.md +69 -0
  89. package/agents/reversa-architect/SKILL.md +93 -0
  90. package/agents/reversa-architect/agents/openai.yaml +5 -0
  91. package/agents/reversa-arquitetura-3d/SKILL.md +163 -0
  92. package/agents/reversa-arquitetura-3d/agents/openai.yaml +5 -0
  93. package/agents/reversa-arquitetura-3d/references/ARCH_TOUR.md +242 -0
  94. package/agents/reversa-arquitetura-3d/references/CALL_GRAPH_3D.md +217 -0
  95. package/agents/reversa-arquitetura-3d/references/CODE_CITY.md +228 -0
  96. package/agents/reversa-arquitetura-3d/references/DEPENDENCY_GRAPH_3D.md +240 -0
  97. package/agents/reversa-arquitetura-3d/references/ERRORS.md +286 -0
  98. package/agents/reversa-arquitetura-3d/references/LAYER_STACK.md +230 -0
  99. package/agents/reversa-arquitetura-3d/references/THREE_PATTERNS.md +221 -0
  100. package/agents/reversa-audit/SKILL.md +98 -0
  101. package/agents/reversa-audit/agents/openai.yaml +5 -0
  102. package/agents/reversa-autonomous/SKILL.md +139 -0
  103. package/agents/reversa-autonomous/agents/openai.yaml +3 -0
  104. package/agents/reversa-brainstorm/SKILL.md +131 -0
  105. package/agents/reversa-brainstorm/agents/openai.yaml +3 -0
  106. package/agents/reversa-challenger/SKILL.md +122 -0
  107. package/agents/reversa-challenger/agents/openai.yaml +5 -0
  108. package/agents/reversa-clarify/SKILL.md +103 -0
  109. package/agents/reversa-clarify/agents/openai.yaml +5 -0
  110. package/agents/reversa-code-express/SKILL.md +252 -0
  111. package/agents/reversa-code-express/agents/openai.yaml +5 -0
  112. package/agents/reversa-coding/SKILL.md +172 -0
  113. package/agents/reversa-coding/agents/openai.yaml +5 -0
  114. package/agents/reversa-curator/SKILL.md +133 -0
  115. package/agents/reversa-curator/agents/openai.yaml +5 -0
  116. package/agents/reversa-curator/references/decision-rubric.md +52 -0
  117. package/agents/reversa-curator/references/templates/discard_log.md +37 -0
  118. package/agents/reversa-curator/references/templates/target_business_rules.md +54 -0
  119. package/agents/reversa-data-master/SKILL.md +67 -0
  120. package/agents/reversa-data-master/agents/openai.yaml +5 -0
  121. package/agents/reversa-debugger/SKILL.md +178 -0
  122. package/agents/reversa-debugger/agents/openai.yaml +3 -0
  123. package/agents/reversa-debugger/references/bug-schema.md +123 -0
  124. package/agents/reversa-debugger/references/bugs-readme-template.md +76 -0
  125. package/agents/reversa-debugger-debate/SKILL.md +75 -0
  126. package/agents/reversa-debugger-debate/agents/openai.yaml +5 -0
  127. package/agents/reversa-debugger-debate/references/debate-protocol.md +102 -0
  128. package/agents/reversa-debugger-fix/SKILL.md +170 -0
  129. package/agents/reversa-debugger-fix/agents/openai.yaml +5 -0
  130. package/agents/reversa-debugger-graph/SKILL.md +94 -0
  131. package/agents/reversa-debugger-graph/agents/openai.yaml +5 -0
  132. package/agents/reversa-decouple/SKILL.md +78 -0
  133. package/agents/reversa-decouple/agents/openai.yaml +5 -0
  134. package/agents/reversa-depth-inspection/SKILL.md +99 -0
  135. package/agents/reversa-depth-inspection/agents/openai.yaml +5 -0
  136. package/agents/reversa-design-system/SKILL.md +77 -0
  137. package/agents/reversa-design-system/agents/openai.yaml +5 -0
  138. package/agents/reversa-designer/SKILL.md +217 -0
  139. package/agents/reversa-designer/agents/openai.yaml +5 -0
  140. package/agents/reversa-designer/references/paradigm-checklist.md +50 -0
  141. package/agents/reversa-designer/references/templates/data_migration_plan.md +80 -0
  142. package/agents/reversa-designer/references/templates/target_architecture.md +68 -0
  143. package/agents/reversa-designer/references/templates/target_data_model.md +64 -0
  144. package/agents/reversa-designer/references/templates/target_domain_model.md +62 -0
  145. package/agents/reversa-designer/references/templates/topology_decision.md +82 -0
  146. package/agents/reversa-detective/SKILL.md +82 -0
  147. package/agents/reversa-detective/agents/openai.yaml +5 -0
  148. package/agents/reversa-docs/SKILL.md +241 -0
  149. package/agents/reversa-docs/agents/openai.yaml +3 -0
  150. package/agents/reversa-docs/references/config-schema.json +108 -0
  151. package/agents/reversa-docs/references/expected_sources.yaml +60 -0
  152. package/agents/reversa-docs-analyst/SKILL.md +163 -0
  153. package/agents/reversa-docs-analyst/agents/openai.yaml +5 -0
  154. package/agents/reversa-docs-mapper/SKILL.md +167 -0
  155. package/agents/reversa-docs-mapper/agents/openai.yaml +5 -0
  156. package/agents/reversa-docs-mapper/references/extraction-policy.md +44 -0
  157. package/agents/reversa-docs-publisher/SKILL.md +323 -0
  158. package/agents/reversa-docs-publisher/agents/openai.yaml +5 -0
  159. package/agents/reversa-docs-publisher/references/auxiliary_sources.yaml +27 -0
  160. package/agents/reversa-docs-publisher/references/vendor-pins.yaml +149 -0
  161. package/agents/reversa-docs-storyteller/SKILL.md +189 -0
  162. package/agents/reversa-docs-storyteller/agents/openai.yaml +5 -0
  163. package/agents/reversa-drafter/SKILL.md +189 -0
  164. package/agents/reversa-drafter/agents/openai.yaml +5 -0
  165. package/agents/reversa-especialista-d3/SKILL.md +37 -0
  166. package/agents/reversa-especialista-d3/agents/openai.yaml +5 -0
  167. package/agents/reversa-especialista-d3/references/api-core.md +13 -0
  168. package/agents/reversa-especialista-d3/references/interatividade.md +5 -0
  169. package/agents/reversa-especialista-d3/references/layouts-complexos.md +8 -0
  170. package/agents/reversa-explorer/SKILL.md +110 -0
  171. package/agents/reversa-explorer/agents/openai.yaml +5 -0
  172. package/agents/reversa-extract-soul/SKILL.md +221 -0
  173. package/agents/reversa-extract-soul/agents/openai.yaml +5 -0
  174. package/agents/reversa-forward/SKILL.md +235 -0
  175. package/agents/reversa-forward/agents/openai.yaml +3 -0
  176. package/agents/reversa-forward-autonomous/SKILL.md +184 -0
  177. package/agents/reversa-forward-autonomous/agents/openai.yaml +3 -0
  178. package/agents/reversa-framer/SKILL.md +124 -0
  179. package/agents/reversa-framer/agents/openai.yaml +5 -0
  180. package/agents/reversa-highcharts-visualizer/SKILL.md +123 -0
  181. package/agents/reversa-highcharts-visualizer/agents/openai.yaml +5 -0
  182. package/agents/reversa-highcharts-visualizer/references/CHART_CATALOG.md +450 -0
  183. package/agents/reversa-highcharts-visualizer/references/ERRORS.md +99 -0
  184. package/agents/reversa-highcharts-visualizer/references/HIGHCHARTS_PATTERNS.md +347 -0
  185. package/agents/reversa-highcharts-visualizer/scripts/analyze_data.py +219 -0
  186. package/agents/reversa-highcharts-visualizer/scripts/parse_data.py +246 -0
  187. package/agents/reversa-highcharts-visualizer/scripts/sample_data.py +208 -0
  188. package/agents/reversa-ideator/SKILL.md +139 -0
  189. package/agents/reversa-ideator/agents/openai.yaml +5 -0
  190. package/agents/reversa-image-prompt-json/SKILL.md +210 -0
  191. package/agents/reversa-image-prompt-json/agents/openai.yaml +5 -0
  192. package/agents/reversa-image-prompt-json/references/Examples.md +123 -0
  193. package/agents/reversa-inspector/SKILL.md +147 -0
  194. package/agents/reversa-inspector/agents/openai.yaml +5 -0
  195. package/agents/reversa-inspector/references/parity-coverage-matrix.md +54 -0
  196. package/agents/reversa-inspector/references/templates/parity_specs.md +64 -0
  197. package/agents/reversa-inspector/references/templates/parity_test.feature +40 -0
  198. package/agents/reversa-migrate/SKILL.md +282 -0
  199. package/agents/reversa-migrate/agents/openai.yaml +3 -0
  200. package/agents/reversa-migrate/references/auto-defaults.md +52 -0
  201. package/agents/reversa-migrate/references/expected_legacy_artifacts.yaml +69 -0
  202. package/agents/reversa-migrate/references/handoff-checklist.md +34 -0
  203. package/agents/reversa-migrate/references/state.json +28 -0
  204. package/agents/reversa-migrate/references/templates/ambiguity_log.md +43 -0
  205. package/agents/reversa-migrate/references/templates/handoff.md +91 -0
  206. package/agents/reversa-migrate/references/templates/migration_brief.md +52 -0
  207. package/agents/reversa-migrate/references/templates/pending_decisions.md +36 -0
  208. package/agents/reversa-modularize/SKILL.md +77 -0
  209. package/agents/reversa-modularize/agents/openai.yaml +5 -0
  210. package/agents/reversa-n8n/SKILL.md +256 -0
  211. package/agents/reversa-n8n/agents/openai.yaml +5 -0
  212. package/agents/reversa-n8n/references/node-catalog.md +245 -0
  213. package/agents/reversa-new/SKILL.md +328 -0
  214. package/agents/reversa-new/agents/openai.yaml +3 -0
  215. package/agents/reversa-optimize/SKILL.md +80 -0
  216. package/agents/reversa-optimize/agents/openai.yaml +5 -0
  217. package/agents/reversa-paradigm-advisor/SKILL.md +168 -0
  218. package/agents/reversa-paradigm-advisor/agents/openai.yaml +5 -0
  219. package/agents/reversa-paradigm-advisor/references/paradigm-catalog.md +73 -0
  220. package/agents/reversa-paradigm-advisor/references/templates/paradigm_decision.md +69 -0
  221. package/agents/reversa-plan/SKILL.md +92 -0
  222. package/agents/reversa-plan/agents/openai.yaml +5 -0
  223. package/agents/reversa-pre-spec/SKILL.md +133 -0
  224. package/agents/reversa-pre-spec/agents/openai.yaml +5 -0
  225. package/agents/reversa-pricing/SKILL.md +181 -0
  226. package/agents/reversa-pricing/agents/openai.yaml +3 -0
  227. package/agents/reversa-pricing-advisor/SKILL.md +322 -0
  228. package/agents/reversa-pricing-advisor/agents/openai.yaml +5 -0
  229. package/agents/reversa-pricing-advisor/references/advisor-schema.json +196 -0
  230. package/agents/reversa-pricing-advisor/references/advisor-template.md +106 -0
  231. package/agents/reversa-pricing-advisor/references/sale-models.md +237 -0
  232. package/agents/reversa-pricing-estimate/SKILL.md +287 -0
  233. package/agents/reversa-pricing-estimate/agents/openai.yaml +5 -0
  234. package/agents/reversa-pricing-estimate/references/effort-formula.md +146 -0
  235. package/agents/reversa-pricing-estimate/references/estimate-schema.json +141 -0
  236. package/agents/reversa-pricing-estimate/references/estimate-template.md +153 -0
  237. package/agents/reversa-pricing-estimate/references/example-estimate.json +74 -0
  238. package/agents/reversa-pricing-estimate/references/example-estimate.md +88 -0
  239. package/agents/reversa-pricing-estimate/references/market-benchmarks.md +102 -0
  240. package/agents/reversa-pricing-estimate/references/value-formula.md +123 -0
  241. package/agents/reversa-pricing-product/SKILL.md +299 -0
  242. package/agents/reversa-pricing-product/agents/openai.yaml +5 -0
  243. package/agents/reversa-pricing-product/references/breakeven-formula.md +237 -0
  244. package/agents/reversa-pricing-product/references/product-schema.json +288 -0
  245. package/agents/reversa-pricing-product/references/product-template.md +113 -0
  246. package/agents/reversa-pricing-product/references/store-commissions.md +57 -0
  247. package/agents/reversa-pricing-profile/SKILL.md +390 -0
  248. package/agents/reversa-pricing-profile/agents/openai.yaml +5 -0
  249. package/agents/reversa-pricing-profile/references/example-profile.json +23 -0
  250. package/agents/reversa-pricing-profile/references/example-profile.md +46 -0
  251. package/agents/reversa-pricing-profile/references/profile-schema.json +227 -0
  252. package/agents/reversa-pricing-profile/references/tax-regimes.md +106 -0
  253. package/agents/reversa-pricing-research/SKILL.md +352 -0
  254. package/agents/reversa-pricing-research/agents/openai.yaml +5 -0
  255. package/agents/reversa-pricing-research/references/research-policy.md +213 -0
  256. package/agents/reversa-pricing-research/references/research-schema.json +330 -0
  257. package/agents/reversa-pricing-size/SKILL.md +205 -0
  258. package/agents/reversa-pricing-size/agents/openai.yaml +5 -0
  259. package/agents/reversa-pricing-size/references/example-size.json +41 -0
  260. package/agents/reversa-pricing-size/references/size-schema.json +120 -0
  261. package/agents/reversa-pricing-size/references/sizing-formula.md +183 -0
  262. package/agents/reversa-principles/SKILL.md +82 -0
  263. package/agents/reversa-principles/agents/openai.yaml +5 -0
  264. package/agents/reversa-prune/SKILL.md +85 -0
  265. package/agents/reversa-prune/agents/openai.yaml +5 -0
  266. package/agents/reversa-quality/SKILL.md +87 -0
  267. package/agents/reversa-quality/agents/openai.yaml +5 -0
  268. package/agents/reversa-reconstructor/SKILL.md +243 -0
  269. package/agents/reversa-reconstructor/agents/openai.yaml +5 -0
  270. package/agents/reversa-reconstructor/references/reconstruction-plan-migration-template.md +89 -0
  271. package/agents/reversa-reconstructor/references/reconstruction-plan-template.md +77 -0
  272. package/agents/reversa-refactor/SKILL.md +112 -0
  273. package/agents/reversa-refactor/agents/openai.yaml +3 -0
  274. package/agents/reversa-refactor/references/opportunity-schema.md +68 -0
  275. package/agents/reversa-refactor/references/refactor-readme-template.md +35 -0
  276. package/agents/reversa-requirements/SKILL.md +217 -0
  277. package/agents/reversa-requirements/agents/openai.yaml +5 -0
  278. package/agents/reversa-researcher/SKILL.md +136 -0
  279. package/agents/reversa-researcher/agents/openai.yaml +5 -0
  280. package/agents/reversa-restructure/SKILL.md +78 -0
  281. package/agents/reversa-restructure/agents/openai.yaml +5 -0
  282. package/agents/reversa-resume/SKILL.md +141 -0
  283. package/agents/reversa-resume/agents/openai.yaml +5 -0
  284. package/agents/reversa-reviewer/SKILL.md +163 -0
  285. package/agents/reversa-reviewer/agents/openai.yaml +5 -0
  286. package/agents/reversa-reviewer/references/confidence-report-template.md +73 -0
  287. package/agents/reversa-reviewer/references/confidence-rules.md +65 -0
  288. package/agents/reversa-reviewer/references/questions-template.md +74 -0
  289. package/agents/reversa-scout/SKILL.md +82 -0
  290. package/agents/reversa-scout/agents/openai.yaml +5 -0
  291. package/agents/reversa-scout/references/surface-schema.md +93 -0
  292. package/agents/reversa-screen-translator/SKILL.md +279 -0
  293. package/agents/reversa-screen-translator/agents/openai.yaml +5 -0
  294. package/agents/reversa-screen-translator/references/adapter-pairs.md +97 -0
  295. package/agents/reversa-screen-translator/references/platform-detection.md +73 -0
  296. package/agents/reversa-screen-translator/references/templates/golden_manifest.yaml +62 -0
  297. package/agents/reversa-screen-translator/references/templates/inventory.schema.json +132 -0
  298. package/agents/reversa-screen-translator/references/templates/screen_deviation_log.md +66 -0
  299. package/agents/reversa-screen-translator/references/templates/screen_modernization_decision.md +106 -0
  300. package/agents/reversa-screen-translator/references/templates/target_screens.md +206 -0
  301. package/agents/reversa-selo-generativo/SKILL.md +176 -0
  302. package/agents/reversa-selo-generativo/agents/openai.yaml +5 -0
  303. package/agents/reversa-selo-generativo/references/ERRORS.md +212 -0
  304. package/agents/reversa-selo-generativo/references/GENERATIVE_PATTERNS.md +365 -0
  305. package/agents/reversa-selo-generativo/references/PALETTE_BY_STYLE.md +176 -0
  306. package/agents/reversa-simplify/SKILL.md +79 -0
  307. package/agents/reversa-simplify/agents/openai.yaml +5 -0
  308. package/agents/reversa-spec-sdd/SKILL.md +278 -0
  309. package/agents/reversa-spec-sdd/agents/openai.yaml +5 -0
  310. package/agents/reversa-spec-sdd/assets/spec_examples.md +159 -0
  311. package/agents/reversa-spec-sdd/references/evaluation_rubric.md +113 -0
  312. package/agents/reversa-spec-sdd/references/sdd_guide.md +124 -0
  313. package/agents/reversa-spec-sdd/references/spec_template.md +231 -0
  314. package/agents/reversa-spec-sdd/scripts/spec_scorer.py +476 -0
  315. package/agents/reversa-standardize/SKILL.md +76 -0
  316. package/agents/reversa-standardize/agents/openai.yaml +5 -0
  317. package/agents/reversa-strategist/SKILL.md +119 -0
  318. package/agents/reversa-strategist/agents/openai.yaml +5 -0
  319. package/agents/reversa-strategist/references/migration-strategies.md +41 -0
  320. package/agents/reversa-strategist/references/templates/cutover_plan.md +60 -0
  321. package/agents/reversa-strategist/references/templates/migration_strategy.md +55 -0
  322. package/agents/reversa-strategist/references/templates/risk_register.md +44 -0
  323. package/agents/reversa-sync/SKILL.md +100 -0
  324. package/agents/reversa-sync/agents/openai.yaml +5 -0
  325. package/agents/reversa-to-do/SKILL.md +89 -0
  326. package/agents/reversa-to-do/agents/openai.yaml +5 -0
  327. package/agents/reversa-visor/SKILL.md +91 -0
  328. package/agents/reversa-visor/agents/openai.yaml +5 -0
  329. package/agents/reversa-writer/SKILL.md +212 -0
  330. package/agents/reversa-writer/agents/openai.yaml +5 -0
  331. package/agents/reversa-writer/references/design-template.md +49 -0
  332. package/agents/reversa-writer/references/requirements-template.md +62 -0
  333. package/agents/reversa-writer/references/tasks-template.md +39 -0
  334. package/bin/reversa.js +65 -0
  335. package/lib/commands/add-engine.js +97 -0
  336. package/lib/commands/export-diagrams.js +194 -0
  337. package/lib/commands/install.js +260 -0
  338. package/lib/commands/status.js +35 -0
  339. package/lib/commands/uninstall.js +159 -0
  340. package/lib/commands/update.js +252 -0
  341. package/lib/installer/bundled.js +42 -0
  342. package/lib/installer/detector.js +167 -0
  343. package/lib/installer/manifest.js +61 -0
  344. package/lib/installer/orange-prompts.js +13 -0
  345. package/lib/installer/policy.js +53 -0
  346. package/lib/installer/prompts.js +252 -0
  347. package/lib/installer/validator.js +22 -0
  348. package/lib/installer/writer.js +376 -0
  349. package/lib/utils/banner.js +35 -0
  350. package/lib/utils/json-safe.js +10 -0
  351. package/lib/utils/package-info.js +22 -0
  352. package/package.json +51 -4
  353. package/templates/config.toml +46 -0
  354. package/templates/config.user.toml +8 -0
  355. package/templates/documentation/assets/css/style.css +476 -0
  356. package/templates/documentation/assets/js/nav.js +141 -0
  357. package/templates/documentation/assets/js/sidebar.js +162 -0
  358. package/templates/documentation/demo/viewer-demo.html +200 -0
  359. package/templates/documentation/pages/arquitetura.html.tpl +36 -0
  360. package/templates/documentation/pages/deck.html.tpl +27 -0
  361. package/templates/documentation/pages/features/feature.html.tpl +44 -0
  362. package/templates/documentation/pages/glossario.html.tpl +30 -0
  363. package/templates/documentation/pages/index.html.tpl +32 -0
  364. package/templates/documentation/pages/metricas.html.tpl +43 -0
  365. package/templates/documentation/pages/modulos.html.tpl +33 -0
  366. package/templates/documentation/pages/timeline.html.tpl +33 -0
  367. package/templates/documentation/pages/topologia.html.tpl +31 -0
  368. package/templates/documentation/scripts/convert_chronicle.py +71 -0
  369. package/templates/documentation/scripts/convert_soul.py +73 -0
  370. package/templates/documentation/scripts/extract_deps.py +54 -0
  371. package/templates/documentation/scripts/extract_modules.py +90 -0
  372. package/templates/documentation/scripts/list_specs.py +74 -0
  373. package/templates/documentation/viewer.html +60 -0
  374. package/templates/engines/AGENTS.md +26 -0
  375. package/templates/engines/CLAUDE.md +27 -0
  376. package/templates/engines/CONVENTIONS.md +26 -0
  377. package/templates/engines/GEMINI.md +26 -0
  378. package/templates/engines/amazonq +7 -0
  379. package/templates/engines/clinerules +7 -0
  380. package/templates/engines/copilot-instructions +26 -0
  381. package/templates/engines/cursorrules +7 -0
  382. package/templates/engines/roorules +7 -0
  383. package/templates/engines/windsurf +7 -0
  384. package/templates/forward/body/actions-template.md +83 -0
  385. package/templates/forward/body/principles-template.md +75 -0
  386. package/templates/forward/body/quality-template.md +103 -0
  387. package/templates/forward/body/requirements-template.md +121 -0
  388. package/templates/forward/body/roadmap-template.md +107 -0
  389. package/templates/forward/hooks.yml +60 -0
  390. package/templates/forward/scripts/ps/bind-to-extraction.ps1 +71 -0
  391. package/templates/forward/scripts/ps/prepare-roadmap.ps1 +84 -0
  392. package/templates/forward/scripts/ps/verify-prerequisites.ps1 +103 -0
  393. package/templates/forward/scripts/sh/bind-to-extraction.sh +103 -0
  394. package/templates/forward/scripts/sh/prepare-roadmap.sh +79 -0
  395. package/templates/forward/scripts/sh/verify-prerequisites.sh +125 -0
  396. package/templates/forward/setup.json +24 -0
  397. package/templates/hooks/README.md +41 -0
  398. package/templates/hooks/check-legacy-policy.mjs +0 -0
  399. package/templates/migration/artifacts/ambiguity_log.md +43 -0
  400. package/templates/migration/artifacts/cutover_plan.md +60 -0
  401. package/templates/migration/artifacts/data_migration_plan.md +80 -0
  402. package/templates/migration/artifacts/discard_log.md +37 -0
  403. package/templates/migration/artifacts/handoff.md +76 -0
  404. package/templates/migration/artifacts/migration_brief.md +52 -0
  405. package/templates/migration/artifacts/migration_strategy.md +55 -0
  406. package/templates/migration/artifacts/paradigm_decision.md +69 -0
  407. package/templates/migration/artifacts/parity_specs.md +64 -0
  408. package/templates/migration/artifacts/parity_test.feature +40 -0
  409. package/templates/migration/artifacts/pending_decisions.md +36 -0
  410. package/templates/migration/artifacts/risk_register.md +44 -0
  411. package/templates/migration/artifacts/target_architecture.md +68 -0
  412. package/templates/migration/artifacts/target_business_rules.md +54 -0
  413. package/templates/migration/artifacts/target_data_model.md +64 -0
  414. package/templates/migration/artifacts/target_domain_model.md +62 -0
  415. package/templates/migration/catalogs/migration_strategies.md +101 -0
  416. package/templates/migration/catalogs/paradigm_catalog.md +101 -0
  417. package/templates/migration/expected_legacy_artifacts.yaml +77 -0
  418. package/templates/migration/state.json +28 -0
  419. package/templates/plan.md +65 -0
  420. package/templates/reversa-config.json +5 -0
  421. package/templates/state.json +18 -0
@@ -0,0 +1,282 @@
1
+ ---
2
+ name: reversa-migrate
3
+ description: "Orquestrador do Time de Migração do Reversa. Conduz o pipeline de migração após o `/reversa` ter populado o _reversa_sdd/. Coleta brief, invoca os 6 agentes (Paradigm Advisor → Curator → Strategist → Designer → Screen Translator → Inspector) com pausas humanas, e gera handoff.md final. Use quando o usuário digitar `/reversa-migrate`, `reversa-migrate`, `migrar sistema`, `iniciar migração`."
4
+ license: MIT
5
+ compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
6
+ metadata:
7
+ author: sandeco
8
+ version: "1.0.0"
9
+ framework: reversa
10
+ role: orchestrator
11
+ team: migration
12
+ ---
13
+
14
+ Você é o **orquestrador `/reversa-migrate`**, responsável por conduzir o time de migração do Reversa: 6 agentes especializados que transformam as specs do legado em specs prontas para reconstrução em uma stack moderna.
15
+
16
+ A migração é um **passo seguinte** ao fluxo principal do Reversa. O usuário primeiro executa `/reversa` no sistema legado, que dispara o Time de Descoberta (Scout → Archaeologist → Detective → Architect → Writer → Reviewer) e popula `_reversa_sdd/`. Apenas após essa etapa o `/reversa-migrate` pode rodar.
17
+
18
+ ## Pipeline
19
+
20
+ ```
21
+ Time de Descoberta: Scout → Archaeologist → Detective → Architect → Writer → Reviewer
22
+ │
23
+ ▼
24
+ _reversa_sdd/
25
+ │
26
+ ▼
27
+ Time de Migração: Paradigm Advisor → Curator → Strategist → Designer → Screen Translator → Inspector
28
+ │
29
+ ▼
30
+ _reversa_sdd/migration/
31
+ │
32
+ ▼
33
+ Agente de codificação do usuário escreve código
34
+ ```
35
+
36
+ O orquestrador **não** toca em código legado, **não** faz parsing de schemas, **não** faz arqueologia. Opera 100% no nível das specs já produzidas.
37
+
38
+ ## Comportamento ao ser ativado
39
+
40
+ Execute estritamente nesta ordem:
41
+
42
+ ### Passo 1: Pré-condições
43
+
44
+ 1. Verifique que `_reversa_sdd/` existe.
45
+ - Se não: encerre com a mensagem:
46
+ > "Não encontrei `_reversa_sdd/`. Execute `/reversa` primeiro para gerar as specs do sistema legado."
47
+ 2. Carregue a lista de artefatos esperados em `references/expected_legacy_artifacts.yaml` (cópia local da skill).
48
+ 3. Para cada artefato `required: true`, verifique presença em `_reversa_sdd/` (considere também aliases declarados).
49
+ - Se algum faltar: liste todos os faltantes, informe que o pipeline está bloqueado, peça ao usuário rodar `/reversa` novamente, e encerre.
50
+
51
+ ### Passo 2: Estado e modo
52
+
53
+ 1. Se `_reversa_sdd/migration/.state.json` **não existir**: este é primeiro run; siga para o passo 3.
54
+ 2. Se existir: leia. Identifique `currentAgent.agent`, `currentAgent.phase`, `currentAgent.status`, `completedAgents`.
55
+ - **Caso especial: pausa intra-agente pendente.** Se `currentAgent.status == "awaiting_user_approval"` (típico após Designer Fase 1, sessão fechada antes da aprovação): releia o artefato em pausa (`topology_decision.md` quando `phase == "topology"`), reconstrua o resumo de 3 a 8 linhas usando o template do passo correspondente do agente, e re-execute a pausa humana antes de prosseguir. Não ofereça menu de opções até resolver a pausa.
56
+ - **Caso normal**, pergunte ao usuário:
57
+ > "Encontrei uma migração em andamento. Concluído: <agentes>. Pendente: <agentes>.
58
+ > 1. Continuar de onde parou (`--resume`)
59
+ > 2. Recriar tudo (`--regenerate=paradigm_advisor`)
60
+ > 3. Recriar a partir de um agente específico
61
+ > 4. Cancelar"
62
+ 3. **Modo `--auto`**: se o usuário invocou explicitamente `--auto`, exiba aviso listando todos os defaults que serão aplicados (ver `references/auto-defaults.md`) e peça confirmação antes de prosseguir.
63
+
64
+ ### Passo 3: Coleta do brief (entrevista)
65
+
66
+ Se `_reversa_sdd/migration/migration_brief.md` **não existir**, conduza a entrevista; caso contrário, ofereça `revisar / manter / recriar`.
67
+
68
+ Perguntas mínimas (uma por vez ou agrupadas, conforme a engine):
69
+
70
+ 1. **Objetivo da migração**: por que estamos migrando?
71
+ 2. **Métricas de sucesso**: como saberemos que deu certo?
72
+ 3. **Restrições**: prazo, orçamento, técnicas, regulatórias.
73
+ 4. **Fatores de risco conhecidos**.
74
+ 5. **Stakeholders**: quem precisa ser ouvido / informado?
75
+ 6. **Stack alvo**: linguagem, framework, banco, infra, mensageria, observabilidade.
76
+ 7. **Escopo**: módulos incluídos e excluídos.
77
+
78
+ **Não pergunte paradigma. Não pergunte apetite.** Esses são responsabilidade do Paradigm Advisor.
79
+
80
+ Renderize `_reversa_sdd/migration/migration_brief.md` usando o template em `references/templates/migration_brief.md`.
81
+
82
+ ### Passo 4: Inicializar `.state.json`
83
+
84
+ Crie `_reversa_sdd/migration/.state.json` a partir do template `references/state.json`. Preencha `startedAt`, `engine`, `reversaVersion`. Marque `currentAgent.agent = "paradigm_advisor"`, `currentAgent.phase = null`, `currentAgent.status = "running"`, `currentAgent.topologyApproved = false`.
85
+
86
+ **Contrato do `currentAgent`** (objeto, não string):
87
+ - `agent`: id do agente atualmente ativo (`paradigm_advisor` | `curator` | `strategist` | `designer` | `screen_translator` | `inspector` | `null` quando ocioso).
88
+ - `phase`: nome da sub-fase (apenas quando o agente declara fases; ex: `"topology"` ou `"architecture"` para o Designer; `"mode"` ou `"generation"` para o Screen Translator; `null` para os demais).
89
+ - `status`: `running` | `awaiting_user_approval` | `complete` | `failed` | `skipped`.
90
+ - `topologyApproved`: `true` somente após o usuário aprovar `topology_decision.md`. Persiste durante toda a vida da migração; é fonte única de verdade.
91
+ - `screenModeApproved`: `true` somente após o usuário aprovar `screen_modernization_decision.md`. Persiste durante toda a vida da migração. Ausência ou `false` significa não aprovado.
92
+
93
+ Ao transicionar para o próximo agente, **reescreva o objeto inteiro**, não atribua uma string. Ao mover um agente para `completedAgents`, defina `currentAgent.agent` para o próximo da fila (ou `null` ao final), reset `phase` e `status`, e **preserve** `topologyApproved` e `screenModeApproved` (eles não pertencem à transição de agente).
94
+
95
+ `status: skipped` é usado quando um agente conclui sem produzir artefatos por falta de aplicabilidade (ex: Screen Translator em legado sem UI). O agente é movido para `completedAgents` normalmente, com a justificativa registrada em `ambiguity_log.md`.
96
+
97
+ ### Passo 5: Executar os 6 agentes em sequência
98
+
99
+ Para cada agente, faça:
100
+
101
+ 1. Anuncie ao usuário: `"Iniciando o **<Agente>**, <responsabilidade curta>."`.
102
+ 2. Ative a skill do agente (`reversa-paradigm-advisor`, `reversa-curator`, `reversa-strategist`, `reversa-designer`, `reversa-screen-translator`, `reversa-inspector`). Se a engine não suportar ativação direta por nome, instrua a leitura de `.agents/skills/<id>/SKILL.md` no contexto atual.
103
+ 3. Aguarde a conclusão **ou** um checkpoint intra-agente (ver passo 5b). Se for conclusão, valide os artefatos previstos.
104
+ 4. Atualize `.state.json`: mover agente de `pendingAgents` → `completedAgents`, atualizar `lastCheckpoint`, registrar artefatos com hash SHA-256.
105
+ 5. **Pausa humana** (ver passo 6) antes de prosseguir, conforme tabela abaixo.
106
+
107
+ #### Passo 5b: Checkpoint intra-agente
108
+
109
+ Alguns agentes operam em fases com pausa humana entre elas. Hoje, **Designer** e **Screen Translator** se comportam assim. Cada um declara as próprias fases na seção "Detecção de fase ao iniciar" do SKILL.md, e usa um campo `<artifact>Approved` no `currentAgent` como fonte única de verdade da aprovação.
110
+
111
+ | Agente | Fase 1 (decide, pausa) | Artefato | Campo de aprovação | Fase 2 (gera) |
112
+ |---|---|---|---|---|
113
+ | Designer | `topology` | `topology_decision.md` | `topologyApproved` | `architecture` (Designer Fase 2) |
114
+ | Screen Translator | `mode` | `screen_modernization_decision.md` | `screenModeApproved` | `generation` (target_screens, deviations, golden) |
115
+
116
+ Fluxo genérico:
117
+
118
+ 1. Agente roda Fase 1, escreve o artefato de decisão e devolve controle com sinal `phase: <nome-da-fase-1>, status: awaiting_user_approval`.
119
+ 2. Orquestrador grava em `.state.json` o campo `currentAgent.phase` e `currentAgent.status`. **Não** move o agente para `completedAgents`.
120
+ 3. Orquestrador executa a pausa humana descrita no passo 6 (linha correspondente da tabela).
121
+ 4. Após aprovação, orquestrador registra `currentAgent.<artifact>Approved = true`. Essa é a fonte única de verdade; **não** duplicar no front-matter do artefato.
122
+ 5. Orquestrador **re-ativa o mesmo agente**. O agente detecta que o artefato existe e está aprovado, e pula direto para a Fase 2.
123
+ 6. Ao concluir a Fase 2, o agente devolve controle com `status: complete` (ou `skipped` se for o caso do Screen Translator em legado sem UI). O orquestrador roda a pausa correspondente na tabela.
124
+ 7. Se o usuário pedir ajustes em qualquer das duas fases, orquestrador re-ativa o agente apontando explicitamente qual fase deve ser refeita:
125
+ - Designer: `--regenerate-phase=topology` ou `--regenerate-phase=architecture`.
126
+ - Screen Translator: `--regenerate-phase=mode` ou `--regenerate-phase=generation`.
127
+ O agente respeita e descarta artefatos da fase em diante.
128
+
129
+ Esse mecanismo é genérico: novos agentes podem adotá-lo declarando seus checkpoints na seção "Detecção de fase ao iniciar" do próprio SKILL.md e adicionando um campo `<artifact>Approved` ao contrato do `currentAgent`.
130
+
131
+ | Após o agente | Pausa para |
132
+ |---|---|
133
+ | Paradigm Advisor | Confirmar paradigma e gap |
134
+ | Curator | Revisar itens DECISÃO HUMANA |
135
+ | Strategist | Escolher estratégia |
136
+ | Designer (Fase 1) | Aprovar `topology_decision.md` (preservar / modernizar / híbrido) antes de detalhar arquitetura |
137
+ | Designer (Fase 2) | Aprovar arquitetura (se ajustes, Designer roda novamente) |
138
+ | Screen Translator (Fase 1) | Aprovar `screen_modernization_decision.md` (literal / modernizado / híbrido). Em modo híbrido, listas explícitas de telas por modo são obrigatórias. Em legado sem UI, agente pula sem pausa. |
139
+ | Screen Translator (Fase 2) | Aprovar deviations pendentes em `screen_deviation_log.md` (se houver) antes de seguir ao Inspector |
140
+ | Inspector | (sem pausa; segue para handoff) |
141
+
142
+ ### Passo 6: Pausa humana (`human_decision_gate`)
143
+
144
+ Em cada pausa:
145
+
146
+ 1. Apresente um resumo claro do que o agente anterior produziu (3 a 8 linhas).
147
+ 2. Liste explicitamente o que precisa de decisão.
148
+ 3. Aguarde resposta do usuário.
149
+
150
+ Comportamento por engine:
151
+
152
+ - **Engines com chat interativo (Claude Code, Cursor, Codex, etc.)**: pergunte direto no chat e aguarde.
153
+ - **Engines sem TTY interativo**: escreva `_reversa_sdd/migration/pending_decisions.md` com as decisões abertas, instrua o usuário a editar e sinalizar conclusão; releia o arquivo após sinalização.
154
+ - **Modo `--auto`**: aplique os defaults documentados em `references/auto-defaults.md`. Marque cada decisão auto-aplicada em `ambiguity_log.md` para revisão posterior.
155
+
156
+ ### Passo 7: Consolidar `ambiguity_log.md`
157
+
158
+ Após cada agente, integre itens ⚠️ e pendências em `_reversa_sdd/migration/ambiguity_log.md`. Ao final, organize em três grupos:
159
+
160
+ - PENDENTES (não pode haver após Inspector concluir)
161
+ - RESOLVIDOS COM DECISÃO HUMANA
162
+ - REFERIDOS À CODIFICAÇÃO
163
+
164
+ ### Passo 8: Gerar `handoff.md`
165
+
166
+ Após Inspector concluir e `ambiguity_log` consolidado:
167
+
168
+ 1. Renderize `_reversa_sdd/migration/handoff.md` usando o template em `references/templates/handoff.md`.
169
+ 2. Liste todos os artefatos produzidos.
170
+ 3. **Destaque `paradigm_decision.md` e `topology_decision.md` como leitura obrigatória primeiro** (paradigma decide o "como pensar"; topologia decide o "como organizar a árvore").
171
+ 4. Liste itens REFERIDOS À CODIFICAÇÃO em seção dedicada.
172
+ 5. Adicione próximos passos específicos para o agente de codificação (configurar repositório novo, implementar bottom-up, validar paridade, executar cutover).
173
+ 6. Em modo `--auto`: liste itens auto-decididos para revisão posterior.
174
+
175
+ ### Passo 9: Resumo final e logs
176
+
177
+ Apresente no chat:
178
+
179
+ > "Migração concluída.
180
+ > - Agentes executados: 6 (Screen Translator pode ter rodado em modo `skipped` se o legado não tem UI)
181
+ > - Artefatos criados: <N>
182
+ > - Itens em `ambiguity_log.md`: <N> pendentes (esperado 0), <N> resolvidos, <N> referidos à codificação
183
+ > - Tempo total: <minutos>
184
+ >
185
+ > Próximo passo: abra `_reversa_sdd/migration/handoff.md` no agente de codificação que vai implementar o sistema novo."
186
+
187
+ Grave log completo em `_reversa_sdd/migration/.logs/<timestamp>-migrate.log` com timestamp por entrada e identificação do agente. Se a engine expor contagem de tokens ou custo, registre; se não, deixe campos vazios sem invalidar o log.
188
+
189
+ ## Modos especiais
190
+
191
+ ### `--resume`
192
+
193
+ 1. Leia `.state.json`.
194
+ 2. Identifique `currentAgent.agent`, `currentAgent.phase` e `currentAgent.status`.
195
+ 3. Se `currentAgent.status == "awaiting_user_approval"`, siga o caso especial do passo 2 (re-executa a pausa pendente). Caso contrário, confirme com o usuário antes de retomar.
196
+ 4. Continue do agente seguinte (ou do próprio se ele estava `failed`, ou da próxima fase se ele estava `awaiting_user_approval` e foi resolvido).
197
+
198
+ ### `--regenerate=<agent>`, `--regenerate=designer:<phase>` ou `--regenerate=screen_translator:<phase>`
199
+
200
+ 1. Confirme com o usuário (operação destrutiva no escopo de `_reversa_sdd/migration/` e `_reversa_sdd/screens/`).
201
+ 2. Faça backup em `_reversa_sdd/migration/.backup-<timestamp>/` e, se aplicável ao Screen Translator, em `_reversa_sdd/screens/.backup-<timestamp>/`.
202
+ 3. Apague artefatos:
203
+ - `--regenerate=<agent>`: artefatos do agente especificado **e de todos os agentes posteriores** na ordem do pipeline. Para o Designer, inclui `topology_decision.md` e reseta `currentAgent.topologyApproved = false`. Para o Screen Translator, inclui `screen_modernization_decision.md`, `target_screens.md`, `screen_deviation_log.md`, `_reversa_sdd/screens/inventory.json` e `_reversa_sdd/screens/golden/`, e reseta `currentAgent.screenModeApproved = false`.
204
+ - `--regenerate=designer:topology`: apaga todos os artefatos do Designer (incluindo `topology_decision.md`) e reseta `topologyApproved`. Equivalente a `--regenerate=designer` mas explícito sobre voltar à Fase 1.
205
+ - `--regenerate=designer:architecture`: apaga apenas artefatos da Fase 2 do Designer (`target_architecture.md`, `target_domain_model.md`, `target_data_model.md`, `data_migration_plan.md`). Preserva `topology_decision.md` e `topologyApproved`.
206
+ - `--regenerate=screen_translator:mode`: apaga todos os artefatos do Screen Translator (incluindo `screen_modernization_decision.md`) e reseta `screenModeApproved`. Equivalente a `--regenerate=screen_translator` mas explícito sobre voltar à Fase 1.
207
+ - `--regenerate=screen_translator:generation`: apaga apenas artefatos da Fase 2 (`target_screens.md`, `screen_deviation_log.md`, `_reversa_sdd/screens/inventory.json`, `_reversa_sdd/screens/golden/`). Preserva `screen_modernization_decision.md` e `screenModeApproved`.
208
+ 4. Atualize `.state.json` removendo agentes do `completedAgents` (quando aplicável) e ajustando `currentAgent`.
209
+ 5. Re-ative o agente com a flag de fase, se aplicável.
210
+
211
+ ### `--auto`
212
+
213
+ Aplica defaults sem pausas humanas. Ver `references/auto-defaults.md`.
214
+
215
+ Sempre exibir aviso explícito antes de iniciar listando todos os defaults aplicados.
216
+
217
+ ## Casos de borda
218
+
219
+ - **`_reversa_sdd/` incompleto**: lista artefatos faltantes e aborta.
220
+ - **Brief presente mas mudanças no sistema legado**: ofereça revisar / recriar antes de prosseguir.
221
+ - **Modificação manual de artefato gerado** (hash em `.state.json` divergente): pause, apresente diff resumido e ofereça (a) preservar versão modificada e abortar regeneração, (b) sobrescrever com backup, (c) abortar pipeline. `--auto` adota (a) por default.
222
+ - **Falha de LLM no meio do agente**: estado preservado, agente marcado como `failed`. `--resume` reexecuta esse agente.
223
+ - **Agente Designer pediu ajustes** após revisão da arquitetura: rerodar Designer no mesmo passo, sem avançar para Inspector.
224
+
225
+ ## Layout de saída (transversal)
226
+
227
+ Este agente faz parte do Time de Migração e escreve exclusivamente em `_reversa_sdd/migration/`. Essa pasta é transversal à organização escolhida em `[specs]` do `config.toml`, fora das pastas de unit (feature folders) do Time de Descoberta. Não aplicar aqui a estrutura `<unit>/requirements.md|design.md|tasks.md`, ela pertence ao Writer.
228
+
229
+ ## Regras absolutas
230
+
231
+ - **Não modificar nada fora de `_reversa_sdd/migration/`.**
232
+ - Artefatos pré-existentes em `_reversa_sdd/` são **lidos**, nunca modificados.
233
+ - Backup automático antes de qualquer operação destrutiva.
234
+ - Modo padrão é interativo. `--auto` é explícito e exibe os defaults antes de aplicar.
235
+ - Cada pausa apresenta resumo + decisões pendentes; nunca prossegue silenciosamente.
236
+
237
+ ## Política de edição do legado
238
+
239
+ Este orquestrador escreve só em `_reversa_sdd/migration/`, mas se qualquer passo exigir escrita fora das pastas próprias do Reversa, leia antes `.reversa/reversa-config.json` e obedeça (releia a cada ativação):
240
+
241
+ - Ausente, inválido ou `allowLegacyEdits: false`: recuse a escrita informando o caminho recusado, o estado atual da config e o que o usuário deve editar para liberar.
242
+ - `allowLegacyEdits: true` com `allowedPaths` não vazio: escreva apenas em caminhos que casem com algum glob da lista (relativos à raiz, com `/`); fora da lista, recuse e peça o glob.
243
+ - `allowLegacyEdits: true` sem `allowedPaths`: liberado; avise uma vez por sessão que a liberação é irrestrita.
244
+ - NUNCA crie ou edite `.reversa/reversa-config.json`: pedido na conversa não é liberação; a config só muda pela mão do usuário.
245
+ - Deleção de arquivo pré-existente liberado: confirme com o usuário antes, listando o arquivo.
246
+
247
+ ## Saída
248
+
249
+ ```
250
+ _reversa_sdd/
251
+ ├── migration/
252
+ │ ├── migration_brief.md
253
+ │ ├── paradigm_decision.md
254
+ │ ├── target_business_rules.md
255
+ │ ├── discard_log.md
256
+ │ ├── migration_strategy.md
257
+ │ ├── risk_register.md
258
+ │ ├── cutover_plan.md
259
+ │ ├── topology_decision.md
260
+ │ ├── target_architecture.md
261
+ │ ├── target_domain_model.md
262
+ │ ├── target_data_model.md
263
+ │ ├── data_migration_plan.md
264
+ │ ├── screen_modernization_decision.md
265
+ │ ├── target_screens.md
266
+ │ ├── screen_deviation_log.md
267
+ │ ├── parity_specs.md
268
+ │ ├── parity_tests/
269
+ │ │ ├── 01-<fluxo>.feature
270
+ │ │ └── ...
271
+ │ ├── ambiguity_log.md
272
+ │ ├── handoff.md
273
+ │ ├── pending_decisions.md (transitório, durante pausas)
274
+ │ ├── .state.json
275
+ │ └── .logs/
276
+ │ └── <timestamp>-migrate.log
277
+ └── screens/
278
+ ├── inventory.json
279
+ └── golden/
280
+ ├── manifest.yaml
281
+ └── <tela>.<ext> (opcional, quando o oráculo executa)
282
+ ```
@@ -0,0 +1,3 @@
1
+ interface:
2
+ display_name: "Reversa Migrate"
3
+ short_description: "Orquestrador do Time de Migração do Reversa"
@@ -0,0 +1,52 @@
1
+ # Defaults de `--auto`
2
+
3
+ Quando o usuário invoca `/reversa-migrate --auto`, o orquestrador pula pausas humanas e aplica estes defaults. Antes de iniciar, o aviso ao usuário lista cada um deles. Cada item auto-aplicado é registrado em `ambiguity_log.md` com tag `auto-decidido` para revisão posterior.
4
+
5
+ ## Paradigm Advisor
6
+ - Escolha **opção 1: adotar paradigma natural da stack alvo**.
7
+ - `derived_appetite` = `transformational`.
8
+
9
+ ## Curator
10
+ - Itens DECISÃO HUMANA são marcados como pendentes em `ambiguity_log.md` e não bloqueiam o pipeline.
11
+ - Itens 🟡 INFERIDOS → MIGRAR (com nota "validar no agente de codificação").
12
+ - Itens 🔴 LACUNA e ⚠️ AMBÍGUOS → DESCARTAR com nota explícita "auto-descartado, requer revisão".
13
+
14
+ ## Strategist
15
+ - Adota a estratégia marcada como **recomendada**.
16
+ - Riscos `crítico` que dependeriam de owner humano ficam com `owner = "a definir"` em `risk_register.md`.
17
+
18
+ ## Designer
19
+ - **Topologia (Fase 1)**: aceita a topologia moderna proposta (opção 2). Justificativa registrada em `topology_decision.md` é a do próprio Designer; no `ambiguity_log.md` fica a tag `auto-decidido` para revisão posterior. Rationale: `--auto` é para usuários que querem o caminho recomendado; refusing-to-decide pararia o pipeline e violaria o contrato de `--auto`.
20
+ - **Arquitetura (Fase 2)**: aprova a primeira proposta sem iteração.
21
+ - Bounded contexts, eventos e ADRs são aceitos como propostos.
22
+
23
+ ## Screen Translator
24
+ - **Modo (Fase 1)**: adota o modo recomendado pelo agente para o par origem→alvo detectado (literal para pares textuais; modernizado para mudanças de plataforma; híbrido só com lista explícita, portanto nunca em `--auto`).
25
+ - **Geração (Fase 2)**: aceita o `target_screens.md` gerado e propaga deviations como `pendente`. `--auto` não aprova deviations sozinho; elas ficam em `ambiguity_log.md` como `auto-decidido` para revisão posterior, sem bloquear o handoff (exceção a `--auto`: se uma deviation for `tipo=correcao` em modo literal, o agente recusa e pede aprovação humana mesmo em `--auto`, pois mudar texto sem aval rompe expectativa).
26
+ - **Captura de golden files**: não automatiza em `--auto` (driver de oráculo é OQ-02). Apenas emite `manifest.yaml` com comandos sugeridos.
27
+ - **Legado sem UI**: marca status `skipped` automaticamente, sem perguntar.
28
+ - **Pré-requisitos Discovery ausentes** (`_reversa_sdd/design-system/` ou `_reversa_sdd/ui/inventory.md`): cria `tokens-derived.md` mínimo e constrói inventário só a partir do código fonte; alerta no `ambiguity_log.md`.
29
+
30
+ ## Inspector
31
+ - Usa critérios de paridade derivados diretamente do paradigma escolhido (ver `parity-coverage-matrix.md` no agente).
32
+ - Não negocia critério "paridade aceita" com o usuário.
33
+
34
+ ## Modificações manuais detectadas
35
+ - Adota **opção (a)**: preservar a versão modificada manualmente e abortar regeneração desse artefato. Nunca destrói trabalho humano.
36
+
37
+ ## Aviso obrigatório
38
+
39
+ Sempre antes de iniciar `--auto`, apresentar:
40
+
41
+ > "⚠️ Modo `--auto` ativado. Os defaults abaixo serão aplicados sem pausa para confirmação:
42
+ > - Paradigm Advisor: adotar paradigma natural da stack (transformacional).
43
+ > - Curator: itens ⚠️/🔴 serão DESCARTADOS com nota; 🟡 serão MIGRADOS com nota.
44
+ > - Strategist: estratégia recomendada será adotada.
45
+ > - Designer (topologia): topologia moderna proposta será adotada (opção 2).
46
+ > - Designer (arquitetura): primeira proposta de arquitetura será aceita.
47
+ > - Screen Translator (modo): adota o modo recomendado para o par origem→alvo. Modo híbrido nunca em `--auto`. Em legado sem UI, status `skipped`.
48
+ > - Screen Translator (geração): deviations ficam pendentes em `ambiguity_log.md` (não aprovadas). Captura de golden files não automatizada (apenas manifesto).
49
+ > - Inspector: critérios de paridade derivados do paradigma sem ajuste interativo.
50
+ >
51
+ > O `handoff.md` final destacará todos os itens auto-decididos para revisão posterior.
52
+ > Confirma? (s/N)"
@@ -0,0 +1,69 @@
1
+ # Cópia local da lista de artefatos esperados em _reversa_sdd/.
2
+ # Fonte canônica: templates/migration/expected_legacy_artifacts.yaml
3
+ # Esta cópia é instalada junto com o agente para acesso direto dentro do projeto do usuário.
4
+
5
+ schemaVersion: 1
6
+ artifacts:
7
+ - path: "code-analysis.md"
8
+ kind: code_analysis
9
+ required: true
10
+ minSchemaVersion: 1
11
+ - path: "domain.md"
12
+ kind: domain_model
13
+ required: true
14
+ minSchemaVersion: 1
15
+ - path: "architecture.md"
16
+ kind: architecture
17
+ required: true
18
+ minSchemaVersion: 1
19
+ - path: "dependencies.md"
20
+ kind: dependencies
21
+ required: true
22
+ minSchemaVersion: 1
23
+ - path: "inventory.md"
24
+ kind: legacy_inventory
25
+ required: true
26
+ minSchemaVersion: 1
27
+ - path: "data-dictionary.md"
28
+ kind: data_dictionary
29
+ required: false
30
+ minSchemaVersion: 1
31
+ - path: "state-machines.md"
32
+ kind: state_machines
33
+ required: false
34
+ minSchemaVersion: 1
35
+ - path: "permissions.md"
36
+ kind: permissions
37
+ required: false
38
+ minSchemaVersion: 1
39
+ - path: "gaps.md"
40
+ kind: gaps
41
+ required: true
42
+ minSchemaVersion: 1
43
+ - path: "questions.md"
44
+ kind: questions
45
+ required: false
46
+ minSchemaVersion: 1
47
+ - path: "confidence-report.md"
48
+ kind: confidence_report
49
+ required: true
50
+ minSchemaVersion: 1
51
+ - path: "traceability/code-spec-matrix.md"
52
+ kind: code_spec_matrix
53
+ required: false
54
+ minSchemaVersion: 1
55
+ - path: "sdd"
56
+ kind: sdd_dir
57
+ required: false
58
+ minSchemaVersion: 1
59
+
60
+ aliases:
61
+ "domain.md":
62
+ - "domain_model.md"
63
+ "architecture.md":
64
+ - "architecture_legacy.md"
65
+ "code-analysis.md":
66
+ - "code_analysis.md"
67
+ - "process_flows.md"
68
+ "inventory.md":
69
+ - "legacy_inventory.md"
@@ -0,0 +1,34 @@
1
+ # Checklist do `handoff.md`
2
+
3
+ Antes de fechar o pipeline, o orquestrador valida que `handoff.md` cumpre todos os itens.
4
+
5
+ ## Checklist obrigatório
6
+
7
+ - [ ] `paradigm_decision.md` aparece como **primeiro item** da seção "Leitura obrigatória" e da "Ordem de leitura recomendada".
8
+ - [ ] `topology_decision.md` aparece como **segundo item** da seção "Leitura obrigatória".
9
+ - [ ] `screen_modernization_decision.md` aparece como **terceiro item** quando há UI; em legado sem UI (Screen Translator skipped), a entrada é omitida com nota explícita "Screen Translator pulado, legado sem UI".
10
+ - [ ] Lista de artefatos produzidos é completa e reflete `_reversa_sdd/migration/` e `_reversa_sdd/screens/` reais.
11
+ - [ ] Deviations pendentes em `screen_deviation_log.md` aparecem como bloqueadores; deviations aprovadas estão refletidas em `parity_specs.md § Exceções`.
12
+ - [ ] Itens REFERIDOS À CODIFICAÇÃO de `ambiguity_log.md` aparecem em seção dedicada de `handoff.md`.
13
+ - [ ] Bloqueadores listados ou linha "nenhum bloqueador, prosseguir".
14
+ - [ ] Próximos passos para o agente de codificação são específicos e acionáveis (não genéricos).
15
+ - [ ] Em `--auto`: itens auto-decididos listados explicitamente.
16
+ - [ ] Estilo coerente com a engine instalada (formato adaptado, ex: front-matter compatível).
17
+
18
+ ## Estrutura mínima
19
+
20
+ 1. Banner de leitura obrigatória do `paradigm_decision.md`, `topology_decision.md` e (se houver UI) `screen_modernization_decision.md`.
21
+ 2. Ordem de leitura recomendada.
22
+ 3. Lista de artefatos.
23
+ 4. Bloqueadores.
24
+ 5. Próximos passos para o agente de codificação.
25
+ 6. Itens auto-decididos (apenas se `--auto`).
26
+ 7. Notas finais.
27
+
28
+ ## Sinalização forte ao agente de codificação
29
+
30
+ A primeira frase de `handoff.md` deve transmitir clareza imediata. Padrão sugerido:
31
+
32
+ > "Sistema novo a ser construído em paradigma <X>, topologia <Y>, telas em modo <Z>. Antes de qualquer linha de código, leia `paradigm_decision.md`, `topology_decision.md` e `screen_modernization_decision.md`."
33
+
34
+ Em legado sem UI (Screen Translator skipped), substituir o trecho de telas por: "telas: nenhuma (sistema sem UI)".
@@ -0,0 +1,28 @@
1
+ {
2
+ "schemaVersion": 2,
3
+ "startedAt": null,
4
+ "lastCheckpoint": null,
5
+ "completedAgents": [],
6
+ "pendingAgents": [
7
+ "paradigm_advisor",
8
+ "curator",
9
+ "strategist",
10
+ "designer",
11
+ "screen_translator",
12
+ "inspector"
13
+ ],
14
+ "currentAgent": {
15
+ "agent": null,
16
+ "phase": null,
17
+ "status": null,
18
+ "topologyApproved": false,
19
+ "screenModeApproved": false
20
+ },
21
+ "pendingDecisions": [],
22
+ "artifacts": {},
23
+ "auto": false,
24
+ "engine": null,
25
+ "reversaVersion": "{{VERSION}}",
26
+ "briefPath": "_reversa_sdd/migration/migration_brief.md",
27
+ "expectedLegacyArtifacts": "references/expected_legacy_artifacts.yaml"
28
+ }
@@ -0,0 +1,43 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: ambiguity_log
7
+ producedBy: orchestrator
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Ambiguity Log
12
+
13
+ > Consolidação de todos os itens ⚠️ AMBÍGUOS ou pendentes detectados pelos agentes ao longo do pipeline.
14
+ > Status final esperado quando o pipeline conclui: nenhum item PENDENTE.
15
+
16
+ ## Resumo
17
+ - Total de itens: <N>
18
+ - PENDENTES: <n>
19
+ - RESOLVIDOS COM DECISÃO HUMANA: <n>
20
+ - REFERIDOS À CODIFICAÇÃO: <n>
21
+
22
+ ## Itens
23
+
24
+ ### AMB-001
25
+ - **Descrição**: <texto>
26
+ - **Detectado por**: paradigm_advisor | curator | strategist | designer | screen_translator | inspector
27
+ - **Origem**: <referência ao artefato e seção>
28
+ - **Status**: PENDENTE | RESOLVIDO COM DECISÃO HUMANA | REFERIDO À CODIFICAÇÃO
29
+ - **Decisão tomada** (se houver):
30
+ - **Escolha**: <texto>
31
+ - **Decisor**: <nome>
32
+ - **Quando**: <ISO-8601>
33
+ - **Justificativa**: <texto>
34
+
35
+ <repetir por item>
36
+
37
+ ## Itens referidos à codificação
38
+ > Lista somente itens com status `REFERIDO À CODIFICAÇÃO`. Aparecem destacados em `handoff.md`.
39
+
40
+ - AMB-XXX: <descrição curta>
41
+
42
+ ## Notas
43
+ <Observações finais do orquestrador.>
@@ -0,0 +1,91 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: handoff
7
+ producedBy: orchestrator
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Handoff para o Agente de Codificação
12
+
13
+ > Este documento é a porta de entrada para o agente de codificação (Claude Code, Codex, Cursor, Antigravity, etc.) que vai escrever o sistema novo a partir das specs.
14
+
15
+ ## ⚠️ Leitura obrigatória primeiro
16
+
17
+ 1. **`paradigm_decision.md`**, leitura inegociável. O paradigma alvo molda como toda a codificação deve acontecer.
18
+ 2. **`topology_decision.md`**, leitura inegociável. A topologia escolhida (preservar / modernizar / híbrido) define a árvore de pastas e a fronteira entre módulos.
19
+ 3. **`screen_modernization_decision.md`**, leitura inegociável quando o legado tem UI. O modo escolhido (literal / modernizado / híbrido) define como o codificador vai materializar as telas.
20
+
21
+ ## Ordem de leitura recomendada
22
+
23
+ 1. `paradigm_decision.md` (obrigatório, primeiro)
24
+ 2. `topology_decision.md` (obrigatório, segundo)
25
+ 3. `screen_modernization_decision.md` (obrigatório quando há UI; pular se Screen Translator rodou em modo skipped)
26
+ 4. `migration_brief.md`
27
+ 5. `target_business_rules.md`
28
+ 6. `migration_strategy.md`
29
+ 7. `target_architecture.md`
30
+ 8. `target_domain_model.md`
31
+ 9. `target_data_model.md`
32
+ 10. `data_migration_plan.md`
33
+ 11. `target_screens.md` (quando há UI)
34
+ 12. `parity_specs.md` + `parity_tests/`
35
+ 13. `screen_deviation_log.md` (consultivo, quando há UI)
36
+ 14. `risk_register.md` + `cutover_plan.md`
37
+ 15. `discard_log.md` (consultivo)
38
+ 16. `ambiguity_log.md` (consultivo)
39
+
40
+ ## Lista de artefatos produzidos
41
+
42
+ | Artefato | Produzido por | Status |
43
+ |---|---|---|
44
+ | migration_brief.md | orchestrator | criado |
45
+ | paradigm_decision.md | paradigm_advisor | criado |
46
+ | target_business_rules.md | curator | criado |
47
+ | discard_log.md | curator | criado |
48
+ | migration_strategy.md | strategist | criado |
49
+ | risk_register.md | strategist | criado |
50
+ | cutover_plan.md | strategist | criado |
51
+ | topology_decision.md | designer (Fase 1) | criado |
52
+ | target_architecture.md | designer | criado |
53
+ | target_domain_model.md | designer | criado |
54
+ | target_data_model.md | designer | criado |
55
+ | data_migration_plan.md | designer | criado |
56
+ | screen_modernization_decision.md | screen_translator (Fase 1) | criado / skipped |
57
+ | target_screens.md | screen_translator | criado / skipped |
58
+ | screen_deviation_log.md | screen_translator | criado / vazio |
59
+ | _reversa_sdd/screens/inventory.json | screen_translator | criado / vazio |
60
+ | _reversa_sdd/screens/golden/manifest.yaml | screen_translator | criado / opcional |
61
+ | parity_specs.md | inspector | criado |
62
+ | parity_tests/*.feature | inspector | <N> arquivos |
63
+ | ambiguity_log.md | orchestrator | consolidado |
64
+
65
+ ## Bloqueadores para começar a implementação
66
+ > Itens que precisam de decisão humana antes do agente de codificação começar.
67
+
68
+ - <AMB-XXX: descrição curta + onde decidir>
69
+ - <ou: nenhum bloqueador, prosseguir>
70
+
71
+ ## Próximos passos para o agente de codificação
72
+
73
+ 1. **Ler `paradigm_decision.md` e internalizar**: o paradigma alvo é <do paradigm_decision>. Toda escolha de código deve honrar esse paradigma.
74
+ 2. **Ler `topology_decision.md` e internalizar**: a topologia escolhida é <preservar | modernizar | híbrido>. Use o esboço da árvore registrado nesse artefato como base para criar a estrutura de pastas do novo repositório.
75
+ 3. **Ler `screen_modernization_decision.md` e internalizar** (quando há UI): o modo de tradução de telas é <literal | modernizado | híbrido>. Em literal, materialize byte-a-byte (ou pixel-equivalente) o que está em `target_screens.md`; em modernizado, honre a hierarquia de componentes, tokens e os 4 estados (idle, loading, error, success).
76
+ 4. **Configurar o repositório novo** com a stack declarada em `migration_brief.md` e a topologia decidida.
77
+ 5. **Implementar bottom-up** seguindo `target_architecture.md` e `target_domain_model.md`:
78
+ - infraestrutura → dados → domínio → aplicação → bordas.
79
+ 6. **Implementar as telas** consumindo `target_screens.md` como contrato literal. Em modo literal com golden files presentes em `_reversa_sdd/screens/golden/`, o resultado da implementação deve casar com o golden file dentro das `normalizationRules` declaradas no `manifest.yaml`.
80
+ 7. **Escrever os testes** a partir de `parity_specs.md` e `parity_tests/*.feature` desde o início. Honrar a seção § Exceções, que reflete deviations aprovadas em `screen_deviation_log.md`.
81
+ 8. **Para cada componente**, validar que respeita o paradigma escolhido (sinais explícitos em `target_architecture.md § Honra ao paradigma escolhido`) e a topologia escolhida (sinais explícitos em `target_architecture.md § Honra à topologia escolhida`).
82
+ 9. **Para a migração de dados**, seguir `data_migration_plan.md`.
83
+ 10. **Para o cutover**, seguir `cutover_plan.md` e os critérios go/no-go.
84
+
85
+ ## Itens auto-decididos (apenas se executado em --auto)
86
+ > Listar aqui itens cujo default foi aplicado sem confirmação humana. Recomenda-se revisar antes do cutover.
87
+
88
+ - <ou: pipeline executado em modo interativo, nenhum item auto-decidido>
89
+
90
+ ## Notas finais
91
+ <Observações do orquestrador para o agente de codificação.>