@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.
- package/LICENSE +21 -0
- package/README.md +487 -2
- package/agents/fg-backlog/SKILL.md +129 -0
- package/agents/fg-backlog/agents/openai.yaml +5 -0
- package/agents/fg-backlog/references/backlog-template.md +60 -0
- package/agents/fg-backlog/references/priorizacao.md +41 -0
- package/agents/impeccable/LICENSE +191 -0
- package/agents/impeccable/NOTICE.md +11 -0
- package/agents/impeccable/SKILL.md +88 -0
- package/agents/impeccable/agents/impeccable_asset_producer.toml +47 -0
- package/agents/impeccable/agents/impeccable_documenter.toml +27 -0
- package/agents/impeccable/agents/impeccable_finish_reviewer.toml +41 -0
- package/agents/impeccable/agents/impeccable_manual_edit_applier.toml +95 -0
- package/agents/impeccable/agents/openai.yaml +4 -0
- package/agents/impeccable/reference/adapt.md +318 -0
- package/agents/impeccable/reference/adapt.native.md +58 -0
- package/agents/impeccable/reference/android.md +46 -0
- package/agents/impeccable/reference/animate.md +89 -0
- package/agents/impeccable/reference/audit.md +139 -0
- package/agents/impeccable/reference/audit.native.md +139 -0
- package/agents/impeccable/reference/bolder.md +33 -0
- package/agents/impeccable/reference/clarify.md +94 -0
- package/agents/impeccable/reference/colorize.md +86 -0
- package/agents/impeccable/reference/component-review.md +63 -0
- package/agents/impeccable/reference/craft-floor.md +44 -0
- package/agents/impeccable/reference/craft.md +5 -0
- package/agents/impeccable/reference/critique.md +819 -0
- package/agents/impeccable/reference/degraded/asset-producer.md +42 -0
- package/agents/impeccable/reference/degraded/documenter.md +24 -0
- package/agents/impeccable/reference/degraded/finish-reviewer.md +38 -0
- package/agents/impeccable/reference/degraded/manual-edit-applier.md +92 -0
- package/agents/impeccable/reference/delight.md +70 -0
- package/agents/impeccable/reference/distill.md +111 -0
- package/agents/impeccable/reference/doctor.md +54 -0
- package/agents/impeccable/reference/document.md +416 -0
- package/agents/impeccable/reference/extract.md +69 -0
- package/agents/impeccable/reference/generate.md +101 -0
- package/agents/impeccable/reference/harden.md +343 -0
- package/agents/impeccable/reference/hooks.md +113 -0
- package/agents/impeccable/reference/init.md +131 -0
- package/agents/impeccable/reference/ios.md +51 -0
- package/agents/impeccable/reference/layout.md +84 -0
- package/agents/impeccable/reference/live-setup.md +104 -0
- package/agents/impeccable/reference/live.md +325 -0
- package/agents/impeccable/reference/mode-operate.md +21 -0
- package/agents/impeccable/reference/mode-persuade.md +19 -0
- package/agents/impeccable/reference/mode-read.md +21 -0
- package/agents/impeccable/reference/new-work.md +154 -0
- package/agents/impeccable/reference/onboard.md +234 -0
- package/agents/impeccable/reference/operate.md +61 -0
- package/agents/impeccable/reference/optimize.md +258 -0
- package/agents/impeccable/reference/overdrive.md +127 -0
- package/agents/impeccable/reference/polish.md +105 -0
- package/agents/impeccable/reference/quieter.md +99 -0
- package/agents/impeccable/reference/region-map.md +26 -0
- package/agents/impeccable/reference/routing.md +24 -0
- package/agents/impeccable/reference/shape.md +59 -0
- package/agents/impeccable/reference/typeset.md +90 -0
- package/agents/impeccable/reference/visualize.md +47 -0
- package/agents/impeccable/reversa-bundle.json +16 -0
- package/agents/impeccable/scripts/VERSION +1 -0
- package/agents/impeccable/scripts/command-metadata.json +98 -0
- package/agents/impeccable/scripts/data/font-index-failures.json +121 -0
- package/agents/impeccable/scripts/data/font-index.json +1 -0
- package/agents/impeccable/scripts/impeccable +212 -0
- package/agents/impeccable/scripts/impeccable.cmd +239 -0
- package/agents/impeccable/scripts/live-browser-dom.js +320 -0
- package/agents/impeccable/scripts/live-browser-ignores.js +242 -0
- package/agents/impeccable/scripts/live-browser-session.js +180 -0
- package/agents/impeccable/scripts/live-browser.js +13557 -0
- package/agents/impeccable/scripts/modern-screenshot.umd.js +14 -0
- package/agents/reversa/SKILL.md +135 -0
- package/agents/reversa/agents/openai.yaml +3 -0
- package/agents/reversa/references/checkpoint-guide.md +106 -0
- package/agents/reversa/references/state-schema.md +80 -0
- package/agents/reversa/references/step-01-first-run.md +63 -0
- package/agents/reversa/references/step-02-resume.md +88 -0
- package/agents/reversa/references/step-03-specs-organization.md +145 -0
- package/agents/reversa/references/step-04-regression-check.md +94 -0
- package/agents/reversa-add/SKILL.md +131 -0
- package/agents/reversa-add/agents/openai.yaml +5 -0
- package/agents/reversa-agents-help/SKILL.md +211 -0
- package/agents/reversa-agents-help/agents/openai.yaml +3 -0
- package/agents/reversa-arbiter/SKILL.md +140 -0
- package/agents/reversa-arbiter/agents/openai.yaml +5 -0
- package/agents/reversa-archaeologist/SKILL.md +95 -0
- package/agents/reversa-archaeologist/agents/openai.yaml +5 -0
- package/agents/reversa-archaeologist/references/modules-schema.md +69 -0
- package/agents/reversa-architect/SKILL.md +93 -0
- package/agents/reversa-architect/agents/openai.yaml +5 -0
- package/agents/reversa-arquitetura-3d/SKILL.md +163 -0
- package/agents/reversa-arquitetura-3d/agents/openai.yaml +5 -0
- package/agents/reversa-arquitetura-3d/references/ARCH_TOUR.md +242 -0
- package/agents/reversa-arquitetura-3d/references/CALL_GRAPH_3D.md +217 -0
- package/agents/reversa-arquitetura-3d/references/CODE_CITY.md +228 -0
- package/agents/reversa-arquitetura-3d/references/DEPENDENCY_GRAPH_3D.md +240 -0
- package/agents/reversa-arquitetura-3d/references/ERRORS.md +286 -0
- package/agents/reversa-arquitetura-3d/references/LAYER_STACK.md +230 -0
- package/agents/reversa-arquitetura-3d/references/THREE_PATTERNS.md +221 -0
- package/agents/reversa-audit/SKILL.md +98 -0
- package/agents/reversa-audit/agents/openai.yaml +5 -0
- package/agents/reversa-autonomous/SKILL.md +139 -0
- package/agents/reversa-autonomous/agents/openai.yaml +3 -0
- package/agents/reversa-brainstorm/SKILL.md +131 -0
- package/agents/reversa-brainstorm/agents/openai.yaml +3 -0
- package/agents/reversa-challenger/SKILL.md +122 -0
- package/agents/reversa-challenger/agents/openai.yaml +5 -0
- package/agents/reversa-clarify/SKILL.md +103 -0
- package/agents/reversa-clarify/agents/openai.yaml +5 -0
- package/agents/reversa-code-express/SKILL.md +252 -0
- package/agents/reversa-code-express/agents/openai.yaml +5 -0
- package/agents/reversa-coding/SKILL.md +172 -0
- package/agents/reversa-coding/agents/openai.yaml +5 -0
- package/agents/reversa-curator/SKILL.md +133 -0
- package/agents/reversa-curator/agents/openai.yaml +5 -0
- package/agents/reversa-curator/references/decision-rubric.md +52 -0
- package/agents/reversa-curator/references/templates/discard_log.md +37 -0
- package/agents/reversa-curator/references/templates/target_business_rules.md +54 -0
- package/agents/reversa-data-master/SKILL.md +67 -0
- package/agents/reversa-data-master/agents/openai.yaml +5 -0
- package/agents/reversa-debugger/SKILL.md +178 -0
- package/agents/reversa-debugger/agents/openai.yaml +3 -0
- package/agents/reversa-debugger/references/bug-schema.md +123 -0
- package/agents/reversa-debugger/references/bugs-readme-template.md +76 -0
- package/agents/reversa-debugger-debate/SKILL.md +75 -0
- package/agents/reversa-debugger-debate/agents/openai.yaml +5 -0
- package/agents/reversa-debugger-debate/references/debate-protocol.md +102 -0
- package/agents/reversa-debugger-fix/SKILL.md +170 -0
- package/agents/reversa-debugger-fix/agents/openai.yaml +5 -0
- package/agents/reversa-debugger-graph/SKILL.md +94 -0
- package/agents/reversa-debugger-graph/agents/openai.yaml +5 -0
- package/agents/reversa-decouple/SKILL.md +78 -0
- package/agents/reversa-decouple/agents/openai.yaml +5 -0
- package/agents/reversa-depth-inspection/SKILL.md +99 -0
- package/agents/reversa-depth-inspection/agents/openai.yaml +5 -0
- package/agents/reversa-design-system/SKILL.md +77 -0
- package/agents/reversa-design-system/agents/openai.yaml +5 -0
- package/agents/reversa-designer/SKILL.md +217 -0
- package/agents/reversa-designer/agents/openai.yaml +5 -0
- package/agents/reversa-designer/references/paradigm-checklist.md +50 -0
- package/agents/reversa-designer/references/templates/data_migration_plan.md +80 -0
- package/agents/reversa-designer/references/templates/target_architecture.md +68 -0
- package/agents/reversa-designer/references/templates/target_data_model.md +64 -0
- package/agents/reversa-designer/references/templates/target_domain_model.md +62 -0
- package/agents/reversa-designer/references/templates/topology_decision.md +82 -0
- package/agents/reversa-detective/SKILL.md +82 -0
- package/agents/reversa-detective/agents/openai.yaml +5 -0
- package/agents/reversa-docs/SKILL.md +241 -0
- package/agents/reversa-docs/agents/openai.yaml +3 -0
- package/agents/reversa-docs/references/config-schema.json +108 -0
- package/agents/reversa-docs/references/expected_sources.yaml +60 -0
- package/agents/reversa-docs-analyst/SKILL.md +163 -0
- package/agents/reversa-docs-analyst/agents/openai.yaml +5 -0
- package/agents/reversa-docs-mapper/SKILL.md +167 -0
- package/agents/reversa-docs-mapper/agents/openai.yaml +5 -0
- package/agents/reversa-docs-mapper/references/extraction-policy.md +44 -0
- package/agents/reversa-docs-publisher/SKILL.md +323 -0
- package/agents/reversa-docs-publisher/agents/openai.yaml +5 -0
- package/agents/reversa-docs-publisher/references/auxiliary_sources.yaml +27 -0
- package/agents/reversa-docs-publisher/references/vendor-pins.yaml +149 -0
- package/agents/reversa-docs-storyteller/SKILL.md +189 -0
- package/agents/reversa-docs-storyteller/agents/openai.yaml +5 -0
- package/agents/reversa-drafter/SKILL.md +189 -0
- package/agents/reversa-drafter/agents/openai.yaml +5 -0
- package/agents/reversa-especialista-d3/SKILL.md +37 -0
- package/agents/reversa-especialista-d3/agents/openai.yaml +5 -0
- package/agents/reversa-especialista-d3/references/api-core.md +13 -0
- package/agents/reversa-especialista-d3/references/interatividade.md +5 -0
- package/agents/reversa-especialista-d3/references/layouts-complexos.md +8 -0
- package/agents/reversa-explorer/SKILL.md +110 -0
- package/agents/reversa-explorer/agents/openai.yaml +5 -0
- package/agents/reversa-extract-soul/SKILL.md +221 -0
- package/agents/reversa-extract-soul/agents/openai.yaml +5 -0
- package/agents/reversa-forward/SKILL.md +235 -0
- package/agents/reversa-forward/agents/openai.yaml +3 -0
- package/agents/reversa-forward-autonomous/SKILL.md +184 -0
- package/agents/reversa-forward-autonomous/agents/openai.yaml +3 -0
- package/agents/reversa-framer/SKILL.md +124 -0
- package/agents/reversa-framer/agents/openai.yaml +5 -0
- package/agents/reversa-highcharts-visualizer/SKILL.md +123 -0
- package/agents/reversa-highcharts-visualizer/agents/openai.yaml +5 -0
- package/agents/reversa-highcharts-visualizer/references/CHART_CATALOG.md +450 -0
- package/agents/reversa-highcharts-visualizer/references/ERRORS.md +99 -0
- package/agents/reversa-highcharts-visualizer/references/HIGHCHARTS_PATTERNS.md +347 -0
- package/agents/reversa-highcharts-visualizer/scripts/analyze_data.py +219 -0
- package/agents/reversa-highcharts-visualizer/scripts/parse_data.py +246 -0
- package/agents/reversa-highcharts-visualizer/scripts/sample_data.py +208 -0
- package/agents/reversa-ideator/SKILL.md +139 -0
- package/agents/reversa-ideator/agents/openai.yaml +5 -0
- package/agents/reversa-image-prompt-json/SKILL.md +210 -0
- package/agents/reversa-image-prompt-json/agents/openai.yaml +5 -0
- package/agents/reversa-image-prompt-json/references/Examples.md +123 -0
- package/agents/reversa-inspector/SKILL.md +147 -0
- package/agents/reversa-inspector/agents/openai.yaml +5 -0
- package/agents/reversa-inspector/references/parity-coverage-matrix.md +54 -0
- package/agents/reversa-inspector/references/templates/parity_specs.md +64 -0
- package/agents/reversa-inspector/references/templates/parity_test.feature +40 -0
- package/agents/reversa-migrate/SKILL.md +282 -0
- package/agents/reversa-migrate/agents/openai.yaml +3 -0
- package/agents/reversa-migrate/references/auto-defaults.md +52 -0
- package/agents/reversa-migrate/references/expected_legacy_artifacts.yaml +69 -0
- package/agents/reversa-migrate/references/handoff-checklist.md +34 -0
- package/agents/reversa-migrate/references/state.json +28 -0
- package/agents/reversa-migrate/references/templates/ambiguity_log.md +43 -0
- package/agents/reversa-migrate/references/templates/handoff.md +91 -0
- package/agents/reversa-migrate/references/templates/migration_brief.md +52 -0
- package/agents/reversa-migrate/references/templates/pending_decisions.md +36 -0
- package/agents/reversa-modularize/SKILL.md +77 -0
- package/agents/reversa-modularize/agents/openai.yaml +5 -0
- package/agents/reversa-n8n/SKILL.md +256 -0
- package/agents/reversa-n8n/agents/openai.yaml +5 -0
- package/agents/reversa-n8n/references/node-catalog.md +245 -0
- package/agents/reversa-new/SKILL.md +328 -0
- package/agents/reversa-new/agents/openai.yaml +3 -0
- package/agents/reversa-optimize/SKILL.md +80 -0
- package/agents/reversa-optimize/agents/openai.yaml +5 -0
- package/agents/reversa-paradigm-advisor/SKILL.md +168 -0
- package/agents/reversa-paradigm-advisor/agents/openai.yaml +5 -0
- package/agents/reversa-paradigm-advisor/references/paradigm-catalog.md +73 -0
- package/agents/reversa-paradigm-advisor/references/templates/paradigm_decision.md +69 -0
- package/agents/reversa-plan/SKILL.md +92 -0
- package/agents/reversa-plan/agents/openai.yaml +5 -0
- package/agents/reversa-pre-spec/SKILL.md +133 -0
- package/agents/reversa-pre-spec/agents/openai.yaml +5 -0
- package/agents/reversa-pricing/SKILL.md +181 -0
- package/agents/reversa-pricing/agents/openai.yaml +3 -0
- package/agents/reversa-pricing-advisor/SKILL.md +322 -0
- package/agents/reversa-pricing-advisor/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-advisor/references/advisor-schema.json +196 -0
- package/agents/reversa-pricing-advisor/references/advisor-template.md +106 -0
- package/agents/reversa-pricing-advisor/references/sale-models.md +237 -0
- package/agents/reversa-pricing-estimate/SKILL.md +287 -0
- package/agents/reversa-pricing-estimate/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-estimate/references/effort-formula.md +146 -0
- package/agents/reversa-pricing-estimate/references/estimate-schema.json +141 -0
- package/agents/reversa-pricing-estimate/references/estimate-template.md +153 -0
- package/agents/reversa-pricing-estimate/references/example-estimate.json +74 -0
- package/agents/reversa-pricing-estimate/references/example-estimate.md +88 -0
- package/agents/reversa-pricing-estimate/references/market-benchmarks.md +102 -0
- package/agents/reversa-pricing-estimate/references/value-formula.md +123 -0
- package/agents/reversa-pricing-product/SKILL.md +299 -0
- package/agents/reversa-pricing-product/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-product/references/breakeven-formula.md +237 -0
- package/agents/reversa-pricing-product/references/product-schema.json +288 -0
- package/agents/reversa-pricing-product/references/product-template.md +113 -0
- package/agents/reversa-pricing-product/references/store-commissions.md +57 -0
- package/agents/reversa-pricing-profile/SKILL.md +390 -0
- package/agents/reversa-pricing-profile/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-profile/references/example-profile.json +23 -0
- package/agents/reversa-pricing-profile/references/example-profile.md +46 -0
- package/agents/reversa-pricing-profile/references/profile-schema.json +227 -0
- package/agents/reversa-pricing-profile/references/tax-regimes.md +106 -0
- package/agents/reversa-pricing-research/SKILL.md +352 -0
- package/agents/reversa-pricing-research/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-research/references/research-policy.md +213 -0
- package/agents/reversa-pricing-research/references/research-schema.json +330 -0
- package/agents/reversa-pricing-size/SKILL.md +205 -0
- package/agents/reversa-pricing-size/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-size/references/example-size.json +41 -0
- package/agents/reversa-pricing-size/references/size-schema.json +120 -0
- package/agents/reversa-pricing-size/references/sizing-formula.md +183 -0
- package/agents/reversa-principles/SKILL.md +82 -0
- package/agents/reversa-principles/agents/openai.yaml +5 -0
- package/agents/reversa-prune/SKILL.md +85 -0
- package/agents/reversa-prune/agents/openai.yaml +5 -0
- package/agents/reversa-quality/SKILL.md +87 -0
- package/agents/reversa-quality/agents/openai.yaml +5 -0
- package/agents/reversa-reconstructor/SKILL.md +243 -0
- package/agents/reversa-reconstructor/agents/openai.yaml +5 -0
- package/agents/reversa-reconstructor/references/reconstruction-plan-migration-template.md +89 -0
- package/agents/reversa-reconstructor/references/reconstruction-plan-template.md +77 -0
- package/agents/reversa-refactor/SKILL.md +112 -0
- package/agents/reversa-refactor/agents/openai.yaml +3 -0
- package/agents/reversa-refactor/references/opportunity-schema.md +68 -0
- package/agents/reversa-refactor/references/refactor-readme-template.md +35 -0
- package/agents/reversa-requirements/SKILL.md +217 -0
- package/agents/reversa-requirements/agents/openai.yaml +5 -0
- package/agents/reversa-researcher/SKILL.md +136 -0
- package/agents/reversa-researcher/agents/openai.yaml +5 -0
- package/agents/reversa-restructure/SKILL.md +78 -0
- package/agents/reversa-restructure/agents/openai.yaml +5 -0
- package/agents/reversa-resume/SKILL.md +141 -0
- package/agents/reversa-resume/agents/openai.yaml +5 -0
- package/agents/reversa-reviewer/SKILL.md +163 -0
- package/agents/reversa-reviewer/agents/openai.yaml +5 -0
- package/agents/reversa-reviewer/references/confidence-report-template.md +73 -0
- package/agents/reversa-reviewer/references/confidence-rules.md +65 -0
- package/agents/reversa-reviewer/references/questions-template.md +74 -0
- package/agents/reversa-scout/SKILL.md +82 -0
- package/agents/reversa-scout/agents/openai.yaml +5 -0
- package/agents/reversa-scout/references/surface-schema.md +93 -0
- package/agents/reversa-screen-translator/SKILL.md +279 -0
- package/agents/reversa-screen-translator/agents/openai.yaml +5 -0
- package/agents/reversa-screen-translator/references/adapter-pairs.md +97 -0
- package/agents/reversa-screen-translator/references/platform-detection.md +73 -0
- package/agents/reversa-screen-translator/references/templates/golden_manifest.yaml +62 -0
- package/agents/reversa-screen-translator/references/templates/inventory.schema.json +132 -0
- package/agents/reversa-screen-translator/references/templates/screen_deviation_log.md +66 -0
- package/agents/reversa-screen-translator/references/templates/screen_modernization_decision.md +106 -0
- package/agents/reversa-screen-translator/references/templates/target_screens.md +206 -0
- package/agents/reversa-selo-generativo/SKILL.md +176 -0
- package/agents/reversa-selo-generativo/agents/openai.yaml +5 -0
- package/agents/reversa-selo-generativo/references/ERRORS.md +212 -0
- package/agents/reversa-selo-generativo/references/GENERATIVE_PATTERNS.md +365 -0
- package/agents/reversa-selo-generativo/references/PALETTE_BY_STYLE.md +176 -0
- package/agents/reversa-simplify/SKILL.md +79 -0
- package/agents/reversa-simplify/agents/openai.yaml +5 -0
- package/agents/reversa-spec-sdd/SKILL.md +278 -0
- package/agents/reversa-spec-sdd/agents/openai.yaml +5 -0
- package/agents/reversa-spec-sdd/assets/spec_examples.md +159 -0
- package/agents/reversa-spec-sdd/references/evaluation_rubric.md +113 -0
- package/agents/reversa-spec-sdd/references/sdd_guide.md +124 -0
- package/agents/reversa-spec-sdd/references/spec_template.md +231 -0
- package/agents/reversa-spec-sdd/scripts/spec_scorer.py +476 -0
- package/agents/reversa-standardize/SKILL.md +76 -0
- package/agents/reversa-standardize/agents/openai.yaml +5 -0
- package/agents/reversa-strategist/SKILL.md +119 -0
- package/agents/reversa-strategist/agents/openai.yaml +5 -0
- package/agents/reversa-strategist/references/migration-strategies.md +41 -0
- package/agents/reversa-strategist/references/templates/cutover_plan.md +60 -0
- package/agents/reversa-strategist/references/templates/migration_strategy.md +55 -0
- package/agents/reversa-strategist/references/templates/risk_register.md +44 -0
- package/agents/reversa-sync/SKILL.md +100 -0
- package/agents/reversa-sync/agents/openai.yaml +5 -0
- package/agents/reversa-to-do/SKILL.md +89 -0
- package/agents/reversa-to-do/agents/openai.yaml +5 -0
- package/agents/reversa-visor/SKILL.md +91 -0
- package/agents/reversa-visor/agents/openai.yaml +5 -0
- package/agents/reversa-writer/SKILL.md +212 -0
- package/agents/reversa-writer/agents/openai.yaml +5 -0
- package/agents/reversa-writer/references/design-template.md +49 -0
- package/agents/reversa-writer/references/requirements-template.md +62 -0
- package/agents/reversa-writer/references/tasks-template.md +39 -0
- package/bin/reversa.js +65 -0
- package/lib/commands/add-engine.js +97 -0
- package/lib/commands/export-diagrams.js +194 -0
- package/lib/commands/install.js +260 -0
- package/lib/commands/status.js +35 -0
- package/lib/commands/uninstall.js +159 -0
- package/lib/commands/update.js +252 -0
- package/lib/installer/bundled.js +42 -0
- package/lib/installer/detector.js +167 -0
- package/lib/installer/manifest.js +61 -0
- package/lib/installer/orange-prompts.js +13 -0
- package/lib/installer/policy.js +53 -0
- package/lib/installer/prompts.js +252 -0
- package/lib/installer/validator.js +22 -0
- package/lib/installer/writer.js +376 -0
- package/lib/utils/banner.js +35 -0
- package/lib/utils/json-safe.js +10 -0
- package/lib/utils/package-info.js +22 -0
- package/package.json +51 -4
- package/templates/config.toml +46 -0
- package/templates/config.user.toml +8 -0
- package/templates/documentation/assets/css/style.css +476 -0
- package/templates/documentation/assets/js/nav.js +141 -0
- package/templates/documentation/assets/js/sidebar.js +162 -0
- package/templates/documentation/demo/viewer-demo.html +200 -0
- package/templates/documentation/pages/arquitetura.html.tpl +36 -0
- package/templates/documentation/pages/deck.html.tpl +27 -0
- package/templates/documentation/pages/features/feature.html.tpl +44 -0
- package/templates/documentation/pages/glossario.html.tpl +30 -0
- package/templates/documentation/pages/index.html.tpl +32 -0
- package/templates/documentation/pages/metricas.html.tpl +43 -0
- package/templates/documentation/pages/modulos.html.tpl +33 -0
- package/templates/documentation/pages/timeline.html.tpl +33 -0
- package/templates/documentation/pages/topologia.html.tpl +31 -0
- package/templates/documentation/scripts/convert_chronicle.py +71 -0
- package/templates/documentation/scripts/convert_soul.py +73 -0
- package/templates/documentation/scripts/extract_deps.py +54 -0
- package/templates/documentation/scripts/extract_modules.py +90 -0
- package/templates/documentation/scripts/list_specs.py +74 -0
- package/templates/documentation/viewer.html +60 -0
- package/templates/engines/AGENTS.md +26 -0
- package/templates/engines/CLAUDE.md +27 -0
- package/templates/engines/CONVENTIONS.md +26 -0
- package/templates/engines/GEMINI.md +26 -0
- package/templates/engines/amazonq +7 -0
- package/templates/engines/clinerules +7 -0
- package/templates/engines/copilot-instructions +26 -0
- package/templates/engines/cursorrules +7 -0
- package/templates/engines/roorules +7 -0
- package/templates/engines/windsurf +7 -0
- package/templates/forward/body/actions-template.md +83 -0
- package/templates/forward/body/principles-template.md +75 -0
- package/templates/forward/body/quality-template.md +103 -0
- package/templates/forward/body/requirements-template.md +121 -0
- package/templates/forward/body/roadmap-template.md +107 -0
- package/templates/forward/hooks.yml +60 -0
- package/templates/forward/scripts/ps/bind-to-extraction.ps1 +71 -0
- package/templates/forward/scripts/ps/prepare-roadmap.ps1 +84 -0
- package/templates/forward/scripts/ps/verify-prerequisites.ps1 +103 -0
- package/templates/forward/scripts/sh/bind-to-extraction.sh +103 -0
- package/templates/forward/scripts/sh/prepare-roadmap.sh +79 -0
- package/templates/forward/scripts/sh/verify-prerequisites.sh +125 -0
- package/templates/forward/setup.json +24 -0
- package/templates/hooks/README.md +41 -0
- package/templates/hooks/check-legacy-policy.mjs +0 -0
- package/templates/migration/artifacts/ambiguity_log.md +43 -0
- package/templates/migration/artifacts/cutover_plan.md +60 -0
- package/templates/migration/artifacts/data_migration_plan.md +80 -0
- package/templates/migration/artifacts/discard_log.md +37 -0
- package/templates/migration/artifacts/handoff.md +76 -0
- package/templates/migration/artifacts/migration_brief.md +52 -0
- package/templates/migration/artifacts/migration_strategy.md +55 -0
- package/templates/migration/artifacts/paradigm_decision.md +69 -0
- package/templates/migration/artifacts/parity_specs.md +64 -0
- package/templates/migration/artifacts/parity_test.feature +40 -0
- package/templates/migration/artifacts/pending_decisions.md +36 -0
- package/templates/migration/artifacts/risk_register.md +44 -0
- package/templates/migration/artifacts/target_architecture.md +68 -0
- package/templates/migration/artifacts/target_business_rules.md +54 -0
- package/templates/migration/artifacts/target_data_model.md +64 -0
- package/templates/migration/artifacts/target_domain_model.md +62 -0
- package/templates/migration/catalogs/migration_strategies.md +101 -0
- package/templates/migration/catalogs/paradigm_catalog.md +101 -0
- package/templates/migration/expected_legacy_artifacts.yaml +77 -0
- package/templates/migration/state.json +28 -0
- package/templates/plan.md +65 -0
- package/templates/reversa-config.json +5 -0
- package/templates/state.json +18 -0
|
@@ -0,0 +1,243 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-reconstructor
|
|
3
|
+
description: "Gera um plano de reconstrução bottom-up a partir das specs do Reversa e executa cada tarefa sob demanda, uma por vez, preservando tokens. Use quando quiser reimplementar o software do zero a partir das especificações geradas. Ativação: /reversa-reconstructor"
|
|
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
|
+
role: reconstructor
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
Você é o Reconstructor. Sua missão é transformar as especificações geradas pelo Reversa em um plano de reconstrução executável e depois implementar cada tarefa sob demanda — bottom-up, uma por vez.
|
|
15
|
+
|
|
16
|
+
## Regra fundamental
|
|
17
|
+
|
|
18
|
+
**Nunca leia mais do que o necessário para cada etapa.** O plano é criado lendo poucos arquivos. Cada tarefa lê apenas os arquivos que ela precisa. Isso preserva tokens e permite pausar e retomar a qualquer momento.
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## Ao ser invocado
|
|
23
|
+
|
|
24
|
+
### Passo 1 — Verificar pré-requisitos
|
|
25
|
+
|
|
26
|
+
Verifique se a pasta `_reversa_sdd/` existe no diretório atual.
|
|
27
|
+
|
|
28
|
+
Se não existir, encerre:
|
|
29
|
+
> "Não encontrei `_reversa_sdd/`. Execute o Reversa no projeto original primeiro, depois copie a pasta para este diretório."
|
|
30
|
+
|
|
31
|
+
### Passo 2 — Detectar migração e perguntar a fonte
|
|
32
|
+
|
|
33
|
+
Verifique se `_reversa_sdd/migration/handoff.md` existe.
|
|
34
|
+
|
|
35
|
+
**Se NÃO existir:** o projeto não tem migração concluída, vá direto para o Passo 3 com fonte `original` (comportamento padrão).
|
|
36
|
+
|
|
37
|
+
**Se existir:** o projeto tem migração concluída e o usuário pode escolher reconstruir a partir das specs originais (sistema fiel ao legado) ou das specs da migração (sistema novo na stack alvo). Pergunte:
|
|
38
|
+
|
|
39
|
+
> "Encontrei specs de **migração** em `_reversa_sdd/migration/`. Você quer reconstruir a partir de:
|
|
40
|
+
>
|
|
41
|
+
> 1. **Specs originais**: reimplementa o sistema fiel ao legado a partir de `_reversa_sdd/`
|
|
42
|
+
> 2. **Specs da migração**: implementa o sistema novo na stack alvo a partir de `_reversa_sdd/migration/`
|
|
43
|
+
> 3. **Outro**: descreva (ex: \"reconstruir só um módulo\", \"misturar fontes\")
|
|
44
|
+
>
|
|
45
|
+
> Use o menu interativo da engine (no Claude Code, `AskUserQuestion`); em engines sem suporte, peça o número 1–3 ou texto livre."
|
|
46
|
+
|
|
47
|
+
Aguarde a resposta. NÃO escolha por conta própria. Persista a escolha em memória da sessão para usar nos passos 3 e 4 e para gravar no plano. Se a opção 3 for ambígua, refaça a pergunta uma vez antes de decidir.
|
|
48
|
+
|
|
49
|
+
**Caso especial: migração em andamento (sem `handoff.md`).** Se existir `_reversa_sdd/migration/.state.json` mas não existir `handoff.md`, informe:
|
|
50
|
+
> "Detectei uma migração **em andamento** (sem `handoff.md`). Para reconstruir a partir das specs da migração, finalize-a com `/reversa-migrate` antes. Vou prosseguir com as specs originais. Tudo bem?"
|
|
51
|
+
>
|
|
52
|
+
> Se o usuário disser não, encerre sem fazer nada.
|
|
53
|
+
|
|
54
|
+
### Passo 3 — Verificar plano existente
|
|
55
|
+
|
|
56
|
+
Verifique se `_reversa_sdd/reconstruction-plan.md` já existe.
|
|
57
|
+
|
|
58
|
+
**Se existir:** leia apenas o cabeçalho (primeiras 30 linhas) e identifique o campo `**Fonte:**` (`original` ou `migração`). Mostre o status atual e pergunte:
|
|
59
|
+
> "Encontrei um plano existente (fonte: <original|migração>). [X] tarefas concluídas, [Y] pendentes.
|
|
60
|
+
> 1. Continuar de onde parou
|
|
61
|
+
> 2. Recriar o plano do zero"
|
|
62
|
+
|
|
63
|
+
Se a fonte do plano existente for diferente da escolhida no Passo 2, alerte explicitamente:
|
|
64
|
+
> "⚠️ O plano existente foi gerado a partir das specs **<antiga>**, mas você escolheu **<nova>** agora. Continuar mantém a fonte antiga; recriar gera plano novo a partir da fonte escolhida."
|
|
65
|
+
|
|
66
|
+
**Se não existir:** vá direto para o Modo Planejamento da fonte escolhida.
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## Modo Planejamento — Original
|
|
71
|
+
|
|
72
|
+
> Use este modo quando a fonte escolhida no Passo 2 for `original`.
|
|
73
|
+
|
|
74
|
+
Leia APENAS estes arquivos (nesta ordem):
|
|
75
|
+
|
|
76
|
+
1. `.reversa/state.json` — se existir: extrai `project`, `user_name`, `chat_language`
|
|
77
|
+
2. `_reversa_sdd/gaps.md` — se existir
|
|
78
|
+
3. `_reversa_sdd/confidence-report.md` — se existir
|
|
79
|
+
4. `_reversa_sdd/architecture.md`
|
|
80
|
+
5. `_reversa_sdd/dependencies.md`
|
|
81
|
+
6. `_reversa_sdd/traceability/code-spec-matrix.md` — se existir
|
|
82
|
+
|
|
83
|
+
Não leia o conteúdo dos arquivos das pastas de unit (`<unit>/requirements.md`, `design.md`, `tasks.md`), nem de `openapi/` ou `user-stories/` agora. Apenas liste as units existentes (subpastas de `_reversa_sdd/` que contenham os 3 arquivos canônicos) a partir do `code-spec-matrix.md` ou do `dependencies.md`.
|
|
84
|
+
|
|
85
|
+
### Como determinar a ordem das tarefas
|
|
86
|
+
|
|
87
|
+
A partir do `dependencies.md`, identifique a árvore de dependências entre as units:
|
|
88
|
+
- Units sem dependências (folhas da árvore) devem ser implementadas primeiro
|
|
89
|
+
- Units que dependem de outras vêm após suas dependências
|
|
90
|
+
- Infraestrutura (banco, cache, filas) sempre antes do domínio
|
|
91
|
+
|
|
92
|
+
Ordem canônica bottom-up:
|
|
93
|
+
|
|
94
|
+
```
|
|
95
|
+
1. Schema do banco de dados → database/erd.md + database/data-dictionary.md
|
|
96
|
+
2. Entidades de domínio → domain.md
|
|
97
|
+
3. Máquinas de estado → state-machines.md (se existir)
|
|
98
|
+
4. Units folha → <unit>/{requirements,design,tasks}.md (uma por tarefa, sem dependentes)
|
|
99
|
+
5. Units intermediárias → <unit>/{requirements,design,tasks}.md (ordem da árvore)
|
|
100
|
+
6. Camada de API → openapi/
|
|
101
|
+
7. Fluxos de usuário → user-stories/
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
### Alertas de pré-voo
|
|
105
|
+
|
|
106
|
+
A partir de `gaps.md` e `confidence-report.md`, identifique gaps 🔴 que bloqueiam tarefas específicas. Associe cada alert à tarefa correspondente no plano.
|
|
107
|
+
|
|
108
|
+
### Gerar o plano
|
|
109
|
+
|
|
110
|
+
Gere `_reversa_sdd/reconstruction-plan.md` seguindo o template em `references/reconstruction-plan-template.md`.
|
|
111
|
+
|
|
112
|
+
Inclua no cabeçalho do plano: `**Fonte:** original`.
|
|
113
|
+
|
|
114
|
+
Regras de geração:
|
|
115
|
+
- Cada unit identificada (subpasta de `<output_folder>/` com os 3 arquivos canônicos) vira uma tarefa própria
|
|
116
|
+
- O campo `Lê:` de cada tarefa lista exatamente os arquivos que serão lidos na execução, tipicamente `<unit>/requirements.md`, `<unit>/design.md` e `<unit>/tasks.md` mais opcionais aplicáveis
|
|
117
|
+
- O campo `Pronto quando:` é derivado dos critérios de aceitação em `<unit>/requirements.md` (se disponíveis) ou do tipo da unit
|
|
118
|
+
- Units sem `tasks.md` listam `dependencies.md` como referência
|
|
119
|
+
|
|
120
|
+
Após gerar, apresente ao usuário:
|
|
121
|
+
|
|
122
|
+
> "[Nome], plano criado com [N] tarefas (fonte: original).
|
|
123
|
+
>
|
|
124
|
+
> Stack detectada: [stack]
|
|
125
|
+
> [Se houver alertas pré-voo]: Há [N] pontos que precisam de decisão antes de iniciar — listados no plano.
|
|
126
|
+
>
|
|
127
|
+
> Para iniciar, diga **INICIAR** ou **execute a tarefa 1**."
|
|
128
|
+
|
|
129
|
+
---
|
|
130
|
+
|
|
131
|
+
## Modo Planejamento — Migração
|
|
132
|
+
|
|
133
|
+
> Use este modo quando a fonte escolhida no Passo 2 for `migração` (handoff.md presente em `_reversa_sdd/migration/`).
|
|
134
|
+
|
|
135
|
+
Leia APENAS estes arquivos (nesta ordem):
|
|
136
|
+
|
|
137
|
+
1. `.reversa/state.json` — se existir: extrai `project`, `user_name`, `chat_language`
|
|
138
|
+
2. `_reversa_sdd/migration/handoff.md` — ponto de entrada, lista artefatos disponíveis e itens REFERIDOS À CODIFICAÇÃO
|
|
139
|
+
3. `_reversa_sdd/migration/paradigm_decision.md` — decide o "como pensar" (paradigma alvo)
|
|
140
|
+
4. `_reversa_sdd/migration/topology_decision.md` — decide o "como organizar a árvore" (preservar/modernizar/híbrido)
|
|
141
|
+
5. `_reversa_sdd/migration/migration_strategy.md` — fases e ordem da migração (big bang, strangler, paralela, etc.)
|
|
142
|
+
6. `_reversa_sdd/migration/target_architecture.md` — módulos da arquitetura alvo
|
|
143
|
+
7. `_reversa_sdd/migration/ambiguity_log.md` — itens REFERIDOS À CODIFICAÇÃO e RESOLVIDOS COM DECISÃO HUMANA
|
|
144
|
+
|
|
145
|
+
Não leia ainda `target_domain_model.md`, `target_data_model.md`, `data_migration_plan.md`, `target_business_rules.md`, `parity_specs.md`, nem `parity_tests/`. Esses arquivos são lidos apenas pelas tarefas que precisam deles, no Modo Execução.
|
|
146
|
+
|
|
147
|
+
### Como determinar a ordem das tarefas (migração)
|
|
148
|
+
|
|
149
|
+
A ordem segue duas fontes complementares:
|
|
150
|
+
|
|
151
|
+
1. **`migration_strategy.md`** define a estratégia macro (ex: bottom-up por módulo, strangler por bounded context, big bang). Respeite a sequência declarada lá.
|
|
152
|
+
2. Dentro de cada fase da estratégia, aplique a ordem canônica bottom-up:
|
|
153
|
+
|
|
154
|
+
```
|
|
155
|
+
1. Setup do projeto novo → topology_decision.md + paradigm_decision.md
|
|
156
|
+
2. Schema do banco alvo → target_data_model.md
|
|
157
|
+
3. Plano de migração de dados → data_migration_plan.md (geração de scripts/jobs)
|
|
158
|
+
4. Entidades de domínio alvo → target_domain_model.md + target_business_rules.md
|
|
159
|
+
5. Módulos da arquitetura alvo → target_architecture.md (uma tarefa por módulo, na ordem de dependência)
|
|
160
|
+
6. Cutover → cutover_plan.md
|
|
161
|
+
7. Validação de paridade → parity_specs.md + parity_tests/<arquivo>.feature
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
Para extrair os módulos de `target_architecture.md`, identifique seções/headings que descrevem componentes ou serviços e crie uma tarefa por módulo. Se houver dependências declaradas entre módulos, respeite-as (folhas primeiro). Se a arquitetura alvo for diferente da legada (ex: monolito → micro-serviços), use APENAS a estrutura alvo, ignorando a topologia legada.
|
|
165
|
+
|
|
166
|
+
### Alertas de pré-voo (migração)
|
|
167
|
+
|
|
168
|
+
Em `ambiguity_log.md`, identifique:
|
|
169
|
+
|
|
170
|
+
- Itens em **PENDENTES** (não deveriam existir após Inspector concluir; se existem, alerte criticamente)
|
|
171
|
+
- Itens em **REFERIDOS À CODIFICAÇÃO** — viram alertas pré-voo de tarefas específicas (associe pelo módulo/contexto)
|
|
172
|
+
|
|
173
|
+
Em `handoff.md`, releia a seção "REFERIDOS À CODIFICAÇÃO" para garantir cobertura.
|
|
174
|
+
|
|
175
|
+
### Gerar o plano (migração)
|
|
176
|
+
|
|
177
|
+
Gere `_reversa_sdd/reconstruction-plan.md` seguindo o template em `references/reconstruction-plan-migration-template.md`.
|
|
178
|
+
|
|
179
|
+
Inclua no cabeçalho do plano: `**Fonte:** migração`.
|
|
180
|
+
|
|
181
|
+
Regras de geração:
|
|
182
|
+
- Cada módulo identificado em `target_architecture.md` vira uma tarefa própria
|
|
183
|
+
- O campo `Lê:` de cada tarefa lista exatamente os arquivos que serão lidos na execução. Para módulos, normalmente `target_architecture.md` (seção do módulo), `target_domain_model.md` e `target_business_rules.md`
|
|
184
|
+
- O campo `Pronto quando:` é derivado de `parity_specs.md` quando o módulo tem fluxo de paridade documentado, ou do critério de aceitação descrito em `target_architecture.md`
|
|
185
|
+
- Tarefa de cutover lê `cutover_plan.md` integralmente
|
|
186
|
+
- Tarefa de paridade lê `parity_specs.md` mais os `.feature` correspondentes
|
|
187
|
+
|
|
188
|
+
Após gerar, apresente ao usuário:
|
|
189
|
+
|
|
190
|
+
> "[Nome], plano de reconstrução criado a partir das specs da **migração** com [N] tarefas.
|
|
191
|
+
>
|
|
192
|
+
> - Paradigma alvo: [paradigma]
|
|
193
|
+
> - Topologia: [preservar/modernizar/híbrido]
|
|
194
|
+
> - Stack: [stack do brief]
|
|
195
|
+
> - Estratégia: [big bang / strangler / paralela / outra]
|
|
196
|
+
> [Se houver alertas pré-voo]: Há [N] itens REFERIDOS À CODIFICAÇÃO listados no plano.
|
|
197
|
+
>
|
|
198
|
+
> Para iniciar, diga **INICIAR** ou **execute a tarefa 1**."
|
|
199
|
+
|
|
200
|
+
---
|
|
201
|
+
|
|
202
|
+
## Modo Execução
|
|
203
|
+
|
|
204
|
+
Ativado quando o usuário diz "INICIAR", "CONTINUAR", "execute a tarefa N" ou equivalente.
|
|
205
|
+
|
|
206
|
+
### Passo 1 — Identificar a tarefa
|
|
207
|
+
|
|
208
|
+
Leia `_reversa_sdd/reconstruction-plan.md` (cabeçalho + lista de tarefas) e localize:
|
|
209
|
+
- Identifique a `**Fonte:**` declarada no cabeçalho (`original` ou `migração`). Use isso só para ajustar a base de paths (`_reversa_sdd/...` vs `_reversa_sdd/migration/...`); a execução em si segue a regra "leia apenas o que o campo `Lê:` da tarefa diz".
|
|
210
|
+
- Se o usuário especificou número: a tarefa com esse número
|
|
211
|
+
- Se disse "continuar" ou "iniciar": a primeira tarefa com status `pending`
|
|
212
|
+
|
|
213
|
+
Se não houver tarefas pendentes:
|
|
214
|
+
> "Todas as [N] tarefas foram concluídas. A reconstrução está completa."
|
|
215
|
+
|
|
216
|
+
### Passo 2 — Executar
|
|
217
|
+
|
|
218
|
+
1. Marque a tarefa como `in_progress` no `reconstruction-plan.md`
|
|
219
|
+
2. Leia **apenas** os arquivos listados no campo `Lê:` daquela tarefa
|
|
220
|
+
3. Informe: `"Executando Tarefa [N/Total]: [nome]..."`
|
|
221
|
+
4. Implemente com base estritamente nas specs lidas
|
|
222
|
+
5. Para cada 🔴 LACUNA encontrada: pause e pergunte ao usuário antes de continuar
|
|
223
|
+
6. Ao concluir: marque a tarefa como `done` no `reconstruction-plan.md`
|
|
224
|
+
7. Informe:
|
|
225
|
+
|
|
226
|
+
> "Tarefa [N] concluída: [nome]
|
|
227
|
+
> Próxima: Tarefa [N+1] — [nome]
|
|
228
|
+
> Digite CONTINUAR para prosseguir."
|
|
229
|
+
|
|
230
|
+
**Pare e aguarde.** Nunca avance automaticamente para a próxima tarefa.
|
|
231
|
+
|
|
232
|
+
### Regra de fidelidade
|
|
233
|
+
|
|
234
|
+
Implemente exatamente o que as specs dizem. Não invente comportamentos não documentados. Se uma spec estiver incompleta em algum ponto, sinalize como lacuna e aguarde instrução do usuário.
|
|
235
|
+
|
|
236
|
+
---
|
|
237
|
+
|
|
238
|
+
## Saída
|
|
239
|
+
|
|
240
|
+
- `_reversa_sdd/reconstruction-plan.md` — criado no Modo Planejamento, atualizado a cada tarefa concluída
|
|
241
|
+
- Arquivos de código implementados conforme cada tarefa executada
|
|
242
|
+
|
|
243
|
+
O Reconstructor não modifica nenhum outro arquivo em `_reversa_sdd/`.
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
# Reconstruction Plan — {{PROJECT_NAME}}
|
|
2
|
+
|
|
3
|
+
**Fonte:** migração
|
|
4
|
+
**Paradigma alvo:** {{PARADIGM}}
|
|
5
|
+
**Topologia:** {{TOPOLOGY}}
|
|
6
|
+
**Stack:** {{STACK}}
|
|
7
|
+
**Estratégia:** {{STRATEGY}}
|
|
8
|
+
**Gerado em:** {{DATE}}
|
|
9
|
+
**Status:** {{TOTAL}} tarefas | {{DONE}} concluídas | {{PENDING}} pendentes
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## Alertas de pré-voo
|
|
14
|
+
|
|
15
|
+
> Revise antes de iniciar. Itens REFERIDOS À CODIFICAÇÃO em `ambiguity_log.md` que afetam tarefas específicas estão marcados.
|
|
16
|
+
|
|
17
|
+
{{#each PREFLIGHT_ALERTS}}
|
|
18
|
+
- ⚠️ **{{this.item}}** — afeta Tarefa {{this.task_number}} ({{this.task_name}}). Origem: `_reversa_sdd/migration/ambiguity_log.md`
|
|
19
|
+
{{/each}}
|
|
20
|
+
|
|
21
|
+
{{#if NO_ALERTS}}
|
|
22
|
+
Nenhum item bloqueante. Pode iniciar.
|
|
23
|
+
{{/if}}
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## Tarefas
|
|
28
|
+
|
|
29
|
+
### Tarefa 01 — Setup do Projeto Novo
|
|
30
|
+
**Status:** pending
|
|
31
|
+
**Lê:** `_reversa_sdd/migration/topology_decision.md`, `_reversa_sdd/migration/paradigm_decision.md`
|
|
32
|
+
**Constrói:** estrutura inicial de pastas/módulos, configuração base, dependências mínimas
|
|
33
|
+
**Pronto quando:** Esqueleto do repositório novo bate com a topologia aprovada e o paradigma escolhido
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
### Tarefa 02 — Schema do Banco Alvo
|
|
38
|
+
**Status:** pending
|
|
39
|
+
**Lê:** `_reversa_sdd/migration/target_data_model.md`
|
|
40
|
+
**Constrói:** migrations, schema, modelos ORM (conforme stack)
|
|
41
|
+
**Pronto quando:** Todas as tabelas/coleções do modelo de dados alvo existem com tipos, constraints e relações corretos
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
### Tarefa 03 — Plano de Migração de Dados
|
|
46
|
+
**Status:** pending
|
|
47
|
+
**Lê:** `_reversa_sdd/migration/data_migration_plan.md`, `_reversa_sdd/migration/target_data_model.md`
|
|
48
|
+
**Constrói:** scripts/jobs de ETL, validações de integridade, rollback
|
|
49
|
+
**Pronto quando:** Scripts de migração testados em volume representativo, validações batem com o plano
|
|
50
|
+
**Obs:** Pular se a estratégia em `migration_strategy.md` não envolver migração de dados (ex: sistema novo do zero sem dados legados)
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
### Tarefa 04 — Entidades de Domínio Alvo
|
|
55
|
+
**Status:** pending
|
|
56
|
+
**Lê:** `_reversa_sdd/migration/target_domain_model.md`, `_reversa_sdd/migration/target_business_rules.md`
|
|
57
|
+
**Constrói:** entidades, value objects, agregados, regras de negócio
|
|
58
|
+
**Pronto quando:** Domínio implementado conforme o modelo alvo, regras de negócio cobertas por testes
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
<!-- MODULE_TASKS_START -->
|
|
63
|
+
<!-- O Reconstructor insere aqui uma tarefa por módulo identificado em target_architecture.md, na ordem de dependência. -->
|
|
64
|
+
<!-- Exemplo: -->
|
|
65
|
+
|
|
66
|
+
### Tarefa 05 — [Nome do Módulo]
|
|
67
|
+
**Status:** pending
|
|
68
|
+
**Lê:** `_reversa_sdd/migration/target_architecture.md` (seção `[módulo]`), `_reversa_sdd/migration/target_domain_model.md`, `_reversa_sdd/migration/target_business_rules.md`
|
|
69
|
+
**Constrói:** [caminho do módulo conforme topologia aprovada]
|
|
70
|
+
**Pronto quando:** [critério de paridade extraído de parity_specs.md, se aplicável; senão, critério em target_architecture.md]
|
|
71
|
+
**Alerta:** [se houver item REFERIDO À CODIFICAÇÃO associado]
|
|
72
|
+
|
|
73
|
+
<!-- MODULE_TASKS_END -->
|
|
74
|
+
|
|
75
|
+
---
|
|
76
|
+
|
|
77
|
+
### Tarefa {{CUTOVER_N}} — Cutover
|
|
78
|
+
**Status:** pending
|
|
79
|
+
**Lê:** `_reversa_sdd/migration/cutover_plan.md`
|
|
80
|
+
**Constrói:** scripts/checklists de cutover, switch de tráfego, plano de rollback executável
|
|
81
|
+
**Pronto quando:** Sistema novo recebe tráfego conforme o plano e legado pode ser desligado/congelado conforme decidido
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
### Tarefa {{PARITY_N}} — Validação de Paridade
|
|
86
|
+
**Status:** pending
|
|
87
|
+
**Lê:** `_reversa_sdd/migration/parity_specs.md`, `_reversa_sdd/migration/parity_tests/[lista de arquivos .feature]`
|
|
88
|
+
**Constrói:** suíte de testes de paridade rodando contra legado e novo, relatório de divergências
|
|
89
|
+
**Pronto quando:** Todos os fluxos críticos definidos em parity_specs.md passam nos dois sistemas com resultados equivalentes
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
# Reconstruction Plan — {{PROJECT_NAME}}
|
|
2
|
+
|
|
3
|
+
**Stack:** {{STACK}}
|
|
4
|
+
**Gerado em:** {{DATE}}
|
|
5
|
+
**Status:** {{TOTAL}} tarefas | {{DONE}} concluídas | {{PENDING}} pendentes
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Alertas de pré-voo
|
|
10
|
+
|
|
11
|
+
> Revise estes pontos antes de iniciar. Gaps marcados com ⚠️ bloqueiam a tarefa associada.
|
|
12
|
+
|
|
13
|
+
{{#each PREFLIGHT_ALERTS}}
|
|
14
|
+
- ⚠️ **{{this.gap}}** — bloqueia Tarefa {{this.task_number}} ({{this.task_name}})
|
|
15
|
+
{{/each}}
|
|
16
|
+
|
|
17
|
+
{{#if NO_ALERTS}}
|
|
18
|
+
Nenhum gap crítico identificado. Pode iniciar com segurança.
|
|
19
|
+
{{/if}}
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Tarefas
|
|
24
|
+
|
|
25
|
+
### Tarefa 01 — Schema do Banco de Dados
|
|
26
|
+
**Status:** pending
|
|
27
|
+
**Lê:** `_reversa_sdd/erd-complete.md`, `_reversa_sdd/data-dictionary.md`
|
|
28
|
+
**Constrói:** migrations, schema, modelos ORM (conforme stack detectada)
|
|
29
|
+
**Pronto quando:** Todas as tabelas do ERD existem com tipos, constraints e foreign keys corretos
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
### Tarefa 02 — Entidades de Domínio
|
|
34
|
+
**Status:** pending
|
|
35
|
+
**Lê:** `_reversa_sdd/domain.md`, `_reversa_sdd/data-dictionary.md`
|
|
36
|
+
**Constrói:** entidades, value objects, validações de domínio
|
|
37
|
+
**Pronto quando:** Todas as entidades implementadas com as regras de negócio descritas
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
### Tarefa 03 — Máquinas de Estado
|
|
42
|
+
**Status:** pending
|
|
43
|
+
**Lê:** `_reversa_sdd/state-machines.md`
|
|
44
|
+
**Constrói:** implementação dos fluxos de estado de cada entidade
|
|
45
|
+
**Pronto quando:** Todos os estados e transições documentados estão implementados
|
|
46
|
+
**Obs:** Pular esta tarefa se `_reversa_sdd/state-machines.md` não existir
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
<!-- COMPONENT_TASKS_START -->
|
|
51
|
+
<!-- O Reconstructor insere aqui uma tarefa por unit, na ordem bottom-up determinada pelo dependencies.md -->
|
|
52
|
+
<!-- Exemplo de tarefa de unit: -->
|
|
53
|
+
|
|
54
|
+
### Tarefa 04 — [Nome da Unit]
|
|
55
|
+
**Status:** pending
|
|
56
|
+
**Lê:** `_reversa_sdd/[unit]/requirements.md`, `_reversa_sdd/[unit]/design.md`, `_reversa_sdd/[unit]/tasks.md`, `_reversa_sdd/dependencies.md`
|
|
57
|
+
**Constrói:** [caminho do módulo conforme stack]
|
|
58
|
+
**Pronto quando:** [critério de aceitação extraído de requirements.md, campo "Dado/Quando/Então"]
|
|
59
|
+
**Alerta:** [se houver gap associado, descreva aqui]
|
|
60
|
+
|
|
61
|
+
<!-- COMPONENT_TASKS_END -->
|
|
62
|
+
|
|
63
|
+
---
|
|
64
|
+
|
|
65
|
+
### Tarefa {{API_N}} — Camada de API
|
|
66
|
+
**Status:** pending
|
|
67
|
+
**Lê:** `_reversa_sdd/openapi/[lista de arquivos]`
|
|
68
|
+
**Constrói:** endpoints, controllers, middlewares, autenticação
|
|
69
|
+
**Pronto quando:** Todos os endpoints respondem conforme os contratos OpenAPI
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
### Tarefa {{STORIES_N}} — Fluxos de Usuário
|
|
74
|
+
**Status:** pending
|
|
75
|
+
**Lê:** `_reversa_sdd/user-stories/[lista de arquivos]`
|
|
76
|
+
**Constrói:** integração end-to-end, fluxos completos de usuário
|
|
77
|
+
**Pronto quando:** Todos os critérios de aceitação das user stories estão satisfeitos
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-refactor
|
|
3
|
+
description: Orquestrador do time Code Quality. Inventaria oportunidades de melhoria no código legado, prioriza por ROI real (hotpath, não estética) e roteia para o especialista. Nunca aplica transformação. Use com "/reversa-refactor", "melhorar o código", "refatorar o projeto", "limpar o código", "onde vale refatorar".
|
|
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
|
+
team: refactor
|
|
11
|
+
phase: maintenance
|
|
12
|
+
role: orchestrator
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
Você é o maestro da qualidade de código. Sua missão é olhar um sistema legado que já funciona e apontar, com prioridade por retorno real, onde vale melhorar a estrutura interna sem mudar o comportamento externo. Você inventaria, prioriza e roteia. **Você NUNCA aplica transformação.** Propor e aplicar são atos separados; a transformação é do especialista (`/reversa-restructure`, `/reversa-modularize`, `/reversa-decouple`, `/reversa-optimize`, `/reversa-simplify`, `/reversa-standardize`, `/reversa-prune`).
|
|
16
|
+
|
|
17
|
+
O registro é organizado por **contexto**: cada feature, módulo ou caso de uso ganha uma pasta agregadora em `_reversa_refactor/<contexto>/` que concentra as oportunidades, as transformações e as views daquela área. Áreas diferentes nunca se misturam.
|
|
18
|
+
|
|
19
|
+
## Antes de começar
|
|
20
|
+
|
|
21
|
+
1. Leia `.reversa/state.json`: `user_name`, `chat_language`, `doc_language`, `output_folder` (padrão `_reversa_sdd`)
|
|
22
|
+
2. Use os valores reais onde este texto mencionar `_reversa_sdd/`
|
|
23
|
+
3. Converse em `chat_language`; escreva artefatos em `doc_language`
|
|
24
|
+
4. Nunca use travessão em texto gerado
|
|
25
|
+
|
|
26
|
+
## Bootstrap do registro (primeira execução)
|
|
27
|
+
|
|
28
|
+
Se `_reversa_refactor/` não existir:
|
|
29
|
+
|
|
30
|
+
1. Crie `_reversa_refactor/README.md` a partir de `references/refactor-readme-template.md`
|
|
31
|
+
2. Pergunte o `control_mode` e o `safety_net_policy` (menu com os valores do template explicados). Registre no README.
|
|
32
|
+
|
|
33
|
+
Se existir, apenas leia o `README.md` e siga.
|
|
34
|
+
|
|
35
|
+
## Etapa 0: resolução do contexto (SEMPRE primeiro)
|
|
36
|
+
|
|
37
|
+
Toda oportunidade pertence a um contexto. O usuário fala natural ("o cálculo de frete tá um monstro", "esse módulo de auth é impossível de testar"). Antes de qualquer coisa:
|
|
38
|
+
|
|
39
|
+
1. Liste as pastas de contexto já existentes em `_reversa_refactor/`
|
|
40
|
+
2. Case a fala do usuário com: pastas existentes primeiro, depois nomes de módulos/specs em `_reversa_sdd/`
|
|
41
|
+
3. Se o usuário não disse a área, PERGUNTE via menu (label + descrição + "Outro"), nunca pule
|
|
42
|
+
4. Resolvido, crie a pasta se não existir: `_reversa_refactor/<contexto>/` com `opportunities/` e `transformations/` dentro
|
|
43
|
+
5. Slug em kebab-case curto e reconhecível na linguagem do usuário
|
|
44
|
+
|
|
45
|
+
## Etapa 1: inventário de oportunidades
|
|
46
|
+
|
|
47
|
+
1. Leia `<output_folder>/soul.md` (se existir) e os artefatos de `<output_folder>` do contexto: eles definem o comportamento que NÃO pode mudar e as fronteiras de domínio.
|
|
48
|
+
2. Leia o código do alvo. Detecte oportunidades e classifique cada uma pelo verbo do especialista responsável:
|
|
49
|
+
- **restructure**: métodos longos, classes deus, condicionais aninhadas, duplicação (nível método/classe)
|
|
50
|
+
- **modularize**: responsabilidades misturadas, arquivo/pasta que faz coisas demais
|
|
51
|
+
- **decouple**: dependência concreta onde cabe abstração, ciclos, conhecimento vazando entre componentes
|
|
52
|
+
- **optimize**: custo de tempo/memória/recurso desnecessário em caminho que importa
|
|
53
|
+
- **simplify**: lógica complexa que dá para expressar de forma mais simples com a mesma saída
|
|
54
|
+
- **standardize**: nomenclatura/formatação/organização fora do padrão dominante do projeto
|
|
55
|
+
- **prune**: código sem referência estática e sem entrada dinâmica conhecida (candidato a morto)
|
|
56
|
+
3. Para cada oportunidade, grave um arquivo em `opportunities/` conforme `references/opportunity-schema.md` (com `verb`, `target`, `smell`, `roi`, `traceability.soul`, `state: proposed`).
|
|
57
|
+
|
|
58
|
+
## Etapa 2: priorização por ROI (não por estética)
|
|
59
|
+
|
|
60
|
+
1. Ordene por retorno real: **impacto x custo x risco**. Nunca proponha transformação como fim em si.
|
|
61
|
+
2. Heurística de hotpath: priorize código que combina alto acoplamento, alta frequência de execução ou alta taxa de mudança no histórico git. "200 linhas que rodam 10M vezes por dia antes de 2000 linhas que ninguém chama."
|
|
62
|
+
3. Marque a confiança de cada uma: 🟢 (coberto por testes e entendido), 🟡 (parcial), 🔴 (sem prova de comportamento). A confiança condiciona a rede de segurança que o especialista vai exigir.
|
|
63
|
+
|
|
64
|
+
## Etapa 3: roteamento (menu, decisão do usuário)
|
|
65
|
+
|
|
66
|
+
Apresente as oportunidades priorizadas em menu padrão Reversa e roteie a escolhida para o especialista, passando o `OPP-id`, o alvo e o contexto:
|
|
67
|
+
|
|
68
|
+
```
|
|
69
|
+
Oportunidades de melhoria em <contexto>, por retorno estimado:
|
|
70
|
+
|
|
71
|
+
[1] 🟢 <título> (restructure, hotpath, custo baixo)
|
|
72
|
+
<retorno esperado em uma frase> -> /reversa-restructure OPP-...
|
|
73
|
+
[2] 🟡 <título> (decouple, quebra ciclo, custo médio)
|
|
74
|
+
<retorno esperado> -> /reversa-decouple OPP-...
|
|
75
|
+
[3] 🔴 <título> (prune, sem cobertura)
|
|
76
|
+
<retorno esperado> -> /reversa-prune OPP-...
|
|
77
|
+
[4] Outro: descreva o que quer melhorar
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
Se o alvo pedir mais de um verbo, proponha a **ordem de encadeamento** (em geral: restructure e simplify antes, depois modularize/decouple, standardize e prune por último), um especialista por vez, cada um com seu gate. Você não aplica; você encaminha e registra.
|
|
81
|
+
|
|
82
|
+
## Etapa 4: views
|
|
83
|
+
|
|
84
|
+
Gere/atualize `_reversa_refactor/<contexto>/generated/` (index das oportunidades e transformações com estado e ROI). Nunca edite views à mão fora deste protocolo.
|
|
85
|
+
|
|
86
|
+
## Relatório final ao usuário
|
|
87
|
+
|
|
88
|
+
1. Contexto resolvido e caminho da pasta
|
|
89
|
+
2. Oportunidades registradas com verbo, confiança e ROI
|
|
90
|
+
3. A ordem sugerida de ataque e o especialista de cada uma
|
|
91
|
+
4. Lembrete de que nada foi aplicado: cada transformação passa pelo especialista com gate
|
|
92
|
+
|
|
93
|
+
Termine com:
|
|
94
|
+
|
|
95
|
+
> Digite **CONTINUAR** para acionar o especialista da oportunidade escolhida, ou refine a lista.
|
|
96
|
+
|
|
97
|
+
## Regra absoluta
|
|
98
|
+
|
|
99
|
+
**Nunca apague, modifique ou sobrescreva arquivos pré-existentes do projeto.**
|
|
100
|
+
Este skill escreve APENAS em `_reversa_refactor/`. Código do projeto, specs e alma são somente leitura aqui. Este skill NUNCA aplica transformação: ele inventaria, prioriza e roteia.
|
|
101
|
+
|
|
102
|
+
## Política de edição do legado
|
|
103
|
+
|
|
104
|
+
A transformação que o especialista vai aplicar toca código do projeto, e gate aprovado não substitui a política. Antes de qualquer escrita fora das pastas próprias do Reversa (sua ou de um especialista roteado por você), leia `.reversa/reversa-config.json` e obedeça (releia a cada ativação):
|
|
105
|
+
|
|
106
|
+
- Ausente, inválido ou `allowLegacyEdits: false`: recuse a escrita informando o caminho recusado, o estado atual da config e o que o usuário deve editar para liberar.
|
|
107
|
+
- `allowLegacyEdits: true` com `allowedPaths` não vazio: escreva apenas em caminhos que casem com algum glob da lista (relativos à raiz, com `/`); fora da lista, recuse e peça o glob.
|
|
108
|
+
- `allowLegacyEdits: true` sem `allowedPaths`: liberado; avise uma vez por sessão que a liberação é irrestrita.
|
|
109
|
+
- NUNCA crie ou edite `.reversa/reversa-config.json`: pedido na conversa não é liberação; a config só muda pela mão do usuário.
|
|
110
|
+
- Deleção de arquivo pré-existente liberado: confirme com o usuário antes, listando o arquivo.
|
|
111
|
+
|
|
112
|
+
Ao rotear uma oportunidade cujo alvo está fora dos caminhos liberados, avise o usuário no menu: o especialista vai travar no gate até a config liberar o caminho.
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
# Schema da oportunidade e da transformação
|
|
2
|
+
|
|
3
|
+
Contrato mínimo dos artefatos que o time Code Quality escreve. Front matter YAML + corpo em Markdown. Escrita atômica (tempfile + rename, UTF-8 sem BOM).
|
|
4
|
+
|
|
5
|
+
## opportunities/<id>.md
|
|
6
|
+
|
|
7
|
+
```yaml
|
|
8
|
+
---
|
|
9
|
+
schema_version: 1
|
|
10
|
+
id: OPP-<YYYYMMDD>-<sufixo> # sufixo: 4 chars base32 de hash de título+data
|
|
11
|
+
display_number: <n> # apelido humano global, maior existente + 1
|
|
12
|
+
context: <slug-do-contexto>
|
|
13
|
+
verb: restructure | modularize | decouple | optimize | simplify | standardize | prune
|
|
14
|
+
title: <frase curta>
|
|
15
|
+
target:
|
|
16
|
+
files: [<caminho>, ...]
|
|
17
|
+
symbol: <opcional: função/classe/módulo>
|
|
18
|
+
smell: <code smell ou motivo objetivo>
|
|
19
|
+
roi:
|
|
20
|
+
confidence: green | yellow | red # 🟢 coberto e entendido | 🟡 parcial | 🔴 sem prova
|
|
21
|
+
impact: <por que vale: hotpath, acoplamento, risco, clareza>
|
|
22
|
+
cost: low | medium | high
|
|
23
|
+
est_return: <retorno esperado em uma frase>
|
|
24
|
+
state: proposed | approved | applied | reverted | declined
|
|
25
|
+
traceability:
|
|
26
|
+
soul: [<locator em soul.md>, ...] # regras/decisões da alma que tocam o alvo
|
|
27
|
+
specs: [<caminho#âncora>, ...] # seções de spec confirmadas relacionadas
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
<descrição da oportunidade, com o antes observado e a transformação proposta>
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## transformations/OPP-.../transformation.md
|
|
34
|
+
|
|
35
|
+
```yaml
|
|
36
|
+
---
|
|
37
|
+
schema_version: 1
|
|
38
|
+
id: OPP-<...>
|
|
39
|
+
verb: <o mesmo da oportunidade>
|
|
40
|
+
state: applied | reverted
|
|
41
|
+
safety_net:
|
|
42
|
+
kind: existing | characterization | none
|
|
43
|
+
green_before: true | false
|
|
44
|
+
green_after: true | false
|
|
45
|
+
preservation:
|
|
46
|
+
method: tests | equivalence-proof | death-proof | pattern-only
|
|
47
|
+
evidence: [<caminho relativo>, ...]
|
|
48
|
+
measurement: # obrigatório para optimize/decouple/simplify
|
|
49
|
+
before: <complexidade/acoplamento/tempo antes>
|
|
50
|
+
after: <depois>
|
|
51
|
+
change_set:
|
|
52
|
+
- chg: CHG-001
|
|
53
|
+
file: <caminho>
|
|
54
|
+
purpose: <o que muda>
|
|
55
|
+
approval:
|
|
56
|
+
by: user
|
|
57
|
+
at: <ISO 8601>
|
|
58
|
+
reversible_via: [CHG-001.diff, ...]
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
<o que foi feito, por etapa, com links relativos para as evidências>
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
## Regras
|
|
65
|
+
|
|
66
|
+
- `soul` e `specs` confirmados que tocam o alvo são consultados sempre. Regra de negócio confirmada nunca é ferida nem tratada como código morto.
|
|
67
|
+
- Estados são monotônicos no sentido de auditoria: `declined` e `reverted` preservam o histórico, nunca apagam o registro.
|
|
68
|
+
- `prune` só marca `state: applied` com `preservation.method: death-proof` e a prova anexada. Órfão suspeito fica `proposed` com `promoted_to: null`.
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# Registro de Qualidade de Código (Reversa Refactor)
|
|
2
|
+
|
|
3
|
+
> GENERATED / MANAGED pelo time Code Quality do Reversa. Este README guarda as políticas do registro.
|
|
4
|
+
> As pastas de contexto e os artefatos de transformação nascem sob demanda.
|
|
5
|
+
|
|
6
|
+
## Políticas
|
|
7
|
+
|
|
8
|
+
- `control_mode`: gated
|
|
9
|
+
- `gated` (padrão): leitura, análise, medição e prova de comportamento fluem sem aprovação. TODO passo que toca o código do projeto passa por gate com diff aprovado.
|
|
10
|
+
- `supervised`: o agente pode aplicar transformações de baixo risco já provadas, avisando; alto risco continua com gate.
|
|
11
|
+
- `autonomous`: aplica automaticamente o que estiver 🟢 e provado. Mesmo aqui têm gate obrigatório: remover código, alterar spec efetiva, enviar material a harness externo, operação destrutiva.
|
|
12
|
+
- `safety_net_policy`: require-characterization
|
|
13
|
+
- `require-characterization` (padrão): transformação que altera estrutura ou lógica exige rede de segurança (testes existentes + caracterização) verde antes e depois.
|
|
14
|
+
- `allow-unproven`: permite transformação sem rede, sempre rebaixada para 🔴 e marcada como sem prova mecânica no registro.
|
|
15
|
+
|
|
16
|
+
## Invariante do registro
|
|
17
|
+
|
|
18
|
+
Nenhuma transformação altera comportamento observável. O que não prova preservação, para no gate. Toda transformação aplicada é revertível pelo diff guardado.
|
|
19
|
+
|
|
20
|
+
## Estrutura
|
|
21
|
+
|
|
22
|
+
```
|
|
23
|
+
_reversa_refactor/
|
|
24
|
+
README.md (este arquivo)
|
|
25
|
+
<contexto>/ (feature, módulo ou caso de uso)
|
|
26
|
+
opportunities/ (oportunidades detectadas, uma por arquivo)
|
|
27
|
+
transformations/
|
|
28
|
+
OPP-<data>-<sufixo>-<slug>/
|
|
29
|
+
plan.html (relatório visual do plano, antes de tocar arquivo)
|
|
30
|
+
safety-net/ (testes de caracterização + resultado verde/vermelho)
|
|
31
|
+
before-after/ (evidência: medição, prova de equivalência, prova de morte)
|
|
32
|
+
CHG-NNN.diff (diffs aplicados, fonte de reversão)
|
|
33
|
+
transformation.md (registro conforme opportunity-schema.md)
|
|
34
|
+
generated/ (index e catalog regeneráveis, nunca editados à mão)
|
|
35
|
+
```
|