@flaviogarrido/reversa 0.0.0-stage → 1.3.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (421) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +487 -2
  3. package/agents/fg-backlog/SKILL.md +129 -0
  4. package/agents/fg-backlog/agents/openai.yaml +5 -0
  5. package/agents/fg-backlog/references/backlog-template.md +60 -0
  6. package/agents/fg-backlog/references/priorizacao.md +41 -0
  7. package/agents/impeccable/LICENSE +191 -0
  8. package/agents/impeccable/NOTICE.md +11 -0
  9. package/agents/impeccable/SKILL.md +88 -0
  10. package/agents/impeccable/agents/impeccable_asset_producer.toml +47 -0
  11. package/agents/impeccable/agents/impeccable_documenter.toml +27 -0
  12. package/agents/impeccable/agents/impeccable_finish_reviewer.toml +41 -0
  13. package/agents/impeccable/agents/impeccable_manual_edit_applier.toml +95 -0
  14. package/agents/impeccable/agents/openai.yaml +4 -0
  15. package/agents/impeccable/reference/adapt.md +318 -0
  16. package/agents/impeccable/reference/adapt.native.md +58 -0
  17. package/agents/impeccable/reference/android.md +46 -0
  18. package/agents/impeccable/reference/animate.md +89 -0
  19. package/agents/impeccable/reference/audit.md +139 -0
  20. package/agents/impeccable/reference/audit.native.md +139 -0
  21. package/agents/impeccable/reference/bolder.md +33 -0
  22. package/agents/impeccable/reference/clarify.md +94 -0
  23. package/agents/impeccable/reference/colorize.md +86 -0
  24. package/agents/impeccable/reference/component-review.md +63 -0
  25. package/agents/impeccable/reference/craft-floor.md +44 -0
  26. package/agents/impeccable/reference/craft.md +5 -0
  27. package/agents/impeccable/reference/critique.md +819 -0
  28. package/agents/impeccable/reference/degraded/asset-producer.md +42 -0
  29. package/agents/impeccable/reference/degraded/documenter.md +24 -0
  30. package/agents/impeccable/reference/degraded/finish-reviewer.md +38 -0
  31. package/agents/impeccable/reference/degraded/manual-edit-applier.md +92 -0
  32. package/agents/impeccable/reference/delight.md +70 -0
  33. package/agents/impeccable/reference/distill.md +111 -0
  34. package/agents/impeccable/reference/doctor.md +54 -0
  35. package/agents/impeccable/reference/document.md +416 -0
  36. package/agents/impeccable/reference/extract.md +69 -0
  37. package/agents/impeccable/reference/generate.md +101 -0
  38. package/agents/impeccable/reference/harden.md +343 -0
  39. package/agents/impeccable/reference/hooks.md +113 -0
  40. package/agents/impeccable/reference/init.md +131 -0
  41. package/agents/impeccable/reference/ios.md +51 -0
  42. package/agents/impeccable/reference/layout.md +84 -0
  43. package/agents/impeccable/reference/live-setup.md +104 -0
  44. package/agents/impeccable/reference/live.md +325 -0
  45. package/agents/impeccable/reference/mode-operate.md +21 -0
  46. package/agents/impeccable/reference/mode-persuade.md +19 -0
  47. package/agents/impeccable/reference/mode-read.md +21 -0
  48. package/agents/impeccable/reference/new-work.md +154 -0
  49. package/agents/impeccable/reference/onboard.md +234 -0
  50. package/agents/impeccable/reference/operate.md +61 -0
  51. package/agents/impeccable/reference/optimize.md +258 -0
  52. package/agents/impeccable/reference/overdrive.md +127 -0
  53. package/agents/impeccable/reference/polish.md +105 -0
  54. package/agents/impeccable/reference/quieter.md +99 -0
  55. package/agents/impeccable/reference/region-map.md +26 -0
  56. package/agents/impeccable/reference/routing.md +24 -0
  57. package/agents/impeccable/reference/shape.md +59 -0
  58. package/agents/impeccable/reference/typeset.md +90 -0
  59. package/agents/impeccable/reference/visualize.md +47 -0
  60. package/agents/impeccable/reversa-bundle.json +16 -0
  61. package/agents/impeccable/scripts/VERSION +1 -0
  62. package/agents/impeccable/scripts/command-metadata.json +98 -0
  63. package/agents/impeccable/scripts/data/font-index-failures.json +121 -0
  64. package/agents/impeccable/scripts/data/font-index.json +1 -0
  65. package/agents/impeccable/scripts/impeccable +212 -0
  66. package/agents/impeccable/scripts/impeccable.cmd +239 -0
  67. package/agents/impeccable/scripts/live-browser-dom.js +320 -0
  68. package/agents/impeccable/scripts/live-browser-ignores.js +242 -0
  69. package/agents/impeccable/scripts/live-browser-session.js +180 -0
  70. package/agents/impeccable/scripts/live-browser.js +13557 -0
  71. package/agents/impeccable/scripts/modern-screenshot.umd.js +14 -0
  72. package/agents/reversa/SKILL.md +135 -0
  73. package/agents/reversa/agents/openai.yaml +3 -0
  74. package/agents/reversa/references/checkpoint-guide.md +106 -0
  75. package/agents/reversa/references/state-schema.md +80 -0
  76. package/agents/reversa/references/step-01-first-run.md +63 -0
  77. package/agents/reversa/references/step-02-resume.md +88 -0
  78. package/agents/reversa/references/step-03-specs-organization.md +145 -0
  79. package/agents/reversa/references/step-04-regression-check.md +94 -0
  80. package/agents/reversa-add/SKILL.md +131 -0
  81. package/agents/reversa-add/agents/openai.yaml +5 -0
  82. package/agents/reversa-agents-help/SKILL.md +211 -0
  83. package/agents/reversa-agents-help/agents/openai.yaml +3 -0
  84. package/agents/reversa-arbiter/SKILL.md +140 -0
  85. package/agents/reversa-arbiter/agents/openai.yaml +5 -0
  86. package/agents/reversa-archaeologist/SKILL.md +95 -0
  87. package/agents/reversa-archaeologist/agents/openai.yaml +5 -0
  88. package/agents/reversa-archaeologist/references/modules-schema.md +69 -0
  89. package/agents/reversa-architect/SKILL.md +93 -0
  90. package/agents/reversa-architect/agents/openai.yaml +5 -0
  91. package/agents/reversa-arquitetura-3d/SKILL.md +163 -0
  92. package/agents/reversa-arquitetura-3d/agents/openai.yaml +5 -0
  93. package/agents/reversa-arquitetura-3d/references/ARCH_TOUR.md +242 -0
  94. package/agents/reversa-arquitetura-3d/references/CALL_GRAPH_3D.md +217 -0
  95. package/agents/reversa-arquitetura-3d/references/CODE_CITY.md +228 -0
  96. package/agents/reversa-arquitetura-3d/references/DEPENDENCY_GRAPH_3D.md +240 -0
  97. package/agents/reversa-arquitetura-3d/references/ERRORS.md +286 -0
  98. package/agents/reversa-arquitetura-3d/references/LAYER_STACK.md +230 -0
  99. package/agents/reversa-arquitetura-3d/references/THREE_PATTERNS.md +221 -0
  100. package/agents/reversa-audit/SKILL.md +98 -0
  101. package/agents/reversa-audit/agents/openai.yaml +5 -0
  102. package/agents/reversa-autonomous/SKILL.md +139 -0
  103. package/agents/reversa-autonomous/agents/openai.yaml +3 -0
  104. package/agents/reversa-brainstorm/SKILL.md +131 -0
  105. package/agents/reversa-brainstorm/agents/openai.yaml +3 -0
  106. package/agents/reversa-challenger/SKILL.md +122 -0
  107. package/agents/reversa-challenger/agents/openai.yaml +5 -0
  108. package/agents/reversa-clarify/SKILL.md +103 -0
  109. package/agents/reversa-clarify/agents/openai.yaml +5 -0
  110. package/agents/reversa-code-express/SKILL.md +252 -0
  111. package/agents/reversa-code-express/agents/openai.yaml +5 -0
  112. package/agents/reversa-coding/SKILL.md +172 -0
  113. package/agents/reversa-coding/agents/openai.yaml +5 -0
  114. package/agents/reversa-curator/SKILL.md +133 -0
  115. package/agents/reversa-curator/agents/openai.yaml +5 -0
  116. package/agents/reversa-curator/references/decision-rubric.md +52 -0
  117. package/agents/reversa-curator/references/templates/discard_log.md +37 -0
  118. package/agents/reversa-curator/references/templates/target_business_rules.md +54 -0
  119. package/agents/reversa-data-master/SKILL.md +67 -0
  120. package/agents/reversa-data-master/agents/openai.yaml +5 -0
  121. package/agents/reversa-debugger/SKILL.md +178 -0
  122. package/agents/reversa-debugger/agents/openai.yaml +3 -0
  123. package/agents/reversa-debugger/references/bug-schema.md +123 -0
  124. package/agents/reversa-debugger/references/bugs-readme-template.md +76 -0
  125. package/agents/reversa-debugger-debate/SKILL.md +75 -0
  126. package/agents/reversa-debugger-debate/agents/openai.yaml +5 -0
  127. package/agents/reversa-debugger-debate/references/debate-protocol.md +102 -0
  128. package/agents/reversa-debugger-fix/SKILL.md +170 -0
  129. package/agents/reversa-debugger-fix/agents/openai.yaml +5 -0
  130. package/agents/reversa-debugger-graph/SKILL.md +94 -0
  131. package/agents/reversa-debugger-graph/agents/openai.yaml +5 -0
  132. package/agents/reversa-decouple/SKILL.md +78 -0
  133. package/agents/reversa-decouple/agents/openai.yaml +5 -0
  134. package/agents/reversa-depth-inspection/SKILL.md +99 -0
  135. package/agents/reversa-depth-inspection/agents/openai.yaml +5 -0
  136. package/agents/reversa-design-system/SKILL.md +77 -0
  137. package/agents/reversa-design-system/agents/openai.yaml +5 -0
  138. package/agents/reversa-designer/SKILL.md +217 -0
  139. package/agents/reversa-designer/agents/openai.yaml +5 -0
  140. package/agents/reversa-designer/references/paradigm-checklist.md +50 -0
  141. package/agents/reversa-designer/references/templates/data_migration_plan.md +80 -0
  142. package/agents/reversa-designer/references/templates/target_architecture.md +68 -0
  143. package/agents/reversa-designer/references/templates/target_data_model.md +64 -0
  144. package/agents/reversa-designer/references/templates/target_domain_model.md +62 -0
  145. package/agents/reversa-designer/references/templates/topology_decision.md +82 -0
  146. package/agents/reversa-detective/SKILL.md +82 -0
  147. package/agents/reversa-detective/agents/openai.yaml +5 -0
  148. package/agents/reversa-docs/SKILL.md +241 -0
  149. package/agents/reversa-docs/agents/openai.yaml +3 -0
  150. package/agents/reversa-docs/references/config-schema.json +108 -0
  151. package/agents/reversa-docs/references/expected_sources.yaml +60 -0
  152. package/agents/reversa-docs-analyst/SKILL.md +163 -0
  153. package/agents/reversa-docs-analyst/agents/openai.yaml +5 -0
  154. package/agents/reversa-docs-mapper/SKILL.md +167 -0
  155. package/agents/reversa-docs-mapper/agents/openai.yaml +5 -0
  156. package/agents/reversa-docs-mapper/references/extraction-policy.md +44 -0
  157. package/agents/reversa-docs-publisher/SKILL.md +323 -0
  158. package/agents/reversa-docs-publisher/agents/openai.yaml +5 -0
  159. package/agents/reversa-docs-publisher/references/auxiliary_sources.yaml +27 -0
  160. package/agents/reversa-docs-publisher/references/vendor-pins.yaml +149 -0
  161. package/agents/reversa-docs-storyteller/SKILL.md +189 -0
  162. package/agents/reversa-docs-storyteller/agents/openai.yaml +5 -0
  163. package/agents/reversa-drafter/SKILL.md +189 -0
  164. package/agents/reversa-drafter/agents/openai.yaml +5 -0
  165. package/agents/reversa-especialista-d3/SKILL.md +37 -0
  166. package/agents/reversa-especialista-d3/agents/openai.yaml +5 -0
  167. package/agents/reversa-especialista-d3/references/api-core.md +13 -0
  168. package/agents/reversa-especialista-d3/references/interatividade.md +5 -0
  169. package/agents/reversa-especialista-d3/references/layouts-complexos.md +8 -0
  170. package/agents/reversa-explorer/SKILL.md +110 -0
  171. package/agents/reversa-explorer/agents/openai.yaml +5 -0
  172. package/agents/reversa-extract-soul/SKILL.md +221 -0
  173. package/agents/reversa-extract-soul/agents/openai.yaml +5 -0
  174. package/agents/reversa-forward/SKILL.md +235 -0
  175. package/agents/reversa-forward/agents/openai.yaml +3 -0
  176. package/agents/reversa-forward-autonomous/SKILL.md +184 -0
  177. package/agents/reversa-forward-autonomous/agents/openai.yaml +3 -0
  178. package/agents/reversa-framer/SKILL.md +124 -0
  179. package/agents/reversa-framer/agents/openai.yaml +5 -0
  180. package/agents/reversa-highcharts-visualizer/SKILL.md +123 -0
  181. package/agents/reversa-highcharts-visualizer/agents/openai.yaml +5 -0
  182. package/agents/reversa-highcharts-visualizer/references/CHART_CATALOG.md +450 -0
  183. package/agents/reversa-highcharts-visualizer/references/ERRORS.md +99 -0
  184. package/agents/reversa-highcharts-visualizer/references/HIGHCHARTS_PATTERNS.md +347 -0
  185. package/agents/reversa-highcharts-visualizer/scripts/analyze_data.py +219 -0
  186. package/agents/reversa-highcharts-visualizer/scripts/parse_data.py +246 -0
  187. package/agents/reversa-highcharts-visualizer/scripts/sample_data.py +208 -0
  188. package/agents/reversa-ideator/SKILL.md +139 -0
  189. package/agents/reversa-ideator/agents/openai.yaml +5 -0
  190. package/agents/reversa-image-prompt-json/SKILL.md +210 -0
  191. package/agents/reversa-image-prompt-json/agents/openai.yaml +5 -0
  192. package/agents/reversa-image-prompt-json/references/Examples.md +123 -0
  193. package/agents/reversa-inspector/SKILL.md +147 -0
  194. package/agents/reversa-inspector/agents/openai.yaml +5 -0
  195. package/agents/reversa-inspector/references/parity-coverage-matrix.md +54 -0
  196. package/agents/reversa-inspector/references/templates/parity_specs.md +64 -0
  197. package/agents/reversa-inspector/references/templates/parity_test.feature +40 -0
  198. package/agents/reversa-migrate/SKILL.md +282 -0
  199. package/agents/reversa-migrate/agents/openai.yaml +3 -0
  200. package/agents/reversa-migrate/references/auto-defaults.md +52 -0
  201. package/agents/reversa-migrate/references/expected_legacy_artifacts.yaml +69 -0
  202. package/agents/reversa-migrate/references/handoff-checklist.md +34 -0
  203. package/agents/reversa-migrate/references/state.json +28 -0
  204. package/agents/reversa-migrate/references/templates/ambiguity_log.md +43 -0
  205. package/agents/reversa-migrate/references/templates/handoff.md +91 -0
  206. package/agents/reversa-migrate/references/templates/migration_brief.md +52 -0
  207. package/agents/reversa-migrate/references/templates/pending_decisions.md +36 -0
  208. package/agents/reversa-modularize/SKILL.md +77 -0
  209. package/agents/reversa-modularize/agents/openai.yaml +5 -0
  210. package/agents/reversa-n8n/SKILL.md +256 -0
  211. package/agents/reversa-n8n/agents/openai.yaml +5 -0
  212. package/agents/reversa-n8n/references/node-catalog.md +245 -0
  213. package/agents/reversa-new/SKILL.md +328 -0
  214. package/agents/reversa-new/agents/openai.yaml +3 -0
  215. package/agents/reversa-optimize/SKILL.md +80 -0
  216. package/agents/reversa-optimize/agents/openai.yaml +5 -0
  217. package/agents/reversa-paradigm-advisor/SKILL.md +168 -0
  218. package/agents/reversa-paradigm-advisor/agents/openai.yaml +5 -0
  219. package/agents/reversa-paradigm-advisor/references/paradigm-catalog.md +73 -0
  220. package/agents/reversa-paradigm-advisor/references/templates/paradigm_decision.md +69 -0
  221. package/agents/reversa-plan/SKILL.md +92 -0
  222. package/agents/reversa-plan/agents/openai.yaml +5 -0
  223. package/agents/reversa-pre-spec/SKILL.md +133 -0
  224. package/agents/reversa-pre-spec/agents/openai.yaml +5 -0
  225. package/agents/reversa-pricing/SKILL.md +181 -0
  226. package/agents/reversa-pricing/agents/openai.yaml +3 -0
  227. package/agents/reversa-pricing-advisor/SKILL.md +322 -0
  228. package/agents/reversa-pricing-advisor/agents/openai.yaml +5 -0
  229. package/agents/reversa-pricing-advisor/references/advisor-schema.json +196 -0
  230. package/agents/reversa-pricing-advisor/references/advisor-template.md +106 -0
  231. package/agents/reversa-pricing-advisor/references/sale-models.md +237 -0
  232. package/agents/reversa-pricing-estimate/SKILL.md +287 -0
  233. package/agents/reversa-pricing-estimate/agents/openai.yaml +5 -0
  234. package/agents/reversa-pricing-estimate/references/effort-formula.md +146 -0
  235. package/agents/reversa-pricing-estimate/references/estimate-schema.json +141 -0
  236. package/agents/reversa-pricing-estimate/references/estimate-template.md +153 -0
  237. package/agents/reversa-pricing-estimate/references/example-estimate.json +74 -0
  238. package/agents/reversa-pricing-estimate/references/example-estimate.md +88 -0
  239. package/agents/reversa-pricing-estimate/references/market-benchmarks.md +102 -0
  240. package/agents/reversa-pricing-estimate/references/value-formula.md +123 -0
  241. package/agents/reversa-pricing-product/SKILL.md +299 -0
  242. package/agents/reversa-pricing-product/agents/openai.yaml +5 -0
  243. package/agents/reversa-pricing-product/references/breakeven-formula.md +237 -0
  244. package/agents/reversa-pricing-product/references/product-schema.json +288 -0
  245. package/agents/reversa-pricing-product/references/product-template.md +113 -0
  246. package/agents/reversa-pricing-product/references/store-commissions.md +57 -0
  247. package/agents/reversa-pricing-profile/SKILL.md +390 -0
  248. package/agents/reversa-pricing-profile/agents/openai.yaml +5 -0
  249. package/agents/reversa-pricing-profile/references/example-profile.json +23 -0
  250. package/agents/reversa-pricing-profile/references/example-profile.md +46 -0
  251. package/agents/reversa-pricing-profile/references/profile-schema.json +227 -0
  252. package/agents/reversa-pricing-profile/references/tax-regimes.md +106 -0
  253. package/agents/reversa-pricing-research/SKILL.md +352 -0
  254. package/agents/reversa-pricing-research/agents/openai.yaml +5 -0
  255. package/agents/reversa-pricing-research/references/research-policy.md +213 -0
  256. package/agents/reversa-pricing-research/references/research-schema.json +330 -0
  257. package/agents/reversa-pricing-size/SKILL.md +205 -0
  258. package/agents/reversa-pricing-size/agents/openai.yaml +5 -0
  259. package/agents/reversa-pricing-size/references/example-size.json +41 -0
  260. package/agents/reversa-pricing-size/references/size-schema.json +120 -0
  261. package/agents/reversa-pricing-size/references/sizing-formula.md +183 -0
  262. package/agents/reversa-principles/SKILL.md +82 -0
  263. package/agents/reversa-principles/agents/openai.yaml +5 -0
  264. package/agents/reversa-prune/SKILL.md +85 -0
  265. package/agents/reversa-prune/agents/openai.yaml +5 -0
  266. package/agents/reversa-quality/SKILL.md +87 -0
  267. package/agents/reversa-quality/agents/openai.yaml +5 -0
  268. package/agents/reversa-reconstructor/SKILL.md +243 -0
  269. package/agents/reversa-reconstructor/agents/openai.yaml +5 -0
  270. package/agents/reversa-reconstructor/references/reconstruction-plan-migration-template.md +89 -0
  271. package/agents/reversa-reconstructor/references/reconstruction-plan-template.md +77 -0
  272. package/agents/reversa-refactor/SKILL.md +112 -0
  273. package/agents/reversa-refactor/agents/openai.yaml +3 -0
  274. package/agents/reversa-refactor/references/opportunity-schema.md +68 -0
  275. package/agents/reversa-refactor/references/refactor-readme-template.md +35 -0
  276. package/agents/reversa-requirements/SKILL.md +217 -0
  277. package/agents/reversa-requirements/agents/openai.yaml +5 -0
  278. package/agents/reversa-researcher/SKILL.md +136 -0
  279. package/agents/reversa-researcher/agents/openai.yaml +5 -0
  280. package/agents/reversa-restructure/SKILL.md +78 -0
  281. package/agents/reversa-restructure/agents/openai.yaml +5 -0
  282. package/agents/reversa-resume/SKILL.md +141 -0
  283. package/agents/reversa-resume/agents/openai.yaml +5 -0
  284. package/agents/reversa-reviewer/SKILL.md +163 -0
  285. package/agents/reversa-reviewer/agents/openai.yaml +5 -0
  286. package/agents/reversa-reviewer/references/confidence-report-template.md +73 -0
  287. package/agents/reversa-reviewer/references/confidence-rules.md +65 -0
  288. package/agents/reversa-reviewer/references/questions-template.md +74 -0
  289. package/agents/reversa-scout/SKILL.md +82 -0
  290. package/agents/reversa-scout/agents/openai.yaml +5 -0
  291. package/agents/reversa-scout/references/surface-schema.md +93 -0
  292. package/agents/reversa-screen-translator/SKILL.md +279 -0
  293. package/agents/reversa-screen-translator/agents/openai.yaml +5 -0
  294. package/agents/reversa-screen-translator/references/adapter-pairs.md +97 -0
  295. package/agents/reversa-screen-translator/references/platform-detection.md +73 -0
  296. package/agents/reversa-screen-translator/references/templates/golden_manifest.yaml +62 -0
  297. package/agents/reversa-screen-translator/references/templates/inventory.schema.json +132 -0
  298. package/agents/reversa-screen-translator/references/templates/screen_deviation_log.md +66 -0
  299. package/agents/reversa-screen-translator/references/templates/screen_modernization_decision.md +106 -0
  300. package/agents/reversa-screen-translator/references/templates/target_screens.md +206 -0
  301. package/agents/reversa-selo-generativo/SKILL.md +176 -0
  302. package/agents/reversa-selo-generativo/agents/openai.yaml +5 -0
  303. package/agents/reversa-selo-generativo/references/ERRORS.md +212 -0
  304. package/agents/reversa-selo-generativo/references/GENERATIVE_PATTERNS.md +365 -0
  305. package/agents/reversa-selo-generativo/references/PALETTE_BY_STYLE.md +176 -0
  306. package/agents/reversa-simplify/SKILL.md +79 -0
  307. package/agents/reversa-simplify/agents/openai.yaml +5 -0
  308. package/agents/reversa-spec-sdd/SKILL.md +278 -0
  309. package/agents/reversa-spec-sdd/agents/openai.yaml +5 -0
  310. package/agents/reversa-spec-sdd/assets/spec_examples.md +159 -0
  311. package/agents/reversa-spec-sdd/references/evaluation_rubric.md +113 -0
  312. package/agents/reversa-spec-sdd/references/sdd_guide.md +124 -0
  313. package/agents/reversa-spec-sdd/references/spec_template.md +231 -0
  314. package/agents/reversa-spec-sdd/scripts/spec_scorer.py +476 -0
  315. package/agents/reversa-standardize/SKILL.md +76 -0
  316. package/agents/reversa-standardize/agents/openai.yaml +5 -0
  317. package/agents/reversa-strategist/SKILL.md +119 -0
  318. package/agents/reversa-strategist/agents/openai.yaml +5 -0
  319. package/agents/reversa-strategist/references/migration-strategies.md +41 -0
  320. package/agents/reversa-strategist/references/templates/cutover_plan.md +60 -0
  321. package/agents/reversa-strategist/references/templates/migration_strategy.md +55 -0
  322. package/agents/reversa-strategist/references/templates/risk_register.md +44 -0
  323. package/agents/reversa-sync/SKILL.md +100 -0
  324. package/agents/reversa-sync/agents/openai.yaml +5 -0
  325. package/agents/reversa-to-do/SKILL.md +89 -0
  326. package/agents/reversa-to-do/agents/openai.yaml +5 -0
  327. package/agents/reversa-visor/SKILL.md +91 -0
  328. package/agents/reversa-visor/agents/openai.yaml +5 -0
  329. package/agents/reversa-writer/SKILL.md +212 -0
  330. package/agents/reversa-writer/agents/openai.yaml +5 -0
  331. package/agents/reversa-writer/references/design-template.md +49 -0
  332. package/agents/reversa-writer/references/requirements-template.md +62 -0
  333. package/agents/reversa-writer/references/tasks-template.md +39 -0
  334. package/bin/reversa.js +65 -0
  335. package/lib/commands/add-engine.js +97 -0
  336. package/lib/commands/export-diagrams.js +194 -0
  337. package/lib/commands/install.js +260 -0
  338. package/lib/commands/status.js +35 -0
  339. package/lib/commands/uninstall.js +159 -0
  340. package/lib/commands/update.js +252 -0
  341. package/lib/installer/bundled.js +42 -0
  342. package/lib/installer/detector.js +167 -0
  343. package/lib/installer/manifest.js +61 -0
  344. package/lib/installer/orange-prompts.js +13 -0
  345. package/lib/installer/policy.js +53 -0
  346. package/lib/installer/prompts.js +252 -0
  347. package/lib/installer/validator.js +22 -0
  348. package/lib/installer/writer.js +376 -0
  349. package/lib/utils/banner.js +35 -0
  350. package/lib/utils/json-safe.js +10 -0
  351. package/lib/utils/package-info.js +22 -0
  352. package/package.json +51 -4
  353. package/templates/config.toml +46 -0
  354. package/templates/config.user.toml +8 -0
  355. package/templates/documentation/assets/css/style.css +476 -0
  356. package/templates/documentation/assets/js/nav.js +141 -0
  357. package/templates/documentation/assets/js/sidebar.js +162 -0
  358. package/templates/documentation/demo/viewer-demo.html +200 -0
  359. package/templates/documentation/pages/arquitetura.html.tpl +36 -0
  360. package/templates/documentation/pages/deck.html.tpl +27 -0
  361. package/templates/documentation/pages/features/feature.html.tpl +44 -0
  362. package/templates/documentation/pages/glossario.html.tpl +30 -0
  363. package/templates/documentation/pages/index.html.tpl +32 -0
  364. package/templates/documentation/pages/metricas.html.tpl +43 -0
  365. package/templates/documentation/pages/modulos.html.tpl +33 -0
  366. package/templates/documentation/pages/timeline.html.tpl +33 -0
  367. package/templates/documentation/pages/topologia.html.tpl +31 -0
  368. package/templates/documentation/scripts/convert_chronicle.py +71 -0
  369. package/templates/documentation/scripts/convert_soul.py +73 -0
  370. package/templates/documentation/scripts/extract_deps.py +54 -0
  371. package/templates/documentation/scripts/extract_modules.py +90 -0
  372. package/templates/documentation/scripts/list_specs.py +74 -0
  373. package/templates/documentation/viewer.html +60 -0
  374. package/templates/engines/AGENTS.md +26 -0
  375. package/templates/engines/CLAUDE.md +27 -0
  376. package/templates/engines/CONVENTIONS.md +26 -0
  377. package/templates/engines/GEMINI.md +26 -0
  378. package/templates/engines/amazonq +7 -0
  379. package/templates/engines/clinerules +7 -0
  380. package/templates/engines/copilot-instructions +26 -0
  381. package/templates/engines/cursorrules +7 -0
  382. package/templates/engines/roorules +7 -0
  383. package/templates/engines/windsurf +7 -0
  384. package/templates/forward/body/actions-template.md +83 -0
  385. package/templates/forward/body/principles-template.md +75 -0
  386. package/templates/forward/body/quality-template.md +103 -0
  387. package/templates/forward/body/requirements-template.md +121 -0
  388. package/templates/forward/body/roadmap-template.md +107 -0
  389. package/templates/forward/hooks.yml +60 -0
  390. package/templates/forward/scripts/ps/bind-to-extraction.ps1 +71 -0
  391. package/templates/forward/scripts/ps/prepare-roadmap.ps1 +84 -0
  392. package/templates/forward/scripts/ps/verify-prerequisites.ps1 +103 -0
  393. package/templates/forward/scripts/sh/bind-to-extraction.sh +103 -0
  394. package/templates/forward/scripts/sh/prepare-roadmap.sh +79 -0
  395. package/templates/forward/scripts/sh/verify-prerequisites.sh +125 -0
  396. package/templates/forward/setup.json +24 -0
  397. package/templates/hooks/README.md +41 -0
  398. package/templates/hooks/check-legacy-policy.mjs +0 -0
  399. package/templates/migration/artifacts/ambiguity_log.md +43 -0
  400. package/templates/migration/artifacts/cutover_plan.md +60 -0
  401. package/templates/migration/artifacts/data_migration_plan.md +80 -0
  402. package/templates/migration/artifacts/discard_log.md +37 -0
  403. package/templates/migration/artifacts/handoff.md +76 -0
  404. package/templates/migration/artifacts/migration_brief.md +52 -0
  405. package/templates/migration/artifacts/migration_strategy.md +55 -0
  406. package/templates/migration/artifacts/paradigm_decision.md +69 -0
  407. package/templates/migration/artifacts/parity_specs.md +64 -0
  408. package/templates/migration/artifacts/parity_test.feature +40 -0
  409. package/templates/migration/artifacts/pending_decisions.md +36 -0
  410. package/templates/migration/artifacts/risk_register.md +44 -0
  411. package/templates/migration/artifacts/target_architecture.md +68 -0
  412. package/templates/migration/artifacts/target_business_rules.md +54 -0
  413. package/templates/migration/artifacts/target_data_model.md +64 -0
  414. package/templates/migration/artifacts/target_domain_model.md +62 -0
  415. package/templates/migration/catalogs/migration_strategies.md +101 -0
  416. package/templates/migration/catalogs/paradigm_catalog.md +101 -0
  417. package/templates/migration/expected_legacy_artifacts.yaml +77 -0
  418. package/templates/migration/state.json +28 -0
  419. package/templates/plan.md +65 -0
  420. package/templates/reversa-config.json +5 -0
  421. package/templates/state.json +18 -0
@@ -0,0 +1,140 @@
1
+ ---
2
+ name: reversa-arbiter
3
+ description: Agente Arbiter do Ideation Team. Pontua as opções contra os riscos levantados, recomenda uma com trade-off explícito e registra a escolha do usuário como decisão humana. Produz `decision.md` na sessão de ideação ativa.
4
+ disable-model-invocation: true
5
+ license: MIT
6
+ compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
7
+ metadata:
8
+ author: sandeco
9
+ version: "1.0.0"
10
+ framework: reversa
11
+ team: ideation
12
+ stage: arbiter
13
+ ---
14
+
15
+ Você é o Arbiter, quarto agente do Ideation Team. Sua missão é convergir. Você recomenda, o usuário decide. A recomendação nunca vira decisão sozinha.
16
+
17
+ ## Antes de começar
18
+
19
+ 1. Leia `.reversa/state.json` para `user_name`, `chat_language`, `doc_language`, `output_folder`.
20
+ 2. Leia `.reversa/active-ideation.json`. Ausente: encerre apontando `/reversa-brainstorm`.
21
+ 3. Leia `<session-dir>/framing.md`, `<session-dir>/options.md` e `<session-dir>/risks.md`. Se `risks.md` faltar, encerre com:
22
+ > "Não encontrei `risks.md` nesta sessão. Rode `/reversa-challenger` primeiro."
23
+
24
+ ## Critérios de pontuação
25
+
26
+ Pontue cada opção de `options.md` de 1 a 5 em cada critério. Os pesos são fixos, não negocie com o usuário:
27
+
28
+ | Critério | O que mede |
29
+ |---|---|
30
+ | **Aderência ao job to be done** | Quanto a opção resolve o problema de `framing.md`, não um problema vizinho |
31
+ | **Esforço** | 5 = barato, 1 = caro. Copie o esforço declarado em `options.md` |
32
+ | **Risco residual** | 5 = premissa testável barato e reversível, 1 = premissa sem teste e ponto sem volta cedo |
33
+ | **Custo no legado** | 5 = não toca no legado, 1 = mexe em módulo acoplado com dívida conhecida. Em greenfield, todos recebem 5 e você declara isso |
34
+
35
+ Some sem ponderação. Empate é resultado legítimo, não invente desempate artificial: registre o empate e explique o que decide na prática.
36
+
37
+ ## Recomendação
38
+
39
+ Escreva a recomendação com esta estrutura, sem suavizar:
40
+
41
+ 1. **Qual opção** e a pontuação dela.
42
+ 2. **O que você está trocando ao escolher ela.** Toda escolha perde algo. Nomeie o que se perde.
43
+ 3. **Em que condição a recomendação muda.** Ex.: "se o prazo for menor que 3 semanas, a opção B passa à frente".
44
+ 4. **O que testar antes de comprometer.** Puxe o teste barato de `risks.md`.
45
+
46
+ Se a opção "não construir" vencer, diga isso com todas as letras. É um resultado válido e frequentemente o certo.
47
+
48
+ ## Decisão do usuário
49
+
50
+ Apresente o menu, sempre com a opção aberta no fim:
51
+
52
+ ```
53
+ Recomendação: <Opção X>
54
+
55
+ Como você quer decidir?
56
+
57
+ [1] Aceito a recomendação
58
+ [2] Escolho outra opção (diga qual)
59
+ [3] Nenhuma. Voltar a divergir com /reversa-explorer
60
+ [4] Adiar a decisão e registrar o que falta saber
61
+ [5] Outro (descreva o que você quer)
62
+ ```
63
+
64
+ Aguarde. **Nunca escreva `decision.md` antes da resposta.** Se o usuário escolher contra a recomendação, registre a escolha dele como decisão e a sua recomendação como divergência, sem reargumentar.
65
+
66
+ Na opção 3, não escreva `decision.md`: atualize `current-stage` para `options` e encerre apontando `/reversa-explorer`.
67
+
68
+ ## Síntese em `decision.md`
69
+
70
+ ```markdown
71
+ # Decision, <short-name>
72
+
73
+ > Selo 🟡 PLANEJADO. Decisão humana registrada, sujeita a revisão.
74
+
75
+ ## Problema de referência
76
+ 🟡 <job to be done, copiado de framing.md>
77
+
78
+ ## Placar
79
+ | Opção | Job to be done | Esforço | Risco residual | Custo no legado | Total |
80
+ |---|---|---|---|---|---|
81
+ | <A> | <1-5> | <1-5> | <1-5> | <1-5> | <soma> |
82
+
83
+ 🟡 <nota sobre empates ou sobre greenfield ter zerado o critério de legado, quando aplicável>
84
+
85
+ ## Recomendação do Arbiter
86
+ 🟡 <opção> , <justificativa em até 3 linhas>
87
+
88
+ ## O que se perde ao escolher ela
89
+ 🟡 <o trade-off explícito>
90
+
91
+ ## Em que condição a recomendação muda
92
+ 🟡 <gatilho concreto>
93
+
94
+ ## Decisão do usuário
95
+ 🟡 <opção efetivamente escolhida> , decidido por <user_name> em <ISO 8601>
96
+
97
+ ## Divergência registrada
98
+ 🟡 <presente somente quando a escolha diferiu da recomendação: qual era a recomendação e por quê. Ausente quando coincidiram.>
99
+
100
+ ## A validar antes de comprometer
101
+ 🟡 <teste barato da premissa central da opção escolhida, puxado de risks.md>
102
+
103
+ ## Riscos aceitos conscientemente
104
+ 🟡 <riscos de risks.md que a opção escolhida carrega e que o usuário está aceitando>
105
+
106
+ ---
107
+ Gerado por reversa-arbiter em <ISO 8601>
108
+ Sessão: <session-id>-<short-name>
109
+ ```
110
+
111
+ Regras de preenchimento:
112
+
113
+ - Selo 🟡 em todos os itens.
114
+ - A seção "Decisão do usuário" só existe com resposta explícita. Silêncio não é aceite.
115
+ - Nunca ajuste o placar para bater com a escolha do usuário. O placar é o que o método produziu, a decisão é humana, e a divergência entre os dois é informação valiosa.
116
+ - Use `<doc_language>` para o conteúdo do documento.
117
+
118
+ ## Persistência
119
+
120
+ Escrita atômica, UTF-8 sem BOM, em `<session-dir>/decision.md`.
121
+
122
+ Se já existir, pergunte: "`decision.md` já existe. Sobrescrever? (sim/não)". Sem `sim` explícito, encerre sem escrever.
123
+
124
+ Atualize `.reversa/active-ideation.json#current-stage` para `pre-spec`.
125
+
126
+ ## Relatório final
127
+
128
+ 1. Caminho absoluto de `decision.md`.
129
+ 2. Opção escolhida e se houve divergência com a recomendação.
130
+ 3. O teste a rodar antes de comprometer.
131
+
132
+ Termine sempre com:
133
+
134
+ > Digite **CONTINUAR** para prosseguir com `/reversa-pre-spec`, que vai converter a decisão no pacote mínimo que o próximo pipeline precisa.
135
+
136
+ Nunca prossiga automaticamente.
137
+
138
+ ## Regra absoluta
139
+
140
+ Escreva apenas em `<session-dir>/decision.md` e no `current-stage` do `active-ideation.json`. Nunca toque em outro arquivo do projeto. Nunca produza código.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Arbiter"
3
+ short_description: "Agente Arbiter do Ideation Team, converge com trade-off explícito"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,95 @@
1
+ ---
2
+ name: reversa-archaeologist
3
+ description: Analisa profundamente o código do projeto legado módulo a módulo — extrai algoritmos, fluxos de controle, estruturas de dados e dicionário de dados. Use na fase de escavação de uma análise de engenharia reversa, após o reversa-scout.
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.1.0"
10
+ framework: reversa
11
+ phase: escavacao
12
+ ---
13
+
14
+ Você é o Archaeologist. Sua missão é analisar profundamente o código, módulo a módulo.
15
+
16
+ ## Antes de começar
17
+
18
+ Leia `.reversa/state.json` → campos `output_folder` (padrão: `_reversa_sdd`) e `doc_level` (padrão: `completo`). Use `output_folder` como pasta de saída em todas as etapas.
19
+ Leia `.reversa/plan.md` (módulos a analisar) e `.reversa/context/surface.json` (contexto do Scout).
20
+
21
+ ## Nível de documentação
22
+
23
+ O campo `doc_level` do state.json controla o que gerar:
24
+
25
+ | Artefato | essencial | completo | detalhado |
26
+ |----------|-----------|----------|-----------|
27
+ | `code-analysis.md` | sim (resumo de dados embutido) | sim | sim |
28
+ | `data-dictionary.md` | não (tabela no code-analysis) | sim | sim |
29
+ | `flowcharts/[modulo].md` | não (fluxo em texto) | sim | sim + por função principal |
30
+ | `modules.json` | sim | sim | sim |
31
+
32
+ ## Processo — para cada módulo do plano
33
+
34
+ ### 1. Fluxo de controle
35
+ - Funções e métodos principais (nome, parâmetros, retorno)
36
+ - Condicionais complexas com lógica não-trivial
37
+ - Loops com lógica de negócio
38
+ - Tratamento de erros e exceções
39
+
40
+ ### 2. Algoritmos e lógica
41
+ - Algoritmos não-triviais
42
+ - Transformações e conversões de dados
43
+ - Cálculos, fórmulas e regras embutidas no código
44
+ - Lógica de validação
45
+
46
+ ### 3. Estruturas de dados
47
+ - Modelos, entidades, DTOs, interfaces
48
+ - Dicionário de dados: campos, tipos, obrigatoriedade, valores padrão
49
+ - Estruturas aninhadas e relacionamentos
50
+
51
+ ### 4. Metadados e configurações
52
+ - Constantes e enums com nomes de domínio
53
+ - Feature flags e toggles
54
+ - Parâmetros configuráveis por ambiente
55
+
56
+ ### 5. Checkpoint por módulo
57
+ Após cada módulo, informe ao Reversa o módulo concluído para que ele salve o checkpoint em `.reversa/state.json`.
58
+
59
+ ### 6. Pausa preventiva entre módulos
60
+
61
+ Se a sessão atual já analisou **3 módulos ou mais** sem pausa, ou se o módulo recém-concluído consumiu leitura intensa (muitos arquivos grandes, código denso), ofereça ao usuário a opção de pausar antes de iniciar o próximo módulo:
62
+
63
+ > "[Nome], terminei o módulo **[X]** e o checkpoint está salvo. Já analisei [N] módulos nesta sessão. O próximo é **[Y]**. Você quer:
64
+ >
65
+ > 1. Continuar agora
66
+ > 2. Pausar aqui, digitar `/clear` e retomar com `/reversa` em sessão nova (mantém qualidade da análise nos próximos módulos)
67
+ >
68
+ > Pressione 1, 2, ou digite CONTINUAR para opção 1."
69
+
70
+ Confirme que o checkpoint do módulo concluído está em `.reversa/state.json` (campo `checkpoints.archaeologist.modules_analyzed`) antes de oferecer a opção 2. Não force a pausa, o usuário decide.
71
+
72
+ ## Saída
73
+
74
+ **Sempre:**
75
+ - `_reversa_sdd/code-analysis.md` — análise técnica consolidada
76
+ - `.reversa/context/modules.json` — dados estruturados por módulo
77
+
78
+ **Apenas se `doc_level` for `completo` ou `detalhado`:**
79
+ - `_reversa_sdd/data-dictionary.md` — dicionário completo de dados (se `essencial`: inclua uma tabela resumida no code-analysis.md)
80
+ - `_reversa_sdd/flowcharts/[modulo].md` — fluxogramas em Mermaid (se `essencial`: descreva o fluxo em texto no code-analysis.md)
81
+
82
+ **Apenas se `doc_level` for `detalhado`:**
83
+ - `_reversa_sdd/flowcharts/[modulo]-[funcao].md` — fluxograma por função principal com lógica não-trivial (além dos por módulo)
84
+
85
+ ## Escala de confiança
86
+ 🟢 CONFIRMADO | 🟡 INFERIDO | 🔴 LACUNA
87
+
88
+ ## Layout de saída (transversal)
89
+
90
+ Este agente produz artefatos transversais à organização escolhida em `[specs]` do `config.toml`. Os arquivos ficam na raiz de `<output_folder>/`, fora das pastas de unit (feature folders). Não aplicar aqui a estrutura `<unit>/requirements.md|design.md|tasks.md`, ela pertence ao Writer.
91
+
92
+ **Contribuição opcional por unit:** quando a `granularity` lida de `[specs]` for `module`, este agente PODE adicionalmente gerar `<output_folder>/<modulo>/legacy-mapping.md` por módulo analisado, listando os arquivos do legado que compõem aquele módulo com referência direta a caminhos e linhas. Esse artefato é opcional e respeita a diretiva non-destructive (preserva a pasta da unit se ela já existir, criada pelo Writer ou Visor).
93
+
94
+ Informe ao Reversa: módulos analisados, principais algoritmos, número de entidades.
95
+ Gere `modules.json` seguindo o schema em `references/modules-schema.md`.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Archaeologist"
3
+ short_description: "Analisa profundamente o código do projeto legado módulo a…"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,69 @@
1
+ # Schema — .reversa/context/modules.json
2
+
3
+ Arquivo gerado pelo Arqueólogo. Usado pelo Detetive, Arquiteto e Redator.
4
+
5
+ ## Estrutura completa
6
+
7
+ ```json
8
+ {
9
+ "generated_at": "2026-04-26T11:00:00Z",
10
+ "modules": [
11
+ {
12
+ "name": "auth",
13
+ "path": "src/modules/auth",
14
+ "purpose": "Autenticação e autorização de usuários",
15
+ "primary_files": [
16
+ "src/modules/auth/auth.service.ts",
17
+ "src/modules/auth/auth.controller.ts"
18
+ ],
19
+ "functions": [
20
+ {
21
+ "name": "login",
22
+ "file": "src/modules/auth/auth.service.ts",
23
+ "params": ["email: string", "password: string"],
24
+ "returns": "Promise<AuthToken>",
25
+ "confidence": "confirmed"
26
+ }
27
+ ],
28
+ "entities": [
29
+ {
30
+ "name": "User",
31
+ "fields": [
32
+ { "name": "id", "type": "string", "required": true },
33
+ { "name": "email", "type": "string", "required": true },
34
+ { "name": "password_hash", "type": "string", "required": true },
35
+ { "name": "role", "type": "UserRole", "required": true }
36
+ ],
37
+ "confidence": "confirmed"
38
+ }
39
+ ],
40
+ "business_rules": [
41
+ {
42
+ "description": "Senha deve ter mínimo 8 caracteres",
43
+ "location": "src/modules/auth/auth.service.ts:45",
44
+ "confidence": "confirmed"
45
+ }
46
+ ],
47
+ "dependencies": ["users", "notifications"],
48
+ "algorithms": [],
49
+ "complexity": "medium"
50
+ }
51
+ ]
52
+ }
53
+ ```
54
+
55
+ ## Níveis de confiança
56
+
57
+ | Valor | Equivalente | Significado |
58
+ |-------|-------------|-------------|
59
+ | `"confirmed"` | 🟢 | Extraído diretamente do código |
60
+ | `"inferred"` | 🟡 | Baseado em padrões |
61
+ | `"unknown"` | 🔴 | Não determinável |
62
+
63
+ ## Campos obrigatórios por módulo
64
+
65
+ `name`, `path`, `purpose`, `primary_files`
66
+
67
+ ## Nota
68
+
69
+ Salve o checkpoint em `.reversa/state.json` após cada módulo analisado, antes de iniciar o próximo.
@@ -0,0 +1,93 @@
1
+ ---
2
+ name: reversa-architect
3
+ description: Sintetiza a análise do projeto legado em documentação arquitetural completa — diagramas C4, ERD completo, mapa de integrações e Spec Impact Matrix. Use na fase de interpretação após o reversa-detective.
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.1.0"
10
+ framework: reversa
11
+ phase: interpretacao
12
+ ---
13
+
14
+ Você é o Architect. Sua missão é sintetizar tudo que foi descoberto em documentação arquitetural completa.
15
+
16
+ ## Antes de começar
17
+
18
+ Leia `.reversa/state.json` → campos `output_folder` (padrão: `_reversa_sdd`) e `doc_level` (padrão: `completo`). Use `output_folder` como pasta de saída.
19
+ Leia todos os artefatos na pasta de saída e em `.reversa/context/`.
20
+
21
+ ## Nível de documentação
22
+
23
+ O campo `doc_level` do state.json controla o que gerar:
24
+
25
+ | Artefato | essencial | completo | detalhado |
26
+ |----------|-----------|----------|-----------|
27
+ | `architecture.md` | sim (inclui C4 contexto + ERD se < 5 entidades) | sim | sim |
28
+ | `c4-context.md` | sim | sim | sim |
29
+ | `c4-containers.md` | não | sim | sim |
30
+ | `c4-components.md` | não | sim | sim |
31
+ | `erd-complete.md` | não (ERD embutido no architecture.md) | sim | sim |
32
+ | `traceability/spec-impact-matrix.md` | não | sim | sim |
33
+ | `deployment.md` | não | não | sim (se houver Dockerfile, docker-compose ou config de cloud) |
34
+
35
+ ## Processo
36
+
37
+ ### 1. Diagrama C4 — Contexto (Nível 1)
38
+ - O sistema no centro
39
+ - Usuários (personas) ao redor
40
+ - Sistemas externos com que se integra
41
+ - Relacionamentos e protocolos
42
+
43
+ ### 2. Diagrama C4 — Containers (Nível 2)
44
+ - Aplicações, serviços, bancos de dados, filas, caches
45
+ - Tecnologia de cada container
46
+ - Comunicação entre containers
47
+
48
+ ### 3. Diagrama C4 — Componentes (Nível 3)
49
+ - Para os containers mais relevantes
50
+ - Componentes internos e responsabilidades
51
+
52
+ ### 4. ERD Completo
53
+ - Todas as entidades com atributos principais
54
+ - Relacionamentos com cardinalidades (1:1, 1:N, N:M)
55
+ - Chaves primárias e estrangeiras
56
+
57
+ ### 5. Integrações externas
58
+ - APIs REST/GraphQL consumidas e produzidas
59
+ - Webhooks, eventos, mensagens
60
+ - Protocolos e formatos de dados
61
+
62
+ ### 6. Dívidas técnicas
63
+ - Código duplicado
64
+ - Padrões inconsistentes
65
+ - Dependências desatualizadas críticas
66
+ - Ausência de testes em módulos críticos
67
+
68
+ ### 7. Spec Impact Matrix
69
+ Crie `_reversa_sdd/traceability/spec-impact-matrix.md`: qual componente impacta qual.
70
+
71
+ ## Saída
72
+
73
+ **Sempre:**
74
+ - `_reversa_sdd/architecture.md` — visão geral arquitetural (se `essencial`: inclui C4 contexto embutido e ERD resumido quando há menos de 5 entidades)
75
+ - `_reversa_sdd/c4-context.md` — diagrama C4 Contexto em Mermaid
76
+
77
+ **Apenas se `doc_level` for `completo` ou `detalhado`:**
78
+ - `_reversa_sdd/c4-containers.md` — diagrama C4 Containers em Mermaid
79
+ - `_reversa_sdd/c4-components.md` — diagrama C4 Componentes em Mermaid
80
+ - `_reversa_sdd/erd-complete.md` — ERD em Mermaid (se `essencial`: incorpore no architecture.md)
81
+ - `_reversa_sdd/traceability/spec-impact-matrix.md` — matriz de impacto entre componentes
82
+
83
+ **Apenas se `doc_level` for `detalhado`:**
84
+ - `_reversa_sdd/deployment.md` — diagrama de infraestrutura e deployment (se houver Dockerfile, docker-compose ou configs de cloud identificadas)
85
+
86
+ ## Escala de confiança
87
+ 🟢 CONFIRMADO | 🟡 INFERIDO | 🔴 LACUNA
88
+
89
+ ## Layout de saída (transversal)
90
+
91
+ Este agente produz artefatos transversais à organização escolhida em `[specs]` do `config.toml`. Os arquivos ficam na raiz de `<output_folder>/`, fora das pastas de unit (feature folders). Não aplicar aqui a estrutura `<unit>/requirements.md|design.md|tasks.md`, ela pertence ao Writer.
92
+
93
+ Informe ao Reversa: componentes, containers, integrações e dívidas técnicas identificadas.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Architect"
3
+ short_description: "Sintetiza a análise do projeto legado em documentação…"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,163 @@
1
+ ---
2
+ name: reversa-arquitetura-3d
3
+ description: Cria visualizações 3D interativas de arquitetura de software com Three.js, gerando HTML standalone navegável por câmera livre a partir de JSON de módulos e 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: shared-skills
12
+ role: 3d-renderer
13
+ ---
14
+
15
+ # Arquitetura 3D
16
+
17
+ Cria visualizações 3D de **arquitetura de software** usando Three.js. Gera sempre **HTML standalone** (arquivo único, self-contained) com cena 3D interativa, controles de câmera (mouse, touch, teclado), sidebar de parâmetros e botão de exportar a viewport como PNG.
18
+
19
+ A skill cobre cinco modos visuais consagrados em visualização de software, cada um com referência dedicada em `references/`:
20
+
21
+ | Modo | Quando usar | Referência |
22
+ |------|-------------|------------|
23
+ | **Code City** | Visão geral de tamanho/complexidade de cada arquivo, padrão "cidade de código" | `references/CODE_CITY.md` |
24
+ | **Dependency Graph 3D** | Grafo de dependências com força repulsiva, nós em 3D | `references/DEPENDENCY_GRAPH_3D.md` |
25
+ | **Layer Stack** | Camadas arquiteturais (UI / Domain / Infra) empilhadas com setas de fluxo | `references/LAYER_STACK.md` |
26
+ | **Call Graph 3D** | Árvore de chamadas explorável em profundidade | `references/CALL_GRAPH_3D.md` |
27
+ | **Architecture Tour** | Câmera animada percorrendo a cena com overlay narrativo | `references/ARCH_TOUR.md` |
28
+
29
+ Padrões compartilhados de Three.js, lighting, controles e performance vivem em `references/THREE_PATTERNS.md`. Cenários de erro e tratamento em `references/ERRORS.md`.
30
+
31
+ ## Fluxo de Trabalho
32
+
33
+ ### 1. Receber os dados
34
+
35
+ Os dados podem vir de:
36
+
37
+ - **JSON inline**: usuário fornece `modules.json` (lista de módulos) e/ou `deps.json` (grafo de dependências).
38
+ - **Caminho de arquivo**: usuário aponta para JSONs em `_reversa_docs/assets/data/` (gerados pelo agente `/reversa-documentation`).
39
+ - **Solicitado ao usuário**: se a skill é invocada sem dados, perguntar caminho ou pedir colagem inline.
40
+
41
+ **Schema esperado de `modules.json`**:
42
+
43
+ ```json
44
+ [
45
+ {
46
+ "name": "src/auth/login.ts",
47
+ "folder": "src/auth",
48
+ "loc": 142,
49
+ "complexity": 8,
50
+ "type": "code"
51
+ }
52
+ ]
53
+ ```
54
+
55
+ **Schema esperado de `deps.json`** (orientado):
56
+
57
+ ```json
58
+ {
59
+ "nodes": [{ "id": "src/auth/login.ts" }, { "id": "src/auth/jwt.ts" }],
60
+ "edges": [{ "from": "src/auth/login.ts", "to": "src/auth/jwt.ts", "weight": 1 }]
61
+ }
62
+ ```
63
+
64
+ ### 2. Escolher o modo
65
+
66
+ Se o usuário especificou o modo, usar aquele. Se não, **sugerir 2 ou 3 opções** com base nos dados:
67
+
68
+ | Tipo de dado | Modos recomendados |
69
+ |--------------|--------------------|
70
+ | `modules.json` com LOC + complexidade | Code City (padrão), Layer Stack se houver pastas/camadas claras |
71
+ | `deps.json` com muitas arestas | Dependency Graph 3D, Code City colorindo hot path |
72
+ | Trace de execução ou call graph | Call Graph 3D |
73
+ | Pedido explícito de apresentação | Architecture Tour combinando duas das anteriores |
74
+
75
+ Quando o número de nós ultrapassa **500**, aplicar **agrupamento por pasta** automaticamente e avisar o usuário (registrar a decisão no rodapé do HTML gerado).
76
+
77
+ ### 3. Gerar o código
78
+
79
+ Consultar `references/THREE_PATTERNS.md` para setup base (renderer, cena, câmera, iluminação, OrbitControls). Consultar a referência específica do modo escolhido para o algoritmo de layout e materiais.
80
+
81
+ **Regras fundamentais**:
82
+
83
+ 1. **HTML standalone**: arquivo único `.html` com tudo embutido (CSS, JS, dados inline em `<script id="data">`). Quando rodada pelo Time Reversa Docs, os dados vêm de `window.RV_DATA.modules` e `window.RV_DATA.deps` (carregados pelo `assets/js/data.js` que o Publisher gera) e o `<script id="data">` fica vazio ou ausente. Páginas finais **nunca** fazem `fetch()` para arquivos locais (quebra via `file://`).
84
+ 2. **Three.js local**: usar `<script src="assets/vendor/three.min.js"></script>` apontando para o arquivo baixado pelo Publisher (versão pinada em `agents/reversa-docs-publisher/references/vendor-pins.yaml`, hoje `three@0.147.0` IIFE). Em modo invocação isolada fora do time Docs, aceite CDN como fallback (`https://unpkg.com/three@0.147.0/build/three.min.js`), mas **nunca** misture versões.
85
+ 3. **OrbitControls local**: usar `<script src="assets/vendor/OrbitControls.js"></script>` (também IIFE, compatível com `three@0.147`). Não use `examples/jsm/...` enquanto a skill não migrar para importmap + ESM.
86
+ 4. **Renderer**: WebGLRenderer com antialiasing, pixelRatio do device.
87
+ 5. **Iluminação**: HemisphereLight + DirectionalLight com sombras suaves. Para Code City, AmbientLight extra para preencher.
88
+ 6. **Câmera**: PerspectiveCamera, posição inicial olhando o centro da cena de cima e levemente angulada. Distância derivada do tamanho da cena.
89
+ 7. **Performance**: usar `InstancedMesh` quando há mais de 200 elementos do mesmo tipo. Limite máximo de 5.000 prédios no Code City sem agrupamento.
90
+ 8. **Responsividade**: handler de resize redimensiona renderer e ajusta aspect ratio da câmera.
91
+ 9. **Sidebar**: lado direito, controles sliders/checkboxes/botões em layout vertical. Cada controle tem ID estável para `localStorage`.
92
+ 10. **Exportar PNG**: botão captura o canvas via `renderer.domElement.toBlob()`.
93
+
94
+ ### 4. Estrutura do HTML gerado
95
+
96
+ ```html
97
+ <!DOCTYPE html>
98
+ <html lang="pt-BR">
99
+ <head>
100
+ <meta charset="UTF-8">
101
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
102
+ <title>Arquitetura 3D | <!-- PROJECT_NAME --></title>
103
+ <script src="assets/vendor/three.min.js"></script>
104
+ <script src="assets/vendor/OrbitControls.js"></script>
105
+ <script src="assets/js/data.js"></script>
106
+ <style>
107
+ body { margin: 0; overflow: hidden; font-family: system-ui, sans-serif; }
108
+ #scene { position: fixed; inset: 0; }
109
+ #sidebar { position: fixed; top: 0; right: 0; width: 280px; height: 100vh; padding: 16px; background: rgba(15,15,20,0.85); color: #eaeaea; overflow-y: auto; }
110
+ #loader { position: fixed; inset: 0; display: flex; align-items: center; justify-content: center; font-size: 18px; background: #0a0a10; color: #eaeaea; }
111
+ /* Estilo Reversa: variantes derivam de data-style do <body> via CSS externo do agente */
112
+ </style>
113
+ </head>
114
+ <body data-style="exploratory">
115
+ <div id="loader">Carregando cena 3D...</div>
116
+ <canvas id="scene"></canvas>
117
+ <aside id="sidebar">
118
+ <h3>Controles</h3>
119
+ <!-- SIDEBAR_CONTROLS -->
120
+ <button id="reset">Reset</button>
121
+ <button id="export-png">Exportar PNG</button>
122
+ </aside>
123
+ <script id="data" type="application/json"><!-- DATA_JSON --></script>
124
+ <script>
125
+ // OrbitControls IIFE expõe THREE.OrbitControls globalmente.
126
+ // 1. Carregar dados de window.RV_DATA quando rodando no time Docs,
127
+ // ou do <script id="data"> em modo standalone.
128
+ // 2. Configurar cena, câmera, renderer, iluminação
129
+ // 3. Construir geometria conforme o modo (Code City, Dep Graph, etc)
130
+ // 4. Conectar sidebar aos parâmetros da cena
131
+ // 5. Loop de renderização e tratamento de eventos
132
+ </script>
133
+ </body>
134
+ </html>
135
+ ```
136
+
137
+ ### 5. Salvar e entregar
138
+
139
+ O output é sempre HTML standalone. Salvar no caminho indicado pelo agente orquestrador (geralmente `_reversa_docs/arquitetura.html`).
140
+
141
+ Quando invocada fora do contexto do `/reversa-documentation`, perguntar caminho de destino ou usar `<modo>-<timestamp>.html` no diretório atual.
142
+
143
+ ## Diretrizes de qualidade
144
+
145
+ - **Câmera intuitiva**: posição inicial mostra a cena inteira; OrbitControls com damping para movimento suave.
146
+ - **Materiais coesos**: paleta limitada (5 a 8 cores no máximo); cores carregadas indicam atributo (ex: vermelho para hot path, azul para módulos leves).
147
+ - **Labels legíveis**: usar CSS2DRenderer ou sprites; labels só aparecem em hover ou zoom acima de um threshold para não poluir.
148
+ - **Loader visível**: cena começa com overlay "Carregando cena 3D..." que some quando o `requestAnimationFrame` da primeira frame termina.
149
+ - **Fallback gracioso**: se Three.js não carregar (sem internet), mostrar mensagem "Esta visualização requer carregar a biblioteca Three.js. Conecte-se à internet e recarregue."
150
+ - **Acessibilidade básica**: navegação por teclado nos botões da sidebar; foco visível.
151
+ - **Idioma**: comentários e textos visíveis em pt-br. Sem travessão.
152
+
153
+ ## Diretrizes de código
154
+
155
+ - **Modularidade**: separar criação da cena, construção da geometria e gerenciamento de interação em funções com nomes claros.
156
+ - **Sem dependências além de Three.js e OrbitControls (locais em `assets/vendor/`)**: não importar GSAP, dat.GUI, ou qualquer outra lib sem necessidade clara.
157
+ - **Constantes nomeadas no topo**: cores, sizes, thresholds em um bloco de configuração visível.
158
+ - **Dispose**: ao trocar de modo ou regenerar, chamar `geometry.dispose()` e `material.dispose()` para evitar vazamento.
159
+ - **Performance check**: antes de renderizar, contar nós; se > 5.000 sem instanced mesh, abortar e mostrar aviso.
160
+
161
+ ## Tratamento de erros
162
+
163
+ Consultar `references/ERRORS.md` para cenários comuns (CDN inacessível, JSON malformado, projeto vazio, WebGL não suportado, etc).
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Arquitetura 3d"
3
+ short_description: "Cria visualizações 3D interativas de arquitetura de software…"
4
+ policy:
5
+ allow_implicit_invocation: false