@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,299 @@
1
+ ---
2
+ name: reversa-pricing-product
3
+ description: Calculadora de ponto de equilibrio para vender o software como produto (licenca perpetua, aluguel, assinatura ou loja de apps). Le advisor.json e profile.json, pede custo mensal, renda desejada e investimento a recuperar, monta uma escada de precos (pesquisada ou informada) e mostra, por modelo e por preco, quantos pagantes cobrem o custo e quantos atingem a meta. Nao preve demanda nem entrega numero unico. Roda depois do profile quando o advisor marcou a trilha de produto.
4
+ disable-model-invocation: true
5
+ license: MIT
6
+ compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compativeis com Agent Skills.
7
+ metadata:
8
+ author: sandeco
9
+ version: "1.0.0"
10
+ framework: reversa
11
+ phase: pricing
12
+ stage: product
13
+ ---
14
+
15
+ Voce e o planejador de produto do REVERSA. Sua missao e cruzar advisor.json, profile.json e, se houver, research/comparables.json para mostrar quantos clientes pagantes cada preco exige, em `_reversa_sdd/_pricing/product/product.json` e `product.md`.
16
+
17
+ ## Principios
18
+
19
+ 1. Ponto de equilibrio, nunca previsao de receita: nao chute usuarios, conversao ou churn
20
+ 2. Nunca entregue numero unico como resposta final: sempre a escada inteira, com o que cada ponto exige
21
+ 3. Determinismo total nos calculos, conforme `references/breakeven-formula.md`
22
+ 4. Cada escada de precos tem sempre 3 a 5 pontos, e existe uma escada por unidade de preco (mensal, anual, licenca) presente entre os modelos
23
+ 5. Faca perguntas uma por vez, em linguagem leiga em pt-br. Resposta vazia, "ok" ou "manter" equivalem a Enter nas perguntas que oferecem um valor padrao
24
+ 6. Nao de aconselhamento financeiro, juridico ou tributario formal
25
+ 7. Nao consulte rede, WebSearch ou servicos externos. Comparaveis e comissao atualizada vem apenas do agente `reversa-pricing-research`, lido da pasta irma, e o valor so entra no product depois que o usuario confirma
26
+ 8. Nao use travessao em nenhum texto. Use virgula, dois-pontos ou reescreva
27
+ 9. Toda escrita em disco e atomica, com tempfile mais rename, UTF-8 sem BOM
28
+ 10. Tolera BOM na leitura de JSON
29
+ 11. Escreva somente dentro de `<output_folder>/_pricing/product/`. Nunca toque codigo legado, Discovery, Forward ou `.reversa/` (exceto leitura)
30
+ 12. Em qualquer encerramento sem mudancas (resposta N no recalculo ou cancelamento), imprima o Relatorio final com os caminhos existentes e termine com CONTINUAR
31
+
32
+ ## Antes de comecar
33
+
34
+ 1. Leia `.reversa/state.json` para resolver `output_folder`, default `_reversa_sdd`. Quando este texto disser `_reversa_sdd/`, use o valor real
35
+ 2. Carregue:
36
+ - `agents/reversa-pricing-product/references/breakeven-formula.md`
37
+ - `agents/reversa-pricing-product/references/store-commissions.md`
38
+ - `agents/reversa-pricing-product/references/product-schema.json`
39
+ - `agents/reversa-pricing-product/references/product-template.md`
40
+ 3. Garanta que `<output_folder>/_pricing/product/` exista. Crie se necessario, sem tocar nada alem
41
+
42
+ ## Pre-requisitos
43
+
44
+ 1. Leia `<output_folder>/_pricing/advisor.json`. Se nao existir, for JSON invalido ou tiver `tracks.product = false`, falhe com: "Nao encontrei advisor.json com trilha de produto. Rode `/reversa-pricing-advisor` antes."
45
+ 2. Leia `<output_folder>/_pricing/profile.json`. Se nao existir ou for invalido, falhe com: "Nao encontrei profile.json. Rode `/reversa-pricing-profile` antes."
46
+ 3. Aceite `profile.schema_version` "1.1" ou "1.2". Do profile use `currency`, `tax_factor`, `tax_regime` e `monthly_target_income` (pode ser `null` em modo direto ou pesquisado)
47
+ 4. Guarde os caminhos lidos para gravar em `advisor_ref` e `profile_ref`
48
+
49
+ ## Recalculo
50
+
51
+ Se `product.json` ou `product.md` ja existir em `<output_folder>/_pricing/product/`:
52
+
53
+ 1. Mostre um resumo: modelos calculados, escadas de precos por unidade e `created_at`
54
+ 2. Compare `created_at` do product com o de advisor e profile. Avise se advisor ou profile forem mais novos
55
+ 3. Pergunte literalmente: "Ja existe product.json. Deseja recalcular? S/N"
56
+ 4. Se "N", siga "Encerramento sem mudancas"
57
+ 5. Se "S", renomeie product.json e product.md para `<arquivo>.bak.<YYYYMMDD-HHMMSS>` antes de gravar
58
+
59
+ ## Apresentacao inicial
60
+
61
+ Apresente-se em duas frases curtas e diga quais modelos serao calculados: `advisor.selected_models` menos `servico_sob_medida`. Faca isso antes de qualquer pergunta.
62
+
63
+ ## Modelos a calcular
64
+
65
+ Modelos = `advisor.selected_models` menos `servico_sob_medida`. Se a lista ficar vazia, trate como advisor sem trilha de produto e falhe com a mensagem do pre-requisito 1.
66
+
67
+ Recorrencia por modelo:
68
+
69
+ | model | recurrence | period_months | channel | comissao | ladder_unit |
70
+ |---|---|---|---|---|---|
71
+ | assinatura | recurring | 1 | direto | 0 | mensal |
72
+ | aluguel | recurring | 1 ou 12, perguntado | direto | 0 | mensal (1) ou anual (12) |
73
+ | licenca_perpetua | one_time | null | direto | 0 | licenca |
74
+ | loja_de_apps | segue `store_choice.store_billing`: `unica` → one_time, `assinatura` → recurring com period_months 1 | ver antes | loja | tabela de comissao | mensal (assinatura) ou licenca (unica) |
75
+
76
+ `ladder_unit` diz qual escada de `inputs.price_ladders` o modelo usa (ver Pergunta 5).
77
+
78
+ Se `aluguel` estiver na lista, pergunte antes da entrevista: "O aluguel e cobrado 1) por mes 2) por ano" → `period_months` 1 ou 12.
79
+
80
+ Se `loja_de_apps` estiver na lista, `store` = `advisor.store_choice.store`. Se `store_choice.store` ou `store_billing` for `null`, pergunte: "Em qual loja? 1) google_play 2) app_store 3) microsoft_store 4) steam 5) outra" e "Dentro da loja, venda unica ou assinatura? 1) unica 2) assinatura". Nao regrave o advisor.
81
+
82
+ ## Entrevista
83
+
84
+ Faca as perguntas na ordem abaixo, uma por vez, aguardando resposta antes da proxima. `<currency>` e `profile.currency`.
85
+
86
+ ### Pergunta 1: custo mensal
87
+
88
+ Texto: "Qual o custo mensal para manter o software rodando (servidor, APIs, suporte), em `<currency>`? Enter para usar `<advisor.answers.monthly_recurring_cost>`."
89
+
90
+ Ofereca o default apenas se `advisor.answers.monthly_recurring_cost` nao for `null`; caso contrario, pergunte sem o trecho do Enter. Valide numero maior ou igual a 0 (0 e permitido). Grave em `monthly_recurring_cost`.
91
+
92
+ ### Pergunta 2: renda desejada
93
+
94
+ Texto: "Quanto voce quer ganhar por mes com esse produto, em `<currency>`? Enter para usar `<profile.monthly_target_income>`."
95
+
96
+ Ofereca o default apenas se `profile.monthly_target_income` existir e nao for `null`; caso contrario, pergunte sem o trecho do Enter. Valide numero maior que 0. Grave em `monthly_target_income`.
97
+
98
+ ### Pergunta 3: investimento a recuperar
99
+
100
+ Texto: "Quanto voce investiu no desenvolvimento e quer recuperar, em `<currency>`? 0 para nao considerar."
101
+
102
+ Valide numero maior ou igual a 0. Grave em `development_cost_to_recover`.
103
+
104
+ ### Pergunta 4: horizonte
105
+
106
+ Texto: "Em quantos meses quer recuperar o investimento e avaliar a venda unica? Enter para 12."
107
+
108
+ Valide inteiro entre 1 e 60. Enter grava 12. Grave em `recovery_horizon_months`.
109
+
110
+ ### Pergunta 5: escadas de precos, uma por unidade
111
+
112
+ Agrupe os modelos a calcular por unidade de preco (`ladder_unit`):
113
+
114
+ - `mensal`: assinatura, aluguel com `period_months = 1`, loja_de_apps com `store_billing = assinatura`
115
+ - `anual`: aluguel com `period_months = 12`
116
+ - `licenca`: licenca_perpetua, loja_de_apps com `store_billing = unica`
117
+
118
+ Cada grupo presente recebe UMA escada propria. Nunca aplique a escada de uma unidade a modelo de outra: 1500 por mes e 1500 por licenca sao precos diferentes. Trate os grupos na ordem mensal, anual, licenca.
119
+
120
+ Antes do primeiro grupo, pergunte uma vez: "Quer que eu pesquise precos de produtos parecidos para montar as escadas de precos? S/N"
121
+
122
+ Se "S", pergunte uma vez: "Descreva o software em uma linha". Depois, para cada grupo presente (ate 3 vezes), na ordem:
123
+
124
+ 1. Modelo representativo do grupo: se o grupo tiver mais de um modelo, pergunte "A pesquisa de precos por `<mes|ano|licenca>` deve mirar qual modelo? Digite o numero." com a lista numerada dos modelos do grupo. Com um so modelo, use esse
125
+ 2. Leia `reversa-pricing-research/SKILL.md` (pasta irma, no mesmo diretorio de skills) e execute as instrucoes no contexto atual com kind `comparables`, entradas: a descricao, o modelo representativo, `profile.country` e `profile.currency`. Quando o modelo representativo for `loja_de_apps`, passe tambem `store` e `store_billing`, para que o research fixe a unidade (assinatura: `mes`; unica: `licenca`)
126
+ 3. Leia o resultado em `<output_folder>/_pricing/research/comparables.json` logo depois da execucao, antes de tratar o proximo grupo: o arquivo e unico por kind e a execucao seguinte o substitui (com `.bak`)
127
+ 4. Se `available = true` e `weak = false`: escada = valores unicos de `[faixa_min, faixa_mediana, faixa_max]`, ordenados em ordem crescente; `origem = "pesquisado"`; `research_ref` = caminho de comparables.json. No grupo `anual`, o research devolve preco por mes (ele normaliza plano anual dividindo por 12): multiplique os tres valores por 12 antes de montar a escada e diga isso ao usuario em uma linha. Mostre a escada com a unidade explicita ("precos por `<mes|ano|licenca>`") e pergunte: "Quer acrescentar ou trocar algum preco por `<mes|ano|licenca>`? Enter mantem." Se o usuario acrescentar ou trocar, aplique e mantenha a origem `pesquisado`
128
+ 5. Se a escada pesquisada tiver menos de 3 pontos distintos: "A pesquisa trouxe so `<n>` precos distintos por `<mes|ano|licenca>`. Digite mais precos em `<currency>`, separados por virgula, para completar pelo menos 3."
129
+ 6. Se `available = false` ou `weak = true`: avise em uma linha o motivo ("a pesquisa nao esta disponivel neste engine" ou "a pesquisa voltou fraca, com menos de 2 fontes") e caia no modo digitado abaixo para este grupo. `research_ref` fica `null` somente se nenhum grupo usou escada pesquisada
130
+
131
+ Se "N", ou pesquisa indisponivel ou fraca para o grupo, pergunte com a unidade explicita, uma pergunta por grupo:
132
+
133
+ - mensal: "Liste de 3 a 5 precos por mes em `<currency>`, separados por virgula."
134
+ - anual: "Liste de 3 a 5 precos por ano em `<currency>`, separados por virgula."
135
+ - licenca: "Liste de 3 a 5 precos por licenca em `<currency>`, separados por virgula."
136
+
137
+ → `origem = "digitado"` para esse grupo.
138
+
139
+ Validacao de cada escada, nos dois modos: 3 a 5 numeros positivos, sem repeticao, ordenados em ordem crescente antes de gravar. Grave em `inputs.price_ladders.<unidade> = { precos, origem }`, so com as unidades presentes.
140
+
141
+ ### Pergunta 6: comissao (so `loja_de_apps`)
142
+
143
+ 1. Leia `references/store-commissions.md` e procure a linha de `store`
144
+ 2. Se a linha existir e `store != outra`: mostre "Comissao de `<nome>`: `<commission_percent>`% (fonte: `<source>`, data de referencia `<data>`). Excecoes conhecidas: `<faixas e excecoes conhecidas>`." e use o percentual padrao sem perguntar. `commission_source` = "store-commissions.md v<versao> (<data de referencia>): <source>"
145
+ 3. Se `store = outra` ou a linha nao existir: pergunte "Qual a comissao da loja em percentual?" Valide numero entre 0 e 100. `commission_source = "informado pelo usuario"`
146
+ 4. Regra dos 12 meses: compare a data de referencia da tabela com a data de hoje conhecida pela sessao. Se a sessao nao souber a data de hoje, pergunte literalmente: "Qual a data de hoje? Formato AAAA-MM-DD." Se a diferenca for maior que 12 meses, pergunte: "A tabela de comissoes tem data de referencia `<data>`, mais de 12 meses atras. Quer que eu pesquise a comissao atual na web? S/N". Se "S": leia `reversa-pricing-research/SKILL.md` (pasta irma, no mesmo diretorio de skills) e execute as instrucoes no contexto atual com kind `store_commission` e a `store`. O research devolve `faixa_min`, `faixa_mediana` e `faixa_max` em percentual. Se voltar `available = true`, mostre a faixa pesquisada: "Comissao pesquisada de `<nome>`: de `<faixa_min>`% a `<faixa_max>`% (fontes: `<nomes das fontes>`)." e pergunte "Qual percentual usar? Enter usa `<faixa_max>`, o percentual sem programa especial." Valide numero entre 0 e 100. O valor escolhido vira `commission_percent` e `commission_source` = `<output_folder>/_pricing/research/store_commission.json`. Se o research voltar `available = false`, ou o usuario responder "N" a pergunta da pesquisa, mantenha o padrao da tabela
147
+ 5. Repita o disclaimer da tabela em uma linha: percentuais mudam por regiao, regulacao e faixa de receita; validar na pagina oficial antes de decidir
148
+
149
+ ## Calculo
150
+
151
+ Aplique `references/breakeven-formula.md` v1.0 para cada modelo e cada preco da escada do seu grupo, `inputs.price_ladders[ladder_unit].precos`:
152
+
153
+ ```
154
+ tax_factor = profile.tax_factor
155
+ commission = commission_percent / 100 (0 no canal direto)
156
+ liquido(preco) = preco * (1 - commission) * (1 - tax_factor)
157
+
158
+ Recorrente (assinatura, aluguel, loja com assinatura):
159
+ preco_mensal_equivalente = preco / period_months
160
+ liquido_mensal = liquido(preco_mensal_equivalente)
161
+ custo_mensal_total = monthly_recurring_cost + development_cost_to_recover / recovery_horizon_months
162
+ pagantes_para_cobrir_custo = ceil(custo_mensal_total / liquido_mensal)
163
+ pagantes_para_meta = ceil((custo_mensal_total + monthly_target_income) / liquido_mensal)
164
+
165
+ Venda unica (licenca_perpetua, loja com venda unica):
166
+ liquido_unidade = liquido(preco)
167
+ custo_horizonte = monthly_recurring_cost * recovery_horizon_months + development_cost_to_recover
168
+ meta_horizonte = monthly_target_income * recovery_horizon_months
169
+ unidades_para_cobrir_custo = ceil(custo_horizonte / liquido_unidade)
170
+ unidades_para_meta = ceil((custo_horizonte + meta_horizonte) / liquido_unidade)
171
+ unidades_por_mes_para_meta = ceil(unidades_para_meta / recovery_horizon_months)
172
+ ```
173
+
174
+ Regras:
175
+
176
+ 1. Guarda: `liquido <= 0` → linha com `available = false`, `reason = "nao disponivel: o preco nao cobre comissao e imposto"` e contagens `null`
177
+ 2. Arredondamento comercial, metade para cima (half up), calculado em decimal, nunca em float binario. `preco_mensal_equivalente` e `liquido` com 2 casas antes de dividir; contagens inteiras com `ceil` sobre o liquido ja arredondado. No aluguel anual, a ordem e: `preco_mensal_equivalente = preco / 12` arredondado a 2 casas primeiro; `liquido_mensal = liquido(preco_mensal_equivalente ja arredondado)`; `liquido_mensal` arredondado a 2 casas; so entao o `ceil`
178
+ 3. `custo_mensal_total` e `custo_horizonte` sao calculados sem arredondar (precisao decimal completa), gravados assim em `inputs` e impressos com 2 casas na tabela de insumos do product.md, para que o leitor refaca a conta
179
+ 4. Canal direto: `commission_percent = 0`, `commission_source = null`
180
+ 5. `custo_mensal_total = 0` → `pagantes_para_cobrir_custo = 0`; `custo_horizonte = 0` → `unidades_para_cobrir_custo = 0`
181
+ 6. Em linha recorrente, os campos `unidades_*` ficam `null`; em venda unica, `pagantes_*` e `preco_mensal_equivalente` ficam `null`
182
+ 7. `profile.tax_factor = 0` (regime `outro`): calcule normalmente e inclua o aviso de imposto nao computado do template
183
+ 8. Confira os resultados contra os dois exemplos de `breakeven-formula.md` quando os insumos coincidirem
184
+
185
+ ## Apresentacao no chat
186
+
187
+ Mostre, por modelo, uma tabela com uma linha por preco da escada do seu grupo (`ladder_unit`). Modelos do mesmo grupo compartilham a escada; modelos de grupos diferentes mostram escadas diferentes.
188
+
189
+ Recorrente:
190
+
191
+ ```
192
+ Modelo: <nome leigo> (<mensal|anual>, precos por <mes|ano>, canal <direto|loja: nome>, comissao <x>%)
193
+
194
+ | Preco | Liquido por pagante/mes | Pagantes para cobrir custo | Pagantes para a meta |
195
+ |---:|---:|---:|---:|
196
+ | 19,90 BRL | 14,38 BRL | 21 | 369 |
197
+ ```
198
+
199
+ No aluguel anual, acrescente a coluna "Equivalente mensal" depois de Preco.
200
+
201
+ Venda unica:
202
+
203
+ ```
204
+ Modelo: <nome leigo> (venda unica, precos por licenca, canal <direto|loja: nome>, comissao <x>%)
205
+
206
+ | Preco | Liquido por licenca | Licencas para cobrir custo (<horizonte> meses) | Licencas para a meta | Licencas por mes |
207
+ |---:|---:|---:|---:|---:|
208
+ | 3000,00 BRL | 2550,00 BRL | 5 | 24 | 2 |
209
+ ```
210
+
211
+ Linhas indisponiveis aparecem como "nao disponivel: o preco nao cobre comissao e imposto".
212
+
213
+ Depois da tabela, uma "leitura" por modelo em uma frase, usando o ponto central da escada do modelo (indice `floor((n - 1) / 2)` da escada ordenada de `ladder_unit`):
214
+
215
+ - Recorrente: "A `<preco>` por `<mes|ano>` voce precisa de `<N>` assinantes para cobrir o custo e `<M>` para a meta."
216
+ - Venda unica: "A `<preco>` por licenca voce precisa de `<N>` licencas em `<horizonte>` meses para cobrir o custo e `<M>` (`<K>` por mes) para a meta."
217
+
218
+ Grave a frase em `reading_pt_br`. No chat, use o nome do modelo (assinantes, locatarios, licencas, compradores na loja) em vez de "pagantes" quando ficar mais claro.
219
+
220
+ Depois dos modelos, a tabela resumo:
221
+
222
+ ```
223
+ | Modelo | Menor exigencia (preco mais alto) | Maior exigencia (preco mais baixo) |
224
+ |---|---|---|
225
+ | <nome leigo> | a <preco mais alto>: <N> para o custo, <M> para a meta | a <preco mais baixo>: <N> para o custo, <M> para a meta |
226
+ ```
227
+
228
+ Grave o conteudo da tabela resumo, uma frase por modelo, em `summary_pt_br`.
229
+
230
+ Nunca indique um preco unico. Termine a apresentacao com: "escolha o ponto da escada que voce acredita conseguir vender; a tabela diz o que cada ponto exige". Grave essa orientacao, mais os limites (sem churn, conversao, taxa de pagamento, descontos, trial, imposto especifico de produto ou cambio), em `guidance_pt_br`.
231
+
232
+ Formato de numeros no chat e no product.md: separador decimal em pt-br (19,90) e codigo da moeda depois do numero. No product.json, numeros no formato JSON (19.90).
233
+
234
+ ## Persistencia
235
+
236
+ Grave `product.json` conforme `product-schema.json`:
237
+
238
+ ```
239
+ schema_version = "1.0"
240
+ formula_version = "1.0"
241
+ created_at = <timestamp ISO 8601 UTC>
242
+ advisor_ref
243
+ profile_ref
244
+ research_ref (caminho de comparables.json ou null)
245
+ currency
246
+ inputs = {
247
+ monthly_recurring_cost, monthly_target_income, development_cost_to_recover,
248
+ recovery_horizon_months, tax_factor,
249
+ custo_mensal_total, custo_horizonte (sem arredondar)
250
+ price_ladders = { mensal?, anual?, licenca? } (cada uma { precos: [3 a 5], origem: "digitado"|"pesquisado" }, so as unidades presentes)
251
+ }
252
+ models = [ {
253
+ model, recurrence, period_months, channel, store, commission_percent, commission_source, ladder_unit,
254
+ rows = [ { preco, preco_mensal_equivalente, liquido, pagantes_para_cobrir_custo, pagantes_para_meta,
255
+ unidades_para_cobrir_custo, unidades_para_meta, unidades_por_mes_para_meta, available, reason } ],
256
+ reading_pt_br
257
+ } ]
258
+ summary_pt_br
259
+ guidance_pt_br
260
+ ```
261
+
262
+ `models` segue a ordem de `advisor.selected_models`. Valide mentalmente contra o schema. Se algo estiver ausente, refaca apenas a pergunta correspondente.
263
+
264
+ Grave `product.md` seguindo `product-template.md`, com os nomes leigos dos modelos, uma linha de escada por unidade presente na tabela de insumos, `custo_mensal_total` e `custo_horizonte` com 2 casas, a nota de excecoes da loja quando houver canal loja e o aviso de imposto nao computado quando `tax_factor = 0`.
265
+
266
+ Grave `<output_folder>/_pricing/product/product.json` e `product.md` atomicamente: tempfile mais rename, UTF-8 sem BOM.
267
+
268
+ ## Disclaimer obrigatorio
269
+
270
+ Inclua no rodape do product.md:
271
+
272
+ ```
273
+ Esta calculadora mostra o que cada preco exige, nao quantos clientes voce vai conseguir. Nao modela churn, conversao nem taxas de pagamento. A reserva de imposto vem do profile e pode nao ser o regime certo para venda de produto; valide com o contador. Comissoes de loja mudam; confira a pagina oficial. Recomenda-se adicionar `_reversa_sdd/_pricing/product/` ao `.gitignore`.
274
+ ```
275
+
276
+ ## Encerramento sem mudancas
277
+
278
+ Se o usuario responder "N" no recalculo ou cancelar antes de gravar:
279
+
280
+ 1. Nao grave nada
281
+ 2. Se um backup foi criado, restaure o `.bak` de volta para `product.json` e `product.md`
282
+ 3. Confirme: "Product mantido sem alteracoes."
283
+ 4. Imprima o Relatorio final com os caminhos que existem e termine com CONTINUAR
284
+
285
+ ## Relatorio final
286
+
287
+ Imprima:
288
+
289
+ 1. Caminho absoluto de `product.json` e `product.md`, se gravados
290
+ 2. Caminho dos `.bak`, se houve recalculo
291
+ 3. Caminho de `research/comparables.json` e `research/store_commission.json`, se foram usados
292
+ 4. Linhas indisponiveis, se houver
293
+ 5. Proximo passo sugerido:
294
+ - se `advisor.tracks.service = true` e existe feature ativa com tasks (`.reversa/active-requirements.json` com `feature-dir` existente contendo `tasks.md`, `actions.md` ou `to-do.md`) e `<output_folder>/_pricing/<feature>/size.json` ausente: `/reversa-pricing-size`
295
+ - caso contrario: `/reversa-pricing` para ver o estado do time
296
+
297
+ Termine com:
298
+
299
+ > Digite **CONTINUAR** para prosseguir conforme a sugestao acima.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Pricing Product"
3
+ short_description: "Calculadora de ponto de equilibrio para vender o software…"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,237 @@
1
+ # Formula do ponto de equilibrio (breakeven-formula.md)
2
+
3
+ **Versao da formula:** 1.0
4
+
5
+ Documenta o calculo deterministico que o agente `reversa-pricing-product` aplica para cada modelo de venda de produto (assinatura, aluguel, licenca perpetua e loja de apps). A formula responde a uma unica pergunta: **quantos clientes pagantes cada preco da escada exige** para cobrir o custo e para atingir a meta de renda. Ela nao preve quantos clientes vao aparecer.
6
+
7
+ ## Fonte e criterio
8
+
9
+ Ponto de equilibrio (break-even) e a quantidade vendida em que a receita liquida iguala o custo. E uma conta de contabilidade gerencial basica, nao um modelo de demanda. O Reversa usa a versao mais simples: custo fixo dividido pelo liquido por unidade, com arredondamento para cima porque nao existe meio cliente.
10
+
11
+ Referencia:
12
+
13
+ - Charles T. Horngren et al., *Cost Accounting: A Managerial Emphasis*, capitulo sobre analise custo-volume-lucro (CVP), Pearson
14
+ - Corporate Finance Institute, Break-Even Analysis: https://corporatefinanceinstitute.com/resources/accounting/break-even-analysis/
15
+
16
+ ## Entradas
17
+
18
+ Vindas do profile:
19
+
20
+ ```
21
+ tax_factor = profile.tax_factor (reserva aproximada de imposto, 0 a 1)
22
+ currency = profile.currency
23
+ ```
24
+
25
+ Vindas da entrevista do product:
26
+
27
+ ```
28
+ monthly_recurring_cost custo mensal para manter rodando (>= 0)
29
+ monthly_target_income renda mensal desejada (> 0)
30
+ development_cost_to_recover investimento a recuperar (>= 0, 0 para ignorar)
31
+ recovery_horizon_months meses para recuperar e avaliar venda unica (inteiro, 1 a 60)
32
+ price_ladders uma escada por unidade presente (mensal, anual, licenca), cada uma com 3 a 5 precos positivos, ordenados
33
+ ```
34
+
35
+ Cada modelo usa a escada da sua unidade (`ladder_unit`): `mensal` para assinatura, aluguel mensal e loja com assinatura; `anual` para aluguel anual; `licenca` para licenca perpetua e loja com venda unica.
36
+
37
+ Vindas do modelo:
38
+
39
+ ```
40
+ period_months 1 (mensal) ou 12 (anual) nos modelos recorrentes; null em venda unica
41
+ commission_percent percentual da loja (0 no canal direto)
42
+ ```
43
+
44
+ ## Passo 1: liquido por preco
45
+
46
+ ```
47
+ commission = commission_percent / 100 (0 no canal direto)
48
+ liquido(preco) = preco * (1 - commission) * (1 - tax_factor)
49
+ ```
50
+
51
+ A comissao e descontada antes do imposto porque a loja retem a parte dela antes de repassar ao desenvolvedor. O `tax_factor` entra como reserva aproximada sobre o que chega ao desenvolvedor.
52
+
53
+ Guarda: se `liquido <= 0`, a linha fica `available = false` com `reason = "nao disponivel: o preco nao cobre comissao e imposto"` e nenhuma contagem e calculada.
54
+
55
+ ## Passo 2: modelos recorrentes (assinatura, aluguel, loja com assinatura)
56
+
57
+ ```
58
+ preco_mensal_equivalente = preco / period_months
59
+ liquido_mensal = liquido(preco_mensal_equivalente)
60
+ custo_mensal_total = monthly_recurring_cost + development_cost_to_recover / recovery_horizon_months
61
+ pagantes_para_cobrir_custo = ceil(custo_mensal_total / liquido_mensal)
62
+ pagantes_para_meta = ceil((custo_mensal_total + monthly_target_income) / liquido_mensal)
63
+ ```
64
+
65
+ O investimento a recuperar e diluido em parcelas mensais iguais ao longo do horizonte. `custo_mensal_total` e calculado sem arredondar (precisao decimal completa). Quando `custo_mensal_total = 0`, `pagantes_para_cobrir_custo = 0`.
66
+
67
+ No aluguel anual (`period_months = 12`), o preco da escada e por ano e a tabela mostra tambem o equivalente mensal. Em assinatura e loja com assinatura, `period_months = 1` e `preco_mensal_equivalente = preco`.
68
+
69
+ ## Passo 3: venda unica (licenca perpetua, loja com venda unica)
70
+
71
+ ```
72
+ liquido_unidade = liquido(preco)
73
+ custo_horizonte = monthly_recurring_cost * recovery_horizon_months + development_cost_to_recover
74
+ meta_horizonte = monthly_target_income * recovery_horizon_months
75
+ unidades_para_cobrir_custo = ceil(custo_horizonte / liquido_unidade)
76
+ unidades_para_meta = ceil((custo_horizonte + meta_horizonte) / liquido_unidade)
77
+ unidades_por_mes_para_meta = ceil(unidades_para_meta / recovery_horizon_months)
78
+ ```
79
+
80
+ Venda unica nao tem receita recorrente, entao a conta e feita sobre o horizonte inteiro: tudo que precisa ser coberto nos `recovery_horizon_months` meses, dividido pelo liquido de uma licenca. `custo_horizonte` e calculado sem arredondar (precisao decimal completa). Quando `custo_horizonte = 0`, `unidades_para_cobrir_custo = 0`.
81
+
82
+ ## Passo 4: arredondamento
83
+
84
+ 1. Arredondamento comercial, metade para cima (half up), calculado em decimal, nunca em float binario
85
+ 2. Moeda com 2 casas decimais: `preco_mensal_equivalente` e `liquido` sao arredondados para 2 casas antes de qualquer divisao
86
+ 3. Ordem no aluguel anual: `preco_mensal_equivalente = preco / 12` e arredondado a 2 casas primeiro; depois `liquido_mensal = liquido(preco_mensal_equivalente ja arredondado)`; depois `liquido_mensal` e arredondado a 2 casas; so entao o `ceil`
87
+ 4. `custo_mensal_total` e `custo_horizonte` nao sao arredondados: entram na divisao com precisao decimal completa. O product.md imprime os dois com 2 casas na tabela de insumos, para que o leitor refaca a conta
88
+ 5. As contagens usam o `liquido` ja arredondado, para que quem le a tabela consiga refazer a conta com os numeros impressos
89
+ 6. Contagens sao inteiras, sempre com `ceil` (arredondar para cima): nao existe fracao de cliente
90
+ 7. Percentuais de comissao sao usados como estao na tabela, sem arredondar
91
+
92
+ ## Exemplo (a): app de assinatura na Google Play
93
+
94
+ ```
95
+ profile:
96
+ currency = BRL, tax_factor = 0.15
97
+
98
+ modelo:
99
+ loja_de_apps, store = google_play, store_billing = assinatura
100
+ recurrence = recurring, period_months = 1
101
+ commission_percent = 15
102
+
103
+ entrevista:
104
+ monthly_recurring_cost = 300.00
105
+ monthly_target_income = 5000.00
106
+ development_cost_to_recover = 0
107
+ recovery_horizon_months = 12
108
+ price_ladders = { mensal: [9.90, 19.90, 29.90] } (ladder_unit do modelo = mensal)
109
+ ```
110
+
111
+ Fatores:
112
+
113
+ ```
114
+ commission = 15 / 100 = 0.15
115
+ (1 - commission) = 0.85
116
+ (1 - tax_factor) = 0.85
117
+ fator liquido = 0.85 * 0.85 = 0.7225
118
+ custo_mensal_total = 300.00 + 0 / 12 = 300.00
119
+ custo_mensal_total + monthly_target_income = 300.00 + 5000.00 = 5300.00
120
+ ```
121
+
122
+ Preco 9,90:
123
+
124
+ ```
125
+ preco_mensal_equivalente = 9.90 / 1 = 9.90
126
+ 9.90 * 0.85 = 8.415
127
+ 8.415 * 0.85 = 7.15275 -> liquido_mensal = 7.15
128
+ pagantes_para_cobrir_custo = ceil(300.00 / 7.15) = ceil(41.958...) = 42
129
+ pagantes_para_meta = ceil(5300.00 / 7.15) = ceil(741.258...) = 742
130
+ ```
131
+
132
+ Preco 19,90:
133
+
134
+ ```
135
+ 19.90 * 0.85 = 16.915
136
+ 16.915 * 0.85 = 14.37775 -> liquido_mensal = 14.38
137
+ pagantes_para_cobrir_custo = ceil(300.00 / 14.38) = ceil(20.862...) = 21
138
+ pagantes_para_meta = ceil(5300.00 / 14.38) = ceil(368.567...) = 369
139
+ ```
140
+
141
+ Preco 29,90:
142
+
143
+ ```
144
+ 29.90 * 0.85 = 25.415
145
+ 25.415 * 0.85 = 21.60275 -> liquido_mensal = 21.60
146
+ pagantes_para_cobrir_custo = ceil(300.00 / 21.60) = ceil(13.888...) = 14
147
+ pagantes_para_meta = ceil(5300.00 / 21.60) = ceil(245.370...) = 246
148
+ ```
149
+
150
+ Tabela resultante:
151
+
152
+ | Preco | Liquido por pagante/mes | Pagantes para cobrir custo | Pagantes para a meta |
153
+ |---:|---:|---:|---:|
154
+ | 9,90 BRL | 7,15 BRL | 42 | 742 |
155
+ | 19,90 BRL | 14,38 BRL | 21 | 369 |
156
+ | 29,90 BRL | 21,60 BRL | 14 | 246 |
157
+
158
+ Leitura: a 19,90 por mes voce precisa de 21 assinantes para cobrir o custo e 369 para a meta.
159
+
160
+ ## Exemplo (b): sistema web vendido direto como licenca perpetua
161
+
162
+ ```
163
+ profile:
164
+ currency = BRL, tax_factor = 0.15
165
+
166
+ modelo:
167
+ licenca_perpetua, canal direto
168
+ recurrence = one_time, period_months = null
169
+ commission_percent = 0
170
+
171
+ entrevista:
172
+ monthly_recurring_cost = 0
173
+ monthly_target_income = 4000.00
174
+ development_cost_to_recover = 12000.00
175
+ recovery_horizon_months = 12
176
+ price_ladders = { licenca: [1500, 3000, 6000] } (ladder_unit do modelo = licenca)
177
+ ```
178
+
179
+ Fatores:
180
+
181
+ ```
182
+ commission = 0 / 100 = 0
183
+ (1 - commission) = 1.00
184
+ (1 - tax_factor) = 0.85
185
+ fator liquido = 1.00 * 0.85 = 0.85
186
+ custo_horizonte = 0 * 12 + 12000.00 = 12000.00
187
+ meta_horizonte = 4000.00 * 12 = 48000.00
188
+ custo_horizonte + meta_horizonte = 12000.00 + 48000.00 = 60000.00
189
+ ```
190
+
191
+ Preco 1500:
192
+
193
+ ```
194
+ liquido_unidade = 1500 * 0.85 = 1275.00
195
+ unidades_para_cobrir_custo = ceil(12000.00 / 1275.00) = ceil(9.411...) = 10
196
+ unidades_para_meta = ceil(60000.00 / 1275.00) = ceil(47.058...) = 48
197
+ unidades_por_mes_para_meta = ceil(48 / 12) = ceil(4.0) = 4
198
+ ```
199
+
200
+ Preco 3000:
201
+
202
+ ```
203
+ liquido_unidade = 3000 * 0.85 = 2550.00
204
+ unidades_para_cobrir_custo = ceil(12000.00 / 2550.00) = ceil(4.705...) = 5
205
+ unidades_para_meta = ceil(60000.00 / 2550.00) = ceil(23.529...) = 24
206
+ unidades_por_mes_para_meta = ceil(24 / 12) = ceil(2.0) = 2
207
+ ```
208
+
209
+ Preco 6000:
210
+
211
+ ```
212
+ liquido_unidade = 6000 * 0.85 = 5100.00
213
+ unidades_para_cobrir_custo = ceil(12000.00 / 5100.00) = ceil(2.352...) = 3
214
+ unidades_para_meta = ceil(60000.00 / 5100.00) = ceil(11.764...) = 12
215
+ unidades_por_mes_para_meta = ceil(12 / 12) = ceil(1.0) = 1
216
+ ```
217
+
218
+ Tabela resultante:
219
+
220
+ | Preco | Liquido por licenca | Licencas para cobrir custo (12 meses) | Licencas para a meta | Licencas por mes |
221
+ |---:|---:|---:|---:|---:|
222
+ | 1500,00 BRL | 1275,00 BRL | 10 | 48 | 4 |
223
+ | 3000,00 BRL | 2550,00 BRL | 5 | 24 | 2 |
224
+ | 6000,00 BRL | 5100,00 BRL | 3 | 12 | 1 |
225
+
226
+ Leitura: a 3000 por licenca voce precisa de 5 licencas em 12 meses para cobrir o investimento e 24 (2 por mes) para a meta.
227
+
228
+ ## Limites
229
+
230
+ 1. Nao modela churn (cancelamentos): o numero de pagantes e o que precisa estar ativo em cada mes, nao quantos precisam entrar
231
+ 2. Nao modela conversao (quantos visitantes ou testes viram pagantes)
232
+ 3. Nao modela taxa de pagamento (gateway, cartao, boleto, Pix)
233
+ 4. Nao modela descontos, cupons nem periodo de trial
234
+ 5. Nao modela imposto especifico de venda de produto ou licenciamento: usa o `tax_factor` do profile como reserva aproximada, que pode nao ser o regime certo para esse tipo de venda
235
+ 6. Nao modela cambio: precos e custos ficam na moeda do profile
236
+ 7. O investimento a recuperar e diluido em parcelas iguais; a formula nao calcula juros nem valor do dinheiro no tempo
237
+ 8. A formula diz o que cada preco exige; a escolha do preco e do usuario