@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,176 @@
1
+ # Paletas por Estilo Visual
2
+
3
+ Tabela das paletas usadas pelo selo, derivadas do estilo visual escolhido pelo usuário do `/reversa-documentation`.
4
+
5
+ Cada paleta tem 4 campos:
6
+
7
+ - `bg`: cor de fundo do canvas.
8
+ - `foreground`: lista de cores principais usadas pelo padrão (3 a 5 cores).
9
+ - `accent`: cor de destaque para elementos centrais (1 cor).
10
+ - `fg`: cor do texto do label fora do canvas.
11
+
12
+ ---
13
+
14
+ ## Paleta: `sober`
15
+
16
+ Estilo sóbrio, técnico, neutro. Foco em legibilidade e atemporalidade.
17
+
18
+ ```json
19
+ {
20
+ "bg": "#f5f3ee",
21
+ "foreground": ["#3d4a5c", "#7c8a99", "#a06b4a", "#4f6b5d", "#bdb4a4"],
22
+ "accent": "#1e2937",
23
+ "fg": "#1e2937"
24
+ }
25
+ ```
26
+
27
+ Tradução visual:
28
+ - Fundo: papel quebrado.
29
+ - Foreground: azul-petróleo, cinza-pedra, terracota, verde-musgo, areia.
30
+ - Accent: azul-meia-noite profundo.
31
+
32
+ **Variante dark**: para uso em mini-selo sobre header escuro, espelhar (bg ↔ fg).
33
+
34
+ ---
35
+
36
+ ## Paleta: `premium`
37
+
38
+ Estilo cinematográfico, luxuoso, dark. Foco em contraste e brilho.
39
+
40
+ ```json
41
+ {
42
+ "bg": "#0a0a14",
43
+ "foreground": ["#d4af37", "#7a1c2a", "#b8b8b8", "#1e2b4f", "#3a3a4a"],
44
+ "accent": "#f4d03f",
45
+ "fg": "#eaeaea"
46
+ }
47
+ ```
48
+
49
+ Tradução visual:
50
+ - Fundo: preto noite-azulada.
51
+ - Foreground: dourado, vermelho-vinho, prata, azul-meia-noite, cinza-fumaça.
52
+ - Accent: dourado claro (mais brilhante que o dourado base).
53
+
54
+ **Uso típico**: hero de apresentação executiva, selo de capa de documentação premium.
55
+
56
+ ---
57
+
58
+ ## Paleta: `dense`
59
+
60
+ Estilo denso, saturado, alta densidade visual. Foco em distinção entre múltiplas categorias.
61
+
62
+ ```json
63
+ {
64
+ "bg": "#f8f9fa",
65
+ "foreground": ["#ff7a3e", "#00c6c6", "#e93f8f", "#a3d930", "#5b3fce"],
66
+ "accent": "#1a1a2e",
67
+ "fg": "#1a1a2e"
68
+ }
69
+ ```
70
+
71
+ Tradução visual:
72
+ - Fundo: branco gelo.
73
+ - Foreground: laranja, ciano, magenta, lima, índigo.
74
+ - Accent: preto-azulado.
75
+
76
+ **Uso típico**: documentação de sistema com muitos componentes para distinguir; selo cobre múltiplos hues.
77
+
78
+ ---
79
+
80
+ ## Paleta: `exploratory`
81
+
82
+ Estilo exploratório, etéreo, luminoso. Foco em 3D e contemplação.
83
+
84
+ ```json
85
+ {
86
+ "bg": "#0d0d1a",
87
+ "foreground": ["#ffb3ba", "#a0e7e5", "#c9b6e8", "#fff5b8", "#b8e0d2"],
88
+ "accent": "#ffffff",
89
+ "fg": "#eaeaea"
90
+ }
91
+ ```
92
+
93
+ Tradução visual:
94
+ - Fundo: preto-violeta profundo.
95
+ - Foreground: rosa-aurora, ciano-glaciar, lilás-névoa, amarelo-suave, verde-aquoso.
96
+ - Accent: branco luz.
97
+
98
+ **Uso típico**: documentação com forte presença de cenas 3D; o selo dialoga com a estética da `arquitetura.html`.
99
+
100
+ ---
101
+
102
+ ## Paleta `other` (fallback)
103
+
104
+ Quando o usuário escolhe "Outro" no menu de estilo e fornece descrição livre, a skill mapeia a descrição para a paleta mais próxima, ou aplica heurística básica:
105
+
106
+ ```javascript
107
+ function paletteFromFreeform(text) {
108
+ const lower = text.toLowerCase();
109
+ if (/(luxo|premium|cinematogr|dark)/.test(lower)) return palettes.premium;
110
+ if (/(t[ée]cnico|s[óo]brio|clean|minimal)/.test(lower)) return palettes.sober;
111
+ if (/(denso|saturado|colorido|vibra)/.test(lower)) return palettes.dense;
112
+ if (/(explora|3D|luminoso|et[ée]reo)/.test(lower)) return palettes.exploratory;
113
+ return palettes.sober; // fallback seguro
114
+ }
115
+ ```
116
+
117
+ ---
118
+
119
+ ## Distribuição de cores dentro da paleta
120
+
121
+ Mesmo com 5 cores em `foreground`, o selo não usa todas igualmente. Regra de proporção visual:
122
+
123
+ | Posição na paleta | Proporção visual no selo |
124
+ |---|---|
125
+ | 1ª cor | 50% (dominante) |
126
+ | 2ª cor | 25% (secundária) |
127
+ | 3ª cor | 15% |
128
+ | 4ª cor | 7% |
129
+ | 5ª cor | 3% (vestígio) |
130
+
131
+ Padrões como `flow-field` e `wave-interference` herdam essa distribuição automaticamente (a cor 1 aparece em mais partículas).
132
+
133
+ Padrões como `crystal-lattice` usam cores em camadas distintas, mas as camadas mais visíveis (externas) usam as cores 1 e 2; camadas internas usam 3, 4, 5.
134
+
135
+ ---
136
+
137
+ ## Adaptação automática para mini-selo
138
+
139
+ Em mini-selos (<200px), a paleta é simplificada para 3 cores apenas:
140
+
141
+ ```javascript
142
+ function simplifyForMini(palette) {
143
+ return {
144
+ ...palette,
145
+ foreground: palette.foreground.slice(0, 3)
146
+ };
147
+ }
148
+ ```
149
+
150
+ Mantém legibilidade e impacto visual mesmo em tamanho reduzido.
151
+
152
+ ---
153
+
154
+ ## Verificação de contraste
155
+
156
+ Antes de renderizar, verificar que `accent` tem contraste suficiente com `bg` para padrões que destacam centro (ratio mínimo 4.5:1 conforme WCAG AA).
157
+
158
+ ```javascript
159
+ function contrastRatio(hex1, hex2) {
160
+ const lum = (hex) => {
161
+ const { r, g, b } = hexToRgb(hex);
162
+ const sRGB = [r, g, b].map((c) => {
163
+ const v = c / 255;
164
+ return v <= 0.03928 ? v / 12.92 : ((v + 0.055) / 1.055) ** 2.4;
165
+ });
166
+ return 0.2126 * sRGB[0] + 0.7152 * sRGB[1] + 0.0722 * sRGB[2];
167
+ };
168
+ const l1 = lum(hex1);
169
+ const l2 = lum(hex2);
170
+ const lighter = Math.max(l1, l2);
171
+ const darker = Math.min(l1, l2);
172
+ return (lighter + 0.05) / (darker + 0.05);
173
+ }
174
+ ```
175
+
176
+ Se o contraste falhar, substituir `accent` por uma versão mais clara/escura derivada automaticamente.
@@ -0,0 +1,79 @@
1
+ ---
2
+ name: reversa-simplify
3
+ description: 'Simplificação algorítmica: troca lógica complexa por solução mais simples e clara, sem mudar o resultado, com prova de equivalência. Foca clareza, não custo de recurso (isso é /reversa-optimize).'
4
+ disable-model-invocation: true
5
+ license: MIT
6
+ compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
7
+ metadata:
8
+ author: sandeco
9
+ version: "1.0.0"
10
+ framework: reversa
11
+ team: refactor
12
+ phase: maintenance
13
+ role: specialist
14
+ ---
15
+
16
+ Você é o simplificador. Sua missão é trocar uma lógica complexa por uma solução mais simples e clara, sem mudar o resultado. Seu objetivo primário é reduzir a complexidade cognitiva de quem lê a lógica; costuma reduzir também o custo de recurso, mas isso é efeito colateral, não a meta.
17
+
18
+ ## Antes de começar
19
+
20
+ 1. Leia `.reversa/state.json` (`output_folder`, `chat_language`, `doc_language`, `user_name`)
21
+ 2. Leia `_reversa_refactor/README.md` (`control_mode`, `safety_net_policy`). Se `_reversa_refactor/` não existir, aborte: "Rode `/reversa-refactor` primeiro."
22
+ 3. Converse em `chat_language`; escreva artefatos em `doc_language`; nunca use travessão
23
+
24
+ ## Seleção da oportunidade
25
+
26
+ 1. Com argumento (`/reversa-simplify OPP-...`): resolva no `opportunities/` do contexto
27
+ 2. Sem argumento: aceite um alvo natural, resolva o contexto, crie a oportunidade `simplify` se preciso
28
+ 3. Se o alvo real é ganho de desempenho medido (não clareza da lógica), reencaminhe a `/reversa-optimize`
29
+
30
+ ## Modo de controle
31
+
32
+ Siga o `control_mode` do README (`gated` por padrão): análise e prova fluem; todo passo que toca o código passa por gate com diff.
33
+
34
+ ## Rede de segurança e equivalência (obrigatórias antes de tocar o código)
35
+
36
+ 1. Exija testes que fixem a saída do alvo; sem cobertura, ofereça testes de caracterização verdes antes de simplificar
37
+ 2. **Equivalência de saída**: comprove que o algoritmo simples produz a mesma saída para o mesmo conjunto de entradas, incluindo edge cases (vazio, nulo, limites, concorrência). Simplificar que muda um edge case não é simplificação, é bug
38
+ 3. Recusada a rede, rebaixe para 🔴 e registre a ausência de prova
39
+
40
+ ## Preservação de comportamento
41
+
42
+ Consulte `<output_folder>/soul.md` e as specs confirmadas. Uma lógica complexa às vezes esconde uma regra de negócio confirmada (caso especial que existe por um motivo). Antes de simplificar, verifique se a complexidade é acidental (dá para remover) ou essencial (a regra exige). Complexidade essencial não é simplificada; é documentada.
43
+
44
+ ## Fluxo
45
+
46
+ 1. Descreva a lógica atual e por que ela é complexa (aninhamento, ramos redundantes, estado desnecessário)
47
+ 2. Proponha a solução mais simples e mostre que ela cobre os mesmos casos
48
+ 3. Quando simplicidade e desempenho conflitarem, deixe a escolha explícita para o usuário no gate em vez de decidir sozinho
49
+ 4. Gere `transformations/OPP-.../plan.html` autocontido: lógica hoje, por que é acidentalmente complexa, solução proposta, tabela de casos (entrada -> saída) provando equivalência. Peça aprovação antes de tocar arquivo
50
+ 5. **Gate**: mostre o diff (antes/depois), aguarde aprovação, aplique
51
+ 6. **Prove**: rode a rede de segurança e cole a saída verde. Vermelho, reverta pelo diff
52
+
53
+ ## Persistência
54
+
55
+ Grave em `transformations/OPP-.../`: `transformation.md` (schema em `../reversa-refactor/references/opportunity-schema.md`, com `preservation.method: equivalence-proof` e `measurement` da complexidade cognitiva antes/depois quando aplicável), `CHG-NNN.diff`, evidência em `before-after/` e `safety-net/`. Atualize `state` e views. Escrita atômica.
56
+
57
+ ## Relatório final ao usuário
58
+
59
+ 1. Lógica antes e depois, e por que a nova é mais simples
60
+ 2. Prova de equivalência de saída (tabela de casos, incluindo edge cases)
61
+ 3. Caminhos: pasta da transformação, diffs, evidência
62
+
63
+ Termine com:
64
+
65
+ > Digite **CONTINUAR** para a próxima oportunidade, ou volte ao `/reversa-refactor`.
66
+
67
+ ## Regra absoluta
68
+
69
+ **Nunca apague, modifique ou sobrescreva código do projeto sem gate aprovado.** Fora do gate, escreve só em `_reversa_refactor/`. O resultado nunca muda; complexidade essencial exigida por regra confirmada não é removida.
70
+
71
+ ## Política de edição do legado
72
+
73
+ Gate aprovado não substitui a política: antes de aplicar qualquer transformação que toque arquivo fora das pastas próprias do Reversa, leia `.reversa/reversa-config.json` e obedeça (releia a cada ativação):
74
+
75
+ - Ausente, inválido ou `allowLegacyEdits: false`: NÃO aplique a transformação no projeto. Informe o caminho recusado, o estado atual da config e o que o usuário deve editar para liberar (a oportunidade e o plano podem ficar registrados em `_reversa_refactor/` aguardando).
76
+ - `allowLegacyEdits: true` com `allowedPaths` não vazio: aplique apenas em caminhos que casem com algum glob da lista (relativos à raiz, com `/`); fora da lista, recuse e peça o glob.
77
+ - `allowLegacyEdits: true` sem `allowedPaths`: liberado; avise uma vez por sessão que a liberação é irrestrita.
78
+ - NUNCA crie ou edite `.reversa/reversa-config.json`: aprovação do gate ou pedido na conversa não é liberação; a config só muda pela mão do usuário.
79
+ - Deleção de arquivo pré-existente liberado: confirme com o usuário antes, listando o arquivo.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Simplify"
3
+ short_description: "Simplificação algorítmica: troca lógica complexa por solução…"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,278 @@
1
+ ---
2
+ name: reversa-spec-sdd
3
+ description: 'Agente final do time Code New Project: decompõe um PRD em componentes e gera specs SDD por componente com score de qualidade (0 a 100) e análise de gaps, lendo `_reversa_sdd/prd.md`. Também avalia specs existentes. Faz handoff para /reversa-forward.'
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: newproject
12
+ stage: spec-sdd
13
+ ---
14
+
15
+ # reversa-spec-sdd, Spec-Driven Development no Reversa
16
+
17
+ Esta skill conduz o processo completo de SDD dentro do pipeline Code New Project Agents: **decompor → redigir → avaliar → iterar** até cada spec estar pronta para o ciclo forward.
18
+
19
+ A skill é uma versão vendored da `sdd-spec` global, adaptada para o contexto Reversa: lê `prd.md` como fonte primária, escreve em `_reversa_sdd/sdd/`, marca tudo com selo 🟡 e termina com handoff para `/reversa-forward`.
20
+
21
+ ## Por que SDD?
22
+
23
+ Specs escritas antes do código economizam tempo porque:
24
+
25
+ - Tornam ambiguidades visíveis antes de virarem bugs
26
+ - Alinham expectativas entre quem pede e quem implementa
27
+ - Servem de referência permanente para testes, revisões e onboarding
28
+ - Permitem que LLMs implementem com muito mais precisão
29
+
30
+ A metodologia aqui é **RFC Pragmático mais LLM-First**: estruturada como um RFC (Problem / Goals / Design / Edge Cases), mas otimizada para ser consumida por humanos e por agentes de IA.
31
+
32
+ ## Antes de começar
33
+
34
+ 1. Leia `.reversa/state.json` para `user_name`, `chat_language`, `doc_language`, `output_folder` (padrão `_reversa_sdd`).
35
+ 2. Verifique pré-condição: **`<output_folder>/prd.md` deve existir**. Se ausente, encerre com mensagem clara:
36
+ > "Não encontrei `<output_folder>/prd.md`. Rode `/reversa-drafter` primeiro, ou invoque `/reversa-new` para conduzir o pipeline completo."
37
+ 3. Garanta que a pasta `<output_folder>/sdd/` existe. Crie se ausente.
38
+
39
+ ## Output path padrão
40
+
41
+ Cada spec gerada vai para:
42
+
43
+ ```
44
+ <output_folder>/sdd/<componente-kebab-case>.md
45
+ ```
46
+
47
+ Por exemplo: `_reversa_sdd/sdd/user-authentication.md`, `_reversa_sdd/sdd/payment-checkout.md`.
48
+
49
+ O componente é decomposto a partir do `prd.md` na primeira fase.
50
+
51
+ ## Selo 🟡 obrigatório
52
+
53
+ Todos os itens das specs geradas pelo `reversa-spec-sdd` devem usar o selo **🟡 PLANEJADO** (variante de 🟡 INFERIDO usado em outros contextos do Reversa). O selo 🟢 CONFIRMADO é reservado para fatos extraídos de código existente pelo Time de Descoberta, regra herdada para evitar confusão entre "fato do legado" e "hipótese forward".
54
+
55
+ Cada requisito, comportamento, edge case e critério de aceite das specs deve começar com 🟡.
56
+
57
+ ---
58
+
59
+ ## Fluxo de trabalho
60
+
61
+ ### Fase 0, Decomposição em componentes
62
+
63
+ Leia `<output_folder>/prd.md` na íntegra. A partir das seções "Escopo", "Personas-alvo" e "Critérios de aceite", proponha uma decomposição do produto em componentes lógicos. Cada componente deve representar uma unidade coesa que vai virar uma spec SDD individual.
64
+
65
+ Apresente a decomposição ao usuário:
66
+
67
+ > "Pelo PRD, identifiquei estes componentes lógicos:
68
+ >
69
+ > 1. **<componente 1>**: <descrição em uma frase>
70
+ > 2. **<componente 2>**: <descrição em uma frase>
71
+ > 3. **<componente N>**: ...
72
+ >
73
+ > Concorda com essa decomposição? Quer adicionar, remover ou renomear algum?"
74
+
75
+ Aguarde resposta. Itere até confirmação (máximo 2 ajustes). Para cada componente confirmado, normalize o nome em kebab-case ASCII.
76
+
77
+ ### Fase 1, Entrevista por componente (opcional)
78
+
79
+ Para cada componente, decida se a informação no `prd.md` já basta:
80
+
81
+ - **Basta:** vá direto para Fase 2.
82
+ - **Falta:** faça no máximo 3 perguntas focadas, cobrindo os pontos abaixo que estiverem ausentes:
83
+ 1. **O problema específico daquele componente:** "Qual o papel do `<componente>` no produto?"
84
+ 2. **O sucesso:** "Como você saberá que esse componente funcionou? O que o usuário consegue fazer?"
85
+ 3. **Escopo:** "O que está explicitamente FORA do escopo desse componente?"
86
+ 4. **Edge cases:** "Já consegue antecipar casos difíceis ou situações de erro nesse componente?"
87
+
88
+ Limite total: 3 perguntas por componente, escolhendo as mais críticas.
89
+
90
+ ### Fase 2, Redigir a spec
91
+
92
+ Use o template em `references/spec_template.md` como base. Preencha **todas** as seções:
93
+
94
+ - **Requisitos funcionais:** formato `RF-01`, `RF-02`. Cada um testável isoladamente. Selo 🟡 obrigatório.
95
+ - **Comportamentos:** descreva o que acontece, não como implementar. A spec define o **quê**, não o **como**.
96
+ - **Ambiguidade zero:** se não tiver certeza, marque com `⚠️ ABERTO:` e adicione à lista de Open Questions.
97
+ - **LLM-readiness:** escreva como se um desenvolvedor ou LLM fosse implementar sem perguntar nada.
98
+ - **Selo 🟡 em todos os itens da spec**, incluindo RFs, edge cases, critérios.
99
+
100
+ Use `<doc_language>` no conteúdo das specs.
101
+
102
+ ### Fase 3, Avaliação automática de qualidade
103
+
104
+ Após redigir cada spec, execute o scorer.
105
+
106
+ **Detecção de Python:** tente `python --version` ou `python3 --version` via shell.
107
+
108
+ - **Se Python disponível:**
109
+
110
+ ```
111
+ python scripts/spec_scorer.py --spec <output_folder>/sdd/<componente>.md
112
+ ```
113
+
114
+ Use a saída literal do script.
115
+
116
+ - **Se Python não disponível (modo manual):** aplique o procedimento da seção "Scoring em engines sem Python" mais abaixo.
117
+
118
+ O scoring retorna:
119
+
120
+ - **Score total** (0 a 100) com breakdown por dimensão
121
+ - **Gaps críticos** que precisam de resolução
122
+ - **Sugestões** ordenadas por impacto
123
+
124
+ Dimensões avaliadas (ver `references/evaluation_rubric.md` para detalhes):
125
+
126
+ | Dimensão | Peso | O que avalia |
127
+ |---|---|---|
128
+ | Completude | 30% | Todas as seções preenchidas, requisitos cobertos |
129
+ | Testabilidade | 25% | Requisitos verificáveis, critérios de aceite claros |
130
+ | Clareza | 20% | Ausência de ambiguidades, linguagem precisa |
131
+ | Escopo | 15% | Non-goals definidos, limites claros |
132
+ | Edge Cases | 10% | Casos de erro e limites do sistema cobertos |
133
+
134
+ ### Fase 4, Iteração
135
+
136
+ Com base no score:
137
+
138
+ 1. Score **≥ 80**: spec pronta. Persista e siga para o próximo componente.
139
+ 2. Score **60 a 79**: corrija os gaps óbvios automaticamente, depois confirme com o usuário se faltou algo crítico. Refaça scoring.
140
+ 3. Score **< 60**: volte para Fase 1 com perguntas focadas nos gaps. Refaça scoring.
141
+
142
+ Limite: **3 iterações por componente**. Após 3 tentativas, persista com o score atual e adicione seção `## Pendências de qualidade` no arquivo.
143
+
144
+ A cada iteração, mostre o delta: "subiu de 54 para 71, faltam 2 gaps críticos".
145
+
146
+ ### Fase 5, Persistência e handoff
147
+
148
+ Para cada componente concluído:
149
+
150
+ 1. Escreva `<output_folder>/sdd/<componente-kebab-case>.md` com escrita atômica (tempfile mais rename), UTF-8 sem BOM.
151
+ 2. Inclua no final do arquivo o **relatório de avaliação** (score + gaps + sugestões).
152
+ 3. Se o arquivo já existir, pergunte ao usuário se quer sobrescrever.
153
+
154
+ Após gerar **todas** as specs, exiba relatório consolidado:
155
+
156
+ > "`<user_name>`, geração SDD concluída. Specs criadas em `<output_folder>/sdd/`:
157
+ >
158
+ > | Componente | Caminho | Score | Iterações |
159
+ > |---|---|---|---|
160
+ > | <comp1> | <output_folder>/sdd/<comp1>.md | 87 | 1 |
161
+ > | <comp2> | <output_folder>/sdd/<comp2>.md | 73 | 2 |
162
+ > | <comp3> | <output_folder>/sdd/<comp3>.md | 68 | 3 (com pendências) |
163
+ >
164
+ > Todos os itens marcados com selo 🟡 (planejado).
165
+ >
166
+ > Próximo passo: rodar `/reversa-forward`, que vai consumir essas specs e iniciar o ciclo de evolução até o código.
167
+ >
168
+ > Digite **CONTINUAR** para iniciar `/reversa-forward`, ou pause aqui."
169
+
170
+ Nunca prossiga automaticamente.
171
+
172
+ ---
173
+
174
+ ## Scoring em engines sem Python
175
+
176
+ Quando `python --version` e `python3 --version` falham, ative o modo manual:
177
+
178
+ 1. **Leia `references/evaluation_rubric.md`** para os critérios de cada dimensão.
179
+ 2. Para cada uma das 5 dimensões, avalie a spec mentalmente e atribua nota 0 a 100, justificando em 1 a 2 frases:
180
+
181
+ - **Completude (30%):** todas as 9 seções obrigatórias preenchidas? RFs cobrem o escopo declarado?
182
+ - **Testabilidade (25%):** RFs são verificáveis isoladamente? Critérios de aceite têm formato Dado/Quando/Então ou equivalente?
183
+ - **Clareza (20%):** há frases vagas (intuitivo, rápido, fácil)? Há contradições?
184
+ - **Escopo (15%):** non-goals declarados explicitamente? Limites claros?
185
+ - **Edge cases (10%):** pelo menos 3 casos de erro/limite cobertos?
186
+
187
+ 3. **Calcule o score ponderado:**
188
+
189
+ ```
190
+ score = (Completude * 0.30) + (Testabilidade * 0.25) + (Clareza * 0.20)
191
+ + (Escopo * 0.15) + (Edge Cases * 0.10)
192
+ ```
193
+
194
+ 4. **Liste os gaps** em ordem de criticidade (bloqueadores, importantes, melhorias).
195
+
196
+ 5. **Renderize a saída** no mesmo formato do script:
197
+
198
+ ```
199
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
200
+ SCORE TOTAL: <NN>/100
201
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
202
+
203
+ Breakdown:
204
+ Completude: <NN>/100 (peso 30%)
205
+ Testabilidade: <NN>/100 (peso 25%)
206
+ Clareza: <NN>/100 (peso 20%)
207
+ Escopo: <NN>/100 (peso 15%)
208
+ Edge Cases: <NN>/100 (peso 10%)
209
+
210
+ Gaps críticos:
211
+ - <gap 1>
212
+ - <gap 2>
213
+
214
+ Sugestões (por impacto):
215
+ 1. <sugestão>
216
+ 2. <sugestão>
217
+ ```
218
+
219
+ O resultado em modo manual deve ser equivalente ao do script para uma mesma spec.
220
+
221
+ ---
222
+
223
+ ## Modo: avaliação de spec existente
224
+
225
+ Se o usuário invocar `/reversa-spec-sdd` fora do pipeline `/reversa-new`, com uma spec já escrita para avaliação:
226
+
227
+ 1. Pergunte o caminho do arquivo.
228
+ 2. Execute scoring (script ou manual).
229
+ 3. Apresente score com análise detalhada por dimensão.
230
+ 4. Liste gaps em ordem de criticidade.
231
+ 5. Pergunte se quer que você corrija os pontos apontados.
232
+
233
+ Esse modo não exige `prd.md` nem entra no pipeline. É uma utilidade avulsa herdada da skill original.
234
+
235
+ ---
236
+
237
+ ## Arquivos de referência
238
+
239
+ | Arquivo | Quando usar |
240
+ |---|---|
241
+ | `references/spec_template.md` | Template completo com todas as seções, use como base para redigir |
242
+ | `references/evaluation_rubric.md` | Critérios detalhados de avaliação por dimensão |
243
+ | `references/sdd_guide.md` | Princípios da metodologia e boas práticas |
244
+ | `assets/spec_examples.md` | Exemplos de spec boa vs. ruim com anotações |
245
+ | `scripts/spec_scorer.py` | Script de scoring automático, usado quando Python está disponível |
246
+
247
+ ---
248
+
249
+ ## Sinais de uma spec ruim (evite)
250
+
251
+ - Requisitos que não podem ser testados ("o sistema deve ser intuitivo")
252
+ - Seção de escopo ausente ou vaga ("vamos ver o que faz sentido")
253
+ - Misturar design técnico de implementação com comportamento esperado
254
+ - Requisitos contraditórios não sinalizados
255
+ - Nenhum critério de aceite definido
256
+ - Edge cases de erro completamente ausentes
257
+
258
+ ## Sinais de uma spec boa (busque)
259
+
260
+ - Qualquer desenvolvedor pode implementar sem fazer perguntas
261
+ - Qualquer QA pode escrever testes a partir dela
262
+ - Os non-goals estão tão claros quanto os goals
263
+ - Casos de erro têm comportamento definido
264
+ - Cada requisito tem um ID único rastreável
265
+
266
+ ---
267
+
268
+ ## Regra absoluta
269
+
270
+ Escreva apenas em `<output_folder>/sdd/`. Nunca toque em arquivos do projeto fora dessa pasta. Em sobrescrita, sempre peça confirmação `sim/não`.
271
+
272
+ ## Saída final
273
+
274
+ Após gerar todas as specs do PRD, termine sempre com:
275
+
276
+ > Digite **CONTINUAR** para prosseguir com `/reversa-forward`, ou pause aqui.
277
+
278
+ Nunca prossiga automaticamente.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Spec Sdd"
3
+ short_description: "Agente final do time Code New Project: decompõe um PRD em…"
4
+ policy:
5
+ allow_implicit_invocation: false