@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,153 @@
1
+ # Template do estimate.md
2
+
3
+ Este e o template Markdown que o agente `reversa-pricing-estimate` usa para gerar `_reversa_sdd/_pricing/<feature>/estimate.md`. Substitua todos os `<placeholders>` pelos valores reais. Mantenha a estrutura fixa.
4
+
5
+ ```markdown
6
+ # Estimativa de Preco
7
+
8
+ **Feature:** `<feature_dir_relativa>`
9
+ **Gerado em:** <created_at_local_legivel>
10
+ **Versao dos calculos:** Esforco v<effort_formula_version>, Valor v<value_formula_version>, Mercado v<market_table_version>
11
+
12
+ **Pre-requisitos consumidos:**
13
+ - Profile: `<output_folder>/_pricing/profile.json`
14
+ - Size: `<output_folder>/_pricing/<feature>/size.json` (classe `<complexity_class>`, score auxiliar `<size_score>`)
15
+
16
+ ## Visao geral
17
+
18
+ | Cenario | Faixa | Comentario |
19
+ |---|---|---|
20
+ | **Esforco** | <esforco_str> | <horas_min> a <horas_max>h, custo + imposto + markup |
21
+ | **Valor** | <valor_str> | 10% a 30% do valor anual declarado |
22
+ | **Faixa de Mercado** | <mercado_str> | taxa hora fonteada por pais e senioridade |
23
+
24
+ ## Cenario Esforco
25
+
26
+ **O que e:** preco calculado a partir de horas provaveis, taxa hora, reserva tributaria aproximada e markup de projeto. E o piso defensavel para nao subsidiar o cliente.
27
+
28
+ **Quando usar:** sempre como sanity check. Cobrar abaixo do Esforco significa assumir prejuizo ou reduzir demais o lucro do projeto.
29
+
30
+ | Item | Valor |
31
+ |---|---|
32
+ | Classe de complexidade | <complexity_class> |
33
+ | Senioridade | <seniority> |
34
+ | Fator de senioridade | <seniority_factor> |
35
+ | Horas estimadas | <horas_min> a <horas_max> h |
36
+ | Ponto medio | <horas_estimadas> h |
37
+ | Taxa hora | <hourly_rate> <currency>/h |
38
+ | Custo direto | <custo_direto_min> a <custo_direto_max> <currency> |
39
+ | Reserva tributaria aproximada | <imposto_aproximado_min> a <imposto_aproximado_max> <currency> |
40
+ | Markup de projeto (<margin_percent>%) | <markup_aplicado_min> a <markup_aplicado_max> <currency> |
41
+ | **Faixa Esforco** | **<preco_minimo> a <preco_maximo> <currency>** |
42
+ | Ponto medio | <preco_total> <currency> |
43
+
44
+ <aviso_vat_se_aplicavel>
45
+ <bloco_billing_currency_se_aplicavel>
46
+
47
+ ## Cenario Valor
48
+
49
+ **O que e:** preco baseado em parte do valor economico anual que a feature gera ou protege para o cliente. O Reversa usa captura de 10% a 30% do valor anual declarado.
50
+
51
+ **Quando usar:** quando o cliente consegue declarar retorno, economia ou custo de nao fazer.
52
+
53
+ <se valor.available>
54
+
55
+ | Item | Valor |
56
+ |---|---|
57
+ | Retorno mensal declarado | <monthly_return_declared> <currency> |
58
+ | Usuarios impactados | <users_impacted> |
59
+ | Custo de nao fazer | <cost_of_not_doing> <currency> |
60
+ | Valor anual usado | <annual_value> <currency> |
61
+ | Captura aplicada | 10% a 30% |
62
+ | Preco recomendado | <preco_recomendado> <currency> |
63
+ | **Faixa Valor** | **<preco_minimo> a <preco_maximo> <currency>** |
64
+ | Payback aproximado | <payback_str> |
65
+
66
+ <bloco_billing_currency_se_aplicavel>
67
+
68
+ <se NOT valor.available>
69
+
70
+ > **Cenario Valor nao disponivel:** <razao_unavailable>
71
+
72
+ </se>
73
+
74
+ ## Cenario Faixa de Mercado
75
+
76
+ **O que e:** faixa derivada de benchmark horario por pais e senioridade, multiplicado pela mesma faixa de horas do cenario Esforco.
77
+
78
+ **Quando usar:** como referencia externa. A v2 nao multiplica por perfil de cliente porque nao ha dataset publico confiavel para isso.
79
+
80
+ <se mercado.available>
81
+
82
+ | Item | Valor |
83
+ |---|---|
84
+ | Pais / Senioridade | <country_nome> / <seniority> |
85
+ | Modelo / Perfil cliente | <pricing_model> / <client_profile> |
86
+ | Complexidade | <complexity_class> |
87
+ | Taxa hora de mercado | <market_hourly_min> a <market_hourly_max> <currency>/h |
88
+ | Tipo de fonte | <source_kind> |
89
+ | Ano de referencia | <source_year> |
90
+ | Fontes | <sources> |
91
+ | **Faixa Mercado** | **<preco_minimo_mercado> a <preco_maximo_mercado> <currency>** |
92
+
93
+ <se fallback aplicado>
94
+
95
+ > Fallback aplicado: <razao>
96
+
97
+ </se>
98
+
99
+ <bloco_billing_currency_se_aplicavel>
100
+
101
+ <se NOT mercado.available>
102
+
103
+ > **Cenario Mercado nao disponivel:** <razao_unavailable>
104
+
105
+ </se>
106
+
107
+ ## Confianca dos insumos
108
+
109
+ <secao gerada somente com profile.schema_version == "1.2"; com profile 1.1, omitir a secao inteira>
110
+
111
+ <se houver origem diferente de digitado, uma linha por campo, neste formato literal>
112
+
113
+ - `<campo>`: `<origem>` (`<source ou "nao informado">`, `<researched_at ou "nao informado">`)
114
+
115
+ Valores pesquisados ou padrao reduzem a confianca desta estimativa. Revise taxa hora, markup e regime antes de enviar proposta.
116
+
117
+ <se todos os campos forem digitados>
118
+
119
+ Todos os insumos do profile foram informados por voce.
120
+
121
+ </se>
122
+
123
+ ## Como escolher entre os tres
124
+
125
+ <orientacao_pt_br_baseada_nos_cenarios>
126
+
127
+ Heuristica geral:
128
+
129
+ 1. Cliente sem retorno claro: use Esforco como piso e Mercado como referencia externa
130
+ 2. Cliente com retorno alto e claro: prefira Valor, com Esforco apenas como piso minimo
131
+ 3. Esforco acima do Mercado: revise profile, size ou adequacao do cliente
132
+ 4. Mercado acima do Esforco: ha espaco para subir markup ou melhorar proposta
133
+
134
+ ## Disclaimer
135
+
136
+ Os numeros nesta estimativa sao aproximacoes para orientacao de orcamento, nao garantia de fechamento de venda. O fator de imposto e uma reserva aproximada, nao uma aliquota legal exata. Validacao tributaria real e responsabilidade do contador do usuario. A faixa de mercado e estatica e baseada nas fontes documentadas em `market-benchmarks.md`. O retorno declarado pelo cliente no cenario Valor e input bruto, nao validado. Recomenda-se adicionar `_reversa_sdd/_pricing/<feature>/estimate.{md,json}` ao `.gitignore` antes de commitar.
137
+ ```
138
+
139
+ ## Billing currency
140
+
141
+ Quando `profile.billing_currency` esta preenchido, cada cenario ganha linha extra:
142
+
143
+ ```markdown
144
+ | Em <billing_currency> | <valor_billing> <billing_currency> (cambio: 1 <billing_currency> = <exchange_rate_to_local> <currency>) |
145
+ ```
146
+
147
+ ## Comentarios curtos
148
+
149
+ | Cenario | Comentario curto |
150
+ |---|---|
151
+ | Esforco | `<horas_min> a <horas_max>h, custo + imposto + markup` |
152
+ | Valor | `10% a 30% do valor anual declarado` ou `Nao disponivel` |
153
+ | Mercado | `taxa hora fonteada por pais e senioridade` ou `Nao disponivel` |
@@ -0,0 +1,74 @@
1
+ {
2
+ "schema_version": "1.1",
3
+ "formula_versions": {
4
+ "effort": "2.0",
5
+ "value": "2.0",
6
+ "market": "2.0"
7
+ },
8
+ "created_at": "2026-05-06T16:42:00Z",
9
+ "feature_dir": "_reversa_sdd/forward/042-pagamento-pix",
10
+ "profile_ref": "_reversa_sdd/_pricing/profile.json",
11
+ "size_ref": "_reversa_sdd/_pricing/042-pagamento-pix/size.json",
12
+ "currency": "BRL",
13
+ "billing_currency": null,
14
+ "exchange_rate_to_local": null,
15
+ "scenarios": {
16
+ "effort": {
17
+ "available": true,
18
+ "horas_min": 32,
19
+ "horas_max": 80,
20
+ "horas_estimadas": 56,
21
+ "seniority_factor": 1.0,
22
+ "custo_direto_min": 3200.0,
23
+ "custo_direto_max": 8000.0,
24
+ "custo_direto": 5600.0,
25
+ "imposto_aproximado_min": 480.0,
26
+ "imposto_aproximado_max": 1200.0,
27
+ "imposto_aproximado": 840.0,
28
+ "markup_aplicado_min": 1120.0,
29
+ "markup_aplicado_max": 2800.0,
30
+ "markup_aplicado": 1960.0,
31
+ "preco_minimo": 4800.0,
32
+ "preco_maximo": 12000.0,
33
+ "preco_total": 8400.0,
34
+ "explanation_pt_br": "Faixa baseada em 32 a 80h para complexidade L, senioridade senior, custo direto, reserva tributaria de 15% e markup de projeto de 35%."
35
+ },
36
+ "value": {
37
+ "available": true,
38
+ "monthly_return_declared": 2000.0,
39
+ "users_impacted": 500,
40
+ "cost_of_not_doing": 5000.0,
41
+ "annual_value": 24000.0,
42
+ "value_capture_min": 0.1,
43
+ "value_capture_recommended": 0.2,
44
+ "value_capture_max": 0.3,
45
+ "preco_minimo": 2400.0,
46
+ "preco_recomendado": 4800.0,
47
+ "preco_maximo": 7200.0,
48
+ "payback_months_min": 1.2,
49
+ "payback_months_max": 3.6,
50
+ "explanation_pt_br": "Faixa baseada em captura de 10% a 30% do valor anual declarado, com payback aproximado de 1.2 a 3.6 meses."
51
+ },
52
+ "market": {
53
+ "available": true,
54
+ "country": "BR",
55
+ "seniority": "senior",
56
+ "primary_pricing_model": "escopo_fechado",
57
+ "primary_client_profile": "pequena_empresa",
58
+ "complexity_class": "L",
59
+ "market_hourly_min": 100.0,
60
+ "market_hourly_max": 200.0,
61
+ "source_kind": "salary_derived_freelance_estimate",
62
+ "source_year": "2025-2026",
63
+ "sources": [
64
+ "Portal Salario CAGED",
65
+ "Glassdoor Brasil"
66
+ ],
67
+ "preco_minimo": 3200.0,
68
+ "preco_maximo": 16000.0,
69
+ "fallback_applied": false,
70
+ "explanation_pt_br": "Faixa derivada de benchmark horario BR senior e 32 a 80h para complexidade L."
71
+ }
72
+ },
73
+ "guidance_pt_br": "O Valor declarado gera uma faixa menor que o Esforco medio. Use Esforco como piso defensavel e Mercado como referencia externa. Para este cliente, cobre abaixo de 4800 BRL apenas se houver motivo estrategico claro."
74
+ }
@@ -0,0 +1,88 @@
1
+ # Estimativa de Preco
2
+
3
+ **Feature:** `_reversa_sdd/forward/042-pagamento-pix`
4
+ **Gerado em:** 2026-05-06 16:42 UTC
5
+ **Versao dos calculos:** Esforco v2.0, Valor v2.0, Mercado v2.0
6
+
7
+ **Pre-requisitos consumidos:**
8
+ - Profile: `_reversa_sdd/_pricing/profile.json`
9
+ - Size: `_reversa_sdd/_pricing/042-pagamento-pix/size.json` (classe `L`, score auxiliar `60`)
10
+
11
+ ## Visao geral
12
+
13
+ | Cenario | Faixa | Comentario |
14
+ |---|---|---|
15
+ | **Esforco** | 4.800,00 a 12.000,00 BRL | 32 a 80h, custo + imposto + markup |
16
+ | **Valor** | 2.400,00 a 7.200,00 BRL | 10% a 30% do valor anual declarado |
17
+ | **Faixa de Mercado** | 3.200,00 a 16.000,00 BRL | taxa hora fonteada por pais e senioridade |
18
+
19
+ ## Cenario Esforco
20
+
21
+ **O que e:** preco calculado a partir de horas provaveis, taxa hora, reserva tributaria aproximada e markup de projeto. E o piso defensavel para nao subsidiar o cliente.
22
+
23
+ **Quando usar:** sempre como sanity check. Cobrar abaixo do Esforco significa assumir prejuizo ou reduzir demais o lucro do projeto.
24
+
25
+ | Item | Valor |
26
+ |---|---|
27
+ | Classe de complexidade | L |
28
+ | Senioridade | senior |
29
+ | Fator de senioridade | 1,00 |
30
+ | Horas estimadas | 32 a 80 h |
31
+ | Ponto medio | 56 h |
32
+ | Taxa hora | 100,00 BRL/h |
33
+ | Custo direto | 3.200,00 a 8.000,00 BRL |
34
+ | Reserva tributaria aproximada | 480,00 a 1.200,00 BRL |
35
+ | Markup de projeto (35%) | 1.120,00 a 2.800,00 BRL |
36
+ | **Faixa Esforco** | **4.800,00 a 12.000,00 BRL** |
37
+ | Ponto medio | 8.400,00 BRL |
38
+
39
+ Aviso: parte do fator tributario pode ser imposto destacado e repassado ao cliente. Valide com contador.
40
+
41
+ ## Cenario Valor
42
+
43
+ **O que e:** preco baseado em parte do valor economico anual que a feature gera ou protege para o cliente. O Reversa usa captura de 10% a 30% do valor anual declarado.
44
+
45
+ **Quando usar:** quando o cliente consegue declarar retorno, economia ou custo de nao fazer.
46
+
47
+ | Item | Valor |
48
+ |---|---|
49
+ | Retorno mensal declarado | 2.000,00 BRL |
50
+ | Usuarios impactados | 500 |
51
+ | Custo de nao fazer | 5.000,00 BRL |
52
+ | Valor anual usado | 24.000,00 BRL |
53
+ | Captura aplicada | 10% a 30% |
54
+ | Preco recomendado | 4.800,00 BRL |
55
+ | **Faixa Valor** | **2.400,00 a 7.200,00 BRL** |
56
+ | Payback aproximado | 1,2 a 3,6 meses |
57
+
58
+ ## Cenario Faixa de Mercado
59
+
60
+ **O que e:** faixa derivada de benchmark horario por pais e senioridade, multiplicado pela mesma faixa de horas do cenario Esforco.
61
+
62
+ **Quando usar:** como referencia externa. A v2 nao multiplica por perfil de cliente porque nao ha dataset publico confiavel para isso.
63
+
64
+ | Item | Valor |
65
+ |---|---|
66
+ | Pais / Senioridade | Brasil / senior |
67
+ | Modelo / Perfil cliente | escopo_fechado / pequena_empresa |
68
+ | Complexidade | L |
69
+ | Taxa hora de mercado | 100,00 a 200,00 BRL/h |
70
+ | Tipo de fonte | salary_derived_freelance_estimate |
71
+ | Ano de referencia | 2025-2026 |
72
+ | Fontes | Portal Salario CAGED, Glassdoor Brasil |
73
+ | **Faixa Mercado** | **3.200,00 a 16.000,00 BRL** |
74
+
75
+ ## Como escolher entre os tres
76
+
77
+ O Valor declarado gera uma faixa menor que o Esforco medio. Use Esforco como piso defensavel e Mercado como referencia externa. Para este cliente, cobre abaixo de 4.800 BRL apenas se houver motivo estrategico claro.
78
+
79
+ Heuristica geral:
80
+
81
+ 1. Cliente sem retorno claro: use Esforco como piso e Mercado como referencia externa
82
+ 2. Cliente com retorno alto e claro: prefira Valor, com Esforco apenas como piso minimo
83
+ 3. Esforco acima do Mercado: revise profile, size ou adequacao do cliente
84
+ 4. Mercado acima do Esforco: ha espaco para subir markup ou melhorar proposta
85
+
86
+ ## Disclaimer
87
+
88
+ Os numeros nesta estimativa sao aproximacoes para orientacao de orcamento, nao garantia de fechamento de venda. O fator de imposto e uma reserva aproximada, nao uma aliquota legal exata. Validacao tributaria real e responsabilidade do contador do usuario. A faixa de mercado e estatica e baseada nas fontes documentadas em `market-benchmarks.md`. O retorno declarado pelo cliente no cenario Valor e input bruto, nao validado. Recomenda-se adicionar `_reversa_sdd/_pricing/<feature>/estimate.{md,json}` ao `.gitignore` antes de commitar.
@@ -0,0 +1,102 @@
1
+ # Benchmarks de mercado (market-benchmarks.md)
2
+
3
+ **Versao da tabela:** 2.0
4
+ **Data de referencia dos benchmarks:** 2026-05
5
+
6
+ Documenta as referencias estaticas que o agente `reversa-pricing-estimate` usa para o cenario Faixa de Mercado. A v2 remove faixas totais inventadas por combinacao e passa a usar benchmark horario por pais e senioridade, derivando o total pela faixa de horas do `effort-formula.md`.
7
+
8
+ ## Disclaimer obrigatorio
9
+
10
+ Os numeros sao aproximacoes didaticas baseadas em fontes publicas e comerciais conhecidas em maio de 2026. Nao substituem pesquisa regional atualizada. Muitas fontes publicas trazem salario mensal ou anual, nao taxa freelance direta. Quando a linha deriva uma taxa freelance a partir de salario, o campo `source_kind` deve dizer isso explicitamente.
11
+
12
+ ## Como calcular o cenario Mercado
13
+
14
+ Cada linha tem:
15
+
16
+ ```
17
+ country | seniority | currency | min_hourly | max_hourly | source_kind | source_year | sources
18
+ ```
19
+
20
+ O total por feature e derivado assim:
21
+
22
+ ```
23
+ market_min = horas_min[complexity_class][seniority] * min_hourly
24
+ market_max = horas_max[complexity_class][seniority] * max_hourly
25
+ ```
26
+
27
+ `pricing_model` muda apenas a apresentacao:
28
+
29
+ - `time_and_materials`: mostrar taxa hora e total estimado por horas
30
+ - `escopo_fechado`, `sprint`, `valor_fixo_por_entrega`: mostrar total por feature derivado por horas
31
+ - `retainer`: mostrar "faixa equivalente por feature dentro de retainer"
32
+
33
+ `client_profile` nao altera o numero na v2. Sem dataset por perfil, multiplicadores por cliente seriam invencao. O estimate.md pode adicionar alerta qualitativo para microempresa, pequena empresa ou enterprise.
34
+
35
+ ## Tabela v2
36
+
37
+ | country | seniority | currency | min_hourly | max_hourly | source_kind | source_year | sources |
38
+ |---|---|---:|---:|---:|---|---:|---|
39
+ | BR | junior | BRL | 40 | 80 | salary_derived_freelance_estimate | 2025-2026 | Portal Salario CAGED, Glassdoor Brasil |
40
+ | BR | mid | BRL | 70 | 130 | salary_derived_freelance_estimate | 2025-2026 | Portal Salario CAGED, Glassdoor Brasil |
41
+ | BR | senior | BRL | 100 | 200 | salary_derived_freelance_estimate | 2025-2026 | Portal Salario CAGED, Glassdoor Brasil |
42
+ | BR | staff_lead | BRL | 160 | 300 | salary_derived_freelance_estimate | 2025-2026 | Portal Salario CAGED, Glassdoor Brasil |
43
+ | BR | principal | BRL | 220 | 420 | salary_derived_freelance_estimate | 2025-2026 | Portal Salario CAGED, Glassdoor Brasil |
44
+ | US | junior | USD | 20 | 40 | freelance_platform_and_public_wage | 2024-2025 | Upwork, O*NET/BLS |
45
+ | US | mid | USD | 40 | 70 | freelance_platform_and_public_wage | 2024-2025 | Upwork, O*NET/BLS |
46
+ | US | senior | USD | 70 | 150 | freelance_platform_and_public_wage | 2024-2025 | Upwork, O*NET/BLS |
47
+ | US | staff_lead | USD | 120 | 200 | freelance_platform_and_public_wage | 2024-2025 | Upwork, O*NET/BLS |
48
+ | US | principal | USD | 160 | 260 | freelance_platform_and_public_wage | 2024-2025 | Upwork, O*NET/BLS |
49
+ | PT | junior | EUR | 25 | 45 | salary_derived_contractor_estimate | 2024-2026 | Landing.Jobs, Hays Portugal |
50
+ | PT | mid | EUR | 40 | 70 | salary_derived_contractor_estimate | 2024-2026 | Landing.Jobs, Hays Portugal |
51
+ | PT | senior | EUR | 60 | 100 | salary_derived_contractor_estimate | 2024-2026 | Landing.Jobs, Hays Portugal |
52
+ | PT | staff_lead | EUR | 90 | 140 | salary_derived_contractor_estimate | 2024-2026 | Landing.Jobs, Hays Portugal |
53
+ | PT | principal | EUR | 120 | 180 | salary_derived_contractor_estimate | 2024-2026 | Landing.Jobs, Hays Portugal |
54
+ | MX | junior | MXN | 200 | 400 | salary_derived_freelance_estimate | 2025 | Glassdoor Mexico, Computrabajo Mexico |
55
+ | MX | mid | MXN | 350 | 650 | salary_derived_freelance_estimate | 2025 | Glassdoor Mexico, Computrabajo Mexico |
56
+ | MX | senior | MXN | 600 | 1000 | salary_derived_freelance_estimate | 2025 | Glassdoor Mexico, Computrabajo Mexico |
57
+ | MX | staff_lead | MXN | 900 | 1500 | salary_derived_freelance_estimate | 2025 | Glassdoor Mexico, Computrabajo Mexico |
58
+ | MX | principal | MXN | 1200 | 2000 | salary_derived_freelance_estimate | 2025 | Glassdoor Mexico, Computrabajo Mexico |
59
+
60
+ ## Aliases de senioridade
61
+
62
+ ```
63
+ pleno -> mid
64
+ especialista -> staff_lead
65
+ staff -> staff_lead
66
+ lead -> staff_lead
67
+ ```
68
+
69
+ ## Fontes
70
+
71
+ - Portal Salario, Programador de Sistemas de Informacao, CBO 317110, dados CAGED/eSocial/Empregador Web, atualizado em 2026: https://www.salario.com.br/profissao/programador-de-sistemas-de-informacao-cbo-317110/
72
+ - Glassdoor Brasil, Software Developer, faixa mensal, atualizado em 2025: https://www.glassdoor.com/Salaries/br%C3%A9sil-software-developer-salary-SRCH_IL.0%2C6_IN36_KO7%2C25.htm
73
+ - O*NET Online, Software Developers 15-1252.00, salarios locais com fonte BLS 2024: https://www.onetonline.org/link/localwages/15-1252.00
74
+ - Upwork, Software Developer hourly cost guide, faixas entry, intermediate e expert: https://www.upwork.com/hire/software-developers/cost/
75
+ - Landing.Jobs Global Tech Talent Trends 2024: https://campaign.landing.jobs/gttt-2024
76
+ - Hays Portugal Salary Guide 2026: https://www.hays.pt/en/salary-guide/overview
77
+ - Glassdoor Mexico, Software Developer, faixa mensal, atualizado em 2025: https://www.glassdoor.com/Salaries/mexico-software-developer-salary-SRCH_IL.0%2C6_IN169_KO7%2C25.htm
78
+ - Computrabajo Mexico, salarios de Developer e Desarrollador IT, atualizado em 2025: https://mx.computrabajo.com/salarios/desarrollador-it
79
+
80
+ ## Regras de fallback
81
+
82
+ 1. Se `country` nao estiver na tabela, Mercado fica `unavailable: true`
83
+ 2. Se `seniority` vier em alias, normalize e calcule
84
+ 3. Se `pricing_model` nao estiver entre os modelos conhecidos, use apresentacao de `escopo_fechado` e registre fallback
85
+ 4. `client_profile` nao altera preco na v2
86
+ 5. `complexity_class` sempre deve existir no size; se ausente, falhe com mensagem pedindo recalculo do Sizer
87
+
88
+ ## Paises nao cobertos na v2
89
+
90
+ Para `country` fora de `[BR, US, PT, MX]`, o cenario Mercado fica indisponivel com explicacao:
91
+
92
+ "Faixa de mercado para `<country>` ainda nao esta documentada nesta versao do Reversa. Cobertos na v2: BR, US, PT, MX."
93
+
94
+ ## Como estender
95
+
96
+ Para adicionar pais:
97
+
98
+ 1. Prefira fonte publica de taxa freelance direta
99
+ 2. Se usar salario, registre `source_kind = salary_derived_freelance_estimate`
100
+ 3. Cite fonte e ano por linha
101
+ 4. Nao adicione multiplicadores por `client_profile` sem dataset
102
+ 5. Bump em `market` formula_version
@@ -0,0 +1,123 @@
1
+ # Formula do cenario Valor (value-formula.md)
2
+
3
+ **Versao da formula:** 2.0
4
+
5
+ Documenta o calculo deterministico que o agente `reversa-pricing-estimate` aplica para o cenario Valor. A formula v2 substitui o multiplo fixo de 6 a 12 meses por captura percentual do valor economico anual declarado.
6
+
7
+ ## Fonte e criterio
8
+
9
+ Value-based pricing usa o valor percebido ou economico para o cliente como base de preco, nao apenas custo interno ou preco de concorrentes.
10
+
11
+ Referencias:
12
+
13
+ - Hinterhuber, A. (2008), *Customer value-based pricing strategies: why companies resist*, Journal of Business Strategy, 29(4), DOI 10.1108/02756660810887079
14
+ - Nagle, Hogan e Zale, *The Strategy and Tactics of Pricing*, 5a ed., Routledge, 2016, especialmente Economic Value to the Customer
15
+
16
+ A faixa de 10% a 30% e uma heuristica comercial do Reversa para B2B/freelance/agencia. Ela deve ser descrita como captura de parte do valor anual, nao como lei academica universal.
17
+
18
+ ## Passo 1: validacao de input
19
+
20
+ ```
21
+ if monthly_return_declared == 0 AND cost_of_not_doing == 0:
22
+ available = false
23
+ explanation_pt_br = "Cenario Valor nao pode ser calculado: cliente nao declarou retorno mensuravel."
24
+ ```
25
+
26
+ `users_impacted` e contexto comercial. Ele aparece no estimate.md, mas nao entra no calculo numerico v2.
27
+
28
+ ## Passo 2: valor economico anual
29
+
30
+ ```
31
+ annual_value =
32
+ max(monthly_return_declared * 12, cost_of_not_doing)
33
+ ```
34
+
35
+ O cliente pode declarar:
36
+
37
+ - retorno mensal recorrente
38
+ - custo anual de nao fazer
39
+ - ambos
40
+
41
+ Quando ambos existem, a formula usa o maior valor economico defensavel.
42
+
43
+ ## Passo 3: captura de valor
44
+
45
+ ```
46
+ value_capture_min = 0.10
47
+ value_capture_recommended = 0.20
48
+ value_capture_max = 0.30
49
+
50
+ preco_minimo = round_currency(annual_value * value_capture_min)
51
+ preco_recomendado = round_currency(annual_value * value_capture_recommended)
52
+ preco_maximo = round_currency(annual_value * value_capture_max)
53
+ ```
54
+
55
+ ## Passo 4: payback explicativo
56
+
57
+ Se `monthly_return_declared > 0`, calcule payback como explicacao secundaria:
58
+
59
+ ```
60
+ payback_months_min = preco_minimo / monthly_return_declared
61
+ payback_months_max = preco_maximo / monthly_return_declared
62
+ ```
63
+
64
+ Se `monthly_return_declared == 0`, grave `payback_months_min = null` e `payback_months_max = null`.
65
+
66
+ Payback nao define preco. Ele apenas ajuda o usuario a explicar a proposta.
67
+
68
+ ## Exemplos
69
+
70
+ ### Exemplo 1: retorno mensal claro
71
+
72
+ ```
73
+ monthly_return_declared = 2000 BRL
74
+ cost_of_not_doing = 5000 BRL
75
+
76
+ annual_value = max(2000 * 12, 5000) = 24000
77
+ preco_minimo = 24000 * 0.10 = 2400
78
+ preco_recomendado = 24000 * 0.20 = 4800
79
+ preco_maximo = 24000 * 0.30 = 7200
80
+ payback_months_min = 1.2
81
+ payback_months_max = 3.6
82
+ ```
83
+
84
+ ### Exemplo 2: prevencao de perda anual
85
+
86
+ ```
87
+ monthly_return_declared = 0
88
+ cost_of_not_doing = 60000 BRL
89
+
90
+ annual_value = max(0, 60000) = 60000
91
+ preco_minimo = 6000
92
+ preco_recomendado = 12000
93
+ preco_maximo = 18000
94
+ payback_months_min = null
95
+ payback_months_max = null
96
+ ```
97
+
98
+ ### Exemplo 3: sem dado mensuravel
99
+
100
+ ```
101
+ monthly_return_declared = 0
102
+ cost_of_not_doing = 0
103
+
104
+ available = false
105
+ ```
106
+
107
+ ## Conversao para moeda de cobranca
108
+
109
+ Identica ao Esforco. Quando `profile.billing_currency` esta preenchido:
110
+
111
+ ```
112
+ preco_minimo_billing = round_currency(preco_minimo / exchange_rate_to_local)
113
+ preco_recomendado_billing = round_currency(preco_recomendado / exchange_rate_to_local)
114
+ preco_maximo_billing = round_currency(preco_maximo / exchange_rate_to_local)
115
+ ```
116
+
117
+ ## Limites e premissas
118
+
119
+ 1. O retorno declarado pelo cliente nao e validado pelo agente
120
+ 2. A faixa de captura 10% a 30% e heuristica documentada
121
+ 3. `users_impacted` nao entra no calculo numerico v2
122
+ 4. Valores extremos nao sao truncados
123
+ 5. A explicacao pode mencionar meses de payback, mas nao deve dizer que o preco e "6 a 12 meses"