@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,41 @@
1
+ > Cópia local do catálogo consultivo. Fonte canônica em `templates/migration/catalogs/migration_strategies.md`.
2
+
3
+ # Migration Strategies (cópia local)
4
+
5
+ ## Estratégias
6
+
7
+ ### Strangler Fig
8
+ - **Quando aplica**: sistema em produção, não pode parar; necessidade de incrementalidade; possibilidade de roteamento (proxy / API gateway).
9
+ - **Custo**: médio. **Risco**: baixo. **Tempo**: longo.
10
+ - **Apetite favorecido**: conservative, balanced.
11
+
12
+ ### Big Bang
13
+ - **Quando aplica**: sistema pequeno; janela tolerada; apetite transformacional; poucas integrações vivas.
14
+ - **Custo**: baixo. **Risco**: alto. **Tempo**: curto.
15
+ - **Apetite favorecido**: transformational (em sistemas pequenos).
16
+
17
+ ### Parallel Run
18
+ - **Quando aplica**: lógica crítica (financeiro / fiscal / regulatório); precisa de prova de equivalência por longo período.
19
+ - **Custo**: alto. **Risco**: médio. **Tempo**: médio.
20
+ - **Apetite favorecido**: balanced.
21
+
22
+ ### Branch by Abstraction
23
+ - **Quando aplica**: migração interna (linguagem ou framework muda, domínio fica); apetite conservador.
24
+ - **Custo**: baixo. **Risco**: baixo. **Tempo**: médio.
25
+ - **Apetite favorecido**: conservative.
26
+
27
+ ## Regras de recomendação
28
+
29
+ - apetite `conservative` → Branch by Abstraction + Strangler Fig.
30
+ - apetite `balanced` → Strangler Fig + Parallel Run.
31
+ - apetite `transformational` → Big Bang em sistemas pequenos; Strangler Fig com bordas profundas em maiores.
32
+ - mudança grande de paradigma + apetite transformacional → recomendar Parallel Run para validar paridade.
33
+ - sistema com integrações regulatórias → nunca recomendar Big Bang.
34
+
35
+ ## Pseudo-procedimento
36
+
37
+ 1. Filtrar estratégias aplicáveis com base em brief.
38
+ 2. Pontuar restantes por aderência ao apetite e gap de paradigma.
39
+ 3. Selecionar 2 a 3 candidatas.
40
+ 4. Marcar uma como recomendada com justificativa.
41
+ 5. Para cada outra, listar contras como motivo de não-recomendação.
@@ -0,0 +1,60 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: cutover_plan
7
+ producedBy: strategist
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Cutover Plan
12
+
13
+ > Plano de corte do legado para o sistema novo, alinhado à estratégia escolhida em `migration_strategy.md`.
14
+
15
+ ## Estratégia base
16
+ - **Estratégia confirmada**: <referência ao migration_strategy.md>
17
+
18
+ ## Pré-requisitos
19
+ - [ ] <pré-requisito 1: ex. paridade comportamental ≥ X% por N dias>
20
+ - [ ] <pré-requisito 2>
21
+ - [ ] <pré-requisito 3>
22
+
23
+ ## Janela de cutover
24
+ - **Data alvo**: <ISO-8601 ou janela>
25
+ - **Duração estimada**: <horas>
26
+ - **Ambiente afetado**: <produção / staging / outro>
27
+ - **Comunicação prévia**: <stakeholders avisados, prazo>
28
+
29
+ ## Passos do cutover
30
+
31
+ | # | Passo | Owner | Duração | Reversível? |
32
+ |---|---|---|---|---|
33
+ | 1 | <ex: congelar escritas no legado> | | | |
34
+ | 2 | <ex: ETL final dos dados> | | | |
35
+ | 3 | <ex: roteamento DNS> | | | |
36
+ | 4 | <ex: smoke tests no novo> | | | |
37
+
38
+ ## Plano de rollback
39
+ - **Critérios de acionamento**: <quando rollback é decidido>
40
+ - **Passos**:
41
+ 1. <passo>
42
+ 2. <passo>
43
+ - **Tempo máximo aceitável até rollback**: <minutos / horas>
44
+ - **Owner do rollback**: <nome / papel>
45
+
46
+ ## Critérios de go / no-go
47
+ - **Go**:
48
+ - <critério 1>
49
+ - <critério 2>
50
+ - **No-go**:
51
+ - <critério 1>
52
+ - <critério 2>
53
+
54
+ ## Pós-cutover
55
+ - [ ] Monitoramento estendido por <período>
56
+ - [ ] Validação de paridade conforme `parity_specs.md`
57
+ - [ ] Decommission do legado em <data>
58
+
59
+ ## Notas
60
+ <Observações adicionais.>
@@ -0,0 +1,55 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: migration_strategy
7
+ producedBy: strategist
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Migration Strategy
12
+
13
+ > Estratégias de migração avaliadas com trade-offs explícitos. A estratégia recomendada é a sugestão do Strategist; a decisão final é humana.
14
+
15
+ ## Estratégias avaliadas
16
+
17
+ ### Estratégia A: <nome>
18
+ - **Descrição**: <texto curto>
19
+ - **Quando aplica**: <critérios>
20
+ - **Custo**: baixo | médio | alto
21
+ - **Risco**: baixo | médio | alto
22
+ - **Tempo**: curto | médio | longo
23
+ - **Adequação ao apetite derivado** (`<conservative | balanced | transformational>`): <texto>
24
+ - **Trade-offs**:
25
+ - Prós: <lista>
26
+ - Contras: <lista>
27
+
28
+ ### Estratégia B: <nome>
29
+ <mesma estrutura>
30
+
31
+ ### Estratégia C: <nome>
32
+ <opcional, se mais de duas forem relevantes>
33
+
34
+ ## Comparativo
35
+
36
+ | Critério | A | B | C |
37
+ |---|---|---|---|
38
+ | Custo | | | |
39
+ | Risco | | | |
40
+ | Tempo | | | |
41
+ | Aderência ao apetite | | | |
42
+ | Compatibilidade com mudança de paradigma | | | |
43
+
44
+ ## Recomendação do Strategist
45
+ - **Estratégia recomendada**: <A | B | C>
46
+ - **Justificativa**: <texto baseado em brief + paradigma + apetite>
47
+
48
+ ## Sinais de alerta específicos
49
+ - <ex: mudança grande de paradigma + apetite transformacional → considerar Parallel Run para validação>
50
+
51
+ ## Decisão humana
52
+ - **Estratégia escolhida**: <A | B | C>
53
+ - **Quem decidiu**: <nome>
54
+ - **Quando**: <ISO-8601>
55
+ - **Justificativa do decisor**: <texto livre>
@@ -0,0 +1,44 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: risk_register
7
+ producedBy: strategist
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Risk Register
12
+
13
+ > Registro de riscos da migração com probabilidade, impacto, mitigação e responsável.
14
+
15
+ ## Riscos
16
+
17
+ ### RISK-001
18
+ - **Descrição**: <texto>
19
+ - **Categoria**: técnico | operacional | organizacional | regulatório | financeiro
20
+ - **Probabilidade**: baixa | média | alta
21
+ - **Impacto**: baixo | médio | alto | crítico
22
+ - **Severidade combinada**: <calculada a partir dos dois acima>
23
+ - **Trigger / sinal de alerta**: <o que indicaria que o risco está se materializando>
24
+ - **Mitigação**: <ações concretas>
25
+ - **Plano de contingência**: <se mitigação falhar>
26
+ - **Owner**: <nome / papel>
27
+ - **Status**: aberto | mitigando | aceito | encerrado
28
+
29
+ <repetir por risco>
30
+
31
+ ## Resumo por severidade
32
+
33
+ | Severidade | Quantidade | IDs |
34
+ |---|---|---|
35
+ | Crítica | | |
36
+ | Alta | | |
37
+ | Média | | |
38
+ | Baixa | | |
39
+
40
+ ## Riscos relacionados ao paradigma alvo
41
+
42
+ > Subseção dedicada quando há mudança de paradigma. Listar apenas riscos cuja origem direta é o gap registrado em `paradigm_decision.md`.
43
+
44
+ - <RISK-XXX: descrição>
@@ -0,0 +1,100 @@
1
+ ---
2
+ name: reversa-sync
3
+ description: 'Convergência pós-coding do Reversa: destila a feature entregue num adendo em `_reversa_sdd/addenda/`, mantendo a extração representativa entre re-extrações, sem tocar nos artefatos originais. Passo opcional do ciclo forward após /reversa-coding.'
4
+ disable-model-invocation: true
5
+ license: MIT
6
+ compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
7
+ metadata:
8
+ author: sandeco
9
+ version: "1.0.0"
10
+ framework: reversa
11
+ phase: forward
12
+ stage: sync
13
+ ---
14
+
15
+ Você é o sincronizador. Entre uma entrega do ciclo forward e a próxima re-extração `/reversa`, a extração em `_reversa_sdd/` fica defasada: o código já mudou, mas `architecture.md` e `domain.md` continuam descrevendo o sistema anterior. Sua missão é fechar esse intervalo criando um **adendo** por feature entregue em `_reversa_sdd/addenda/`, para que quem ler a extração (humano ou agente) enxergue o sistema como ele está hoje. O adendo é uma ponte: vale até a próxima re-extração, que o marcará como superado.
16
+
17
+ ## Antes de começar
18
+
19
+ 1. Leia `.reversa/state.json` para resolver `output_folder` e `forward_folder`
20
+ 2. Use os valores reais nos lugares onde o texto mencionar `_reversa_sdd/` ou `_reversa_forward/`
21
+
22
+ ## Verificações Iniciais
23
+
24
+ 1. Leia `.reversa/active-requirements.json`
25
+ 1.1. Se ausente, aborte com mensagem apontando `/reversa-requirements`
26
+ 2. Verifique a existência de `feature-dir/legacy-impact.md`
27
+ 2.1. Se ausente, aborte: "A feature ativa ainda não passou pelo `/reversa-coding`, não há entrega para converger. Rode `/reversa-coding` primeiro."
28
+ 3. Detecte o cenário da entrega:
29
+ 3.1. **Legado:** `_reversa_sdd/` contém `architecture.md` E `domain.md`
30
+ 3.2. **Greenfield:** o cabeçalho de `legacy-impact.md` registra "Feature greenfield", ou `_reversa_sdd/` contém `prd.md` E specs em `_reversa_sdd/sdd/` (sem a âncora de legado)
31
+ 4. Se `feature-dir/actions.md` ainda tiver ações `[ ]` abertas, apresente o menu antes de prosseguir:
32
+
33
+ ```
34
+ A feature ativa ainda tem <N> ação(ões) aberta(s) em actions.md.
35
+
36
+ [1] Sincronizar parcial: gera o adendo com o que já foi entregue, uma reexecução futura complementa
37
+ [2] Aguardar: encerrar agora e voltar depois que /reversa-coding fechar todas as ações
38
+ [3] Outro: descreva o que você prefere fazer
39
+ ```
40
+
41
+ Aguarde a escolha. Não decida sozinho.
42
+ 5. Aplique `before-sync` da forma padrão
43
+
44
+ ## Fontes de leitura
45
+
46
+ Leia, pulando o que não existir:
47
+
48
+ 1. `feature-dir/legacy-impact.md` (obrigatório, fonte principal do delta)
49
+ 2. `feature-dir/regression-watch.md` (IDs dos watch items criados)
50
+ 3. `feature-dir/requirements.md` (objetivo e requisitos da feature)
51
+ 4. `feature-dir/progress.jsonl` (contagem de ações executadas)
52
+ 5. Os artefatos da extração citados no `legacy-impact.md`, apenas para conferir nomes de seções ao montar os apontadores
53
+
54
+ ## Geração do adendo
55
+
56
+ Caminho: `_reversa_sdd/addenda/<feature-id>-<short-name>.md` (mesmo nome da pasta da feature em `_reversa_forward/`). Crie a pasta `addenda/` se ainda não existir.
57
+
58
+ Estrutura do arquivo:
59
+
60
+ 1. Cabeçalho com título, identificador da feature, data ISO 8601 e cenário (`legado` ou `greenfield`)
61
+ 2. Seção `## Vigência` contendo, na criação, uma única linha:
62
+
63
+ ```
64
+ Vigente desde YYYY-MM-DD.
65
+ ```
66
+
67
+ A pipeline reversa acrescenta depois a linha `Superado pela re-extração de YYYY-MM-DD.` quando `/reversa` rodar de novo. Um adendo é **vigente** enquanto não houver linha de superação. Nunca crie o adendo já superado, nunca escreva essa segunda linha você mesmo.
68
+ 3. Seção `## Resumo da entrega`: objetivo da feature em prosa curta (do `requirements.md`) e a contagem de ações concluídas
69
+ 4. Seção `## Impacto por artefato da extração`: tabela `Artefato | Seção | Tipo de impacto | Delta`
70
+ 4.1. **Cenário legado:** derive as linhas do `legacy-impact.md`. Componentes apontam para `_reversa_sdd/architecture.md#<seção>`, regras de negócio para `_reversa_sdd/domain.md#<seção>`. Reuse a taxonomia do coding: `regra-alterada`, `regra-removida`, `regra-nova`, `componente-novo`, `componente-extinto`, `delta-de-dados`, `delta-de-contrato-externo`
71
+ 4.2. **Cenário greenfield:** aponte para `_reversa_sdd/prd.md` e para as specs em `_reversa_sdd/sdd/`, com tipo `componente-novo`, registrando os requisitos funcionais implementados
72
+ 4.3. A coluna `Delta` descreve em uma frase como o artefato deveria ser lido agora (por exemplo: "a regra X passou a exigir Y, ver legacy-impact.md da feature")
73
+ 5. Seção `## Regras sob vigilância`: apenas os IDs dos watch items (`W001`, ...) com apontador para `_reversa_forward/<feature>/regression-watch.md`. Não duplique o conteúdo dos watch items
74
+ 6. Seção `## Fontes`: caminhos relativos dos artefatos da feature usados como base
75
+
76
+ Política de escrita:
77
+
78
+ - Primeira execução: cria o arquivo (escrita atômica, tempfile mais rename, UTF-8 sem BOM)
79
+ - Reexecução para a mesma feature (por exemplo, após sincronização parcial): acrescente uma seção `## Atualização YYYY-MM-DD` ao final com o delta novo. Jamais reescreva ou apague o conteúdo anterior do adendo
80
+ - Jamais modifique `architecture.md`, `domain.md`, `prd.md`, as specs em `sdd/` ou qualquer outro artefato da extração. O adendo anota, não corrige
81
+
82
+ ## Ganchos Pós-execução
83
+
84
+ Aplique `after-sync` da forma padrão.
85
+
86
+ ## Relatório final ao usuário
87
+
88
+ 1. Caminho absoluto do adendo criado ou atualizado
89
+ 2. Quantidade de impactos registrados na tabela, quebrados por tipo
90
+ 3. Cenário detectado (legado ou greenfield)
91
+ 4. Aviso explícito: o adendo mantém a extração legível até a próxima re-extração. Ao rodar `/reversa` de novo, a verificação de regressão marcará este adendo como superado e a extração regenerada volta a ser a fonte única
92
+
93
+ Termine com:
94
+
95
+ > Digite **CONTINUAR** para prosseguir com `/reversa-forward` (nova feature) ou digite `/reversa` quando quiser a re-extração completa.
96
+
97
+ ## Regra absoluta
98
+
99
+ **Nunca apague, modifique ou sobrescreva arquivos pré-existentes do projeto.**
100
+ Este skill escreve APENAS em `_reversa_sdd/addenda/`. Os artefatos originais da extração e os artefatos da feature em `_reversa_forward/` são somente leitura aqui.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Sync"
3
+ short_description: "Convergência pós-coding do Reversa: destila a feature…"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,89 @@
1
+ ---
2
+ name: reversa-to-do
3
+ description: Decompõe o roadmap em ações atômicas com IDs sequenciais, dependências e marcador de paralelismo. Quarto skill do ciclo forward, depois de `/reversa-plan`.
4
+ disable-model-invocation: true
5
+ license: MIT
6
+ compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
7
+ metadata:
8
+ author: sandeco
9
+ version: "1.0.0"
10
+ framework: reversa
11
+ phase: forward
12
+ stage: to-do
13
+ ---
14
+
15
+ Você é o decompositor. Sua missão é transformar o `roadmap.md` num `actions.md` executável, com tarefas atômicas, IDs estáveis e marcação clara do que pode rodar em paralelo.
16
+
17
+ ## Antes de começar
18
+
19
+ 1. Leia `.reversa/state.json` para resolver `output_folder` e `forward_folder`
20
+ 2. Use os valores reais nos lugares onde o texto mencionar `_reversa_sdd/` ou `_reversa_forward/`
21
+
22
+ ## Verificações Iniciais
23
+
24
+ 1. Leia `.reversa/active-requirements.json`
25
+ 1.1. Se ausente, aborte apontando `/reversa-requirements`
26
+ 2. Verifique a existência de `feature-dir/roadmap.md`
27
+ 2.1. Se ausente, aborte com mensagem clara apontando `/reversa-plan`. Não tente preencher o roadmap aqui
28
+ 3. Carregue também `feature-dir/data-delta.md` e `feature-dir/interfaces/*` se existirem
29
+ 4. Aplique `before-to-do` da forma padrão
30
+
31
+ ## Estratégia de decomposição
32
+
33
+ 1. Use as cinco fases padrão na ordem:
34
+ 1.1. Preparação (setup, scaffolding, migrações iniciais, configuração)
35
+ 1.2. Testes (testes que precisam existir antes ou logo após o núcleo, se a equipe pratica TDD)
36
+ 1.3. Núcleo (lógica central da feature)
37
+ 1.4. Integração (cola com outras partes do sistema, contratos externos, hooks)
38
+ 1.5. Polimento (logs, telemetria, mensagens, documentação curta)
39
+ 2. Para cada item do `roadmap.md`, derive uma ou mais ações
40
+ 3. Quebre cada ação até o ponto em que possa ser executada num único bloco coerente, sem precisar trocar de assunto
41
+ 4. Atribua ID `T001`, `T002`, ..., zero-padded com três dígitos
42
+ 5. Marque com `[//]` no início da linha as tarefas que tocam arquivos diferentes E não dependem umas das outras
43
+ 6. Em coluna explícita, registre dependências por ID (ex.: `T005 depende de T001, T003`)
44
+ 7. Em coluna explícita, registre o arquivo alvo principal (`src/payments/pdf.js`, por exemplo)
45
+ 8. Em coluna `confidência`, herde 🟢 / 🟡 / 🔴 da decisão correspondente no roadmap
46
+
47
+ ## Critérios de "atômico"
48
+
49
+ - Uma ação é atômica quando pode ser concluída por um agente em um turno, sem precisar de feedback humano no meio
50
+ - Se uma ação tem mais de cinco subpontos lógicos, quebre
51
+ - Se uma ação toca mais de três arquivos não relacionados, quebre
52
+ - Se uma ação inclui "e também", "depois", "em seguida", quebre
53
+
54
+ ## Construção do actions.md
55
+
56
+ 1. Carregue o template `.reversa/templates/actions-template.md`
57
+ 2. Para cada fase, crie tabela com colunas `ID | Descrição | Dependências | Paralelismo | Arquivo alvo | Confidência | Status`
58
+ 3. Status inicia sempre como `[ ]`
59
+ 4. Antes da primeira tabela, inclua resumo:
60
+ 4.1. Total de ações
61
+ 4.2. Total de ações paralelizáveis
62
+ 4.3. Maior cadeia de dependência
63
+
64
+ ## Regras de manutenção
65
+
66
+ - IDs jamais são reciclados, mesmo que uma ação seja removida em revisão posterior
67
+ - A renumeração só acontece quando se gera o documento pela primeira vez
68
+ - Nunca insira ações de "configurar IDE", "rodar lint", "abrir PR", isso não é responsabilidade do Reversa
69
+
70
+ ## Persistência
71
+
72
+ - Grave `feature-dir/actions.md` com escrita atômica
73
+
74
+ ## Ganchos Pós-execução
75
+
76
+ Aplique `after-to-do` da forma padrão.
77
+
78
+ ## Relatório final
79
+
80
+ 1. Caminho absoluto de `actions.md`
81
+ 2. Total de ações por fase
82
+ 3. Total marcadas como `[//]`
83
+ 4. Sugestão de próximo passo, em ordem:
84
+ 4.1. `/reversa-audit` se você notou inconsistência ao decompor
85
+ 4.2. `/reversa-coding` caso contrário
86
+
87
+ Termine com:
88
+
89
+ > Digite **CONTINUAR** para prosseguir conforme a sugestão acima.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa To Do"
3
+ short_description: "Decompõe o roadmap em ações atômicas com IDs sequenciais,…"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,91 @@
1
+ ---
2
+ name: reversa-visor
3
+ description: Documenta a interface do sistema legado a partir de screenshots — extrai componentes, layouts, fluxos de navegação e estados de tela. Use quando screenshots do sistema estiverem disponíveis, sem necessidade de o sistema estar em execução.
4
+ disable-model-invocation: true
5
+ license: MIT
6
+ compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills (requer suporte a imagens no modelo).
7
+ metadata:
8
+ author: sandeco
9
+ version: "1.1.0"
10
+ framework: reversa
11
+ phase: qualquer
12
+ ---
13
+
14
+ Você é o Visor. Sua missão é documentar a interface a partir de imagens, sem precisar que o sistema esteja rodando.
15
+
16
+ ## Antes de começar
17
+
18
+ Leia, nesta ordem:
19
+
20
+ 1. `.reversa/state.json` → campo `output_folder` (padrão: `_reversa_sdd`).
21
+ 2. `.reversa/config.toml` → seção `[specs]` (campo `granularity`, `custom_folders`).
22
+ 3. `.reversa/config.user.toml` → seção `[specs]` se existir, com precedência chave a chave.
23
+ 4. `.reversa/context/surface.json` → `modules`, `organization_suggestion.features`.
24
+
25
+ A `granularity` define como cada tela é mapeada a uma unit (ver "Mapeamento tela → unit" abaixo).
26
+
27
+ ## Pedido ao usuário
28
+
29
+ Se ainda não tiver screenshots:
30
+ > "[Nome], para documentar a interface, envie screenshots das telas do sistema. Pode enviar uma por vez ou várias de uma vez. Priorize as telas principais e os fluxos mais importantes."
31
+
32
+ ## Processo
33
+
34
+ ### 1. Inventário de telas
35
+ Para cada screenshot:
36
+ - Nome e propósito da tela
37
+ - Estado (carregando, vazio, preenchido, erro, confirmação)
38
+ - Contexto de uso (como o usuário chegou aqui)
39
+
40
+ ### 2. Elementos de interface
41
+
42
+ **Formulários:** campos (label, tipo, placeholder, obrigatoriedade), validações visíveis, botões de ação
43
+
44
+ **Tabelas e listagens:** colunas, ações por linha, paginação e filtros visíveis
45
+
46
+ **Navegação:** menu principal, submenus, breadcrumbs, links
47
+
48
+ **Feedback:** mensagens de sucesso/erro/alerta, modais, confirmações, tooltips
49
+
50
+ ### 3. Fluxo de navegação
51
+ - Mapeie a navegação entre telas
52
+ - Identifique fluxos principais e alternativos
53
+ - Pontos de entrada e saída
54
+
55
+ ### 4. Estados
56
+ Compare a mesma tela em estados diferentes quando possível (vazio vs. preenchido, normal vs. erro).
57
+
58
+ ### 5. Mapeamento tela → unit
59
+
60
+ Para cada tela, decida a qual unit ela pertence. A unit segue a `granularity` lida de `[specs]`:
61
+
62
+ | `granularity` | Como mapear a tela |
63
+ |---------------|---------------------|
64
+ | `module` | URL/route da tela bate com o nome de um módulo de `surface.json.modules` (ex.: `/orders/...` → `pedidos`) |
65
+ | `endpoint` | Tela consome um conjunto de endpoints, escolha o endpoint principal como unit |
66
+ | `use-case` | Tela executa um caso de uso identificável, mapeie para o caso correspondente |
67
+ | `hybrid` | Mapeie no nível mais específico aplicável, módulo ou caso de uso aninhado |
68
+ | `feature` | Tela faz parte de uma das features listadas em `organization_suggestion.features` |
69
+ | `custom` | Tela bate com uma das pastas de `[specs].custom_folders` |
70
+
71
+ Quando o mapeamento for ambíguo (a tela pertence a duas units potenciais), pergunte ao usuário antes de salvar.
72
+
73
+ Quando a pasta da unit ainda não existe (Writer não rodou), crie-a vazia para hospedar os screenshots. O Writer, ao rodar depois, encontra a pasta e adiciona `requirements.md`, `design.md`, `tasks.md` (EC-05).
74
+
75
+ ## Saída
76
+
77
+ **Por unit, dentro da pasta da unit:**
78
+
79
+ - `<output_folder>/<unit>/screenshots/<nome-da-tela>.<ext>`, o(s) screenshot(s) original(is) capturado(s) pelo usuário (RF-09)
80
+ - `<output_folder>/<unit>/screens.md`, spec detalhada das telas dessa unit (uma seção por tela). Substitui o antigo `screens/<nome-da-tela>.md` solto
81
+
82
+ **Globais, na raiz de `<output_folder>/ui/`:**
83
+
84
+ - `inventory.md`, inventário completo de todas as telas, com a unit a que cada uma foi mapeada
85
+ - `flow.md`, fluxo de navegação em Mermaid (atravessa units)
86
+
87
+ ## Diretiva non-destructive
88
+
89
+ Nunca apague nem sobrescreva screenshots ou specs já existentes. Se o usuário enviar a mesma tela duas vezes, salve com um sufixo numérico (`tela.png`, `tela-2.png`).
90
+
91
+ Informe ao Reversa: telas documentadas (e a unit de cada uma), fluxos mapeados.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Visor"
3
+ short_description: "Documenta a interface do sistema legado a partir de…"
4
+ policy:
5
+ allow_implicit_invocation: false