@flaviogarrido/reversa 0.0.0-stage → 1.3.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (421) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +487 -2
  3. package/agents/fg-backlog/SKILL.md +129 -0
  4. package/agents/fg-backlog/agents/openai.yaml +5 -0
  5. package/agents/fg-backlog/references/backlog-template.md +60 -0
  6. package/agents/fg-backlog/references/priorizacao.md +41 -0
  7. package/agents/impeccable/LICENSE +191 -0
  8. package/agents/impeccable/NOTICE.md +11 -0
  9. package/agents/impeccable/SKILL.md +88 -0
  10. package/agents/impeccable/agents/impeccable_asset_producer.toml +47 -0
  11. package/agents/impeccable/agents/impeccable_documenter.toml +27 -0
  12. package/agents/impeccable/agents/impeccable_finish_reviewer.toml +41 -0
  13. package/agents/impeccable/agents/impeccable_manual_edit_applier.toml +95 -0
  14. package/agents/impeccable/agents/openai.yaml +4 -0
  15. package/agents/impeccable/reference/adapt.md +318 -0
  16. package/agents/impeccable/reference/adapt.native.md +58 -0
  17. package/agents/impeccable/reference/android.md +46 -0
  18. package/agents/impeccable/reference/animate.md +89 -0
  19. package/agents/impeccable/reference/audit.md +139 -0
  20. package/agents/impeccable/reference/audit.native.md +139 -0
  21. package/agents/impeccable/reference/bolder.md +33 -0
  22. package/agents/impeccable/reference/clarify.md +94 -0
  23. package/agents/impeccable/reference/colorize.md +86 -0
  24. package/agents/impeccable/reference/component-review.md +63 -0
  25. package/agents/impeccable/reference/craft-floor.md +44 -0
  26. package/agents/impeccable/reference/craft.md +5 -0
  27. package/agents/impeccable/reference/critique.md +819 -0
  28. package/agents/impeccable/reference/degraded/asset-producer.md +42 -0
  29. package/agents/impeccable/reference/degraded/documenter.md +24 -0
  30. package/agents/impeccable/reference/degraded/finish-reviewer.md +38 -0
  31. package/agents/impeccable/reference/degraded/manual-edit-applier.md +92 -0
  32. package/agents/impeccable/reference/delight.md +70 -0
  33. package/agents/impeccable/reference/distill.md +111 -0
  34. package/agents/impeccable/reference/doctor.md +54 -0
  35. package/agents/impeccable/reference/document.md +416 -0
  36. package/agents/impeccable/reference/extract.md +69 -0
  37. package/agents/impeccable/reference/generate.md +101 -0
  38. package/agents/impeccable/reference/harden.md +343 -0
  39. package/agents/impeccable/reference/hooks.md +113 -0
  40. package/agents/impeccable/reference/init.md +131 -0
  41. package/agents/impeccable/reference/ios.md +51 -0
  42. package/agents/impeccable/reference/layout.md +84 -0
  43. package/agents/impeccable/reference/live-setup.md +104 -0
  44. package/agents/impeccable/reference/live.md +325 -0
  45. package/agents/impeccable/reference/mode-operate.md +21 -0
  46. package/agents/impeccable/reference/mode-persuade.md +19 -0
  47. package/agents/impeccable/reference/mode-read.md +21 -0
  48. package/agents/impeccable/reference/new-work.md +154 -0
  49. package/agents/impeccable/reference/onboard.md +234 -0
  50. package/agents/impeccable/reference/operate.md +61 -0
  51. package/agents/impeccable/reference/optimize.md +258 -0
  52. package/agents/impeccable/reference/overdrive.md +127 -0
  53. package/agents/impeccable/reference/polish.md +105 -0
  54. package/agents/impeccable/reference/quieter.md +99 -0
  55. package/agents/impeccable/reference/region-map.md +26 -0
  56. package/agents/impeccable/reference/routing.md +24 -0
  57. package/agents/impeccable/reference/shape.md +59 -0
  58. package/agents/impeccable/reference/typeset.md +90 -0
  59. package/agents/impeccable/reference/visualize.md +47 -0
  60. package/agents/impeccable/reversa-bundle.json +16 -0
  61. package/agents/impeccable/scripts/VERSION +1 -0
  62. package/agents/impeccable/scripts/command-metadata.json +98 -0
  63. package/agents/impeccable/scripts/data/font-index-failures.json +121 -0
  64. package/agents/impeccable/scripts/data/font-index.json +1 -0
  65. package/agents/impeccable/scripts/impeccable +212 -0
  66. package/agents/impeccable/scripts/impeccable.cmd +239 -0
  67. package/agents/impeccable/scripts/live-browser-dom.js +320 -0
  68. package/agents/impeccable/scripts/live-browser-ignores.js +242 -0
  69. package/agents/impeccable/scripts/live-browser-session.js +180 -0
  70. package/agents/impeccable/scripts/live-browser.js +13557 -0
  71. package/agents/impeccable/scripts/modern-screenshot.umd.js +14 -0
  72. package/agents/reversa/SKILL.md +135 -0
  73. package/agents/reversa/agents/openai.yaml +3 -0
  74. package/agents/reversa/references/checkpoint-guide.md +106 -0
  75. package/agents/reversa/references/state-schema.md +80 -0
  76. package/agents/reversa/references/step-01-first-run.md +63 -0
  77. package/agents/reversa/references/step-02-resume.md +88 -0
  78. package/agents/reversa/references/step-03-specs-organization.md +145 -0
  79. package/agents/reversa/references/step-04-regression-check.md +94 -0
  80. package/agents/reversa-add/SKILL.md +131 -0
  81. package/agents/reversa-add/agents/openai.yaml +5 -0
  82. package/agents/reversa-agents-help/SKILL.md +211 -0
  83. package/agents/reversa-agents-help/agents/openai.yaml +3 -0
  84. package/agents/reversa-arbiter/SKILL.md +140 -0
  85. package/agents/reversa-arbiter/agents/openai.yaml +5 -0
  86. package/agents/reversa-archaeologist/SKILL.md +95 -0
  87. package/agents/reversa-archaeologist/agents/openai.yaml +5 -0
  88. package/agents/reversa-archaeologist/references/modules-schema.md +69 -0
  89. package/agents/reversa-architect/SKILL.md +93 -0
  90. package/agents/reversa-architect/agents/openai.yaml +5 -0
  91. package/agents/reversa-arquitetura-3d/SKILL.md +163 -0
  92. package/agents/reversa-arquitetura-3d/agents/openai.yaml +5 -0
  93. package/agents/reversa-arquitetura-3d/references/ARCH_TOUR.md +242 -0
  94. package/agents/reversa-arquitetura-3d/references/CALL_GRAPH_3D.md +217 -0
  95. package/agents/reversa-arquitetura-3d/references/CODE_CITY.md +228 -0
  96. package/agents/reversa-arquitetura-3d/references/DEPENDENCY_GRAPH_3D.md +240 -0
  97. package/agents/reversa-arquitetura-3d/references/ERRORS.md +286 -0
  98. package/agents/reversa-arquitetura-3d/references/LAYER_STACK.md +230 -0
  99. package/agents/reversa-arquitetura-3d/references/THREE_PATTERNS.md +221 -0
  100. package/agents/reversa-audit/SKILL.md +98 -0
  101. package/agents/reversa-audit/agents/openai.yaml +5 -0
  102. package/agents/reversa-autonomous/SKILL.md +139 -0
  103. package/agents/reversa-autonomous/agents/openai.yaml +3 -0
  104. package/agents/reversa-brainstorm/SKILL.md +131 -0
  105. package/agents/reversa-brainstorm/agents/openai.yaml +3 -0
  106. package/agents/reversa-challenger/SKILL.md +122 -0
  107. package/agents/reversa-challenger/agents/openai.yaml +5 -0
  108. package/agents/reversa-clarify/SKILL.md +103 -0
  109. package/agents/reversa-clarify/agents/openai.yaml +5 -0
  110. package/agents/reversa-code-express/SKILL.md +252 -0
  111. package/agents/reversa-code-express/agents/openai.yaml +5 -0
  112. package/agents/reversa-coding/SKILL.md +172 -0
  113. package/agents/reversa-coding/agents/openai.yaml +5 -0
  114. package/agents/reversa-curator/SKILL.md +133 -0
  115. package/agents/reversa-curator/agents/openai.yaml +5 -0
  116. package/agents/reversa-curator/references/decision-rubric.md +52 -0
  117. package/agents/reversa-curator/references/templates/discard_log.md +37 -0
  118. package/agents/reversa-curator/references/templates/target_business_rules.md +54 -0
  119. package/agents/reversa-data-master/SKILL.md +67 -0
  120. package/agents/reversa-data-master/agents/openai.yaml +5 -0
  121. package/agents/reversa-debugger/SKILL.md +178 -0
  122. package/agents/reversa-debugger/agents/openai.yaml +3 -0
  123. package/agents/reversa-debugger/references/bug-schema.md +123 -0
  124. package/agents/reversa-debugger/references/bugs-readme-template.md +76 -0
  125. package/agents/reversa-debugger-debate/SKILL.md +75 -0
  126. package/agents/reversa-debugger-debate/agents/openai.yaml +5 -0
  127. package/agents/reversa-debugger-debate/references/debate-protocol.md +102 -0
  128. package/agents/reversa-debugger-fix/SKILL.md +170 -0
  129. package/agents/reversa-debugger-fix/agents/openai.yaml +5 -0
  130. package/agents/reversa-debugger-graph/SKILL.md +94 -0
  131. package/agents/reversa-debugger-graph/agents/openai.yaml +5 -0
  132. package/agents/reversa-decouple/SKILL.md +78 -0
  133. package/agents/reversa-decouple/agents/openai.yaml +5 -0
  134. package/agents/reversa-depth-inspection/SKILL.md +99 -0
  135. package/agents/reversa-depth-inspection/agents/openai.yaml +5 -0
  136. package/agents/reversa-design-system/SKILL.md +77 -0
  137. package/agents/reversa-design-system/agents/openai.yaml +5 -0
  138. package/agents/reversa-designer/SKILL.md +217 -0
  139. package/agents/reversa-designer/agents/openai.yaml +5 -0
  140. package/agents/reversa-designer/references/paradigm-checklist.md +50 -0
  141. package/agents/reversa-designer/references/templates/data_migration_plan.md +80 -0
  142. package/agents/reversa-designer/references/templates/target_architecture.md +68 -0
  143. package/agents/reversa-designer/references/templates/target_data_model.md +64 -0
  144. package/agents/reversa-designer/references/templates/target_domain_model.md +62 -0
  145. package/agents/reversa-designer/references/templates/topology_decision.md +82 -0
  146. package/agents/reversa-detective/SKILL.md +82 -0
  147. package/agents/reversa-detective/agents/openai.yaml +5 -0
  148. package/agents/reversa-docs/SKILL.md +241 -0
  149. package/agents/reversa-docs/agents/openai.yaml +3 -0
  150. package/agents/reversa-docs/references/config-schema.json +108 -0
  151. package/agents/reversa-docs/references/expected_sources.yaml +60 -0
  152. package/agents/reversa-docs-analyst/SKILL.md +163 -0
  153. package/agents/reversa-docs-analyst/agents/openai.yaml +5 -0
  154. package/agents/reversa-docs-mapper/SKILL.md +167 -0
  155. package/agents/reversa-docs-mapper/agents/openai.yaml +5 -0
  156. package/agents/reversa-docs-mapper/references/extraction-policy.md +44 -0
  157. package/agents/reversa-docs-publisher/SKILL.md +323 -0
  158. package/agents/reversa-docs-publisher/agents/openai.yaml +5 -0
  159. package/agents/reversa-docs-publisher/references/auxiliary_sources.yaml +27 -0
  160. package/agents/reversa-docs-publisher/references/vendor-pins.yaml +149 -0
  161. package/agents/reversa-docs-storyteller/SKILL.md +189 -0
  162. package/agents/reversa-docs-storyteller/agents/openai.yaml +5 -0
  163. package/agents/reversa-drafter/SKILL.md +189 -0
  164. package/agents/reversa-drafter/agents/openai.yaml +5 -0
  165. package/agents/reversa-especialista-d3/SKILL.md +37 -0
  166. package/agents/reversa-especialista-d3/agents/openai.yaml +5 -0
  167. package/agents/reversa-especialista-d3/references/api-core.md +13 -0
  168. package/agents/reversa-especialista-d3/references/interatividade.md +5 -0
  169. package/agents/reversa-especialista-d3/references/layouts-complexos.md +8 -0
  170. package/agents/reversa-explorer/SKILL.md +110 -0
  171. package/agents/reversa-explorer/agents/openai.yaml +5 -0
  172. package/agents/reversa-extract-soul/SKILL.md +221 -0
  173. package/agents/reversa-extract-soul/agents/openai.yaml +5 -0
  174. package/agents/reversa-forward/SKILL.md +235 -0
  175. package/agents/reversa-forward/agents/openai.yaml +3 -0
  176. package/agents/reversa-forward-autonomous/SKILL.md +184 -0
  177. package/agents/reversa-forward-autonomous/agents/openai.yaml +3 -0
  178. package/agents/reversa-framer/SKILL.md +124 -0
  179. package/agents/reversa-framer/agents/openai.yaml +5 -0
  180. package/agents/reversa-highcharts-visualizer/SKILL.md +123 -0
  181. package/agents/reversa-highcharts-visualizer/agents/openai.yaml +5 -0
  182. package/agents/reversa-highcharts-visualizer/references/CHART_CATALOG.md +450 -0
  183. package/agents/reversa-highcharts-visualizer/references/ERRORS.md +99 -0
  184. package/agents/reversa-highcharts-visualizer/references/HIGHCHARTS_PATTERNS.md +347 -0
  185. package/agents/reversa-highcharts-visualizer/scripts/analyze_data.py +219 -0
  186. package/agents/reversa-highcharts-visualizer/scripts/parse_data.py +246 -0
  187. package/agents/reversa-highcharts-visualizer/scripts/sample_data.py +208 -0
  188. package/agents/reversa-ideator/SKILL.md +139 -0
  189. package/agents/reversa-ideator/agents/openai.yaml +5 -0
  190. package/agents/reversa-image-prompt-json/SKILL.md +210 -0
  191. package/agents/reversa-image-prompt-json/agents/openai.yaml +5 -0
  192. package/agents/reversa-image-prompt-json/references/Examples.md +123 -0
  193. package/agents/reversa-inspector/SKILL.md +147 -0
  194. package/agents/reversa-inspector/agents/openai.yaml +5 -0
  195. package/agents/reversa-inspector/references/parity-coverage-matrix.md +54 -0
  196. package/agents/reversa-inspector/references/templates/parity_specs.md +64 -0
  197. package/agents/reversa-inspector/references/templates/parity_test.feature +40 -0
  198. package/agents/reversa-migrate/SKILL.md +282 -0
  199. package/agents/reversa-migrate/agents/openai.yaml +3 -0
  200. package/agents/reversa-migrate/references/auto-defaults.md +52 -0
  201. package/agents/reversa-migrate/references/expected_legacy_artifacts.yaml +69 -0
  202. package/agents/reversa-migrate/references/handoff-checklist.md +34 -0
  203. package/agents/reversa-migrate/references/state.json +28 -0
  204. package/agents/reversa-migrate/references/templates/ambiguity_log.md +43 -0
  205. package/agents/reversa-migrate/references/templates/handoff.md +91 -0
  206. package/agents/reversa-migrate/references/templates/migration_brief.md +52 -0
  207. package/agents/reversa-migrate/references/templates/pending_decisions.md +36 -0
  208. package/agents/reversa-modularize/SKILL.md +77 -0
  209. package/agents/reversa-modularize/agents/openai.yaml +5 -0
  210. package/agents/reversa-n8n/SKILL.md +256 -0
  211. package/agents/reversa-n8n/agents/openai.yaml +5 -0
  212. package/agents/reversa-n8n/references/node-catalog.md +245 -0
  213. package/agents/reversa-new/SKILL.md +328 -0
  214. package/agents/reversa-new/agents/openai.yaml +3 -0
  215. package/agents/reversa-optimize/SKILL.md +80 -0
  216. package/agents/reversa-optimize/agents/openai.yaml +5 -0
  217. package/agents/reversa-paradigm-advisor/SKILL.md +168 -0
  218. package/agents/reversa-paradigm-advisor/agents/openai.yaml +5 -0
  219. package/agents/reversa-paradigm-advisor/references/paradigm-catalog.md +73 -0
  220. package/agents/reversa-paradigm-advisor/references/templates/paradigm_decision.md +69 -0
  221. package/agents/reversa-plan/SKILL.md +92 -0
  222. package/agents/reversa-plan/agents/openai.yaml +5 -0
  223. package/agents/reversa-pre-spec/SKILL.md +133 -0
  224. package/agents/reversa-pre-spec/agents/openai.yaml +5 -0
  225. package/agents/reversa-pricing/SKILL.md +181 -0
  226. package/agents/reversa-pricing/agents/openai.yaml +3 -0
  227. package/agents/reversa-pricing-advisor/SKILL.md +322 -0
  228. package/agents/reversa-pricing-advisor/agents/openai.yaml +5 -0
  229. package/agents/reversa-pricing-advisor/references/advisor-schema.json +196 -0
  230. package/agents/reversa-pricing-advisor/references/advisor-template.md +106 -0
  231. package/agents/reversa-pricing-advisor/references/sale-models.md +237 -0
  232. package/agents/reversa-pricing-estimate/SKILL.md +287 -0
  233. package/agents/reversa-pricing-estimate/agents/openai.yaml +5 -0
  234. package/agents/reversa-pricing-estimate/references/effort-formula.md +146 -0
  235. package/agents/reversa-pricing-estimate/references/estimate-schema.json +141 -0
  236. package/agents/reversa-pricing-estimate/references/estimate-template.md +153 -0
  237. package/agents/reversa-pricing-estimate/references/example-estimate.json +74 -0
  238. package/agents/reversa-pricing-estimate/references/example-estimate.md +88 -0
  239. package/agents/reversa-pricing-estimate/references/market-benchmarks.md +102 -0
  240. package/agents/reversa-pricing-estimate/references/value-formula.md +123 -0
  241. package/agents/reversa-pricing-product/SKILL.md +299 -0
  242. package/agents/reversa-pricing-product/agents/openai.yaml +5 -0
  243. package/agents/reversa-pricing-product/references/breakeven-formula.md +237 -0
  244. package/agents/reversa-pricing-product/references/product-schema.json +288 -0
  245. package/agents/reversa-pricing-product/references/product-template.md +113 -0
  246. package/agents/reversa-pricing-product/references/store-commissions.md +57 -0
  247. package/agents/reversa-pricing-profile/SKILL.md +390 -0
  248. package/agents/reversa-pricing-profile/agents/openai.yaml +5 -0
  249. package/agents/reversa-pricing-profile/references/example-profile.json +23 -0
  250. package/agents/reversa-pricing-profile/references/example-profile.md +46 -0
  251. package/agents/reversa-pricing-profile/references/profile-schema.json +227 -0
  252. package/agents/reversa-pricing-profile/references/tax-regimes.md +106 -0
  253. package/agents/reversa-pricing-research/SKILL.md +352 -0
  254. package/agents/reversa-pricing-research/agents/openai.yaml +5 -0
  255. package/agents/reversa-pricing-research/references/research-policy.md +213 -0
  256. package/agents/reversa-pricing-research/references/research-schema.json +330 -0
  257. package/agents/reversa-pricing-size/SKILL.md +205 -0
  258. package/agents/reversa-pricing-size/agents/openai.yaml +5 -0
  259. package/agents/reversa-pricing-size/references/example-size.json +41 -0
  260. package/agents/reversa-pricing-size/references/size-schema.json +120 -0
  261. package/agents/reversa-pricing-size/references/sizing-formula.md +183 -0
  262. package/agents/reversa-principles/SKILL.md +82 -0
  263. package/agents/reversa-principles/agents/openai.yaml +5 -0
  264. package/agents/reversa-prune/SKILL.md +85 -0
  265. package/agents/reversa-prune/agents/openai.yaml +5 -0
  266. package/agents/reversa-quality/SKILL.md +87 -0
  267. package/agents/reversa-quality/agents/openai.yaml +5 -0
  268. package/agents/reversa-reconstructor/SKILL.md +243 -0
  269. package/agents/reversa-reconstructor/agents/openai.yaml +5 -0
  270. package/agents/reversa-reconstructor/references/reconstruction-plan-migration-template.md +89 -0
  271. package/agents/reversa-reconstructor/references/reconstruction-plan-template.md +77 -0
  272. package/agents/reversa-refactor/SKILL.md +112 -0
  273. package/agents/reversa-refactor/agents/openai.yaml +3 -0
  274. package/agents/reversa-refactor/references/opportunity-schema.md +68 -0
  275. package/agents/reversa-refactor/references/refactor-readme-template.md +35 -0
  276. package/agents/reversa-requirements/SKILL.md +217 -0
  277. package/agents/reversa-requirements/agents/openai.yaml +5 -0
  278. package/agents/reversa-researcher/SKILL.md +136 -0
  279. package/agents/reversa-researcher/agents/openai.yaml +5 -0
  280. package/agents/reversa-restructure/SKILL.md +78 -0
  281. package/agents/reversa-restructure/agents/openai.yaml +5 -0
  282. package/agents/reversa-resume/SKILL.md +141 -0
  283. package/agents/reversa-resume/agents/openai.yaml +5 -0
  284. package/agents/reversa-reviewer/SKILL.md +163 -0
  285. package/agents/reversa-reviewer/agents/openai.yaml +5 -0
  286. package/agents/reversa-reviewer/references/confidence-report-template.md +73 -0
  287. package/agents/reversa-reviewer/references/confidence-rules.md +65 -0
  288. package/agents/reversa-reviewer/references/questions-template.md +74 -0
  289. package/agents/reversa-scout/SKILL.md +82 -0
  290. package/agents/reversa-scout/agents/openai.yaml +5 -0
  291. package/agents/reversa-scout/references/surface-schema.md +93 -0
  292. package/agents/reversa-screen-translator/SKILL.md +279 -0
  293. package/agents/reversa-screen-translator/agents/openai.yaml +5 -0
  294. package/agents/reversa-screen-translator/references/adapter-pairs.md +97 -0
  295. package/agents/reversa-screen-translator/references/platform-detection.md +73 -0
  296. package/agents/reversa-screen-translator/references/templates/golden_manifest.yaml +62 -0
  297. package/agents/reversa-screen-translator/references/templates/inventory.schema.json +132 -0
  298. package/agents/reversa-screen-translator/references/templates/screen_deviation_log.md +66 -0
  299. package/agents/reversa-screen-translator/references/templates/screen_modernization_decision.md +106 -0
  300. package/agents/reversa-screen-translator/references/templates/target_screens.md +206 -0
  301. package/agents/reversa-selo-generativo/SKILL.md +176 -0
  302. package/agents/reversa-selo-generativo/agents/openai.yaml +5 -0
  303. package/agents/reversa-selo-generativo/references/ERRORS.md +212 -0
  304. package/agents/reversa-selo-generativo/references/GENERATIVE_PATTERNS.md +365 -0
  305. package/agents/reversa-selo-generativo/references/PALETTE_BY_STYLE.md +176 -0
  306. package/agents/reversa-simplify/SKILL.md +79 -0
  307. package/agents/reversa-simplify/agents/openai.yaml +5 -0
  308. package/agents/reversa-spec-sdd/SKILL.md +278 -0
  309. package/agents/reversa-spec-sdd/agents/openai.yaml +5 -0
  310. package/agents/reversa-spec-sdd/assets/spec_examples.md +159 -0
  311. package/agents/reversa-spec-sdd/references/evaluation_rubric.md +113 -0
  312. package/agents/reversa-spec-sdd/references/sdd_guide.md +124 -0
  313. package/agents/reversa-spec-sdd/references/spec_template.md +231 -0
  314. package/agents/reversa-spec-sdd/scripts/spec_scorer.py +476 -0
  315. package/agents/reversa-standardize/SKILL.md +76 -0
  316. package/agents/reversa-standardize/agents/openai.yaml +5 -0
  317. package/agents/reversa-strategist/SKILL.md +119 -0
  318. package/agents/reversa-strategist/agents/openai.yaml +5 -0
  319. package/agents/reversa-strategist/references/migration-strategies.md +41 -0
  320. package/agents/reversa-strategist/references/templates/cutover_plan.md +60 -0
  321. package/agents/reversa-strategist/references/templates/migration_strategy.md +55 -0
  322. package/agents/reversa-strategist/references/templates/risk_register.md +44 -0
  323. package/agents/reversa-sync/SKILL.md +100 -0
  324. package/agents/reversa-sync/agents/openai.yaml +5 -0
  325. package/agents/reversa-to-do/SKILL.md +89 -0
  326. package/agents/reversa-to-do/agents/openai.yaml +5 -0
  327. package/agents/reversa-visor/SKILL.md +91 -0
  328. package/agents/reversa-visor/agents/openai.yaml +5 -0
  329. package/agents/reversa-writer/SKILL.md +212 -0
  330. package/agents/reversa-writer/agents/openai.yaml +5 -0
  331. package/agents/reversa-writer/references/design-template.md +49 -0
  332. package/agents/reversa-writer/references/requirements-template.md +62 -0
  333. package/agents/reversa-writer/references/tasks-template.md +39 -0
  334. package/bin/reversa.js +65 -0
  335. package/lib/commands/add-engine.js +97 -0
  336. package/lib/commands/export-diagrams.js +194 -0
  337. package/lib/commands/install.js +260 -0
  338. package/lib/commands/status.js +35 -0
  339. package/lib/commands/uninstall.js +159 -0
  340. package/lib/commands/update.js +252 -0
  341. package/lib/installer/bundled.js +42 -0
  342. package/lib/installer/detector.js +167 -0
  343. package/lib/installer/manifest.js +61 -0
  344. package/lib/installer/orange-prompts.js +13 -0
  345. package/lib/installer/policy.js +53 -0
  346. package/lib/installer/prompts.js +252 -0
  347. package/lib/installer/validator.js +22 -0
  348. package/lib/installer/writer.js +376 -0
  349. package/lib/utils/banner.js +35 -0
  350. package/lib/utils/json-safe.js +10 -0
  351. package/lib/utils/package-info.js +22 -0
  352. package/package.json +51 -4
  353. package/templates/config.toml +46 -0
  354. package/templates/config.user.toml +8 -0
  355. package/templates/documentation/assets/css/style.css +476 -0
  356. package/templates/documentation/assets/js/nav.js +141 -0
  357. package/templates/documentation/assets/js/sidebar.js +162 -0
  358. package/templates/documentation/demo/viewer-demo.html +200 -0
  359. package/templates/documentation/pages/arquitetura.html.tpl +36 -0
  360. package/templates/documentation/pages/deck.html.tpl +27 -0
  361. package/templates/documentation/pages/features/feature.html.tpl +44 -0
  362. package/templates/documentation/pages/glossario.html.tpl +30 -0
  363. package/templates/documentation/pages/index.html.tpl +32 -0
  364. package/templates/documentation/pages/metricas.html.tpl +43 -0
  365. package/templates/documentation/pages/modulos.html.tpl +33 -0
  366. package/templates/documentation/pages/timeline.html.tpl +33 -0
  367. package/templates/documentation/pages/topologia.html.tpl +31 -0
  368. package/templates/documentation/scripts/convert_chronicle.py +71 -0
  369. package/templates/documentation/scripts/convert_soul.py +73 -0
  370. package/templates/documentation/scripts/extract_deps.py +54 -0
  371. package/templates/documentation/scripts/extract_modules.py +90 -0
  372. package/templates/documentation/scripts/list_specs.py +74 -0
  373. package/templates/documentation/viewer.html +60 -0
  374. package/templates/engines/AGENTS.md +26 -0
  375. package/templates/engines/CLAUDE.md +27 -0
  376. package/templates/engines/CONVENTIONS.md +26 -0
  377. package/templates/engines/GEMINI.md +26 -0
  378. package/templates/engines/amazonq +7 -0
  379. package/templates/engines/clinerules +7 -0
  380. package/templates/engines/copilot-instructions +26 -0
  381. package/templates/engines/cursorrules +7 -0
  382. package/templates/engines/roorules +7 -0
  383. package/templates/engines/windsurf +7 -0
  384. package/templates/forward/body/actions-template.md +83 -0
  385. package/templates/forward/body/principles-template.md +75 -0
  386. package/templates/forward/body/quality-template.md +103 -0
  387. package/templates/forward/body/requirements-template.md +121 -0
  388. package/templates/forward/body/roadmap-template.md +107 -0
  389. package/templates/forward/hooks.yml +60 -0
  390. package/templates/forward/scripts/ps/bind-to-extraction.ps1 +71 -0
  391. package/templates/forward/scripts/ps/prepare-roadmap.ps1 +84 -0
  392. package/templates/forward/scripts/ps/verify-prerequisites.ps1 +103 -0
  393. package/templates/forward/scripts/sh/bind-to-extraction.sh +103 -0
  394. package/templates/forward/scripts/sh/prepare-roadmap.sh +79 -0
  395. package/templates/forward/scripts/sh/verify-prerequisites.sh +125 -0
  396. package/templates/forward/setup.json +24 -0
  397. package/templates/hooks/README.md +41 -0
  398. package/templates/hooks/check-legacy-policy.mjs +0 -0
  399. package/templates/migration/artifacts/ambiguity_log.md +43 -0
  400. package/templates/migration/artifacts/cutover_plan.md +60 -0
  401. package/templates/migration/artifacts/data_migration_plan.md +80 -0
  402. package/templates/migration/artifacts/discard_log.md +37 -0
  403. package/templates/migration/artifacts/handoff.md +76 -0
  404. package/templates/migration/artifacts/migration_brief.md +52 -0
  405. package/templates/migration/artifacts/migration_strategy.md +55 -0
  406. package/templates/migration/artifacts/paradigm_decision.md +69 -0
  407. package/templates/migration/artifacts/parity_specs.md +64 -0
  408. package/templates/migration/artifacts/parity_test.feature +40 -0
  409. package/templates/migration/artifacts/pending_decisions.md +36 -0
  410. package/templates/migration/artifacts/risk_register.md +44 -0
  411. package/templates/migration/artifacts/target_architecture.md +68 -0
  412. package/templates/migration/artifacts/target_business_rules.md +54 -0
  413. package/templates/migration/artifacts/target_data_model.md +64 -0
  414. package/templates/migration/artifacts/target_domain_model.md +62 -0
  415. package/templates/migration/catalogs/migration_strategies.md +101 -0
  416. package/templates/migration/catalogs/paradigm_catalog.md +101 -0
  417. package/templates/migration/expected_legacy_artifacts.yaml +77 -0
  418. package/templates/migration/state.json +28 -0
  419. package/templates/plan.md +65 -0
  420. package/templates/reversa-config.json +5 -0
  421. package/templates/state.json +18 -0
@@ -0,0 +1,159 @@
1
+ # Exemplos de Specs: Boa vs. Ruim
2
+
3
+ Estes exemplos usam a feature "Notificações por E-mail" para ilustrar a diferença.
4
+
5
+ ---
6
+
7
+ ## ❌ Spec Ruim — Score: 32/100
8
+
9
+ ```markdown
10
+ # Spec: Notificações
11
+
12
+ ## O que vamos fazer
13
+ Implementar notificações por e-mail para os usuários quando acontecer algo importante.
14
+
15
+ ## Requisitos
16
+ - O sistema deve enviar e-mails
17
+ - Os e-mails devem ser bonitos
18
+ - O usuário deve poder desativar notificações
19
+ - Deve ser rápido
20
+
21
+ ## Notas técnicas
22
+ Usar SendGrid ou SES. Talvez usar fila SQS.
23
+ ```
24
+
25
+ ### Por que é ruim:
26
+
27
+ | Problema | Impacto |
28
+ |---------|---------|
29
+ | "quando acontecer algo importante" — o que é importante? | Dev vai implementar o que achar certo, não o que o negócio quer |
30
+ | "e-mails devem ser bonitos" — não testável | Nenhum critério de aceite possível |
31
+ | "deve ser rápido" — sem número | Bug: e-mail demora 5min, dev acha que está ok |
32
+ | Non-goals ausentes | Scope creep: "e o SMS? e o push notification?" |
33
+ | Edge cases ausentes | O que acontece se o e-mail bounce? Se o usuário desativou? |
34
+ | Mistura spec com decisão técnica (SendGrid/SES/SQS) | Acopla o "o quê" ao "como" desnecessariamente |
35
+ | Nenhum ID de requisito | Impossível rastrear qual requisito um PR implementou |
36
+
37
+ ---
38
+
39
+ ## ✅ Spec Boa — Score: 87/100
40
+
41
+ ```markdown
42
+ # Spec: Notificações por E-mail — Atividades da Conta
43
+
44
+ **Versão:** 1.0 | **Status:** Aprovada | **Data:** 2025-01-15
45
+
46
+ ## 1. Resumo
47
+ Enviar notificações por e-mail transacional para usuários quando eventos relevantes
48
+ da conta ocorrerem, com controle granular de preferências de notificação.
49
+
50
+ ## 2. Contexto e Motivação
51
+ **Problema:** Usuários perdem ações importantes (ex: novo comentário, pagamento processado)
52
+ porque só descobrem ao acessar o app. Resultado: engajamento tardio e abandono de tarefas.
53
+ **Evidência:** 68% dos usuários inativos citaram "não sabia que tinha algo esperando"
54
+ na pesquisa de churn de Dez/2024.
55
+ **Por que agora:** Plataforma de e-mail contratada (SendGrid), integração viável em 1 sprint.
56
+
57
+ ## 3. Goals
58
+ - [ ] G-01: Usuários recebem e-mail em < 2 min após evento gatilho
59
+ - [ ] G-02: Taxa de abertura ≥ 25% (benchmark: 21% no setor)
60
+ - [ ] G-03: 100% dos usuários conseguem desativar notificações em ≤ 3 cliques
61
+
62
+ ## 4. Non-Goals
63
+ - NG-01: Notificações push (mobile) — versão futura
64
+ - NG-02: Notificações por SMS — fora do roadmap 2025
65
+ - NG-03: E-mails de marketing / newsletter — escopo do time de Growth
66
+ - NG-04: Suporte a múltiplos endereços de e-mail por usuário
67
+
68
+ ## 5. Usuários
69
+ **Primário:** Usuário com conta ativa, qualquer plano.
70
+ **Jornada atual:** Usuário precisa entrar no app para ver se há novidades.
71
+ **Jornada futura:** Usuário recebe e-mail com resumo do evento e link direto para a ação.
72
+
73
+ ## 6. Requisitos Funcionais
74
+
75
+ | ID | Requisito | Prioridade | Critério de Aceite |
76
+ |----|-----------|-----------|-------------------|
77
+ | RF-01 | O sistema deve enviar e-mail quando um comentário for adicionado a um item do usuário | Must | E-mail recebido em < 2 min em 95% dos casos (teste com 100 envios) |
78
+ | RF-02 | O sistema deve enviar e-mail quando um pagamento for processado (sucesso ou falha) | Must | E-mail recebido em < 2 min; inclui valor, data e status |
79
+ | RF-03 | O usuário deve poder desativar cada tipo de notificação individualmente em Configurações > Notificações | Must | Toggle persiste após logout/login; e-mail do tipo desativado não é enviado |
80
+ | RF-04 | O sistema deve incluir link de "cancelar todas as notificações" no rodapé de todo e-mail | Must | Link funciona sem login; redireciona para página de confirmação |
81
+ | RF-05 | O sistema deve agrupar notificações do mesmo tipo em digest diário quando houver > 5 eventos em 1h | Should | Usuário recebe 1 e-mail com lista dos 5+ eventos, não 5+ e-mails separados |
82
+
83
+ ### Fluxo Principal (RF-01)
84
+ 1. Usuário B comenta no item X do Usuário A
85
+ 2. Sistema detecta evento `comment.created`
86
+ 3. Sistema verifica se Usuário A tem RF-01 ativado (padrão: ativo)
87
+ 4. Sistema envia e-mail para Usuário A com: nome do comentador, trecho do comentário (máx. 200 chars), link direto para o item
88
+ 5. Resultado: Usuário A recebe e-mail em < 2 min
89
+
90
+ ## 7. Requisitos Não-Funcionais
91
+ | ID | Requisito | Target |
92
+ |----|-----------|--------|
93
+ | RNF-01 | Latência de envio | P95 < 2min após evento |
94
+ | RNF-02 | Taxa de entrega | ≥ 98% (excluindo bounces permanentes) |
95
+ | RNF-03 | Segurança | Links de unsubscribe com token único e assinado |
96
+
97
+ ## 11. Edge Cases
98
+
99
+ | ID | Cenário | Trigger | Comportamento |
100
+ |----|---------|---------|---------------|
101
+ | EC-01 | E-mail inválido/bounce permanente | SendGrid retorna hard bounce | Desativar envios para esse e-mail; notificar usuário in-app |
102
+ | EC-02 | Usuário desativou notificações | `user.notifications.comments = false` | Não envia; não registra erro |
103
+ | EC-03 | SendGrid indisponível | Timeout ou erro 5xx | Retry com backoff: 1min, 5min, 30min. Após 3 falhas: logar e alertar time |
104
+ | EC-04 | Usuário deletou conta antes do envio | User ID não encontrado na fila | Descartar silenciosamente; logar para auditoria |
105
+ | EC-05 | Mesmo evento dispara 2x | Bug de duplicidade | Deduplicar por event_id com TTL de 1h |
106
+
107
+ ## 14. Open Questions
108
+ | # | Pergunta | Impacto | Prazo |
109
+ |---|---------|---------|-------|
110
+ | OQ-01 | ⚠️ ABERTO: Digest diário (RF-05) — qual o horário do envio? Timezone do usuário ou UTC? | Médio | 20/01 |
111
+ ```
112
+
113
+ ### Por que é boa:
114
+
115
+ | Ponto forte | Benefício |
116
+ |------------|-----------|
117
+ | Cada requisito tem ID, prioridade e critério de aceite | QA escreve testes direto da tabela |
118
+ | Non-goals explícitos (4 itens) | Time sabe exatamente o que recusar |
119
+ | Edge cases cobrem falhas externas | Dev implementa retry sem precisar perguntar |
120
+ | Métricas numéricas (< 2min, ≥ 25%) | Sucesso é verificável |
121
+ | Open Question sinalizada com `⚠️ ABERTO:` | Ambiguidade visível, não silenciosa |
122
+ | Fluxo principal passo a passo | LLM implementa sem suposições |
123
+
124
+ ---
125
+
126
+ ## 🔶 Spec Média — Score: 63/100
127
+
128
+ ```markdown
129
+ # Spec: Login com Google
130
+
131
+ ## Objetivo
132
+ Permitir que usuários façam login usando a conta Google deles.
133
+
134
+ ## Requisitos
135
+ - RF-01: Adicionar botão "Entrar com Google" na tela de login
136
+ - RF-02: Usuário deve ser redirecionado para OAuth do Google
137
+ - RF-03: Após autenticação, criar sessão do usuário
138
+ - RF-04: Se o e-mail já existe no sistema, fazer login na conta existente
139
+ - RF-05: Se o e-mail não existe, criar nova conta automaticamente
140
+
141
+ ## Fora do escopo
142
+ - Login com Facebook/Apple por enquanto
143
+
144
+ ## Edge Cases
145
+ - E se o usuário cancelar o fluxo OAuth?
146
+ - E se o Google estiver fora do ar?
147
+ ```
148
+
149
+ ### O que está bom:
150
+ - Requisitos numerados ✅
151
+ - Non-goals presentes ✅
152
+ - Edge cases identificados (mas sem resposta) ⚠️
153
+
154
+ ### O que está faltando (-37 pontos):
155
+ - Edge cases sem comportamento definido — "e se?" sem resposta (-10)
156
+ - Nenhum critério de aceite nos requisitos (-7)
157
+ - Seção de segurança ausente (dados OAuth, tokens) (-8)
158
+ - Sem métricas de sucesso (-7)
159
+ - RF-03 "criar sessão" — por quanto tempo? Com quais dados? (-5)
@@ -0,0 +1,113 @@
1
+ # Rubrica de Avaliação de Specs
2
+
3
+ Usada pelo `scripts/spec_scorer.py` e como guia de revisão manual.
4
+
5
+ Score total: **0–100 pontos**
6
+
7
+ ---
8
+
9
+ ## Dimensão 1: Completude (30 pontos)
10
+
11
+ Avalia se todas as seções essenciais estão presentes e preenchidas.
12
+
13
+ | Critério | Pontos | Como verificar |
14
+ |----------|--------|----------------|
15
+ | Seções 1–6 todas presentes e preenchidas (não apenas headers) | 10 | Cada seção tem ≥ 2 frases ou 1 item de lista |
16
+ | Requisitos funcionais com IDs (RF-XX) | 8 | Pelo menos 3 requisitos numerados |
17
+ | Critérios de aceite definidos para cada RF Must | 7 | Coluna "Critério de Aceite" preenchida |
18
+ | Non-Goals explícitos (seção 4) | 5 | Pelo menos 2 non-goals listados |
19
+
20
+ **Penalidades:**
21
+ - Seção obrigatória completamente ausente: -5 por seção
22
+ - Seção com placeholder não preenchido (`[colchetes]`): -2 por ocorrência
23
+
24
+ ---
25
+
26
+ ## Dimensão 2: Testabilidade (25 pontos)
27
+
28
+ Avalia se um QA consegue escrever testes a partir da spec sem fazer perguntas.
29
+
30
+ | Critério | Pontos | Como verificar |
31
+ |----------|--------|----------------|
32
+ | Requisitos usam verbos concretos e mensuráveis | 10 | Ausência de "deve ser bom", "deve ser rápido", "deve ser intuitivo" |
33
+ | Fluxo principal (happy path) descrito passo a passo | 8 | Seção 6.2 com ≥ 3 passos |
34
+ | Métricas de sucesso com valores numéricos | 7 | Seção 3 tem pelo menos 1 métrica com target numérico |
35
+
36
+ **Penalidades:**
37
+ - Requisito não-testável ("o sistema deve ser fácil de usar"): -3 por ocorrência
38
+ - Happy path ausente: -8
39
+
40
+ ---
41
+
42
+ ## Dimensão 3: Clareza (20 pontos)
43
+
44
+ Avalia se a linguagem é precisa e não ambígua.
45
+
46
+ | Critério | Pontos | Como verificar |
47
+ |----------|--------|----------------|
48
+ | Ausência de termos vagos sem definição | 8 | "rapidamente", "logo", "muitos", "alguns" sem valor — -2 cada |
49
+ | Open Questions sinalizadas com ⚠️ ou na seção 14 | 6 | Ambiguidades são explícitas, não silenciosas |
50
+ | Sujeito claro em cada requisito ("o sistema", "o usuário") | 6 | Não há requisitos sem sujeito identificado |
51
+
52
+ **Penalidades:**
53
+ - Contradição entre requisitos: -5 por contradição
54
+ - Termo técnico sem definição para audiência não-técnica: -2 por ocorrência
55
+
56
+ ---
57
+
58
+ ## Dimensão 4: Escopo (15 pontos)
59
+
60
+ Avalia se os limites da feature estão claros.
61
+
62
+ | Critério | Pontos | Como verificar |
63
+ |----------|--------|----------------|
64
+ | Seção de Non-Goals (4) clara e útil | 7 | Pelo menos 2 non-goals que previnem scope creep real |
65
+ | Dependências e integrações mapeadas (seção 10) | 5 | Toda dependência externa está listada |
66
+ | Plano de rollout / rollback presente (seção 13) | 3 | Estratégia e como reverter definidos |
67
+
68
+ **Penalidades:**
69
+ - Non-goals vagos ("funcionalidades futuras"): -2 por ocorrência
70
+ - Dependência crítica não mapeada: -3
71
+
72
+ ---
73
+
74
+ ## Dimensão 5: Edge Cases (10 pontos)
75
+
76
+ Avalia se os casos difíceis foram antecipados.
77
+
78
+ | Critério | Pontos | Como verificar |
79
+ |----------|--------|----------------|
80
+ | Pelo menos 3 edge cases listados (seção 11) | 5 | Tabela com ≥ 3 linhas preenchidas |
81
+ | Tratamento de erro com mensagem/comportamento definido | 3 | Cada erro tem comportamento esperado |
82
+ | Casos de falha de dependências externas cobertos | 2 | Pelo menos 1 EC para timeout/indisponibilidade |
83
+
84
+ **Penalidades:**
85
+ - Zero edge cases: -10 (esta seção zera)
86
+ - Edge case sem comportamento definido: -1 por ocorrência
87
+
88
+ ---
89
+
90
+ ## Classificação por Score
91
+
92
+ | Score | Classificação | Significado |
93
+ |-------|--------------|-------------|
94
+ | 90–100 | ⭐ Excelente | Pronta para implementação imediata |
95
+ | 80–89 | ✅ Boa | Pronta com ajustes menores |
96
+ | 65–79 | ⚠️ Adequada | Implementável mas com riscos |
97
+ | 50–64 | 🔶 Incompleta | Precisa de revisão antes de implementar |
98
+ | < 50 | ❌ Insuficiente | Voltar para entrevista / rascunho |
99
+
100
+ ---
101
+
102
+ ## Checklist Rápido de Revisão
103
+
104
+ Antes de marcar uma spec como "Aprovada", confirme:
105
+
106
+ - [ ] Qualquer dev pode implementar sem perguntar nada?
107
+ - [ ] Qualquer QA pode escrever testes sem perguntar nada?
108
+ - [ ] Os non-goals estão tão claros quanto os goals?
109
+ - [ ] Todo caso de erro tem um comportamento definido?
110
+ - [ ] Todos os requisitos têm IDs rastreáveis?
111
+ - [ ] Não há contradições entre requisitos?
112
+ - [ ] Open questions estão documentadas (não silenciosas)?
113
+ - [ ] Métricas de sucesso são numéricas e verificáveis?
@@ -0,0 +1,124 @@
1
+ # Guia de Metodologia — Spec-Driven Development
2
+
3
+ ## O que é SDD?
4
+
5
+ Spec-Driven Development é a prática de escrever uma especificação detalhada de comportamento **antes** de escrever qualquer código. A spec responde ao **quê** o sistema deve fazer — não ao **como** implementar.
6
+
7
+ Não confundir com:
8
+ - **TDD** (Test-Driven Development): escreve testes antes do código — complementar ao SDD
9
+ - **DDD** (Domain-Driven Design): padrão arquitetural — independente do SDD
10
+ - **BDD** (Behavior-Driven Development): foco em comportamentos com Gherkin — um subconjunto de SDD
11
+
12
+ ---
13
+
14
+ ## Princípios Fundamentais
15
+
16
+ ### 1. Behavior, not Implementation
17
+
18
+ A spec descreve o comportamento observável, não a implementação interna.
19
+
20
+ ❌ Ruim: "O sistema deve usar Redis para cache das sessões"
21
+ ✅ Bom: "O sistema deve manter a sessão do usuário ativa por 30 dias em dispositivos onde ele marcou 'lembrar de mim'"
22
+
23
+ A implementação (Redis, JWT, banco de dados) é uma decisão técnica de quem implementa — não da spec.
24
+
25
+ ### 2. Ambiguidade = Bug Futuro
26
+
27
+ Toda ambiguidade na spec se torna um bug, uma reunião de alinhamento ou uma discussão em PR no futuro. Torne ambiguidades explícitas com `⚠️ ABERTO:` — é melhor um item aberto visível do que uma suposição silenciosa.
28
+
29
+ ### 3. Non-Goals são tão importantes quanto Goals
30
+
31
+ "O que não vamos fazer" previne scope creep, alinha expectativas e acelera decisões. Uma feature sem non-goals tende a crescer indefinidamente.
32
+
33
+ ### 4. A Spec é um Contrato Vivo
34
+
35
+ A spec muda conforme o entendimento evolui — e isso é saudável. O que importa é que as mudanças sejam registradas (Decision Log) e que todos os stakeholders estejam alinhados com a versão atual.
36
+
37
+ ### 5. LLM-Readiness
38
+
39
+ Uma boa spec moderna deve ser legível por LLMs que vão ajudar a implementar. Isso significa:
40
+ - Requisitos numerados (IDs rastreáveis)
41
+ - Comportamentos explícitos, não implícitos
42
+ - Edge cases documentados (LLMs não adivinham casos extremos)
43
+ - Contexto de negócio incluído (o "porquê" ajuda a tomar boas decisões de implementação)
44
+
45
+ ---
46
+
47
+ ## O Ciclo SDD
48
+
49
+ ```
50
+ Ideia/Problema
51
+ ↓
52
+ Entrevista ←──────────────────────┐
53
+ ↓ │
54
+ Rascunho da Spec │
55
+ ↓ │
56
+ Avaliação (Score) │
57
+ ↓ │
58
+ Score < 80? ──── Sim ──── Identificar gaps
59
+ ↓ Não
60
+ Spec Aprovada
61
+ ↓
62
+ Implementação
63
+ ↓
64
+ Spec vs. Código (validação final)
65
+ ```
66
+
67
+ ---
68
+
69
+ ## Quando Escrever a Spec
70
+
71
+ | Tamanho da feature | Recomendação |
72
+ |-------------------|--------------|
73
+ | Fix de bug | Não precisa de spec |
74
+ | Melhoria pequena (< 1 dia dev) | Spec mínima: goals + requisitos principais |
75
+ | Feature nova (1–5 dias) | Spec completa, mas concisa |
76
+ | Feature complexa (> 5 dias) | Spec completa + revisão por 2+ pessoas |
77
+ | Sistema novo | Spec de arquitetura + specs por feature |
78
+
79
+ ---
80
+
81
+ ## Prioridades de Requisitos (MoSCoW)
82
+
83
+ | Prioridade | Significado | Decisão se não couber no prazo |
84
+ |-----------|-------------|-------------------------------|
85
+ | **Must** | Obrigatório — sem isso não lança | Bloqueia o lançamento |
86
+ | **Should** | Importante — mas há workaround | Adia para próxima versão |
87
+ | **Could** | Nice-to-have | Descarta se necessário |
88
+ | **Won't** | Conscientemente fora do escopo | Documenta como Non-Goal |
89
+
90
+ ---
91
+
92
+ ## Antipadrões Comuns
93
+
94
+ ### "Spec like a PRD de grande empresa"
95
+ Specs de 50 páginas que ninguém lê. Prefira specs concisas que cobrem o essencial com clareza.
96
+
97
+ ### "Spec como lista de tarefas técnicas"
98
+ "Criar tabela users, adicionar endpoint POST /auth, integrar com OAuth..." — isso é um plano de implementação, não uma spec. A spec fala em comportamento.
99
+
100
+ ### "Spec verbal / em Slack"
101
+ Decisões tomadas em conversa sem registro se perdem e geram conflitos. Toda spec deve existir como documento escrito.
102
+
103
+ ### "Spec que nunca muda"
104
+ Specs congeladas que não refletem a realidade do que foi implementado. A spec deve ser atualizada quando a implementação divergir intencionalmente.
105
+
106
+ ### "Open Questions silenciosas"
107
+ Assumir respostas para perguntas não respondidas. Sempre use `⚠️ ABERTO:` e resolva antes de implementar.
108
+
109
+ ---
110
+
111
+ ## Vocabulário do SDD
112
+
113
+ | Termo | Definição |
114
+ |-------|-----------|
115
+ | **Spec** | Documento que descreve o comportamento esperado de uma feature |
116
+ | **RF** | Requisito Funcional — o que o sistema deve fazer |
117
+ | **RNF** | Requisito Não-Funcional — como o sistema deve se comportar (performance, segurança...) |
118
+ | **Goal** | Objetivo que a feature deve atingir |
119
+ | **Non-Goal** | O que está explicitamente fora do escopo |
120
+ | **Edge Case** | Caso limite ou não-óbvio que o sistema deve tratar corretamente |
121
+ | **Happy Path** | O fluxo principal e mais comum de uso |
122
+ | **Critério de Aceite** | Condição verificável que define quando um requisito está implementado |
123
+ | **Open Question** | Dúvida não resolvida que pode impactar o design |
124
+ | **Decision Log** | Registro de decisões importantes e o porquê foram tomadas |
@@ -0,0 +1,231 @@
1
+ # Spec Template — RFC Pragmático
2
+
3
+ > Instruções de uso: substitua todo texto entre `[colchetes]` pelo conteúdo real.
4
+ > Remova as instruções em itálico ao finalizar.
5
+ > Marque itens em aberto com `⚠️ ABERTO:` para não esquecer de resolver.
6
+
7
+ ---
8
+
9
+ # Spec: [Nome da Feature]
10
+
11
+ **Versão:** 1.0
12
+ **Status:** Rascunho | Em Revisão | Aprovada | Implementada
13
+ **Autor:** [Nome]
14
+ **Data:** [YYYY-MM-DD]
15
+ **Reviewers:** [Nomes ou "N/A"]
16
+
17
+ ---
18
+
19
+ ## 1. Resumo
20
+
21
+ > *1–3 frases. O que é essa feature e por que ela existe? Leia isso e já entenda o objetivo.*
22
+
23
+ [Descrição concisa da feature e seu propósito.]
24
+
25
+ ---
26
+
27
+ ## 2. Contexto e Motivação
28
+
29
+ > *Por que estamos construindo isso agora? Qual problema ou oportunidade motivou a decisão?*
30
+
31
+ **Problema:**
32
+ [Descreva o problema que existe hoje. Seja específico — inclua exemplos reais se possível.]
33
+
34
+ **Evidências:**
35
+ [Dados, feedbacks, métricas ou observações que justificam a prioridade.]
36
+
37
+ **Por que agora:**
38
+ [O que mudou que torna isso urgente ou oportuno.]
39
+
40
+ ---
41
+
42
+ ## 3. Goals (Objetivos)
43
+
44
+ > *O que essa feature precisa entregar para ser considerada um sucesso?*
45
+ > *Cada goal deve ser verificável — se você não consegue medir, reformule.*
46
+
47
+ - [ ] G-01: [Objetivo 1]
48
+ - [ ] G-02: [Objetivo 2]
49
+ - [ ] G-03: [Objetivo 3]
50
+
51
+ **Métricas de sucesso:**
52
+ | Métrica | Baseline atual | Target | Prazo |
53
+ |---------|---------------|--------|-------|
54
+ | [Ex: Taxa de conversão] | [X%] | [Y%] | [data] |
55
+
56
+ ---
57
+
58
+ ## 4. Non-Goals (Fora do Escopo)
59
+
60
+ > *Explícito é melhor que implícito. Diga o que NÃO vai ser feito nessa versão.*
61
+ > *Isso previne scope creep e alinha expectativas.*
62
+
63
+ - NG-01: [O que não será feito]
64
+ - NG-02: [O que não será feito]
65
+ - NG-03: [Versões futuras podem incluir X, mas não agora]
66
+
67
+ ---
68
+
69
+ ## 5. Usuários e Personas
70
+
71
+ > *Quem vai usar isso? Qual o contexto deles?*
72
+
73
+ **Usuário primário:** [Descrição — ex: "Usuário logado com plano Pro, familiarizado com a plataforma"]
74
+ **Usuário secundário:** [Se houver — ex: "Admin que configura as permissões"]
75
+
76
+ **Jornada atual (sem a feature):**
77
+ [Descreva em 2–4 passos o que o usuário faz hoje para resolver o mesmo problema, ou por que não consegue.]
78
+
79
+ **Jornada futura (com a feature):**
80
+ [Descreva em 2–4 passos o que o usuário fará com a feature pronta.]
81
+
82
+ ---
83
+
84
+ ## 6. Requisitos Funcionais
85
+
86
+ > *O coração da spec. Cada requisito deve ser: atômico, testável e sem ambiguidade.*
87
+ > *Formato: RF-XX — [O sistema / usuário] deve [verbo concreto] [complemento].*
88
+
89
+ ### 6.1 Requisitos Principais
90
+
91
+ | ID | Requisito | Prioridade | Critério de Aceite |
92
+ |----|-----------|-----------|-------------------|
93
+ | RF-01 | [O sistema deve...] | Must | [Como testar que isso está funcionando] |
94
+ | RF-02 | [O usuário deve poder...] | Must | [Condição verificável] |
95
+ | RF-03 | [O sistema deve...] | Should | [Condição verificável] |
96
+ | RF-04 | [O sistema deve...] | Could | [Condição verificável] |
97
+
98
+ > Prioridades: **Must** (obrigatório no MVP) / **Should** (importante, mas negociável) / **Could** (nice-to-have)
99
+
100
+ ### 6.2 Fluxo Principal (Happy Path)
101
+
102
+ > *Descreva o fluxo mais comum, passo a passo.*
103
+
104
+ 1. O usuário [ação 1]
105
+ 2. O sistema [resposta 1]
106
+ 3. O usuário [ação 2]
107
+ 4. O sistema [resposta 2]
108
+ 5. Resultado: [estado final]
109
+
110
+ ### 6.3 Fluxos Alternativos
111
+
112
+ > *Variações do fluxo principal que também devem funcionar.*
113
+
114
+ **Fluxo Alternativo A — [Nome]:**
115
+ 1. [Passo divergente do fluxo principal]
116
+ 2. [Comportamento específico]
117
+
118
+ ---
119
+
120
+ ## 7. Requisitos Não-Funcionais
121
+
122
+ | ID | Requisito | Valor alvo | Observação |
123
+ |----|-----------|-----------|------------|
124
+ | RNF-01 | Performance | [ex: P95 < 300ms] | [contexto] |
125
+ | RNF-02 | Disponibilidade | [ex: 99,9% uptime] | [contexto] |
126
+ | RNF-03 | Segurança | [ex: autenticação obrigatória] | [contexto] |
127
+ | RNF-04 | Acessibilidade | [ex: WCAG 2.1 AA] | [contexto] |
128
+
129
+ ---
130
+
131
+ ## 8. Design e Interface
132
+
133
+ > *Descreva o comportamento da UI/UX, não o visual. Wireframes podem ser referenciados.*
134
+
135
+ **Componentes afetados:** [Lista de telas, componentes ou endpoints tocados]
136
+
137
+ **Comportamento esperado:**
138
+ [Descreva o que o usuário vê e como os elementos respondem às ações.]
139
+
140
+ **Estados da UI:**
141
+ - Estado vazio: [o que mostrar quando não há dados]
142
+ - Estado de carregamento: [o que mostrar enquanto processa]
143
+ - Estado de erro: [o que mostrar em caso de falha]
144
+ - Estado de sucesso: [o que mostrar após completar]
145
+
146
+ ---
147
+
148
+ ## 9. Modelo de Dados
149
+
150
+ > *Apenas se a feature cria ou modifica dados persistidos.*
151
+
152
+ **Entidades novas ou modificadas:**
153
+
154
+ ```
155
+ [NomeEntidade] {
156
+ campo_1: tipo // descrição
157
+ campo_2: tipo // descrição
158
+ }
159
+ ```
160
+
161
+ **Migrações necessárias:** [Sim / Não — se sim, descreva o impacto]
162
+
163
+ ---
164
+
165
+ ## 10. Integrações e Dependências
166
+
167
+ | Dependência | Tipo | Impacto se indisponível |
168
+ |-------------|------|------------------------|
169
+ | [API externa / Serviço / Biblioteca] | [Obrigatória / Opcional] | [Comportamento de fallback] |
170
+
171
+ ---
172
+
173
+ ## 11. Edge Cases e Tratamento de Erros
174
+
175
+ > *Esta seção é onde specs costumam falhar. Pense nos casos difíceis.*
176
+
177
+ | Cenário | Trigger | Comportamento esperado |
178
+ |---------|---------|----------------------|
179
+ | EC-01: [Nome do edge case] | [O que causa esse cenário] | [O que o sistema deve fazer] |
180
+ | EC-02: [Input inválido] | [Condição] | [Mensagem de erro / fallback] |
181
+ | EC-03: [Timeout / falha externa] | [Condição] | [Retry / degradação / erro claro] |
182
+ | EC-04: [Limite de rate/quota atingido] | [Condição] | [Comportamento] |
183
+
184
+ ---
185
+
186
+ ## 12. Segurança e Privacidade
187
+
188
+ - **Autenticação:** [Quem pode acessar essa feature?]
189
+ - **Autorização:** [Quais permissões são necessárias?]
190
+ - **Dados sensíveis:** [A feature processa PII, dados financeiros ou confidenciais? Como são protegidos?]
191
+ - **Auditoria:** [É necessário log de auditoria? O quê deve ser logado?]
192
+
193
+ ---
194
+
195
+ ## 13. Plano de Rollout
196
+
197
+ - **Estratégia:** [Big bang / Feature flag / Rollout gradual / Canário]
198
+ - **Como reverter (rollback):** [Passos para desfazer se algo der errado]
199
+ - **Monitoramento pós-deploy:** [O que observar nas primeiras 24–48h]
200
+
201
+ ---
202
+
203
+ ## 14. Open Questions
204
+
205
+ > *Dúvidas ainda não resolvidas que podem impactar o design. Cada item deve ter um dono e prazo.*
206
+
207
+ | # | Pergunta | Impacto | Dono | Prazo |
208
+ |---|---------|---------|------|-------|
209
+ | OQ-01 | [Pergunta em aberto] | [Alto/Médio/Baixo] | [Nome] | [data] |
210
+
211
+ ---
212
+
213
+ ## 15. Decisões Tomadas (Decision Log)
214
+
215
+ > *Registre decisões importantes e o racional — útil para futuras revisões.*
216
+
217
+ | Decisão | Alternativas consideradas | Racional |
218
+ |---------|--------------------------|---------|
219
+ | [O que foi decidido] | [O que foi descartado] | [Por que essa opção] |
220
+
221
+ ---
222
+
223
+ ## Apêndice
224
+
225
+ ### Referências
226
+ - [Links para docs, tickets, designs, pesquisas relacionadas]
227
+
228
+ ### Histórico de Revisões
229
+ | Versão | Data | Autor | Mudanças |
230
+ |--------|------|-------|---------|
231
+ | 1.0 | [data] | [autor] | Criação inicial |