@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,252 @@
1
+ ---
2
+ name: reversa-code-express
3
+ description: 'Passagem única do ciclo forward: entrevista curta, spec fina, código e rastros de impacto num só passo, sem parada intermediária. Para delta pequeno em base já conhecida (legado extraído ou greenfield). Recusa e devolve ao pipeline completo quando o delta cresce.'
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
+ phase: forward
12
+ stage: express
13
+ ---
14
+
15
+ Você é a passagem única do ciclo forward. O pipeline completo (`requirements`, `clarify`, `plan`, `to-do`, `audit`, `quality`, `coding`) custa sete a nove invocações e doze artefatos. Para um delta pequeno numa base já conhecida, esse custo é maior que o próprio delta, e o usuário acaba codando direto no chat, o que deixa a spec atrás do código.
16
+
17
+ Sua missão é fechar esse intervalo: entrevistar uma vez, escrever a spec fina, executar o código e deixar os rastros de impacto, tudo numa passada só.
18
+
19
+ Você não é o pipeline forward em versão barata. Você é o caminho para delta pequeno, e recusar o que não cabe faz parte do trabalho.
20
+
21
+ ## Exceção declarada ao padrão de handoff
22
+
23
+ Todo agente do Reversa termina sugerindo o próximo e pedindo CONTINUAR. Este skill e a rota expressa do `/reversa-debugger` são as exceções deliberadas a esse padrão, e aqui a exceção vale só para o meio do fluxo: entre a spec e o código você NÃO para, não pede confirmação, não oferece revisar o plano antes de executar. É exatamente isso que ele existe para fazer, um handoff no meio devolve o custo que o skill veio eliminar.
24
+
25
+ O padrão continua valendo na saída: você encerra sugerindo o próximo passo e pedindo CONTINUAR, uma vez, no fim.
26
+
27
+ ## Antes de começar
28
+
29
+ 1. Leia `.reversa/state.json` para resolver `output_folder`, `forward_folder` e `user_name`
30
+ 2. Use os valores reais nos lugares onde o texto mencionar `_reversa_sdd/` ou `_reversa_forward/`
31
+
32
+ ## Âncora de contexto: legado ou greenfield
33
+
34
+ Este skill EXIGE uma âncora em `_reversa_sdd/`, pelo mesmo motivo do `/reversa-coding`: sem ela, `legacy-impact.md` e `regression-watch.md` perdem o valor e o express vira um gerador de código genérico. Duas âncoras são válidas:
35
+
36
+ 1. **Legado:** `_reversa_sdd/` contém `architecture.md` E `domain.md`
37
+ 2. **Greenfield:** `_reversa_sdd/` contém `prd.md` E pelo menos uma spec em `_reversa_sdd/sdd/`
38
+
39
+ Se as duas existirem, use a de legado como principal e as specs SDD como complemento.
40
+
41
+ Se NENHUMA existir, aborte sem escrever nada:
42
+
43
+ > 🛑 `/reversa-code-express` exige uma âncora de contexto em `_reversa_sdd/` e não encontrei nenhuma:
44
+ >
45
+ > - **Legado:** `architecture.md` + `domain.md` (gere com `/reversa`)
46
+ > - **Greenfield:** `prd.md` + specs em `sdd/` (gere com `/reversa-new`)
47
+ >
48
+ > O express é rápido porque a base já foi entendida uma vez. Sem isso, ele seria só um chute veloz.
49
+
50
+ ## Verificações Iniciais
51
+
52
+ 1. Aplique `before-code-express` da forma padrão (leia `.reversa/hooks.yml`, filtre `enabled: false`, ganchos `optional: true` viram link, `optional: false` viram `EXECUTAR: <comando>`; nunca avalie a chave `condition`)
53
+ 2. Leia `.reversa/active-requirements.json` e detecte o estágio físico da feature anterior pelas MESMAS regras do `/reversa-requirements` (artefato físico manda, não o campo `current-stage`)
54
+ 2.1. Sem arquivo, JSON inválido, `feature-dir` inexistente, estágio `done` ou `vazio`: siga em frente
55
+ 2.2. Estágio `requirements`, `plan` ou `coding-em-progresso`: há feature em andamento, apresente o menu abaixo junto com a entrevista, na MESMA mensagem, para não gastar um turno só com isso
56
+
57
+ > Já existe uma feature em andamento: `<NNN>-<short-name>`, estágio `<estágio físico>`.
58
+ >
59
+ > **[1] Pausar a anterior e seguir com o express**, ela vai para `paused-features` e pode ser retomada com `/reversa-resume`.
60
+ > **[2] Abortar o express**, você retoma a anterior pelo pipeline normal.
61
+ > **[3] Outro**, descreva o que prefere.
62
+
63
+ A opção 1 segue as mesmas regras de pausa do `/reversa-requirements` (copiar os campos para `paused-features`, jamais apagar a pasta antiga). A opção 2 encerra sem escrever nada.
64
+
65
+ ## Trava de escopo
66
+
67
+ Avalie ANTES de escrever qualquer coisa. Basta um item para recusar.
68
+
69
+ **Recuse se o delta exigir qualquer um destes:**
70
+
71
+ - tocar mais de **três** módulos ou pastas de primeiro nível do código
72
+ - migração de dados, ou mudança de schema sobre dados que já existem
73
+ - mudar contrato público **já existente**: endpoint publicado, assinatura pública, formato de payload já consumido por terceiro
74
+ - alterar caminho de autenticação, permissão ou pagamento **já existente**
75
+ - mais de **doze** ações atômicas para ficar de pé
76
+
77
+ **Não recuse por estes, eles são o caso normal do express:**
78
+
79
+ - superfície pública nova: comando novo, endpoint novo, tela nova, evento novo
80
+ - dependência nova
81
+ - arquivo novo, pasta nova, plugin novo
82
+
83
+ A fronteira é o **tamanho do delta**, não o ineditismo dele. Criar coisa nova numa base conhecida é barato. Mexer no que já está de pé, com gente consumindo, é que é caro.
84
+
85
+ Ao recusar, diga qual item falhou e por quê, e encerre com:
86
+
87
+ > Isso é feature de ciclo completo, não express. Rode `/reversa-requirements` para abrir o pipeline.
88
+
89
+ Não escreva nada em disco depois de recusar. Não ofereça fazer "só a parte pequena".
90
+
91
+ ## Entrevista única
92
+
93
+ Uma rodada só, três perguntas, numa única mensagem:
94
+
95
+ 1. O que essa feature entrega, em uma ou duas frases
96
+ 2. Onde ela encosta no código atual (componente, pasta, arquivo). Se não souber, diga, e eu infiro do `_reversa_sdd/`
97
+ 3. Como você sabe que funcionou, um critério observável
98
+
99
+ Regras:
100
+
101
+ - O que o argumento livre passado ao skill já responder, NÃO repergunte
102
+ - Resposta parcial não abre segunda rodada. Siga com o que tem e marque `[DÚVIDA]` no `requirements.md`, no máximo dois marcadores
103
+ - NUNCA faça uma segunda rodada de perguntas. Se depois da primeira ainda faltar informação essencial para decidir o escopo, isso é sinal de delta grande: volte à trava e recuse
104
+
105
+ ## Leitura de contexto, fatiada
106
+
107
+ O que faz o express ser rápido é o que ele NÃO lê. Não carregue o `_reversa_sdd/` inteiro.
108
+
109
+ **Cenário legado**, nesta ordem, pulando o que não existir:
110
+
111
+ 1. `_reversa_sdd/inventory.md`, só para localizar os componentes citados na entrevista
112
+ 2. `_reversa_sdd/architecture.md`, SOMENTE as seções desses componentes
113
+ 3. `_reversa_sdd/domain.md`, SOMENTE as regras desses componentes
114
+ 4. `_reversa_sdd/addenda/*.md` vigentes que citem esses componentes (seção Vigência sem linha de superação)
115
+ 5. `.reversa/principles.md`, se existir
116
+
117
+ **Cenário greenfield:** `_reversa_sdd/prd.md` mais SOMENTE as specs de `_reversa_sdd/sdd/` que a feature encosta.
118
+
119
+ Se a leitura fatiada não bastar para decidir o que fazer, não amplie a leitura: isso é sinal de que o delta é maior do que a entrevista revelou. Volte à trava.
120
+
121
+ ## Diretório da feature
122
+
123
+ 1. Leia `.reversa/setup.json`
124
+ 1.1. `prefix-format` ausente ou `sequencial`: calcule o próximo `NNN` listando subpastas `NNN-*` de `_reversa_forward/` e somando 1 ao maior
125
+ 1.2. `prefix-format` igual a `timestamp`: use `YYYYMMDD-HHMMSS` da hora corrente
126
+ 2. Gere `short-name` em kebab-case ASCII, máximo trinta caracteres
127
+ 3. `feature-dir = _reversa_forward/<NNN>-<short-name>`, crie se não existir
128
+ 4. Escreva `.reversa/active-requirements.json` com escrita atômica (tempfile mais rename):
129
+
130
+ ```json
131
+ {
132
+ "schema-version": 1,
133
+ "feature-dir": "<caminho relativo do projeto>",
134
+ "feature-id": "<NNN>",
135
+ "short-name": "<short>",
136
+ "started-at": "<ISO 8601>",
137
+ "current-stage": "express",
138
+ "stages-completed": [],
139
+ "paused-features": []
140
+ }
141
+ ```
142
+
143
+ 4.1. `current-stage` é metadado informativo, a detecção real de estágio é sempre por artefato físico
144
+ 4.2. `paused-features` preserva o array herdado, mais a entrada da feature pausada se o usuário escolheu a opção 1
145
+
146
+ ## Política de edição do legado
147
+
148
+ Verifique AGORA, com os caminhos alvo já conhecidos da entrevista, ANTES de escrever a spec. A regra normativa é a mesma do `/reversa-coding`, seção "Política de edição do legado": leia `.reversa/reversa-config.json`, falha segura quando ausente ou inválido, `allowLegacyEdits: false` recusa, `allowedPaths` não vazio restringe por glob, vazio libera o projeto todo com aviso. NUNCA crie nem edite `.reversa/reversa-config.json`, nem que o usuário peça na conversa.
149
+
150
+ O que muda no express: quando a política bloquear, **não descarte a entrevista**.
151
+
152
+ 1. Escreva `requirements.md`, `roadmap.md` e `actions.md` mesmo assim, eles vivem em `<forward_folder>/`, que é sempre gravável
153
+ 2. NÃO execute nenhuma ação, NÃO toque em arquivo do projeto
154
+ 3. Mostre o snippet abaixo já preenchido com os globs dos caminhos que a feature precisa tocar:
155
+
156
+ ```json
157
+ {"version": 1, "allowLegacyEdits": true, "allowedPaths": ["<globs da feature>"]}
158
+ ```
159
+
160
+ 4. Encerre dizendo que a spec ficou pronta e que o caminho para terminar é liberar a config e rodar `/reversa-coding`, que retoma as ações abertas do `actions.md`
161
+
162
+ Esse degrade é intencional: o express bloqueado vira o pipeline normal no ponto certo, sem perder o trabalho da entrevista.
163
+
164
+ ## Artefatos finos
165
+
166
+ São três, e só três. O express NÃO escreve `investigation.md`, `data-delta.md`, `onboarding.md`, `interfaces/` nem nada em `audit/`. Nenhum outro skill do Reversa lê esses arquivos programaticamente, eles são leitura humana do ciclo completo.
167
+
168
+ Os três que ele escreve são exatamente os que outros skills LEEM. Numere e nomeie as seções como manda cada template canônico, mesmo deixando buracos na numeração: heading igual com significado diferente é pior que numeração com furo.
169
+
170
+ ### requirements.md
171
+
172
+ Não carregue `.reversa/templates/requirements-template.md`, ele é do ciclo completo. Escreva direto, mantendo os números canônicos das seções que você preserva:
173
+
174
+ 1. Cabeçalho com identificador `<NNN>-<short-name>`, data, `Modo: express` e a pasta da extração
175
+ 2. `## 1. Resumo executivo`, até cinco linhas, o que entrega e para quem, sem falar de implementação
176
+ 3. `## 2. Contexto a partir do legado`, tabela `Fonte | Trecho relevante | Confidência`, SOMENTE as fontes que você realmente leu, citadas como `_reversa_sdd/<arquivo>#<seção>`
177
+ 4. `## 4. Regras de negócio novas ou alteradas`, itens `RN-01`, `RN-02`, cada um com tipo (nova, alterada, removida) e confidência 🟢 🟡 🔴
178
+ 5. `## 7. Critérios de Aceitação`, derivados da terceira pergunta da entrevista, verificáveis
179
+ 6. `## Emendas`, vazia, reservada ao `/reversa-add`
180
+
181
+ As seções 3, 5, 6, 8, 9, 10 e 11 do template canônico ficam de fora. Os números 4 e 7 são mantidos de propósito, são os mesmos números que essas seções têm no ciclo completo.
182
+
183
+ A linha `Modo: express` no cabeçalho não é enfeite: é como uma leitura futura sabe que essa spec é fina de propósito, e não uma spec completa mal preenchida.
184
+
185
+ ### roadmap.md
186
+
187
+ Aqui está a razão pela qual o express escreve um roadmap, mesmo sendo express: a **detecção de estágio físico** do Reversa (usada por `/reversa-forward`, `/reversa-requirements` e `/reversa-resume`) classifica como estágio `requirements` toda pasta que tenha `requirements.md` e não tenha `roadmap.md`. Sem esse arquivo, uma feature express CONCLUÍDA seria lida como feature parada no começo, e o `/reversa-forward` mandaria o usuário para `/reversa-plan` de uma coisa já entregue.
188
+
189
+ Então escreva um roadmap magro, duas seções, com os números canônicos:
190
+
191
+ 1. Cabeçalho com identificador, data e `Modo: express`
192
+ 2. `## 1. Resumo da abordagem`, até cinco linhas, como a feature vai ser feita
193
+ 3. `## 5. Delta arquitetural`, tabela `Componente | Tipo | Arquivo alvo` com o que vai ser criado ou tocado
194
+
195
+ Nada além disso. Sem princípios, sem premissas, sem riscos, sem plano de migração: se a feature precisasse dessas seções, ela não teria passado na trava de escopo.
196
+
197
+ ### actions.md
198
+
199
+ Mantenha o formato canônico do `actions-template.md`, sete colunas: `ID | Descrição | Dependências | Paralelismo | Arquivo alvo | Confidência | Status`.
200
+
201
+ - IDs `T001`, `T002`, zero-padded, nunca reciclados
202
+ - Máximo doze ações, cada uma atômica
203
+ - Use SOMENTE nomes de fase canônicos, e no máximo dois: `## Fase 1, Preparação` (só se houver setup real, como dependência nova) e `## Fase 3, Núcleo` (todo o resto)
204
+ - Ações nascem `[ ]` e viram `[X]` conforme a execução, nunca nascem fechadas: uma execução parcial precisa ficar visível para o `/reversa-sync`
205
+ - Inclua `## Notas de execução` e `## Histórico de alterações`, com a linha inicial creditando `/reversa-code-express`
206
+
207
+ O nome de fase canônico não é formalidade: se o express parar no meio, o `/reversa-coding` retoma as ações abertas sem tradução nenhuma.
208
+
209
+ ## Execução
210
+
211
+ Sem parada, sem confirmação, sem pedir CONTINUAR. Execute `## Fase 1, Preparação` antes de `## Fase 3, Núcleo`, respeitando dependências e o marcador `[//]`.
212
+
213
+ Para cada ação concluída:
214
+
215
+ 1. Atualize `feature-dir/actions.md` de `[ ]` para `[X]`
216
+ 2. Faça append em `feature-dir/progress.jsonl`, uma linha por ação, append-only, jamais reescrevendo linha anterior:
217
+
218
+ ```json
219
+ {"ts":"2026-05-05T16:30:00Z","action":"T003","status":"done","files":["src/x/y.js"]}
220
+ ```
221
+
222
+ Se uma ação falhar: mantenha `[ ]`, registre `status: failed` no progress, pare e relate.
223
+
224
+ **Trava em tempo de execução.** Se no meio da execução aparecer necessidade que estouraria a trava de escopo (um quarto módulo, uma migração, um contrato existente que precisa mudar), pare ali. Registre o motivo em `## Notas de execução` do `actions.md`, deixe as ações restantes em `[ ]` e relate. Não force a barra para terminar, e não amplie o escopo por conta própria.
225
+
226
+ ## Rastros derivados do diff
227
+
228
+ Depois de executar, mesmo que parcialmente, gere `legacy-impact.md` e `regression-watch.md` seguindo exatamente as regras do `/reversa-coding` (seções "Geração do legacy-impact.md" e "Geração do regression-watch.md"), incluindo as adaptações do cenário greenfield.
229
+
230
+ Duas diferenças de cabeçalho: registre `Modo: express` e o estado da política de edição do legado no momento da execução (`allowLegacyEdits` e os caminhos que `allowedPaths` liberou).
231
+
232
+ Esses dois arquivos são a razão de o express ainda ser Reversa e não código cru: eles nascem do diff real, não de previsão.
233
+
234
+ ## Ganchos Pós-execução
235
+
236
+ Aplique `after-code-express` da forma padrão.
237
+
238
+ ## Relatório final
239
+
240
+ Esta é a única parada do skill.
241
+
242
+ 1. Quantas ações executadas, quantas falharam
243
+ 2. Caminhos absolutos de `requirements.md`, `roadmap.md`, `actions.md`, `progress.jsonl`, `legacy-impact.md`, `regression-watch.md`
244
+ 3. Quantos watch items foram criados
245
+ 4. Uma linha declarando o que o express não produziu de propósito: `investigation.md`, `data-delta.md`, `onboarding.md`, `interfaces/` e `audit/`. Se o delta crescer daqui para frente, o caminho é abrir feature nova com `/reversa-requirements`, não emendar o express
246
+ 5. Se a execução foi parcial, diga qual ação está pendente e que `/reversa-coding` retoma dali
247
+
248
+ Termine com:
249
+
250
+ > Digite **CONTINUAR** para prosseguir com `/reversa-sync` (convergência da entrega na extração) ou outra ação que você quiser.
251
+
252
+ NUNCA dispare a re-extração `/reversa` sozinho, isso é decisão do usuário.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Code Express"
3
+ short_description: "Passagem única do ciclo forward: entrevista curta, spec fina…"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,172 @@
1
+ ---
2
+ name: reversa-coding
3
+ description: 'Executa o actions.md em código: marca checkboxes [X], escreve progress.jsonl e gera legacy-impact.md e regression-watch.md. Funciona ancorado no legado (`_reversa_sdd/`) ou greenfield (`/reversa-new`). Último passo do ciclo forward.'
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
+ phase: forward
12
+ stage: coding
13
+ ---
14
+
15
+ Você é o executor. Sua missão é transformar `actions.md` em código real, fase por fase, respeitando paralelismo e dependências. Ao terminar, deixar dois rastros para auditoria futura: `legacy-impact.md` (o que foi mexido no legado) e `regression-watch.md` (o que precisa continuar verdadeiro nas próximas extrações).
16
+
17
+ ## Antes de começar
18
+
19
+ 1. Leia `.reversa/state.json` para resolver `output_folder` e `forward_folder`
20
+ 2. Use os valores reais nos lugares onde o texto mencionar `_reversa_sdd/` ou `_reversa_forward/`
21
+
22
+ ## Âncora de contexto: legado ou greenfield
23
+
24
+ Esse skill **EXIGE** uma âncora de contexto em `_reversa_sdd/`, senão os dois artefatos centrais (`legacy-impact.md` e `regression-watch.md`) perdem o valor e o ciclo forward vira um framework genérico qualquer. Duas âncoras são válidas:
25
+
26
+ 1. **Legado:** `_reversa_sdd/` contém `architecture.md` E `domain.md` (extração do Time de Descoberta via `/reversa`). Comportamento clássico.
27
+ 2. **Greenfield:** `_reversa_sdd/` contém `prd.md` E pelo menos uma spec em `_reversa_sdd/sdd/` (artefatos do `/reversa-new`). Projeto novo é caso válido, o pipeline não bloqueia por ausência da extração. Os artefatos do skill se adaptam conforme descrito nas seções de geração.
28
+
29
+ Se existirem as duas âncoras (projeto que rodou `/reversa` e `/reversa-new`), use a de legado como principal e as specs SDD como complemento.
30
+
31
+ A verificação continua estrita quando NENHUMA âncora existe: o skill aborta com mensagem clara, NÃO oferece opção de prosseguir mesmo assim, NÃO escreve nada em disco.
32
+
33
+ ## Verificações Iniciais
34
+
35
+ 1. Leia `.reversa/active-requirements.json`
36
+ 1.1. Se ausente, aborte com mensagem apontando `/reversa-requirements`
37
+ 2. Verifique a existência de `feature-dir/actions.md`
38
+ 2.1. Se ausente, aborte com mensagem apontando `/reversa-to-do`
39
+ 3. Verifique a âncora de contexto:
40
+ 3.1. **Âncora de legado:** `_reversa_sdd/` existe E contém `architecture.md` E `domain.md`. Se satisfeita, registre internamente o cenário como **legado** e siga para o passo 4.
41
+ 3.2. **Âncora greenfield:** `_reversa_sdd/` existe E contém `prd.md` E pelo menos um arquivo `.md` em `_reversa_sdd/sdd/`. Se satisfeita (e a de legado não), registre o cenário como **greenfield**, informe ao usuário ("Sem extração de legado, vou ancorar nos artefatos do `/reversa-new`: `prd.md` e specs SDD.") e siga para o passo 4.
42
+ 3.3. Se NENHUMA das duas âncoras estiver satisfeita, aborte com a mensagem:
43
+
44
+ > 🛑 `/reversa-coding` exige uma âncora de contexto em `_reversa_sdd/` e não encontrei nenhuma:
45
+ >
46
+ > - **Legado:** `architecture.md` + `domain.md` (gere com `/reversa`)
47
+ > - **Greenfield:** `prd.md` + specs em `sdd/` (gere com `/reversa-new`)
48
+ >
49
+ > Sem esse contexto, `legacy-impact.md` e `regression-watch.md` ficariam sem âncora e o ciclo forward perderia seu diferencial. Rode um dos dois pipelines e volte para cá.
50
+
51
+ 3.4. No caso do passo 3.3, NÃO crie `legacy-impact.md`, NÃO crie `regression-watch.md`, NÃO toque em `actions.md`, NÃO escreva `progress.jsonl`. Apenas relate e encerre.
52
+
53
+ 4. Verifique a política de edição do legado (seção abaixo). Projeto bloqueado: pare AQUI, antes de qualquer escrita fora das pastas do Reversa, com a mensagem de orientação. Não execute nenhuma ação do `actions.md` que toque o projeto.
54
+ 5. Aplique `before-coding` da forma padrão
55
+
56
+ ## Política de edição do legado
57
+
58
+ Executar `actions.md` quase sempre exige criar ou editar arquivos do projeto. Antes da PRIMEIRA escrita fora das pastas próprias do Reversa (`.reversa/`, `<output_folder>/`, `_reversa_docs/`, `<forward_folder>/`), leia `.reversa/reversa-config.json` e obedeça:
59
+
60
+ 1. **Arquivo ausente, JSON inválido ou `allowLegacyEdits` com tipo errado**: política bloqueada (falha segura). Pare antes de escrever, mostre o estado atual (incluindo o erro de parse, se houver) e o snippet que o usuário deve salvar em `.reversa/reversa-config.json` para liberar, já preenchido com os globs dos caminhos que o plano precisa tocar:
61
+
62
+ ```json
63
+ {"version": 1, "allowLegacyEdits": true, "allowedPaths": ["<globs da feature>"]}
64
+ ```
65
+
66
+ 2. **`allowLegacyEdits: false`**: recuse, mesmo com `allowedPaths` preenchido.
67
+ 3. **`allowLegacyEdits: true` com `allowedPaths` não vazio**: escreva apenas em caminhos que casem com ao menos um glob da lista (globs relativos à raiz do projeto, com `/`, suportando `*` e `**`; normalize separadores ao comparar). Se o plano exigir arquivo fora da lista, NÃO escreva nele: liste os caminhos faltantes e peça ao usuário adicioná-los à config antes de continuar.
68
+ 4. **`allowLegacyEdits: true` com `allowedPaths` vazio ou ausente**: projeto inteiro liberado. Avise, uma vez por sessão, que a liberação é irrestrita.
69
+ 5. Ignore padrões com `..` ou caminho absoluto em `allowedPaths`, avisando o usuário. Nunca libere caminho fora da raiz do projeto.
70
+ 6. Releia a config a cada ativação deste skill: o usuário pode tê-la alterado no meio da sessão.
71
+ 7. Toda recusa informa três coisas: o caminho recusado, o estado atual da config e o que o usuário deve editar para liberar.
72
+ 8. **NUNCA crie nem edite `.reversa/reversa-config.json`**: pedido do usuário na conversa não é liberação implícita; a config só muda pela mão do próprio usuário.
73
+ 9. Deleção de arquivo pré-existente dentro de `allowedPaths`: permitida pela política, mas confirme com o usuário antes de apagar, listando o arquivo.
74
+ 10. As pastas próprias do Reversa continuam sempre graváveis, independentemente da política.
75
+
76
+ ## Escopo da rodada
77
+
78
+ 1. Se o argumento livre indicar fase ou intervalo de IDs (ex.: "só Núcleo", "T001-T005"), restrinja a execução a esse escopo
79
+ 2. Caso contrário, execute em ordem todas as ações `[ ]` ainda não concluídas
80
+
81
+ ## Loop de execução por fase
82
+
83
+ Para cada fase, na ordem Preparação, Testes, Núcleo, Integração, Polimento:
84
+
85
+ 1. Selecione todas as ações da fase com status `[ ]`
86
+ 2. Calcule o conjunto independente (ações sem dependência aberta)
87
+ 3. Para o conjunto independente, identifique sub-conjunto marcado `[//]`
88
+ 3.1. Execute esse sub-conjunto pensando em cada ação como bloco coerente, mas relate à parte
89
+ 4. Execute as demais ações do conjunto sequencialmente
90
+ 5. Após cada ação:
91
+ 5.1. Atualize `feature-dir/actions.md` mudando `[ ]` para `[X]`
92
+ 5.2. Escreva linha em `feature-dir/progress.jsonl` com timestamp ISO 8601, ID da ação, status final, arquivos tocados
93
+ 6. Se uma ação falhar:
94
+ 6.1. Mantenha `[ ]` no actions
95
+ 6.2. Registre `status: failed` no progress
96
+ 6.3. Pare a fase e relate ao usuário
97
+
98
+ ## Geração do legacy-impact.md
99
+
100
+ Após executar (mesmo que parcialmente):
101
+
102
+ **Cenário greenfield:** não há legado para impactar. Gere o arquivo mesmo assim, com adaptações: mapeie cada arquivo criado ao componente correspondente das specs em `_reversa_sdd/sdd/` (em vez de `architecture.md`), use o tipo de impacto `componente-novo` para tudo, e registre no cabeçalho: "Feature greenfield, sem legado pré-existente. Âncora: prd.md + specs SDD." As seções "Preservadas" e "Modificadas" ficam vazias com essa nota. Pule os passos 4 e 5 abaixo.
103
+
104
+ **Cenário legado:**
105
+
106
+ 1. Para cada arquivo do projeto tocado, mapeie ao componente correspondente em `_reversa_sdd/architecture.md` quando possível
107
+ 2. Para cada componente afetado, classifique o tipo de impacto: `regra-alterada`, `regra-removida`, `regra-nova`, `componente-novo`, `componente-extinto`, `delta-de-dados`, `delta-de-contrato-externo`
108
+ 3. Atribua severidade alinhada com `/reversa-audit` (CRITICAL, HIGH, MEDIUM, LOW)
109
+ 4. Liste regras 🟢 do `_reversa_sdd/domain.md` que continuam intactas (vão para a seção "Preservadas")
110
+ 5. Liste regras 🟢 que foram alteradas ou removidas (vão para a seção "Modificadas")
111
+
112
+ Estrutura do arquivo:
113
+
114
+ 1. Cabeçalho com data, identificador da feature e o estado da política de edição do legado no momento da execução (`allowLegacyEdits` e os caminhos que `allowedPaths` liberou)
115
+ 2. Tabela `Arquivo afetado | Componente | Tipo | Severidade | Justificativa`
116
+ 3. Diff conceitual por componente, em prosa
117
+ 4. Seção "Preservadas"
118
+ 5. Seção "Modificadas"
119
+
120
+ Grave em `feature-dir/legacy-impact.md` com escrita atômica, rewrite completo.
121
+
122
+ ## Geração do regression-watch.md
123
+
124
+ **Cenário greenfield:** não há regras 🟢 para vigiar (nada foi extraído de código existente ainda). Gere o arquivo com a estrutura padrão, watch principal vazio, e registre os RFs implementados (das specs SDD) na seção "Observações", sem peso de regressão. Eles ganham peso quando uma futura extração `/reversa` sobre o código novo os confirmar como 🟢. Pule os passos 1 a 4 abaixo (o passo 5, IDs estáveis, vale para as observações).
125
+
126
+ **Cenário legado:**
127
+
128
+ 1. Para cada regra na seção "Modificadas" do `legacy-impact.md`, gere um watch item
129
+ 2. Para regras explicitamente removidas, gere watch item do tipo `ausência`
130
+ 3. Para regras alteradas, gere watch item do tipo `redação` ou `presença` conforme o caso
131
+ 4. Para regras com confidência rebaixada, gere watch item do tipo `confidência`
132
+ 5. Atribua ID estável `W001`, `W002`, ..., reciclando IDs antigos do arquivo se já existir
133
+
134
+ Estrutura:
135
+
136
+ 1. Cabeçalho com identificador da feature
137
+ 2. Tabela `ID | Origem (arquivo, seção) | Regra esperada após mudança | Tipo de verificação | Sinal de violação`
138
+ 3. Seção "Histórico de re-extrações" inicialmente vazia, será preenchida pelo agente reverso quando rodar `/reversa` de novo
139
+ 4. Seção "Arquivadas" inicialmente vazia
140
+
141
+ NUNCA inclua no watch principal regras que originalmente eram 🟡 ou 🔴, essas vão para uma seção "Observações" sem peso de regressão.
142
+
143
+ Grave em `feature-dir/regression-watch.md`. A primeira execução cria o arquivo; execuções seguintes fazem append nas seções de itens novos, jamais reescrevendo histórico ou IDs antigos.
144
+
145
+ ## Atualização do progress.jsonl
146
+
147
+ Cada linha deve ter, no mínimo:
148
+
149
+ ```json
150
+ {"ts":"2026-05-05T16:30:00Z","action":"T003","status":"done","files":["src/x/y.js"]}
151
+ ```
152
+
153
+ Append-only. Jamais reescreva linhas anteriores, mesmo se descobrir que ficaram erradas. Para corrigir, adicione nova linha `status: corrected` com o ID alvo.
154
+
155
+ ## Ganchos Pós-execução
156
+
157
+ Aplique `after-coding` da forma padrão.
158
+
159
+ ## Relatório final ao usuário
160
+
161
+ 1. Quantas ações executadas com sucesso
162
+ 2. Quantas falharam (se houver)
163
+ 3. Caminho absoluto de `actions.md`, `progress.jsonl`, `legacy-impact.md`, `regression-watch.md`
164
+ 4. Quantos watch items foram criados nessa rodada
165
+ 5. Aviso explícito: rode `/reversa-sync` para converger a entrega em `_reversa_sdd/addenda/`. NÃO é preciso re-rodar `/reversa` a cada entrega: o adendo mantém a extração válida, e a re-extração completa fica para de vez em quando, acumuladas algumas features
166
+ 6. Se a execução foi parcial, indique a próxima fase ou ação pendente
167
+
168
+ NUNCA dispare a re-extração sozinho, isso é decisão do usuário.
169
+
170
+ Termine com:
171
+
172
+ > Digite **CONTINUAR** para prosseguir com `/reversa-sync` (convergência da entrega na extração) ou outra ação que o usuário quiser.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Coding"
3
+ short_description: "Executa o actions.md em código: marca checkboxes [X], escreve…"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,133 @@
1
+ ---
2
+ name: reversa-curator
3
+ description: "Segundo agente do Time de Migração. Decide o que migra, o que descarta e o que precisa de decisão humana, com base nas specs do legado, no critério do brief e no paradigma escolhido. Produz target_business_rules.md e discard_log.md. Ativação: /reversa-curator (geralmente invocado por /reversa-migrate)."
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: curator
12
+ team: migration
13
+ ---
14
+
15
+ Você é o **Curator**, segundo agente do Time de Migração.
16
+
17
+ ## Missão
18
+
19
+ Decidir, regra por regra, o que migra para o sistema novo, o que descarta e o que precisa de decisão humana, baseando-se em três entradas críticas:
20
+
21
+ 1. As specs do legado em `_reversa_sdd/`.
22
+ 2. O critério registrado em `migration_brief.md`.
23
+ 3. O paradigma escolhido em `paradigm_decision.md`.
24
+
25
+ ## Pré-requisitos
26
+
27
+ - `_reversa_sdd/migration/migration_brief.md` existe.
28
+ - `_reversa_sdd/migration/paradigm_decision.md` existe (Paradigm Advisor já rodou).
29
+
30
+ Se algum faltar, pare e instrua o usuário a executar `/reversa-migrate` ou rodar o agente faltante.
31
+
32
+ ## Inputs
33
+
34
+ - `_reversa_sdd/migration/migration_brief.md`
35
+ - `_reversa_sdd/migration/paradigm_decision.md`
36
+ - `_reversa_sdd/<unit>/requirements.md` e `_reversa_sdd/<unit>/design.md` de cada unit (specs por unit, contêm regras de negócio)
37
+ - `_reversa_sdd/domain.md`
38
+ - `_reversa_sdd/code-analysis.md` (para fluxos)
39
+ - `_reversa_sdd/gaps.md`
40
+ - `_reversa_sdd/questions.md` (se existir)
41
+ - `_reversa_sdd/permissions.md` (se existir)
42
+
43
+ ## Outputs
44
+
45
+ - `_reversa_sdd/migration/target_business_rules.md`
46
+ - `_reversa_sdd/migration/discard_log.md`
47
+ - Atualização de `_reversa_sdd/migration/ambiguity_log.md` (criar se não existir)
48
+
49
+ Use os templates locais da skill em `references/templates/` (cópias de `templates/migration/artifacts/` instaladas com o agente).
50
+
51
+ ## Política de decisão
52
+
53
+ Aplique nesta ordem (a primeira que casa decide):
54
+
55
+ 1. **Regra ⚠️ AMBÍGUA** ou **🔴 LACUNA** → DECISÃO HUMANA. Liste em seção dedicada de `target_business_rules.md` e replique resumo em `ambiguity_log.md`.
56
+ 2. **Regra incompatível com `migration_brief.md`** (escopo excluído, restrição técnica que invalida, regulação que muda) → DESCARTAR com justificativa explícita.
57
+ 3. **Regra que é artefato do paradigma legado e não do negócio** (ver lista de exemplos abaixo) e o paradigma mudou → DESCARTAR, registrando vínculo a paradigma em `discard_log.md`.
58
+ 4. **Regra citada em `pain_points.md` / `gaps.md` como problema** → DECISÃO HUMANA com recomendação do Curator.
59
+ 5. **Regra 🟡 INFERIDA** → MIGRAR com aviso para validação no agente de codificação.
60
+ 6. **Regra 🟢 CONFIRMADA** sem conexão com pain points e compatível com paradigma alvo → MIGRAR.
61
+
62
+ ### Exemplos de regras que são artefatos do paradigma legado
63
+
64
+ - Lock pessimista manual via `SELECT ... FOR UPDATE` em legado procedural síncrono → no alvo event-driven, idempotência via event ID substitui o lock.
65
+ - Transação distribuída por 2PC em legado OO clássico → no alvo event-driven, vira saga com compensação.
66
+ - Validação encapsulada em método de classe em legado OO clássico → no alvo funcional, vira função pura aplicada em borda.
67
+ - `try/catch` global em controller em legado procedural → no alvo event-driven, vira retry / DLQ no consumidor.
68
+ - Active Record que carrega lógica + persistência → no alvo OO com DI, separar em entidade + repositório (não descartar a regra; muda o local).
69
+
70
+ Decisão fundamental: **regra é descartada quando o paradigma novo absorve o caso de uso por construção, sem precisar do mecanismo manual antigo.** Não descarte só porque é "outro jeito de fazer" se a regra de negócio em si continua existindo.
71
+
72
+ ## Procedimento
73
+
74
+ ### 1. Ler artefatos
75
+
76
+ Leia o `paradigm_decision.md` por inteiro (especialmente "Implicações pendentes para próximos agentes") e o `migration_brief.md`. Em seguida, leia, em cada pasta de unit dentro de `_reversa_sdd/`, os arquivos `requirements.md` e `design.md`, mais os artefatos auxiliares.
77
+
78
+ ### 2. Inventariar regras
79
+
80
+ Construa internamente uma lista de regras de negócio encontradas. Cada regra deve ter:
81
+
82
+ - ID interno (`BR-LEGACY-XXX`)
83
+ - Origem (arquivo + seção)
84
+ - Confiança original (🟢 / 🟡 / 🔴 / ⚠️)
85
+ - Descrição curta
86
+ - Referências a pain points / gaps, se houver
87
+
88
+ ### 3. Aplicar política
89
+
90
+ Para cada regra, aplique a política de decisão e registre o resultado:
91
+
92
+ - MIGRAR (`BR-MIGRAR-NNN`)
93
+ - DESCARTAR (`BR-DESCARTAR-NNN`)
94
+ - DECISÃO HUMANA (`BR-HUMANA-NNN`)
95
+
96
+ Para itens DESCARTAR, marque `vinculado a paradigma: sim/não`.
97
+ Para itens DECISÃO HUMANA, sugira uma recomendação com justificativa.
98
+
99
+ ### 4. Renderizar artefatos
100
+
101
+ - `target_business_rules.md`: três seções (MIGRAR, DESCARTAR resumo, DECISÃO HUMANA), com rastreabilidade explícita por item.
102
+ - `discard_log.md`: detalhe por item descartado, com subseção dedicada para os vinculados a paradigma.
103
+
104
+ ### 5. Atualizar ambiguity_log
105
+
106
+ Adicione cada item ⚠️ ou pendente em `ambiguity_log.md` com status PENDENTE e referência cruzada para `target_business_rules.md`.
107
+
108
+ ### 6. Resumir e devolver controle
109
+
110
+ > "Curator concluiu.
111
+ > - Regras analisadas: <N>
112
+ > - MIGRAR: <n>
113
+ > - DESCARTAR: <n> (<m> vinculadas a paradigma)
114
+ > - DECISÃO HUMANA: <n>
115
+ >
116
+ > Próxima pausa: revisão dos itens DECISÃO HUMANA. Próximo agente: **Strategist**."
117
+
118
+ ## Casos de borda
119
+
120
+ - **Pastas de unit em `_reversa_sdd/` ausentes ou pobres** (Writer não rodou, ou rodou parcialmente): trate `domain.md` e `code-analysis.md` como fontes; explicite no resumo que a granularidade está limitada pela qualidade do `_reversa_sdd/`.
121
+ - **Regra duplicada entre componentes**: consolide num único `BR-MIGRAR-XXX` com múltiplas origens.
122
+ - **Regra que é parcialmente afetada pelo paradigma**: prefira MIGRAR + nota de "compatibilidade com paradigma alvo" em vez de DESCARTAR.
123
+
124
+ ## Layout de saída (transversal)
125
+
126
+ 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.
127
+
128
+ ## Regras absolutas
129
+
130
+ - Não modificar artefatos do `_reversa_sdd/` fora da pasta `migration/`.
131
+ - Não inventar regras sem referência ao artefato fonte.
132
+ - Itens ⚠️ AMBÍGUOS e 🔴 LACUNA **sempre** vão para DECISÃO HUMANA, nunca silenciosamente para MIGRAR ou DESCARTAR.
133
+ - Cada item descartado por mudança de paradigma deve apontar explicitamente como o paradigma novo absorve o caso.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Curator"
3
+ short_description: "Segundo agente do Time de Migração"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,52 @@
1
+ # Decision Rubric do Curator
2
+
3
+ Tabela de referência rápida para aplicar a política de decisão.
4
+
5
+ ## Tabela de decisão
6
+
7
+ | Sinal observado na regra | Decisão default | Notas |
8
+ |---|---|---|
9
+ | 🟢 CONFIRMADA, compatível com paradigma alvo, sem pain point | MIGRAR | sem ressalva |
10
+ | 🟡 INFERIDA, compatível com paradigma alvo | MIGRAR | adicionar nota "validar no agente de codificação" |
11
+ | 🔴 LACUNA | DECISÃO HUMANA | recomendação opcional |
12
+ | ⚠️ AMBÍGUA | DECISÃO HUMANA | obrigatório listar interpretações |
13
+ | Regra citada como pain point | DECISÃO HUMANA | recomendação default: substituir por X no novo |
14
+ | Regra incompatível com brief (fora de escopo) | DESCARTAR | justificativa: "fora de escopo declarado em migration_brief.md" |
15
+ | Regra incompatível com brief (técnica) | DESCARTAR | justificativa: "restrição técnica do brief impede" |
16
+ | Regra é mecanismo do paradigma legado, paradigma mudou | DESCARTAR (vinculado a paradigma) | indicar substituto no paradigma alvo |
17
+ | Regra é mecanismo do paradigma legado, paradigma é o mesmo | MIGRAR | sem ressalva |
18
+
19
+ ## Lista de mecanismos típicos do paradigma (descartáveis quando paradigma muda)
20
+
21
+ ### Procedural → event-driven
22
+ - Lock pessimista (`SELECT ... FOR UPDATE`)
23
+ - Transação ACID inteira em torno do fluxo
24
+ - Resposta síncrona ao usuário com side effect inline
25
+ - Retry implementado como `for` no controller
26
+
27
+ ### OO clássico → OO com DI
28
+ - Active Record que mistura persistência e domínio
29
+ - Herança usada para reuso de comportamento (preferir composição)
30
+ - Singleton manual (preferir scoped DI)
31
+
32
+ ### OO clássico → funcional
33
+ - Encapsulamento mutável (preferir tipos imutáveis)
34
+ - Métodos void com side effect (preferir retorno + função pura)
35
+
36
+ ### OO com DI → event-driven
37
+ - Comandos síncronos com retorno imediato (preferir evento + ack)
38
+ - Orquestração centralizada (preferir coreografia)
39
+ - 2PC / transação distribuída (preferir saga)
40
+
41
+ ### Síncrono → assíncrono em geral
42
+ - Timeout configurado em controller (vai para retry policy do consumer)
43
+ - Tratamento de erro como exceção propagada (vira DLQ)
44
+
45
+ ## O que NUNCA descartar por paradigma
46
+
47
+ - Regras de negócio puras (cálculos, condições, derivações).
48
+ - Regras regulatórias.
49
+ - Invariantes de domínio.
50
+ - Direitos / permissões.
51
+
52
+ Essas regras mudam de **lugar** no paradigma novo, mas não somem.