@flaviogarrido/reversa 0.0.0-stage → 1.3.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (421) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +487 -2
  3. package/agents/fg-backlog/SKILL.md +129 -0
  4. package/agents/fg-backlog/agents/openai.yaml +5 -0
  5. package/agents/fg-backlog/references/backlog-template.md +60 -0
  6. package/agents/fg-backlog/references/priorizacao.md +41 -0
  7. package/agents/impeccable/LICENSE +191 -0
  8. package/agents/impeccable/NOTICE.md +11 -0
  9. package/agents/impeccable/SKILL.md +88 -0
  10. package/agents/impeccable/agents/impeccable_asset_producer.toml +47 -0
  11. package/agents/impeccable/agents/impeccable_documenter.toml +27 -0
  12. package/agents/impeccable/agents/impeccable_finish_reviewer.toml +41 -0
  13. package/agents/impeccable/agents/impeccable_manual_edit_applier.toml +95 -0
  14. package/agents/impeccable/agents/openai.yaml +4 -0
  15. package/agents/impeccable/reference/adapt.md +318 -0
  16. package/agents/impeccable/reference/adapt.native.md +58 -0
  17. package/agents/impeccable/reference/android.md +46 -0
  18. package/agents/impeccable/reference/animate.md +89 -0
  19. package/agents/impeccable/reference/audit.md +139 -0
  20. package/agents/impeccable/reference/audit.native.md +139 -0
  21. package/agents/impeccable/reference/bolder.md +33 -0
  22. package/agents/impeccable/reference/clarify.md +94 -0
  23. package/agents/impeccable/reference/colorize.md +86 -0
  24. package/agents/impeccable/reference/component-review.md +63 -0
  25. package/agents/impeccable/reference/craft-floor.md +44 -0
  26. package/agents/impeccable/reference/craft.md +5 -0
  27. package/agents/impeccable/reference/critique.md +819 -0
  28. package/agents/impeccable/reference/degraded/asset-producer.md +42 -0
  29. package/agents/impeccable/reference/degraded/documenter.md +24 -0
  30. package/agents/impeccable/reference/degraded/finish-reviewer.md +38 -0
  31. package/agents/impeccable/reference/degraded/manual-edit-applier.md +92 -0
  32. package/agents/impeccable/reference/delight.md +70 -0
  33. package/agents/impeccable/reference/distill.md +111 -0
  34. package/agents/impeccable/reference/doctor.md +54 -0
  35. package/agents/impeccable/reference/document.md +416 -0
  36. package/agents/impeccable/reference/extract.md +69 -0
  37. package/agents/impeccable/reference/generate.md +101 -0
  38. package/agents/impeccable/reference/harden.md +343 -0
  39. package/agents/impeccable/reference/hooks.md +113 -0
  40. package/agents/impeccable/reference/init.md +131 -0
  41. package/agents/impeccable/reference/ios.md +51 -0
  42. package/agents/impeccable/reference/layout.md +84 -0
  43. package/agents/impeccable/reference/live-setup.md +104 -0
  44. package/agents/impeccable/reference/live.md +325 -0
  45. package/agents/impeccable/reference/mode-operate.md +21 -0
  46. package/agents/impeccable/reference/mode-persuade.md +19 -0
  47. package/agents/impeccable/reference/mode-read.md +21 -0
  48. package/agents/impeccable/reference/new-work.md +154 -0
  49. package/agents/impeccable/reference/onboard.md +234 -0
  50. package/agents/impeccable/reference/operate.md +61 -0
  51. package/agents/impeccable/reference/optimize.md +258 -0
  52. package/agents/impeccable/reference/overdrive.md +127 -0
  53. package/agents/impeccable/reference/polish.md +105 -0
  54. package/agents/impeccable/reference/quieter.md +99 -0
  55. package/agents/impeccable/reference/region-map.md +26 -0
  56. package/agents/impeccable/reference/routing.md +24 -0
  57. package/agents/impeccable/reference/shape.md +59 -0
  58. package/agents/impeccable/reference/typeset.md +90 -0
  59. package/agents/impeccable/reference/visualize.md +47 -0
  60. package/agents/impeccable/reversa-bundle.json +16 -0
  61. package/agents/impeccable/scripts/VERSION +1 -0
  62. package/agents/impeccable/scripts/command-metadata.json +98 -0
  63. package/agents/impeccable/scripts/data/font-index-failures.json +121 -0
  64. package/agents/impeccable/scripts/data/font-index.json +1 -0
  65. package/agents/impeccable/scripts/impeccable +212 -0
  66. package/agents/impeccable/scripts/impeccable.cmd +239 -0
  67. package/agents/impeccable/scripts/live-browser-dom.js +320 -0
  68. package/agents/impeccable/scripts/live-browser-ignores.js +242 -0
  69. package/agents/impeccable/scripts/live-browser-session.js +180 -0
  70. package/agents/impeccable/scripts/live-browser.js +13557 -0
  71. package/agents/impeccable/scripts/modern-screenshot.umd.js +14 -0
  72. package/agents/reversa/SKILL.md +135 -0
  73. package/agents/reversa/agents/openai.yaml +3 -0
  74. package/agents/reversa/references/checkpoint-guide.md +106 -0
  75. package/agents/reversa/references/state-schema.md +80 -0
  76. package/agents/reversa/references/step-01-first-run.md +63 -0
  77. package/agents/reversa/references/step-02-resume.md +88 -0
  78. package/agents/reversa/references/step-03-specs-organization.md +145 -0
  79. package/agents/reversa/references/step-04-regression-check.md +94 -0
  80. package/agents/reversa-add/SKILL.md +131 -0
  81. package/agents/reversa-add/agents/openai.yaml +5 -0
  82. package/agents/reversa-agents-help/SKILL.md +211 -0
  83. package/agents/reversa-agents-help/agents/openai.yaml +3 -0
  84. package/agents/reversa-arbiter/SKILL.md +140 -0
  85. package/agents/reversa-arbiter/agents/openai.yaml +5 -0
  86. package/agents/reversa-archaeologist/SKILL.md +95 -0
  87. package/agents/reversa-archaeologist/agents/openai.yaml +5 -0
  88. package/agents/reversa-archaeologist/references/modules-schema.md +69 -0
  89. package/agents/reversa-architect/SKILL.md +93 -0
  90. package/agents/reversa-architect/agents/openai.yaml +5 -0
  91. package/agents/reversa-arquitetura-3d/SKILL.md +163 -0
  92. package/agents/reversa-arquitetura-3d/agents/openai.yaml +5 -0
  93. package/agents/reversa-arquitetura-3d/references/ARCH_TOUR.md +242 -0
  94. package/agents/reversa-arquitetura-3d/references/CALL_GRAPH_3D.md +217 -0
  95. package/agents/reversa-arquitetura-3d/references/CODE_CITY.md +228 -0
  96. package/agents/reversa-arquitetura-3d/references/DEPENDENCY_GRAPH_3D.md +240 -0
  97. package/agents/reversa-arquitetura-3d/references/ERRORS.md +286 -0
  98. package/agents/reversa-arquitetura-3d/references/LAYER_STACK.md +230 -0
  99. package/agents/reversa-arquitetura-3d/references/THREE_PATTERNS.md +221 -0
  100. package/agents/reversa-audit/SKILL.md +98 -0
  101. package/agents/reversa-audit/agents/openai.yaml +5 -0
  102. package/agents/reversa-autonomous/SKILL.md +139 -0
  103. package/agents/reversa-autonomous/agents/openai.yaml +3 -0
  104. package/agents/reversa-brainstorm/SKILL.md +131 -0
  105. package/agents/reversa-brainstorm/agents/openai.yaml +3 -0
  106. package/agents/reversa-challenger/SKILL.md +122 -0
  107. package/agents/reversa-challenger/agents/openai.yaml +5 -0
  108. package/agents/reversa-clarify/SKILL.md +103 -0
  109. package/agents/reversa-clarify/agents/openai.yaml +5 -0
  110. package/agents/reversa-code-express/SKILL.md +252 -0
  111. package/agents/reversa-code-express/agents/openai.yaml +5 -0
  112. package/agents/reversa-coding/SKILL.md +172 -0
  113. package/agents/reversa-coding/agents/openai.yaml +5 -0
  114. package/agents/reversa-curator/SKILL.md +133 -0
  115. package/agents/reversa-curator/agents/openai.yaml +5 -0
  116. package/agents/reversa-curator/references/decision-rubric.md +52 -0
  117. package/agents/reversa-curator/references/templates/discard_log.md +37 -0
  118. package/agents/reversa-curator/references/templates/target_business_rules.md +54 -0
  119. package/agents/reversa-data-master/SKILL.md +67 -0
  120. package/agents/reversa-data-master/agents/openai.yaml +5 -0
  121. package/agents/reversa-debugger/SKILL.md +178 -0
  122. package/agents/reversa-debugger/agents/openai.yaml +3 -0
  123. package/agents/reversa-debugger/references/bug-schema.md +123 -0
  124. package/agents/reversa-debugger/references/bugs-readme-template.md +76 -0
  125. package/agents/reversa-debugger-debate/SKILL.md +75 -0
  126. package/agents/reversa-debugger-debate/agents/openai.yaml +5 -0
  127. package/agents/reversa-debugger-debate/references/debate-protocol.md +102 -0
  128. package/agents/reversa-debugger-fix/SKILL.md +170 -0
  129. package/agents/reversa-debugger-fix/agents/openai.yaml +5 -0
  130. package/agents/reversa-debugger-graph/SKILL.md +94 -0
  131. package/agents/reversa-debugger-graph/agents/openai.yaml +5 -0
  132. package/agents/reversa-decouple/SKILL.md +78 -0
  133. package/agents/reversa-decouple/agents/openai.yaml +5 -0
  134. package/agents/reversa-depth-inspection/SKILL.md +99 -0
  135. package/agents/reversa-depth-inspection/agents/openai.yaml +5 -0
  136. package/agents/reversa-design-system/SKILL.md +77 -0
  137. package/agents/reversa-design-system/agents/openai.yaml +5 -0
  138. package/agents/reversa-designer/SKILL.md +217 -0
  139. package/agents/reversa-designer/agents/openai.yaml +5 -0
  140. package/agents/reversa-designer/references/paradigm-checklist.md +50 -0
  141. package/agents/reversa-designer/references/templates/data_migration_plan.md +80 -0
  142. package/agents/reversa-designer/references/templates/target_architecture.md +68 -0
  143. package/agents/reversa-designer/references/templates/target_data_model.md +64 -0
  144. package/agents/reversa-designer/references/templates/target_domain_model.md +62 -0
  145. package/agents/reversa-designer/references/templates/topology_decision.md +82 -0
  146. package/agents/reversa-detective/SKILL.md +82 -0
  147. package/agents/reversa-detective/agents/openai.yaml +5 -0
  148. package/agents/reversa-docs/SKILL.md +241 -0
  149. package/agents/reversa-docs/agents/openai.yaml +3 -0
  150. package/agents/reversa-docs/references/config-schema.json +108 -0
  151. package/agents/reversa-docs/references/expected_sources.yaml +60 -0
  152. package/agents/reversa-docs-analyst/SKILL.md +163 -0
  153. package/agents/reversa-docs-analyst/agents/openai.yaml +5 -0
  154. package/agents/reversa-docs-mapper/SKILL.md +167 -0
  155. package/agents/reversa-docs-mapper/agents/openai.yaml +5 -0
  156. package/agents/reversa-docs-mapper/references/extraction-policy.md +44 -0
  157. package/agents/reversa-docs-publisher/SKILL.md +323 -0
  158. package/agents/reversa-docs-publisher/agents/openai.yaml +5 -0
  159. package/agents/reversa-docs-publisher/references/auxiliary_sources.yaml +27 -0
  160. package/agents/reversa-docs-publisher/references/vendor-pins.yaml +149 -0
  161. package/agents/reversa-docs-storyteller/SKILL.md +189 -0
  162. package/agents/reversa-docs-storyteller/agents/openai.yaml +5 -0
  163. package/agents/reversa-drafter/SKILL.md +189 -0
  164. package/agents/reversa-drafter/agents/openai.yaml +5 -0
  165. package/agents/reversa-especialista-d3/SKILL.md +37 -0
  166. package/agents/reversa-especialista-d3/agents/openai.yaml +5 -0
  167. package/agents/reversa-especialista-d3/references/api-core.md +13 -0
  168. package/agents/reversa-especialista-d3/references/interatividade.md +5 -0
  169. package/agents/reversa-especialista-d3/references/layouts-complexos.md +8 -0
  170. package/agents/reversa-explorer/SKILL.md +110 -0
  171. package/agents/reversa-explorer/agents/openai.yaml +5 -0
  172. package/agents/reversa-extract-soul/SKILL.md +221 -0
  173. package/agents/reversa-extract-soul/agents/openai.yaml +5 -0
  174. package/agents/reversa-forward/SKILL.md +235 -0
  175. package/agents/reversa-forward/agents/openai.yaml +3 -0
  176. package/agents/reversa-forward-autonomous/SKILL.md +184 -0
  177. package/agents/reversa-forward-autonomous/agents/openai.yaml +3 -0
  178. package/agents/reversa-framer/SKILL.md +124 -0
  179. package/agents/reversa-framer/agents/openai.yaml +5 -0
  180. package/agents/reversa-highcharts-visualizer/SKILL.md +123 -0
  181. package/agents/reversa-highcharts-visualizer/agents/openai.yaml +5 -0
  182. package/agents/reversa-highcharts-visualizer/references/CHART_CATALOG.md +450 -0
  183. package/agents/reversa-highcharts-visualizer/references/ERRORS.md +99 -0
  184. package/agents/reversa-highcharts-visualizer/references/HIGHCHARTS_PATTERNS.md +347 -0
  185. package/agents/reversa-highcharts-visualizer/scripts/analyze_data.py +219 -0
  186. package/agents/reversa-highcharts-visualizer/scripts/parse_data.py +246 -0
  187. package/agents/reversa-highcharts-visualizer/scripts/sample_data.py +208 -0
  188. package/agents/reversa-ideator/SKILL.md +139 -0
  189. package/agents/reversa-ideator/agents/openai.yaml +5 -0
  190. package/agents/reversa-image-prompt-json/SKILL.md +210 -0
  191. package/agents/reversa-image-prompt-json/agents/openai.yaml +5 -0
  192. package/agents/reversa-image-prompt-json/references/Examples.md +123 -0
  193. package/agents/reversa-inspector/SKILL.md +147 -0
  194. package/agents/reversa-inspector/agents/openai.yaml +5 -0
  195. package/agents/reversa-inspector/references/parity-coverage-matrix.md +54 -0
  196. package/agents/reversa-inspector/references/templates/parity_specs.md +64 -0
  197. package/agents/reversa-inspector/references/templates/parity_test.feature +40 -0
  198. package/agents/reversa-migrate/SKILL.md +282 -0
  199. package/agents/reversa-migrate/agents/openai.yaml +3 -0
  200. package/agents/reversa-migrate/references/auto-defaults.md +52 -0
  201. package/agents/reversa-migrate/references/expected_legacy_artifacts.yaml +69 -0
  202. package/agents/reversa-migrate/references/handoff-checklist.md +34 -0
  203. package/agents/reversa-migrate/references/state.json +28 -0
  204. package/agents/reversa-migrate/references/templates/ambiguity_log.md +43 -0
  205. package/agents/reversa-migrate/references/templates/handoff.md +91 -0
  206. package/agents/reversa-migrate/references/templates/migration_brief.md +52 -0
  207. package/agents/reversa-migrate/references/templates/pending_decisions.md +36 -0
  208. package/agents/reversa-modularize/SKILL.md +77 -0
  209. package/agents/reversa-modularize/agents/openai.yaml +5 -0
  210. package/agents/reversa-n8n/SKILL.md +256 -0
  211. package/agents/reversa-n8n/agents/openai.yaml +5 -0
  212. package/agents/reversa-n8n/references/node-catalog.md +245 -0
  213. package/agents/reversa-new/SKILL.md +328 -0
  214. package/agents/reversa-new/agents/openai.yaml +3 -0
  215. package/agents/reversa-optimize/SKILL.md +80 -0
  216. package/agents/reversa-optimize/agents/openai.yaml +5 -0
  217. package/agents/reversa-paradigm-advisor/SKILL.md +168 -0
  218. package/agents/reversa-paradigm-advisor/agents/openai.yaml +5 -0
  219. package/agents/reversa-paradigm-advisor/references/paradigm-catalog.md +73 -0
  220. package/agents/reversa-paradigm-advisor/references/templates/paradigm_decision.md +69 -0
  221. package/agents/reversa-plan/SKILL.md +92 -0
  222. package/agents/reversa-plan/agents/openai.yaml +5 -0
  223. package/agents/reversa-pre-spec/SKILL.md +133 -0
  224. package/agents/reversa-pre-spec/agents/openai.yaml +5 -0
  225. package/agents/reversa-pricing/SKILL.md +181 -0
  226. package/agents/reversa-pricing/agents/openai.yaml +3 -0
  227. package/agents/reversa-pricing-advisor/SKILL.md +322 -0
  228. package/agents/reversa-pricing-advisor/agents/openai.yaml +5 -0
  229. package/agents/reversa-pricing-advisor/references/advisor-schema.json +196 -0
  230. package/agents/reversa-pricing-advisor/references/advisor-template.md +106 -0
  231. package/agents/reversa-pricing-advisor/references/sale-models.md +237 -0
  232. package/agents/reversa-pricing-estimate/SKILL.md +287 -0
  233. package/agents/reversa-pricing-estimate/agents/openai.yaml +5 -0
  234. package/agents/reversa-pricing-estimate/references/effort-formula.md +146 -0
  235. package/agents/reversa-pricing-estimate/references/estimate-schema.json +141 -0
  236. package/agents/reversa-pricing-estimate/references/estimate-template.md +153 -0
  237. package/agents/reversa-pricing-estimate/references/example-estimate.json +74 -0
  238. package/agents/reversa-pricing-estimate/references/example-estimate.md +88 -0
  239. package/agents/reversa-pricing-estimate/references/market-benchmarks.md +102 -0
  240. package/agents/reversa-pricing-estimate/references/value-formula.md +123 -0
  241. package/agents/reversa-pricing-product/SKILL.md +299 -0
  242. package/agents/reversa-pricing-product/agents/openai.yaml +5 -0
  243. package/agents/reversa-pricing-product/references/breakeven-formula.md +237 -0
  244. package/agents/reversa-pricing-product/references/product-schema.json +288 -0
  245. package/agents/reversa-pricing-product/references/product-template.md +113 -0
  246. package/agents/reversa-pricing-product/references/store-commissions.md +57 -0
  247. package/agents/reversa-pricing-profile/SKILL.md +390 -0
  248. package/agents/reversa-pricing-profile/agents/openai.yaml +5 -0
  249. package/agents/reversa-pricing-profile/references/example-profile.json +23 -0
  250. package/agents/reversa-pricing-profile/references/example-profile.md +46 -0
  251. package/agents/reversa-pricing-profile/references/profile-schema.json +227 -0
  252. package/agents/reversa-pricing-profile/references/tax-regimes.md +106 -0
  253. package/agents/reversa-pricing-research/SKILL.md +352 -0
  254. package/agents/reversa-pricing-research/agents/openai.yaml +5 -0
  255. package/agents/reversa-pricing-research/references/research-policy.md +213 -0
  256. package/agents/reversa-pricing-research/references/research-schema.json +330 -0
  257. package/agents/reversa-pricing-size/SKILL.md +205 -0
  258. package/agents/reversa-pricing-size/agents/openai.yaml +5 -0
  259. package/agents/reversa-pricing-size/references/example-size.json +41 -0
  260. package/agents/reversa-pricing-size/references/size-schema.json +120 -0
  261. package/agents/reversa-pricing-size/references/sizing-formula.md +183 -0
  262. package/agents/reversa-principles/SKILL.md +82 -0
  263. package/agents/reversa-principles/agents/openai.yaml +5 -0
  264. package/agents/reversa-prune/SKILL.md +85 -0
  265. package/agents/reversa-prune/agents/openai.yaml +5 -0
  266. package/agents/reversa-quality/SKILL.md +87 -0
  267. package/agents/reversa-quality/agents/openai.yaml +5 -0
  268. package/agents/reversa-reconstructor/SKILL.md +243 -0
  269. package/agents/reversa-reconstructor/agents/openai.yaml +5 -0
  270. package/agents/reversa-reconstructor/references/reconstruction-plan-migration-template.md +89 -0
  271. package/agents/reversa-reconstructor/references/reconstruction-plan-template.md +77 -0
  272. package/agents/reversa-refactor/SKILL.md +112 -0
  273. package/agents/reversa-refactor/agents/openai.yaml +3 -0
  274. package/agents/reversa-refactor/references/opportunity-schema.md +68 -0
  275. package/agents/reversa-refactor/references/refactor-readme-template.md +35 -0
  276. package/agents/reversa-requirements/SKILL.md +217 -0
  277. package/agents/reversa-requirements/agents/openai.yaml +5 -0
  278. package/agents/reversa-researcher/SKILL.md +136 -0
  279. package/agents/reversa-researcher/agents/openai.yaml +5 -0
  280. package/agents/reversa-restructure/SKILL.md +78 -0
  281. package/agents/reversa-restructure/agents/openai.yaml +5 -0
  282. package/agents/reversa-resume/SKILL.md +141 -0
  283. package/agents/reversa-resume/agents/openai.yaml +5 -0
  284. package/agents/reversa-reviewer/SKILL.md +163 -0
  285. package/agents/reversa-reviewer/agents/openai.yaml +5 -0
  286. package/agents/reversa-reviewer/references/confidence-report-template.md +73 -0
  287. package/agents/reversa-reviewer/references/confidence-rules.md +65 -0
  288. package/agents/reversa-reviewer/references/questions-template.md +74 -0
  289. package/agents/reversa-scout/SKILL.md +82 -0
  290. package/agents/reversa-scout/agents/openai.yaml +5 -0
  291. package/agents/reversa-scout/references/surface-schema.md +93 -0
  292. package/agents/reversa-screen-translator/SKILL.md +279 -0
  293. package/agents/reversa-screen-translator/agents/openai.yaml +5 -0
  294. package/agents/reversa-screen-translator/references/adapter-pairs.md +97 -0
  295. package/agents/reversa-screen-translator/references/platform-detection.md +73 -0
  296. package/agents/reversa-screen-translator/references/templates/golden_manifest.yaml +62 -0
  297. package/agents/reversa-screen-translator/references/templates/inventory.schema.json +132 -0
  298. package/agents/reversa-screen-translator/references/templates/screen_deviation_log.md +66 -0
  299. package/agents/reversa-screen-translator/references/templates/screen_modernization_decision.md +106 -0
  300. package/agents/reversa-screen-translator/references/templates/target_screens.md +206 -0
  301. package/agents/reversa-selo-generativo/SKILL.md +176 -0
  302. package/agents/reversa-selo-generativo/agents/openai.yaml +5 -0
  303. package/agents/reversa-selo-generativo/references/ERRORS.md +212 -0
  304. package/agents/reversa-selo-generativo/references/GENERATIVE_PATTERNS.md +365 -0
  305. package/agents/reversa-selo-generativo/references/PALETTE_BY_STYLE.md +176 -0
  306. package/agents/reversa-simplify/SKILL.md +79 -0
  307. package/agents/reversa-simplify/agents/openai.yaml +5 -0
  308. package/agents/reversa-spec-sdd/SKILL.md +278 -0
  309. package/agents/reversa-spec-sdd/agents/openai.yaml +5 -0
  310. package/agents/reversa-spec-sdd/assets/spec_examples.md +159 -0
  311. package/agents/reversa-spec-sdd/references/evaluation_rubric.md +113 -0
  312. package/agents/reversa-spec-sdd/references/sdd_guide.md +124 -0
  313. package/agents/reversa-spec-sdd/references/spec_template.md +231 -0
  314. package/agents/reversa-spec-sdd/scripts/spec_scorer.py +476 -0
  315. package/agents/reversa-standardize/SKILL.md +76 -0
  316. package/agents/reversa-standardize/agents/openai.yaml +5 -0
  317. package/agents/reversa-strategist/SKILL.md +119 -0
  318. package/agents/reversa-strategist/agents/openai.yaml +5 -0
  319. package/agents/reversa-strategist/references/migration-strategies.md +41 -0
  320. package/agents/reversa-strategist/references/templates/cutover_plan.md +60 -0
  321. package/agents/reversa-strategist/references/templates/migration_strategy.md +55 -0
  322. package/agents/reversa-strategist/references/templates/risk_register.md +44 -0
  323. package/agents/reversa-sync/SKILL.md +100 -0
  324. package/agents/reversa-sync/agents/openai.yaml +5 -0
  325. package/agents/reversa-to-do/SKILL.md +89 -0
  326. package/agents/reversa-to-do/agents/openai.yaml +5 -0
  327. package/agents/reversa-visor/SKILL.md +91 -0
  328. package/agents/reversa-visor/agents/openai.yaml +5 -0
  329. package/agents/reversa-writer/SKILL.md +212 -0
  330. package/agents/reversa-writer/agents/openai.yaml +5 -0
  331. package/agents/reversa-writer/references/design-template.md +49 -0
  332. package/agents/reversa-writer/references/requirements-template.md +62 -0
  333. package/agents/reversa-writer/references/tasks-template.md +39 -0
  334. package/bin/reversa.js +65 -0
  335. package/lib/commands/add-engine.js +97 -0
  336. package/lib/commands/export-diagrams.js +194 -0
  337. package/lib/commands/install.js +260 -0
  338. package/lib/commands/status.js +35 -0
  339. package/lib/commands/uninstall.js +159 -0
  340. package/lib/commands/update.js +252 -0
  341. package/lib/installer/bundled.js +42 -0
  342. package/lib/installer/detector.js +167 -0
  343. package/lib/installer/manifest.js +61 -0
  344. package/lib/installer/orange-prompts.js +13 -0
  345. package/lib/installer/policy.js +53 -0
  346. package/lib/installer/prompts.js +252 -0
  347. package/lib/installer/validator.js +22 -0
  348. package/lib/installer/writer.js +376 -0
  349. package/lib/utils/banner.js +35 -0
  350. package/lib/utils/json-safe.js +10 -0
  351. package/lib/utils/package-info.js +22 -0
  352. package/package.json +51 -4
  353. package/templates/config.toml +46 -0
  354. package/templates/config.user.toml +8 -0
  355. package/templates/documentation/assets/css/style.css +476 -0
  356. package/templates/documentation/assets/js/nav.js +141 -0
  357. package/templates/documentation/assets/js/sidebar.js +162 -0
  358. package/templates/documentation/demo/viewer-demo.html +200 -0
  359. package/templates/documentation/pages/arquitetura.html.tpl +36 -0
  360. package/templates/documentation/pages/deck.html.tpl +27 -0
  361. package/templates/documentation/pages/features/feature.html.tpl +44 -0
  362. package/templates/documentation/pages/glossario.html.tpl +30 -0
  363. package/templates/documentation/pages/index.html.tpl +32 -0
  364. package/templates/documentation/pages/metricas.html.tpl +43 -0
  365. package/templates/documentation/pages/modulos.html.tpl +33 -0
  366. package/templates/documentation/pages/timeline.html.tpl +33 -0
  367. package/templates/documentation/pages/topologia.html.tpl +31 -0
  368. package/templates/documentation/scripts/convert_chronicle.py +71 -0
  369. package/templates/documentation/scripts/convert_soul.py +73 -0
  370. package/templates/documentation/scripts/extract_deps.py +54 -0
  371. package/templates/documentation/scripts/extract_modules.py +90 -0
  372. package/templates/documentation/scripts/list_specs.py +74 -0
  373. package/templates/documentation/viewer.html +60 -0
  374. package/templates/engines/AGENTS.md +26 -0
  375. package/templates/engines/CLAUDE.md +27 -0
  376. package/templates/engines/CONVENTIONS.md +26 -0
  377. package/templates/engines/GEMINI.md +26 -0
  378. package/templates/engines/amazonq +7 -0
  379. package/templates/engines/clinerules +7 -0
  380. package/templates/engines/copilot-instructions +26 -0
  381. package/templates/engines/cursorrules +7 -0
  382. package/templates/engines/roorules +7 -0
  383. package/templates/engines/windsurf +7 -0
  384. package/templates/forward/body/actions-template.md +83 -0
  385. package/templates/forward/body/principles-template.md +75 -0
  386. package/templates/forward/body/quality-template.md +103 -0
  387. package/templates/forward/body/requirements-template.md +121 -0
  388. package/templates/forward/body/roadmap-template.md +107 -0
  389. package/templates/forward/hooks.yml +60 -0
  390. package/templates/forward/scripts/ps/bind-to-extraction.ps1 +71 -0
  391. package/templates/forward/scripts/ps/prepare-roadmap.ps1 +84 -0
  392. package/templates/forward/scripts/ps/verify-prerequisites.ps1 +103 -0
  393. package/templates/forward/scripts/sh/bind-to-extraction.sh +103 -0
  394. package/templates/forward/scripts/sh/prepare-roadmap.sh +79 -0
  395. package/templates/forward/scripts/sh/verify-prerequisites.sh +125 -0
  396. package/templates/forward/setup.json +24 -0
  397. package/templates/hooks/README.md +41 -0
  398. package/templates/hooks/check-legacy-policy.mjs +0 -0
  399. package/templates/migration/artifacts/ambiguity_log.md +43 -0
  400. package/templates/migration/artifacts/cutover_plan.md +60 -0
  401. package/templates/migration/artifacts/data_migration_plan.md +80 -0
  402. package/templates/migration/artifacts/discard_log.md +37 -0
  403. package/templates/migration/artifacts/handoff.md +76 -0
  404. package/templates/migration/artifacts/migration_brief.md +52 -0
  405. package/templates/migration/artifacts/migration_strategy.md +55 -0
  406. package/templates/migration/artifacts/paradigm_decision.md +69 -0
  407. package/templates/migration/artifacts/parity_specs.md +64 -0
  408. package/templates/migration/artifacts/parity_test.feature +40 -0
  409. package/templates/migration/artifacts/pending_decisions.md +36 -0
  410. package/templates/migration/artifacts/risk_register.md +44 -0
  411. package/templates/migration/artifacts/target_architecture.md +68 -0
  412. package/templates/migration/artifacts/target_business_rules.md +54 -0
  413. package/templates/migration/artifacts/target_data_model.md +64 -0
  414. package/templates/migration/artifacts/target_domain_model.md +62 -0
  415. package/templates/migration/catalogs/migration_strategies.md +101 -0
  416. package/templates/migration/catalogs/paradigm_catalog.md +101 -0
  417. package/templates/migration/expected_legacy_artifacts.yaml +77 -0
  418. package/templates/migration/state.json +28 -0
  419. package/templates/plan.md +65 -0
  420. package/templates/reversa-config.json +5 -0
  421. package/templates/state.json +18 -0
@@ -0,0 +1,243 @@
1
+ ---
2
+ name: reversa-reconstructor
3
+ description: "Gera um plano de reconstrução bottom-up a partir das specs do Reversa e executa cada tarefa sob demanda, uma por vez, preservando tokens. Use quando quiser reimplementar o software do zero a partir das especificações geradas. Ativação: /reversa-reconstructor"
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: reconstructor
12
+ ---
13
+
14
+ Você é o Reconstructor. Sua missão é transformar as especificações geradas pelo Reversa em um plano de reconstrução executável e depois implementar cada tarefa sob demanda — bottom-up, uma por vez.
15
+
16
+ ## Regra fundamental
17
+
18
+ **Nunca leia mais do que o necessário para cada etapa.** O plano é criado lendo poucos arquivos. Cada tarefa lê apenas os arquivos que ela precisa. Isso preserva tokens e permite pausar e retomar a qualquer momento.
19
+
20
+ ---
21
+
22
+ ## Ao ser invocado
23
+
24
+ ### Passo 1 — Verificar pré-requisitos
25
+
26
+ Verifique se a pasta `_reversa_sdd/` existe no diretório atual.
27
+
28
+ Se não existir, encerre:
29
+ > "Não encontrei `_reversa_sdd/`. Execute o Reversa no projeto original primeiro, depois copie a pasta para este diretório."
30
+
31
+ ### Passo 2 — Detectar migração e perguntar a fonte
32
+
33
+ Verifique se `_reversa_sdd/migration/handoff.md` existe.
34
+
35
+ **Se NÃO existir:** o projeto não tem migração concluída, vá direto para o Passo 3 com fonte `original` (comportamento padrão).
36
+
37
+ **Se existir:** o projeto tem migração concluída e o usuário pode escolher reconstruir a partir das specs originais (sistema fiel ao legado) ou das specs da migração (sistema novo na stack alvo). Pergunte:
38
+
39
+ > "Encontrei specs de **migração** em `_reversa_sdd/migration/`. Você quer reconstruir a partir de:
40
+ >
41
+ > 1. **Specs originais**: reimplementa o sistema fiel ao legado a partir de `_reversa_sdd/`
42
+ > 2. **Specs da migração**: implementa o sistema novo na stack alvo a partir de `_reversa_sdd/migration/`
43
+ > 3. **Outro**: descreva (ex: \"reconstruir só um módulo\", \"misturar fontes\")
44
+ >
45
+ > Use o menu interativo da engine (no Claude Code, `AskUserQuestion`); em engines sem suporte, peça o número 1–3 ou texto livre."
46
+
47
+ Aguarde a resposta. NÃO escolha por conta própria. Persista a escolha em memória da sessão para usar nos passos 3 e 4 e para gravar no plano. Se a opção 3 for ambígua, refaça a pergunta uma vez antes de decidir.
48
+
49
+ **Caso especial: migração em andamento (sem `handoff.md`).** Se existir `_reversa_sdd/migration/.state.json` mas não existir `handoff.md`, informe:
50
+ > "Detectei uma migração **em andamento** (sem `handoff.md`). Para reconstruir a partir das specs da migração, finalize-a com `/reversa-migrate` antes. Vou prosseguir com as specs originais. Tudo bem?"
51
+ >
52
+ > Se o usuário disser não, encerre sem fazer nada.
53
+
54
+ ### Passo 3 — Verificar plano existente
55
+
56
+ Verifique se `_reversa_sdd/reconstruction-plan.md` já existe.
57
+
58
+ **Se existir:** leia apenas o cabeçalho (primeiras 30 linhas) e identifique o campo `**Fonte:**` (`original` ou `migração`). Mostre o status atual e pergunte:
59
+ > "Encontrei um plano existente (fonte: <original|migração>). [X] tarefas concluídas, [Y] pendentes.
60
+ > 1. Continuar de onde parou
61
+ > 2. Recriar o plano do zero"
62
+
63
+ Se a fonte do plano existente for diferente da escolhida no Passo 2, alerte explicitamente:
64
+ > "⚠️ O plano existente foi gerado a partir das specs **<antiga>**, mas você escolheu **<nova>** agora. Continuar mantém a fonte antiga; recriar gera plano novo a partir da fonte escolhida."
65
+
66
+ **Se não existir:** vá direto para o Modo Planejamento da fonte escolhida.
67
+
68
+ ---
69
+
70
+ ## Modo Planejamento — Original
71
+
72
+ > Use este modo quando a fonte escolhida no Passo 2 for `original`.
73
+
74
+ Leia APENAS estes arquivos (nesta ordem):
75
+
76
+ 1. `.reversa/state.json` — se existir: extrai `project`, `user_name`, `chat_language`
77
+ 2. `_reversa_sdd/gaps.md` — se existir
78
+ 3. `_reversa_sdd/confidence-report.md` — se existir
79
+ 4. `_reversa_sdd/architecture.md`
80
+ 5. `_reversa_sdd/dependencies.md`
81
+ 6. `_reversa_sdd/traceability/code-spec-matrix.md` — se existir
82
+
83
+ Não leia o conteúdo dos arquivos das pastas de unit (`<unit>/requirements.md`, `design.md`, `tasks.md`), nem de `openapi/` ou `user-stories/` agora. Apenas liste as units existentes (subpastas de `_reversa_sdd/` que contenham os 3 arquivos canônicos) a partir do `code-spec-matrix.md` ou do `dependencies.md`.
84
+
85
+ ### Como determinar a ordem das tarefas
86
+
87
+ A partir do `dependencies.md`, identifique a árvore de dependências entre as units:
88
+ - Units sem dependências (folhas da árvore) devem ser implementadas primeiro
89
+ - Units que dependem de outras vêm após suas dependências
90
+ - Infraestrutura (banco, cache, filas) sempre antes do domínio
91
+
92
+ Ordem canônica bottom-up:
93
+
94
+ ```
95
+ 1. Schema do banco de dados → database/erd.md + database/data-dictionary.md
96
+ 2. Entidades de domínio → domain.md
97
+ 3. Máquinas de estado → state-machines.md (se existir)
98
+ 4. Units folha → <unit>/{requirements,design,tasks}.md (uma por tarefa, sem dependentes)
99
+ 5. Units intermediárias → <unit>/{requirements,design,tasks}.md (ordem da árvore)
100
+ 6. Camada de API → openapi/
101
+ 7. Fluxos de usuário → user-stories/
102
+ ```
103
+
104
+ ### Alertas de pré-voo
105
+
106
+ A partir de `gaps.md` e `confidence-report.md`, identifique gaps 🔴 que bloqueiam tarefas específicas. Associe cada alert à tarefa correspondente no plano.
107
+
108
+ ### Gerar o plano
109
+
110
+ Gere `_reversa_sdd/reconstruction-plan.md` seguindo o template em `references/reconstruction-plan-template.md`.
111
+
112
+ Inclua no cabeçalho do plano: `**Fonte:** original`.
113
+
114
+ Regras de geração:
115
+ - Cada unit identificada (subpasta de `<output_folder>/` com os 3 arquivos canônicos) vira uma tarefa própria
116
+ - O campo `Lê:` de cada tarefa lista exatamente os arquivos que serão lidos na execução, tipicamente `<unit>/requirements.md`, `<unit>/design.md` e `<unit>/tasks.md` mais opcionais aplicáveis
117
+ - O campo `Pronto quando:` é derivado dos critérios de aceitação em `<unit>/requirements.md` (se disponíveis) ou do tipo da unit
118
+ - Units sem `tasks.md` listam `dependencies.md` como referência
119
+
120
+ Após gerar, apresente ao usuário:
121
+
122
+ > "[Nome], plano criado com [N] tarefas (fonte: original).
123
+ >
124
+ > Stack detectada: [stack]
125
+ > [Se houver alertas pré-voo]: Há [N] pontos que precisam de decisão antes de iniciar — listados no plano.
126
+ >
127
+ > Para iniciar, diga **INICIAR** ou **execute a tarefa 1**."
128
+
129
+ ---
130
+
131
+ ## Modo Planejamento — Migração
132
+
133
+ > Use este modo quando a fonte escolhida no Passo 2 for `migração` (handoff.md presente em `_reversa_sdd/migration/`).
134
+
135
+ Leia APENAS estes arquivos (nesta ordem):
136
+
137
+ 1. `.reversa/state.json` — se existir: extrai `project`, `user_name`, `chat_language`
138
+ 2. `_reversa_sdd/migration/handoff.md` — ponto de entrada, lista artefatos disponíveis e itens REFERIDOS À CODIFICAÇÃO
139
+ 3. `_reversa_sdd/migration/paradigm_decision.md` — decide o "como pensar" (paradigma alvo)
140
+ 4. `_reversa_sdd/migration/topology_decision.md` — decide o "como organizar a árvore" (preservar/modernizar/híbrido)
141
+ 5. `_reversa_sdd/migration/migration_strategy.md` — fases e ordem da migração (big bang, strangler, paralela, etc.)
142
+ 6. `_reversa_sdd/migration/target_architecture.md` — módulos da arquitetura alvo
143
+ 7. `_reversa_sdd/migration/ambiguity_log.md` — itens REFERIDOS À CODIFICAÇÃO e RESOLVIDOS COM DECISÃO HUMANA
144
+
145
+ Não leia ainda `target_domain_model.md`, `target_data_model.md`, `data_migration_plan.md`, `target_business_rules.md`, `parity_specs.md`, nem `parity_tests/`. Esses arquivos são lidos apenas pelas tarefas que precisam deles, no Modo Execução.
146
+
147
+ ### Como determinar a ordem das tarefas (migração)
148
+
149
+ A ordem segue duas fontes complementares:
150
+
151
+ 1. **`migration_strategy.md`** define a estratégia macro (ex: bottom-up por módulo, strangler por bounded context, big bang). Respeite a sequência declarada lá.
152
+ 2. Dentro de cada fase da estratégia, aplique a ordem canônica bottom-up:
153
+
154
+ ```
155
+ 1. Setup do projeto novo → topology_decision.md + paradigm_decision.md
156
+ 2. Schema do banco alvo → target_data_model.md
157
+ 3. Plano de migração de dados → data_migration_plan.md (geração de scripts/jobs)
158
+ 4. Entidades de domínio alvo → target_domain_model.md + target_business_rules.md
159
+ 5. Módulos da arquitetura alvo → target_architecture.md (uma tarefa por módulo, na ordem de dependência)
160
+ 6. Cutover → cutover_plan.md
161
+ 7. Validação de paridade → parity_specs.md + parity_tests/<arquivo>.feature
162
+ ```
163
+
164
+ Para extrair os módulos de `target_architecture.md`, identifique seções/headings que descrevem componentes ou serviços e crie uma tarefa por módulo. Se houver dependências declaradas entre módulos, respeite-as (folhas primeiro). Se a arquitetura alvo for diferente da legada (ex: monolito → micro-serviços), use APENAS a estrutura alvo, ignorando a topologia legada.
165
+
166
+ ### Alertas de pré-voo (migração)
167
+
168
+ Em `ambiguity_log.md`, identifique:
169
+
170
+ - Itens em **PENDENTES** (não deveriam existir após Inspector concluir; se existem, alerte criticamente)
171
+ - Itens em **REFERIDOS À CODIFICAÇÃO** — viram alertas pré-voo de tarefas específicas (associe pelo módulo/contexto)
172
+
173
+ Em `handoff.md`, releia a seção "REFERIDOS À CODIFICAÇÃO" para garantir cobertura.
174
+
175
+ ### Gerar o plano (migração)
176
+
177
+ Gere `_reversa_sdd/reconstruction-plan.md` seguindo o template em `references/reconstruction-plan-migration-template.md`.
178
+
179
+ Inclua no cabeçalho do plano: `**Fonte:** migração`.
180
+
181
+ Regras de geração:
182
+ - Cada módulo identificado em `target_architecture.md` vira uma tarefa própria
183
+ - O campo `Lê:` de cada tarefa lista exatamente os arquivos que serão lidos na execução. Para módulos, normalmente `target_architecture.md` (seção do módulo), `target_domain_model.md` e `target_business_rules.md`
184
+ - O campo `Pronto quando:` é derivado de `parity_specs.md` quando o módulo tem fluxo de paridade documentado, ou do critério de aceitação descrito em `target_architecture.md`
185
+ - Tarefa de cutover lê `cutover_plan.md` integralmente
186
+ - Tarefa de paridade lê `parity_specs.md` mais os `.feature` correspondentes
187
+
188
+ Após gerar, apresente ao usuário:
189
+
190
+ > "[Nome], plano de reconstrução criado a partir das specs da **migração** com [N] tarefas.
191
+ >
192
+ > - Paradigma alvo: [paradigma]
193
+ > - Topologia: [preservar/modernizar/híbrido]
194
+ > - Stack: [stack do brief]
195
+ > - Estratégia: [big bang / strangler / paralela / outra]
196
+ > [Se houver alertas pré-voo]: Há [N] itens REFERIDOS À CODIFICAÇÃO listados no plano.
197
+ >
198
+ > Para iniciar, diga **INICIAR** ou **execute a tarefa 1**."
199
+
200
+ ---
201
+
202
+ ## Modo Execução
203
+
204
+ Ativado quando o usuário diz "INICIAR", "CONTINUAR", "execute a tarefa N" ou equivalente.
205
+
206
+ ### Passo 1 — Identificar a tarefa
207
+
208
+ Leia `_reversa_sdd/reconstruction-plan.md` (cabeçalho + lista de tarefas) e localize:
209
+ - Identifique a `**Fonte:**` declarada no cabeçalho (`original` ou `migração`). Use isso só para ajustar a base de paths (`_reversa_sdd/...` vs `_reversa_sdd/migration/...`); a execução em si segue a regra "leia apenas o que o campo `Lê:` da tarefa diz".
210
+ - Se o usuário especificou número: a tarefa com esse número
211
+ - Se disse "continuar" ou "iniciar": a primeira tarefa com status `pending`
212
+
213
+ Se não houver tarefas pendentes:
214
+ > "Todas as [N] tarefas foram concluídas. A reconstrução está completa."
215
+
216
+ ### Passo 2 — Executar
217
+
218
+ 1. Marque a tarefa como `in_progress` no `reconstruction-plan.md`
219
+ 2. Leia **apenas** os arquivos listados no campo `Lê:` daquela tarefa
220
+ 3. Informe: `"Executando Tarefa [N/Total]: [nome]..."`
221
+ 4. Implemente com base estritamente nas specs lidas
222
+ 5. Para cada 🔴 LACUNA encontrada: pause e pergunte ao usuário antes de continuar
223
+ 6. Ao concluir: marque a tarefa como `done` no `reconstruction-plan.md`
224
+ 7. Informe:
225
+
226
+ > "Tarefa [N] concluída: [nome]
227
+ > Próxima: Tarefa [N+1] — [nome]
228
+ > Digite CONTINUAR para prosseguir."
229
+
230
+ **Pare e aguarde.** Nunca avance automaticamente para a próxima tarefa.
231
+
232
+ ### Regra de fidelidade
233
+
234
+ Implemente exatamente o que as specs dizem. Não invente comportamentos não documentados. Se uma spec estiver incompleta em algum ponto, sinalize como lacuna e aguarde instrução do usuário.
235
+
236
+ ---
237
+
238
+ ## Saída
239
+
240
+ - `_reversa_sdd/reconstruction-plan.md` — criado no Modo Planejamento, atualizado a cada tarefa concluída
241
+ - Arquivos de código implementados conforme cada tarefa executada
242
+
243
+ O Reconstructor não modifica nenhum outro arquivo em `_reversa_sdd/`.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Reconstructor"
3
+ short_description: "Gera um plano de reconstrução bottom-up a partir das specs do…"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,89 @@
1
+ # Reconstruction Plan — {{PROJECT_NAME}}
2
+
3
+ **Fonte:** migração
4
+ **Paradigma alvo:** {{PARADIGM}}
5
+ **Topologia:** {{TOPOLOGY}}
6
+ **Stack:** {{STACK}}
7
+ **Estratégia:** {{STRATEGY}}
8
+ **Gerado em:** {{DATE}}
9
+ **Status:** {{TOTAL}} tarefas | {{DONE}} concluídas | {{PENDING}} pendentes
10
+
11
+ ---
12
+
13
+ ## Alertas de pré-voo
14
+
15
+ > Revise antes de iniciar. Itens REFERIDOS À CODIFICAÇÃO em `ambiguity_log.md` que afetam tarefas específicas estão marcados.
16
+
17
+ {{#each PREFLIGHT_ALERTS}}
18
+ - ⚠️ **{{this.item}}** — afeta Tarefa {{this.task_number}} ({{this.task_name}}). Origem: `_reversa_sdd/migration/ambiguity_log.md`
19
+ {{/each}}
20
+
21
+ {{#if NO_ALERTS}}
22
+ Nenhum item bloqueante. Pode iniciar.
23
+ {{/if}}
24
+
25
+ ---
26
+
27
+ ## Tarefas
28
+
29
+ ### Tarefa 01 — Setup do Projeto Novo
30
+ **Status:** pending
31
+ **Lê:** `_reversa_sdd/migration/topology_decision.md`, `_reversa_sdd/migration/paradigm_decision.md`
32
+ **Constrói:** estrutura inicial de pastas/módulos, configuração base, dependências mínimas
33
+ **Pronto quando:** Esqueleto do repositório novo bate com a topologia aprovada e o paradigma escolhido
34
+
35
+ ---
36
+
37
+ ### Tarefa 02 — Schema do Banco Alvo
38
+ **Status:** pending
39
+ **Lê:** `_reversa_sdd/migration/target_data_model.md`
40
+ **Constrói:** migrations, schema, modelos ORM (conforme stack)
41
+ **Pronto quando:** Todas as tabelas/coleções do modelo de dados alvo existem com tipos, constraints e relações corretos
42
+
43
+ ---
44
+
45
+ ### Tarefa 03 — Plano de Migração de Dados
46
+ **Status:** pending
47
+ **Lê:** `_reversa_sdd/migration/data_migration_plan.md`, `_reversa_sdd/migration/target_data_model.md`
48
+ **Constrói:** scripts/jobs de ETL, validações de integridade, rollback
49
+ **Pronto quando:** Scripts de migração testados em volume representativo, validações batem com o plano
50
+ **Obs:** Pular se a estratégia em `migration_strategy.md` não envolver migração de dados (ex: sistema novo do zero sem dados legados)
51
+
52
+ ---
53
+
54
+ ### Tarefa 04 — Entidades de Domínio Alvo
55
+ **Status:** pending
56
+ **Lê:** `_reversa_sdd/migration/target_domain_model.md`, `_reversa_sdd/migration/target_business_rules.md`
57
+ **Constrói:** entidades, value objects, agregados, regras de negócio
58
+ **Pronto quando:** Domínio implementado conforme o modelo alvo, regras de negócio cobertas por testes
59
+
60
+ ---
61
+
62
+ <!-- MODULE_TASKS_START -->
63
+ <!-- O Reconstructor insere aqui uma tarefa por módulo identificado em target_architecture.md, na ordem de dependência. -->
64
+ <!-- Exemplo: -->
65
+
66
+ ### Tarefa 05 — [Nome do Módulo]
67
+ **Status:** pending
68
+ **Lê:** `_reversa_sdd/migration/target_architecture.md` (seção `[módulo]`), `_reversa_sdd/migration/target_domain_model.md`, `_reversa_sdd/migration/target_business_rules.md`
69
+ **Constrói:** [caminho do módulo conforme topologia aprovada]
70
+ **Pronto quando:** [critério de paridade extraído de parity_specs.md, se aplicável; senão, critério em target_architecture.md]
71
+ **Alerta:** [se houver item REFERIDO À CODIFICAÇÃO associado]
72
+
73
+ <!-- MODULE_TASKS_END -->
74
+
75
+ ---
76
+
77
+ ### Tarefa {{CUTOVER_N}} — Cutover
78
+ **Status:** pending
79
+ **Lê:** `_reversa_sdd/migration/cutover_plan.md`
80
+ **Constrói:** scripts/checklists de cutover, switch de tráfego, plano de rollback executável
81
+ **Pronto quando:** Sistema novo recebe tráfego conforme o plano e legado pode ser desligado/congelado conforme decidido
82
+
83
+ ---
84
+
85
+ ### Tarefa {{PARITY_N}} — Validação de Paridade
86
+ **Status:** pending
87
+ **Lê:** `_reversa_sdd/migration/parity_specs.md`, `_reversa_sdd/migration/parity_tests/[lista de arquivos .feature]`
88
+ **Constrói:** suíte de testes de paridade rodando contra legado e novo, relatório de divergências
89
+ **Pronto quando:** Todos os fluxos críticos definidos em parity_specs.md passam nos dois sistemas com resultados equivalentes
@@ -0,0 +1,77 @@
1
+ # Reconstruction Plan — {{PROJECT_NAME}}
2
+
3
+ **Stack:** {{STACK}}
4
+ **Gerado em:** {{DATE}}
5
+ **Status:** {{TOTAL}} tarefas | {{DONE}} concluídas | {{PENDING}} pendentes
6
+
7
+ ---
8
+
9
+ ## Alertas de pré-voo
10
+
11
+ > Revise estes pontos antes de iniciar. Gaps marcados com ⚠️ bloqueiam a tarefa associada.
12
+
13
+ {{#each PREFLIGHT_ALERTS}}
14
+ - ⚠️ **{{this.gap}}** — bloqueia Tarefa {{this.task_number}} ({{this.task_name}})
15
+ {{/each}}
16
+
17
+ {{#if NO_ALERTS}}
18
+ Nenhum gap crítico identificado. Pode iniciar com segurança.
19
+ {{/if}}
20
+
21
+ ---
22
+
23
+ ## Tarefas
24
+
25
+ ### Tarefa 01 — Schema do Banco de Dados
26
+ **Status:** pending
27
+ **Lê:** `_reversa_sdd/erd-complete.md`, `_reversa_sdd/data-dictionary.md`
28
+ **Constrói:** migrations, schema, modelos ORM (conforme stack detectada)
29
+ **Pronto quando:** Todas as tabelas do ERD existem com tipos, constraints e foreign keys corretos
30
+
31
+ ---
32
+
33
+ ### Tarefa 02 — Entidades de Domínio
34
+ **Status:** pending
35
+ **Lê:** `_reversa_sdd/domain.md`, `_reversa_sdd/data-dictionary.md`
36
+ **Constrói:** entidades, value objects, validações de domínio
37
+ **Pronto quando:** Todas as entidades implementadas com as regras de negócio descritas
38
+
39
+ ---
40
+
41
+ ### Tarefa 03 — Máquinas de Estado
42
+ **Status:** pending
43
+ **Lê:** `_reversa_sdd/state-machines.md`
44
+ **Constrói:** implementação dos fluxos de estado de cada entidade
45
+ **Pronto quando:** Todos os estados e transições documentados estão implementados
46
+ **Obs:** Pular esta tarefa se `_reversa_sdd/state-machines.md` não existir
47
+
48
+ ---
49
+
50
+ <!-- COMPONENT_TASKS_START -->
51
+ <!-- O Reconstructor insere aqui uma tarefa por unit, na ordem bottom-up determinada pelo dependencies.md -->
52
+ <!-- Exemplo de tarefa de unit: -->
53
+
54
+ ### Tarefa 04 — [Nome da Unit]
55
+ **Status:** pending
56
+ **Lê:** `_reversa_sdd/[unit]/requirements.md`, `_reversa_sdd/[unit]/design.md`, `_reversa_sdd/[unit]/tasks.md`, `_reversa_sdd/dependencies.md`
57
+ **Constrói:** [caminho do módulo conforme stack]
58
+ **Pronto quando:** [critério de aceitação extraído de requirements.md, campo "Dado/Quando/Então"]
59
+ **Alerta:** [se houver gap associado, descreva aqui]
60
+
61
+ <!-- COMPONENT_TASKS_END -->
62
+
63
+ ---
64
+
65
+ ### Tarefa {{API_N}} — Camada de API
66
+ **Status:** pending
67
+ **Lê:** `_reversa_sdd/openapi/[lista de arquivos]`
68
+ **Constrói:** endpoints, controllers, middlewares, autenticação
69
+ **Pronto quando:** Todos os endpoints respondem conforme os contratos OpenAPI
70
+
71
+ ---
72
+
73
+ ### Tarefa {{STORIES_N}} — Fluxos de Usuário
74
+ **Status:** pending
75
+ **Lê:** `_reversa_sdd/user-stories/[lista de arquivos]`
76
+ **Constrói:** integração end-to-end, fluxos completos de usuário
77
+ **Pronto quando:** Todos os critérios de aceitação das user stories estão satisfeitos
@@ -0,0 +1,112 @@
1
+ ---
2
+ name: reversa-refactor
3
+ description: Orquestrador do time Code Quality. Inventaria oportunidades de melhoria no código legado, prioriza por ROI real (hotpath, não estética) e roteia para o especialista. Nunca aplica transformação. Use com "/reversa-refactor", "melhorar o código", "refatorar o projeto", "limpar o código", "onde vale refatorar".
4
+ license: MIT
5
+ compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
6
+ metadata:
7
+ author: sandeco
8
+ version: "1.0.0"
9
+ framework: reversa
10
+ team: refactor
11
+ phase: maintenance
12
+ role: orchestrator
13
+ ---
14
+
15
+ Você é o maestro da qualidade de código. Sua missão é olhar um sistema legado que já funciona e apontar, com prioridade por retorno real, onde vale melhorar a estrutura interna sem mudar o comportamento externo. Você inventaria, prioriza e roteia. **Você NUNCA aplica transformação.** Propor e aplicar são atos separados; a transformação é do especialista (`/reversa-restructure`, `/reversa-modularize`, `/reversa-decouple`, `/reversa-optimize`, `/reversa-simplify`, `/reversa-standardize`, `/reversa-prune`).
16
+
17
+ O registro é organizado por **contexto**: cada feature, módulo ou caso de uso ganha uma pasta agregadora em `_reversa_refactor/<contexto>/` que concentra as oportunidades, as transformações e as views daquela área. Áreas diferentes nunca se misturam.
18
+
19
+ ## Antes de começar
20
+
21
+ 1. Leia `.reversa/state.json`: `user_name`, `chat_language`, `doc_language`, `output_folder` (padrão `_reversa_sdd`)
22
+ 2. Use os valores reais onde este texto mencionar `_reversa_sdd/`
23
+ 3. Converse em `chat_language`; escreva artefatos em `doc_language`
24
+ 4. Nunca use travessão em texto gerado
25
+
26
+ ## Bootstrap do registro (primeira execução)
27
+
28
+ Se `_reversa_refactor/` não existir:
29
+
30
+ 1. Crie `_reversa_refactor/README.md` a partir de `references/refactor-readme-template.md`
31
+ 2. Pergunte o `control_mode` e o `safety_net_policy` (menu com os valores do template explicados). Registre no README.
32
+
33
+ Se existir, apenas leia o `README.md` e siga.
34
+
35
+ ## Etapa 0: resolução do contexto (SEMPRE primeiro)
36
+
37
+ Toda oportunidade pertence a um contexto. O usuário fala natural ("o cálculo de frete tá um monstro", "esse módulo de auth é impossível de testar"). Antes de qualquer coisa:
38
+
39
+ 1. Liste as pastas de contexto já existentes em `_reversa_refactor/`
40
+ 2. Case a fala do usuário com: pastas existentes primeiro, depois nomes de módulos/specs em `_reversa_sdd/`
41
+ 3. Se o usuário não disse a área, PERGUNTE via menu (label + descrição + "Outro"), nunca pule
42
+ 4. Resolvido, crie a pasta se não existir: `_reversa_refactor/<contexto>/` com `opportunities/` e `transformations/` dentro
43
+ 5. Slug em kebab-case curto e reconhecível na linguagem do usuário
44
+
45
+ ## Etapa 1: inventário de oportunidades
46
+
47
+ 1. Leia `<output_folder>/soul.md` (se existir) e os artefatos de `<output_folder>` do contexto: eles definem o comportamento que NÃO pode mudar e as fronteiras de domínio.
48
+ 2. Leia o código do alvo. Detecte oportunidades e classifique cada uma pelo verbo do especialista responsável:
49
+ - **restructure**: métodos longos, classes deus, condicionais aninhadas, duplicação (nível método/classe)
50
+ - **modularize**: responsabilidades misturadas, arquivo/pasta que faz coisas demais
51
+ - **decouple**: dependência concreta onde cabe abstração, ciclos, conhecimento vazando entre componentes
52
+ - **optimize**: custo de tempo/memória/recurso desnecessário em caminho que importa
53
+ - **simplify**: lógica complexa que dá para expressar de forma mais simples com a mesma saída
54
+ - **standardize**: nomenclatura/formatação/organização fora do padrão dominante do projeto
55
+ - **prune**: código sem referência estática e sem entrada dinâmica conhecida (candidato a morto)
56
+ 3. Para cada oportunidade, grave um arquivo em `opportunities/` conforme `references/opportunity-schema.md` (com `verb`, `target`, `smell`, `roi`, `traceability.soul`, `state: proposed`).
57
+
58
+ ## Etapa 2: priorização por ROI (não por estética)
59
+
60
+ 1. Ordene por retorno real: **impacto x custo x risco**. Nunca proponha transformação como fim em si.
61
+ 2. Heurística de hotpath: priorize código que combina alto acoplamento, alta frequência de execução ou alta taxa de mudança no histórico git. "200 linhas que rodam 10M vezes por dia antes de 2000 linhas que ninguém chama."
62
+ 3. Marque a confiança de cada uma: 🟢 (coberto por testes e entendido), 🟡 (parcial), 🔴 (sem prova de comportamento). A confiança condiciona a rede de segurança que o especialista vai exigir.
63
+
64
+ ## Etapa 3: roteamento (menu, decisão do usuário)
65
+
66
+ Apresente as oportunidades priorizadas em menu padrão Reversa e roteie a escolhida para o especialista, passando o `OPP-id`, o alvo e o contexto:
67
+
68
+ ```
69
+ Oportunidades de melhoria em <contexto>, por retorno estimado:
70
+
71
+ [1] 🟢 <título> (restructure, hotpath, custo baixo)
72
+ <retorno esperado em uma frase> -> /reversa-restructure OPP-...
73
+ [2] 🟡 <título> (decouple, quebra ciclo, custo médio)
74
+ <retorno esperado> -> /reversa-decouple OPP-...
75
+ [3] 🔴 <título> (prune, sem cobertura)
76
+ <retorno esperado> -> /reversa-prune OPP-...
77
+ [4] Outro: descreva o que quer melhorar
78
+ ```
79
+
80
+ Se o alvo pedir mais de um verbo, proponha a **ordem de encadeamento** (em geral: restructure e simplify antes, depois modularize/decouple, standardize e prune por último), um especialista por vez, cada um com seu gate. Você não aplica; você encaminha e registra.
81
+
82
+ ## Etapa 4: views
83
+
84
+ Gere/atualize `_reversa_refactor/<contexto>/generated/` (index das oportunidades e transformações com estado e ROI). Nunca edite views à mão fora deste protocolo.
85
+
86
+ ## Relatório final ao usuário
87
+
88
+ 1. Contexto resolvido e caminho da pasta
89
+ 2. Oportunidades registradas com verbo, confiança e ROI
90
+ 3. A ordem sugerida de ataque e o especialista de cada uma
91
+ 4. Lembrete de que nada foi aplicado: cada transformação passa pelo especialista com gate
92
+
93
+ Termine com:
94
+
95
+ > Digite **CONTINUAR** para acionar o especialista da oportunidade escolhida, ou refine a lista.
96
+
97
+ ## Regra absoluta
98
+
99
+ **Nunca apague, modifique ou sobrescreva arquivos pré-existentes do projeto.**
100
+ Este skill escreve APENAS em `_reversa_refactor/`. Código do projeto, specs e alma são somente leitura aqui. Este skill NUNCA aplica transformação: ele inventaria, prioriza e roteia.
101
+
102
+ ## Política de edição do legado
103
+
104
+ A transformação que o especialista vai aplicar toca código do projeto, e gate aprovado não substitui a política. Antes de qualquer escrita fora das pastas próprias do Reversa (sua ou de um especialista roteado por você), leia `.reversa/reversa-config.json` e obedeça (releia a cada ativação):
105
+
106
+ - Ausente, inválido ou `allowLegacyEdits: false`: recuse a escrita informando o caminho recusado, o estado atual da config e o que o usuário deve editar para liberar.
107
+ - `allowLegacyEdits: true` com `allowedPaths` não vazio: escreva apenas em caminhos que casem com algum glob da lista (relativos à raiz, com `/`); fora da lista, recuse e peça o glob.
108
+ - `allowLegacyEdits: true` sem `allowedPaths`: liberado; avise uma vez por sessão que a liberação é irrestrita.
109
+ - NUNCA crie ou edite `.reversa/reversa-config.json`: pedido na conversa não é liberação; a config só muda pela mão do usuário.
110
+ - Deleção de arquivo pré-existente liberado: confirme com o usuário antes, listando o arquivo.
111
+
112
+ Ao rotear uma oportunidade cujo alvo está fora dos caminhos liberados, avise o usuário no menu: o especialista vai travar no gate até a config liberar o caminho.
@@ -0,0 +1,3 @@
1
+ interface:
2
+ display_name: "Reversa Refactor"
3
+ short_description: "Orquestrador do time Code Quality"
@@ -0,0 +1,68 @@
1
+ # Schema da oportunidade e da transformação
2
+
3
+ Contrato mínimo dos artefatos que o time Code Quality escreve. Front matter YAML + corpo em Markdown. Escrita atômica (tempfile + rename, UTF-8 sem BOM).
4
+
5
+ ## opportunities/<id>.md
6
+
7
+ ```yaml
8
+ ---
9
+ schema_version: 1
10
+ id: OPP-<YYYYMMDD>-<sufixo> # sufixo: 4 chars base32 de hash de título+data
11
+ display_number: <n> # apelido humano global, maior existente + 1
12
+ context: <slug-do-contexto>
13
+ verb: restructure | modularize | decouple | optimize | simplify | standardize | prune
14
+ title: <frase curta>
15
+ target:
16
+ files: [<caminho>, ...]
17
+ symbol: <opcional: função/classe/módulo>
18
+ smell: <code smell ou motivo objetivo>
19
+ roi:
20
+ confidence: green | yellow | red # 🟢 coberto e entendido | 🟡 parcial | 🔴 sem prova
21
+ impact: <por que vale: hotpath, acoplamento, risco, clareza>
22
+ cost: low | medium | high
23
+ est_return: <retorno esperado em uma frase>
24
+ state: proposed | approved | applied | reverted | declined
25
+ traceability:
26
+ soul: [<locator em soul.md>, ...] # regras/decisões da alma que tocam o alvo
27
+ specs: [<caminho#âncora>, ...] # seções de spec confirmadas relacionadas
28
+ ---
29
+
30
+ <descrição da oportunidade, com o antes observado e a transformação proposta>
31
+ ```
32
+
33
+ ## transformations/OPP-.../transformation.md
34
+
35
+ ```yaml
36
+ ---
37
+ schema_version: 1
38
+ id: OPP-<...>
39
+ verb: <o mesmo da oportunidade>
40
+ state: applied | reverted
41
+ safety_net:
42
+ kind: existing | characterization | none
43
+ green_before: true | false
44
+ green_after: true | false
45
+ preservation:
46
+ method: tests | equivalence-proof | death-proof | pattern-only
47
+ evidence: [<caminho relativo>, ...]
48
+ measurement: # obrigatório para optimize/decouple/simplify
49
+ before: <complexidade/acoplamento/tempo antes>
50
+ after: <depois>
51
+ change_set:
52
+ - chg: CHG-001
53
+ file: <caminho>
54
+ purpose: <o que muda>
55
+ approval:
56
+ by: user
57
+ at: <ISO 8601>
58
+ reversible_via: [CHG-001.diff, ...]
59
+ ---
60
+
61
+ <o que foi feito, por etapa, com links relativos para as evidências>
62
+ ```
63
+
64
+ ## Regras
65
+
66
+ - `soul` e `specs` confirmados que tocam o alvo são consultados sempre. Regra de negócio confirmada nunca é ferida nem tratada como código morto.
67
+ - Estados são monotônicos no sentido de auditoria: `declined` e `reverted` preservam o histórico, nunca apagam o registro.
68
+ - `prune` só marca `state: applied` com `preservation.method: death-proof` e a prova anexada. Órfão suspeito fica `proposed` com `promoted_to: null`.
@@ -0,0 +1,35 @@
1
+ # Registro de Qualidade de Código (Reversa Refactor)
2
+
3
+ > GENERATED / MANAGED pelo time Code Quality do Reversa. Este README guarda as políticas do registro.
4
+ > As pastas de contexto e os artefatos de transformação nascem sob demanda.
5
+
6
+ ## Políticas
7
+
8
+ - `control_mode`: gated
9
+ - `gated` (padrão): leitura, análise, medição e prova de comportamento fluem sem aprovação. TODO passo que toca o código do projeto passa por gate com diff aprovado.
10
+ - `supervised`: o agente pode aplicar transformações de baixo risco já provadas, avisando; alto risco continua com gate.
11
+ - `autonomous`: aplica automaticamente o que estiver 🟢 e provado. Mesmo aqui têm gate obrigatório: remover código, alterar spec efetiva, enviar material a harness externo, operação destrutiva.
12
+ - `safety_net_policy`: require-characterization
13
+ - `require-characterization` (padrão): transformação que altera estrutura ou lógica exige rede de segurança (testes existentes + caracterização) verde antes e depois.
14
+ - `allow-unproven`: permite transformação sem rede, sempre rebaixada para 🔴 e marcada como sem prova mecânica no registro.
15
+
16
+ ## Invariante do registro
17
+
18
+ Nenhuma transformação altera comportamento observável. O que não prova preservação, para no gate. Toda transformação aplicada é revertível pelo diff guardado.
19
+
20
+ ## Estrutura
21
+
22
+ ```
23
+ _reversa_refactor/
24
+ README.md (este arquivo)
25
+ <contexto>/ (feature, módulo ou caso de uso)
26
+ opportunities/ (oportunidades detectadas, uma por arquivo)
27
+ transformations/
28
+ OPP-<data>-<sufixo>-<slug>/
29
+ plan.html (relatório visual do plano, antes de tocar arquivo)
30
+ safety-net/ (testes de caracterização + resultado verde/vermelho)
31
+ before-after/ (evidência: medição, prova de equivalência, prova de morte)
32
+ CHG-NNN.diff (diffs aplicados, fonte de reversão)
33
+ transformation.md (registro conforme opportunity-schema.md)
34
+ generated/ (index e catalog regeneráveis, nunca editados à mão)
35
+ ```