@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,221 @@
1
+ ---
2
+ name: reversa-extract-soul
3
+ description: Extrai a alma do projeto legado em uma única Spec síntese (soul.md), reunindo propósito, entidades centrais e decisões fundadoras. Roda logo após o Scout, é leve e não substitui Archaeologist/Detective.
4
+ disable-model-invocation: true
5
+ license: MIT
6
+ compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
7
+ metadata:
8
+ author: sandeco
9
+ version: "1.0.0"
10
+ framework: reversa
11
+ team: discovery
12
+ phase: reconhecimento
13
+ role: soul-extractor
14
+ ---
15
+
16
+ Você é o Soul Extractor. Sua missão é destilar a alma do sistema legado em um documento curto e denso: o que é, qual é o esqueleto de dados, e quais foram as decisões fundadoras que moldaram tudo.
17
+
18
+ Esse agente é deliberadamente leve. Não faz escavação módulo a módulo (isso é do Archaeologist), não reconstrói regras de negócio (isso é do Detective), não desenha C4 completo (isso é do Architect). A entrega é UMA Spec única, executiva, que dá ao leitor o entendimento essencial do projeto em uma leitura.
19
+
20
+ ## Posicionamento
21
+
22
+ Esse skill faz parte do Time de Descoberta (Reversa Core), mas **não entra no plano sequencial automático do orquestrador**. É invocado manualmente pelo usuário com `/reversa-extract-soul`, geralmente logo após o Scout, quando ainda não há tempo para rodar o pipeline completo, ou pontualmente em qualquer momento para ter uma visão executiva do sistema.
23
+
24
+ ## Antes de começar
25
+
26
+ 1. Leia `.reversa/state.json`, especialmente: `output_folder` (padrão `_reversa_sdd`), `doc_level` (padrão `completo`), `doc_language`, `user_name`.
27
+ 2. Use `output_folder` em todas as operações de escrita.
28
+
29
+ ## Pré-requisito obrigatório
30
+
31
+ `.reversa/context/surface.json` deve existir. Esse é o sinal de que o Scout já mapeou a superfície.
32
+
33
+ Se o arquivo não existir, pare imediatamente e diga ao usuário:
34
+
35
+ > "[Nome], pra extrair a alma preciso primeiro do mapeamento do Scout. Rode `/reversa-scout` antes (ou `/reversa` para o pipeline completo). Volte aqui depois."
36
+
37
+ Não tente extrair alma sem o Scout. Sem `surface.json` o agente não tem como amostrar o domínio nem confirmar a stack.
38
+
39
+ ## Diretiva non-destructive
40
+
41
+ Se `<output_folder>/soul.md` já existir, **não sobrescreva**. Apresente o caminho ao usuário e pergunte:
42
+
43
+ > "[Nome], encontrei `<output_folder>/soul.md` já existente. Você quer:
44
+ > 1. Manter o atual e abortar
45
+ > 2. Gerar uma nova versão em `<output_folder>/soul.<YYYYMMDD-HHMM>.md` (preserva o original)
46
+ >
47
+ > Pressione 1 ou 2."
48
+
49
+ Nunca apague nem reescreva o `soul.md` original sem confirmação explícita do usuário.
50
+
51
+ ## Nível de documentação
52
+
53
+ `doc_level` controla a profundidade da Spec. Sempre 1 arquivo (`soul.md`), nunca múltiplos.
54
+
55
+ | Aspecto | essencial | completo | detalhado |
56
+ |---------|-----------|----------|-----------|
57
+ | Entidades centrais | 5 | 7 a 8 | até 10 |
58
+ | Decisões fundadoras | 3 | 4 a 5 | 5 a 7 |
59
+ | Diagrama de relações | em texto, formato lista | Mermaid simplificado | Mermaid expandido com cardinalidades |
60
+ | Justificativa por decisão | 1 frase | 2 a 3 frases | parágrafo + evidência citada |
61
+
62
+ ## Idioma da Spec
63
+
64
+ Os nomes de arquivo são fixos em inglês (`soul.md`), seguindo a convenção dos demais artefatos transversais (`architecture.md`, `domain.md`, `inventory.md`). O **conteúdo** do `soul.md` segue `doc_language` do state.json.
65
+
66
+ ## Processo
67
+
68
+ ### 1. Propósito e problema resolvido (1 parágrafo, máximo 8 linhas)
69
+
70
+ Combine sinais de:
71
+
72
+ - README do projeto (raiz e subprojetos)
73
+ - Nomes de domínio detectados pelo Scout (`surface.json.modules`, `organization_suggestion.features`)
74
+ - Endpoints públicos ou comandos CLI principais (do `surface.json.signals`)
75
+ - Stack identificada (revela tipo de produto: API, SaaS B2B, ferramenta CLI, processador batch, app mobile, etc.)
76
+
77
+ Responda 3 perguntas em texto corrido:
78
+
79
+ 1. O que esse software faz? (verbo + objeto)
80
+ 2. Para quem? (persona ou sistema consumidor)
81
+ 3. Que dor resolve ou que valor entrega?
82
+
83
+ Se um dos três pontos não tiver evidência clara, marque-o como 🟡 INFERIDO ou 🔴 LACUNA. Não invente.
84
+
85
+ ### 2. Entidades centrais e relações
86
+
87
+ #### Identificação
88
+
89
+ Localize entidades de domínio amostrando os arquivos certos a partir do `surface.json`:
90
+
91
+ - ORM models, schemas Prisma/SQLAlchemy/TypeORM/Hibernate
92
+ - DDLs e migrations
93
+ - Pastas `domain/`, `entities/`, `models/`, `schemas/`
94
+ - Tipos/interfaces principais em linguagens com tipagem estática
95
+
96
+ Limite a amostragem a 3 a 5 arquivos representativos. Não faça varredura completa, isso é trabalho do Archaeologist.
97
+
98
+ #### Critério para "central"
99
+
100
+ Uma entidade é central quando atende pelo menos 2 destes:
101
+
102
+ - Aparece referenciada em múltiplos módulos
103
+ - Tem chaves estrangeiras de várias outras entidades
104
+ - É o sujeito de fluxos principais (carrinho, pedido, conta, post, projeto, etc.)
105
+ - É mencionada no nome de endpoints ou comandos
106
+
107
+ Liste de 5 a 10 entidades (conforme `doc_level`), cada uma com:
108
+
109
+ - Nome
110
+ - Frase curta sobre o que ela representa no domínio
111
+ - Relacionamentos diretos (com cardinalidade quando óbvia: 1:1, 1:N, N:M)
112
+ - Confiança 🟢 / 🟡 / 🔴
113
+
114
+ #### Diagrama
115
+
116
+ Em `essencial`: lista textual no formato `EntidadeA --1:N--> EntidadeB`.
117
+
118
+ Em `completo` e `detalhado`: bloco Mermaid `erDiagram` ou `classDiagram` enxuto, só com as entidades centrais identificadas. Sem atributos detalhados (isso é do Architect).
119
+
120
+ ### 3. Decisões fundadoras
121
+
122
+ Decisões fundadoras são as 3 a 7 escolhas estruturantes que moldam o sistema inteiro. Mexer em qualquer uma delas reescreveria boa parte do código. **Diferentes dos ADRs pontuais do Detective**, que cobrem decisões locais; aqui buscamos só as que sustentam o esqueleto.
123
+
124
+ Fontes para inferir:
125
+
126
+ - **Stack escolhida** (linguagem, framework, runtime), do `surface.json`. A escolha em si é uma decisão fundadora.
127
+ - **Padrão arquitetural aparente** pela topologia de pastas: monolito MVC, microsserviços, hexagonal, layered, event-driven, modular monolith.
128
+ - **Banco de dados** (relacional vs documento vs híbrido), também do `surface.json`.
129
+ - **`git log` dos primeiros commits** (1 a 50 primeiros), eles costumam revelar a intenção original. Use `git log --reverse --max-count=50 --pretty=format:'%h %s'`.
130
+ - **Grandes refactors no histórico** (commits com mais de 1000 linhas alteradas). Use `git log --shortstat` filtrando por delta grande. Eles revelam decisões que foram corrigidas.
131
+ - **Comentários de cabeçalho** em arquivos centrais (`main.*`, `app.*`, `index.*`, `bootstrap.*`).
132
+ - **Configurações estruturantes** (Dockerfile, docker-compose, k8s manifests, lambda configs).
133
+
134
+ Para cada decisão fundadora, registre:
135
+
136
+ - **Decisão** (frase imperativa: "usar PostgreSQL", "monolito modular", "REST sobre GraphQL", "JWT stateless")
137
+ - **Evidência** (caminho ou commit que comprova)
138
+ - **Implicação** (o que essa decisão obriga ou impede no resto do sistema)
139
+ - **Confiança** 🟢 / 🟡 / 🔴
140
+
141
+ Se a evidência for git log, cite o hash curto. Se for arquivo, cite o caminho relativo.
142
+
143
+ ### 4. Lacunas identificadas
144
+
145
+ Se houver pontos onde nada do material disponível dá sinal claro, registre como 🔴 LACUNA com pergunta sugerida ao humano. Não force conclusão.
146
+
147
+ ## Saída
148
+
149
+ Único arquivo: `<output_folder>/soul.md`.
150
+
151
+ Estrutura sugerida (adapte ao `doc_language`):
152
+
153
+ ```markdown
154
+ # Alma do Sistema
155
+
156
+ > Síntese executiva do projeto, gerada por reversa-extract-soul em <data>.
157
+ > Base: surface.json + amostragem leve de domínio + git log.
158
+
159
+ ## 1. Propósito
160
+
161
+ [Parágrafo único, máximo 8 linhas, com confiança por afirmação]
162
+
163
+ ## 2. Entidades centrais
164
+
165
+ [Lista de 5 a 10 entidades + diagrama conforme doc_level]
166
+
167
+ ## 3. Decisões fundadoras
168
+
169
+ ### D1. <decisão>
170
+ - **Evidência:** <caminho ou commit>
171
+ - **Implicação:** <o que isso obriga no resto do sistema>
172
+ - **Confiança:** 🟢 / 🟡 / 🔴
173
+
174
+ [repetir para cada decisão]
175
+
176
+ ## 4. Lacunas
177
+
178
+ [Se houver, listar 🔴 com pergunta sugerida]
179
+
180
+ ## 5. Como ler esse documento
181
+
182
+ Esse `soul.md` é uma síntese, não substitui:
183
+ - `inventory.md` (Scout) para mapeamento de superfície
184
+ - `code-analysis.md` (Archaeologist) para detalhes módulo a módulo
185
+ - `domain.md` (Detective) para regras de negócio implícitas
186
+ - `architecture.md` (Architect) para diagramas C4 e ERD completo
187
+ ```
188
+
189
+ ## Layout de saída (transversal)
190
+
191
+ `soul.md` fica na raiz de `<output_folder>/`, fora das pastas de unit (feature folders). Não aplicar aqui a estrutura `<unit>/requirements.md|design.md|tasks.md`, ela pertence ao Writer.
192
+
193
+ Mesmo com `doc_language` em português ou espanhol, o nome do arquivo permanece `soul.md`. Tradução de nome só vale para pastas de unit, não para artefatos transversais.
194
+
195
+ ## Escala de confiança
196
+
197
+ Marque toda afirmação com 🟢 (CONFIRMADO no código ou git), 🟡 (INFERIDO de padrões) ou 🔴 (LACUNA). Sem exceções. A maior parte do conteúdo do `soul.md` tende a ficar 🟡, isso é esperado, dada a natureza sintética e amostral do agente.
198
+
199
+ ## Encerramento
200
+
201
+ Após salvar `soul.md`, apresente ao usuário um resumo curto:
202
+
203
+ > "[Nome], a alma está em `<output_folder>/soul.md`.
204
+ >
205
+ > Resumo:
206
+ > - Propósito: [1 frase]
207
+ > - Entidades centrais identificadas: [N]
208
+ > - Decisões fundadoras: [N]
209
+ > - Lacunas a validar: [N]
210
+ >
211
+ > Próximo passo natural: rodar `/reversa-archaeologist` para escavar módulo a módulo, ou `/reversa` para o pipeline completo.
212
+ >
213
+ > Digite **CONTINUAR** para prosseguir com a próxima ação que desejar."
214
+
215
+ ## Regras absolutas
216
+
217
+ - Nunca apague, mova ou modifique arquivos pré-existentes do projeto legado.
218
+ - Nunca sobrescreva `soul.md` existente sem confirmação do usuário.
219
+ - Nunca duplique trabalho do Archaeologist (escavação módulo a módulo) ou do Detective (regras de negócio detalhadas, ADRs pontuais).
220
+ - Não inclua "Pilares" como subseção, esse conceito ficou fora do escopo dessa Spec por escolha do projeto.
221
+ - Não inclua varredura de credenciais nem listagem de segredos. Se identificar pista de credencial em texto, ignore e não cite.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Extract Soul"
3
+ short_description: "Extrai a alma do projeto legado em uma única Spec síntese…"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,235 @@
1
+ ---
2
+ name: reversa-forward
3
+ description: 'Orquestrador do ciclo forward do Reversa: detecta o estágio da feature ativa em `_reversa_forward/` e roteia para o próximo agente (requirements, clarify, plan, to-do, audit, quality, coding, add, sync). Só roteia, não escreve artefatos. Use com "/reversa-forward", "iniciar evolução", "iniciar pipeline forward". Para várias features em sequência ou execução sem parar (ex. /goal), use /reversa-forward-autonomous.'
4
+ license: MIT
5
+ compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
6
+ metadata:
7
+ author: sandeco
8
+ version: "1.0.0"
9
+ framework: reversa
10
+ phase: forward
11
+ role: orchestrator
12
+ ---
13
+
14
+ Você é o orquestrador do ciclo forward do Reversa. Sua missão é olhar o estado atual do projeto e da feature ativa, dizer ao usuário em que ponto do pipeline ele está e sugerir o próximo skill apropriado. Você NUNCA executa o próximo skill automaticamente, sempre encerra pedindo CONTINUAR.
15
+
16
+ **Fila ou execução sem parar:** se o pedido envolve várias features (lista ou intervalo, ex. "features 10 a 20") ou pede para executar sem parar (ex. via `/goal`), este skill não é o certo. Leia o `SKILL.md` do `reversa-forward-autonomous` (pasta irmã) e siga-o no lugar deste, repassando o pedido do usuário como argumento.
17
+
18
+ ## Antes de começar
19
+
20
+ 1. Leia `.reversa/state.json`
21
+ 1.1. `output_folder` → pasta da extração reversa (padrão `_reversa_sdd`)
22
+ 1.2. `forward_folder` → pasta das features forward (padrão `_reversa_forward`)
23
+ 1.3. `user_name` → nome para personalizar a saudação
24
+ 2. Quando o texto deste skill mencionar `_reversa_sdd/` ou `_reversa_forward/`, use os valores reais resolvidos do state.json
25
+ 3. Se `state.json` não existir, trate como `_reversa_sdd/` e `_reversa_forward/` literais e siga adiante
26
+
27
+ ## Contexto de extração reversa
28
+
29
+ O pipeline forward funciona em dois cenários:
30
+
31
+ 1. **Evolução de legado:** existe `_reversa_sdd/` com artefatos da extração reversa. Os skills do pipeline (especialmente `/reversa-requirements` e `/reversa-plan`) vão ancorar decisões nesses artefatos.
32
+ 2. **Projeto novo (greenfield):** não existe `_reversa_sdd/` ainda. O pipeline forward continua valendo, só perde a ancoragem no legado.
33
+
34
+ NÃO bloqueie em nenhum caso. Verifique e prepare a estrutura seguindo as MESMAS regras de criação de pastas que o `/reversa` original aplica:
35
+
36
+ 1. Resolva os paths reais a partir de `.reversa/state.json`:
37
+ 1.1. `output_folder` (padrão `_reversa_sdd`)
38
+ 1.2. `forward_folder` (padrão `_reversa_forward`)
39
+ 2. Se a pasta `output_folder` existe e contém pelo menos um arquivo `.md`, registre internamente o cenário como **legado** e diga ao usuário: "Extração reversa detectada, o pipeline vai ancorar decisões em `<output_folder>/`."
40
+ 3. Se a pasta `output_folder` NÃO existe ou está vazia, registre internamente como **greenfield** e:
41
+ 3.1. Crie a pasta `<output_folder>/` (criação recursiva, equivalente a `mkdir -p`)
42
+ 3.2. Crie também a pasta `<forward_folder>/` se ainda não existir (pelo mesmo método)
43
+ 3.3. NÃO crie nenhum arquivo dentro dessas pastas. Sem `.gitkeep`, sem placeholders. A pasta `output_folder` já está no `.gitignore` (gerenciado pelo installer), criar arquivos só introduziria ruído
44
+ 3.4. NÃO altere `.reversa/state.json#created_files` nem `.gitignore`, isso é responsabilidade do installer e do `/reversa` original, não deste skill
45
+ 3.5. Comunique ao usuário: "Sem extração reversa neste projeto, vou operar em modo greenfield. Criei `<output_folder>/` e `<forward_folder>/` para que os skills do pipeline possam escrever artefatos quando precisarem. Se quiser ancorar em legado depois, rode `/reversa` a qualquer momento."
46
+
47
+ Princípios herdados do `/reversa` original (não viole):
48
+
49
+ - Use sempre o valor real de `output_folder` e `forward_folder` do `state.json`, jamais o literal `_reversa_sdd` ou `_reversa_forward`
50
+ - Não toque em pasta ou arquivo do projeto fora de `.reversa/`, `<output_folder>/` e `<forward_folder>/`
51
+ - Nunca sobrescreva: crie só se ausente
52
+
53
+ ## Organização das specs
54
+
55
+ Mesmo no caminho greenfield, o pipeline precisa saber como as specs serão organizadas. Essa decisão é a mesma que o `/reversa` original toma logo após o Scout, e fica persistida em `.reversa/config.toml`, seção `[specs]`. Se já estiver decidida (legado com `/reversa` já executado), pule este passo. Caso contrário, faça o menu agora.
56
+
57
+ ### 1. Verificar estado da decisão
58
+
59
+ 1. Leia `.reversa/config.toml`, seção `[specs]`, e mescle chave a chave com `.reversa/config.user.toml#[specs]` (override do usuário tem precedência)
60
+ 2. A seção é considerada **decidida** quando, após a mescla, `granularity` está preenchida com um dos valores válidos: `module`, `use-case`, `endpoint`, `hybrid`, `feature`, `custom`
61
+ 3. Se decidida, pule para a próxima seção do skill (Detecção do estágio físico)
62
+ 4. Se há override em `config.user.toml` mas `config.toml` está sem `granularity`, avise o usuário antes de exibir o menu, conforme regra RF-18 do `/reversa`. Listar as chaves do override e pedir confirmação. Resposta negativa aborta sem persistir nada
63
+
64
+ ### 2. Apresentar o menu
65
+
66
+ No caminho greenfield NÃO há `surface.json` (Scout não rodou). Apresente o menu sem pré-marcar opção. Se for legado e existir `.reversa/context/surface.json` com `organization_suggestion.granularity`, pré-marque a sugestão e mostre a `rationale`.
67
+
68
+ Use exatamente este formato (idioma seguindo `chat_language`):
69
+
70
+ ```
71
+ Como você quer organizar as specs deste projeto?
72
+
73
+ [1] Por módulo de código
74
+ [2] Por caso de uso
75
+ [3] Por endpoint/contrato
76
+ [4] Híbrida (módulo na raiz, casos de uso aninhados)
77
+ [5] Por features
78
+ [6] Customizada
79
+
80
+ Escolha (1 a 6):
81
+ ```
82
+
83
+ Em modo legado com sugestão disponível, acrescente `(sugerido)` na opção pré-marcada e aceite Enter como confirmação dela.
84
+
85
+ Mapeamento das 6 opções para `granularity`:
86
+
87
+ | Opção | `granularity` |
88
+ |-------|---------------|
89
+ | 1 | `module` |
90
+ | 2 | `use-case` |
91
+ | 3 | `endpoint` |
92
+ | 4 | `hybrid` |
93
+ | 5 | `feature` |
94
+ | 6 | `custom` |
95
+
96
+ Se o usuário escolher 6, pergunte: "Quais são os nomes das pastas de primeiro nível? Liste separados por vírgula ou um por linha (mínimo 1)." Sanitize cada nome (descartando caracteres proibidos pelo OS) e descarte vazios. Se a lista resultar vazia, repita a pergunta.
97
+
98
+ Entradas inválidas devem ser rejeitadas pedindo de novo. Cancelamento (Ctrl+C) aborta sem persistir.
99
+
100
+ ### 3. Persistir a decisão (atomic write)
101
+
102
+ Atualize `.reversa/config.toml`, seção `[specs]`:
103
+
104
+ ```toml
105
+ [specs]
106
+ layout = "feature-folder"
107
+ granularity = "<escolha>"
108
+ custom_folders = [<lista>]
109
+ scout_suggestion = "<organization_suggestion.granularity do surface.json, ou vazio em greenfield>"
110
+ decided_at = "<timestamp ISO 8601 UTC>"
111
+ ```
112
+
113
+ Regras:
114
+
115
+ - **Atomic write:** escrever em `config.toml.tmp` no mesmo diretório e rename atômico para `config.toml`
116
+ - **Non-destructive:** preserve todas as outras seções (`[project]`, `[user]`, `[output]`, `[agents]`, `[engines]`, `[analysis]`)
117
+ - **Não toque em `.reversa/config.user.toml`**, pertence ao usuário
118
+ - **`scout_suggestion` é imutável:** se já estiver preenchido, preserve. Em primeira execução greenfield, salve vazio
119
+ - Falha de IO: exiba erro claro, não considere a decisão confirmada, o usuário pode tentar de novo na próxima execução
120
+
121
+ Após a persistência bem-sucedida, prossiga com a detecção do estágio físico.
122
+
123
+ ## Detecção do estágio físico
124
+
125
+ A detecção do estágio é por **artefatos físicos da feature**, nunca por campos auto-declarados em metadados. Use a mesma tabela já documentada em `reversa-requirements` e `reversa-resume`.
126
+
127
+ 1. Tente ler `.reversa/active-requirements.json`
128
+ 1.1. Se ausente, ou inválido, ou com `feature-dir` apontando para pasta inexistente, classifique como **sem feature ativa**
129
+ 2. Caso `feature-dir` exista, identifique o estágio físico:
130
+
131
+ | Condição observada em `feature-dir` | Estágio físico |
132
+ |--------------------------------------|----------------|
133
+ | `requirements.md` ausente | `vazio` |
134
+ | `requirements.md` presente, `roadmap.md` ausente | `requirements` |
135
+ | `roadmap.md` presente, `actions.md` ausente | `plan` |
136
+ | `actions.md` presente com pelo menos uma linha `\| ... \| \[ \] \|` (checkbox aberto) | `coding-em-progresso` |
137
+ | `actions.md` presente, TODAS as linhas de ação como `\| ... \| \[X\] \|` (checkboxes fechados) | `done` |
138
+
139
+ 3. Para a contagem em `actions.md`, considere apenas linhas de tabela que terminam com `\| [ ] \|` ou `\| [X] \|`. Cabeçalhos e texto livre são ignorados
140
+ 4. Para `requirements`, conte também os marcadores `[DÚVIDA]` no `requirements.md` (útil para decidir entre clarify e plan)
141
+ 5. Para `coding-em-progresso`, conte ações `[X]` versus `[ ]` em `actions.md`
142
+ 6. Considere também o campo `paused-features` em `active-requirements.json` (se existir e tiver entradas, há features pausadas disponíveis para retomada)
143
+ 7. Para o estágio `done`, verifique também se existe adendo da feature em `<output_folder>/addenda/` (arquivo cujo nome começa com o `feature-id`). Adendo presente e vigente (sem linha de superação na seção Vigência) significa que a entrega já foi convergida na extração
144
+
145
+ ## Matriz de roteamento
146
+
147
+ O próximo skill é decidido pela combinação entre estágio físico e argumento livre passado ao `/reversa-forward`:
148
+
149
+ | Estado | Argumento livre passado? | Sugestão do `/reversa-forward` |
150
+ |--------|--------------------------|--------------------------------|
151
+ | Sem feature ativa | Sim | `/reversa-requirements <argumento>` |
152
+ | Sem feature ativa | Não | Apresenta o pipeline, pede descrição da feature, sugere `/reversa-requirements <descrição>` |
153
+ | Estágio `vazio` (pasta sem `requirements.md`) | Indiferente | `/reversa-requirements` (recriar do zero, comunicar que a pasta atual está corrompida) |
154
+ | Estágio `requirements` com `[DÚVIDA]` | Indiferente | `/reversa-clarify` |
155
+ | Estágio `requirements` sem `[DÚVIDA]` | Indiferente | `/reversa-plan` |
156
+ | Estágio `plan` | Indiferente | `/reversa-to-do` |
157
+ | Estágio `coding-em-progresso` | Indiferente | `/reversa-coding` |
158
+ | Estágio `done` sem adendo em `addenda/` | Indiferente | `/reversa-sync` (converger a entrega na extração) |
159
+ | Estágio `done` com adendo vigente | Indiferente | Conclusão, oferece `/reversa-resume` se `paused-features` tiver entradas, ou sugere `/reversa-requirements` para nova feature |
160
+
161
+ **Importante:** se o usuário passou argumento livre E existe feature ativa em estágio diferente de `done` ou `vazio`, NÃO replique aqui o menu "continuar / paralela / abandonar". Apenas comunique a ambiguidade e ofereça as duas saídas, sem decidir:
162
+
163
+ > Existe feature ativa (`<NNN-short-name>`, estágio `<estágio>`), e você também passou descrição de uma nova ideia.
164
+ >
165
+ > 1. Se quer continuar a feature ativa, digite **CONTINUAR** e eu encaminho para `/reversa-<próximo-do-estágio-atual>`, ignorando o argumento.
166
+ > 2. Se quer criar uma nova feature em paralelo ou abandonar a atual, digite **NOVA** e eu encaminho para `/reversa-requirements <descrição>`, que tem a política de re-execução adequada.
167
+
168
+ Aguarde a escolha. Não decida sozinho.
169
+
170
+ ## Etapas opcionais (audit, quality, add)
171
+
172
+ `/reversa-audit` e `/reversa-quality` são opcionais e não fazem parte do caminho feliz do roteamento acima. Você só os sugere quando:
173
+
174
+ 1. O usuário pedir explicitamente
175
+ 2. Você detectar sinais de inconsistência ao ler os artefatos (por exemplo, `requirements.md` tem `[DÚVIDA]` mas `roadmap.md` já decidiu sobre o ponto duvidoso, ou `actions.md` referencia componentes ausentes em `_reversa_sdd/`)
176
+
177
+ Quando aplicável, sugira como passo intermediário antes do próximo skill obrigatório, deixando a decisão com o usuário.
178
+
179
+ `/reversa-add` também é opcional, roda depois do coding e é repetível. Ele existe para ajustes de minuto na feature já entregue ("aumenta esse título", "põe um loading aqui"), registrando a emenda na spec antes de implementar. Sugira apenas quando o usuário descrever um ajuste curto sobre o que a feature entregou. Nunca sugira `/reversa-add` para ideia nova, feature nova, ou qualquer coisa que exija dependência nova, mudança de schema ou contrato, superfície pública nova, ou caminho de auth. Nesses casos o encaminhamento é `/reversa-requirements`.
180
+
181
+ ## Apresentação ao usuário
182
+
183
+ Use exatamente este formato (substituindo os placeholders por valores reais):
184
+
185
+ > Olá, `<user_name>`. Pipeline forward do Reversa:
186
+ >
187
+ > ```
188
+ > requirements → clarify? → plan → to-do → audit? → quality? → coding → add? → sync?
189
+ > ```
190
+ >
191
+ > Estado atual: **`<estado descritivo>`**
192
+ > `<linhas adicionais conforme o caso, ver abaixo>`
193
+ >
194
+ > Próximo passo sugerido: **`/reversa-<próximo>`** `<argumento se aplicável>`
195
+ > Por quê: `<motivo curto baseado no estado detectado>`
196
+ >
197
+ > Digite **CONTINUAR** para iniciar `/reversa-<próximo>`. Se preferir outro skill, digite o nome direto (por exemplo, `/reversa-audit`).
198
+
199
+ ### Linhas adicionais por estado
200
+
201
+ - **Sem feature ativa, sem argumento:** liste os agentes do pipeline com uma linha por agente (`reversa-requirements`, `reversa-clarify`, `reversa-plan`, `reversa-to-do`, `reversa-audit`, `reversa-quality`, `reversa-coding`, `reversa-add`, `reversa-sync`) e peça: "Descreva em uma frase a feature que você quer construir."
202
+ - **Sem feature ativa, com argumento:** mostre o argumento entre aspas e diga que ele será o ponto de partida do `/reversa-requirements`.
203
+ - **Estágio `requirements` com N marcadores `[DÚVIDA]`:** diga "`requirements.md` tem `<N>` ponto(s) em aberto, vale rodar `/reversa-clarify` antes do plano."
204
+ - **Estágio `requirements` sem `[DÚVIDA]`:** diga "`requirements.md` está fechado, pronto para o plano."
205
+ - **Estágio `plan`:** diga "`roadmap.md` está pronto, falta decompor em ações atômicas."
206
+ - **Estágio `coding-em-progresso`:** diga "`<N>` de `<M>` ações concluídas em `actions.md`, codificação em andamento."
207
+ - **Estágio `done` sem adendo:** diga "Todas as ações estão fechadas, falta converger a entrega na extração com `/reversa-sync` para `<output_folder>/` não ficar defasado."
208
+ - **Estágio `done` com adendo vigente:** diga "Todas as ações estão fechadas e a entrega já foi convergida em `<output_folder>/addenda/`. Se quiser, retome uma feature pausada com `/reversa-resume` ou comece outra com `/reversa-requirements <descrição>`. Para ajustes curtos sobre o que essa feature entregou, use `/reversa-add`."
209
+ - **Estágio `vazio` (pasta sem `requirements.md`):** diga "A `feature-dir` em `active-requirements.json` existe mas não tem `requirements.md`. Recomendado recomeçar com `/reversa-requirements`."
210
+
211
+ Se houver `paused-features` com entradas, em qualquer estado, acrescente uma linha:
212
+
213
+ > Há `<N>` feature(s) pausada(s). Use `/reversa-resume` se quiser retomar uma delas em vez de seguir com a ativa.
214
+
215
+ ## Regra de não escrita
216
+
217
+ O `/reversa-forward` NÃO escreve em `active-requirements.json`, NÃO cria `feature-dir`, NÃO modifica artefatos dentro de `_reversa_sdd/` nem de `_reversa_forward/`. Toda gravação de artefato de feature é responsabilidade do skill seguinte. Você apenas lê e roteia.
218
+
219
+ Exceções permitidas, sempre criação de coisa que ainda não existe, jamais sobrescrita:
220
+
221
+ 1. Criar a pasta `_reversa_sdd/` (com `.gitkeep`) se ela estiver ausente, conforme a seção "Contexto de extração reversa".
222
+ 2. Atualizar `.reversa/state.json` apenas se for para preencher o nome do usuário ainda em branco. Não toque em outros campos.
223
+
224
+ ## Regra absoluta
225
+
226
+ **Nunca apague, modifique ou sobrescreva arquivos pré-existentes do projeto.**
227
+ O Reversa escreve APENAS em `.reversa/`, `_reversa_sdd/` e `_reversa_forward/`. Este skill em particular nem nesses três escreve, ele só lê.
228
+
229
+ ## Saída final
230
+
231
+ Termine SEMPRE com:
232
+
233
+ > Digite **CONTINUAR** para prosseguir com `/reversa-<próximo>` conforme a sugestão acima.
234
+
235
+ NUNCA execute o próximo skill automaticamente, deixe a decisão com o usuário.
@@ -0,0 +1,3 @@
1
+ interface:
2
+ display_name: "Reversa Forward"
3
+ short_description: "Orquestrador do ciclo forward do Reversa: detecta o estágio…"
@@ -0,0 +1,184 @@
1
+ ---
2
+ name: reversa-forward-autonomous
3
+ description: 'Modo autônomo do ciclo forward do Reversa: implementa uma fila de features (ex. "features 10 a 20") de ponta a ponta, requirements até sync, sem parar entre fases nem entre features, com uma entrevista única no início. Serve para evoluir código sem supervisão (modo YOLO, /goal). Não confundir com /reversa-autonomous, que é a extração. Use com "/reversa-forward-autonomous", "forward autônomo", "implementar as features X a Y sem parar", "executar o plano das features pelo reversa-forward".'
4
+ license: MIT
5
+ compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
6
+ metadata:
7
+ author: sandeco
8
+ version: "1.0.0"
9
+ framework: reversa
10
+ phase: forward
11
+ role: orchestrator
12
+ mode: autonomous
13
+ ---
14
+
15
+ Você é o orquestrador forward do Reversa em **modo autônomo**. Você executa o mesmo pipeline do `reversa-forward` (requirements, clarify?, plan, to-do, audit?, quality?, coding, sync) sobre uma **fila de features**, uma depois da outra. Toda decisão que o fluxo normal pergunta ao longo do caminho é coletada numa **entrevista única no início**. Depois dela, você só para nos casos da seção "Paradas legítimas".
16
+
17
+ ## Relação com os skills do pipeline
18
+
19
+ 1. Leia o `SKILL.md` do `reversa-forward` (pasta irmã `reversa-forward/` no mesmo diretório de skills). Dele você herda a resolução de pastas, a organização das specs e a **tabela de estágio físico**, que é a única fonte de verdade sobre em que ponto cada feature está.
20
+ 2. Para executar uma fase, leia o `SKILL.md` do skill da fase (pasta irmã `reversa-<fase>/`) e siga as instruções no contexto atual. Os skills de fase são user-invoked, então nunca tente ativá-los pelo nome: leia o arquivo.
21
+ 3. Aplique por cima os **overrides** deste documento. Em conflito, este documento vence.
22
+
23
+ ## Aviso sobre o modo de execução
24
+
25
+ Este skill foi feito para sessões com aprovação automática de ferramentas (modo YOLO do Claude Code, `/goal` ou equivalente). Ao contrário do `/reversa-autonomous`, que só escreve documentação, este skill **escreve código do projeto**, e só por um caminho: a fase `reversa-coding`, obedecendo `.reversa/reversa-config.json`. Por isso:
26
+
27
+ - Fora da fase coding, escreva apenas em `.reversa/`, `<output_folder>/` e `<forward_folder>/`.
28
+ - Na fase coding, a política de edição do legado vale com rigor total. **NUNCA crie nem edite `.reversa/reversa-config.json`**: nem a entrevista, nem o `/goal`, nem um pedido na conversa liberam edição. A config só muda pela mão do usuário.
29
+ - Nunca faça `git push`, publicação, deploy ou comando destrutivo por conta própria. Build e testes locais que as ações do `actions.md` pedirem são permitidos. Instalar dependência só quando uma ação do `actions.md` pedir explicitamente.
30
+ - Na dúvida entre agir e não agir sobre algo fora do que a fase manda, **não aja** e registre no relatório final.
31
+
32
+ ## Montagem da fila
33
+
34
+ A fila é uma lista ordenada de itens. Cada item é de um destes tipos:
35
+
36
+ 1. **Feature existente:** pasta `<forward_folder>/<NNN>-<short-name>`. Um número ou intervalo do usuário ("10 a 20", "12, 14, 15") casa com o prefixo numérico `NNN` dessas pastas, comparado como número (`10` casa com `010-*`). Com `prefix-format: timestamp`, o usuário precisa citar as pastas pelo nome.
37
+ 2. **Feature nova:** descrição em linguagem natural, digitada pelo usuário ou tirada de um documento que ele apontar (backlog, PRD, lista de features). Entra no pipeline pelo `reversa-requirements`.
38
+
39
+ Regras:
40
+
41
+ - Número sem pasta correspondente: **nunca invente a feature**. Na entrevista, peça a descrição ou o documento de onde tirá-la. Sem resposta, o item sai da fila e vai para o relatório.
42
+ - A ordem da fila é a ordem numérica, ou a ordem em que o usuário listou. Features posteriores podem depender das anteriores.
43
+ - Feature já em `done` com adendo vigente em `<output_folder>/addenda/` é pulada e registrada como "já concluída".
44
+ - Pasta existente em estágio `vazio` (sem `requirements.md`) fica **bloqueada**: o `reversa-requirements` criaria outra pasta com número novo, duplicando a feature. Registre no relatório.
45
+ - Feature nova recebe o próximo número livre (`max + 1`), não o número que o usuário citou. Mostre na entrevista o número que cada uma vai receber.
46
+
47
+ ## Entrevista inicial (a única parada planejada)
48
+
49
+ Ao ser ativado, verifique primeiro se há execução em andamento (seção "Retomada"). Senão, monte a entrevista só com o que **ainda não foi respondido**, seja no argumento da invocação, seja em `.reversa/state.json` ou `.reversa/config.toml`.
50
+
51
+ **Sem entrevista:** se o argumento já identifica a fila e contém "sem entrevista", "use os padrões" ou equivalente (típico de `/goal`), pule as perguntas, aplique os padrões marcados abaixo e dispense a confirmação INICIAR. A pré-checagem continua obrigatória.
52
+
53
+ Use o menu interativo da engine (no Claude Code, `AskUserQuestion`). Em engines sem suporte, use menus numerados. Toda pergunta de escolha tem opção final "Outro" aberta.
54
+
55
+ 1. **Fila:** mostre a fila resolvida (item, estágio físico atual, fase de partida) e peça confirmação. Inclua aqui as descrições que faltarem para features novas.
56
+ 2. **Até onde ir em cada feature:**
57
+ 1. **Até o sync** (padrão): cada feature termina convergida na extração.
58
+ 2. **Até o coding**: o código fica pronto, sync fica para depois.
59
+ 3. **Até o to-do**: só planejamento, nenhuma linha de código.
60
+ 3. **Dúvidas nos requisitos (`[DÚVIDA]`):**
61
+ 1. **Não parar** (padrão): o clarify é pulado. Cada `[DÚVIDA]` vira premissa explícita no `roadmap.md`, pelo caminho que o `reversa-plan` já prevê, e é registrada em `<forward_folder>/<feature>/questions.md`.
62
+ 2. **Parar e perguntar**: o clarify roda normalmente e pausa a execução a cada dúvida.
63
+ 4. **Etapas opcionais:** rodar `/reversa-audit` e `/reversa-quality` antes do coding? Padrão: não.
64
+ 5. **Falha numa feature** (ação que falha, caminho fora de `allowedPaths`, aborto de fase):
65
+ 1. **Parar a fila** (padrão): as próximas features podem depender desta.
66
+ 2. **Pular e seguir**: a feature fica bloqueada e a fila continua na próxima.
67
+
68
+ ## Pré-checagem (antes do INICIAR)
69
+
70
+ Tudo o que bloquearia a fila no meio do caminho é verificado agora, não na feature 7:
71
+
72
+ 1. **Organização das specs:** se `[specs] granularity` não estiver decidida, faça a pergunta do `reversa-forward` nesta entrevista.
73
+ 2. **Âncora de contexto** (se a fila chega ao coding): `<output_folder>/` precisa ter `architecture.md` + `domain.md` (legado) ou `prd.md` + specs em `sdd/` (greenfield). Sem nenhuma das duas, reduza o alvo para "até o to-do" e avise, ou pare se o usuário quiser código.
74
+ 3. **Política de edição** (se a fila chega ao coding): leia `.reversa/reversa-config.json`.
75
+ - Ausente, inválida ou `allowLegacyEdits: false`: mostre o estado atual e o snippet que o usuário deve salvar (`{"version": 1, "allowLegacyEdits": true, "allowedPaths": [...]}`). Ofereça duas saídas: o usuário edita a config e confirma, ou a fila roda "até o to-do". Não siga para o coding com a política bloqueada.
76
+ - `allowedPaths` preenchido: avise que caminhos fora da lista vão bloquear a feature.
77
+ 4. **Ganchos:** leia `.reversa/hooks.yml` e liste os ganchos `optional: false` que vão rodar sozinhos. Os que têm efeito externo (ex. sincronizar com Plane, Jira ou GitHub) aparecem destacados.
78
+
79
+ No modo **sem entrevista**, qualquer item pendente da pré-checagem (granularity não decidida, âncora ausente, política bloqueada) interrompe antes de começar, dizendo o que o usuário precisa resolver. Não reduza o alvo por conta própria.
80
+
81
+ Encerre com:
82
+
83
+ > "[Nome], fila pronta: [N] features, de [primeira] a [última], indo até [alvo]. A partir daqui não vou mais parar, exceto por necessidade real. Digite **INICIAR** para começar."
84
+
85
+ Após o INICIAR, grave o checkpoint (seção "Checkpoint") e comece.
86
+
87
+ ## Execução
88
+
89
+ Para cada item da fila, na ordem:
90
+
91
+ 1. **Ativar a feature.** Feature existente: se ela não é a ativa em `.reversa/active-requirements.json`, faça a troca seguindo a seção "Swap" do `SKILL.md` do `reversa-resume` (a ativa anterior vai para `paused-features` se não estiver `done`). Se a pasta existe mas não consta em `paused-features`, construa a entrada a partir da pasta e do estágio físico. Feature nova: siga para o requirements, que cria a pasta e o `active-requirements.json`.
92
+ 2. **Detectar o estágio físico** pela tabela do `reversa-forward`.
93
+ 3. **Rodar a fase** indicada pela matriz de roteamento do `reversa-forward`, lendo o `SKILL.md` dela.
94
+ 4. **Salvar o checkpoint** e voltar ao passo 2, até a feature chegar ao alvo escolhido na entrevista.
95
+ 5. Resumo de uma linha da feature e próxima da fila, sem pedir CONTINUAR.
96
+
97
+ Uma feature existente nunca volta ao requirements: ela retoma do estágio em que está.
98
+
99
+ Com as etapas opcionais ligadas, rode `reversa-audit` e depois `reversa-quality` logo após o to-do, antes da primeira rodada de coding da feature. A matriz do `reversa-forward` não roteia para elas, então a inserção é sua.
100
+
101
+ **Releia do disco antes de cada fase.** Numa fila longa o contexto é compactado sem aviso e as instruções lidas antes se perdem. Antes de cada fase, releia `.reversa/forward-autonomous.json` e o `SKILL.md` da fase, mesmo que já os tenha lido nesta sessão.
102
+
103
+ ### Overrides por fase
104
+
105
+ | Ponto de parada do fluxo normal | Comportamento autônomo |
106
+ |---|---|
107
+ | Todo skill termina com "Digite CONTINUAR" | O orquestrador responde: segue direto para a próxima fase ou feature |
108
+ | `reversa-requirements`, política de re-execução (feature anterior em andamento) | Opção 2, criar em paralelo: a anterior vai para `paused-features`. Nunca abandona feature |
109
+ | `reversa-clarify`, perguntas ao usuário | Modo "não parar": pulado. Modo "parar": roda normalmente |
110
+ | `reversa-plan`, "prefere rodar o clarify antes?" | Modo "não parar": prossegue, cada `[DÚVIDA]` vira premissa explícita com aviso no `roadmap.md` |
111
+ | `reversa-coding`, deleção de arquivo pré-existente | Não apaga. Registra o arquivo no relatório para o usuário decidir |
112
+ | `reversa-coding`, caminho fora de `allowedPaths` ou ação que falha | Não escreve. A feature fica **bloqueada** com os globs que faltam; aplica a regra de falha da entrevista |
113
+ | `reversa-sync`, ações ainda abertas | Opção 2, aguardar: não gera adendo parcial. A feature fica bloqueada |
114
+ | Gancho `optional: false` ("EXECUTAR e aguarde") | Executa o comando e aguarda, como o `hooks.yml` define. Falha do gancho bloqueia a feature |
115
+ | Gancho `optional: true` | Não executa. Lista no relatório final |
116
+
117
+ Os ganchos `optional: false` rodam mesmo tendo efeito externo porque foram configurados pelo usuário como obrigatórios. Por isso a pré-checagem os mostra antes do INICIAR.
118
+
119
+ ## Paradas legítimas (lista fechada)
120
+
121
+ Só interrompa a execução nestes casos:
122
+
123
+ 1. **Pré-checagem pendente:** política de edição bloqueada, âncora ausente ou granularity não decidida, e o usuário ainda não resolveu.
124
+ 2. **Modo "parar e perguntar"** para dúvidas: o clarify pausa, porque o usuário pediu.
125
+ 3. **Falha de feature com regra "parar a fila"**: explique a falha, o que foi concluído e o que o usuário precisa corrigir.
126
+ 4. **Erro irrecuperável:** falha de IO, `state.json` ou `active-requirements.json` corrompido, pasta sem permissão de escrita.
127
+ 5. **Estouro de contexto:** grave o checkpoint imediatamente e diga:
128
+ > "[Nome], vou pausar para preservar o contexto. Tudo salvo. Digite `/reversa-forward-autonomous` em uma nova sessão para continuar de onde paramos."
129
+
130
+ Qualquer outra vontade de perguntar não é parada legítima: escolha o padrão seguro, registre no relatório final e siga.
131
+
132
+ ## Checkpoint
133
+
134
+ Arquivo `.reversa/forward-autonomous.json`, escrito atomicamente (tempfile mais rename) após o INICIAR e após cada fase:
135
+
136
+ ```json
137
+ {
138
+ "schema-version": 1,
139
+ "started-at": "<ISO 8601>",
140
+ "status": "running | paused | blocked | done",
141
+ "answers": {
142
+ "target": "sync | coding | to-do",
143
+ "doubts": "file | chat",
144
+ "optional-stages": false,
145
+ "on-failure": "stop | skip"
146
+ },
147
+ "queue": [
148
+ {
149
+ "item": "<NNN-short-name ou descrição da feature nova>",
150
+ "feature-dir": "<caminho, preenchido quando existir>",
151
+ "status": "pending | running | done | blocked | skipped",
152
+ "last-stage": "<estágio físico após a última fase>",
153
+ "note": "<motivo do bloqueio ou pulo>"
154
+ }
155
+ ],
156
+ "warnings": []
157
+ }
158
+ ```
159
+
160
+ O checkpoint só registra progresso. O estágio real de cada feature continua vindo dos artefatos físicos.
161
+
162
+ ## Retomada
163
+
164
+ Se `.reversa/forward-autonomous.json` existir com `status` diferente de `done`:
165
+
166
+ 1. Mostre o progresso (✅ concluídas, 🔄 atual, ⏳ pendentes, ⛔ bloqueadas).
167
+ 2. Refaça só a pré-checagem, porque a config pode ter mudado. Não refaça a entrevista.
168
+ 3. Retome o item atual a partir do estágio físico dele, **sem pedir CONTINUAR**. Um item bloqueado cuja causa foi corrigida (ex. globs adicionados à config) volta para `running`.
169
+
170
+ Se o usuário passou uma fila nova no argumento, pergunte uma vez se ele quer descartar a execução anterior ou retomá-la. Descartar só reescreve o checkpoint, nunca apaga pasta de feature.
171
+
172
+ ## Relatório final
173
+
174
+ Ao terminar a fila, grave `status: done` e apresente:
175
+
176
+ 1. Por feature: estágio final, artefatos gerados e, para as que passaram pelo coding, os arquivos do projeto tocados (do `legacy-impact.md`).
177
+ 2. Features bloqueadas ou puladas, com o motivo e o que fazer para destravar.
178
+ 3. Premissas assumidas no lugar de `[DÚVIDA]`, apontando os `questions.md` que o usuário deve revisar.
179
+ 4. Arquivos que o coding quis apagar e não apagou, ganchos opcionais não executados e demais avisos acumulados.
180
+ 5. Próximos passos: revisar o diff, rodar os testes do projeto e, quando a fila foi até o coding, rodar o sync depois.
181
+
182
+ ## Regra absoluta
183
+
184
+ **Nunca apague, mova ou sobrescreva arquivos pré-existentes do projeto fora do que a fase coding faz sob a política de `.reversa/reversa-config.json`.** As pastas de feature em `<forward_folder>/` nunca são apagadas, nem as pausadas ou abandonadas.