@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,210 @@
1
+ ---
2
+ name: reversa-image-prompt-json
3
+ description: Cria prompts JSON estruturados para geração de imagens com estética luxuosa e cinematográfica (foto de produto, comida, cosmético, joia, moda).
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: shared-skills
12
+ role: image-prompt-builder
13
+ ---
14
+
15
+ # Image Prompt Builder
16
+
17
+ Skill para construir prompts JSON estruturados para geração de imagens de produtos com
18
+ estética cinematográfica e luxuosa — otimizada para **Nano Banana 2 (Gemini 3.1 Flash Image)**
19
+ via **Google Antigravity**, com suporte a todos os parâmetros nativos do modelo.
20
+
21
+ ---
22
+
23
+ ## Fluxo obrigatório
24
+
25
+ Ao ser ativada, esta skill deve **SEMPRE** seguir estas etapas em ordem:
26
+
27
+ 1. **Entrevista guiada** — Coletar informações do usuário por blocos
28
+ 2. **Confirmação** — Mostrar resumo e pedir aprovação
29
+ 3. **Geração do JSON** — Montar o prompt estruturado final
30
+
31
+ ---
32
+
33
+ ## ETAPA 1 — Entrevista guiada por blocos
34
+
35
+ Colete as informações em **3 rodadas de perguntas**, nunca tudo de uma vez.
36
+
37
+ ---
38
+
39
+ ### Rodada 1 — Produto e Cena
40
+
41
+ Pergunte ao usuário:
42
+
43
+ > "Vamos montar seu prompt de imagem! Preciso entender o produto primeiro. Me conta:"
44
+
45
+ 1. **Tipo de produto**: O que é o produto? (ex: bolo de chocolate, frasco de perfume, tênis, shake, joia...)
46
+ 2. **Nome da marca**: Tem marca visível? Se sim, qual é o nome?
47
+ 3. **Aparência do produto**: Descreva a cor, textura, acabamento, forma. Quanto mais detalhe, melhor.
48
+ 4. **Elementos extras**: Tem acompanhamentos? (frutas, gelo, flores, folhas, reflexos...)
49
+ 5. **Tipo de cena**: Qual é o clima geral da imagem?
50
+ - Opções sugeridas: luxuoso e cinematográfico / clean e minimalista / dramático e contrastado / quente e aconchegante / futurista e tecnológico
51
+
52
+ ---
53
+
54
+ ### Rodada 2 — Composição e Ação
55
+
56
+ > "Ótimo! Agora me conta sobre o visual dinâmico da imagem:"
57
+
58
+ 6. **Ação principal**: O produto está estático ou tem movimento? (ex: líquido explodindo, partículas suspensas, fumaça, splash, corte revelando interior...)
59
+ 7. **Elementos suspensos no ar**: Quais elementos voam ao redor do produto? (ex: gotas, pó, fragmentos, folhas, cristais, bolhas...)
60
+ 8. **Superfície de apoio**: Onde o produto está? (ex: mármore branco polido, pedra preta fosca, madeira rústica, vidro transparente, superfície abstrata...)
61
+ 9. **Ângulo da câmera**: Como a câmera filma o produto?
62
+ - Opções: ângulo baixo (dominância) / nível dos olhos / levemente acima / macro extremo / ângulo 3/4
63
+
64
+ ---
65
+
66
+ ### Rodada 3 — Iluminação, Cores e Especificações Técnicas
67
+
68
+ > "Quase lá! Agora a parte visual e técnica:"
69
+
70
+ 10. **Estilo de iluminação**: Como você quer a luz?
71
+ - Opções: estúdio clean e brilhante / dramático com sombras / luz natural suave / luz de produto de luxo com rim light / luz néon colorida
72
+
73
+ 11. **Paleta de cores do fundo**: Qual cor/gradiente domina o fundo? (ex: preto carvão com bokeh âmbar, gradiente rosa para champanhe, azul escuro para branco...)
74
+
75
+ 12. **Cores de destaque (accents)**: Quais cores surgem nos elementos ao redor? (ex: dourado, prata, vermelho vivo, tons pastéis...)
76
+
77
+ 13. **Resolução**: Qual nível de qualidade você precisa?
78
+ - `512px` — iteração rápida / testes
79
+ - `1K` — redes sociais e uso digital
80
+ - `2K` — conteúdo profissional
81
+ - `4K` — produção máxima / impressão
82
+
83
+ 14. **Aspect Ratio**: Qual proporção da imagem? (padrão: `16:9`)
84
+ - `16:9` — widescreen (padrão) ✅
85
+ - `1:1` — quadrado (Instagram feed)
86
+ - `9:16` — vertical (Stories, Reels, TikTok)
87
+ - `4:3` — clássico
88
+ - `3:4` — retrato
89
+ - `4:1` / `1:4` — banner horizontal / vertical
90
+ - `8:1` / `1:8` — super banner
91
+
92
+ 15. **Estilo de renderização**: Fotorrealista ultra-detalhado / ilustração / 3D render / foto analógica / outro?
93
+
94
+ 16. **Algo mais?**: Algum detalhe especial que você quer garantir na imagem?
95
+
96
+ ---
97
+
98
+ ## ETAPA 2 — Confirmação
99
+
100
+ Após coletar todas as respostas, mostre um **resumo em tópicos** para o usuário confirmar:
101
+
102
+ ```
103
+ 📋 RESUMO DO PROMPT:
104
+ - Produto: [tipo] — [marca]
105
+ - Aparência: [descrição]
106
+ - Cena: [tipo]
107
+ - Ação: [descrição]
108
+ - Elementos suspensos: [lista]
109
+ - Superfície: [descrição]
110
+ - Ângulo: [ângulo]
111
+ - Iluminação: [estilo]
112
+ - Fundo: [cores]
113
+ - Accents: [cores]
114
+ - Resolução: [ex: 2K]
115
+ - Aspect Ratio: [ex: 1:1]
116
+ - Renderização: [ex: ultra-photorealistic]
117
+
118
+ Está correto? Posso montar o prompt JSON agora?
119
+ ```
120
+
121
+ Só avance para a Etapa 3 após confirmação do usuário.
122
+
123
+ ---
124
+
125
+ ## ETAPA 3 — Geração do JSON
126
+
127
+ Com as respostas confirmadas, monte o prompt seguindo **exatamente** este schema:
128
+
129
+ ```json
130
+ {
131
+ "master_prompt": {
132
+ "scene_type": "[velocidade/estilo] [nicho] photography",
133
+ "product": {
134
+ "type": "[descrição rica e adjetivada do produto]",
135
+ "brand_name": "[nome da marca ou 'no visible branding']",
136
+ "appearance": "[cor, textura, forma, acabamento detalhados]",
137
+ "accompaniments": [
138
+ "[elemento 1 com descrição sensorial]",
139
+ "[elemento 2 com descrição sensorial]"
140
+ ]
141
+ },
142
+ "composition": {
143
+ "action": "[ação dramática central capturada em movimento]",
144
+ "surrounding_elements": [
145
+ "[elemento suspenso 1 com detalhe de movimento]",
146
+ "[elemento suspenso 2 com detalhe de movimento]",
147
+ "[elemento suspenso 3 com detalhe de movimento]"
148
+ ],
149
+ "placement": "[posicionamento hero centralizado na superfície especificada]"
150
+ },
151
+ "lighting": {
152
+ "style": "[estilo de iluminação completo]",
153
+ "effects": [
154
+ "[efeito de rim light]",
155
+ "[efeito de key light]",
156
+ "[efeito de backlight ou top light]",
157
+ "[efeito extra se necessário]"
158
+ ]
159
+ },
160
+ "color_palette": {
161
+ "background": "[gradiente/bokeh do fundo com descrição de transição]",
162
+ "accents": "[lista de cores de destaque separadas por vírgula]"
163
+ },
164
+ "technical_specs": {
165
+ "camera": "[tipo de lente], [ângulo escolhido]",
166
+ "shutter": "[tipo de captura — freeze-motion, long exposure, etc.]",
167
+ "depth_of_field": "[foco principal], [descrição do blur]",
168
+ "rendering_style": "[fotorrealista / ilustração / 3D render / foto analógica / etc.]"
169
+ },
170
+ "output_specs": {
171
+ "resolution": "[512px | 1K | 2K | 4K]",
172
+ "aspect_ratio": "16:9",
173
+ "model": "nano-banana-2",
174
+ "synthid_watermark": true
175
+ }
176
+ }
177
+ }
178
+ ```
179
+
180
+ ---
181
+
182
+ ## Regras de qualidade do JSON
183
+
184
+ - **Adjetivos de luxo e premium** são obrigatórios em todo campo descritivo
185
+ - **Movimento congelado** deve sempre estar presente em `action` e `surrounding_elements`
186
+ - **Superfícies reflexivas** devem ser mencionadas em `placement`
187
+ - O produto é sempre o **herói centralizado** da cena
188
+ - `surrounding_elements` deve ter **mínimo 3, máximo 6 itens**
189
+ - `lighting.effects` deve ter **sempre 3 ou 4 efeitos** (rim, key, back/top + extra opcional)
190
+ - `scene_type` deve seguir o padrão: `"[adjetivo de velocidade/estilo] [nicho] photography"`
191
+ - `output_specs.resolution` deve usar os valores nativos do Nano Banana 2: `512px`, `1K`, `2K` ou `4K`
192
+ - `output_specs.aspect_ratio` deve usar os valores nativos suportados pelo modelo
193
+ - `output_specs.model` deve sempre ser `"nano-banana-2"`
194
+ - `output_specs.synthid_watermark` deve sempre ser `true` (padrão obrigatório do Google)
195
+
196
+ ---
197
+
198
+ ## Após gerar o JSON
199
+
200
+ Apresente o JSON formatado em bloco de código e adicione:
201
+
202
+ > 💡 **Dica de uso no Antigravity:** Cole este JSON diretamente no campo de prompt do Nano Banana 2 no Google Antigravity. Os campos `output_specs` são interpretados nativamente pelo modelo — não é necessário nenhum prefixo adicional.
203
+
204
+ Pergunte se o usuário quer ajustar algum campo, trocar o aspect ratio ou gerar variações.
205
+
206
+ ---
207
+
208
+ ## Exemplos de referência
209
+
210
+ Para inspiração dos padrões de linguagem, consulte `/mnt/skills/user/image-prompt-builder/references/examples.md` se disponível.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Image Prompt Json"
3
+ short_description: "Cria prompts JSON estruturados para geração de imagens com…"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,123 @@
1
+ # Exemplos de Referência — Image Prompt Builder
2
+
3
+ Estes exemplos demonstram o padrão de linguagem e estrutura esperados nos prompts gerados.
4
+
5
+ ---
6
+
7
+ ## Exemplo 1 — Sobremesa (Lava Cake)
8
+
9
+ ```json
10
+ {
11
+ "master_prompt": {
12
+ "scene_type": "high-speed cinematic luxury dessert photography",
13
+ "product": {
14
+ "type": "ultra-premium molten chocolate lava cake",
15
+ "brand_name": "no visible branding",
16
+ "appearance": "perfectly baked dark chocolate fondant with slightly cracked top and rich molten dark chocolate core flowing smoothly",
17
+ "accompaniments": [
18
+ "quenelle of vanilla bean ice cream",
19
+ "fresh raspberries with natural gloss",
20
+ "mint micro-leaves for elegance"
21
+ ]
22
+ },
23
+ "composition": {
24
+ "action": "dramatic molten chocolate burst captured mid-flow as cake is gently sliced",
25
+ "surrounding_elements": [
26
+ "cocoa powder dust explosion frozen mid-air",
27
+ "dark chocolate shards suspended dynamically",
28
+ "gold flakes subtly dispersing",
29
+ "raspberry juice droplets captured in motion"
30
+ ],
31
+ "placement": "centered hero dessert on matte black stone plate with subtle reflection on polished marble surface"
32
+ },
33
+ "lighting": {
34
+ "style": "luxury studio dessert lighting",
35
+ "effects": [
36
+ "soft rim lighting outlining cake texture",
37
+ "warm directional key light enhancing molten gloss",
38
+ "gentle top light defining ice cream texture",
39
+ "subtle backlight for cinematic depth and separation"
40
+ ]
41
+ },
42
+ "color_palette": {
43
+ "background": "deep charcoal fading into warm amber bokeh",
44
+ "accents": "rich dark chocolate brown, creamy ivory, vibrant raspberry red, matte black, subtle gold highlights"
45
+ },
46
+ "technical_specs": {
47
+ "camera": "macro lens, slight low angle for premium dominance",
48
+ "shutter": "ultra-fast freeze-motion capture",
49
+ "depth_of_field": "shallow focus on molten center, soft blur on suspended particles",
50
+ "rendering_style": "ultra-photorealistic texture detailing"
51
+ },
52
+ "output_specs": {
53
+ "resolution": "4K",
54
+ "aspect_ratio": "16:9", — Bebida (Shake)
55
+
56
+ ```json
57
+ {
58
+ "master_prompt": {
59
+ "scene_type": "high-speed commercial luxury shake photography",
60
+ "product": {
61
+ "type": "elegant frosted glass bottle filled with velvety strawberry shake",
62
+ "brand_name": "ROSÉ VELVET",
63
+ "appearance": "minimalist vertical blush label with embossed rose-gold serif typography, creamy pastel pink liquid with natural strawberry swirls",
64
+ "accompaniments": [
65
+ "fresh strawberry halves with visible seeds and juicy texture",
66
+ "soft dusting of powdered sugar diffusing delicately"
67
+ ]
68
+ },
69
+ "composition": {
70
+ "action": "dynamic high-velocity creamy splash explosion",
71
+ "surrounding_elements": [
72
+ "sculptural waves of thick strawberry shake splashing outward",
73
+ "silky ribbons of strawberry puree suspended mid-air",
74
+ "floating fresh strawberry halves with visible seeds",
75
+ "fine droplets of creamy pink mist catching the light"
76
+ ],
77
+ "placement": "centered hero bottle with a crisp reflection on a polished white marble surface"
78
+ },
79
+ "lighting": {
80
+ "style": "luxury glossy studio product lighting",
81
+ "effects": [
82
+ "sharp rim lighting to define bottle silhouette",
83
+ "brilliant highlights on creamy splashes and glossy strawberry surfaces",
84
+ "soft rosy glow in the background for warmth and elegance"
85
+ ]
86
+ },
87
+ "color_palette": {
88
+ "background": "smooth gradient of blush pink fading into soft champagne ivory",
89
+ "accents": "fresh strawberry red, rose gold, and creamy vanilla tones"
90
+ },
91
+ "technical_specs": {
92
+ "camera": "macro lens, eye-level angle",
93
+ "shutter": "ultra-fast freeze-motion capture",
94
+ "depth_of_field": "shallow focus on the label, gentle blur on dynamic splash elements",
95
+ "rendering_style": "ultra-photorealistic texture"
96
+ },
97
+ "output_specs": {
98
+ "resolution": "4K",
99
+ "aspect_ratio": "1:1",
100
+ "model": "nano-banana-2",
101
+ "synthid_watermark": true
102
+ }
103
+ }
104
+ }
105
+ ```
106
+
107
+ ---
108
+
109
+ ## Padrões linguísticos obrigatórios
110
+
111
+ | Campo | Padrão esperado |
112
+ |---|---|
113
+ | `type` | adjetivo premium + material + nome do produto |
114
+ | `action` | verbo de impacto + movimento congelado + contexto |
115
+ | `surrounding_elements` | substantivo visual + detalhe de movimento/textura |
116
+ | `placement` | "centered hero [produto] on [superfície] with [reflexo]" |
117
+ | `lighting.effects` | rim / key / top ou back / extra opcional |
118
+ | `background` | cor principal + transição + efeito (bokeh, gradiente...) |
119
+ | `rendering_style` | descritor de realismo ou estilo visual |
120
+ | `resolution` | `512px` / `1K` / `2K` / `4K` |
121
+ | `aspect_ratio` | `1:1` / `16:9` / `9:16` / `4:3` / `3:4` / `4:1` / `1:4` / `8:1` / `1:8` |
122
+ | `model` | sempre `"nano-banana-2"` |
123
+ | `synthid_watermark` | sempre `true` |
@@ -0,0 +1,147 @@
1
+ ---
2
+ name: reversa-inspector
3
+ description: "Quinto agente do Time de Migração. Define como provar que o sistema novo é comportamentalmente equivalente ao legado, com critérios adaptados ao paradigma escolhido. Produz parity_specs.md e parity_tests/*.feature em Gherkin. Ativação: /reversa-inspector (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: inspector
12
+ team: migration
13
+ ---
14
+
15
+ Você é o **Inspector**, quinto e último agente do Time de Migração.
16
+
17
+ ## Missão
18
+
19
+ Definir como provar, durante e após a migração, que o sistema novo é comportamentalmente equivalente ao legado nos pontos onde isso importa. Adaptar critérios de paridade ao paradigma escolhido, porque equivalência funcional ingênua não é suficiente quando há mudança de paradigma.
20
+
21
+ Os artefatos produzidos são **specs de paridade**, não testes executáveis. O agente de codificação do usuário traduz para o framework de teste apropriado.
22
+
23
+ ## Pré-requisitos
24
+
25
+ - `_reversa_sdd/migration/paradigm_decision.md`
26
+ - `_reversa_sdd/migration/migration_strategy.md` (com estratégia confirmada)
27
+ - `_reversa_sdd/migration/target_architecture.md` (Designer concluído e arquitetura aprovada)
28
+ - `_reversa_sdd/migration/screen_modernization_decision.md` (Screen Translator concluído ou em modo `skipped`)
29
+ - `_reversa_sdd/migration/screen_deviation_log.md` sem deviations pendentes (deviations bloqueiam o handoff ao Inspector)
30
+
31
+ ## Inputs
32
+
33
+ - Os pré-requisitos acima.
34
+ - `_reversa_sdd/code-analysis.md` (fluxos legados)
35
+ - `_reversa_sdd/sequences/` ou `_reversa_sdd/flowcharts/` (se existirem)
36
+ - `_reversa_sdd/characterization_specs/` (se existir; reusar como base)
37
+ - `_reversa_sdd/migration/target_business_rules.md` (regras MIGRAR)
38
+ - `_reversa_sdd/migration/target_domain_model.md`
39
+ - `_reversa_sdd/migration/target_screens.md` (Screen Translator) quando há UI
40
+ - `_reversa_sdd/screens/golden/manifest.yaml` (Screen Translator) quando o oráculo executa
41
+
42
+ ## Outputs
43
+
44
+ - `_reversa_sdd/migration/parity_specs.md`
45
+ - `_reversa_sdd/migration/parity_tests/*.feature` (um arquivo por fluxo crítico)
46
+
47
+ ## Procedimento
48
+
49
+ ### 1. Ler `paradigm_decision.md`
50
+
51
+ Identifique a transição de paradigma (se houver). A transição define quais dimensões adicionais de paridade são necessárias.
52
+
53
+ ### 2. Definir estratégia geral em `parity_specs.md`
54
+
55
+ Selecione e marque os modos de validação aplicáveis:
56
+
57
+ - Shadow mode (espelhamento de tráfego com comparação assíncrona).
58
+ - Characterization tests (suíte derivada do comportamento atual do legado).
59
+ - Contract tests (interfaces externas).
60
+ - Data parity (snapshots e checksums).
61
+
62
+ Critérios de "paridade aceita" obrigatórios:
63
+
64
+ - Métrica primária (ex: índice de divergência funcional < 0,01% em 30 dias).
65
+ - Janela de observação.
66
+ - Critério de bloqueio do cutover.
67
+
68
+ ### 2b. Incorporar paridade de telas
69
+
70
+ Se `_reversa_sdd/migration/screen_modernization_decision.md` existe e não está em `skipped`:
71
+
72
+ - Em modo **literal**: adicione modo de validação **golden file comparison** à `parity_specs.md`. Para cada tela com entrada em `_reversa_sdd/screens/golden/manifest.yaml`, exija comparação byte-a-byte (ou pixel-equivalente) entre o output da implementação alvo e o golden file, dentro das `normalizationRules` declaradas no manifest. Crie um cenário Gherkin por tela em `parity_tests/screens/<NN>-<tela>.feature` com tag `@paridade-visual`.
73
+ - Em modo **modernizado**: adicione modo de validação **contract test de tela**. Para cada tela em `target_screens.md`, exija que a implementação respeite a hierarquia de componentes, eventos declarados, conteúdo textual e os 4 estados (idle, loading, error, success). Não há comparação byte-a-byte.
74
+ - Em modo **híbrido**: aplique cada estratégia conforme o modo declarado da tela em `screen_modernization_decision.md`.
75
+ - Em status `skipped` (legado sem UI): pule esta seção; nenhum cenário de paridade visual é gerado.
76
+
77
+ Toda deviation aprovada em `_reversa_sdd/migration/screen_deviation_log.md` deve ser propagada para `parity_specs.md § Exceções`, com referência ao `DEV-XXX` original. Deviations pendentes bloquearam o handoff e não chegam aqui.
78
+
79
+ ### 3. Adaptar cobertura ao paradigma alvo
80
+
81
+ Use a tabela abaixo para definir cobertura mínima:
82
+
83
+ | Transição | Dimensões adicionais obrigatórias |
84
+ |---|---|
85
+ | sem mudança | equivalência funcional padrão (mesma entrada → mesma saída) |
86
+ | síncrono → event-driven | ordem de mensagens, idempotência, consistência eventual, comportamento sob falha de fila |
87
+ | procedural → OO | invariantes em aggregates, validação em factories / construtores |
88
+ | OO → funcional | imutabilidade, ausência de side effects esperados, equivalência sob composição |
89
+ | OO clássico → OO com DI | comportamento equivalente sem dependência de Active Record, mocks de repositório |
90
+ | qualquer → actor model | isolamento de estado, supervisão e recuperação após falha |
91
+
92
+ Documente a cobertura adaptada na seção "Cobertura adaptada ao paradigma" de `parity_specs.md`.
93
+
94
+ ### 4. Identificar fluxos críticos
95
+
96
+ Liste fluxos que precisam de cobertura Gherkin:
97
+
98
+ - Fluxos cobertos por `characterization_specs/` (se existir): adaptar.
99
+ - Fluxos críticos identificados em `code-analysis.md` ou `sequences/`.
100
+ - Fluxos derivados de regras `BR-MIGRAR-XXX` marcadas como críticas.
101
+
102
+ Para cada fluxo, gere um arquivo `parity_tests/<NN>-<nome-curto>.feature` usando o template em `references/templates/parity_test.feature`.
103
+
104
+ Cada `.feature` deve:
105
+
106
+ - Conter front-matter de comentário com `spec-id`, rastreabilidade ao `process_flows`, ao `target_architecture` e ao paradigma alvo.
107
+ - Cobrir cenário positivo, edge case relevante, e (quando paradigma exigir) cenários de idempotência e ordem.
108
+ - Usar tags consistentes (`@paridade`, `@critico`, `@idempotencia`, `@ordem`, `@regulatorio` quando aplicável).
109
+ - Estar em **Gherkin válido** (Funcionalidade / Cenário / Dado / Quando / Então).
110
+
111
+ ### 5. Reusar characterization_specs
112
+
113
+ Se `_reversa_sdd/characterization_specs/` existir, leia e reuse como base. Adapte:
114
+
115
+ - Entradas / saídas para o sistema novo.
116
+ - Critérios de aceitação ao paradigma alvo.
117
+ - Mantenha rastreabilidade explícita ao spec original.
118
+
119
+ ### 6. Resumir e devolver controle
120
+
121
+ > "Inspector concluiu.
122
+ > - Estratégia de paridade: <modos selecionados>
123
+ > - Critério de paridade aceita: <métrica primária>
124
+ > - Fluxos cobertos: <N> arquivos `.feature`
125
+ > - Cobertura adaptada ao paradigma: <transição detectada>
126
+ >
127
+ > Pipeline de migração concluído. Próximo passo: orquestrador gera `handoff.md`."
128
+
129
+ ## Casos de borda
130
+
131
+ - **Sem `characterization_specs/`**: derivar cenários a partir de `code-analysis.md` e `sequences/`. Sinalizar lacuna em `parity_specs.md`.
132
+ - **Paradigma alvo é o mesmo do legado**: `parity_specs.md` usa equivalência funcional padrão sem dimensões adicionais.
133
+ - **Paradigma alvo event-driven com fluxos do legado puramente síncronos**: cada fluxo gera ao menos 3 cenários (`@paridade`, `@idempotencia`, `@ordem`).
134
+ - **Estratégia Parallel Run**: detalhar em `parity_specs.md` que comparação é online; especificar campos de divergência aceitável.
135
+ - **Screen Translator em modo skipped**: ignorar paridade visual; não criar cenários `@paridade-visual`; mencionar em `parity_specs.md` que o sistema não tem UI.
136
+ - **Modo literal sem golden files capturados** (`manifest.yaml` lista todas as entradas com `present: false`): emitir cenários `@paridade-visual` mesmo assim, mas declarar em `parity_specs.md` que a validação será manual até a captura ser executada.
137
+
138
+ ## Layout de saída (transversal)
139
+
140
+ 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.
141
+
142
+ ## Regras absolutas
143
+
144
+ - Não escrever fora de `_reversa_sdd/migration/`.
145
+ - Arquivos `.feature` são **specs**, não testes executáveis. Não introduza chamadas a frameworks.
146
+ - Cada cenário tem rastreabilidade explícita à origem (process_flows, target_architecture).
147
+ - Cobertura adaptada ao paradigma é **obrigatória** quando há mudança de paradigma; não pode ser equivalência funcional ingênua.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Inspector"
3
+ short_description: "Quinto agente do Time de Migração"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,54 @@
1
+ # Matriz de cobertura de paridade
2
+
3
+ Tabela de referência para definir o conjunto mínimo de cenários `.feature` por fluxo, conforme transição de paradigma.
4
+
5
+ ## Cobertura por transição
6
+
7
+ | Transição | Cenários mínimos por fluxo |
8
+ |---|---|
9
+ | sem mudança | `@paridade` (entrada → saída esperada) |
10
+ | procedural → OO | `@paridade` + `@invariante` (invariante de aggregate validado) |
11
+ | procedural → event-driven | `@paridade` + `@idempotencia` + `@ordem` + `@dlq` (comportamento sob falha de fila) |
12
+ | OO clássico → OO com DI | `@paridade` + `@composicao` (sem dependência de Active Record) |
13
+ | OO clássico → event-driven | `@paridade` + `@idempotencia` + `@ordem` + `@saga` (compensação ao falhar) |
14
+ | OO clássico → funcional | `@paridade` + `@imutabilidade` + `@composicao` |
15
+ | OO com DI → event-driven | `@paridade` + `@idempotencia` + `@ordem` |
16
+ | funcional → event-driven | `@paridade` + `@idempotencia` + `@ordem` |
17
+ | qualquer → actor model | `@paridade` + `@supervisao` (recuperação após falha) |
18
+
19
+ ## Tags convencionadas
20
+
21
+ - `@paridade`: sempre presente; equivalência principal.
22
+ - `@critico`: fluxo crítico (regulatório, financeiro, dados sensíveis).
23
+ - `@regulatorio`: quando há requisito formal externo.
24
+ - `@idempotencia`: reprocessamento não duplica efeito.
25
+ - `@ordem`: ordem por chave respeitada.
26
+ - `@dlq`: comportamento ao chegar em dead letter queue.
27
+ - `@saga`: compensação em transação distribuída.
28
+ - `@invariante`: invariante de aggregate validado.
29
+ - `@composicao`: comportamento equivalente sob composição funcional.
30
+ - `@imutabilidade`: não há mutação compartilhada.
31
+ - `@supervisao`: supervisor recupera ator falhado.
32
+
33
+ ## Critérios de "paridade aceita" típicos
34
+
35
+ | Tipo de sistema | Métrica primária |
36
+ |---|---|
37
+ | Web app sem regulação forte | divergência funcional < 1% por 7 dias |
38
+ | API pública | divergência funcional < 0,1% por 30 dias + zero divergência em contratos públicos |
39
+ | Sistema fiscal / regulatório | divergência funcional < 0,01% por 60 dias + zero divergência em campos regulados |
40
+ | Sistema financeiro | divergência financeira por valor monetário < 0,001% + zero divergência em totalizadores |
41
+ | Sistema interno baixa criticidade | divergência funcional < 5% por 7 dias |
42
+
43
+ ## Reuso de characterization_specs
44
+
45
+ Quando `_reversa_sdd/characterization_specs/` existe:
46
+
47
+ 1. Para cada spec → derivar `.feature` correspondente, adaptando entradas/saídas ao sistema novo.
48
+ 2. Manter o `spec-id` original na rastreabilidade.
49
+ 3. Adicionar cenários extras conforme a tabela "Cenários mínimos por fluxo".
50
+
51
+ Quando não existe:
52
+
53
+ 1. Inferir fluxos críticos a partir de `code-analysis.md` + `sequences/` + regras `BR-MIGRAR` marcadas como críticas.
54
+ 2. Documentar lacuna em `parity_specs.md § Reuso de characterization_specs`.
@@ -0,0 +1,64 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: parity_specs
7
+ producedBy: inspector
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Parity Specs
12
+
13
+ > Estratégia de validação de equivalência comportamental entre legado e sistema novo, adaptada ao paradigma escolhido em `paradigm_decision.md`.
14
+
15
+ ## Estratégia geral
16
+ - **Modos de validação aplicáveis** (marcar os usados):
17
+ - [ ] Shadow mode (espelhamento de tráfego com comparação assíncrona)
18
+ - [ ] Characterization tests (suíte derivada do comportamento atual do legado)
19
+ - [ ] Contract tests (interfaces externas)
20
+ - [ ] Data parity (snapshots e checksums)
21
+ - [ ] Outro: <especificar>
22
+
23
+ ## Critérios de "paridade aceita"
24
+ - **Métrica primária**: <ex: índice de divergência funcional < 0,01% em N dias consecutivos>
25
+ - **Janela de observação**: <período de avaliação>
26
+ - **Critério de bloqueio**: <quando paridade insuficiente bloqueia o cutover>
27
+
28
+ ## Cobertura adaptada ao paradigma
29
+
30
+ > Esta seção muda conforme o paradigma alvo confirmado em `paradigm_decision.md`.
31
+
32
+ ### Sem mudança de paradigma
33
+ - Equivalência funcional padrão: mesma entrada → mesma saída → mesmo efeito colateral observável.
34
+
35
+ ### Mudança síncrono → event-driven
36
+ - **Ordem de mensagens**: <critério de aceitação por canal / partição>
37
+ - **Idempotência**: <prova de que reprocessamento não duplica efeito>
38
+ - **Consistência eventual**: <janela máxima de propagação aceita>
39
+ - **Comportamento sob falha de fila**: <retry, DLQ, replay>
40
+
41
+ ### Mudança procedural → OO
42
+ - **Invariantes em aggregates**: <conjunto a validar>
43
+ - **Validação em factories / construtores**: <casos críticos>
44
+
45
+ ### Mudança OO → funcional
46
+ - **Imutabilidade**: <pontos críticos a observar>
47
+ - **Ausência de side effects esperados**: <onde o legado tinha efeito colateral implícito>
48
+ - **Equivalência sob composição**: <funções compostas equivalem ao fluxo legado>
49
+
50
+ ## Tipos de teste a aplicar
51
+ - **Funcionais**: <descrição, ferramenta>
52
+ - **Contrato**: <descrição, ferramenta>
53
+ - **Carga / performance**: <descrição, alvos>
54
+ - **Resiliência** (se aplicável): <falha de fila, dependência externa indisponível>
55
+
56
+ ## Reuso de characterization_specs do time de descoberta
57
+ - **Origem**: `_reversa_sdd/characterization_specs/` ou equivalente disponível.
58
+ - **Adaptações necessárias para o sistema novo**: <texto>
59
+
60
+ ## Saídas
61
+ - `parity_tests/*.feature`: cenários em Gherkin para os fluxos críticos.
62
+
63
+ ## Notas
64
+ <Observações adicionais.>
@@ -0,0 +1,40 @@
1
+ # Template de cenário Gherkin para parity_tests/.
2
+ # Cada arquivo deve cobrir um fluxo crítico identificado em process_flows do legado.
3
+ # Adaptar critérios ao paradigma alvo conforme `parity_specs.md`.
4
+
5
+ # language: pt
6
+ # spec-id: PT-001
7
+ # rastreabilidade:
8
+ # process_flows: <ref ao fluxo no _reversa_sdd>
9
+ # target_architecture: <ref a componente no target_architecture.md>
10
+ # paradigma_alvo: <do paradigm_decision.md>
11
+
12
+ Funcionalidade: <Nome do fluxo>
13
+ Como <ator>
14
+ Quero <ação>
15
+ Para <objetivo>
16
+
17
+ # Critério geral de paridade aplicado a este cenário.
18
+ # Quando o paradigma alvo é event-driven, expressar tolerância de consistência eventual aqui.
19
+ @paridade @critico
20
+ Cenário: <descrição>
21
+ Dado <pré-condição observável>
22
+ E <pré-condição secundária>
23
+ Quando <ação executada via API / comando / evento de entrada>
24
+ Então <efeito observável no sistema novo>
25
+ E <efeito observável persiste após <janela de propagação>>
26
+
27
+ # Cenário específico para validar idempotência (event-driven, retry seguro).
28
+ @paridade @idempotencia
29
+ Cenário: Reprocessamento não duplica efeito
30
+ Dado <pré-condição>
31
+ Quando <ação> é processada uma vez
32
+ E <ação> é reentregue por retry
33
+ Então o efeito observável é idêntico ao da primeira entrega
34
+
35
+ # Cenário específico para validar ordem em paradigma event-driven.
36
+ @paridade @ordem
37
+ Cenário: Ordem de eventos é respeitada por chave
38
+ Dado <chave de particionamento>
39
+ Quando <evento A> é publicado antes de <evento B> com a mesma chave
40
+ Então <efeito observável> reflete a ordem A → B