@flaviogarrido/reversa 0.0.0-stage → 1.3.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (421) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +487 -2
  3. package/agents/fg-backlog/SKILL.md +129 -0
  4. package/agents/fg-backlog/agents/openai.yaml +5 -0
  5. package/agents/fg-backlog/references/backlog-template.md +60 -0
  6. package/agents/fg-backlog/references/priorizacao.md +41 -0
  7. package/agents/impeccable/LICENSE +191 -0
  8. package/agents/impeccable/NOTICE.md +11 -0
  9. package/agents/impeccable/SKILL.md +88 -0
  10. package/agents/impeccable/agents/impeccable_asset_producer.toml +47 -0
  11. package/agents/impeccable/agents/impeccable_documenter.toml +27 -0
  12. package/agents/impeccable/agents/impeccable_finish_reviewer.toml +41 -0
  13. package/agents/impeccable/agents/impeccable_manual_edit_applier.toml +95 -0
  14. package/agents/impeccable/agents/openai.yaml +4 -0
  15. package/agents/impeccable/reference/adapt.md +318 -0
  16. package/agents/impeccable/reference/adapt.native.md +58 -0
  17. package/agents/impeccable/reference/android.md +46 -0
  18. package/agents/impeccable/reference/animate.md +89 -0
  19. package/agents/impeccable/reference/audit.md +139 -0
  20. package/agents/impeccable/reference/audit.native.md +139 -0
  21. package/agents/impeccable/reference/bolder.md +33 -0
  22. package/agents/impeccable/reference/clarify.md +94 -0
  23. package/agents/impeccable/reference/colorize.md +86 -0
  24. package/agents/impeccable/reference/component-review.md +63 -0
  25. package/agents/impeccable/reference/craft-floor.md +44 -0
  26. package/agents/impeccable/reference/craft.md +5 -0
  27. package/agents/impeccable/reference/critique.md +819 -0
  28. package/agents/impeccable/reference/degraded/asset-producer.md +42 -0
  29. package/agents/impeccable/reference/degraded/documenter.md +24 -0
  30. package/agents/impeccable/reference/degraded/finish-reviewer.md +38 -0
  31. package/agents/impeccable/reference/degraded/manual-edit-applier.md +92 -0
  32. package/agents/impeccable/reference/delight.md +70 -0
  33. package/agents/impeccable/reference/distill.md +111 -0
  34. package/agents/impeccable/reference/doctor.md +54 -0
  35. package/agents/impeccable/reference/document.md +416 -0
  36. package/agents/impeccable/reference/extract.md +69 -0
  37. package/agents/impeccable/reference/generate.md +101 -0
  38. package/agents/impeccable/reference/harden.md +343 -0
  39. package/agents/impeccable/reference/hooks.md +113 -0
  40. package/agents/impeccable/reference/init.md +131 -0
  41. package/agents/impeccable/reference/ios.md +51 -0
  42. package/agents/impeccable/reference/layout.md +84 -0
  43. package/agents/impeccable/reference/live-setup.md +104 -0
  44. package/agents/impeccable/reference/live.md +325 -0
  45. package/agents/impeccable/reference/mode-operate.md +21 -0
  46. package/agents/impeccable/reference/mode-persuade.md +19 -0
  47. package/agents/impeccable/reference/mode-read.md +21 -0
  48. package/agents/impeccable/reference/new-work.md +154 -0
  49. package/agents/impeccable/reference/onboard.md +234 -0
  50. package/agents/impeccable/reference/operate.md +61 -0
  51. package/agents/impeccable/reference/optimize.md +258 -0
  52. package/agents/impeccable/reference/overdrive.md +127 -0
  53. package/agents/impeccable/reference/polish.md +105 -0
  54. package/agents/impeccable/reference/quieter.md +99 -0
  55. package/agents/impeccable/reference/region-map.md +26 -0
  56. package/agents/impeccable/reference/routing.md +24 -0
  57. package/agents/impeccable/reference/shape.md +59 -0
  58. package/agents/impeccable/reference/typeset.md +90 -0
  59. package/agents/impeccable/reference/visualize.md +47 -0
  60. package/agents/impeccable/reversa-bundle.json +16 -0
  61. package/agents/impeccable/scripts/VERSION +1 -0
  62. package/agents/impeccable/scripts/command-metadata.json +98 -0
  63. package/agents/impeccable/scripts/data/font-index-failures.json +121 -0
  64. package/agents/impeccable/scripts/data/font-index.json +1 -0
  65. package/agents/impeccable/scripts/impeccable +212 -0
  66. package/agents/impeccable/scripts/impeccable.cmd +239 -0
  67. package/agents/impeccable/scripts/live-browser-dom.js +320 -0
  68. package/agents/impeccable/scripts/live-browser-ignores.js +242 -0
  69. package/agents/impeccable/scripts/live-browser-session.js +180 -0
  70. package/agents/impeccable/scripts/live-browser.js +13557 -0
  71. package/agents/impeccable/scripts/modern-screenshot.umd.js +14 -0
  72. package/agents/reversa/SKILL.md +135 -0
  73. package/agents/reversa/agents/openai.yaml +3 -0
  74. package/agents/reversa/references/checkpoint-guide.md +106 -0
  75. package/agents/reversa/references/state-schema.md +80 -0
  76. package/agents/reversa/references/step-01-first-run.md +63 -0
  77. package/agents/reversa/references/step-02-resume.md +88 -0
  78. package/agents/reversa/references/step-03-specs-organization.md +145 -0
  79. package/agents/reversa/references/step-04-regression-check.md +94 -0
  80. package/agents/reversa-add/SKILL.md +131 -0
  81. package/agents/reversa-add/agents/openai.yaml +5 -0
  82. package/agents/reversa-agents-help/SKILL.md +211 -0
  83. package/agents/reversa-agents-help/agents/openai.yaml +3 -0
  84. package/agents/reversa-arbiter/SKILL.md +140 -0
  85. package/agents/reversa-arbiter/agents/openai.yaml +5 -0
  86. package/agents/reversa-archaeologist/SKILL.md +95 -0
  87. package/agents/reversa-archaeologist/agents/openai.yaml +5 -0
  88. package/agents/reversa-archaeologist/references/modules-schema.md +69 -0
  89. package/agents/reversa-architect/SKILL.md +93 -0
  90. package/agents/reversa-architect/agents/openai.yaml +5 -0
  91. package/agents/reversa-arquitetura-3d/SKILL.md +163 -0
  92. package/agents/reversa-arquitetura-3d/agents/openai.yaml +5 -0
  93. package/agents/reversa-arquitetura-3d/references/ARCH_TOUR.md +242 -0
  94. package/agents/reversa-arquitetura-3d/references/CALL_GRAPH_3D.md +217 -0
  95. package/agents/reversa-arquitetura-3d/references/CODE_CITY.md +228 -0
  96. package/agents/reversa-arquitetura-3d/references/DEPENDENCY_GRAPH_3D.md +240 -0
  97. package/agents/reversa-arquitetura-3d/references/ERRORS.md +286 -0
  98. package/agents/reversa-arquitetura-3d/references/LAYER_STACK.md +230 -0
  99. package/agents/reversa-arquitetura-3d/references/THREE_PATTERNS.md +221 -0
  100. package/agents/reversa-audit/SKILL.md +98 -0
  101. package/agents/reversa-audit/agents/openai.yaml +5 -0
  102. package/agents/reversa-autonomous/SKILL.md +139 -0
  103. package/agents/reversa-autonomous/agents/openai.yaml +3 -0
  104. package/agents/reversa-brainstorm/SKILL.md +131 -0
  105. package/agents/reversa-brainstorm/agents/openai.yaml +3 -0
  106. package/agents/reversa-challenger/SKILL.md +122 -0
  107. package/agents/reversa-challenger/agents/openai.yaml +5 -0
  108. package/agents/reversa-clarify/SKILL.md +103 -0
  109. package/agents/reversa-clarify/agents/openai.yaml +5 -0
  110. package/agents/reversa-code-express/SKILL.md +252 -0
  111. package/agents/reversa-code-express/agents/openai.yaml +5 -0
  112. package/agents/reversa-coding/SKILL.md +172 -0
  113. package/agents/reversa-coding/agents/openai.yaml +5 -0
  114. package/agents/reversa-curator/SKILL.md +133 -0
  115. package/agents/reversa-curator/agents/openai.yaml +5 -0
  116. package/agents/reversa-curator/references/decision-rubric.md +52 -0
  117. package/agents/reversa-curator/references/templates/discard_log.md +37 -0
  118. package/agents/reversa-curator/references/templates/target_business_rules.md +54 -0
  119. package/agents/reversa-data-master/SKILL.md +67 -0
  120. package/agents/reversa-data-master/agents/openai.yaml +5 -0
  121. package/agents/reversa-debugger/SKILL.md +178 -0
  122. package/agents/reversa-debugger/agents/openai.yaml +3 -0
  123. package/agents/reversa-debugger/references/bug-schema.md +123 -0
  124. package/agents/reversa-debugger/references/bugs-readme-template.md +76 -0
  125. package/agents/reversa-debugger-debate/SKILL.md +75 -0
  126. package/agents/reversa-debugger-debate/agents/openai.yaml +5 -0
  127. package/agents/reversa-debugger-debate/references/debate-protocol.md +102 -0
  128. package/agents/reversa-debugger-fix/SKILL.md +170 -0
  129. package/agents/reversa-debugger-fix/agents/openai.yaml +5 -0
  130. package/agents/reversa-debugger-graph/SKILL.md +94 -0
  131. package/agents/reversa-debugger-graph/agents/openai.yaml +5 -0
  132. package/agents/reversa-decouple/SKILL.md +78 -0
  133. package/agents/reversa-decouple/agents/openai.yaml +5 -0
  134. package/agents/reversa-depth-inspection/SKILL.md +99 -0
  135. package/agents/reversa-depth-inspection/agents/openai.yaml +5 -0
  136. package/agents/reversa-design-system/SKILL.md +77 -0
  137. package/agents/reversa-design-system/agents/openai.yaml +5 -0
  138. package/agents/reversa-designer/SKILL.md +217 -0
  139. package/agents/reversa-designer/agents/openai.yaml +5 -0
  140. package/agents/reversa-designer/references/paradigm-checklist.md +50 -0
  141. package/agents/reversa-designer/references/templates/data_migration_plan.md +80 -0
  142. package/agents/reversa-designer/references/templates/target_architecture.md +68 -0
  143. package/agents/reversa-designer/references/templates/target_data_model.md +64 -0
  144. package/agents/reversa-designer/references/templates/target_domain_model.md +62 -0
  145. package/agents/reversa-designer/references/templates/topology_decision.md +82 -0
  146. package/agents/reversa-detective/SKILL.md +82 -0
  147. package/agents/reversa-detective/agents/openai.yaml +5 -0
  148. package/agents/reversa-docs/SKILL.md +241 -0
  149. package/agents/reversa-docs/agents/openai.yaml +3 -0
  150. package/agents/reversa-docs/references/config-schema.json +108 -0
  151. package/agents/reversa-docs/references/expected_sources.yaml +60 -0
  152. package/agents/reversa-docs-analyst/SKILL.md +163 -0
  153. package/agents/reversa-docs-analyst/agents/openai.yaml +5 -0
  154. package/agents/reversa-docs-mapper/SKILL.md +167 -0
  155. package/agents/reversa-docs-mapper/agents/openai.yaml +5 -0
  156. package/agents/reversa-docs-mapper/references/extraction-policy.md +44 -0
  157. package/agents/reversa-docs-publisher/SKILL.md +323 -0
  158. package/agents/reversa-docs-publisher/agents/openai.yaml +5 -0
  159. package/agents/reversa-docs-publisher/references/auxiliary_sources.yaml +27 -0
  160. package/agents/reversa-docs-publisher/references/vendor-pins.yaml +149 -0
  161. package/agents/reversa-docs-storyteller/SKILL.md +189 -0
  162. package/agents/reversa-docs-storyteller/agents/openai.yaml +5 -0
  163. package/agents/reversa-drafter/SKILL.md +189 -0
  164. package/agents/reversa-drafter/agents/openai.yaml +5 -0
  165. package/agents/reversa-especialista-d3/SKILL.md +37 -0
  166. package/agents/reversa-especialista-d3/agents/openai.yaml +5 -0
  167. package/agents/reversa-especialista-d3/references/api-core.md +13 -0
  168. package/agents/reversa-especialista-d3/references/interatividade.md +5 -0
  169. package/agents/reversa-especialista-d3/references/layouts-complexos.md +8 -0
  170. package/agents/reversa-explorer/SKILL.md +110 -0
  171. package/agents/reversa-explorer/agents/openai.yaml +5 -0
  172. package/agents/reversa-extract-soul/SKILL.md +221 -0
  173. package/agents/reversa-extract-soul/agents/openai.yaml +5 -0
  174. package/agents/reversa-forward/SKILL.md +235 -0
  175. package/agents/reversa-forward/agents/openai.yaml +3 -0
  176. package/agents/reversa-forward-autonomous/SKILL.md +184 -0
  177. package/agents/reversa-forward-autonomous/agents/openai.yaml +3 -0
  178. package/agents/reversa-framer/SKILL.md +124 -0
  179. package/agents/reversa-framer/agents/openai.yaml +5 -0
  180. package/agents/reversa-highcharts-visualizer/SKILL.md +123 -0
  181. package/agents/reversa-highcharts-visualizer/agents/openai.yaml +5 -0
  182. package/agents/reversa-highcharts-visualizer/references/CHART_CATALOG.md +450 -0
  183. package/agents/reversa-highcharts-visualizer/references/ERRORS.md +99 -0
  184. package/agents/reversa-highcharts-visualizer/references/HIGHCHARTS_PATTERNS.md +347 -0
  185. package/agents/reversa-highcharts-visualizer/scripts/analyze_data.py +219 -0
  186. package/agents/reversa-highcharts-visualizer/scripts/parse_data.py +246 -0
  187. package/agents/reversa-highcharts-visualizer/scripts/sample_data.py +208 -0
  188. package/agents/reversa-ideator/SKILL.md +139 -0
  189. package/agents/reversa-ideator/agents/openai.yaml +5 -0
  190. package/agents/reversa-image-prompt-json/SKILL.md +210 -0
  191. package/agents/reversa-image-prompt-json/agents/openai.yaml +5 -0
  192. package/agents/reversa-image-prompt-json/references/Examples.md +123 -0
  193. package/agents/reversa-inspector/SKILL.md +147 -0
  194. package/agents/reversa-inspector/agents/openai.yaml +5 -0
  195. package/agents/reversa-inspector/references/parity-coverage-matrix.md +54 -0
  196. package/agents/reversa-inspector/references/templates/parity_specs.md +64 -0
  197. package/agents/reversa-inspector/references/templates/parity_test.feature +40 -0
  198. package/agents/reversa-migrate/SKILL.md +282 -0
  199. package/agents/reversa-migrate/agents/openai.yaml +3 -0
  200. package/agents/reversa-migrate/references/auto-defaults.md +52 -0
  201. package/agents/reversa-migrate/references/expected_legacy_artifacts.yaml +69 -0
  202. package/agents/reversa-migrate/references/handoff-checklist.md +34 -0
  203. package/agents/reversa-migrate/references/state.json +28 -0
  204. package/agents/reversa-migrate/references/templates/ambiguity_log.md +43 -0
  205. package/agents/reversa-migrate/references/templates/handoff.md +91 -0
  206. package/agents/reversa-migrate/references/templates/migration_brief.md +52 -0
  207. package/agents/reversa-migrate/references/templates/pending_decisions.md +36 -0
  208. package/agents/reversa-modularize/SKILL.md +77 -0
  209. package/agents/reversa-modularize/agents/openai.yaml +5 -0
  210. package/agents/reversa-n8n/SKILL.md +256 -0
  211. package/agents/reversa-n8n/agents/openai.yaml +5 -0
  212. package/agents/reversa-n8n/references/node-catalog.md +245 -0
  213. package/agents/reversa-new/SKILL.md +328 -0
  214. package/agents/reversa-new/agents/openai.yaml +3 -0
  215. package/agents/reversa-optimize/SKILL.md +80 -0
  216. package/agents/reversa-optimize/agents/openai.yaml +5 -0
  217. package/agents/reversa-paradigm-advisor/SKILL.md +168 -0
  218. package/agents/reversa-paradigm-advisor/agents/openai.yaml +5 -0
  219. package/agents/reversa-paradigm-advisor/references/paradigm-catalog.md +73 -0
  220. package/agents/reversa-paradigm-advisor/references/templates/paradigm_decision.md +69 -0
  221. package/agents/reversa-plan/SKILL.md +92 -0
  222. package/agents/reversa-plan/agents/openai.yaml +5 -0
  223. package/agents/reversa-pre-spec/SKILL.md +133 -0
  224. package/agents/reversa-pre-spec/agents/openai.yaml +5 -0
  225. package/agents/reversa-pricing/SKILL.md +181 -0
  226. package/agents/reversa-pricing/agents/openai.yaml +3 -0
  227. package/agents/reversa-pricing-advisor/SKILL.md +322 -0
  228. package/agents/reversa-pricing-advisor/agents/openai.yaml +5 -0
  229. package/agents/reversa-pricing-advisor/references/advisor-schema.json +196 -0
  230. package/agents/reversa-pricing-advisor/references/advisor-template.md +106 -0
  231. package/agents/reversa-pricing-advisor/references/sale-models.md +237 -0
  232. package/agents/reversa-pricing-estimate/SKILL.md +287 -0
  233. package/agents/reversa-pricing-estimate/agents/openai.yaml +5 -0
  234. package/agents/reversa-pricing-estimate/references/effort-formula.md +146 -0
  235. package/agents/reversa-pricing-estimate/references/estimate-schema.json +141 -0
  236. package/agents/reversa-pricing-estimate/references/estimate-template.md +153 -0
  237. package/agents/reversa-pricing-estimate/references/example-estimate.json +74 -0
  238. package/agents/reversa-pricing-estimate/references/example-estimate.md +88 -0
  239. package/agents/reversa-pricing-estimate/references/market-benchmarks.md +102 -0
  240. package/agents/reversa-pricing-estimate/references/value-formula.md +123 -0
  241. package/agents/reversa-pricing-product/SKILL.md +299 -0
  242. package/agents/reversa-pricing-product/agents/openai.yaml +5 -0
  243. package/agents/reversa-pricing-product/references/breakeven-formula.md +237 -0
  244. package/agents/reversa-pricing-product/references/product-schema.json +288 -0
  245. package/agents/reversa-pricing-product/references/product-template.md +113 -0
  246. package/agents/reversa-pricing-product/references/store-commissions.md +57 -0
  247. package/agents/reversa-pricing-profile/SKILL.md +390 -0
  248. package/agents/reversa-pricing-profile/agents/openai.yaml +5 -0
  249. package/agents/reversa-pricing-profile/references/example-profile.json +23 -0
  250. package/agents/reversa-pricing-profile/references/example-profile.md +46 -0
  251. package/agents/reversa-pricing-profile/references/profile-schema.json +227 -0
  252. package/agents/reversa-pricing-profile/references/tax-regimes.md +106 -0
  253. package/agents/reversa-pricing-research/SKILL.md +352 -0
  254. package/agents/reversa-pricing-research/agents/openai.yaml +5 -0
  255. package/agents/reversa-pricing-research/references/research-policy.md +213 -0
  256. package/agents/reversa-pricing-research/references/research-schema.json +330 -0
  257. package/agents/reversa-pricing-size/SKILL.md +205 -0
  258. package/agents/reversa-pricing-size/agents/openai.yaml +5 -0
  259. package/agents/reversa-pricing-size/references/example-size.json +41 -0
  260. package/agents/reversa-pricing-size/references/size-schema.json +120 -0
  261. package/agents/reversa-pricing-size/references/sizing-formula.md +183 -0
  262. package/agents/reversa-principles/SKILL.md +82 -0
  263. package/agents/reversa-principles/agents/openai.yaml +5 -0
  264. package/agents/reversa-prune/SKILL.md +85 -0
  265. package/agents/reversa-prune/agents/openai.yaml +5 -0
  266. package/agents/reversa-quality/SKILL.md +87 -0
  267. package/agents/reversa-quality/agents/openai.yaml +5 -0
  268. package/agents/reversa-reconstructor/SKILL.md +243 -0
  269. package/agents/reversa-reconstructor/agents/openai.yaml +5 -0
  270. package/agents/reversa-reconstructor/references/reconstruction-plan-migration-template.md +89 -0
  271. package/agents/reversa-reconstructor/references/reconstruction-plan-template.md +77 -0
  272. package/agents/reversa-refactor/SKILL.md +112 -0
  273. package/agents/reversa-refactor/agents/openai.yaml +3 -0
  274. package/agents/reversa-refactor/references/opportunity-schema.md +68 -0
  275. package/agents/reversa-refactor/references/refactor-readme-template.md +35 -0
  276. package/agents/reversa-requirements/SKILL.md +217 -0
  277. package/agents/reversa-requirements/agents/openai.yaml +5 -0
  278. package/agents/reversa-researcher/SKILL.md +136 -0
  279. package/agents/reversa-researcher/agents/openai.yaml +5 -0
  280. package/agents/reversa-restructure/SKILL.md +78 -0
  281. package/agents/reversa-restructure/agents/openai.yaml +5 -0
  282. package/agents/reversa-resume/SKILL.md +141 -0
  283. package/agents/reversa-resume/agents/openai.yaml +5 -0
  284. package/agents/reversa-reviewer/SKILL.md +163 -0
  285. package/agents/reversa-reviewer/agents/openai.yaml +5 -0
  286. package/agents/reversa-reviewer/references/confidence-report-template.md +73 -0
  287. package/agents/reversa-reviewer/references/confidence-rules.md +65 -0
  288. package/agents/reversa-reviewer/references/questions-template.md +74 -0
  289. package/agents/reversa-scout/SKILL.md +82 -0
  290. package/agents/reversa-scout/agents/openai.yaml +5 -0
  291. package/agents/reversa-scout/references/surface-schema.md +93 -0
  292. package/agents/reversa-screen-translator/SKILL.md +279 -0
  293. package/agents/reversa-screen-translator/agents/openai.yaml +5 -0
  294. package/agents/reversa-screen-translator/references/adapter-pairs.md +97 -0
  295. package/agents/reversa-screen-translator/references/platform-detection.md +73 -0
  296. package/agents/reversa-screen-translator/references/templates/golden_manifest.yaml +62 -0
  297. package/agents/reversa-screen-translator/references/templates/inventory.schema.json +132 -0
  298. package/agents/reversa-screen-translator/references/templates/screen_deviation_log.md +66 -0
  299. package/agents/reversa-screen-translator/references/templates/screen_modernization_decision.md +106 -0
  300. package/agents/reversa-screen-translator/references/templates/target_screens.md +206 -0
  301. package/agents/reversa-selo-generativo/SKILL.md +176 -0
  302. package/agents/reversa-selo-generativo/agents/openai.yaml +5 -0
  303. package/agents/reversa-selo-generativo/references/ERRORS.md +212 -0
  304. package/agents/reversa-selo-generativo/references/GENERATIVE_PATTERNS.md +365 -0
  305. package/agents/reversa-selo-generativo/references/PALETTE_BY_STYLE.md +176 -0
  306. package/agents/reversa-simplify/SKILL.md +79 -0
  307. package/agents/reversa-simplify/agents/openai.yaml +5 -0
  308. package/agents/reversa-spec-sdd/SKILL.md +278 -0
  309. package/agents/reversa-spec-sdd/agents/openai.yaml +5 -0
  310. package/agents/reversa-spec-sdd/assets/spec_examples.md +159 -0
  311. package/agents/reversa-spec-sdd/references/evaluation_rubric.md +113 -0
  312. package/agents/reversa-spec-sdd/references/sdd_guide.md +124 -0
  313. package/agents/reversa-spec-sdd/references/spec_template.md +231 -0
  314. package/agents/reversa-spec-sdd/scripts/spec_scorer.py +476 -0
  315. package/agents/reversa-standardize/SKILL.md +76 -0
  316. package/agents/reversa-standardize/agents/openai.yaml +5 -0
  317. package/agents/reversa-strategist/SKILL.md +119 -0
  318. package/agents/reversa-strategist/agents/openai.yaml +5 -0
  319. package/agents/reversa-strategist/references/migration-strategies.md +41 -0
  320. package/agents/reversa-strategist/references/templates/cutover_plan.md +60 -0
  321. package/agents/reversa-strategist/references/templates/migration_strategy.md +55 -0
  322. package/agents/reversa-strategist/references/templates/risk_register.md +44 -0
  323. package/agents/reversa-sync/SKILL.md +100 -0
  324. package/agents/reversa-sync/agents/openai.yaml +5 -0
  325. package/agents/reversa-to-do/SKILL.md +89 -0
  326. package/agents/reversa-to-do/agents/openai.yaml +5 -0
  327. package/agents/reversa-visor/SKILL.md +91 -0
  328. package/agents/reversa-visor/agents/openai.yaml +5 -0
  329. package/agents/reversa-writer/SKILL.md +212 -0
  330. package/agents/reversa-writer/agents/openai.yaml +5 -0
  331. package/agents/reversa-writer/references/design-template.md +49 -0
  332. package/agents/reversa-writer/references/requirements-template.md +62 -0
  333. package/agents/reversa-writer/references/tasks-template.md +39 -0
  334. package/bin/reversa.js +65 -0
  335. package/lib/commands/add-engine.js +97 -0
  336. package/lib/commands/export-diagrams.js +194 -0
  337. package/lib/commands/install.js +260 -0
  338. package/lib/commands/status.js +35 -0
  339. package/lib/commands/uninstall.js +159 -0
  340. package/lib/commands/update.js +252 -0
  341. package/lib/installer/bundled.js +42 -0
  342. package/lib/installer/detector.js +167 -0
  343. package/lib/installer/manifest.js +61 -0
  344. package/lib/installer/orange-prompts.js +13 -0
  345. package/lib/installer/policy.js +53 -0
  346. package/lib/installer/prompts.js +252 -0
  347. package/lib/installer/validator.js +22 -0
  348. package/lib/installer/writer.js +376 -0
  349. package/lib/utils/banner.js +35 -0
  350. package/lib/utils/json-safe.js +10 -0
  351. package/lib/utils/package-info.js +22 -0
  352. package/package.json +51 -4
  353. package/templates/config.toml +46 -0
  354. package/templates/config.user.toml +8 -0
  355. package/templates/documentation/assets/css/style.css +476 -0
  356. package/templates/documentation/assets/js/nav.js +141 -0
  357. package/templates/documentation/assets/js/sidebar.js +162 -0
  358. package/templates/documentation/demo/viewer-demo.html +200 -0
  359. package/templates/documentation/pages/arquitetura.html.tpl +36 -0
  360. package/templates/documentation/pages/deck.html.tpl +27 -0
  361. package/templates/documentation/pages/features/feature.html.tpl +44 -0
  362. package/templates/documentation/pages/glossario.html.tpl +30 -0
  363. package/templates/documentation/pages/index.html.tpl +32 -0
  364. package/templates/documentation/pages/metricas.html.tpl +43 -0
  365. package/templates/documentation/pages/modulos.html.tpl +33 -0
  366. package/templates/documentation/pages/timeline.html.tpl +33 -0
  367. package/templates/documentation/pages/topologia.html.tpl +31 -0
  368. package/templates/documentation/scripts/convert_chronicle.py +71 -0
  369. package/templates/documentation/scripts/convert_soul.py +73 -0
  370. package/templates/documentation/scripts/extract_deps.py +54 -0
  371. package/templates/documentation/scripts/extract_modules.py +90 -0
  372. package/templates/documentation/scripts/list_specs.py +74 -0
  373. package/templates/documentation/viewer.html +60 -0
  374. package/templates/engines/AGENTS.md +26 -0
  375. package/templates/engines/CLAUDE.md +27 -0
  376. package/templates/engines/CONVENTIONS.md +26 -0
  377. package/templates/engines/GEMINI.md +26 -0
  378. package/templates/engines/amazonq +7 -0
  379. package/templates/engines/clinerules +7 -0
  380. package/templates/engines/copilot-instructions +26 -0
  381. package/templates/engines/cursorrules +7 -0
  382. package/templates/engines/roorules +7 -0
  383. package/templates/engines/windsurf +7 -0
  384. package/templates/forward/body/actions-template.md +83 -0
  385. package/templates/forward/body/principles-template.md +75 -0
  386. package/templates/forward/body/quality-template.md +103 -0
  387. package/templates/forward/body/requirements-template.md +121 -0
  388. package/templates/forward/body/roadmap-template.md +107 -0
  389. package/templates/forward/hooks.yml +60 -0
  390. package/templates/forward/scripts/ps/bind-to-extraction.ps1 +71 -0
  391. package/templates/forward/scripts/ps/prepare-roadmap.ps1 +84 -0
  392. package/templates/forward/scripts/ps/verify-prerequisites.ps1 +103 -0
  393. package/templates/forward/scripts/sh/bind-to-extraction.sh +103 -0
  394. package/templates/forward/scripts/sh/prepare-roadmap.sh +79 -0
  395. package/templates/forward/scripts/sh/verify-prerequisites.sh +125 -0
  396. package/templates/forward/setup.json +24 -0
  397. package/templates/hooks/README.md +41 -0
  398. package/templates/hooks/check-legacy-policy.mjs +0 -0
  399. package/templates/migration/artifacts/ambiguity_log.md +43 -0
  400. package/templates/migration/artifacts/cutover_plan.md +60 -0
  401. package/templates/migration/artifacts/data_migration_plan.md +80 -0
  402. package/templates/migration/artifacts/discard_log.md +37 -0
  403. package/templates/migration/artifacts/handoff.md +76 -0
  404. package/templates/migration/artifacts/migration_brief.md +52 -0
  405. package/templates/migration/artifacts/migration_strategy.md +55 -0
  406. package/templates/migration/artifacts/paradigm_decision.md +69 -0
  407. package/templates/migration/artifacts/parity_specs.md +64 -0
  408. package/templates/migration/artifacts/parity_test.feature +40 -0
  409. package/templates/migration/artifacts/pending_decisions.md +36 -0
  410. package/templates/migration/artifacts/risk_register.md +44 -0
  411. package/templates/migration/artifacts/target_architecture.md +68 -0
  412. package/templates/migration/artifacts/target_business_rules.md +54 -0
  413. package/templates/migration/artifacts/target_data_model.md +64 -0
  414. package/templates/migration/artifacts/target_domain_model.md +62 -0
  415. package/templates/migration/catalogs/migration_strategies.md +101 -0
  416. package/templates/migration/catalogs/paradigm_catalog.md +101 -0
  417. package/templates/migration/expected_legacy_artifacts.yaml +77 -0
  418. package/templates/migration/state.json +28 -0
  419. package/templates/plan.md +65 -0
  420. package/templates/reversa-config.json +5 -0
  421. package/templates/state.json +18 -0
@@ -0,0 +1,168 @@
1
+ ---
2
+ name: reversa-paradigm-advisor
3
+ description: "Primeiro agente do Time de Migração. Detecta o paradigma do sistema legado a partir das specs, infere o paradigma natural da stack alvo, alerta sobre gaps e força uma decisão consciente do usuário. Produz paradigm_decision.md, leitura obrigatória de todos os agentes posteriores. Ativação: /reversa-paradigm-advisor (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: paradigm_advisor
12
+ team: migration
13
+ ---
14
+
15
+ Você é o **Paradigm Advisor**, primeiro agente do Time de Migração do Reversa.
16
+
17
+ ## Missão
18
+
19
+ Identificar o paradigma de programação do sistema legado, inferir o paradigma natural da stack alvo declarada, alertar sobre gaps de paradigma e conduzir uma decisão consciente do usuário sobre como tratá-los.
20
+
21
+ Sua missão é **evitar que o usuário troque de linguagem achando que isso é só uma mudança sintática quando na verdade é uma mudança fundamental de modelo mental**.
22
+
23
+ Você é o agente mais opinativo do time. Você **educa o usuário, não apenas coleta resposta**.
24
+
25
+ ## Pré-requisitos
26
+
27
+ 1. `_reversa_sdd/migration/migration_brief.md` deve existir (com `Stack alvo` declarada).
28
+ 2. `_reversa_sdd/` deve estar populado pelo Time de Descoberta (Scout, Archaeologist, Detective, Architect, Writer, Reviewer).
29
+
30
+ Se algum pré-requisito faltar, encerre com mensagem clara ao usuário e oriente a executar `/reversa-migrate` (que conduz o brief) ou `/reversa` (que popula o `_reversa_sdd/`).
31
+
32
+ ## Inputs
33
+
34
+ Leia somente o que precisar:
35
+
36
+ - `_reversa_sdd/migration/migration_brief.md` (obrigatório, para extrair stack alvo)
37
+ - `_reversa_sdd/domain.md` (ou `domain_model.md` em versões antigas)
38
+ - `_reversa_sdd/architecture.md`
39
+ - `_reversa_sdd/inventory.md` (ou `legacy_inventory.md`)
40
+ - `_reversa_sdd/code-analysis.md` (ou `process_flows.md`), opcional, ler só se a detecção do paradigma estiver ambígua
41
+ - Catálogo: `references/paradigm-catalog.md` (cópia local do catálogo consultivo)
42
+
43
+ Não leia código-fonte do legado; opere 100% no nível das specs.
44
+
45
+ ## Output
46
+
47
+ - `_reversa_sdd/migration/paradigm_decision.md` (obrigatório)
48
+
49
+ Use o template em `references/templates/paradigm_decision.md` e preencha **todos** os campos.
50
+
51
+ ## Procedimento
52
+
53
+ ### 1. Detectar o paradigma do legado
54
+
55
+ Use a tabela em `references/paradigm-catalog.md` § "Catálogo de paradigmas" para classificar com base em sinais observados nos artefatos de `_reversa_sdd/`:
56
+
57
+ - **Procedural**: domain pobre, fluxos lineares em controllers, ausência de aggregates, lógica em scripts ou métodos top-level.
58
+ - **OO clássico**: hierarquia de classes, herança forte, padrão Active Record, controllers anêmicos.
59
+ - **OO com DI**: aggregates explícitos, interfaces de repositório, separação de camadas.
60
+ - **Funcional**: tipos algébricos, imutabilidade dominante, ausência de classes.
61
+ - **Event-driven**: eventos no domain model, integrações via fila, processos de longa duração.
62
+ - **Actor model**: processos supervisionados, mensagens entre atores.
63
+ - **Dataflow**: pipelines declarativos, transformações em estágios.
64
+ - **Híbrido**: combinações detectadas com evidência por componente.
65
+
66
+ Para cada classificação, registre **evidências citáveis** com referência ao artefato e seção. Use a escala de confiança do Reversa:
67
+
68
+ - 🟢 CONFIRMADO (evidência direta no artefato)
69
+ - 🟡 INFERIDO (padrão observado, mas sem afirmação explícita)
70
+ - 🔴 LACUNA (paradigma não dedutível pelas specs disponíveis)
71
+ - ⚠️ AMBÍGUO (evidências apontam para mais de um paradigma)
72
+
73
+ Se híbrido, listar componentes A, B, C com paradigma de cada e evidência.
74
+
75
+ ### 2. Inferir o paradigma natural da stack alvo
76
+
77
+ Consulte `references/paradigm-catalog.md` § "Mapeamento stack → paradigma natural" usando a stack declarada em `migration_brief.md`.
78
+
79
+ Registre:
80
+ - paradigma natural inferido
81
+ - alternativas viáveis com custo/benefício
82
+ - justificativa (por que a stack é naturalmente desse paradigma)
83
+
84
+ ### 3. Identificar o gap
85
+
86
+ Compare paradigma legado com paradigma alvo:
87
+
88
+ - **Iguais**: mensagem curta `"Sem mudança de paradigma. Confirma?"`. Se o usuário confirmar, vá direto ao passo 5 com `gap = nenhum` e `derived_appetite = balanced` por default (a menos que o brief indique apetite explícito).
89
+ - **Diferentes**: avance ao passo 4.
90
+
91
+ ### 4. Apresentar o gap concretamente
92
+
93
+ Use `references/paradigm-catalog.md` § "Tabela de gaps típicos por par" para a combinação detectada. **Nunca apresente o gap em abstrato**: traga exemplos do próprio sistema legado citando regras / fluxos / componentes específicos identificados em `_reversa_sdd/`.
94
+
95
+ Mínimo de **4 implicações concretas** com exemplo do legado. Exemplo de formato:
96
+
97
+ > **Implicação 1: tratamento de erro deixa de ser try/catch local; vira retry/DLQ**
98
+ > No legado, vejo que `OrderService.confirmOrder()` (em `_reversa_sdd/orders/design.md`) lança exceção e depende do controller para responder 500 ao usuário. No paradigma alvo (event-driven em Node), confirmar pedido vira evento; falhas vão para DLQ; o usuário recebe 202 imediato e o resultado chega assíncrono.
99
+
100
+ ### 5. Apresentar as 3 opções
101
+
102
+ Sempre apresente:
103
+
104
+ 1. **Adotar o paradigma natural da stack** (transformacional)
105
+ - Consequências concretas por implicação listada acima.
106
+ 2. **Forçar paradigma similar ao legado** (conservador)
107
+ - Consequências: como simular o paradigma legado na stack alvo, custo idiomático, perda de ecossistema, débito técnico.
108
+ 3. **Híbrido** (equilibrado)
109
+ - Consequências: bordas onde adotar natural vs. onde manter legado.
110
+
111
+ Pergunte explicitamente: **"Qual opção você escolhe?"**.
112
+
113
+ ### 6. Coletar a decisão
114
+
115
+ Após o usuário responder, registre em `paradigm_decision.md`:
116
+
117
+ - **Escolha**: 1 / 2 / 3
118
+ - **Justificativa do usuário** (texto livre)
119
+ - **`derived_appetite`**:
120
+ - opção 1 → `transformational`
121
+ - opção 2 → `conservative`
122
+ - opção 3 → `balanced`
123
+
124
+ ### 7. Listar implicações pendentes para próximos agentes
125
+
126
+ Para cada implicação concreta levantada no passo 4, indicar:
127
+
128
+ - qual agente posterior é afetado (Curator / Strategist / Designer / Inspector)
129
+ - ação esperada desse agente para honrar a decisão
130
+
131
+ Isso é o contrato que os próximos agentes vão cumprir.
132
+
133
+ ### 8. Escrever o artefato
134
+
135
+ Renderize `_reversa_sdd/migration/paradigm_decision.md` com base no template, preenchendo todos os campos com evidências, escolhas e justificativas. Garanta tagging de evidência (🟢🟡🔴⚠️) onde aplicável.
136
+
137
+ ### 9. Resumir e devolver controle
138
+
139
+ Apresente um resumo curto ao usuário:
140
+
141
+ > "Paradigm Decision registrado.
142
+ > - Legado detectado: <paradigma> (<confiança>)
143
+ > - Alvo inferido: <paradigma>
144
+ > - Gap: <severidade>
145
+ > - Escolha: opção <N> (<rótulo>)
146
+ > - Apetite derivado: <conservative | balanced | transformational>
147
+ >
148
+ > Próximo agente: **Curator**."
149
+
150
+ Devolva controle ao orquestrador `/reversa-migrate` para a pausa de revisão humana.
151
+
152
+ ## Casos de borda
153
+
154
+ - **Stack alvo ausente ou ambígua no brief**: pergunte antes de prosseguir; não invente.
155
+ - **Paradigma legado indetectável** (`_reversa_sdd/` muito pobre): registre como 🔴 LACUNA, peça confirmação ao usuário com base na intuição dele sobre o legado.
156
+ - **Legado híbrido**: detecte componentes, peça decisão por componente ou decisão unificadora ("vamos forçar tudo para um paradigma único?").
157
+ - **Engine sem chat interativo**: escreva `pending_decisions.md` em `_reversa_sdd/migration/` com as três opções e aguarde leitura.
158
+
159
+ ## Layout de saída (transversal)
160
+
161
+ 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.
162
+
163
+ ## Regras absolutas
164
+
165
+ - Não modificar nem deletar arquivos fora de `_reversa_sdd/migration/`.
166
+ - Não inventar evidência sem referência ao artefato fonte.
167
+ - Nunca pular a apresentação das 3 opções, mesmo se a recomendação parecer óbvia: a decisão é humana.
168
+ - Nunca decidir paradigma sem registrar a justificativa do usuário.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Paradigm Advisor"
3
+ short_description: "Primeiro agente do Time de Migração"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,73 @@
1
+ > Cópia local do catálogo consultivo. A fonte canônica fica em `templates/migration/catalogs/paradigm_catalog.md`.
2
+ > Esta cópia é instalada junto com o agente para que ele tenha acesso ao catálogo dentro do projeto do usuário, sem depender de localização do pacote npm.
3
+
4
+ # Paradigm Catalog (cópia local)
5
+
6
+ ## Catálogo de paradigmas
7
+
8
+ ### Procedural
9
+ - **Características**: funções top-level, fluxo linear em controllers, ausência de classes ou uso ornamental, dados como dicts/structs, side effects abertos.
10
+ - **Exemplos no legado**: scripts PHP clássicos, COBOL batch, sistemas Perl pré-OO, scripts shell.
11
+ - **Sinais em `_reversa_sdd/`**: domínio descrito como "funções", fluxos lineares em `process_flows`, ausência de aggregates explícitos.
12
+
13
+ ### OO clássico
14
+ - **Características**: hierarquia de classes, herança forte, padrão Active Record, lógica acoplada aos modelos.
15
+ - **Exemplos no legado**: Rails monolítico, Django tradicional, Java EE pré-DI, .NET WebForms / clássico.
16
+ - **Sinais em `_reversa_sdd/`**: classes com responsabilidades amplas, herança em domain model, controllers anêmicos chamando métodos do modelo.
17
+
18
+ ### OO com DI
19
+ - **Características**: containers de injeção, interfaces explícitas, padrão Repository / Service, separação clara entre camadas.
20
+ - **Exemplos no legado**: Spring moderno, .NET 6+, NestJS, Symfony moderno.
21
+ - **Sinais em `_reversa_sdd/`**: aggregates explícitos, interfaces de repositório, ausência de Active Record.
22
+
23
+ ### Funcional
24
+ - **Características**: imutabilidade dominante, funções puras, composição, ausência de side effects implícitos, tipagem rica.
25
+ - **Exemplos no legado**: Haskell, Elm, F#, Scala funcional, Clojure.
26
+ - **Sinais em `_reversa_sdd/`**: tipos algébricos, ausência de classes, fluxo expresso como composição.
27
+
28
+ ### Event-driven (assíncrono)
29
+ - **Características**: filas / tópicos, handlers desacoplados, ausência de fluxo linear, consistência eventual, idempotência explícita.
30
+ - **Exemplos no legado**: backends Node moderno orientado a fila, sistemas SQS / Kafka heavy, microsserviços assíncronos.
31
+ - **Sinais em `_reversa_sdd/`**: eventos no domain model, integrações via fila, processos de longa duração com retry.
32
+
33
+ ### Actor model
34
+ - **Características**: atores isolados com mailbox, supervisão, isolamento de estado.
35
+ - **Exemplos no legado**: Erlang / Elixir / OTP, Akka.
36
+ - **Sinais em `_reversa_sdd/`**: processos supervisionados, mensagens entre atores.
37
+
38
+ ### Dataflow
39
+ - **Características**: pipelines declarativos, transformações em fluxo, ausência de loops imperativos no domínio.
40
+ - **Exemplos no legado**: ETLs clássicos, Spark, Flink.
41
+ - **Sinais em `_reversa_sdd/`**: descrição em DAG, transformações em estágios.
42
+
43
+ ## Mapeamento stack → paradigma natural
44
+
45
+ | Stack alvo | Paradigma natural | Alternativas viáveis | Notas |
46
+ |---|---|---|---|
47
+ | Node.js 20 (Fastify, Express, NestJS) | event-driven assíncrono | OO com DI (NestJS), funcional leve | runtime async-first; bloqueio CPU pesado vai para worker threads |
48
+ | Go (net/http, Echo, Fiber) | CSP / goroutines (event-driven leve) | procedural estruturado | concorrência via channels; OO simulada via interfaces |
49
+ | Rust (axum, Actix, tokio) | ownership / async funcional | event-driven | imutabilidade por default, segurança via tipos |
50
+ | Elixir / Phoenix | actor model (BEAM) | funcional | supervisão via OTP |
51
+ | Python moderno (FastAPI, Django 5) | OO com DI ou procedural rico | event-driven (Celery, asyncio) | escolha depende do framework |
52
+ | Kotlin (Spring Boot, Ktor) | OO com DI | event-driven (Reactor) | corrotinas habilitam async ergonômico |
53
+ | .NET 8 (ASP.NET Core, Minimal API) | OO com DI | event-driven (Channels, MediatR) | tradição OO + assincronismo first-class |
54
+ | Java moderno (Spring Boot 3, Quarkus) | OO com DI | event-driven (Project Reactor) | bibliotecas funcionais possíveis mas não dominantes |
55
+ | Ruby moderno (Rails 7, Hanami) | OO clássico (Rails) ou OO com DI (Hanami) | funcional leve (dry-rb) | Rails dita Active Record; Hanami é DI-heavy |
56
+ | TypeScript serverless (AWS Lambda, Cloudflare Workers) | event-driven | funcional | invocação por evento; cold start influencia design |
57
+
58
+ ## Tabela de gaps típicos por par
59
+
60
+ | De → Para | Gap principal | Implicações concretas |
61
+ |---|---|---|
62
+ | procedural → event-driven | sincronia → assincronismo | resposta deixa de ser imediata; tratamento de erro vira retry/DLQ; idempotência obrigatória; ordem de eventos passa a importar |
63
+ | procedural → OO com DI | dados como dict → aggregates | invariantes ficam dentro de aggregates; lógica deixa de viver em controllers; dependências via interfaces |
64
+ | procedural → funcional | side effects abertos → puros + isolados | mutabilidade vira exceção; composição substitui sequência; tipos algébricos para estados |
65
+ | OO clássico → event-driven | fluxo síncrono → coreografia | ações deixam de ser atômicas; transações distribuídas viram sagas; consistência forte → eventual |
66
+ | OO clássico → OO com DI | herança → composição via interfaces | Active Record desaparece; persistência vira repositório; testes ganham mocks naturais |
67
+ | OO clássico → funcional | encapsulamento mutável → imutabilidade | métodos com efeito viram funções puras + atualização explícita; estado expresso como sequência de transformações |
68
+ | OO com DI → event-driven | comando síncrono → evento | retorno deixa de ser imediato; orquestração vira coreografia; ordem por chave |
69
+ | OO com DI → funcional | mocks → composição testável | DI deixa de ser por interface, vira por argumento de função |
70
+ | funcional → event-driven | composição síncrona → mensageria | latência aumenta; falha vira mensagem em DLQ; estado distribuído |
71
+ | event-driven → procedural síncrono | desnatural; só faz sentido para sistemas pequenos | colapsar handlers em chamadas diretas; perda de desacoplamento; consistência forte volta |
72
+ | dataflow → event-driven | DAG declarativa → coreografia mutável | controle fica menos previsível; ordem precisa ser garantida por chave |
73
+ | actor model → OO com DI | mensagens entre atores → chamadas síncronas | perda de isolamento de falha; supervisão precisa virar try/catch ou retry orquestrado |
@@ -0,0 +1,69 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: paradigm_decision
7
+ producedBy: paradigm_advisor
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Paradigm Decision
12
+
13
+ > Decisão consciente sobre como tratar a mudança (ou ausência) de paradigma entre o legado e a stack alvo.
14
+ > Este artefato é leitura obrigatória primeiro para qualquer agente posterior e para o agente de codificação.
15
+
16
+ ## Paradigma do legado detectado
17
+ - **Paradigma principal**: <procedural | OO clássico | OO com DI | funcional | event-driven | actor model | dataflow | híbrido: ...>
18
+ - **Confiança**: 🟢 CONFIRMADO | 🟡 INFERIDO | 🔴 LACUNA | ⚠️ AMBÍGUO
19
+ - **Evidências**:
20
+ - <evidência 1, com referência a artefato do `_reversa_sdd/`>
21
+ - <evidência 2>
22
+ - **Variações observadas** (se híbrido):
23
+ - <componente A: paradigma X, evidência>
24
+ - <componente B: paradigma Y, evidência>
25
+
26
+ ## Stack alvo declarada
27
+ - Linguagem: <do migration_brief.md>
28
+ - Framework: <do migration_brief.md>
29
+ - Infra: <do migration_brief.md>
30
+
31
+ ## Paradigma natural inferido
32
+ - **Paradigma**: <inferido via paradigm_catalog>
33
+ - **Justificativa**: <por que essa stack tem esse paradigma natural>
34
+ - **Alternativas viáveis**: <ex: OO com DI também é viável em Node, com custo X>
35
+
36
+ ## Gap identificado
37
+ - **Severidade**: alto | médio | baixo | nenhum
38
+ - **Implicações concretas** (não em abstrato; com exemplo do próprio sistema legado):
39
+ - <implicação 1, citando regra/fluxo do legado afetado>
40
+ - <implicação 2>
41
+ - <implicação 3>
42
+ - <implicação 4>
43
+
44
+ ## Opções apresentadas ao usuário
45
+ 1. **Adotar paradigma natural da stack** (transformacional)
46
+ - Consequências: <lista>
47
+ 2. **Forçar paradigma similar ao legado** (conservador)
48
+ - Consequências: <lista>
49
+ 3. **Híbrido** (equilibrado)
50
+ - Consequências: <lista>
51
+
52
+ ## Decisão do usuário
53
+ - **Escolha**: <1 | 2 | 3>
54
+ - **Justificativa do usuário**: <texto livre>
55
+ - **Decidido em**: <ISO-8601>
56
+
57
+ ## Apetite derivado
58
+ - `derived_appetite`: conservative | balanced | transformational
59
+
60
+ ## Implicações pendentes para próximos agentes
61
+ | Agente | Implicação | Como honrar |
62
+ |---|---|---|
63
+ | Curator | <implicação> | <ação esperada> |
64
+ | Strategist | <implicação> | <ação esperada> |
65
+ | Designer | <implicação> | <ação esperada> |
66
+ | Inspector | <implicação> | <ação esperada> |
67
+
68
+ ## Notas
69
+ <Qualquer ponto adicional que o agente de codificação precisa saber sobre o paradigma alvo.>
@@ -0,0 +1,92 @@
1
+ ---
2
+ name: reversa-plan
3
+ description: Esboça a abordagem técnica como delta sobre o legado, gerando roadmap, investigation, data-delta, onboarding e interfaces da feature ativa. Terceiro skill do ciclo forward, depois de `/reversa-requirements` e (opcionalmente) `/reversa-clarify`.
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: plan
13
+ ---
14
+
15
+ Você é o arquiteto de evolução do Reversa. Sua missão é traduzir o `requirements.md` da feature ativa numa proposta técnica concreta, expressa como delta sobre o que já existe no legado.
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 para `/reversa-requirements`
26
+ 2. Carregue o `requirements.md` da `feature-dir`
27
+ 2.1. Se o documento ainda tiver marcadores `[DÚVIDA]`, avise o usuário e pergunte se ele prefere rodar `/reversa-clarify` antes
28
+ 2.2. Se o usuário confirmar que quer prosseguir mesmo com dúvidas, cada `[DÚVIDA]` vira premissa explícita no `roadmap.md`, com aviso visível
29
+ 3. Aplique ganchos `before-plan` da forma padrão (mesma lógica do skill `reversa-requirements`)
30
+
31
+ ## Coleta de contexto técnico
32
+
33
+ Leia os artefatos da pipeline reversa nesta ordem, ignorando os que não existirem:
34
+
35
+ 1. `_reversa_sdd/architecture.md` (componentes, dependências internas)
36
+ 2. `_reversa_sdd/c4-context.md` (fronteiras externas)
37
+ 3. `_reversa_sdd/state-machines.md` (máquinas de estado afetadas)
38
+ 4. `_reversa_sdd/dependencies.md` (bibliotecas usadas)
39
+ 5. `_reversa_sdd/code-analysis.md`, mas apenas as seções dos componentes citados no requirements
40
+ 6. `_reversa_sdd/addenda/*.md` (adendos vigentes de features já entregues, criados pelo `/reversa-sync`, com deltas que a extração ainda não absorveu)
41
+ 7. `.reversa/principles.md` (princípios obrigatórios)
42
+
43
+ Anote quais arquivos serão tocados pela mudança proposta. Essa lista vai virar parte do `legacy-impact.md` quando o `/reversa-coding` rodar mais tarde, então registre-a em rascunho mental.
44
+
45
+ ## Verificação de princípios
46
+
47
+ Para cada princípio em `principles.md`:
48
+
49
+ 1. Avalie se a feature respeita o princípio
50
+ 2. Se houver conflito, escreva o conflito numa seção `## Princípios Aplicados` do `roadmap.md`
51
+ 3. NUNCA reescreva ou atenue um princípio aqui, isso é tarefa do `/reversa-principles`
52
+
53
+ ## Geração dos artefatos
54
+
55
+ Carregue o template em `.reversa/templates/roadmap-template.md` e gere os arquivos abaixo na `feature-dir`:
56
+
57
+ | Arquivo | Conteúdo esperado |
58
+ |---------|-------------------|
59
+ | `roadmap.md` | resumo da abordagem, princípios aplicados, decisões técnicas, delta arquitetural, delta de dados, delta de contratos, plano de migração, riscos, critério de pronto |
60
+ | `investigation.md` | pesquisa de fundo, alternativas avaliadas, links para fontes externas, padrões aplicáveis |
61
+ | `data-delta.md` | diff conceitual sobre o modelo extraído em `_reversa_sdd/`, novos campos, campos removidos, migrações necessárias |
62
+ | `onboarding.md` | passo a passo executável para um humano que vai testar a feature pela primeira vez |
63
+ | `interfaces/<nome>.md` | um arquivo por contrato externo afetado (HTTP, fila, gRPC, GraphQL), descreve request, response, erros, idempotência, timeouts |
64
+
65
+ Quando a feature não tocar contratos externos, omita o diretório `interfaces/`.
66
+
67
+ ## Regras de redação
68
+
69
+ - Escreva o `roadmap.md` em forma de delta, jamais redescreva a arquitetura inteira do legado
70
+ - Cite componentes do `_reversa_sdd/` por nome literal e arquivo de origem
71
+ - Marque cada decisão técnica com 🟢 / 🟡 / 🔴 conforme a confidência sobre a fonte
72
+ - Se uma decisão depender de uma `[DÚVIDA]` aceita como premissa, use 🟡
73
+
74
+ ## Persistência
75
+
76
+ - Grave todos os artefatos com escrita atômica
77
+ - Crie `feature-dir/interfaces/` apenas se houver pelo menos um arquivo dentro
78
+
79
+ ## Ganchos Pós-execução
80
+
81
+ Aplique `after-plan` da forma padrão.
82
+
83
+ ## Relatório final
84
+
85
+ 1. Caminhos absolutos dos artefatos gerados
86
+ 2. Lista de princípios em conflito, se houver
87
+ 3. Lista de premissas adotadas a partir de marcadores `[DÚVIDA]` não resolvidos
88
+ 4. Sugestão de próximo passo: `/reversa-to-do` (ou `/reversa-audit` se houver desconfiança)
89
+
90
+ Termine com:
91
+
92
+ > Digite **CONTINUAR** para prosseguir conforme a sugestão acima.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Plan"
3
+ short_description: "Esboça a abordagem técnica como delta sobre o legado, gerando…"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,133 @@
1
+ ---
2
+ name: reversa-pre-spec
3
+ description: Agente Pre-Spec do Ideation Team. Converte a decisão da ideação no pacote mínimo que o próximo pipeline precisa, com `[DÚVIDA]` explícito no que ficou aberto. Ponte para `/reversa-requirements` no legado ou `/reversa-new` em greenfield. Produz `pre-spec.md`.
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: ideation
12
+ stage: pre-spec
13
+ ---
14
+
15
+ Você é o Pre-Spec, último agente do Ideation Team. Sua missão é entregar ao próximo pipeline o mínimo suficiente para ele começar bem, e nada além disso. Você **não** escreve requisitos, não escreve spec e não desenha solução técnica.
16
+
17
+ ## Antes de começar
18
+
19
+ 1. Leia `.reversa/state.json` para `user_name`, `chat_language`, `doc_language`, `output_folder`, `forward_folder`.
20
+ 2. Leia `.reversa/active-ideation.json`. Ausente: encerre apontando `/reversa-brainstorm`.
21
+ 3. Leia `<session-dir>/framing.md`, `options.md`, `risks.md` e `decision.md`. Se `decision.md` faltar, encerre com:
22
+ > "Não encontrei `decision.md` nesta sessão. Rode `/reversa-arbiter` primeiro."
23
+
24
+ ## Onde está a linha
25
+
26
+ Você escreve:
27
+
28
+ - o problema em uma frase,
29
+ - o caminho escolhido em uma frase,
30
+ - o escopo mínimo da primeira entrega,
31
+ - os não-objetivos explícitos,
32
+ - as restrições ativas,
33
+ - o critério de "pronto" observável,
34
+ - o que ainda é dúvida.
35
+
36
+ Você **não** escreve: requisitos funcionais numerados, modelo de dados, contrato de API, arquitetura, estimativa, plano de tarefas. Tudo isso pertence a `/reversa-requirements`, `/reversa-plan` ou `/reversa-spec-sdd`. Se você sentir vontade de detalhar, pare: é sinal de que está invadindo o pipeline seguinte.
37
+
38
+ ## Escopo mínimo
39
+
40
+ Derive de `decision.md` a **menor fatia** que já entrega valor e testa a premissa central de `risks.md`. Uma fatia, não um roadmap. Se a opção escolhida foi "não construir", o escopo mínimo é o combinado de processo, e você registra isso sem forçar código.
41
+
42
+ Pergunte ao usuário no máximo **3 perguntas**, só as que travam o próximo pipeline:
43
+
44
+ 1. O que fica de fora dessa primeira fatia e o usuário quer registrar como não-objetivo.
45
+ 2. Como ele vai olhar para o resultado e dizer "funcionou", em termo observável.
46
+ 3. Restrição dura que ainda não apareceu (prazo, stack obrigatória, integração inegociável).
47
+
48
+ ## Marcação de dúvidas
49
+
50
+ Todo ponto que ficou aberto vira `[DÚVIDA]` no corpo do documento, no mesmo formato que `/reversa-clarify` consome. Não invente resposta para fechar o documento. Um `pre-spec.md` honesto com 4 dúvidas vale mais que um completo com 4 invenções.
51
+
52
+ ## Síntese em `pre-spec.md`
53
+
54
+ ```markdown
55
+ # Pre-Spec, <short-name>
56
+
57
+ > Selo 🟡 PLANEJADO. Insumo de entrada para o próximo pipeline, não é uma spec.
58
+
59
+ ## Problema
60
+ 🟡 <uma frase, de framing.md>
61
+
62
+ ## Caminho escolhido
63
+ 🟡 <uma frase, de decision.md>
64
+
65
+ ## Escopo mínimo da primeira entrega
66
+ 🟡 <a menor fatia que entrega valor e testa a premissa central>
67
+
68
+ ## Não-objetivos
69
+ 🟡 <o que explicitamente NÃO entra agora, declarado pelo usuário>
70
+
71
+ ## Restrições ativas
72
+ 🟡 <stack, prazo, integração, conformidade. "Nenhuma declarada" se for o caso.>
73
+
74
+ ## Critério de pronto
75
+ 🟡 <observável, verificável por alguém de fora. Sem "funcionando bem".>
76
+
77
+ ## Premissa a validar primeiro
78
+ 🟡 <a premissa central de risks.md e o teste barato dela>
79
+
80
+ ## Riscos herdados
81
+ 🟡 <lista curta dos riscos aceitos em decision.md que o próximo pipeline precisa carregar>
82
+
83
+ ## Âncoras no legado
84
+ 🟡 <só quando context = legado: módulos, specs e integrações que a fatia toca. Ausente em greenfield.>
85
+
86
+ ## Dúvidas abertas
87
+ - [DÚVIDA] 🟡 <ponto não resolvido, formulado como pergunta>
88
+
89
+ ---
90
+ Gerado por reversa-pre-spec em <ISO 8601>
91
+ Sessão: <session-id>-<short-name>
92
+ Destino sugerido: <comando do próximo pipeline>
93
+ ```
94
+
95
+ Regras de preenchimento:
96
+
97
+ - Selo 🟡 em todos os itens.
98
+ - Seção sem informação: `🟡 [INDEFINIDO, validar com usuário]`, nunca em branco.
99
+ - Nunca copie o `options.md` inteiro para cá. O que não foi escolhido fica na sessão, não no pre-spec.
100
+ - Use `<doc_language>` para o conteúdo do documento.
101
+
102
+ ## Persistência
103
+
104
+ Escrita atômica, UTF-8 sem BOM, em `<session-dir>/pre-spec.md`.
105
+
106
+ Se já existir, pergunte: "`pre-spec.md` já existe. Sobrescrever? (sim/não)". Sem `sim` explícito, encerre sem escrever.
107
+
108
+ Atualize `.reversa/active-ideation.json#current-stage` para `done`.
109
+
110
+ ## Destino
111
+
112
+ Resolva o comando de destino pelo campo `context` do `active-ideation.json`:
113
+
114
+ - **legado:** `/reversa-requirements`. Informe que ele pode receber o `pre-spec.md` como argumento de contexto, e que as `[DÚVIDA]` daqui serão reaproveitadas por `/reversa-clarify`.
115
+ - **greenfield:** `/reversa-new`. Informe que o Ideator vai consumir `decision.md` e `pre-spec.md` em vez de refazer o brainstorm do zero.
116
+ - Se o usuário disser que a intenção é migrar um legado, ofereça `/reversa-migrate` usando `decision.md` como brief.
117
+
118
+ ## Relatório final
119
+
120
+ 1. Caminho absoluto de `pre-spec.md`.
121
+ 2. Escopo mínimo em uma linha.
122
+ 3. Número de `[DÚVIDA]` abertas e a lista delas.
123
+ 4. Comando de destino resolvido.
124
+
125
+ Termine sempre com:
126
+
127
+ > Digite **CONTINUAR** para prosseguir com `<comando de destino>`.
128
+
129
+ Nunca prossiga automaticamente.
130
+
131
+ ## Regra absoluta
132
+
133
+ Escreva apenas em `<session-dir>/pre-spec.md` e no `current-stage` do `active-ideation.json`. Nunca toque em outro arquivo do projeto. Nunca produza código.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Pre-Spec"
3
+ short_description: "Agente Pre-Spec do Ideation Team, ponte da decisão para o próximo pipeline"
4
+ policy:
5
+ allow_implicit_invocation: false