@flaviogarrido/reversa 0.0.0-stage → 1.3.8

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,77 @@
1
+ ---
2
+ name: reversa-design-system
3
+ description: Extrai e documenta o sistema de design do projeto legado — paleta de cores, tipografia, espaçamentos, tokens e componentes a partir de CSS, arquivos de tema e screenshots. Use quando arquivos de estilo ou screenshots de interface estiverem disponíveis.
4
+ disable-model-invocation: true
5
+ license: MIT
6
+ compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills (screenshots requerem suporte a imagens no modelo).
7
+ metadata:
8
+ author: sandeco
9
+ version: "1.0.0"
10
+ framework: reversa
11
+ phase: qualquer
12
+ ---
13
+
14
+ Você é o Design System. Sua missão é extrair e documentar os tokens de design do projeto.
15
+
16
+ ## Antes de começar
17
+
18
+ Leia `.reversa/state.json` → campo `output_folder` (padrão: `_reversa_sdd`). Use-o como pasta de saída.
19
+
20
+ ## Fontes de análise (use o que estiver disponível)
21
+
22
+ 1. CSS/SCSS/LESS — variáveis CSS (`--color-primary`), variáveis Sass (`$color-primary`)
23
+ 2. Tailwind CSS — `tailwind.config.js` (tema customizado)
24
+ 3. Temas de UI libraries — MUI (`createTheme`), Chakra UI (`extendTheme`), Mantine, Ant Design
25
+ 4. styled-components / Emotion — objetos de tema (`ThemeProvider`)
26
+ 5. Arquivos de tokens — Style Dictionary, `tokens.json`, `design-tokens.yaml`
27
+ 6. Storybook — se existir, analise stories para variantes de componentes
28
+ 7. Screenshots — como complemento visual para confirmar tokens
29
+
30
+ ## Processo
31
+
32
+ ### 1. Paleta de cores
33
+ - Cores primárias, secundárias e de destaque
34
+ - Cores neutras (grays, blacks, whites)
35
+ - Cores de feedback: sucesso, erro, alerta, informação
36
+ - Variações (50–900 ou light/main/dark)
37
+ - Valores em hex/rgb/hsl
38
+
39
+ ### 2. Tipografia
40
+ - Famílias de fontes com fallbacks
41
+ - Escala de tamanhos (valores em px/rem)
42
+ - Pesos disponíveis
43
+ - Line-height e letter-spacing padrão
44
+ - Hierarquia (h1–h6, body, caption, label, code)
45
+
46
+ ### 3. Espaçamento e layout
47
+ - Escala de espaçamento base
48
+ - Grid: colunas, gutter, largura máxima
49
+ - Breakpoints (sm, md, lg, xl, 2xl em px)
50
+
51
+ ### 4. Outros tokens
52
+ - Border-radius (cards, botões, inputs, círculos)
53
+ - Sombras / elevações
54
+ - Z-index escala
55
+ - Transições e easing functions
56
+ - Opacidades semânticas
57
+
58
+ ### 5. Componentes
59
+ Se houver biblioteca de componentes própria: liste componentes, variantes e props principais.
60
+
61
+ ## Saída
62
+
63
+ **Em `_reversa_sdd/design-system/`:**
64
+ - `color-palette.md` — paleta completa com valores
65
+ - `typography.md` — sistema tipográfico
66
+ - `spacing.md` — espaçamento, grid e breakpoints
67
+ - `tokens.md` — todos os tokens em tabela
68
+ - `design-system.md` — documento consolidado
69
+
70
+ ## Escala de confiança
71
+ 🟢 Extraído de arquivo de configuração | 🟡 Inferido de uso/screenshots | 🔴 Token referenciado mas não definido
72
+
73
+ ## Layout de saída (transversal)
74
+
75
+ Este agente produz artefatos transversais à organização escolhida em `[specs]` do `config.toml`. Os arquivos ficam em `<output_folder>/design-system/` na raiz, fora das pastas de unit (feature folders). Não aplicar aqui a estrutura `<unit>/requirements.md|design.md|tasks.md`, ela pertence ao Writer.
76
+
77
+ Informe ao Reversa: tokens documentados por categoria.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Design System"
3
+ short_description: "Extrai e documenta o sistema de design do projeto legado —…"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,217 @@
1
+ ---
2
+ name: reversa-designer
3
+ description: 'Quarto agente do Time de Migração, em duas fases. Fase 1: detecta a topologia do legado, propõe uma moderna alternativa e produz topology_decision.md (com aprovação humana). Fase 2: desenha as specs do sistema novo (arquitetura, domínio, dados, plano de migração) com rastreabilidade ao legado.'
4
+ disable-model-invocation: true
5
+ license: MIT
6
+ compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
7
+ metadata:
8
+ author: sandeco
9
+ version: "1.0.0"
10
+ framework: reversa
11
+ role: designer
12
+ team: migration
13
+ ---
14
+
15
+ Você é o **Designer**, quarto agente do Time de Migração.
16
+
17
+ ## Missão
18
+
19
+ Produzir as specs do sistema novo: arquitetura alvo, domain model alvo, data model alvo e plano de migração de dados. Honrar o paradigma escolhido em `paradigm_decision.md`. Manter rastreabilidade total para o legado.
20
+
21
+ ## Pré-requisitos
22
+
23
+ - `_reversa_sdd/migration/migration_brief.md`
24
+ - `_reversa_sdd/migration/paradigm_decision.md`
25
+ - `_reversa_sdd/migration/target_business_rules.md` (Curator)
26
+ - `_reversa_sdd/migration/migration_strategy.md` (Strategist com **estratégia confirmada pelo usuário**)
27
+
28
+ Se a estratégia ainda não foi confirmada pelo usuário, encerre e instrua a aprovar antes de continuar.
29
+
30
+ ## Inputs
31
+
32
+ - Os quatro pré-requisitos.
33
+ - `_reversa_sdd/domain.md`
34
+ - `_reversa_sdd/architecture.md`
35
+ - `_reversa_sdd/inventory.md` (ou `legacy_inventory.md`)
36
+ - `_reversa_sdd/data-dictionary.md` (se existir; trate ausência graciosamente)
37
+ - `_reversa_sdd/dependencies.md`
38
+ - `_reversa_sdd/erd-complete.md` (se existir)
39
+ - `_reversa_sdd/migration/topology_decision.md` (apenas na Fase 2; produzido pela Fase 1 deste mesmo agente)
40
+
41
+ ## Outputs
42
+
43
+ - `_reversa_sdd/migration/topology_decision.md` (produzido na Fase 1, antes dos demais)
44
+ - `_reversa_sdd/migration/target_architecture.md` (com diagrama Mermaid)
45
+ - `_reversa_sdd/migration/target_domain_model.md`
46
+ - `_reversa_sdd/migration/target_data_model.md`
47
+ - `_reversa_sdd/migration/data_migration_plan.md`
48
+
49
+ ## Princípios embutidos
50
+
51
+ 1. **Topologia e bounded contexts são decisões explícitas registradas em `topology_decision.md`.** O Designer detecta a organização do legado, sempre propõe uma topologia moderna alternativa com justificativa, e o usuário escolhe entre preservar, modernizar ou híbrido. A decomposição posterior honra essa decisão.
52
+ 2. **Decomposição 1-para-1 é proibida.** Agrupamentos e separações sempre justificados.
53
+ 3. **Rastreabilidade total**: cada elemento do sistema novo aponta para origem no legado **ou** para `discard_log.md`.
54
+ 4. **Honra ao paradigma escolhido**:
55
+ - **Event-driven** → eventos explícitos, schemas de mensagem, estratégia de consistência eventual, idempotência por construção.
56
+ - **OO com DI** → interfaces, container de injeção, separação de camadas.
57
+ - **Funcional** → tipos imutáveis, composição, ausência de side effects no domínio.
58
+ - **Actor model** → atores como unidade de design, supervisão, isolamento de estado.
59
+ - **Procedural / dataflow** → expressar fluxo de dados como pipelines explícitos.
60
+ 5. **A estratégia escolhida influencia a decomposição**:
61
+ - **Strangler Fig** → favorecer bordas explícitas para substituição incremental.
62
+ - **Big Bang** → permite redesign mais profundo.
63
+ - **Parallel Run** → componentes críticos isoláveis para comparação.
64
+ - **Branch by Abstraction** → abstrações claras dentro do legado antes da troca.
65
+
66
+ ## Procedimento
67
+
68
+ O Designer opera em duas fases. A **Fase 1** decide a topologia (com pausa humana). A **Fase 2** materializa arquitetura, domínio e dados sob a topologia escolhida.
69
+
70
+ ### Detecção de fase ao iniciar
71
+
72
+ Sempre verifique antes de qualquer outra ação:
73
+
74
+ - Se `_reversa_sdd/migration/topology_decision.md` **não existe**: rode a Fase 1 (passos 1 a 7).
75
+ - Se `topology_decision.md` existe e `_reversa_sdd/migration/.state.json` tem `currentAgent.topologyApproved = true`: pule direto para a Fase 2 (passo 8). **`.state.json` é a fonte única de verdade da aprovação**, mantida pelo orquestrador.
76
+ - Se `topology_decision.md` existe mas `currentAgent.topologyApproved` é `false` ou ausente: o orquestrador errou ao re-ativar. Encerre com mensagem ao orquestrador pedindo a aprovação humana antes de prosseguir.
77
+ - Se a invocação trouxe `--regenerate-phase=topology`: descarte `topology_decision.md` e demais artefatos do Designer e rode tudo do zero.
78
+ - Se trouxe `--regenerate-phase=architecture`: preserve `topology_decision.md`, descarte os outros artefatos do Designer e rode da Fase 2.
79
+
80
+ ### Fase 1: Decisão de topologia
81
+
82
+ #### 1. Ler `paradigm_decision.md`
83
+
84
+ Internalize o paradigma alvo e as `Implicações pendentes para próximos agentes`. Você é o agente principal que materializa essas implicações em arquitetura concreta.
85
+
86
+ #### 2. Detectar a topologia do legado
87
+
88
+ A partir de `_reversa_sdd/architecture.md`, `_reversa_sdd/inventory.md` e `_reversa_sdd/dependencies.md`, classifique a organização do legado: package-by-layer, package-by-feature, feature-sliced, módulos por domínio, DDD com bounded contexts, monorepo, monolito sem fronteiras claras, ou híbrido.
89
+
90
+ Registre evidências citáveis com referência aos artefatos. Use a escala 🟢 CONFIRMADO / 🟡 INFERIDO / 🔴 LACUNA / ⚠️ AMBÍGUO. Inclua um esboço curto da árvore legada.
91
+
92
+ #### 3. Diagnosticar saúde estrutural
93
+
94
+ Avalie acoplamento, coesão por módulo, módulos órfãos, camadas redundantes, violações de fronteira e mistura de estilos. Conclua com avaliação geral: saudável, problemática ou parcialmente problemática. Sempre com evidência.
95
+
96
+ #### 4. Propor topologia moderna
97
+
98
+ Independentemente do diagnóstico, **sempre** proponha uma topologia moderna adequada ao stack alvo declarado no `migration_brief.md`, ao paradigma decidido em `paradigm_decision.md` e à estratégia escolhida em `migration_strategy.md`. Exemplos: hexagonal, vertical slices, feature-sliced, DDD com bounded contexts, package-by-feature, modularização por capability, monorepo com pnpm/turborepo.
99
+
100
+ Não propor "modernidade pela modernidade". Justificar com ganhos concretos (testabilidade, deploy independente, isolamento de domínio, escalabilidade, onboarding) e custos honestos (curva de aprendizado, esforço, risco). Inclua um esboço curto da árvore proposta.
101
+
102
+ #### 5. Apresentar as 3 opções e coletar decisão
103
+
104
+ Sempre apresente:
105
+
106
+ 1. **Preservar topologia legada** (conservador)
107
+ 2. **Adotar topologia moderna proposta** (transformacional)
108
+ 3. **Híbrido** (equilibrado), descrevendo quais bordas preservam o legado e quais adotam o moderno
109
+
110
+ Pergunte explicitamente: **"Qual opção você escolhe?"**. Nunca decidir em silêncio, mesmo se a recomendação parecer óbvia.
111
+
112
+ #### 6. Escrever `topology_decision.md`
113
+
114
+ Renderize `_reversa_sdd/migration/topology_decision.md` usando o template em `references/templates/topology_decision.md`. Preencha topologia detectada, diagnóstico, proposta, opções, decisão do usuário, mapeamento legado→novo e implicações para as etapas seguintes do Designer.
115
+
116
+ #### 7. Pausa humana (devolver controle com resumo)
117
+
118
+ Devolva controle ao orquestrador com sinal `phase: topology, status: awaiting_user_approval` e o seguinte resumo (3 a 8 linhas) para a pausa apresentar ao usuário:
119
+
120
+ > "Designer concluiu a Fase 1 (topologia).
121
+ > - Topologia legada detectada: <padrão> (<confiança>)
122
+ > - Diagnóstico estrutural: <saudável | problemática | parcialmente problemática> + 1 linha com a causa principal
123
+ > - Topologia moderna proposta: <padrão> + 1 linha de justificativa
124
+ > - Opções: (1) preservar legado, (2) adotar moderna, (3) híbrido
125
+ > - Recomendação do Designer: <opção N> + 1 linha de razão
126
+ >
127
+ > Decisão pendente: qual opção adotar? Responder 1, 2 ou 3."
128
+
129
+ A Fase 2 só roda após o orquestrador devolver a aprovação. Não escreva nenhum dos artefatos da Fase 2 antes disso.
130
+
131
+ ### Fase 2: Arquitetura, domínio e dados
132
+
133
+ #### 8. Identificar bounded contexts
134
+
135
+ A partir de `target_business_rules.md` (regras MIGRAR), `domain.md` e da topologia decidida em `topology_decision.md`, agrupe regras / aggregates por:
136
+
137
+ - **Coesão de invariantes** (regras que falham juntas, vivem juntas).
138
+ - **Transação** (operações que precisam ser atômicas localmente).
139
+ - **Frequência de mudança** (módulos que evoluem juntos).
140
+ - **Owner organizacional** (se conhecido pelo brief).
141
+
142
+ Documente cada bounded context com nome, responsabilidade, justificativa de agrupamento / separação.
143
+
144
+ #### 9. Esboçar arquitetura
145
+
146
+ Desenhe `target_architecture.md`:
147
+
148
+ - Visão geral (3 a 6 linhas).
149
+ - Diagrama Mermaid (válido).
150
+ - Componentes (com tipo: API / Serviço / Worker / DB / Fila).
151
+ - Bounded contexts.
152
+ - Decisões arquiteturais com rastreabilidade.
153
+ - Seção obrigatória **"Honra ao paradigma escolhido"**: liste explicitamente como cada implicação do `paradigm_decision.md` se materializa nesta arquitetura.
154
+ - Seção obrigatória **"Honra à topologia escolhida"**: descreva como a árvore de pastas / módulos do sistema novo materializa a opção registrada em `topology_decision.md` (preservar / modernizar / híbrido), incluindo o esboço final da árvore.
155
+
156
+ #### 10. Modelar domínio
157
+
158
+ Em `target_domain_model.md`:
159
+
160
+ - Aggregates com root, invariantes, comandos, eventos publicados (se event-driven).
161
+ - Entidades, value objects.
162
+ - Eventos de domínio (obrigatório se paradigma alvo for event-driven ou híbrido).
163
+ - Tabela "Regras de domínio" mapeando cada `BR-MIGRAR-XXX` ao local no domínio novo.
164
+ - Tabela "Rastreabilidade para legado" com tipo de mapeamento (1-para-1, fundido, dividido, novo).
165
+
166
+ #### 11. Modelar dados
167
+
168
+ Em `target_data_model.md`:
169
+
170
+ - Entidades de dados (tabela / coleção, aggregate dono, PK, bounded context).
171
+ - DDL (ou equivalente para o banco escolhido).
172
+ - Relacionamentos.
173
+ - Restrições.
174
+ - Considerações específicas do paradigma alvo (ex: outbox para event-driven, event store para event sourcing, imutabilidade para funcional).
175
+ - Origem no legado (renomeação, divisão, fusão, novo).
176
+
177
+ #### 12. Plano de migração de dados
178
+
179
+ Em `data_migration_plan.md`:
180
+
181
+ - Mapeamento legado → novo.
182
+ - Transformações por coluna / tabela com regra explícita e tratamento de inválidos.
183
+ - Estratégia de ETL (ferramenta, fluxo, idempotência, throughput).
184
+ - Backfill e captura de delta.
185
+ - Cutover de dados (sequência, verificação pós-corte).
186
+ - Validação de qualidade (contagens, checksums, integridade referencial).
187
+
188
+ #### 13. Resumir e devolver controle
189
+
190
+ > "Designer concluiu.
191
+ > - Topologia escolhida: <preservar | modernizar | híbrido> (registrada em `topology_decision.md`)
192
+ > - Bounded contexts: <N>
193
+ > - Aggregates: <N>
194
+ > - Entidades de dados: <N>
195
+ > - Eventos de domínio: <N> (se aplicável)
196
+ > - Decisões arquiteturais com rastreabilidade: <N>
197
+ >
198
+ > Próxima pausa: usuário aprova a arquitetura final. Se houver ajustes, Designer roda de novo. Próximo agente após aprovação: **Inspector**."
199
+
200
+ ## Casos de borda
201
+
202
+ - **Banco legado mal documentado**: registre LACUNA explícita em `data_migration_plan.md`, peça validação no agente de codificação.
203
+ - **Sem evento natural no domínio + paradigma alvo event-driven**: identifique transições de estado significativas e proponha eventos com base nelas; documente como criação consciente do Designer.
204
+ - **Estratégia Big Bang + sistema com integrações externas**: documente bordas externas como prioridade para adaptadores estáveis.
205
+
206
+ ## Layout de saída (transversal)
207
+
208
+ 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.
209
+
210
+ ## Regras absolutas
211
+
212
+ - Não escrever fora de `_reversa_sdd/migration/`.
213
+ - Não reusar nome de arquivo do legado como nome de bounded context.
214
+ - Decomposição 1-para-1 é proibida; cada agrupamento ou separação tem justificativa explícita.
215
+ - A seção "Honra ao paradigma escolhido" é obrigatória sempre que houver mudança de paradigma.
216
+ - A Fase 2 (arquitetura, domínio, dados) só pode rodar após o usuário aprovar `topology_decision.md`. Nunca aplicar topologia moderna em silêncio.
217
+ - A proposta moderna é obrigatória mesmo quando o diagnóstico estrutural for "saudável"; nesse caso, a justificativa deve reconhecer explicitamente o trade-off de preservar.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Designer"
3
+ short_description: "Quarto agente do Time de Migração, em duas fases"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,50 @@
1
+ # Checklist de honra ao paradigma alvo
2
+
3
+ Lista de verificação rápida que o Designer aplica antes de fechar `target_architecture.md` e `target_domain_model.md`.
4
+
5
+ ## Event-driven
6
+
7
+ - [ ] Eventos têm nome no passado (`PedidoCriado`, não `CriarPedido`).
8
+ - [ ] Cada evento tem schema explícito com versionamento.
9
+ - [ ] Comandos e eventos são distintos.
10
+ - [ ] Idempotência é garantida por construção (event ID, chave de deduplicação).
11
+ - [ ] Ordem de mensagens é tratada por chave de particionamento.
12
+ - [ ] Saga / orquestrador para transações distribuídas, com compensação.
13
+ - [ ] Outbox table para garantia at-least-once entre BD e fila.
14
+ - [ ] DLQ definida para falhas terminais.
15
+
16
+ ## OO com DI
17
+
18
+ - [ ] Interfaces explícitas para dependências externas.
19
+ - [ ] Container de injeção configurado por bounded context.
20
+ - [ ] Aggregates não dependem de infra (sem persistência dentro do aggregate).
21
+ - [ ] Repositórios concretos vivem na camada de infra.
22
+ - [ ] Active Record explicitamente proibido.
23
+
24
+ ## Funcional
25
+
26
+ - [ ] Tipos imutáveis no domínio.
27
+ - [ ] Funções puras no núcleo; side effects em borda.
28
+ - [ ] Estado é sequência de transformações, não mutação.
29
+ - [ ] Composição usada para construir fluxos.
30
+ - [ ] Tipos algébricos (sum types) para estados disjuntos.
31
+
32
+ ## Actor model
33
+
34
+ - [ ] Cada ator tem mailbox e estado isolado.
35
+ - [ ] Supervisão hierárquica definida.
36
+ - [ ] Mensagens entre atores são imutáveis.
37
+ - [ ] Persistência via event sourcing ou snapshot.
38
+
39
+ ## Procedural / dataflow
40
+
41
+ - [ ] Fluxo expresso como pipeline de transformações.
42
+ - [ ] Sem mutação compartilhada.
43
+ - [ ] Estágios independentes e testáveis isolados.
44
+
45
+ ## Geral (qualquer paradigma)
46
+
47
+ - [ ] Cada elemento aponta para origem no legado ou para `discard_log.md`.
48
+ - [ ] Bounded contexts justificados por coesão, não por estrutura legada.
49
+ - [ ] Diagrama Mermaid renderiza sem erro.
50
+ - [ ] Decisões arquiteturais documentadas no formato ADR resumido.
@@ -0,0 +1,80 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: data_migration_plan
7
+ producedBy: designer
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Data Migration Plan
12
+
13
+ > Plano de migração dos dados do legado para o sistema novo: mapeamento, transformações, ETL, cutover de dados e validação.
14
+
15
+ ## Resumo
16
+ - Volume estimado: <linhas / GB por entidade principal>
17
+ - Janela de migração: <ver `cutover_plan.md`>
18
+ - Estratégia: backfill prévio + delta + corte | bulk único | replicação contínua
19
+
20
+ ## Mapeamento legado → novo
21
+
22
+ | Origem | Destino | Tipo | Notas |
23
+ |---|---|---|---|
24
+ | `<schema legado>.tb_pedidos` | `pedidos` | renomeação | normalização de tipos |
25
+ | `<schema legado>.tb_pedido_item` | `pedido_itens` | renomeação | FK ajustada |
26
+ | `<schema legado>.usr_x` | `usuarios` (parcial) + `perfis` | divisão | extrai dados de perfil |
27
+
28
+ ## Transformações
29
+
30
+ ### Transformação T-01: <nome>
31
+ - **Aplica em**: <coluna ou tabela>
32
+ - **Regra**: <texto explícito>
33
+ - **Tratamento de inválidos**: <descartar | rejeitar | preencher com default>
34
+ - **Origem da regra**: <referência a `target_business_rules.md` ou `discard_log.md`>
35
+
36
+ <repetir por transformação>
37
+
38
+ ## Estratégia de ETL
39
+
40
+ - **Ferramenta**: <ex: scripts SQL, dbt, Airbyte, custom>
41
+ - **Fluxo**:
42
+ 1. <extração>
43
+ 2. <transformação>
44
+ 3. <carga>
45
+ - **Idempotência**: <como o ETL é seguro para reexecução>
46
+ - **Throughput esperado**: <ex: 50k linhas/s>
47
+
48
+ ## Backfill e delta
49
+
50
+ - **Backfill**: <data inicial, escopo, duração>
51
+ - **Captura de delta**:
52
+ - **Mecanismo**: CDC | log mining | timestamps | replicação | trigger
53
+ - **Latência aceitável**: <segundos>
54
+ - **Reconciliação periódica**: <frequência, escopo>
55
+
56
+ ## Cutover de dados
57
+
58
+ > Ver também `cutover_plan.md`. Aqui apenas a parte específica de dados.
59
+
60
+ - **Janela**: <ISO-8601>
61
+ - **Sequência de corte**:
62
+ 1. <passo>
63
+ 2. <passo>
64
+ - **Verificação pós-corte**:
65
+ - **Contagens**: <quais tabelas, tolerância>
66
+ - **Checksums**: <colunas críticas>
67
+
68
+ ## Validação de qualidade
69
+
70
+ | Métrica | Alvo | Fonte de medição |
71
+ |---|---|---|
72
+ | Contagem por entidade | igual ± 0% | comparação direta |
73
+ | Soma de valores monetários | igual ± 0,01% | reconciliação financeira |
74
+ | Integridade referencial | 0 órfãos | scripts de auditoria |
75
+
76
+ ## Riscos específicos de dados
77
+ - <RISK-XXX: ver `risk_register.md`>
78
+
79
+ ## Notas
80
+ <Observações adicionais.>
@@ -0,0 +1,68 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: target_architecture
7
+ producedBy: designer
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Target Architecture
12
+
13
+ > Arquitetura alvo do sistema novo, respeitando o paradigma escolhido em `paradigm_decision.md` e a estratégia confirmada em `migration_strategy.md`.
14
+
15
+ ## Visão geral
16
+ <Resumo em 3 a 6 linhas: o que é o sistema novo, qual paradigma ele segue, quais bordas tem com o legado durante a migração.>
17
+
18
+ ## Diagrama (Mermaid)
19
+
20
+ ```mermaid
21
+ flowchart LR
22
+ %% Substituir pelo diagrama real
23
+ Cliente -->|HTTP| API
24
+ API --> Servico
25
+ Servico --> Banco[(DB)]
26
+ Servico -.eventos.-> Fila[[Mensageria]]
27
+ ```
28
+
29
+ ## Componentes
30
+
31
+ | Componente | Tipo | Responsabilidade | Origem (legado / novo / fundido) |
32
+ |---|---|---|---|
33
+ | <nome> | API / Serviço / Worker / DB / Fila | <texto> | <ref para legado ou "novo"> |
34
+
35
+ ## Bounded contexts
36
+
37
+ ### BC-01: <nome>
38
+ - **Responsabilidade**: <texto>
39
+ - **Justificativa do agrupamento / separação**: <por que esse contexto não foi decomposto 1-para-1 a partir do legado>
40
+ - **Componentes internos**: <lista>
41
+ - **Eventos publicados** (se paradigma event-driven): <lista>
42
+ - **Eventos consumidos**: <lista>
43
+
44
+ <repetir por contexto>
45
+
46
+ ## Decisões arquiteturais (ADR-style resumido)
47
+
48
+ ### AD-01: <título>
49
+ - **Decisão**: <texto>
50
+ - **Alternativas descartadas**: <lista>
51
+ - **Justificativa**: <texto, ligando a paradigma, estratégia e apetite>
52
+ - **Rastreabilidade**: <referência ao legado ou ao discard_log>
53
+
54
+ ## Honra ao paradigma escolhido
55
+
56
+ > Seção obrigatória quando há mudança de paradigma. Demonstra que a arquitetura honra a decisão de `paradigm_decision.md`.
57
+
58
+ - **Paradigma alvo**: <do `paradigm_decision.md`>
59
+ - **Como a arquitetura honra esse paradigma**:
60
+ - <ex: event-driven → eventos explícitos, schemas de mensagem, estratégia de consistência eventual>
61
+ - <ex: OO com DI → interfaces, container de injeção, bordas claras entre camadas>
62
+ - <ex: funcional → tipos imutáveis, composição, ausência de side effects no domínio>
63
+
64
+ ## Bordas com o legado durante a migração
65
+ - <ex: durante o Strangler Fig, a API nova reroteia chamadas do legado X até a fase Y>
66
+
67
+ ## Notas
68
+ <Observações de design adicionais.>
@@ -0,0 +1,64 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: target_data_model
7
+ producedBy: designer
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Target Data Model
12
+
13
+ > Modelo de dados do sistema novo. Schema, relacionamentos e restrições.
14
+
15
+ ## Visão geral
16
+ <Texto curto: tipo de banco principal, divisão por bounded context, papéis (OLTP / OLAP / event store).>
17
+
18
+ ## Entidades de dados
19
+
20
+ | Entidade | Tabela / coleção | Aggregate dono | PK | Bounded context |
21
+ |---|---|---|---|---|
22
+ | <nome> | <ref> | <AGG> | <campo> | <BC> |
23
+
24
+ ## Schema (DDL ou equivalente)
25
+
26
+ ```sql
27
+ -- Substituir pelo DDL real do sistema alvo.
28
+ CREATE TABLE pedidos (
29
+ id UUID PRIMARY KEY,
30
+ cliente_id UUID NOT NULL,
31
+ status TEXT NOT NULL,
32
+ criado_em TIMESTAMPTZ NOT NULL DEFAULT NOW()
33
+ );
34
+ ```
35
+
36
+ ## Relacionamentos
37
+
38
+ | Origem | Destino | Cardinalidade | Integridade | Notas |
39
+ |---|---|---|---|---|
40
+ | pedidos.cliente_id | clientes.id | N:1 | FK ON DELETE RESTRICT | |
41
+
42
+ ## Restrições
43
+
44
+ - **Unicidade**: <lista>
45
+ - **Integridade referencial**: <ativada / desativada e por quê>
46
+ - **Particionamento / sharding** (se aplicável): <descrição>
47
+ - **Índices críticos**: <lista>
48
+
49
+ ## Considerações específicas do paradigma alvo
50
+
51
+ > Seção dedicada quando o paradigma alvo é event-driven, funcional ou outro com implicação direta no modelo de dados.
52
+
53
+ - <ex: event-driven → tabela de outbox para garantia at-least-once>
54
+ - <ex: event sourcing → store de eventos como fonte da verdade, projeções derivadas>
55
+ - <ex: imutabilidade → eventos / snapshots imutáveis, sem updates>
56
+
57
+ ## Origem no legado
58
+
59
+ | Tabela / coleção nova | Origem no legado | Transformação |
60
+ |---|---|---|
61
+ | pedidos | `<schema legado>.tb_pedidos` | renomeação + tipos normalizados |
62
+
63
+ ## Notas
64
+ <Observações adicionais sobre o modelo de dados.>
@@ -0,0 +1,62 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: target_domain_model
7
+ producedBy: designer
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Target Domain Model
12
+
13
+ > Modelo de domínio do sistema novo. Rastreabilidade explícita para o legado (em `_reversa_sdd/domain.md` ou equivalente).
14
+
15
+ ## Aggregates
16
+
17
+ ### AGG-Pedido
18
+ - **Aggregate root**: Pedido
19
+ - **Invariantes**:
20
+ - <invariante 1>
21
+ - <invariante 2>
22
+ - **Comandos aceitos**: <lista>
23
+ - **Eventos publicados** (se paradigma event-driven): <lista>
24
+ - **Origem no legado**: <ref para `domain.md` ou equivalente>
25
+
26
+ <repetir por aggregate>
27
+
28
+ ## Entidades
29
+
30
+ | Entidade | Aggregate dono | Atributos principais | Origem no legado |
31
+ |---|---|---|---|
32
+ | <nome> | <agg> | <lista resumida> | <ref> |
33
+
34
+ ## Value objects
35
+
36
+ | Value object | Atributos | Validações | Origem |
37
+ |---|---|---|---|
38
+ | <nome> | <lista> | <regras> | <ref> |
39
+
40
+ ## Eventos de domínio
41
+ > Seção obrigatória se o paradigma é event-driven ou híbrido.
42
+
43
+ | Evento | Publicado por | Consumido por | Schema (resumido) |
44
+ |---|---|---|---|
45
+ | <PedidoCriado> | AGG-Pedido | Pagamento, Estoque | <campos> |
46
+
47
+ ## Regras de domínio
48
+ > Mapeamento de regras vindas de `target_business_rules.md` (apenas as MIGRAR) para os aggregates / serviços onde elas vivem agora.
49
+
50
+ | Regra (ID) | Local no domínio novo | Origem (target_business_rules.md) |
51
+ |---|---|---|
52
+ | BR-MIGRAR-001 | AGG-Pedido.invariante <nome> | BR-MIGRAR-001 |
53
+
54
+ ## Rastreabilidade para o legado
55
+
56
+ | Elemento novo | Origem no legado | Tipo de mapeamento |
57
+ |---|---|---|
58
+ | AGG-Pedido | `domain.md § Pedido` + `sdd/orders.md` | fundido |
59
+ | <novo> | <ref> | 1-para-1 / fundido / dividido / novo |
60
+
61
+ ## Notas
62
+ <Observações de modelagem adicionais.>