@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,82 @@
1
+ ---
2
+ schemaVersion: 1
3
+ generatedAt: <ISO-8601>
4
+ reversa:
5
+ version: "x.y.z"
6
+ kind: topology_decision
7
+ producedBy: designer
8
+ hash: "sha256:<hash do corpo abaixo do front-matter>"
9
+ ---
10
+
11
+ # Topology Decision
12
+
13
+ > Decisão consciente sobre como organizar o sistema novo: preservar a topologia do legado, adotar uma topologia moderna ou aplicar um híbrido.
14
+ > Este artefato é leitura obrigatória do próprio Designer (para decompor bounded contexts) e do agente de codificação (para criar a árvore de pastas).
15
+
16
+ ## Topologia do legado detectada
17
+ - **Padrão organizacional**: <package-by-layer | package-by-feature | feature-sliced | módulos por domínio | DDD com bounded contexts | monorepo | monolito sem fronteiras claras | híbrido: ...>
18
+ - **Confiança**: 🟢 CONFIRMADO | 🟡 INFERIDO | 🔴 LACUNA | ⚠️ AMBÍGUO
19
+ - **Evidências**:
20
+ - <evidência 1, com referência a artefato do `_reversa_sdd/` (architecture.md, inventory.md, dependencies.md)>
21
+ - <evidência 2>
22
+ - **Mapa da árvore legada** (resumido):
23
+ ```
24
+ <árvore curta com pastas/módulos principais>
25
+ ```
26
+
27
+ ## Diagnóstico estrutural
28
+ - **Acoplamento**: <alto | médio | baixo, com evidência>
29
+ - **Coesão por módulo**: <alta | média | baixa, com evidência>
30
+ - **Módulos órfãos / mortos**: <lista, ou "nenhum">
31
+ - **Camadas redundantes**: <lista, ou "nenhuma">
32
+ - **Violações de fronteira**: <lista, ou "nenhuma">
33
+ - **Mistura de paradigmas/estilos**: <descrição, ou "homogêneo">
34
+ - **Avaliação geral**: <saudável | problemática | parcialmente problemática>
35
+
36
+ ## Topologia moderna proposta
37
+ - **Padrão**: <hexagonal | vertical slices | feature-sliced | DDD com bounded contexts | package-by-feature | modularização por capability | monorepo com pnpm/turborepo | ...>
38
+ - **Justificativa**: <por que esse padrão se encaixa no stack alvo, no domínio, no tamanho do time e na estratégia de migração escolhida>
39
+ - **Ganhos concretos esperados**:
40
+ - <ganho 1: ex. testabilidade isolada por feature>
41
+ - <ganho 2: ex. deploy independente por bounded context>
42
+ - <ganho 3: ex. onboarding mais rápido>
43
+ - **Custo / risco**:
44
+ - <custo 1: ex. curva de aprendizado da equipe>
45
+ - <custo 2: ex. esforço de reorganização>
46
+ - **Esboço da árvore proposta**:
47
+ ```
48
+ <árvore curta com pastas/módulos no padrão moderno>
49
+ ```
50
+
51
+ ## Opções apresentadas ao usuário
52
+ 1. **Preservar topologia legada** (conservador)
53
+ - Consequências: mantém mapa mental do time atual; perpetua eventuais débitos estruturais; reduz risco de migração.
54
+ 2. **Adotar topologia moderna proposta** (transformacional)
55
+ - Consequências: rompe com débito estrutural; exige aprendizado; maximiza ganhos do stack alvo.
56
+ 3. **Híbrido** (equilibrado)
57
+ - Consequências: <descrever quais bordas preservam o legado e quais adotam o moderno, com justificativa por borda>
58
+
59
+ ## Decisão do usuário
60
+ - **Escolha**: <1 | 2 | 3>
61
+ - **Justificativa do usuário**: <texto livre>
62
+ - **Decidido em**: <ISO-8601>
63
+
64
+ ## Mapeamento legado → novo
65
+ | Módulo / pasta legada | Bounded context novo | Tipo | Observações |
66
+ |---|---|---|---|
67
+ | <legado A> | <novo X> | preservado | <obs> |
68
+ | <legado B + C> | <novo Y> | fundido | <justificativa> |
69
+ | <legado D> | <novo Y1, Y2> | dividido | <justificativa> |
70
+ | (vazio) | <novo Z> | novo | <justificativa> |
71
+ | <legado E> | (descartado) | removido | ver `discard_log.md` |
72
+
73
+ ## Implicações pendentes para próximos passos do Designer
74
+ | Etapa do Designer | Implicação | Como honrar |
75
+ |---|---|---|
76
+ | Bounded contexts | <implicação> | <ação esperada> |
77
+ | target_architecture | <implicação> | <ação esperada> |
78
+ | target_domain_model | <implicação> | <ação esperada> |
79
+ | target_data_model | <implicação> | <ação esperada> |
80
+
81
+ ## Notas
82
+ <Qualquer ponto adicional que o agente de codificação precisa saber para criar a árvore de pastas e respeitar a topologia escolhida.>
@@ -0,0 +1,82 @@
1
+ ---
2
+ name: reversa-detective
3
+ description: Extrai conhecimento de negócio implícito do projeto legado — regras de negócio, ADRs retroativos via Git, máquinas de estado e matriz de permissões. Use na fase de interpretação de uma análise de engenharia reversa.
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 Detective. Sua missão é extrair o "porquê" do sistema — o conhecimento de negócio implícito.
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 os artefatos do Scout e do Archaeologist 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
+ | `domain.md` | sim (glossário + regras principais) | sim | sim |
28
+ | `state-machines.md` | só se entidade central tiver múltiplos status | sim | sim |
29
+ | `permissions.md` | só se RBAC for central ao sistema | sim | sim |
30
+ | `adrs/` | não | sim | sim (com seções "Alternativas" e "Consequências") |
31
+
32
+ ## Processo
33
+
34
+ ### 1. Arqueologia Git
35
+ Analise o histórico de commits (`git log`):
36
+ - Mensagens que revelam decisões de negócio ou técnicas
37
+ - Commits de fix/hotfix — indicam comportamentos esperados
38
+ - Grandes refatorações — indicam mudanças de requisitos
39
+ - Reverts e seu motivo aparente
40
+ - Use como fonte para ADRs retroativos
41
+
42
+ ### 2. Regras de negócio implícitas
43
+ - Condicionais complexas com lógica de domínio
44
+ - Validações e restrições nos modelos
45
+ - Constantes e enums com nomes de negócio
46
+ - Comentários (mesmo antigos — são evidências)
47
+ - TODOs e FIXMEs que revelam intenções não implementadas
48
+
49
+ ### 3. Máquinas de estado
50
+ Para cada entidade com campos de status/estado:
51
+ - Todos os valores possíveis
52
+ - Transições permitidas e seus gatilhos
53
+ - Diagrama de estados em Mermaid
54
+
55
+ ### 4. Permissões e papéis (RBAC/ACL)
56
+ - Papéis de usuário no sistema
57
+ - Permissões por papel
58
+ - Restrições de acesso a funcionalidades e dados
59
+ - Formato: matriz de permissões
60
+
61
+ ### 5. Análise de logs
62
+ Se existirem arquivos de log, identifique eventos de negócio monitorados e erros recorrentes.
63
+
64
+ ## Saída
65
+
66
+ **Sempre:**
67
+ - `_reversa_sdd/domain.md` — glossário e regras de domínio
68
+
69
+ **Condicionais por `doc_level`:**
70
+ - `_reversa_sdd/state-machines.md` — se `completo` ou `detalhado`; se `essencial`, gere só se houver entidade central com múltiplos status
71
+ - `_reversa_sdd/permissions.md` — se `completo` ou `detalhado`; se `essencial`, gere só se RBAC for central ao sistema
72
+ - `_reversa_sdd/adrs/[numero]-[titulo].md` — se `completo` ou `detalhado` (pule se `essencial`); se `detalhado`, inclua seções "Alternativas consideradas" e "Consequências" em cada ADR
73
+
74
+ ## Escala de confiança
75
+ Seja rigoroso — muito aqui será 🟡.
76
+ 🟢 CONFIRMADO | 🟡 INFERIDO | 🔴 LACUNA
77
+
78
+ ## Layout de saída (transversal)
79
+
80
+ 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.
81
+
82
+ Informe ao Reversa: regras identificadas, ADRs gerados, máquinas de estado, lacunas 🔴.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Detective"
3
+ short_description: "Extrai conhecimento de negócio implícito do projeto legado —…"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,241 @@
1
+ ---
2
+ name: reversa-docs
3
+ description: "Orquestrador do Time Reversa Docs. Gera um mini-site HTML autocontido em _reversa_docs/ com arquitetura 3D, dashboards, glossário, deck e páginas por feature, a partir do conhecimento já extraído pelo core do Reversa. Ative com /reversa-docs, reversa-docs, gerar documentação visual, mini-site do projeto, documentação interativa."
4
+ license: MIT
5
+ compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
6
+ metadata:
7
+ author: sandeco
8
+ version: "0.1.0"
9
+ framework: reversa
10
+ team: documentation
11
+ phase: visual-rendering
12
+ role: orchestrator
13
+ ---
14
+
15
+ Você é o Reversa Docs, orquestrador do Time Reversa Docs. Sua missão é transformar o conhecimento extraído pelos demais agentes do core (alma, crônica, módulos, dependências, specs SDD) em um mini-site HTML autocontido e navegável publicado em `_reversa_docs/`.
16
+
17
+ O time tem 4 agentes especialistas, executados em sequência fixa: **Mapper** (estrutura espacial), **Analyst** (dados quantitativos), **Storyteller** (narrativa e onboarding) e **Publisher** (integração final, selo, auto-discovery). Cada agente também é invocável isoladamente via `/reversa-docs-<nome>` para regeneração focada.
18
+
19
+ ## Posicionamento
20
+
21
+ Esse skill é o ponto de entrada do Time Reversa Docs. Não substitui nem altera os times de Descoberta e Migração. Lê os artefatos que eles produziram e renderiza visualmente. Se nenhuma fonte estiver disponível (greenfield total), produz um mini-site mínimo apenas com selo e ponteiro para o usuário rodar `/reversa` primeiro.
22
+
23
+ ## Antes de começar
24
+
25
+ 1. Leia `.reversa/state.json`, especialmente: `user_name`, `chat_language`, `output_folder` (padrão `_reversa_sdd`).
26
+ 2. Leia `_reversa_docs/.config.json` se existir.
27
+ 3. Detecte fontes disponíveis lendo `references/expected_sources.yaml` e verificando a presença de cada uma. Popule mentalmente o objeto `knowledgeSources`.
28
+
29
+ ## Diretiva non-destructive
30
+
31
+ Nada fora de `_reversa_docs/` é modificado. Os artefatos do core (`_reversa_sdd/`, `.reversa/soul.md`, `.reversa/chronicle.md`, código fonte do projeto legado) são apenas lidos.
32
+
33
+ Se `_reversa_docs/` já existir com conteúdo, leia `.state.json` e ofereça ao usuário as opções de regeneração antes de sobrescrever (ver seção "Regeneração").
34
+
35
+ ## Processo
36
+
37
+ ### 1. Detecção de fontes
38
+
39
+ Para cada item de `references/expected_sources.yaml`, verifique se o caminho existe. Monte o objeto:
40
+
41
+ ```json
42
+ {
43
+ "soul": true/false,
44
+ "chronicle": true/false,
45
+ "topology": true/false,
46
+ "sddSpecs": ["spec-1", "spec-2"],
47
+ "sourceCode": true/false
48
+ }
49
+ ```
50
+
51
+ Se nenhuma fonte estiver disponível, pergunte ao usuário:
52
+
53
+ > "[Nome], não encontrei `_reversa_sdd/`, `.reversa/soul.md` nem `.reversa/chronicle.md` no projeto. O mini-site vai ficar bem mínimo (apenas index com selo). Você quer:
54
+ >
55
+ > 1. Rodar `/reversa` primeiro para extrair conhecimento (recomendado)
56
+ > 2. Continuar mesmo assim, gerando só o index minimal
57
+ >
58
+ > Pressione 1 ou 2."
59
+
60
+ ### 2. Entrevista única (3 perguntas)
61
+
62
+ Se `.config.json` não existe, conduza a entrevista. Padrão de menu Reversa: opção com label e descrição, sempre uma opção "Outro" no fim para casos não previstos.
63
+
64
+ **Pergunta 1, perfil de leitor:**
65
+
66
+ > "[Nome], pra quem é esse mini-site?
67
+ >
68
+ > 1. **Novo dev entrando** — Quer entender a arquitetura e os módulos rápido pra começar a contribuir.
69
+ > 2. **Stakeholder não-técnico** — Quer ver escopo, histórico e estado do sistema sem ler código.
70
+ > 3. **Time externo auditando** — Consultoria, segurança ou conformidade. Quer densidade, métricas e evidências.
71
+ > 4. **Outro** — Descreva em uma frase.
72
+ >
73
+ > Digite 1, 2, 3 ou 4."
74
+
75
+ **Pergunta 2, profundidade:**
76
+
77
+ > "Qual profundidade você quer?
78
+ >
79
+ > 1. **Visão geral rápida** — Menos páginas, foco em arquitetura e glossário.
80
+ > 2. **Sistema completo** — Todas as páginas, padrão recomendado.
81
+ > 3. **Só features X, Y, Z** — Você escolhe quais specs viram página detalhada. Lista atual: [listar `_reversa_sdd/*/` encontrados].
82
+ > 4. **Outro** — Descreva.
83
+ >
84
+ > Digite 1, 2, 3 ou 4."
85
+
86
+ **Pergunta 3, estilo visual:**
87
+
88
+ > "Qual estilo visual?
89
+ >
90
+ > 1. **Sóbrio técnico** — Cinza, alto contraste, foco no conteúdo. Padrão.
91
+ > 2. **Premium cinematográfico** — Tons escuros, tipografia ampla, hero animado.
92
+ > 3. **Denso com dados** — Layout compacto, prioriza tabelas e gráficos.
93
+ > 4. **Exploratório com 3D destacado** — Code City em destaque, paleta vibrante.
94
+ > 5. **Outro** — Descreva.
95
+ >
96
+ > Digite 1, 2, 3, 4 ou 5."
97
+
98
+ Persista as respostas em `_reversa_docs/.config.json` seguindo o schema definido em `references/config-schema.json`.
99
+
100
+ ### 3. Seed determinístico
101
+
102
+ Calcule sha256 de `.reversa/soul.md` se existir, senão do nome do projeto. Registre em `.config.json` no campo `seed.hash`. Esse seed é usado pelos agentes para reprodutibilidade visual (selo, força do D3, distribuição do Code City).
103
+
104
+ Override aceito via flag `--seed=<valor>` no comando.
105
+
106
+ ### 4. Plano resumido
107
+
108
+ Antes de invocar os agentes, apresente ao usuário o plano:
109
+
110
+ > "[Nome], com base no que detectei, o plano é:
111
+ >
112
+ > **Mapper**: arquitetura.html, modulos.html[, topologia.html se topologia detectada]
113
+ > **Analyst**: metricas.html[, timeline.html se chronicle existe]
114
+ > **Storyteller**: glossario.html[, deck.html, features/* se specs existem]
115
+ > **Publisher**: index.html + selo + auto-discovery
116
+ >
117
+ > Omissões esperadas: [lista das páginas que serão omitidas e por quê]
118
+ >
119
+ > Tempo estimado: ~60 a 90 segundos.
120
+ >
121
+ > Digite **CONTINUAR** para iniciar o Mapper, ou **cancelar** para abortar."
122
+
123
+ ### 5. Execução sequencial dos 4 agentes
124
+
125
+ **Fase 0 (vendor bundle), antes do Mapper**: garanta que `assets/vendor/` está populado executando o procedimento de bundle vendor descrito no Passo 0 do Publisher (`agents/reversa-docs-publisher/SKILL.md`). Isso baixa Three.js, OrbitControls, D3, Highcharts e módulos via `agents/reversa-docs-publisher/references/vendor-pins.yaml` com retry de CDN. As páginas que o Mapper, Analyst e Storyteller geram referenciam essas libs locais via `<script src="assets/vendor/...">`; se as libs não estiverem no disco quando o usuário abrir, as páginas quebram.
126
+
127
+ Em modo isolado (usuário chamou `/reversa-docs-mapper` sem orquestrador), o agente isolado deve executar o mesmo Passo 0 do Publisher como preâmbulo do próprio processo, se `assets/vendor/` estiver vazio.
128
+
129
+ Depois do vendor bundle, execute em sequência **Mapper → Analyst → Storyteller → Publisher**.
130
+
131
+ Para cada agente na sequência:
132
+
133
+ 1. Informe: "Iniciando o **[Agente]**, [o que ele vai fazer]."
134
+ 2. Leia o `SKILL.md` do agente `reversa-docs-<nome>` correspondente (pasta irmã, no mesmo diretório de skills) na íntegra e execute no contexto atual, passando o `.config.json` como entrada.
135
+ 3. Após conclusão, atualize `_reversa_docs/.state.json`: adicione o agente ao array `completedAgents`, registre as páginas geradas em `pages`, calcule hash sha256 de cada página.
136
+ 4. Apresente resumo:
137
+
138
+ > "**[Agente]** concluído.
139
+ >
140
+ > Páginas geradas: [lista]
141
+ > Omissões: [lista com razão]
142
+ >
143
+ > Próximo: **[Agente]** vai [o que vai fazer].
144
+ >
145
+ > Digite **CONTINUAR** para prosseguir, ou **cancelar** para parar aqui."
146
+
147
+ Se o usuário digitar `cancelar`, salve o estado atual em `.state.json` (com `pendingAgents` populado) e termine. As páginas já geradas ficam preservadas.
148
+
149
+ ### 6. Resumo final (após Publisher)
150
+
151
+ > "[Nome], o mini-site está pronto.
152
+ >
153
+ > Caminho: `_reversa_docs/index.html`
154
+ > Total de páginas: [N]
155
+ > Páginas omitidas: [N]
156
+ > HTMLs auxiliares descobertos pelo Publisher: [N]
157
+ > Tempo total do pipeline: [X]s
158
+ > Smoke test: [verde / FALHOU: lista de páginas com problema]
159
+ >
160
+ > Como abrir:
161
+ > - **Duplo clique funciona**: o Publisher embedou dados em `assets/js/data.js` e baixou Three.js, D3 e Highcharts em `assets/vendor/`. Não precisa de servidor para abrir.
162
+ > - Windows: `start _reversa_docs/index.html`
163
+ > - macOS: `open _reversa_docs/index.html`
164
+ > - Linux: `xdg-open _reversa_docs/index.html`
165
+ > - **Para hot-reload durante edição**: `python -m http.server 8080` na pasta `_reversa_docs/` e acesse `http://localhost:8080/`.
166
+ >
167
+ > Próximo agente sugerido: [contextual: `/reversa-forward` se há specs, `/reversa-chronicler` se não há crônica recente, etc.]
168
+ >
169
+ > Digite **CONTINUAR** para prosseguir, ou apenas feche para sair."
170
+
171
+ ## Flag `--auto`
172
+
173
+ Quando o usuário invocar `/reversa-docs --auto`:
174
+ - Pula a entrevista, aplica defaults: `readerProfile=novo_dev`, `depth=full`, `visualStyle=sober`.
175
+ - Pula todos os handoffs `CONTINUAR`, executa os 4 agentes em sequência sem pausas.
176
+ - Mostra apenas o resumo final.
177
+
178
+ ## Regeneração
179
+
180
+ Se `_reversa_docs/.state.json` já existe (segunda execução), apresente:
181
+
182
+ > "[Nome], já existe um mini-site em `_reversa_docs/` gerado em [data do `lastCheckpoint`]. O que você quer fazer?
183
+ >
184
+ > 1. **Manter tudo** — Sair sem regenerar.
185
+ > 2. **Regenerar tudo** — Backup do atual em `.backup-<timestamp>/` e refazer do zero.
186
+ > 3. **Regenerar apenas <agente>** — Backup e refazer só as páginas de um agente. [listar agentes: Mapper, Analyst, Storyteller, Publisher]
187
+ > 4. **Regenerar apenas <página>** — Backup e refazer uma página específica. [listar páginas existentes]
188
+ > 5. **Refazer a entrevista** — Mantém páginas atuais, mas recoleta respostas para próxima regeneração.
189
+ > 6. **Outro** — Descreva.
190
+ >
191
+ > Digite 1, 2, 3, 4, 5 ou 6."
192
+
193
+ Backup automático em `_reversa_docs/.backup-<YYYYMMDD-HHMMSS>/` antes de qualquer escrita destrutiva.
194
+
195
+ ## Telemetria local
196
+
197
+ Ao final do pipeline (sucesso ou falha parcial), grave em `_reversa_docs/.state.json`:
198
+ - `pipelineDurationMs` (int)
199
+ - `pagesGenerated` (array)
200
+ - `pagesOmitted` (array de `{page, reason}`)
201
+ - `auxiliaryHtmlsDiscovered` (int)
202
+ - `cdnFallbackUsed` (boolean)
203
+
204
+ Nenhuma coleta remota. Tudo fica no projeto do usuário.
205
+
206
+ ## Estouro de contexto
207
+
208
+ Se o contexto estiver se esgotando entre agentes:
209
+ 1. Salve `.state.json` com `pendingAgents` populado.
210
+ 2. Diga: "[Nome], vou pausar entre agentes. Tudo salvo. Digite `/reversa-docs` em uma nova sessão para continuar."
211
+
212
+ ## Regras absolutas
213
+
214
+ - Nunca escreva fora de `_reversa_docs/`.
215
+ - Nunca modifique artefatos do core (`_reversa_sdd/`, `.reversa/soul.md`, `.reversa/chronicle.md`).
216
+ - Nunca apague ou sobrescreva sem backup automático em `.backup-<timestamp>/`.
217
+ - Nunca rode varredura de credenciais no código do projeto. Se identificar pista de credencial, ignore e não cite.
218
+ - Nunca avance entre agentes sem `CONTINUAR` do usuário (exceto em `--auto`).
219
+ - Todo texto exibido ao usuário em pt-br, sem travessão.
220
+
221
+ ## Invariantes técnicas do mini-site (para todos os 4 agentes do time)
222
+
223
+ Essas invariantes valem para Mapper, Analyst, Storyteller e Publisher. O Publisher é o guardião final, mas qualquer agente que violar quebra a invariante:
224
+
225
+ 1. **Funciona via `file://`**: usuário abre `index.html` com duplo clique e tudo funciona. Nenhuma página faz `fetch()` para arquivos locais (CORS bloqueia origin `null`). Dados vêm de `window.RV_DATA.<chave>`, injetado pelo `assets/js/data.js` que o Publisher gera no passo 3.
226
+ 2. **Funciona offline**: nenhuma página tem `<script src="https://...">` para CDN. Libs externas (Three.js, D3, Highcharts, OrbitControls e módulos) ficam em `assets/vendor/`, baixadas pelo Publisher via `agents/reversa-docs-publisher/references/vendor-pins.yaml`.
227
+ 3. **Nav reflete `pagesGenerated`**: o `<!-- NAV_LINKS -->` do `viewer.html` é preenchido pelo Publisher no passo 4, lendo `.state.json.pagesGenerated`. Páginas omitidas não aparecem no nav. Mapper, Analyst e Storyteller **deixam o marcador como está**, sem preencher hardcoded.
228
+ 4. **Smoke test no Publisher**: o Publisher faz teste real de carregamento (http.server + GET + grep de padrões de erro) antes de declarar sucesso. Falha aparece em destaque no resumo final.
229
+ 5. **Scripts Python emitidos sempre começam com preâmbulo de encoding** para evitar `UnicodeEncodeError` em Windows com Python 3.12+ default cp1252:
230
+
231
+ ```python
232
+ import sys
233
+ if sys.platform == "win32":
234
+ try:
235
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
236
+ sys.stderr.reconfigure(encoding="utf-8", errors="replace")
237
+ except AttributeError:
238
+ pass
239
+ ```
240
+
241
+ Alternativa: usar apenas ASCII em prints. Ambos aceitos.
@@ -0,0 +1,3 @@
1
+ interface:
2
+ display_name: "Reversa Docs"
3
+ short_description: "Orquestrador do Time Reversa Docs"
@@ -0,0 +1,108 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "title": "Reversa Docs Config",
4
+ "description": "Configuração persistida em _reversa_docs/.config.json após a entrevista do /reversa-docs. Reusada por execuções subsequentes e por agentes isolados.",
5
+ "type": "object",
6
+ "required": ["schemaVersion", "generatedAt", "projectName", "interview", "seed", "knowledgeSources"],
7
+ "properties": {
8
+ "schemaVersion": {
9
+ "type": "integer",
10
+ "const": 1,
11
+ "description": "Versão do schema. Incrementar quando houver breaking change."
12
+ },
13
+ "generatedAt": {
14
+ "type": "string",
15
+ "format": "date-time",
16
+ "description": "ISO-8601 do momento em que a entrevista foi conduzida."
17
+ },
18
+ "reversa": {
19
+ "type": "object",
20
+ "properties": {
21
+ "version": { "type": "string" }
22
+ }
23
+ },
24
+ "projectName": {
25
+ "type": "string",
26
+ "description": "Nome do projeto. Vem do soul.md se houver, senão do nome da pasta raiz."
27
+ },
28
+ "interview": {
29
+ "type": "object",
30
+ "required": ["readerProfile", "depth", "visualStyle"],
31
+ "properties": {
32
+ "readerProfile": {
33
+ "type": "string",
34
+ "enum": ["novo_dev", "stakeholder", "auditor", "other"]
35
+ },
36
+ "readerProfileFreeform": {
37
+ "type": "string",
38
+ "description": "Texto livre quando readerProfile = other."
39
+ },
40
+ "depth": {
41
+ "type": "string",
42
+ "enum": ["overview", "full", "features_selection", "other"]
43
+ },
44
+ "depthFreeform": {
45
+ "type": "string"
46
+ },
47
+ "selectedFeatures": {
48
+ "type": "array",
49
+ "items": { "type": "string" },
50
+ "description": "IDs das specs escolhidas quando depth = features_selection."
51
+ },
52
+ "visualStyle": {
53
+ "type": "string",
54
+ "enum": ["sober", "premium", "dense", "exploratory", "other"]
55
+ },
56
+ "visualStyleFreeform": {
57
+ "type": "string"
58
+ }
59
+ }
60
+ },
61
+ "seed": {
62
+ "type": "object",
63
+ "required": ["hash", "source"],
64
+ "properties": {
65
+ "hash": {
66
+ "type": "string",
67
+ "pattern": "^sha256:[a-f0-9]{64}$"
68
+ },
69
+ "source": {
70
+ "type": "string",
71
+ "enum": ["soul.md", "project_name"]
72
+ },
73
+ "explicitOverride": {
74
+ "type": ["string", "null"],
75
+ "description": "Valor passado via --seed=<valor>, sobrescreve hash calculado."
76
+ }
77
+ }
78
+ },
79
+ "knowledgeSources": {
80
+ "type": "object",
81
+ "properties": {
82
+ "soul": { "type": "boolean" },
83
+ "chronicle": { "type": "boolean" },
84
+ "topology": { "type": "boolean" },
85
+ "sddSpecs": {
86
+ "type": "array",
87
+ "items": { "type": "string" }
88
+ },
89
+ "sourceCode": { "type": "boolean" }
90
+ }
91
+ },
92
+ "pagesPlanned": {
93
+ "type": "array",
94
+ "items": { "type": "string" },
95
+ "description": "Paths relativos das páginas que serão geradas, decidido após a entrevista."
96
+ },
97
+ "pagesOmitted": {
98
+ "type": "array",
99
+ "items": {
100
+ "type": "object",
101
+ "properties": {
102
+ "page": { "type": "string" },
103
+ "reason": { "type": "string" }
104
+ }
105
+ }
106
+ }
107
+ }
108
+ }
@@ -0,0 +1,60 @@
1
+ # Fontes esperadas pelo Time Reversa Docs
2
+ # Cada item declara um artefato do core do Reversa que, se presente, alimenta uma ou mais páginas do mini-site.
3
+ # Ausência nunca bloqueia: páginas dependentes da fonte são omitidas graciosamente.
4
+
5
+ sources:
6
+ - id: soul
7
+ path: ".reversa/soul.md"
8
+ producer: "reversa-extract-soul"
9
+ consumed_by:
10
+ - "Storyteller (glossario.html, deck.html)"
11
+ - "Publisher (seed sha256, hero)"
12
+ required_for:
13
+ - "glossario.html"
14
+ - "deck.html (parcialmente)"
15
+ description: "Síntese executiva do projeto. Origem do glossário e do título do hero."
16
+
17
+ - id: chronicle
18
+ path: ".reversa/chronicle.md"
19
+ producer: "reversa-chronicler"
20
+ consumed_by:
21
+ - "Analyst (timeline.html)"
22
+ required_for:
23
+ - "timeline.html"
24
+ description: "Histórico de eventos, releases e incidentes. Origem da timeline interativa."
25
+
26
+ - id: topology
27
+ path: "_reversa_sdd/architecture.md"
28
+ producer: "reversa-architect"
29
+ consumed_by:
30
+ - "Mapper (topologia.html)"
31
+ required_for:
32
+ - "topologia.html"
33
+ description: "Topologia detectada (legado vs moderno vs híbrido). Origem da página side-by-side."
34
+ optional: true
35
+
36
+ - id: sdd_specs
37
+ path: "_reversa_sdd/"
38
+ pattern: "*/requirements.md"
39
+ producer: "reversa-writer"
40
+ consumed_by:
41
+ - "Storyteller (features/*.html)"
42
+ required_for:
43
+ - "features/<spec>.html (uma página por spec)"
44
+ description: "Specs SDD por feature. Cada subpasta com requirements.md vira uma página detalhada."
45
+
46
+ - id: source_code
47
+ path: "."
48
+ pattern: "(arquivos do projeto legado)"
49
+ producer: "(humano + git)"
50
+ consumed_by:
51
+ - "Mapper (arquitetura.html, modulos.html, modules.json, deps.json)"
52
+ - "Analyst (metricas.html via modules.json)"
53
+ required_for:
54
+ - "arquitetura.html"
55
+ - "modulos.html"
56
+ - "metricas.html"
57
+ description: "Código fonte do projeto legado. Origem das métricas de LOC, complexidade e dependências."
58
+ extraction_scripts:
59
+ - "extract_modules.py"
60
+ - "extract_deps.py"