@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,60 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: cutover_plan
7
+ producedBy: strategist
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Cutover Plan
12
+
13
+ > Plano de corte do legado para o sistema novo, alinhado à estratégia escolhida em `migration_strategy.md`.
14
+
15
+ ## Estratégia base
16
+ - **Estratégia confirmada**: <referência ao migration_strategy.md>
17
+
18
+ ## Pré-requisitos
19
+ - [ ] <pré-requisito 1: ex. paridade comportamental ≥ X% por N dias>
20
+ - [ ] <pré-requisito 2>
21
+ - [ ] <pré-requisito 3>
22
+
23
+ ## Janela de cutover
24
+ - **Data alvo**: <ISO-8601 ou janela>
25
+ - **Duração estimada**: <horas>
26
+ - **Ambiente afetado**: <produção / staging / outro>
27
+ - **Comunicação prévia**: <stakeholders avisados, prazo>
28
+
29
+ ## Passos do cutover
30
+
31
+ | # | Passo | Owner | Duração | Reversível? |
32
+ |---|---|---|---|---|
33
+ | 1 | <ex: congelar escritas no legado> | | | |
34
+ | 2 | <ex: ETL final dos dados> | | | |
35
+ | 3 | <ex: roteamento DNS> | | | |
36
+ | 4 | <ex: smoke tests no novo> | | | |
37
+
38
+ ## Plano de rollback
39
+ - **Critérios de acionamento**: <quando rollback é decidido>
40
+ - **Passos**:
41
+ 1. <passo>
42
+ 2. <passo>
43
+ - **Tempo máximo aceitável até rollback**: <minutos / horas>
44
+ - **Owner do rollback**: <nome / papel>
45
+
46
+ ## Critérios de go / no-go
47
+ - **Go**:
48
+ - <critério 1>
49
+ - <critério 2>
50
+ - **No-go**:
51
+ - <critério 1>
52
+ - <critério 2>
53
+
54
+ ## Pós-cutover
55
+ - [ ] Monitoramento estendido por <período>
56
+ - [ ] Validação de paridade conforme `parity_specs.md`
57
+ - [ ] Decommission do legado em <data>
58
+
59
+ ## Notas
60
+ <Observações adicionais.>
@@ -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,37 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: discard_log
7
+ producedBy: curator
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Discard Log
12
+
13
+ > Registro completo do que foi descartado da migração e por quê. Cada item tem rastreabilidade para a origem no legado.
14
+
15
+ ## Itens descartados
16
+
17
+ ### BR-DESCARTAR-001
18
+ - **Origem**: `_reversa_sdd/<unit>/{requirements,design}.md` § <seção>
19
+ - **Descrição**: <regra ou comportamento descartado>
20
+ - **Justificativa**: <texto>
21
+ - **Vinculado a paradigma**: sim | não
22
+ - Se sim: <qual paradigma e como o paradigma alvo absorve o caso>
23
+ - **Reposição no sistema novo**: <none | substituído por X>
24
+ - **Risco de descartar**: baixo | médio | alto, com nota explicativa
25
+
26
+ <repetir por item>
27
+
28
+ ## Itens descartados por mudança de paradigma (subseção dedicada)
29
+
30
+ > Lista apenas dos itens cujo `Vinculado a paradigma = sim`. Auditoria explícita para o agente de codificação.
31
+
32
+ | ID | Origem | Paradigma legado | Substituto no paradigma alvo |
33
+ |---|---|---|---|
34
+ | BR-DESCARTAR-XXX | <ref> | <ex: lock pessimista síncrono> | <ex: idempotência via event ID> |
35
+
36
+ ## Notas
37
+ <Observações finais do Curator sobre o conjunto descartado.>
@@ -0,0 +1,76 @@
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
+
19
+ ## Ordem de leitura recomendada
20
+
21
+ 1. `paradigm_decision.md` (obrigatório, primeiro)
22
+ 2. `migration_brief.md`
23
+ 3. `target_business_rules.md`
24
+ 4. `migration_strategy.md`
25
+ 5. `target_architecture.md`
26
+ 6. `target_domain_model.md`
27
+ 7. `target_data_model.md`
28
+ 8. `data_migration_plan.md`
29
+ 9. `parity_specs.md` + `parity_tests/`
30
+ 10. `risk_register.md` + `cutover_plan.md`
31
+ 11. `discard_log.md` (consultivo)
32
+ 12. `ambiguity_log.md` (consultivo)
33
+
34
+ ## Lista de artefatos produzidos
35
+
36
+ | Artefato | Produzido por | Status |
37
+ |---|---|---|
38
+ | migration_brief.md | orchestrator | criado |
39
+ | paradigm_decision.md | paradigm_advisor | criado |
40
+ | target_business_rules.md | curator | criado |
41
+ | discard_log.md | curator | criado |
42
+ | migration_strategy.md | strategist | criado |
43
+ | risk_register.md | strategist | criado |
44
+ | cutover_plan.md | strategist | criado |
45
+ | target_architecture.md | designer | criado |
46
+ | target_domain_model.md | designer | criado |
47
+ | target_data_model.md | designer | criado |
48
+ | data_migration_plan.md | designer | criado |
49
+ | parity_specs.md | inspector | criado |
50
+ | parity_tests/*.feature | inspector | <N> arquivos |
51
+ | ambiguity_log.md | orchestrator | consolidado |
52
+
53
+ ## Bloqueadores para começar a implementação
54
+ > Itens que precisam de decisão humana antes do agente de codificação começar.
55
+
56
+ - <AMB-XXX: descrição curta + onde decidir>
57
+ - <ou: nenhum bloqueador, prosseguir>
58
+
59
+ ## Próximos passos para o agente de codificação
60
+
61
+ 1. **Ler `paradigm_decision.md` e internalizar**: o paradigma alvo é <do paradigm_decision>. Toda escolha de código deve honrar esse paradigma.
62
+ 2. **Configurar o repositório novo** com a stack declarada em `migration_brief.md`.
63
+ 3. **Implementar bottom-up** seguindo `target_architecture.md` e `target_domain_model.md`:
64
+ - infraestrutura → dados → domínio → aplicação → bordas.
65
+ 4. **Escrever os testes** a partir de `parity_specs.md` e `parity_tests/*.feature` desde o início.
66
+ 5. **Para cada componente**, validar que respeita o paradigma escolhido (sinais explícitos em `target_architecture.md § Honra ao paradigma escolhido`).
67
+ 6. **Para a migração de dados**, seguir `data_migration_plan.md`.
68
+ 7. **Para o cutover**, seguir `cutover_plan.md` e os critérios go/no-go.
69
+
70
+ ## Itens auto-decididos (apenas se executado em --auto)
71
+ > Listar aqui itens cujo default foi aplicado sem confirmação humana. Recomenda-se revisar antes do cutover.
72
+
73
+ - <ou: pipeline executado em modo interativo, nenhum item auto-decidido>
74
+
75
+ ## Notas finais
76
+ <Observações do orquestrador para o agente de codificação.>
@@ -0,0 +1,52 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: migration_brief
7
+ producedBy: orchestrator
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Migration Brief
12
+
13
+ > Documento de critério de migração coletado em entrevista no início do `/reversa-migrate`.
14
+ > Consumido pelos seis agentes do Time de Migração. Não pergunta paradigma (responsabilidade do Paradigm Advisor) nem apetite (derivado em `paradigm_decision.md`).
15
+
16
+ ## Objetivo da migração
17
+ <Por que esta migração existe? O que muda no negócio se ela acontecer ou não.>
18
+
19
+ ## Métricas de sucesso
20
+ - <métrica 1, com alvo numérico ou qualitativo claro>
21
+ - <métrica 2>
22
+ - <métrica 3>
23
+
24
+ ## Restrições
25
+ - **Prazo**: <data ou janela>
26
+ - **Orçamento**: <faixa, time, contratação envolvida>
27
+ - **Técnicas**: <APIs externas que não podem mudar, contratos, regras regulatórias>
28
+ - **Operacionais**: <janelas de manutenção, SLAs durante a migração>
29
+
30
+ ## Fatores de risco conhecidos
31
+ - <risco 1: descrição curta>
32
+ - <risco 2>
33
+
34
+ ## Stakeholders
35
+ | Nome / papel | Responsabilidade na migração |
36
+ |---|---|
37
+ | <nome> | <responsabilidade> |
38
+
39
+ ## Stack alvo
40
+ - **Linguagem**: <ex: Node.js 20>
41
+ - **Framework**: <ex: Fastify>
42
+ - **Banco**: <ex: PostgreSQL 16>
43
+ - **Mensageria** (se houver): <ex: SQS, Kafka, none>
44
+ - **Infra**: <ex: AWS Lambda, Kubernetes, on-premise>
45
+ - **Outros componentes relevantes**: <cache, observabilidade, gateway>
46
+
47
+ ## Escopo declarado
48
+ - **Incluído**: <módulos do legado que entram>
49
+ - **Excluído**: <módulos que ficam de fora ou serão descontinuados>
50
+
51
+ ## Notas livres
52
+ <Qualquer contexto que o usuário queira deixar registrado para os agentes lerem.>
@@ -0,0 +1,55 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: migration_strategy
7
+ producedBy: strategist
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Migration Strategy
12
+
13
+ > Estratégias de migração avaliadas com trade-offs explícitos. A estratégia recomendada é a sugestão do Strategist; a decisão final é humana.
14
+
15
+ ## Estratégias avaliadas
16
+
17
+ ### Estratégia A: <nome>
18
+ - **Descrição**: <texto curto>
19
+ - **Quando aplica**: <critérios>
20
+ - **Custo**: baixo | médio | alto
21
+ - **Risco**: baixo | médio | alto
22
+ - **Tempo**: curto | médio | longo
23
+ - **Adequação ao apetite derivado** (`<conservative | balanced | transformational>`): <texto>
24
+ - **Trade-offs**:
25
+ - Prós: <lista>
26
+ - Contras: <lista>
27
+
28
+ ### Estratégia B: <nome>
29
+ <mesma estrutura>
30
+
31
+ ### Estratégia C: <nome>
32
+ <opcional, se mais de duas forem relevantes>
33
+
34
+ ## Comparativo
35
+
36
+ | Critério | A | B | C |
37
+ |---|---|---|---|
38
+ | Custo | | | |
39
+ | Risco | | | |
40
+ | Tempo | | | |
41
+ | Aderência ao apetite | | | |
42
+ | Compatibilidade com mudança de paradigma | | | |
43
+
44
+ ## Recomendação do Strategist
45
+ - **Estratégia recomendada**: <A | B | C>
46
+ - **Justificativa**: <texto baseado em brief + paradigma + apetite>
47
+
48
+ ## Sinais de alerta específicos
49
+ - <ex: mudança grande de paradigma + apetite transformacional → considerar Parallel Run para validação>
50
+
51
+ ## Decisão humana
52
+ - **Estratégia escolhida**: <A | B | C>
53
+ - **Quem decidiu**: <nome>
54
+ - **Quando**: <ISO-8601>
55
+ - **Justificativa do decisor**: <texto livre>
@@ -0,0 +1,69 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: paradigm_decision
7
+ producedBy: paradigm_advisor
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Paradigm Decision
12
+
13
+ > Decisão consciente sobre como tratar a mudança (ou ausência) de paradigma entre o legado e a stack alvo.
14
+ > Este artefato é leitura obrigatória primeiro para qualquer agente posterior e para o agente de codificação.
15
+
16
+ ## Paradigma do legado detectado
17
+ - **Paradigma principal**: <procedural | OO clássico | OO com DI | funcional | event-driven | actor model | dataflow | híbrido: ...>
18
+ - **Confiança**: 🟢 CONFIRMADO | 🟡 INFERIDO | 🔴 LACUNA | ⚠️ AMBÍGUO
19
+ - **Evidências**:
20
+ - <evidência 1, com referência a artefato do `_reversa_sdd/`>
21
+ - <evidência 2>
22
+ - **Variações observadas** (se híbrido):
23
+ - <componente A: paradigma X, evidência>
24
+ - <componente B: paradigma Y, evidência>
25
+
26
+ ## Stack alvo declarada
27
+ - Linguagem: <do migration_brief.md>
28
+ - Framework: <do migration_brief.md>
29
+ - Infra: <do migration_brief.md>
30
+
31
+ ## Paradigma natural inferido
32
+ - **Paradigma**: <inferido via paradigm_catalog>
33
+ - **Justificativa**: <por que essa stack tem esse paradigma natural>
34
+ - **Alternativas viáveis**: <ex: OO com DI também é viável em Node, com custo X>
35
+
36
+ ## Gap identificado
37
+ - **Severidade**: alto | médio | baixo | nenhum
38
+ - **Implicações concretas** (não em abstrato; com exemplo do próprio sistema legado):
39
+ - <implicação 1, citando regra/fluxo do legado afetado>
40
+ - <implicação 2>
41
+ - <implicação 3>
42
+ - <implicação 4>
43
+
44
+ ## Opções apresentadas ao usuário
45
+ 1. **Adotar paradigma natural da stack** (transformacional)
46
+ - Consequências: <lista>
47
+ 2. **Forçar paradigma similar ao legado** (conservador)
48
+ - Consequências: <lista>
49
+ 3. **Híbrido** (equilibrado)
50
+ - Consequências: <lista>
51
+
52
+ ## Decisão do usuário
53
+ - **Escolha**: <1 | 2 | 3>
54
+ - **Justificativa do usuário**: <texto livre>
55
+ - **Decidido em**: <ISO-8601>
56
+
57
+ ## Apetite derivado
58
+ - `derived_appetite`: conservative | balanced | transformational
59
+
60
+ ## Implicações pendentes para próximos agentes
61
+ | Agente | Implicação | Como honrar |
62
+ |---|---|---|
63
+ | Curator | <implicação> | <ação esperada> |
64
+ | Strategist | <implicação> | <ação esperada> |
65
+ | Designer | <implicação> | <ação esperada> |
66
+ | Inspector | <implicação> | <ação esperada> |
67
+
68
+ ## Notas
69
+ <Qualquer ponto adicional que o agente de codificação precisa saber sobre o paradigma alvo.>
@@ -0,0 +1,64 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: parity_specs
7
+ producedBy: inspector
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Parity Specs
12
+
13
+ > Estratégia de validação de equivalência comportamental entre legado e sistema novo, adaptada ao paradigma escolhido em `paradigm_decision.md`.
14
+
15
+ ## Estratégia geral
16
+ - **Modos de validação aplicáveis** (marcar os usados):
17
+ - [ ] Shadow mode (espelhamento de tráfego com comparação assíncrona)
18
+ - [ ] Characterization tests (suíte derivada do comportamento atual do legado)
19
+ - [ ] Contract tests (interfaces externas)
20
+ - [ ] Data parity (snapshots e checksums)
21
+ - [ ] Outro: <especificar>
22
+
23
+ ## Critérios de "paridade aceita"
24
+ - **Métrica primária**: <ex: índice de divergência funcional < 0,01% em N dias consecutivos>
25
+ - **Janela de observação**: <período de avaliação>
26
+ - **Critério de bloqueio**: <quando paridade insuficiente bloqueia o cutover>
27
+
28
+ ## Cobertura adaptada ao paradigma
29
+
30
+ > Esta seção muda conforme o paradigma alvo confirmado em `paradigm_decision.md`.
31
+
32
+ ### Sem mudança de paradigma
33
+ - Equivalência funcional padrão: mesma entrada → mesma saída → mesmo efeito colateral observável.
34
+
35
+ ### Mudança síncrono → event-driven
36
+ - **Ordem de mensagens**: <critério de aceitação por canal / partição>
37
+ - **Idempotência**: <prova de que reprocessamento não duplica efeito>
38
+ - **Consistência eventual**: <janela máxima de propagação aceita>
39
+ - **Comportamento sob falha de fila**: <retry, DLQ, replay>
40
+
41
+ ### Mudança procedural → OO
42
+ - **Invariantes em aggregates**: <conjunto a validar>
43
+ - **Validação em factories / construtores**: <casos críticos>
44
+
45
+ ### Mudança OO → funcional
46
+ - **Imutabilidade**: <pontos críticos a observar>
47
+ - **Ausência de side effects esperados**: <onde o legado tinha efeito colateral implícito>
48
+ - **Equivalência sob composição**: <funções compostas equivalem ao fluxo legado>
49
+
50
+ ## Tipos de teste a aplicar
51
+ - **Funcionais**: <descrição, ferramenta>
52
+ - **Contrato**: <descrição, ferramenta>
53
+ - **Carga / performance**: <descrição, alvos>
54
+ - **Resiliência** (se aplicável): <falha de fila, dependência externa indisponível>
55
+
56
+ ## Reuso de characterization_specs do time de descoberta
57
+ - **Origem**: `_reversa_sdd/characterization_specs/` ou equivalente disponível.
58
+ - **Adaptações necessárias para o sistema novo**: <texto>
59
+
60
+ ## Saídas
61
+ - `parity_tests/*.feature`: cenários em Gherkin para os fluxos críticos.
62
+
63
+ ## Notas
64
+ <Observações adicionais.>
@@ -0,0 +1,40 @@
1
+ # Template de cenário Gherkin para parity_tests/.
2
+ # Cada arquivo deve cobrir um fluxo crítico identificado em process_flows do legado.
3
+ # Adaptar critérios ao paradigma alvo conforme `parity_specs.md`.
4
+
5
+ # language: pt
6
+ # spec-id: PT-001
7
+ # rastreabilidade:
8
+ # process_flows: <ref ao fluxo no _reversa_sdd>
9
+ # target_architecture: <ref a componente no target_architecture.md>
10
+ # paradigma_alvo: <do paradigm_decision.md>
11
+
12
+ Funcionalidade: <Nome do fluxo>
13
+ Como <ator>
14
+ Quero <ação>
15
+ Para <objetivo>
16
+
17
+ # Critério geral de paridade aplicado a este cenário.
18
+ # Quando o paradigma alvo é event-driven, expressar tolerância de consistência eventual aqui.
19
+ @paridade @critico
20
+ Cenário: <descrição>
21
+ Dado <pré-condição observável>
22
+ E <pré-condição secundária>
23
+ Quando <ação executada via API / comando / evento de entrada>
24
+ Então <efeito observável no sistema novo>
25
+ E <efeito observável persiste após <janela de propagação>>
26
+
27
+ # Cenário específico para validar idempotência (event-driven, retry seguro).
28
+ @paridade @idempotencia
29
+ Cenário: Reprocessamento não duplica efeito
30
+ Dado <pré-condição>
31
+ Quando <ação> é processada uma vez
32
+ E <ação> é reentregue por retry
33
+ Então o efeito observável é idêntico ao da primeira entrega
34
+
35
+ # Cenário específico para validar ordem em paradigma event-driven.
36
+ @paridade @ordem
37
+ Cenário: Ordem de eventos é respeitada por chave
38
+ Dado <chave de particionamento>
39
+ Quando <evento A> é publicado antes de <evento B> com a mesma chave
40
+ Então <efeito observável> reflete a ordem A → B
@@ -0,0 +1,36 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: pending_decisions
7
+ producedBy: orchestrator
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Pending Decisions
12
+
13
+ > Arquivo transitório usado durante pausas humanas. Cada item descreve uma decisão aberta com contexto e opções.
14
+ > Após o usuário responder, o item é movido para `ambiguity_log.md` (ou para o artefato dono da decisão) e este arquivo pode ser apagado.
15
+
16
+ ## Decisões abertas
17
+
18
+ ### PD-001
19
+ - **Agente que solicitou**: paradigm_advisor | curator | strategist | designer | screen_translator | inspector
20
+ - **Tópico**: <título curto>
21
+ - **Contexto**:
22
+ <texto explicando por que essa decisão é necessária aqui>
23
+ - **Opções**:
24
+ 1. <opção 1>
25
+ 2. <opção 2>
26
+ 3. <opção 3>
27
+ - **Default proposto** (usado em `--auto`): <opção número>
28
+ - **Impacto se decidido errado**: <texto>
29
+ - **Onde a decisão será gravada**: <ex: `paradigm_decision.md § Decisão do usuário`>
30
+
31
+ <repetir por decisão>
32
+
33
+ ## Como responder
34
+
35
+ - No chat: respondendo direto ao agente com o número da opção e justificativa.
36
+ - Em arquivo: editando este `pending_decisions.md`, adicionando um campo `Resposta:` em cada item.
@@ -0,0 +1,44 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: risk_register
7
+ producedBy: strategist
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Risk Register
12
+
13
+ > Registro de riscos da migração com probabilidade, impacto, mitigação e responsável.
14
+
15
+ ## Riscos
16
+
17
+ ### RISK-001
18
+ - **Descrição**: <texto>
19
+ - **Categoria**: técnico | operacional | organizacional | regulatório | financeiro
20
+ - **Probabilidade**: baixa | média | alta
21
+ - **Impacto**: baixo | médio | alto | crítico
22
+ - **Severidade combinada**: <calculada a partir dos dois acima>
23
+ - **Trigger / sinal de alerta**: <o que indicaria que o risco está se materializando>
24
+ - **Mitigação**: <ações concretas>
25
+ - **Plano de contingência**: <se mitigação falhar>
26
+ - **Owner**: <nome / papel>
27
+ - **Status**: aberto | mitigando | aceito | encerrado
28
+
29
+ <repetir por risco>
30
+
31
+ ## Resumo por severidade
32
+
33
+ | Severidade | Quantidade | IDs |
34
+ |---|---|---|
35
+ | Crítica | | |
36
+ | Alta | | |
37
+ | Média | | |
38
+ | Baixa | | |
39
+
40
+ ## Riscos relacionados ao paradigma alvo
41
+
42
+ > Subseção dedicada quando há mudança de paradigma. Listar apenas riscos cuja origem direta é o gap registrado em `paradigm_decision.md`.
43
+
44
+ - <RISK-XXX: descrição>
@@ -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.>