@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,52 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: migration_brief
7
+ producedBy: orchestrator
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Migration Brief
12
+
13
+ > Documento de critério de migração coletado em entrevista no início do `/reversa-migrate`.
14
+ > Consumido pelos seis agentes do Time de Migração. Não pergunta paradigma (responsabilidade do Paradigm Advisor) nem apetite (derivado em `paradigm_decision.md`).
15
+
16
+ ## Objetivo da migração
17
+ <Por que esta migração existe? O que muda no negócio se ela acontecer ou não.>
18
+
19
+ ## Métricas de sucesso
20
+ - <métrica 1, com alvo numérico ou qualitativo claro>
21
+ - <métrica 2>
22
+ - <métrica 3>
23
+
24
+ ## Restrições
25
+ - **Prazo**: <data ou janela>
26
+ - **Orçamento**: <faixa, time, contratação envolvida>
27
+ - **Técnicas**: <APIs externas que não podem mudar, contratos, regras regulatórias>
28
+ - **Operacionais**: <janelas de manutenção, SLAs durante a migração>
29
+
30
+ ## Fatores de risco conhecidos
31
+ - <risco 1: descrição curta>
32
+ - <risco 2>
33
+
34
+ ## Stakeholders
35
+ | Nome / papel | Responsabilidade na migração |
36
+ |---|---|
37
+ | <nome> | <responsabilidade> |
38
+
39
+ ## Stack alvo
40
+ - **Linguagem**: <ex: Node.js 20>
41
+ - **Framework**: <ex: Fastify>
42
+ - **Banco**: <ex: PostgreSQL 16>
43
+ - **Mensageria** (se houver): <ex: SQS, Kafka, none>
44
+ - **Infra**: <ex: AWS Lambda, Kubernetes, on-premise>
45
+ - **Outros componentes relevantes**: <cache, observabilidade, gateway>
46
+
47
+ ## Escopo declarado
48
+ - **Incluído**: <módulos do legado que entram>
49
+ - **Excluído**: <módulos que ficam de fora ou serão descontinuados>
50
+
51
+ ## Notas livres
52
+ <Qualquer contexto que o usuário queira deixar registrado para os agentes lerem.>
@@ -0,0 +1,36 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: pending_decisions
7
+ producedBy: orchestrator
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Pending Decisions
12
+
13
+ > Arquivo transitório usado durante pausas humanas. Cada item descreve uma decisão aberta com contexto e opções.
14
+ > Após o usuário responder, o item é movido para `ambiguity_log.md` (ou para o artefato dono da decisão) e este arquivo pode ser apagado.
15
+
16
+ ## Decisões abertas
17
+
18
+ ### PD-001
19
+ - **Agente que solicitou**: paradigm_advisor | curator | strategist | designer | screen_translator | inspector
20
+ - **Tópico**: <título curto>
21
+ - **Contexto**:
22
+ <texto explicando por que essa decisão é necessária aqui>
23
+ - **Opções**:
24
+ 1. <opção 1>
25
+ 2. <opção 2>
26
+ 3. <opção 3>
27
+ - **Default proposto** (usado em `--auto`): <opção número>
28
+ - **Impacto se decidido errado**: <texto>
29
+ - **Onde a decisão será gravada**: <ex: `paradigm_decision.md § Decisão do usuário`>
30
+
31
+ <repetir por decisão>
32
+
33
+ ## Como responder
34
+
35
+ - No chat: respondendo direto ao agente com o número da opção e justificativa.
36
+ - Em arquivo: editando este `pending_decisions.md`, adicionando um campo `Resposta:` em cada item.
@@ -0,0 +1,77 @@
1
+ ---
2
+ name: reversa-modularize
3
+ description: 'Modularização: divide um trecho grande em módulos coesos com responsabilidade definida, respeitando as fronteiras da alma. Não mexe na lógica interna nem inverte dependências.'
4
+ disable-model-invocation: true
5
+ license: MIT
6
+ compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
7
+ metadata:
8
+ author: sandeco
9
+ version: "1.0.0"
10
+ framework: reversa
11
+ team: refactor
12
+ phase: maintenance
13
+ role: specialist
14
+ ---
15
+
16
+ Você é o modularizador. Sua missão é dividir um trecho que faz coisas demais em módulos menores, coesos e com responsabilidade bem definida, sem alterar o comportamento observável. Foco estrito: fronteiras de módulo e distribuição de responsabilidade. Você não mexe na lógica interna de um método nem inverte dependências uma a uma.
17
+
18
+ ## Antes de começar
19
+
20
+ 1. Leia `.reversa/state.json` (`output_folder`, `chat_language`, `doc_language`, `user_name`)
21
+ 2. Leia `_reversa_refactor/README.md` (`control_mode`, `safety_net_policy`). Se `_reversa_refactor/` não existir, aborte: "Rode `/reversa-refactor` primeiro."
22
+ 3. Converse em `chat_language`; escreva artefatos em `doc_language`; nunca use travessão
23
+
24
+ ## Seleção da oportunidade
25
+
26
+ 1. Com argumento (`/reversa-modularize OPP-...`): resolva no `opportunities/` do contexto
27
+ 2. Sem argumento: aceite um alvo natural, resolva o contexto, crie a oportunidade `modularize` se preciso
28
+ 3. Recuse alvos que não sejam modularização: reencaminhe ao verbo certo
29
+
30
+ ## Modo de controle
31
+
32
+ Siga o `control_mode` do README (`gated` por padrão): análise e prova fluem; todo passo que toca o código passa por gate com diff.
33
+
34
+ ## Rede de segurança (obrigatória antes de tocar o código)
35
+
36
+ Mover código quebra referências com facilidade. Exija testes que cubram o comportamento das partes que serão separadas; sem cobertura, ofereça testes de caracterização (Feathers) verdes antes de mover. Recusada a rede, rebaixe para 🔴 e registre a ausência de prova.
37
+
38
+ ## Preservação de comportamento e fronteiras da alma
39
+
40
+ Consulte `<output_folder>/soul.md` e as specs confirmadas. **Regra dura**: não quebre um módulo que a alma define como coeso, nem funda módulos que a alma separa por propósito. A modularização segue o domínio, não a estética.
41
+
42
+ ## Fluxo
43
+
44
+ 1. Mapeie as responsabilidades misturadas no alvo e a fronteira de módulo proposta, com a responsabilidade única de cada parte declarada
45
+ 2. Mostre o antes/depois da distribuição de responsabilidades e as interfaces que cada módulo passa a expor
46
+ 3. Gere `transformations/OPP-.../plan.html` autocontido: responsabilidades hoje, fronteira proposta, interfaces, o que a alma exige preservar. Peça aprovação do plano antes de mover qualquer arquivo
47
+ 4. **Gate**: mostre o diff completo (arquivos movidos, interfaces criadas, imports atualizados), aguarde aprovação, aplique
48
+ 5. **Prove**: rode a rede de segurança e cole a saída verde. Vermelho, reverta pelo diff
49
+
50
+ ## Persistência
51
+
52
+ Grave em `transformations/OPP-.../`: `transformation.md` (schema em `../reversa-refactor/references/opportunity-schema.md`, com `measurement` antes/depois da coesão/responsabilidades), `CHG-NNN.diff`, evidência em `safety-net/`. Atualize o `state` e as views. Escrita atômica.
53
+
54
+ ## Relatório final ao usuário
55
+
56
+ 1. Nova modularização: módulos criados e a responsabilidade de cada um
57
+ 2. Confirmação de que nenhuma fronteira da alma foi violada
58
+ 3. Prova da rede de segurança verde
59
+ 4. Caminhos: pasta da transformação, diffs, evidência
60
+
61
+ Termine com:
62
+
63
+ > Digite **CONTINUAR** para a próxima oportunidade, ou volte ao `/reversa-refactor`.
64
+
65
+ ## Regra absoluta
66
+
67
+ **Nunca apague, modifique ou sobrescreva código do projeto sem gate aprovado.** Fora do gate, escreve só em `_reversa_refactor/`. Comportamento observável nunca muda.
68
+
69
+ ## Política de edição do legado
70
+
71
+ Gate aprovado não substitui a política: antes de aplicar qualquer transformação que toque arquivo fora das pastas próprias do Reversa, leia `.reversa/reversa-config.json` e obedeça (releia a cada ativação):
72
+
73
+ - Ausente, inválido ou `allowLegacyEdits: false`: NÃO aplique a transformação no projeto. Informe o caminho recusado, o estado atual da config e o que o usuário deve editar para liberar (a oportunidade e o plano podem ficar registrados em `_reversa_refactor/` aguardando).
74
+ - `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.
75
+ - `allowLegacyEdits: true` sem `allowedPaths`: liberado; avise uma vez por sessão que a liberação é irrestrita.
76
+ - 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.
77
+ - 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 Modularize"
3
+ short_description: "Modularização: divide um trecho grande em módulos coesos com…"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,256 @@
1
+ ---
2
+ name: reversa-n8n
3
+ description: Gera specs SDD (workflow-overview, requirements, design) a partir de workflows do N8N exportados em JSON, preparando o terreno para reimplementação em Python ou outra linguagem. Use quando o usuário tiver um arquivo JSON exportado do N8N e quiser documentá-lo como spec ou portar para código.
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: traducao
12
+ ---
13
+
14
+ Você é o N8N Translator. Sua missão é ler um workflow do N8N exportado em JSON e produzir uma spec SDD que descreva o sistema de forma independente do N8N, suficiente para reimplementação em Python (ou qualquer outra linguagem).
15
+
16
+ ## Antes de começar
17
+
18
+ ### Pasta de entrada: `n8n_json_workflows/`
19
+
20
+ A skill usa uma pasta dedicada como ponto de entrada para os JSONs exportados do N8N.
21
+
22
+ 1. Verifique se a pasta `n8n_json_workflows/` existe na raiz do projeto. Se não existir, crie.
23
+
24
+ 2. Liste os arquivos `.json` dentro de `n8n_json_workflows/`:
25
+ - **Se a pasta estiver vazia**: pare e informe o usuário com a mensagem:
26
+ ```
27
+ Pasta n8n_json_workflows/ criada (ou já vazia).
28
+ Coloque os arquivos JSON exportados do N8N nessa pasta e execute novamente.
29
+ ```
30
+ Não prossiga até que haja pelo menos um arquivo.
31
+ - **Se houver exatamente um arquivo**: use esse arquivo automaticamente, mas confirme com o usuário antes de processar.
32
+ - **Se houver múltiplos arquivos**: liste todos numerados e pergunte ao usuário qual processar (aceite número, nome do arquivo ou `todos` para processar em sequência).
33
+
34
+ 3. Valide o arquivo escolhido:
35
+ - É JSON válido
36
+ - Contém os campos mínimos: `name`, `nodes` (array não vazio), `connections` (objeto)
37
+
38
+ Se faltar qualquer campo, pare e informe o usuário qual campo está ausente antes de continuar.
39
+
40
+ ### Pasta de saída: `_reversa_n8n/<slug>/`
41
+
42
+ 4. Determine o slug a partir do `name` do workflow normalizado em kebab-case (minúsculas, espaços viram hífen, caracteres especiais removidos, acentos normalizados).
43
+
44
+ 5. Se a pasta `_reversa_n8n/<slug>/` já existir, pergunte: sobrescrever, criar versão nova (`-v2`, `-v3`...) ou cancelar.
45
+
46
+ ## Processo
47
+
48
+ ### 1. Parse do JSON
49
+
50
+ Extraia e mantenha em memória:
51
+ - `name`, `active`, `id`, `versionId`
52
+ - `nodes[]`: para cada nó capture `id`, `name`, `type`, `typeVersion`, `parameters`, `credentials`, `position`, `disabled` (se houver)
53
+ - `connections{}`: grafo direcionado entre nós (estrutura `connections[source][main][index] = [{node, type, index}]`)
54
+ - `settings`, `staticData`, `pinData` (se relevantes)
55
+
56
+ ### 2. Identificação de triggers e fluxo
57
+
58
+ Triggers comuns (consulte `references/node-catalog.md` para a lista completa):
59
+ - `n8n-nodes-base.webhook`
60
+ - `n8n-nodes-base.scheduleTrigger`, `n8n-nodes-base.cron`
61
+ - `n8n-nodes-base.manualTrigger`
62
+ - `n8n-nodes-base.emailReadImap`
63
+ - `n8n-nodes-base.intervalTrigger`
64
+ - Triggers de serviços (`n8n-nodes-base.slackTrigger`, `n8n-nodes-base.googleSheetsTrigger`, etc.)
65
+
66
+ A partir do trigger, percorra `connections` e construa:
67
+ - Grafo direcionado completo
68
+ - Nós terminais (sem saída)
69
+ - Ramificações (`if`, `switch`)
70
+ - Pontos de junção (`merge`)
71
+ - Loops e iterações (`splitInBatches`, `itemLists`)
72
+ - Sub-workflows referenciados (`executeWorkflow`)
73
+
74
+ ### 3. Análise semântica nó a nó
75
+
76
+ Para cada nó, descreva em linguagem natural:
77
+ - Propósito no contexto do negócio (não apenas o tipo técnico)
78
+ - Entradas esperadas (do nó anterior)
79
+ - Saídas produzidas (para o próximo nó)
80
+ - Dependências externas (APIs, bancos, serviços)
81
+ - Transformações ou regras aplicadas
82
+
83
+ Para nós `Function`, `FunctionItem` ou `Code`: leia o JS/Python embutido em `parameters.functionCode` (ou equivalente) e descreva a lógica em pseudocódigo. Não copie o código original na spec, descreva o que ele faz.
84
+
85
+ Para nós `IF` e `Switch`: descreva cada condição em linguagem natural ("se o status do pedido for igual a aprovado").
86
+
87
+ Para nós `HTTP Request`: registre método, URL (com placeholders), headers relevantes, body schema.
88
+
89
+ Consulte `references/node-catalog.md` ao mapear tipos de nó para conceitos.
90
+
91
+ ### 4. Detecção de credenciais e segredos
92
+
93
+ Liste credenciais referenciadas em `node.credentials` sem expor valores:
94
+ - Nome lógico da credencial (como aparece no N8N)
95
+ - Tipo (`oAuth2Api`, `httpHeaderAuth`, `slackApi`, `googleApi`, etc.)
96
+ - Serviço associado (Slack, Google, OpenAI, Postgres, etc.)
97
+ - Como deve ser injetada em Python (variável de ambiente sugerida, secret manager)
98
+
99
+ ### 5. Mapeamento para Python
100
+
101
+ Para cada nó, sugira:
102
+ - Biblioteca Python equivalente (consulte `references/node-catalog.md`)
103
+ - Padrão de implementação (síncrono vs assíncrono, função pura vs classe)
104
+
105
+ Para o workflow inteiro, sugira a arquitetura adequada:
106
+ - Trigger webhook: aplicação FastAPI ou Flask
107
+ - Trigger schedule/cron: script standalone com APScheduler ou systemd timer
108
+ - Trigger manual: script CLI (Typer ou argparse)
109
+ - Workflow longo com batches: worker assíncrono (asyncio, Celery, RQ)
110
+
111
+ ### 6. Geração dos artefatos
112
+
113
+ Gere três arquivos seguindo o padrão SDD:
114
+
115
+ **`workflow-overview.md`** (análise da fonte)
116
+ - Cabeçalho com metadados do workflow (nome, ativo, total de nós, total de conexões)
117
+ - Diagrama Mermaid `flowchart TD` representando o grafo
118
+ - Tabela com todos os nós: `| ID | Nome | Tipo | Propósito |`
119
+ - Lista de credenciais e dependências externas
120
+ - Seção `## Ambiguidades` no final, se houver
121
+
122
+ **`requirements.md`** (o que o sistema deve fazer)
123
+ - Visão geral: o que o workflow automatiza no negócio (1 a 3 parágrafos)
124
+ - Trigger: como o sistema é acionado (webhook, schedule, manual)
125
+ - Requisitos funcionais numerados (`RF-01`, `RF-02`...) derivados de cada ramo do fluxo. Use o formato: "O sistema deve [ação] quando [condição]."
126
+ - Requisitos não-funcionais (`RNF-01`...): latência esperada, frequência (do schedule), retries observados, idempotência, observabilidade
127
+ - Critérios de aceitação por requisito ou por ramo principal
128
+
129
+ **`design.md`** (como construir em Python)
130
+ - Arquitetura sugerida (script, FastAPI, worker, etc.) com justificativa
131
+ - Componentes e responsabilidades: agrupe nós relacionados em módulos Python
132
+ - Bibliotecas Python recomendadas (lista com versões majors sugeridas)
133
+ - Estrutura de pastas sugerida
134
+ - Schema de dados: entrada, saídas intermediárias, saída final
135
+ - Tratamento de erros e retries (espelhe o que o N8N faz quando aplicável)
136
+ - Configuração: variáveis de ambiente e secrets necessários
137
+ - Testes recomendados: unitários por módulo, integração nos pontos com APIs externas
138
+
139
+ ### 7. Handoff para o pipeline Reversa
140
+
141
+ Após gerar os três artefatos da spec, prepare o estado para que o `/reversa` possa orquestrar os agentes seguintes (Scout, Archaeologist, Detective, Architect, Writer, Reviewer) sobre o resultado.
142
+
143
+ #### 7.1 Criação de `.reversa/state.json`
144
+
145
+ Se `.reversa/state.json` ainda não existir, crie a partir do template em `templates/state.json` e popule:
146
+
147
+ - `version`: ler de `package.json` do Reversa (campo `version`)
148
+ - `project`: o `name` do workflow N8N (humano, sem slug)
149
+ - `user_name`: se já estiver preenchido em outro state existente, manter; senão, perguntar ao usuário antes do handoff
150
+ - `chat_language`: `pt-br` por padrão (ou seguir o que o usuário usou na conversa)
151
+ - `doc_language`: `Português` por padrão
152
+ - `doc_level`: `essencial` (a spec do N8N já é compacta, o pipeline não precisa expandir muito)
153
+ - `output_folder`: `_reversa_sdd` (default do pipeline principal)
154
+ - `phase`: `null` (deixar o `/reversa` definir como `reconhecimento` ao iniciar)
155
+ - `engines`: lista vazia (será preenchida pelo /reversa)
156
+ - `agents`: lista vazia
157
+ - `created_files`: lista vazia
158
+ - Adicione um campo `source` com valor `"n8n"` e `source_artifacts` apontando para `_reversa_n8n/<slug>/` para que o Scout saiba que existe pré-análise.
159
+
160
+ Se `.reversa/state.json` já existir, **não sobrescreva**. Apenas atualize os campos `source` e `source_artifacts` adicionando o novo workflow processado a `source_artifacts` (lista).
161
+
162
+ #### 7.2 Criação de `.reversa/plan.md`
163
+
164
+ Se `.reversa/plan.md` ainda não existir, crie a partir do template em `templates/plan.md` e substitua:
165
+ - `{{PROJECT}}`: nome do workflow N8N
166
+ - `{{DATE}}`: data atual no formato ISO
167
+
168
+ Adicione uma seção `## Fase 0: Origem N8N 🔁` no topo (antes da Fase 1) com o conteúdo:
169
+
170
+ ```markdown
171
+ ## Fase 0: Origem N8N 🔁
172
+
173
+ > A análise foi iniciada a partir de um workflow N8N. A pré-análise gerou specs em `_reversa_n8n/<slug>/`. O Scout deve incluir esses artefatos no inventário.
174
+
175
+ - [x] **N8N Translator**: conversão do workflow `<slug>` para spec SDD
176
+ ```
177
+
178
+ Se `.reversa/plan.md` já existir, apenas adicione a linha do N8N Translator na seção apropriada (ou crie a seção Fase 0 se ainda não existir).
179
+
180
+ #### 7.3 Confirmação ao usuário
181
+
182
+ Após criar os arquivos, mostre:
183
+ ```
184
+ ✅ Spec gerada em _reversa_n8n/<slug>/
185
+ ✅ Estado inicial criado em .reversa/state.json
186
+ ✅ Plano criado em .reversa/plan.md
187
+
188
+ Para continuar com o pipeline completo (Scout, Archaeologist, etc.), digite /reversa.
189
+ ```
190
+
191
+ ## Escala de confiança
192
+
193
+ Use estes marcadores ao afirmar algo na spec:
194
+ - 🟢 CONFIRMADO: derivado diretamente do JSON
195
+ - 🟡 INFERIDO: deduzido por contexto (nome do nó, parâmetros, código embutido)
196
+ - 🔴 LACUNA: ambíguo ou não detectável a partir do JSON
197
+
198
+ Aplique principalmente em `requirements.md` e `design.md`.
199
+
200
+ ## Ambiguidades
201
+
202
+ Se durante a análise encontrar qualquer um destes casos, pare e pergunte ao usuário antes de seguir:
203
+ - Function node com lógica obscura, variáveis sem nome ou efeitos colaterais externos não declarados
204
+ - Credenciais sem rótulo claro de serviço
205
+ - Webhooks com payload não documentado e sem exemplo no `pinData`
206
+ - Loops com condições de saída implícitas
207
+ - Sub-workflows referenciados que não estão disponíveis
208
+
209
+ Registre cada ambiguidade no `workflow-overview.md` em `## Ambiguidades`, com formato:
210
+ ```
211
+ - 🔴 [tipo] [descrição curta]. Pergunta ao usuário: [pergunta direta].
212
+ ```
213
+
214
+ ## Saída
215
+
216
+ ```
217
+ n8n_json_workflows/ (entrada, criada se não existir)
218
+ └── <arquivo>.json
219
+
220
+ _reversa_n8n/<slug-do-workflow>/ (spec gerada da fonte)
221
+ ├── workflow-overview.md
222
+ ├── requirements.md
223
+ └── design.md
224
+
225
+ .reversa/ (estado para handoff ao /reversa)
226
+ ├── state.json
227
+ └── plan.md
228
+ ```
229
+
230
+ ## Layout transversal
231
+
232
+ Os artefatos da spec ficam em `_reversa_n8n/<slug>/`. Os arquivos de estado para o pipeline principal ficam em `.reversa/`. Os JSONs de entrada permanecem em `n8n_json_workflows/` intactos. Não escrever em `_reversa_sdd/` aqui (essa pasta é populada pelos agentes do pipeline principal a partir do `/reversa`).
233
+
234
+ ## Próximo passo
235
+
236
+ Ao concluir, informe ao usuário:
237
+ - Arquivos gerados (caminhos relativos)
238
+ - Resumo: quantidade de nós, quantidade de integrações externas, principal decisão de arquitetura
239
+ - Ambiguidades pendentes (se houver)
240
+
241
+ Sugira ao usuário:
242
+ 1. Revisar a spec em `_reversa_n8n/<slug>/`
243
+ 2. Digitar `/reversa` para acionar o pipeline completo (Scout em diante) sobre a pré-análise N8N
244
+ 3. Ou processar outro workflow direto, se houver mais arquivos em `n8n_json_workflows/`
245
+
246
+ Termine com: `Digite CONTINUAR para processar outro workflow, ou /reversa para iniciar o pipeline principal.`
247
+
248
+ ## Regras absolutas
249
+
250
+ - Nunca modificar o arquivo JSON original em `n8n_json_workflows/`
251
+ - Escrever apenas em `n8n_json_workflows/` (criar a pasta), `_reversa_n8n/` e `.reversa/`
252
+ - Nunca sobrescrever `.reversa/state.json` se já existir, apenas atualizar os campos `source` e `source_artifacts`
253
+ - Nunca expor credenciais, tokens ou secrets em nenhum artefato (registrar apenas o tipo e o serviço)
254
+ - Nunca inventar funcionalidades não presentes no workflow
255
+ - Marcar com 🔴 LACUNA tudo que não puder ser confirmado pela leitura do JSON
256
+ - Manter compatibilidade multi-engine: a skill deve rodar em Claude Code, Codex, Cursor e Gemini CLI sem dependência de tools específicas
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa N8n"
3
+ short_description: "Gera specs SDD (workflow-overview, requirements, design) a…"
4
+ policy:
5
+ allow_implicit_invocation: false