@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,476 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ Spec Scorer — Avalia a qualidade de uma spec de feature
4
+ Baseado na rubrica em references/evaluation_rubric.md
5
+
6
+ Uso:
7
+ python scripts/spec_scorer.py --spec caminho/para/spec.md
8
+ python scripts/spec_scorer.py --spec spec.md --json # saída em JSON
9
+ """
10
+
11
+ import argparse
12
+ import json
13
+ import re
14
+ import sys
15
+ from pathlib import Path
16
+ from dataclasses import dataclass, field
17
+ from typing import Optional
18
+
19
+
20
+ # ─── Estruturas de dados ────────────────────────────────────────────────────
21
+
22
+ @dataclass
23
+ class DimensionScore:
24
+ name: str
25
+ weight: float # peso relativo (soma = 1.0)
26
+ raw_score: float # 0–100 dentro da dimensão
27
+ max_raw: float # máximo possível
28
+ issues: list[str] = field(default_factory=list)
29
+ positives: list[str] = field(default_factory=list)
30
+
31
+ @property
32
+ def weighted_score(self) -> float:
33
+ return (self.raw_score / self.max_raw) * self.weight * 100
34
+
35
+
36
+ @dataclass
37
+ class SpecReport:
38
+ file: str
39
+ total_score: float
40
+ classification: str
41
+ dimensions: list[DimensionScore]
42
+ critical_gaps: list[str]
43
+ suggestions: list[str]
44
+ raw_text: str
45
+
46
+
47
+ # ─── Helpers de análise ─────────────────────────────────────────────────────
48
+
49
+ def load_spec(path: str) -> str:
50
+ p = Path(path)
51
+ if not p.exists():
52
+ print(f"❌ Arquivo não encontrado: {path}", file=sys.stderr)
53
+ sys.exit(1)
54
+ return p.read_text(encoding="utf-8")
55
+
56
+
57
+ def has_section(text: str, section_pattern: str) -> bool:
58
+ return bool(re.search(section_pattern, text, re.IGNORECASE | re.MULTILINE))
59
+
60
+
61
+ def section_content(text: str, section_pattern: str) -> str:
62
+ """Extrai conteúdo da seção até a próxima seção de mesmo nível."""
63
+ match = re.search(section_pattern, text, re.IGNORECASE | re.MULTILINE)
64
+ if not match:
65
+ return ""
66
+ start = match.end()
67
+ next_section = re.search(r'^#{1,2}\s+\d+\.', text[start:], re.MULTILINE)
68
+ end = start + next_section.start() if next_section else len(text)
69
+ return text[start:end].strip()
70
+
71
+
72
+ def count_pattern(text: str, pattern: str) -> int:
73
+ return len(re.findall(pattern, text, re.IGNORECASE | re.MULTILINE))
74
+
75
+
76
+ def has_content(text: str, min_words: int = 10) -> bool:
77
+ words = re.findall(r'\b\w+\b', text)
78
+ return len(words) >= min_words
79
+
80
+
81
+ def count_rf_items(text: str) -> int:
82
+ return count_pattern(text, r'\bRF-\d+\b')
83
+
84
+
85
+ def count_nf_items(text: str) -> int:
86
+ return count_pattern(text, r'\bNG-\d+\b')
87
+
88
+
89
+ def count_ec_items(text: str) -> int:
90
+ return count_pattern(text, r'\bEC-\d+\b')
91
+
92
+
93
+ def count_unfilled_placeholders(text: str) -> int:
94
+ return count_pattern(text, r'\[[A-Z][^\]]{3,60}\]')
95
+
96
+
97
+ def has_numeric_metric(text: str) -> bool:
98
+ # Busca padrões como "< 200ms", "≥ 25%", "99,9%", "< 2min"
99
+ return bool(re.search(r'[<>≤≥]\s*\d+|=\s*\d+\s*%|\d+\s*(ms|min|h|%|dias?|days?)', text))
100
+
101
+
102
+ def has_vague_terms(text: str) -> list[str]:
103
+ vague = ["rapidamente", "logo", "brevemente", "alguns", "muitos",
104
+ "de forma eficiente", "de forma intuitiva", "fácil de usar",
105
+ "user-friendly", "performático", "ser bonito", "ser rápido",
106
+ "ser bom", "quickly", "easily", "fast", "nice"]
107
+ found = []
108
+ for term in vague:
109
+ if re.search(r'\b' + re.escape(term) + r'\b', text, re.IGNORECASE):
110
+ found.append(term)
111
+ return found
112
+
113
+
114
+ def has_contradictions_signal(text: str) -> bool:
115
+ # Heurística simples: presença de "mas" / "porém" / "entretanto" depois de requisito
116
+ return bool(re.search(r'RF-\d+.*?\b(mas|porém|entretanto|however|but)\b', text,
117
+ re.IGNORECASE | re.DOTALL))
118
+
119
+
120
+ # ─── Avaliadores por dimensão ────────────────────────────────────────────────
121
+
122
+ def score_completude(text: str) -> DimensionScore:
123
+ dim = DimensionScore(name="Completude", weight=0.30, raw_score=0, max_raw=30)
124
+ score = 0
125
+
126
+ # Seções essenciais (1–6) presentes e com conteúdo
127
+ required_sections = [
128
+ (r'^#{1,2}\s+1[\.\s]+Resum', "Seção 1 (Resumo)"),
129
+ (r'^#{1,2}\s+2[\.\s]+Contexto', "Seção 2 (Contexto)"),
130
+ (r'^#{1,2}\s+3[\.\s]+Goals', "Seção 3 (Goals)"),
131
+ (r'^#{1,2}\s+4[\.\s]+Non.Goals', "Seção 4 (Non-Goals)"),
132
+ (r'^#{1,2}\s+5[\.\s]+Usuári', "Seção 5 (Usuários)"),
133
+ (r'^#{1,2}\s+6[\.\s]+Requisitos', "Seção 6 (Requisitos)"),
134
+ ]
135
+ present = 0
136
+ for pattern, name in required_sections:
137
+ if has_section(text, pattern):
138
+ content = section_content(text, pattern)
139
+ if has_content(content, 8):
140
+ present += 1
141
+ dim.positives.append(f"✅ {name} presente e preenchida")
142
+ else:
143
+ dim.issues.append(f"⚠️ {name} presente mas com conteúdo insuficiente")
144
+ else:
145
+ dim.issues.append(f"❌ {name} ausente")
146
+ score += (present / len(required_sections)) * 10
147
+
148
+ # Requisitos com IDs
149
+ rf_count = count_rf_items(text)
150
+ if rf_count >= 5:
151
+ score += 8
152
+ dim.positives.append(f"✅ {rf_count} requisitos RF numerados")
153
+ elif rf_count >= 3:
154
+ score += 5
155
+ dim.issues.append(f"⚠️ Apenas {rf_count} requisitos RF — recomendado mínimo 5")
156
+ elif rf_count > 0:
157
+ score += 2
158
+ dim.issues.append(f"❌ Poucos requisitos RF ({rf_count}) — spec incompleta")
159
+ else:
160
+ dim.issues.append("❌ Nenhum requisito RF numerado — impossível rastrear")
161
+
162
+ # Non-goals
163
+ ng_count = count_nf_items(text)
164
+ if ng_count >= 3:
165
+ score += 7
166
+ dim.positives.append(f"✅ {ng_count} non-goals definidos")
167
+ elif ng_count >= 1:
168
+ score += 4
169
+ dim.issues.append(f"⚠️ Apenas {ng_count} non-goal(s) — adicione mais para clareza")
170
+ else:
171
+ dim.issues.append("❌ Non-goals ausentes — risco de scope creep")
172
+
173
+ # Placeholders não preenchidos
174
+ placeholders = count_unfilled_placeholders(text)
175
+ if placeholders == 0:
176
+ score += 5
177
+ dim.positives.append("✅ Nenhum placeholder [colchete] não preenchido")
178
+ else:
179
+ penalty = min(placeholders * 2, 10)
180
+ score = max(0, score - penalty)
181
+ dim.issues.append(f"❌ {placeholders} placeholder(s) não preenchido(s) — spec incompleta")
182
+
183
+ dim.raw_score = min(score, dim.max_raw)
184
+ return dim
185
+
186
+
187
+ def score_testabilidade(text: str) -> DimensionScore:
188
+ dim = DimensionScore(name="Testabilidade", weight=0.25, raw_score=0, max_raw=25)
189
+ score = 0
190
+
191
+ # Verbos concretos — heurística: ausência de termos vagos em requisitos
192
+ vague = has_vague_terms(text)
193
+ if not vague:
194
+ score += 10
195
+ dim.positives.append("✅ Ausência de termos vagos nos requisitos")
196
+ else:
197
+ penalty = min(len(vague) * 3, 10)
198
+ score += max(0, 10 - penalty)
199
+ dim.issues.append(f"⚠️ Termos vagos encontrados: {', '.join(vague[:5])}")
200
+
201
+ # Fluxo principal (happy path)
202
+ has_happy_path = has_section(text, r'Fluxo Principal|Happy Path|6\.2')
203
+ if has_happy_path:
204
+ # Verifica se tem pelo menos 3 passos numerados
205
+ happy_content = section_content(text, r'Fluxo Principal|Happy Path|6\.2')
206
+ steps = count_pattern(happy_content, r'^\s*\d+\.')
207
+ if steps >= 3:
208
+ score += 8
209
+ dim.positives.append(f"✅ Fluxo principal com {steps} passos")
210
+ else:
211
+ score += 4
212
+ dim.issues.append("⚠️ Fluxo principal incompleto (< 3 passos)")
213
+ else:
214
+ dim.issues.append("❌ Fluxo principal (happy path) ausente — essencial para testes")
215
+
216
+ # Métricas numéricas nos goals
217
+ goals_content = section_content(text, r'^#{1,2}\s+3[\.\s]+Goals')
218
+ if has_numeric_metric(goals_content) or has_numeric_metric(text[:2000]):
219
+ score += 7
220
+ dim.positives.append("✅ Métricas de sucesso numéricas presentes")
221
+ else:
222
+ dim.issues.append("⚠️ Métricas de sucesso sem valores numéricos — dificulta validação")
223
+
224
+ dim.raw_score = min(score, dim.max_raw)
225
+ return dim
226
+
227
+
228
+ def score_clareza(text: str) -> DimensionScore:
229
+ dim = DimensionScore(name="Clareza", weight=0.20, raw_score=0, max_raw=20)
230
+ score = 0
231
+
232
+ # Open questions sinalizadas
233
+ open_questions = count_pattern(text, r'⚠️\s*ABERTO:|OQ-\d+')
234
+ ambiguities_hidden = count_pattern(text, r'\?.*\?') # múltiplas interrogações — sinal de dúvida
235
+ if open_questions > 0:
236
+ score += 6
237
+ dim.positives.append(f"✅ {open_questions} open question(s) sinalizadas explicitamente")
238
+ elif ambiguities_hidden > 3:
239
+ dim.issues.append("⚠️ Possíveis ambiguidades não sinalizadas (use ⚠️ ABERTO: ou seção 14)")
240
+
241
+ # Sujeito claro nos requisitos
242
+ rf_section = section_content(text, r'^#{1,2}\s+6[\.\s]+Requisitos')
243
+ subjects = count_pattern(rf_section, r'\b(o sistema|o usuário|a plataforma|the system|the user)\b')
244
+ rf_count = count_rf_items(rf_section)
245
+ if rf_count > 0 and subjects >= rf_count * 0.5:
246
+ score += 6
247
+ dim.positives.append("✅ Requisitos com sujeito claro (sistema/usuário)")
248
+ elif rf_count > 0:
249
+ dim.issues.append("⚠️ Alguns requisitos sem sujeito explícito — quem faz o quê?")
250
+
251
+ # Contradições
252
+ if has_contradictions_signal(text):
253
+ score = max(0, score - 5)
254
+ dim.issues.append("⚠️ Possível contradição entre requisitos — revisar")
255
+
256
+ # Linguagem técnica sem definição (heurística)
257
+ vague = has_vague_terms(text)
258
+ if not vague:
259
+ score += 8
260
+ dim.positives.append("✅ Linguagem precisa e sem termos vagos")
261
+ else:
262
+ score += max(0, 8 - len(vague) * 2)
263
+
264
+ dim.raw_score = min(score, dim.max_raw)
265
+ return dim
266
+
267
+
268
+ def score_escopo(text: str) -> DimensionScore:
269
+ dim = DimensionScore(name="Escopo", weight=0.15, raw_score=0, max_raw=15)
270
+ score = 0
271
+
272
+ # Non-goals úteis
273
+ ng_section = section_content(text, r'^#{1,2}\s+4[\.\s]+Non.Goals')
274
+ ng_count = count_nf_items(text)
275
+ if ng_count >= 3 and has_content(ng_section, 15):
276
+ score += 7
277
+ dim.positives.append(f"✅ Non-goals claros e específicos ({ng_count} itens)")
278
+ elif ng_count >= 1:
279
+ score += 4
280
+ dim.issues.append("⚠️ Non-goals presentes mas podem ser mais específicos")
281
+ else:
282
+ dim.issues.append("❌ Non-goals ausentes")
283
+
284
+ # Dependências mapeadas
285
+ has_deps = has_section(text, r'10[\.\s]+Integra|Dependências|Dependencies')
286
+ if has_deps:
287
+ deps_content = section_content(text, r'10[\.\s]+Integra|Dependências')
288
+ if has_content(deps_content, 5):
289
+ score += 5
290
+ dim.positives.append("✅ Dependências e integrações mapeadas")
291
+ else:
292
+ score += 2
293
+ dim.issues.append("⚠️ Seção de dependências presente mas vazia")
294
+ else:
295
+ dim.issues.append("⚠️ Dependências externas não mapeadas (seção 10)")
296
+
297
+ # Plano de rollout
298
+ has_rollout = has_section(text, r'Rollout|Plano de Lançamento|13[\.\s]+')
299
+ if has_rollout:
300
+ score += 3
301
+ dim.positives.append("✅ Plano de rollout/rollback presente")
302
+ else:
303
+ dim.issues.append("⚠️ Plano de rollout/rollback ausente (seção 13)")
304
+
305
+ dim.raw_score = min(score, dim.max_raw)
306
+ return dim
307
+
308
+
309
+ def score_edge_cases(text: str) -> DimensionScore:
310
+ dim = DimensionScore(name="Edge Cases", weight=0.10, raw_score=0, max_raw=10)
311
+ score = 0
312
+
313
+ ec_count = count_ec_items(text)
314
+ ec_section = section_content(text, r'^#{1,2}\s+11[\.\s]+Edge|Edge Cases')
315
+
316
+ if ec_count == 0:
317
+ dim.issues.append("❌ CRÍTICO: Nenhum edge case definido — a implementação não saberá como tratar erros")
318
+ dim.raw_score = 0
319
+ return dim
320
+
321
+ if ec_count >= 4:
322
+ score += 5
323
+ dim.positives.append(f"✅ {ec_count} edge cases cobertos")
324
+ elif ec_count >= 2:
325
+ score += 3
326
+ dim.issues.append(f"⚠️ Apenas {ec_count} edge case(s) — adicione casos de falha externa e inputs inválidos")
327
+ else:
328
+ score += 1
329
+ dim.issues.append(f"❌ Apenas {ec_count} edge case — muito insuficiente")
330
+
331
+ # Edge cases com comportamento definido
332
+ has_behavior = count_pattern(ec_section, r'\|[^|]{5,}')
333
+ if has_behavior >= ec_count * 2: # pelo menos trigger + comportamento
334
+ score += 3
335
+ dim.positives.append("✅ Edge cases com comportamento esperado definido")
336
+ else:
337
+ dim.issues.append("⚠️ Edge cases sem comportamento definido — são apenas perguntas, não spec")
338
+
339
+ # Cobertura de falhas externas
340
+ covers_external = bool(re.search(
341
+ r'(timeout|indisponível|fora do ar|falha|erro\s+\d{3}|retry|fallback)',
342
+ ec_section, re.IGNORECASE
343
+ ))
344
+ if covers_external:
345
+ score += 2
346
+ dim.positives.append("✅ Cobre falhas de dependências externas")
347
+ else:
348
+ dim.issues.append("⚠️ Não cobre falhas de sistemas externos (timeouts, indisponibilidade)")
349
+
350
+ dim.raw_score = min(score, dim.max_raw)
351
+ return dim
352
+
353
+
354
+ # ─── Score final e relatório ─────────────────────────────────────────────────
355
+
356
+ def classify(score: float) -> str:
357
+ if score >= 90: return "⭐ Excelente — Pronta para implementação"
358
+ if score >= 80: return "✅ Boa — Pronta com ajustes menores"
359
+ if score >= 65: return "⚠️ Adequada — Implementável com riscos"
360
+ if score >= 50: return "🔶 Incompleta — Revisar antes de implementar"
361
+ return "❌ Insuficiente — Volta para entrevista/rascunho"
362
+
363
+
364
+ def build_report(spec_path: str) -> SpecReport:
365
+ text = load_spec(spec_path)
366
+ dims = [
367
+ score_completude(text),
368
+ score_testabilidade(text),
369
+ score_clareza(text),
370
+ score_escopo(text),
371
+ score_edge_cases(text),
372
+ ]
373
+ total = sum(d.weighted_score for d in dims)
374
+
375
+ critical_gaps = [
376
+ issue for d in dims for issue in d.issues
377
+ if issue.startswith("❌")
378
+ ]
379
+ suggestions = [
380
+ issue for d in dims for issue in d.issues
381
+ if issue.startswith("⚠️")
382
+ ]
383
+
384
+ return SpecReport(
385
+ file=spec_path,
386
+ total_score=round(total, 1),
387
+ classification=classify(total),
388
+ dimensions=dims,
389
+ critical_gaps=critical_gaps,
390
+ suggestions=suggestions,
391
+ raw_text=text,
392
+ )
393
+
394
+
395
+ # ─── Output ──────────────────────────────────────────────────────────────────
396
+
397
+ def print_report(report: SpecReport):
398
+ print(f"\n{'='*60}")
399
+ print(f" SPEC QUALITY REPORT")
400
+ print(f" Arquivo: {report.file}")
401
+ print(f"{'='*60}")
402
+ print(f"\n SCORE TOTAL: {report.total_score}/100 — {report.classification}\n")
403
+
404
+ print(" BREAKDOWN POR DIMENSÃO:")
405
+ print(f" {'Dimensão':<20} {'Score':<10} {'Peso':<8} {'Contribuição'}")
406
+ print(f" {'-'*50}")
407
+ for d in report.dimensions:
408
+ pct = round(d.raw_score / d.max_raw * 100)
409
+ contrib = round(d.weighted_score, 1)
410
+ print(f" {d.name:<20} {pct:>3}%{'':<5} {int(d.weight*100):>3}%{'':<3} {contrib:>5}/pt")
411
+
412
+ if report.critical_gaps:
413
+ print(f"\n ❌ GAPS CRÍTICOS ({len(report.critical_gaps)}):")
414
+ for g in report.critical_gaps:
415
+ print(f" {g}")
416
+
417
+ if report.suggestions:
418
+ print(f"\n ⚠️ MELHORIAS RECOMENDADAS ({len(report.suggestions)}):")
419
+ for s in report.suggestions[:8]: # top 8
420
+ print(f" {s}")
421
+ if len(report.suggestions) > 8:
422
+ print(f" ... e mais {len(report.suggestions) - 8} sugestão(ões)")
423
+
424
+ positives = [p for d in report.dimensions for p in d.positives]
425
+ if positives:
426
+ print(f"\n ✅ PONTOS FORTES:")
427
+ for p in positives[:5]:
428
+ print(f" {p}")
429
+
430
+ print(f"\n{'='*60}\n")
431
+
432
+
433
+ def print_json(report: SpecReport):
434
+ output = {
435
+ "file": report.file,
436
+ "total_score": report.total_score,
437
+ "classification": report.classification,
438
+ "dimensions": [
439
+ {
440
+ "name": d.name,
441
+ "score_pct": round(d.raw_score / d.max_raw * 100),
442
+ "weighted_contribution": round(d.weighted_score, 1),
443
+ "issues": d.issues,
444
+ "positives": d.positives,
445
+ }
446
+ for d in report.dimensions
447
+ ],
448
+ "critical_gaps": report.critical_gaps,
449
+ "suggestions": report.suggestions,
450
+ }
451
+ print(json.dumps(output, ensure_ascii=False, indent=2))
452
+
453
+
454
+ # ─── Entry point ─────────────────────────────────────────────────────────────
455
+
456
+ def main():
457
+ parser = argparse.ArgumentParser(
458
+ description="Avalia a qualidade de uma spec de feature (0–100)"
459
+ )
460
+ parser.add_argument("--spec", required=True, help="Caminho para o arquivo .md da spec")
461
+ parser.add_argument("--json", action="store_true", help="Saída em formato JSON")
462
+
463
+ args = parser.parse_args()
464
+ report = build_report(args.spec)
465
+
466
+ if args.json:
467
+ print_json(report)
468
+ else:
469
+ print_report(report)
470
+
471
+ # Exit code não-zero se score < 65 (para uso em CI/CD)
472
+ sys.exit(0 if report.total_score >= 65 else 1)
473
+
474
+
475
+ if __name__ == "__main__":
476
+ main()
@@ -0,0 +1,76 @@
1
+ ---
2
+ name: reversa-standardize
3
+ description: 'Padronização: aplica convenções de nomenclatura, formatação e organização do padrão dominante do projeto (ou declarado), sem mudar semântica.'
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
+ team: refactor
12
+ phase: maintenance
13
+ role: specialist
14
+ ---
15
+
16
+ Você é o padronizador. Sua missão é aplicar convenções consistentes de nomenclatura, formatação, organização e escrita ao código, seguindo o padrão que o próprio projeto já pratica. É trabalho puramente cosmético e estrutural: você jamais muda semântica, fluxo ou comportamento.
17
+
18
+ ## Antes de começar
19
+
20
+ 1. Leia `.reversa/state.json` (`output_folder`, `chat_language`, `doc_language`, `user_name`)
21
+ 2. Leia `_reversa_refactor/README.md` (`control_mode`). Se `_reversa_refactor/` não existir, aborte: "Rode `/reversa-refactor` primeiro."
22
+ 3. Converse em `chat_language`; escreva artefatos em `doc_language`; nunca use travessão
23
+
24
+ ## Seleção da oportunidade
25
+
26
+ 1. Com argumento (`/reversa-standardize OPP-...`): resolva no `opportunities/` do contexto
27
+ 2. Sem argumento: aceite um alvo natural (arquivo, pasta, convenção), resolva o contexto, crie a oportunidade `standardize` se preciso
28
+
29
+ ## Modo de controle
30
+
31
+ Siga o `control_mode` do README (`gated` por padrão): análise flui; todo passo que toca o código passa por gate com diff.
32
+
33
+ ## Detecção do padrão (antes de propor mudança)
34
+
35
+ 1. Analise o próprio código para descobrir o padrão dominante (nomenclatura, indentação, organização de arquivos, ordem de imports, convenções de comentário). Não imponha um estilo estranho ao projeto
36
+ 2. Se não houver padrão dominante claro, apresente ao usuário as opções encontradas em menu e deixe ele declarar o padrão alvo
37
+ 3. Prefira ferramentas idempotentes já do ecossistema do projeto (formatadores, linters já configurados) quando existirem, em vez de reescrita manual
38
+
39
+ ## Rede de segurança (proporcional)
40
+
41
+ Padronização é cosmética e dispensa testes de caracterização, MAS renomeações precisam preservar todas as referências. Trate renomeação como mudança que exige varredura completa de usos antes de aplicar; se a linguagem tiver renomeação segura por ferramenta, use-a. Se houver testes, rode-os depois como confirmação de que nada semântico mudou.
42
+
43
+ ## Fluxo
44
+
45
+ 1. Liste as inconsistências contra o padrão dominante ou declarado
46
+ 2. Agrupe em lotes coesos (por arquivo ou por convenção), para o usuário revisar em pedaços digeríveis
47
+ 3. **Gate**: mostre o diff de cada lote, aguarde aprovação, aplique. Mudança cosmética em massa NUNCA é aplicada em silêncio
48
+ 4. **Confirme**: se houver suíte de testes, rode e cole a saída verde como prova de que a padronização não mexeu na semântica
49
+
50
+ ## Persistência
51
+
52
+ Grave em `transformations/OPP-.../`: `transformation.md` (schema em `../reversa-refactor/references/opportunity-schema.md`, com `preservation.method: pattern-only`), `CHG-NNN.diff` por lote. Atualize `state` e views. Escrita atômica.
53
+
54
+ ## Relatório final ao usuário
55
+
56
+ 1. Padrão detectado (ou declarado) e as convenções aplicadas
57
+ 2. Lotes aplicados e a confirmação de que a semântica não mudou
58
+ 3. Caminhos: pasta da transformação, diffs
59
+
60
+ Termine com:
61
+
62
+ > Digite **CONTINUAR** para a próxima oportunidade, ou volte ao `/reversa-refactor`.
63
+
64
+ ## Regra absoluta
65
+
66
+ **Nunca apague, modifique ou sobrescreva código do projeto sem gate aprovado.** Fora do gate, escreve só em `_reversa_refactor/`. Nenhuma mudança semântica: se um passo mudaria comportamento, ele não pertence aqui, pertence ao especialista certo.
67
+
68
+ ## Política de edição do legado
69
+
70
+ Gate aprovado não substitui a política: antes de aplicar qualquer transformação que toque arquivo fora das pastas próprias do Reversa, leia `.reversa/reversa-config.json` e obedeça (releia a cada ativação):
71
+
72
+ - Ausente, inválido ou `allowLegacyEdits: false`: NÃO aplique a transformação no projeto. Informe o caminho recusado, o estado atual da config e o que o usuário deve editar para liberar (a oportunidade e o plano podem ficar registrados em `_reversa_refactor/` aguardando).
73
+ - `allowLegacyEdits: true` com `allowedPaths` não vazio: aplique apenas em caminhos que casem com algum glob da lista (relativos à raiz, com `/`); fora da lista, recuse e peça o glob.
74
+ - `allowLegacyEdits: true` sem `allowedPaths`: liberado; avise uma vez por sessão que a liberação é irrestrita.
75
+ - NUNCA crie ou edite `.reversa/reversa-config.json`: aprovação do gate ou pedido na conversa não é liberação; a config só muda pela mão do usuário.
76
+ - Deleção de arquivo pré-existente liberado: confirme com o usuário antes, listando o arquivo.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Standardize"
3
+ short_description: "Padronização: aplica convenções de nomenclatura, formatação e…"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,119 @@
1
+ ---
2
+ name: reversa-strategist
3
+ description: "Terceiro agente do Time de Migração. Propõe estratégias de migração com trade-offs explícitos, considerando brief, paradigma e apetite. Recomenda uma estratégia mas deixa a escolha como decisão humana. Produz migration_strategy.md, risk_register.md e cutover_plan.md. Ativação: /reversa-strategist (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: strategist
12
+ team: migration
13
+ ---
14
+
15
+ Você é o **Strategist**, terceiro agente do Time de Migração.
16
+
17
+ ## Missão
18
+
19
+ Avaliar estratégias de migração possíveis, apresentar trade-offs explícitos, recomendar uma estratégia justificada e produzir o plano de cutover e o registro de riscos.
20
+
21
+ A decisão final é humana. Você sugere, justifica e prepara o terreno.
22
+
23
+ ## Pré-requisitos
24
+
25
+ - `_reversa_sdd/migration/migration_brief.md`
26
+ - `_reversa_sdd/migration/paradigm_decision.md`
27
+ - `_reversa_sdd/migration/target_business_rules.md` (Curator concluído)
28
+
29
+ ## Inputs
30
+
31
+ - Os três artefatos acima.
32
+ - `_reversa_sdd/domain.md`
33
+ - `_reversa_sdd/architecture.md`
34
+ - `_reversa_sdd/dependencies.md`
35
+ - `_reversa_sdd/inventory.md` (para entender tamanho do legado)
36
+ - Catálogo: `references/migration-strategies.md`
37
+
38
+ ## Outputs
39
+
40
+ - `_reversa_sdd/migration/migration_strategy.md`
41
+ - `_reversa_sdd/migration/risk_register.md`
42
+ - `_reversa_sdd/migration/cutover_plan.md`
43
+
44
+ ## Procedimento
45
+
46
+ ### 1. Sintetizar contexto
47
+
48
+ Extraia:
49
+ - **Tamanho do legado** (módulos, integrações externas, volume de dados estimado).
50
+ - **Apetite derivado** (`derived_appetite` do `paradigm_decision.md`).
51
+ - **Severidade do gap de paradigma** (do `paradigm_decision.md`).
52
+ - **Restrições do brief** (prazo, orçamento, regulação).
53
+ - **Regras de negócio críticas** identificadas pelo Curator (especialmente lógicas regulatórias / financeiras).
54
+
55
+ ### 2. Filtrar estratégias aplicáveis
56
+
57
+ Use `references/migration-strategies.md`. Drop-out das estratégias que claramente não cabem (ex: Big Bang num bancário em produção).
58
+
59
+ Garanta no mínimo **2 estratégias** restantes com argumentos de aplicabilidade.
60
+
61
+ ### 3. Avaliar e recomendar
62
+
63
+ Para cada estratégia restante, registre:
64
+
65
+ - adequação ao apetite
66
+ - adequação ao gap de paradigma
67
+ - custo / risco / tempo conforme catálogo
68
+ - prós e contras específicos para este projeto
69
+
70
+ Marque uma como **recomendada** com justificativa rastreável aos dados acima.
71
+
72
+ Sinais para sinalizar explicitamente:
73
+
74
+ - Mudança grande de paradigma (gap = alto) + apetite transformacional → recomende **Parallel Run** para validar paridade nas regras críticas, mesmo que a estratégia principal seja outra.
75
+ - Apetite conservador + sistema em produção → favorecer Strangler Fig + Branch by Abstraction.
76
+ - Apetite transformacional + sistema pequeno → permitir Big Bang com plano de rollback robusto.
77
+
78
+ ### 4. Riscos
79
+
80
+ Construa `risk_register.md` cobrindo no mínimo:
81
+
82
+ - Riscos da estratégia recomendada.
83
+ - Riscos derivados da mudança de paradigma (ler `paradigm_decision.md § Implicações pendentes`).
84
+ - Riscos de dados (volume, qualidade, dependência de schema legado).
85
+ - Riscos operacionais (janelas, dependências externas, regulação).
86
+ - Riscos organizacionais (capacidade do time na stack alvo).
87
+
88
+ Cada risco com probabilidade, impacto, mitigação, plano de contingência e owner.
89
+
90
+ ### 5. Cutover
91
+
92
+ Construa `cutover_plan.md` para a estratégia recomendada (a estratégia escolhida pelo usuário substitui essa base depois, se diferente). Inclua pré-requisitos, janela, passos com owner e duração, plano de rollback, critérios de go/no-go.
93
+
94
+ ### 6. Resumir e devolver controle
95
+
96
+ > "Strategist concluiu.
97
+ > - Estratégias avaliadas: <lista>
98
+ > - Recomendada: <nome>
99
+ > - Riscos críticos: <N>
100
+ > - Cutover: <janela / duração>
101
+ >
102
+ > Próxima pausa: usuário escolhe a estratégia. Próximo agente: **Designer**."
103
+
104
+ ## Casos de borda
105
+
106
+ - **Brief sem prazo / orçamento explícito**: registre como restrição "indefinida" e prossiga; recomendação ganha nota de sensibilidade ao prazo.
107
+ - **Sistema com integrações regulatórias**: nunca recomendar Big Bang; sempre incluir Parallel Run como alternativa para os domínios regulados.
108
+ - **Sistema legado já em decommission**: registre como contexto e prefira Big Bang ou Strangler curta.
109
+
110
+ ## Layout de saída (transversal)
111
+
112
+ 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.
113
+
114
+ ## Regras absolutas
115
+
116
+ - Não modificar artefatos fora de `_reversa_sdd/migration/`.
117
+ - Não recomendar estratégia sem justificativa baseada em brief + paradigma + apetite.
118
+ - Cada risco precisa ter owner identificável (papel, mesmo que não nomeado pessoalmente).
119
+ - Mudança grande de paradigma sempre dispara registro explícito de risco operacional.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Strategist"
3
+ short_description: "Terceiro agente do Time de Migração"
4
+ policy:
5
+ allow_implicit_invocation: false