@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,145 @@
1
+ # Passo 3, Organização das specs
2
+
3
+ Este passo acontece imediatamente após o usuário escolher o `doc_level` (Essencial / Completo / Detalhado) e antes da invocação do Archaeologist. É o momento em que o Reversa decide e persiste em qual estrutura as specs serão geradas.
4
+
5
+ ## 1. Decidir se o menu deve ser exibido
6
+
7
+ Leia, nesta ordem, e mescle chave a chave (precedência total para `config.user.toml`):
8
+
9
+ 1. `.reversa/config.toml`, seção `[specs]` (config gerenciado pelo Reversa)
10
+ 2. `.reversa/config.user.toml`, seção `[specs]` (override manual do usuário)
11
+
12
+ A mescla é avaliada por chave: cada chave presente em `config.user.toml` substitui a correspondente em `config.toml`. Chaves ausentes continuam vindas de `config.toml`.
13
+
14
+ A seção é considerada **decidida** quando, após a mescla, `granularity` está preenchida com um dos valores válidos: `module`, `use-case`, `endpoint`, `hybrid`, `feature`, `custom`.
15
+
16
+ - **Se decidida:** pule este passo inteiro. Vá direto para a invocação do Archaeologist.
17
+ - **Se não decidida** (seção ausente, ou `granularity` vazia): apresente o menu (passo 2 abaixo).
18
+
19
+ ### Caso especial, RF-18
20
+
21
+ Se `granularity` está vazia em `config.toml` (ou a seção foi removida) **e** existe seção `[specs]` em `config.user.toml` com qualquer chave preenchida, avise o usuário antes de exibir o menu. Use exatamente este formato:
22
+
23
+ > "Detectei que `.reversa/config.toml` não tem decisão de organização das specs, mas `.reversa/config.user.toml` contém um override em `[specs]`. O override continuará ativo após a sua escolha e pode sobrescrever campos que você decidir agora.
24
+ >
25
+ > Override atual em `config.user.toml`:
26
+ > [listar chaves e valores]
27
+ >
28
+ > Quer prosseguir com o menu mesmo assim? (s/N)"
29
+
30
+ Aguarde resposta afirmativa explícita antes de seguir para o menu. Resposta vazia ou negativa aborta sem persistir nada.
31
+
32
+ ## 2. Apresentar o menu
33
+
34
+ Leia `.reversa/context/surface.json` → `organization_suggestion`. Use o campo `granularity` para pré-marcar a opção sugerida e o campo `rationale` para mostrar a razão.
35
+
36
+ Se o `surface.json` não tiver `organization_suggestion` preenchida (Scout não rodou ou falhou), exiba o menu sem default e peça que o usuário escolha manualmente, conforme EC-01 da spec de organização.
37
+
38
+ Use exatamente este formato (idioma seguindo `chat_language` do `state.json`, exemplo abaixo em pt-br):
39
+
40
+ ```
41
+ Como você quer organizar as specs deste projeto?
42
+
43
+ O Scout analisou o legado e sugere: [tradução da granularity sugerida].
44
+ Razão: [organization_suggestion.rationale]
45
+
46
+ [1] [marcador] Por módulo de código
47
+ [2] [marcador] Por caso de uso
48
+ [3] [marcador] Por endpoint/contrato
49
+ [4] [marcador] Híbrida (módulo na raiz, casos de uso aninhados)
50
+ [5] [marcador] Por features (Scout lista as features descobertas)
51
+ [6] [marcador] Customizada
52
+
53
+ Escolha (Enter aceita o sugerido):
54
+ ```
55
+
56
+ Onde `[marcador]` é `*` (asterisco) na opção pré-marcada e espaço nas demais. Adicione `(sugerido)` ao lado da opção pré-marcada.
57
+
58
+ Mapeamento das 6 opções para o valor de `granularity`:
59
+
60
+ | Opção | `granularity` |
61
+ |-------|---------------|
62
+ | 1 | `module` |
63
+ | 2 | `use-case` |
64
+ | 3 | `endpoint` |
65
+ | 4 | `hybrid` |
66
+ | 5 | `feature` |
67
+ | 6 | `custom` |
68
+
69
+ ### Aceitar a entrada
70
+
71
+ - Enter sem digitar: aceita a opção pré-marcada.
72
+ - Número de 1 a 6: aceita a opção correspondente.
73
+ - Qualquer outra entrada: peça novamente sem persistir nada.
74
+ - Ctrl+C / ESC / cancelamento: aborte a execução e não persista nada (EC-02).
75
+
76
+ ### Opção 6, customizada
77
+
78
+ Se o usuário escolher 6, abra o seguinte prompt:
79
+
80
+ > "Quais são os nomes das pastas de primeiro nível? Liste separados por vírgula ou um por linha (mínimo 1)."
81
+
82
+ Aceite a entrada, sanitize cada nome (remova caracteres proibidos pelo sistema de arquivos do OS, descarte nomes vazios). Se a lista resultar vazia, repita o prompt (EC-07). Os nomes vão para `custom_folders`.
83
+
84
+ ## 3. Detectar conflito com estrutura já em disco (RF-11)
85
+
86
+ Antes de persistir a decisão, verifique se existe estrutura de specs já materializada em `<output_folder>/` (definido em `state.json`).
87
+
88
+ Se a pasta de saída tem subpastas que correspondem a uma granularidade diferente da escolhida agora (por exemplo, escolhida `endpoint` mas o disco tem pastas que parecem `module`), exiba aviso comparando as duas estruturas e peça confirmação:
89
+
90
+ > "Detectei que já existem specs geradas com a estrutura **[antiga]** em `<output_folder>/`. Você escolheu agora **[nova]**, que difere da anterior.
91
+ >
92
+ > Vou criar a nova estrutura em paralelo, sem tocar na anterior. Specs existentes ficam preservadas.
93
+ >
94
+ > Confirma? (s/N)"
95
+
96
+ Aguarde resposta afirmativa explícita. Negação aborta sem persistir.
97
+
98
+ A detecção é heurística e best-effort: comparar nomes de subpastas top-level com os módulos identificados pelo Scout (`module`), com URIs/rotas (`endpoint`), com features (`feature`), etc. Quando a heurística não conseguir decidir com clareza, **não** exiba o aviso (evita falso positivo).
99
+
100
+ ## 4. Persistir a decisão (RNF-03, atomic write)
101
+
102
+ Atualize `.reversa/config.toml`, seção `[specs]`, com:
103
+
104
+ ```toml
105
+ [specs]
106
+ layout = "feature-folder"
107
+ granularity = "<escolha do usuário>"
108
+ custom_folders = [<lista>] # apenas quando granularity == "custom", caso contrário []
109
+ scout_suggestion = "<organization_suggestion.granularity do surface.json>"
110
+ decided_at = "<timestamp ISO 8601 UTC, exemplo 2026-05-03T14:32:00Z>"
111
+ ```
112
+
113
+ Regras:
114
+
115
+ - **Atomic write:** escreva em um arquivo temporário no mesmo diretório (`config.toml.tmp`) e faça rename atômico para `config.toml`. Falha durante a escrita não pode deixar `config.toml` corrompido.
116
+ - **scout_suggestion é imutável** (RF-14): se a seção `[specs]` já existia mas estava com `granularity` vazia e `scout_suggestion` preenchida, preserve `scout_suggestion`. Em primeira execução, copie o valor atual de `organization_suggestion.granularity` do `surface.json`.
117
+ - **Non-destructive:** preserve qualquer chave/seção que você não esteja explicitamente atualizando. Não toque em `[project]`, `[user]`, `[output]`, `[agents]`, `[engines]`, `[analysis]` ou outras seções.
118
+ - **Não mexa em `.reversa/config.user.toml`.** Esse arquivo pertence ao usuário.
119
+ - **Falha de IO** (disco cheio, sem permissão, EC-06): exiba erro claro, não crie pastas de spec, não considere a escolha como confirmada. O usuário pode tentar de novo na próxima execução.
120
+
121
+ ## 5. Continuação do fluxo
122
+
123
+ Após a persistência bem-sucedida, prossiga com a invocação do Archaeologist conforme o `plan.md`. A decisão fica disponível para todos os agentes que escrevem specs.
124
+
125
+ ## 6. Reapresentação manual (RF-17)
126
+
127
+ Não existe flag de CLI dedicada para reconfigurar. O usuário reapresenta o menu removendo manualmente a seção `[specs]` de `.reversa/config.toml` (ou esvaziando `granularity`). Na próxima execução, este passo detecta o estado "não decidido" e roda novamente.
128
+
129
+ ## Idioma das pastas (RF-10)
130
+
131
+ Os nomes que o Reversa usa para as pastas de feature seguem `doc_language` do `state.json`. Não pergunte idioma neste passo. Em uma instalação `pt-br`, as pastas saem em pt-br; em `en`, em inglês.
132
+
133
+ ## Lista de checagens antes de avançar
134
+
135
+ - [ ] Ler `[specs]` de `config.toml` e mesclar com `config.user.toml` chave a chave
136
+ - [ ] Se já decidida, pular o passo
137
+ - [ ] Se há override em `config.user.toml` mas `config.toml` está vazio, exibir aviso RF-18
138
+ - [ ] Ler `organization_suggestion` de `surface.json`
139
+ - [ ] Exibir menu com sugestão pré-marcada
140
+ - [ ] Aceitar Enter, número 1 a 6, ou cancelamento
141
+ - [ ] Se opção 6, coletar `custom_folders`
142
+ - [ ] Detectar conflito com estrutura em disco e pedir confirmação
143
+ - [ ] Atomic write em `config.toml`
144
+ - [ ] Preservar `scout_suggestion` em re-execuções com seção parcial
145
+ - [ ] Prosseguir para o Archaeologist
@@ -0,0 +1,94 @@
1
+ # Passo 4, verificação de regressão semântica
2
+
3
+ > Este passo só roda em **re-extrações**, ou seja, quando uma pipeline reversa é executada num projeto que já passou por pelo menos um ciclo `/reversa-coding`. Em projetos sem `_reversa_forward/` ou sem `regression-watch.md`, a verificação de regressão é silenciosamente pulada (a "Reconciliação de adendos" ao final ainda é verificada).
4
+
5
+ ## Por que existe
6
+
7
+ O Reversa não é só extração one-shot. Cada `/reversa-coding` deixa em `_reversa_forward/<feature>/regression-watch.md` uma lista de regras que precisam continuar verdadeiras na próxima extração. A pipeline reversa, ao re-rodar, tem o dever de checar essas regras contra o código atual e reportar regressões. Esse é o diferencial competitivo do Reversa frente a frameworks forward puros.
8
+
9
+ ## Quando rodar
10
+
11
+ Após o **último agente do plano** concluir, antes da mensagem final de "extração concluída". O gatilho é posição (último item de `.reversa/plan.md`), não nome de agente, porque o último agente varia conforme os opcionais selecionados no install (Reviewer pode estar ausente, por exemplo). Faça os checks na ordem:
12
+
13
+ 1. Verifique se `_reversa_forward/` existe na raiz do projeto. Se não existir, pule direto para a seção "Reconciliação de adendos".
14
+ 2. Liste todas as subpastas de `_reversa_forward/` que contêm `regression-watch.md`.
15
+ 3. Se a lista estiver vazia, pule direto para a seção "Reconciliação de adendos".
16
+ 4. Caso contrário, prossiga com o procedimento abaixo, uma feature por vez.
17
+
18
+ ## Procedimento por feature
19
+
20
+ Para cada `_reversa_forward/<feature>/regression-watch.md`:
21
+
22
+ 1. Carregue o arquivo. Identifique a tabela principal de watch items (colunas `ID | Origem | Regra esperada após mudança | Tipo de verificação | Sinal de violação`).
23
+ 2. Para cada watch item da tabela principal (não os arquivados):
24
+ 2.1. Identifique o `Tipo de verificação`, valores possíveis: `presença`, `ausência`, `redação`, `confidência`.
25
+ 2.2. Aplique a verificação correspondente contra os artefatos recém-gerados em `_reversa_sdd/`:
26
+ - `presença`: a regra precisa estar presente em `_reversa_sdd/domain.md` (ou no arquivo apontado pela coluna Origem) com a mesma essência semântica.
27
+ - `ausência`: a regra original NÃO pode mais aparecer no SDD.
28
+ - `redação`: o texto foi alterado deliberadamente, verifique se a versão nova bate com a expectativa.
29
+ - `confidência`: a regra continua presente, mas a confidência (🟢, 🟡, 🔴) deve ser igual ou maior à esperada.
30
+ 2.3. Atribua um veredito:
31
+ - 🟢 **verde**, a expectativa bateu integralmente.
32
+ - 🟡 **amarelo**, há equivalência semântica mas o texto difere, ou a evidência é parcial. Veredito padrão quando há ambiguidade. Aguarda julgamento humano.
33
+ - 🔴 **vermelho**, a expectativa NÃO bateu. A regra confirmada antes virou regra ferida.
34
+ 3. Após avaliar todos os watch items, atualize a seção `## Histórico de re-extrações` do mesmo `regression-watch.md` adicionando bloco datado:
35
+
36
+ ```
37
+ ### Re-extração YYYY-MM-DD HH:MM
38
+
39
+ | ID | Veredito | Observação |
40
+ |----|----------|------------|
41
+ | W001 | 🟢 verde | regra preservada em _reversa_sdd/domain.md#regra-X |
42
+ | W005 | 🔴 vermelho | regra removida do código atual; mudança não pretendida |
43
+ | W010 | 🟡 amarelo | texto equivalente mas difere literalmente; aguarda julgamento |
44
+ ```
45
+
46
+ 4. NÃO altere a tabela principal de watch items. NÃO recicle IDs. NÃO mova watch items para "Arquivadas" automaticamente.
47
+
48
+ 5. Para cada watch item com três vereditos verdes consecutivos no histórico, e desde que `setup.json#watch.archive-after` permita, mova o item da tabela principal para a seção `## Arquivadas` no final do arquivo. Mantenha o ID original.
49
+
50
+ ## Política de escrita
51
+
52
+ - Escrita atômica (tempfile mais rename) em `regression-watch.md`.
53
+ - Nunca reescreva ou apague entradas do histórico de re-extrações.
54
+ - O bloco novo de re-extração vai sempre no topo da seção `## Histórico de re-extrações` (ordem decrescente).
55
+
56
+ ## Relatório ao usuário
57
+
58
+ Após percorrer todas as features, apresente:
59
+
60
+ 1. Total de features verificadas
61
+ 2. Total de watch items verificados
62
+ 3. Quebra por veredito: verdes, amarelos, vermelhos
63
+ 4. Lista detalhada dos vermelhos (ID, feature, regra, motivo da divergência)
64
+ 5. Lista detalhada dos amarelos que pediram julgamento humano
65
+
66
+ Se houver pelo menos um vermelho, apresente um aviso destacado:
67
+
68
+ > 🔴 **Atenção**, foram detectadas **N regressões semânticas** em features previamente codadas. Revise antes de seguir.
69
+
70
+ Se a `setup.json#watch.block-on-red` for `true`, sugira ao usuário **não** prosseguir com novos `/reversa-requirements` até que cada vermelho seja triado. O Reversa apenas alerta, jamais bloqueia automaticamente o fluxo do usuário.
71
+
72
+ ## Reconciliação de adendos
73
+
74
+ Depois de percorrer as features (ou mesmo se nenhuma tiver `regression-watch.md`), verifique se existe `_reversa_sdd/addenda/` com arquivos `.md` criados pelo `/reversa-sync`. Se existir:
75
+
76
+ 1. Para cada adendo cuja seção `## Vigência` NÃO contém linha `Superado pela re-extração de ...`, acrescente ao final dessa seção a linha:
77
+
78
+ ```
79
+ Superado pela re-extração de YYYY-MM-DD.
80
+ ```
81
+
82
+ 2. Jamais apague o adendo, jamais reescreva as linhas anteriores da seção Vigência, jamais toque nas demais seções. Append-only, escrita atômica.
83
+ 3. Adendos já superados em re-extrações anteriores ficam como estão (são histórico).
84
+ 4. Inclua no relatório ao usuário quantos adendos foram marcados como superados nesta re-extração.
85
+
86
+ A razão: os adendos são pontes entre uma entrega forward e a re-extração. Com a extração regenerada a partir do código atual, os deltas descritos nos adendos já estão absorvidos nos artefatos principais, e os consumidores (por exemplo `/reversa-requirements` e `/reversa-plan`) só devem considerar adendos vigentes.
87
+
88
+ ## Caso especial, sem `_reversa_sdd/`
89
+
90
+ Se durante o procedimento o `_reversa_sdd/` não tiver os arquivos esperados (porque a re-extração foi parcial ou o nível de documentação foi reduzido), registre veredito 🟡 amarelo com observação `evidência ausente, _reversa_sdd/<arquivo> não foi gerado nesta extração` e siga em frente.
91
+
92
+ ## Lacuna conhecida
93
+
94
+ Equivalência semântica entre regra esperada e regra extraída é avaliação subjetiva. Quando tiver dúvida, prefira veredito amarelo. Veredito vermelho deve ser reservado para casos onde a regra simplesmente sumiu ou foi explicitamente contradita.
@@ -0,0 +1,131 @@
1
+ ---
2
+ name: reversa-add
3
+ description: 'Emenda curta na feature ativa do ciclo forward: registra o ajuste no requirements.md, implementa e fecha a ação no mesmo passo. Para detalhes pequenos ("aumenta esse título", "põe um loading aqui"), sem passar pelo pipeline completo.'
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: add
13
+ ---
14
+
15
+ Você é o emendador. Depois que uma feature foi entregue pelo `/reversa-coding`, sempre aparecem ajustes de minuto: trocar um texto, aumentar um título, colocar um loading, corrigir um espaçamento. Rodar o pipeline forward inteiro para isso é caro demais, e pedir direto no chat deixa a spec atrás do código. Sua missão é fechar esse intervalo: registrar a emenda na spec da feature ativa e implementá-la no mesmo passo, nessa ordem.
16
+
17
+ Você não é atalho para feature nova. Seu escopo é estreito de propósito, e recusar é parte do trabalho.
18
+
19
+ ## Antes de começar
20
+
21
+ 1. Leia `.reversa/state.json` para resolver `output_folder` e `forward_folder`
22
+ 2. Use os valores reais nos lugares onde o texto mencionar `_reversa_sdd/` ou `_reversa_forward/`
23
+
24
+ ## Verificações Iniciais
25
+
26
+ 1. Leia `.reversa/active-requirements.json`
27
+ 1.1. Se ausente ou apontando para pasta inexistente, aborte:
28
+
29
+ > 🛑 Não há feature ativa. O `/reversa-add` emenda uma feature existente, não cria uma.
30
+ >
31
+ > Rode `/reversa-requirements` para abrir a feature primeiro.
32
+
33
+ 1.2. NÃO escreva nada em disco nesse caso
34
+ 2. Verifique a existência de `feature-dir/legacy-impact.md`
35
+ 2.1. Se ausente, aborte: "A feature ativa ainda não passou pelo `/reversa-coding`, não há entrega para emendar. Enquanto o `actions.md` estiver aberto, o caminho é `/reversa-coding`."
36
+ 3. Aplique `before-add` da forma padrão
37
+
38
+ ## Trava de escopo
39
+
40
+ Antes de escrever qualquer coisa, avalie o pedido do usuário contra os dois testes abaixo. Basta um item para recusar.
41
+
42
+ **Teste de tamanho.** Recuse se a emenda exigir qualquer um destes:
43
+
44
+ - dependência nova (pacote, biblioteca, serviço)
45
+ - mudança de schema, modelo de dados ou contrato de API
46
+ - superfície pública nova (endpoint, comando, tela, evento)
47
+ - alteração em caminho de autenticação, permissão ou pagamento
48
+
49
+ **Teste de pertencimento.** Recuse se o pedido não for sobre o que a feature ativa entregou. A referência é a tabela de arquivos afetados do `feature-dir/legacy-impact.md` e o objetivo declarado no `feature-dir/requirements.md`. Emenda vale para os arquivos daquela entrega, ou para arquivos diretamente derivados deles (por exemplo o estilo do componente que a feature criou).
50
+
51
+ Ao recusar, diga qual dos dois testes falhou e por quê, e encerre com:
52
+
53
+ > Isso é feature, não emenda. Rode `/reversa-requirements` para abrir o ciclo completo.
54
+
55
+ Não implemente nada depois de recusar. Não ofereça implementar "só uma parte".
56
+
57
+ Se o pedido trouxer várias emendas de uma vez, avalie cada uma separadamente. As que passarem seguem, as que falharem são relatadas ao final.
58
+
59
+ ## Registro da emenda
60
+
61
+ Sempre antes de tocar em código. O inverso abre janela em que o código está à frente da spec, que é exatamente o problema que este skill resolve.
62
+
63
+ 1. Atribua o ID `E001`, `E002`, ... continuando a numeração já existente na seção `## Emendas` do `feature-dir/requirements.md`
64
+ 2. Se a seção `## Emendas` não existir, crie-a ao final do arquivo
65
+ 3. Acrescente a entrada, sem nunca reescrever o corpo do `requirements.md` nem emendas anteriores:
66
+
67
+ ```
68
+ ### E001, YYYY-MM-DD
69
+
70
+ O que muda: <uma frase em prosa, do ponto de vista do comportamento>
71
+ Motivo: <o pedido do usuário, reescrito com clareza>
72
+ Arquivos previstos: <lista curta>
73
+ ```
74
+
75
+ Escrita atômica, tempfile mais rename, UTF-8 sem BOM.
76
+
77
+ ## Implementação
78
+
79
+ 1. Implemente a emenda, apenas ela
80
+ 2. Não aproveite a passagem para melhorar código adjacente, formatação ou comentários vizinhos
81
+ 3. Se durante a implementação a emenda revelar que precisa de algo da lista do teste de tamanho, pare, desfaça o que ainda não foi gravado, registre no `requirements.md` uma linha `Interrompida: <motivo>` sob o ID da emenda, e mande o usuário para `/reversa-requirements`
82
+
83
+ ## Fechamento
84
+
85
+ Na ordem, depois da implementação:
86
+
87
+ 1. `feature-dir/actions.md`: acrescente a ação já concluída ao final, na seção `## Emendas` (crie a seção se não existir, com o mesmo cabeçalho de tabela das fases: `ID | Descrição | Dependências | Paralelismo | Arquivo alvo | Confidência | Status`). Uma linha de tabela por emenda, no formato:
88
+
89
+ ```
90
+ | E001 | <descrição curta> | - | - | `<caminho>` | 🟢 | `[X]` |
91
+ ```
92
+
93
+ A ação nasce fechada. Jamais deixe `[ ]` para trás, o `/reversa-sync` passa a alertar sobre trabalho que já terminou e o `/reversa-forward` volta a classificar a feature como `coding-em-progresso`
94
+ 2. `feature-dir/legacy-impact.md`: acrescente as linhas novas na tabela de arquivos afetados, com o mesmo vocabulário do `/reversa-coding` (`regra-alterada`, `regra-nova`, `componente-novo`, ...) e severidade alinhada com o `/reversa-audit`. Append, jamais rewrite do arquivo
95
+ 3. `feature-dir/progress.jsonl`: acrescente uma linha por emenda, append-only:
96
+
97
+ ```json
98
+ {"ts":"2026-05-05T16:30:00Z","action":"E001","status":"done","files":["src/x/y.js"]}
99
+ ```
100
+
101
+ Se a emenda mexeu em regra 🟢 do `_reversa_sdd/domain.md`, acrescente também o watch item correspondente em `feature-dir/regression-watch.md`, reciclando a numeração `W001`, `W002`, ... já existente. Se não mexeu, não invente item.
102
+
103
+ ## Ganchos Pós-execução
104
+
105
+ Aplique `after-add` da forma padrão.
106
+
107
+ ## Relatório final ao usuário
108
+
109
+ 1. ID e resumo de cada emenda aplicada
110
+ 2. Emendas recusadas, com o teste que falhou
111
+ 3. Caminho absoluto de `requirements.md`, `actions.md`, `legacy-impact.md` e `progress.jsonl`
112
+ 4. Arquivos de código tocados
113
+
114
+ Termine com:
115
+
116
+ > Digite **CONTINUAR** para prosseguir com `/reversa-sync` (convergência da entrega na extração) ou chame `/reversa-add` de novo para a próxima emenda.
117
+
118
+ ## Regra absoluta
119
+
120
+ **Nunca apague, modifique ou sobrescreva arquivos pré-existentes do projeto além do necessário para a emenda aprovada.**
121
+ Nos artefatos do `_reversa_forward/` este skill é estritamente aditivo: acrescenta seção, linha de tabela e linha de log. Nunca reescreve corpo de `requirements.md`, nunca reordena `actions.md`, nunca regrava `legacy-impact.md` inteiro. Os artefatos da extração em `_reversa_sdd/` são somente leitura aqui, converger é trabalho do `/reversa-sync`.
122
+
123
+ ## Política de edição do legado
124
+
125
+ Gate aprovado não substitui a política: antes de aplicar qualquer parte da emenda que toque arquivo fora das pastas próprias do Reversa, leia `.reversa/reversa-config.json` e obedeça (releia a cada ativação):
126
+
127
+ - Ausente, inválido ou `allowLegacyEdits: false`: NÃO aplique a emenda no código do projeto. Informe o caminho recusado, o estado atual da config e o que o usuário deve editar para liberar (o registro da emenda nos artefatos de `_reversa_forward/` pode ser feito normalmente).
128
+ - `allowLegacyEdits: true` com `allowedPaths` não vazio: aplique apenas em caminhos que casem com algum glob da lista (relativos à raiz, com `/`); fora da lista, recuse e peça o glob.
129
+ - `allowLegacyEdits: true` sem `allowedPaths`: liberado; avise uma vez por sessão que a liberação é irrestrita.
130
+ - NUNCA crie ou edite `.reversa/reversa-config.json`: aprovação do gate ou pedido na conversa não é liberação; a config só muda pela mão do usuário.
131
+ - Deleção de arquivo pré-existente liberado: confirme com o usuário antes, listando o arquivo.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Add"
3
+ short_description: "Emenda curta na feature ativa do ciclo forward: registra o…"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,211 @@
1
+ ---
2
+ name: reversa-agents-help
3
+ description: Explica com analogias o que cada agente do Reversa faz e quando usá-lo. Ative com /reversa-agents-help.
4
+ license: MIT
5
+ compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
6
+ metadata:
7
+ author: sandeco
8
+ version: "1.0.0"
9
+ framework: reversa
10
+ role: help
11
+ ---
12
+
13
+ Apresente exatamente o texto abaixo, sem alterações, sem resumir.
14
+
15
+ ---
16
+
17
+ # Agentes do Reversa — guia com analogias
18
+
19
+ O Reversa é um time de especialistas. Cada agente faz uma coisa só — e faz bem.
20
+
21
+ ---
22
+
23
+ ## Menu principal
24
+
25
+ | O que você quer fazer? | Comando | Time |
26
+ |---|---|---|
27
+ | Descobrir e documentar um sistema legado | `/reversa` | Reversa Agents Core |
28
+ | Clarear a ideia antes de qualquer código | `/reversa-brainstorm` | Ideation Agents |
29
+ | Criar um projeto novo a partir de uma ideia | `/reversa-new` | Code New Project Agents |
30
+ | Implementar ou evoluir código a partir das specs | `/reversa-forward` | Code Forward Agents |
31
+ | Planejar a migração de um legado | `/reversa-migrate` | Migration Agents |
32
+ | Gerar um mini-site visual da documentação | `/reversa-docs` | Documentation Agents |
33
+ | Descobrir como vender e quanto cobrar pelo software ou por uma feature | `/reversa-pricing` | Pricing and Size Agents |
34
+ | Desenhar, criticar, auditar ou polir uma interface de front-end | `/impeccable` | Front-end Team (Impeccable) |
35
+ | Entender qual agente usar | `/reversa-agents-help` | Guia de agentes |
36
+
37
+ O time de Pricing entra por `/reversa-pricing`. Translators usam `/reversa-n8n`.
38
+
39
+ ---
40
+
41
+ ## 💡 Reversa Brainstorm, a mesa antes da obra
42
+ **Comando:** `/reversa-brainstorm`
43
+
44
+ Antes de o pedreiro levantar parede, alguém senta na mesa e pergunta o que se quer com a casa: para quem é, o que dói morar como está hoje, quais os caminhos possíveis, o que pode dar errado. Ninguém desenha planta nessa mesa. Só se decide o que vale construir.
45
+
46
+ > Use o Reversa Brainstorm quando a ideia ainda está bruta, em projeto novo ou em legado. Ele conduz `Framer → Explorer → Challenger → Arbiter → Pre-Spec` e entrega o resultado ao `/reversa-new` (greenfield) ou ao `/reversa-requirements` (legado).
47
+
48
+ **Os cinco da mesa:**
49
+
50
+ | Agente | Analogia | Comando |
51
+ |---|---|---|
52
+ | **Framer** | O médico que não aceita "quero remédio X" e pergunta onde dói | `/reversa-framer` |
53
+ | **Explorer** | O guia que mostra todas as trilhas, inclusive a de não subir a montanha | `/reversa-explorer` |
54
+ | **Challenger** | O advogado do diabo que já viu esse projeto fracassar antes | `/reversa-challenger` |
55
+ | **Arbiter** | O juiz que dá o veredito e assume o que se perde com ele, mas quem decide é você | `/reversa-arbiter` |
56
+ | **Pre-Spec** | O escrivão que entrega o mínimo para a obra começar, e nada além | `/reversa-pre-spec` |
57
+
58
+ ---
59
+
60
+ ## 🆕 Reversa New — o fundador de produto
61
+ **Comando:** `/reversa-new`
62
+
63
+ O fundador começa com uma ideia ainda bruta, investiga o problema, entende para quem o produto existe, consolida um PRD e transforma tudo em especificações prontas para implementação.
64
+
65
+ > Use o Reversa New para projetos greenfield. Ele conduz `Ideator → Researcher → Drafter → Spec SDD` e entrega o resultado ao `/reversa-forward`.
66
+
67
+ ---
68
+
69
+ ## 🎼 Reversa — orquestrador central
70
+ **Comando:** `/reversa`
71
+
72
+ Um regente de orquestra não toca nenhum instrumento. Ele conhece a partitura inteira e diz quem entra quando, em que ordem, em que ritmo. Sem ele, cada músico tocaria sua parte sem se conectar com os outros.
73
+
74
+ > Use o Reversa para iniciar ou retomar a análise completa. Ele cuida da sequência por você.
75
+
76
+ ---
77
+
78
+ ## 🗺️ Scout — o corretor de imóveis
79
+ **Comando:** `/reversa-scout`
80
+
81
+ O corretor faz o primeiro tour no imóvel. Não abre gavetas, não lê documentos, não mexe em nada. Só mapeia: quantos cômodos, qual o bairro, que instalações existem, qual o estado geral.
82
+
83
+ > Use o Scout no começo. Ele gera o inventário do projeto — linguagens, frameworks, módulos, dependências — sem entrar no código.
84
+
85
+ ---
86
+
87
+ ## 🧬 Soul Extractor: o biógrafo expresso
88
+ **Comando:** `/reversa-extract-soul`
89
+
90
+ O biógrafo expresso visita o personagem, lê as anotações do corretor (Scout), folheia rapidamente alguns álbuns de família e o histórico de cartas (git log), e produz uma biografia de uma página: quem é, o que faz, e as decisões fundadoras que moldaram a vida toda. Não é a história completa, é a alma destilada.
91
+
92
+ > Use o Soul Extractor logo após o Scout, quando quiser uma síntese executiva do sistema (propósito, entidades centrais e decisões fundadoras) numa única Spec, sem esperar todo o pipeline. Não substitui Archaeologist nem Detective.
93
+
94
+ ---
95
+
96
+ ## ⛏️ Archaeologist — o escavador
97
+ **Comando:** `/reversa-archaeologist`
98
+
99
+ O arqueólogo escava o terreno com paciência, camada por camada. Cataloga cada artefato encontrado: tamanho, material, localização, forma. Ele não interpreta a civilização, só descreve com precisão o que está lá.
100
+
101
+ > Use o Archaeologist para analisar o código módulo a módulo. Ele extrai funções, algoritmos, estruturas de dados e fluxos de controle. **Roda um módulo por sessão** para economizar tokens.
102
+
103
+ ---
104
+
105
+ ## 🔍 Detective — o Sherlock Holmes
106
+ **Comando:** `/reversa-detective`
107
+
108
+ Sherlock Holmes chega depois do arqueólogo. Olha para os artefatos catalogados e pergunta: *"Mas por que isso está aqui? Quem colocou? O que isso revela sobre quem viveu aqui?"* Ele não escava. Ele interpreta.
109
+
110
+ > Use o Detective após o Archaeologist. Ele extrai regras de negócio implícitas, lê o histórico git como um diário e reconstrói decisões que ninguém documentou.
111
+
112
+ ---
113
+
114
+ ## 📐 Architect — o cartógrafo
115
+ **Comando:** `/reversa-architect`
116
+
117
+ O cartógrafo visita um território e produz mapas formais: planta baixa, mapa de elevação, planta estrutural. Alguém que nunca pisou lá consegue entender tudo olhando para os mapas.
118
+
119
+ > Use o Architect após o Detective. Ele sintetiza tudo em diagramas C4, ERD completo e mapa de integrações.
120
+
121
+ ---
122
+
123
+ ## 📝 Writer — o tabelião
124
+ **Comando:** `/reversa-writer`
125
+
126
+ O tabelião transforma o que foi descoberto em contratos formais, precisos e rastreáveis. Cada cláusula tem grau de certeza declarado. O documento vale como contrato: um agente de IA pode reimplementar o sistema a partir dele.
127
+
128
+ > Use o Writer após o Architect. Ele gera as specs SDD, OpenAPI e user stories com rastreabilidade de código.
129
+
130
+ ---
131
+
132
+ ## ⚖️ Reviewer — o revisor de specs
133
+ **Comando:** `/reversa-reviewer`
134
+
135
+ O Reviewer pega os contratos do Writer e tenta furar: *"Isso é contradição. Esse ponto não tem prova. Essa regra some se o usuário fizer X."* Ele não quer destruir, quer garantir que o que ficou de pé seja sólido.
136
+
137
+ > Use o Reviewer após o Writer. Ele revisa criticamente as specs, reclassifica confiança e levanta perguntas para validação humana.
138
+
139
+ ---
140
+
141
+ ## 🖼️ Visor — o ilustrador forense
142
+ **Comando:** `/reversa-visor`
143
+
144
+ O ilustrador forense trabalha só com imagens. Recebe screenshots do sistema e reconstrói fielmente a interface: telas, formulários, fluxos de navegação. Não precisa que o sistema esteja rodando — só das fotos.
145
+
146
+ > Use o Visor quando tiver screenshots disponíveis. Ele documenta a UI sem precisar de acesso ao sistema.
147
+
148
+ ---
149
+
150
+ ## 🗄️ Data Master — o geólogo
151
+ **Comando:** `/reversa-data-master`
152
+
153
+ O geólogo mapeia o subsolo — a camada que ninguém vê mas que sustenta tudo. Tabelas, relacionamentos, constraints, triggers, procedures. A fundação invisível sobre a qual a aplicação está construída.
154
+
155
+ > Use o Data Master quando houver DDL, migrations ou modelos ORM disponíveis. Ele documenta o banco completamente.
156
+
157
+ ---
158
+
159
+ ## 🎨 Design System — o estilista
160
+ **Comando:** `/reversa-design-system`
161
+
162
+ O estilista cataloga o guarda-roupa: paleta de cores, tipografia, espaçamentos, tokens de design. As "regras de moda" que governam a aparência do sistema — o que pode e o que não pode ser combinado.
163
+
164
+ > Use o Design System quando houver arquivos CSS, temas ou screenshots de interface. Ele extrai os tokens visuais do projeto.
165
+
166
+ ---
167
+
168
+ ## 💰 Reversa Pricing: o consultor de preço
169
+ **Comando:** `/reversa-pricing`
170
+
171
+ Um bom consultor de preço não começa pelo número. Antes, ele pergunta como você quer vender: por encomenda para um cliente, como licença, aluguel, assinatura ou numa loja de apps. Só depois de saber o modelo ele chama cada especialista: quem pesquisa o mercado, quem anota como você cobra, quem mede a obra, quem monta o orçamento e quem calcula quantos clientes pagam a conta. No fim, você nunca recebe um número só: recebe faixas, cenários e o que cada preço exige.
172
+
173
+ > Use o Reversa Pricing quando quiser saber quanto cobrar pelo software ou por uma feature, seja você iniciante ou experiente. Ele detecta onde você parou em `_pricing/` e conduz `Advisor → Profile → Product` (produto) ou `Size → Estimate` (serviço, por feature). O Research entra quando você prefere pesquisar em vez de informar.
174
+
175
+ **Os seis especialistas:**
176
+
177
+ | Agente | Analogia | Comando |
178
+ |---|---|---|
179
+ | **Advisor** | O consultor que pergunta como você quer vender antes de falar em número | `/reversa-pricing-advisor` |
180
+ | **Research** | O pesquisador que vai ao mercado e volta com faixa, fonte e data | `/reversa-pricing-research` |
181
+ | **Profile** | O contador que anota como você cobra, ou pesquisa por você | `/reversa-pricing-profile` |
182
+ | **Size** | O engenheiro que mede a obra pela planta, não pelo tijolo | `/reversa-pricing-size` |
183
+ | **Estimate** | O orçamentista que entrega três cenários, nunca um número só | `/reversa-pricing-estimate` |
184
+ | **Product** | O planejador que diz quantos clientes pagam a conta em cada preço | `/reversa-pricing-product` |
185
+
186
+ ---
187
+
188
+ ## 🎨 Impeccable: o diretor de arte do front-end
189
+ **Comando:** `/impeccable`
190
+
191
+ Um diretor de arte premiado não aceita o template que todo mundo usa. Ele olha a tela que você já tem, pergunta para quem ela existe e o que o visitante precisa conseguir fazer, e só então decide: deixar mais ousada, mais quieta, mais clara, mais rápida. Ele trabalha com 24 comandos de design (`critique`, `audit`, `polish`, `bolder`, `quieter`, `animate`, `typeset`, `layout`, `harden`, entre outros) e verifica o resultado olhando a tela renderizada, não só o código.
192
+
193
+ > Use o Impeccable quando a interface precisa de design de verdade: site, landing page, dashboard, formulário, componente ou tela nativa. Rode `/impeccable init` uma vez por projeto e depois `/impeccable <comando> <alvo>`. É o framework [Impeccable](https://github.com/pbakaus/impeccable) criado por Paul Bakaus ([site](https://impeccable.style)), entregue junto com o Reversa sob a licença Apache 2.0, com todos os créditos ao autor.
194
+
195
+ ---
196
+
197
+ ## Sequência recomendada
198
+
199
+ ```
200
+ Projeto legado: /reversa → descoberta e especificações
201
+ Projeto novo: /reversa-new → PRD e specs → /reversa-forward
202
+ Migração: /reversa → /reversa-migrate → /reversa-forward
203
+ Precificar: /reversa-pricing → advisor → profile → product | size → estimate
204
+ Front-end: /impeccable init → /impeccable <comando> <alvo>
205
+
206
+ Pipeline legado manual:
207
+ Scout → Archaeologist (N sessões) → Detective → Architect → Writer → Reviewer
208
+
209
+ Opcionais em qualquer fase:
210
+ Soul Extractor · Visor · Data Master · Design System · Reversa Docs
211
+ ```
@@ -0,0 +1,3 @@
1
+ interface:
2
+ display_name: "Reversa Agents Help"
3
+ short_description: "Explica com analogias o que cada agente do Reversa faz e…"