@flaviogarrido/reversa 0.0.0-stage → 1.3.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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,54 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: target_business_rules
|
|
7
|
+
producedBy: curator
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Target Business Rules
|
|
12
|
+
|
|
13
|
+
> Catálogo das regras de negócio do legado com decisão de migração: MIGRAR, DESCARTAR ou DECISÃO HUMANA.
|
|
14
|
+
> Cada item rastreia para a origem em `_reversa_sdd/` e respeita o `paradigm_decision.md`.
|
|
15
|
+
|
|
16
|
+
## Resumo
|
|
17
|
+
- Total de regras analisadas: <N>
|
|
18
|
+
- MIGRAR: <n>
|
|
19
|
+
- DESCARTAR: <n> (detalhe em `discard_log.md`)
|
|
20
|
+
- DECISÃO HUMANA: <n>
|
|
21
|
+
|
|
22
|
+
## Regras MIGRAR
|
|
23
|
+
|
|
24
|
+
### BR-MIGRAR-001
|
|
25
|
+
- **Origem**: `_reversa_sdd/<unit>/{requirements,design}.md` § <seção>
|
|
26
|
+
- **Confiança original**: 🟢 | 🟡 | 🔴 | ⚠️
|
|
27
|
+
- **Descrição**: <regra>
|
|
28
|
+
- **Justificativa de migração**: <por que migra>
|
|
29
|
+
- **Compatibilidade com paradigma alvo**: <nota; ex: precisará ser expressa como evento>
|
|
30
|
+
|
|
31
|
+
<repetir por regra>
|
|
32
|
+
|
|
33
|
+
## Regras DESCARTAR (resumo)
|
|
34
|
+
|
|
35
|
+
| ID | Origem | Motivo curto | Vínculo a paradigma? |
|
|
36
|
+
|---|---|---|---|
|
|
37
|
+
| BR-DESCARTAR-001 | <ref> | <motivo> | sim/não |
|
|
38
|
+
|
|
39
|
+
> Detalhe completo em `discard_log.md`.
|
|
40
|
+
|
|
41
|
+
## Regras DECISÃO HUMANA
|
|
42
|
+
|
|
43
|
+
### BR-HUMANA-001
|
|
44
|
+
- **Origem**: <ref>
|
|
45
|
+
- **Tipo de ambiguidade**: ⚠️ AMBÍGUA | 🔴 GAP | dependência de stakeholder
|
|
46
|
+
- **Descrição**: <regra>
|
|
47
|
+
- **Opções**: <opções claras>
|
|
48
|
+
- **Recomendação do Curator**: <opção sugerida e por quê>
|
|
49
|
+
- **Status**: PENDENTE | RESOLVIDA (escolha + decisor + data)
|
|
50
|
+
|
|
51
|
+
<repetir por item>
|
|
52
|
+
|
|
53
|
+
## Notas
|
|
54
|
+
<Observações gerais do Curator. Itens que serão consolidados em `ambiguity_log.md`.>
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: target_data_model
|
|
7
|
+
producedBy: designer
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Target Data Model
|
|
12
|
+
|
|
13
|
+
> Modelo de dados do sistema novo. Schema, relacionamentos e restrições.
|
|
14
|
+
|
|
15
|
+
## Visão geral
|
|
16
|
+
<Texto curto: tipo de banco principal, divisão por bounded context, papéis (OLTP / OLAP / event store).>
|
|
17
|
+
|
|
18
|
+
## Entidades de dados
|
|
19
|
+
|
|
20
|
+
| Entidade | Tabela / coleção | Aggregate dono | PK | Bounded context |
|
|
21
|
+
|---|---|---|---|---|
|
|
22
|
+
| <nome> | <ref> | <AGG> | <campo> | <BC> |
|
|
23
|
+
|
|
24
|
+
## Schema (DDL ou equivalente)
|
|
25
|
+
|
|
26
|
+
```sql
|
|
27
|
+
-- Substituir pelo DDL real do sistema alvo.
|
|
28
|
+
CREATE TABLE pedidos (
|
|
29
|
+
id UUID PRIMARY KEY,
|
|
30
|
+
cliente_id UUID NOT NULL,
|
|
31
|
+
status TEXT NOT NULL,
|
|
32
|
+
criado_em TIMESTAMPTZ NOT NULL DEFAULT NOW()
|
|
33
|
+
);
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## Relacionamentos
|
|
37
|
+
|
|
38
|
+
| Origem | Destino | Cardinalidade | Integridade | Notas |
|
|
39
|
+
|---|---|---|---|---|
|
|
40
|
+
| pedidos.cliente_id | clientes.id | N:1 | FK ON DELETE RESTRICT | |
|
|
41
|
+
|
|
42
|
+
## Restrições
|
|
43
|
+
|
|
44
|
+
- **Unicidade**: <lista>
|
|
45
|
+
- **Integridade referencial**: <ativada / desativada e por quê>
|
|
46
|
+
- **Particionamento / sharding** (se aplicável): <descrição>
|
|
47
|
+
- **Índices críticos**: <lista>
|
|
48
|
+
|
|
49
|
+
## Considerações específicas do paradigma alvo
|
|
50
|
+
|
|
51
|
+
> Seção dedicada quando o paradigma alvo é event-driven, funcional ou outro com implicação direta no modelo de dados.
|
|
52
|
+
|
|
53
|
+
- <ex: event-driven → tabela de outbox para garantia at-least-once>
|
|
54
|
+
- <ex: event sourcing → store de eventos como fonte da verdade, projeções derivadas>
|
|
55
|
+
- <ex: imutabilidade → eventos / snapshots imutáveis, sem updates>
|
|
56
|
+
|
|
57
|
+
## Origem no legado
|
|
58
|
+
|
|
59
|
+
| Tabela / coleção nova | Origem no legado | Transformação |
|
|
60
|
+
|---|---|---|
|
|
61
|
+
| pedidos | `<schema legado>.tb_pedidos` | renomeação + tipos normalizados |
|
|
62
|
+
|
|
63
|
+
## Notas
|
|
64
|
+
<Observações adicionais sobre o modelo de dados.>
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: target_domain_model
|
|
7
|
+
producedBy: designer
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Target Domain Model
|
|
12
|
+
|
|
13
|
+
> Modelo de domínio do sistema novo. Rastreabilidade explícita para o legado (em `_reversa_sdd/domain.md` ou equivalente).
|
|
14
|
+
|
|
15
|
+
## Aggregates
|
|
16
|
+
|
|
17
|
+
### AGG-Pedido
|
|
18
|
+
- **Aggregate root**: Pedido
|
|
19
|
+
- **Invariantes**:
|
|
20
|
+
- <invariante 1>
|
|
21
|
+
- <invariante 2>
|
|
22
|
+
- **Comandos aceitos**: <lista>
|
|
23
|
+
- **Eventos publicados** (se paradigma event-driven): <lista>
|
|
24
|
+
- **Origem no legado**: <ref para `domain.md` ou equivalente>
|
|
25
|
+
|
|
26
|
+
<repetir por aggregate>
|
|
27
|
+
|
|
28
|
+
## Entidades
|
|
29
|
+
|
|
30
|
+
| Entidade | Aggregate dono | Atributos principais | Origem no legado |
|
|
31
|
+
|---|---|---|---|
|
|
32
|
+
| <nome> | <agg> | <lista resumida> | <ref> |
|
|
33
|
+
|
|
34
|
+
## Value objects
|
|
35
|
+
|
|
36
|
+
| Value object | Atributos | Validações | Origem |
|
|
37
|
+
|---|---|---|---|
|
|
38
|
+
| <nome> | <lista> | <regras> | <ref> |
|
|
39
|
+
|
|
40
|
+
## Eventos de domínio
|
|
41
|
+
> Seção obrigatória se o paradigma é event-driven ou híbrido.
|
|
42
|
+
|
|
43
|
+
| Evento | Publicado por | Consumido por | Schema (resumido) |
|
|
44
|
+
|---|---|---|---|
|
|
45
|
+
| <PedidoCriado> | AGG-Pedido | Pagamento, Estoque | <campos> |
|
|
46
|
+
|
|
47
|
+
## Regras de domínio
|
|
48
|
+
> Mapeamento de regras vindas de `target_business_rules.md` (apenas as MIGRAR) para os aggregates / serviços onde elas vivem agora.
|
|
49
|
+
|
|
50
|
+
| Regra (ID) | Local no domínio novo | Origem (target_business_rules.md) |
|
|
51
|
+
|---|---|---|
|
|
52
|
+
| BR-MIGRAR-001 | AGG-Pedido.invariante <nome> | BR-MIGRAR-001 |
|
|
53
|
+
|
|
54
|
+
## Rastreabilidade para o legado
|
|
55
|
+
|
|
56
|
+
| Elemento novo | Origem no legado | Tipo de mapeamento |
|
|
57
|
+
|---|---|---|
|
|
58
|
+
| AGG-Pedido | `domain.md § Pedido` + `sdd/orders.md` | fundido |
|
|
59
|
+
| <novo> | <ref> | 1-para-1 / fundido / dividido / novo |
|
|
60
|
+
|
|
61
|
+
## Notas
|
|
62
|
+
<Observações de modelagem adicionais.>
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
kind: migration_strategies
|
|
4
|
+
description: Catálogo consultivo de estratégias de migração com critérios de aplicabilidade. Usado pelo Strategist.
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Migration Strategies
|
|
8
|
+
|
|
9
|
+
> Catálogo das estratégias canônicas de migração com critérios de aplicabilidade, custo, risco, tempo, exemplo e referências.
|
|
10
|
+
> Atualizar este catálogo é tarefa de manutenção independente do agente Strategist.
|
|
11
|
+
|
|
12
|
+
## Estratégias
|
|
13
|
+
|
|
14
|
+
### Strangler Fig
|
|
15
|
+
- **Descrição**: Sistema novo cresce ao redor do legado, capturando funcionalidades incrementalmente até o legado poder ser desligado.
|
|
16
|
+
- **Quando aplica**:
|
|
17
|
+
- Sistema em produção que não pode parar.
|
|
18
|
+
- Necessidade de incrementalidade.
|
|
19
|
+
- Possibilidade de roteamento entre velho e novo (proxy / API gateway).
|
|
20
|
+
- **Custo**: médio.
|
|
21
|
+
- **Risco**: baixo (rollback parcial é viável).
|
|
22
|
+
- **Tempo**: longo (meses a anos em sistemas grandes).
|
|
23
|
+
- **Apetite favorecido**: conservative, balanced.
|
|
24
|
+
- **Exemplo**: API gateway redireciona endpoints `/v2/orders/*` para o sistema novo enquanto `/orders/*` continua no legado.
|
|
25
|
+
- **Referências**: Martin Fowler, "StranglerFigApplication"; Sam Newman, "Monolith to Microservices".
|
|
26
|
+
|
|
27
|
+
### Big Bang
|
|
28
|
+
- **Descrição**: Substituição completa em uma única janela de cutover.
|
|
29
|
+
- **Quando aplica**:
|
|
30
|
+
- Sistema pequeno.
|
|
31
|
+
- Janela de manutenção tolerada.
|
|
32
|
+
- Apetite transformacional alto.
|
|
33
|
+
- Baixa quantidade de integrações externas vivas.
|
|
34
|
+
- **Custo**: baixo (sem manutenção de duas versões).
|
|
35
|
+
- **Risco**: alto (rollback completo é caro; falha derruba o serviço).
|
|
36
|
+
- **Tempo**: curto.
|
|
37
|
+
- **Apetite favorecido**: transformational (em sistemas pequenos).
|
|
38
|
+
- **Exemplo**: ferramenta interna usada por 50 pessoas migrada em uma noite com rollback documentado.
|
|
39
|
+
- **Referências**: descrita em vários frameworks de migração; alta correlação com falhas históricas em sistemas grandes.
|
|
40
|
+
|
|
41
|
+
### Parallel Run
|
|
42
|
+
- **Descrição**: Legado e novo rodam em paralelo recebendo o mesmo input; output é comparado para detectar divergências.
|
|
43
|
+
- **Quando aplica**:
|
|
44
|
+
- Lógica crítica (financeiro, fiscal, regulatório).
|
|
45
|
+
- Necessidade de prova de equivalência por longo período.
|
|
46
|
+
- Mudança grande de paradigma + apetite transformacional (alto risco operacional).
|
|
47
|
+
- **Custo**: alto (duas pilhas operando simultaneamente; comparação de outputs).
|
|
48
|
+
- **Risco**: médio (riscos vêm da operação dupla, não do corte).
|
|
49
|
+
- **Tempo**: médio.
|
|
50
|
+
- **Apetite favorecido**: balanced.
|
|
51
|
+
- **Exemplo**: cálculo de imposto rodando no legado e no novo por 60 dias; cutover só após divergência < 0,01%.
|
|
52
|
+
- **Referências**: Michael Nygard, "Release It!"; comum em sistemas bancários e fiscais.
|
|
53
|
+
|
|
54
|
+
### Branch by Abstraction
|
|
55
|
+
- **Descrição**: Refatoração interna do legado para introduzir uma abstração que permite trocar a implementação por baixo, depois substituir.
|
|
56
|
+
- **Quando aplica**:
|
|
57
|
+
- Migração interna (linguagem ou framework muda, mas o domínio fica).
|
|
58
|
+
- Apetite conservador.
|
|
59
|
+
- Time já dentro do legado, com domínio do código.
|
|
60
|
+
- **Custo**: baixo.
|
|
61
|
+
- **Risco**: baixo.
|
|
62
|
+
- **Tempo**: médio.
|
|
63
|
+
- **Apetite favorecido**: conservative.
|
|
64
|
+
- **Exemplo**: extrair interface `OrderRepository` no legado, deixar implementação antiga e nova escolhidas por flag, depois remover a antiga.
|
|
65
|
+
- **Referências**: Paul Hammant, "Branch By Abstraction".
|
|
66
|
+
|
|
67
|
+
## Comparativo rápido
|
|
68
|
+
|
|
69
|
+
| Estratégia | Quando aplica | Custo | Risco | Tempo |
|
|
70
|
+
|---|---|---|---|---|
|
|
71
|
+
| Strangler Fig | sistema em produção, não pode parar | médio | baixo | longo |
|
|
72
|
+
| Big Bang | sistema pequeno, janela controlada, apetite transformacional | baixo | alto | curto |
|
|
73
|
+
| Parallel Run | lógica crítica (financeiro / fiscal) | alto | médio | médio |
|
|
74
|
+
| Branch by Abstraction | refatoração interna antes da migração | baixo | baixo | médio |
|
|
75
|
+
|
|
76
|
+
## Influência do paradigma na escolha
|
|
77
|
+
|
|
78
|
+
- **Apetite `conservative`** → favorece Branch by Abstraction e Strangler Fig.
|
|
79
|
+
- **Apetite `balanced`** → favorece Strangler Fig e Parallel Run.
|
|
80
|
+
- **Apetite `transformational`** → permite Big Bang em sistemas pequenos, Strangler Fig com bordas profundas em sistemas maiores.
|
|
81
|
+
- **Mudança grande de paradigma + apetite transformacional** → sinalizar `risco de divergência operacional alto` e recomendar Parallel Run para validação.
|
|
82
|
+
|
|
83
|
+
## Função utilitária (uso pelo Strategist)
|
|
84
|
+
|
|
85
|
+
Pseudo-procedimento que o agente segue ao consultar o catálogo:
|
|
86
|
+
|
|
87
|
+
1. Receber `migration_brief` (escopo, prazo, restrições) + `derived_appetite` + `gap de paradigma`.
|
|
88
|
+
2. Filtrar estratégias por aplicabilidade (drop-out das que claramente não cabem).
|
|
89
|
+
3. Pontuar cada estratégia restante por aderência ao apetite e ao gap.
|
|
90
|
+
4. Selecionar as 2 a 3 melhores candidatas.
|
|
91
|
+
5. Marcar uma como `recomendada` com justificativa explícita.
|
|
92
|
+
6. Para cada estratégia restante, listar contras como motivos de não-recomendação.
|
|
93
|
+
|
|
94
|
+
## Cenários de teste do catálogo
|
|
95
|
+
|
|
96
|
+
1. brief = sistema bancário em produção, apetite conservative → recomendar Strangler Fig + Branch by Abstraction.
|
|
97
|
+
2. brief = ferramenta interna 50 usuários, apetite transformational → recomendar Big Bang.
|
|
98
|
+
3. brief = sistema fiscal, apetite balanced, mudança de paradigma alta → recomendar Parallel Run + Strangler Fig.
|
|
99
|
+
4. brief = monolito Rails para microsserviços Go, apetite transformational, mudança grande de paradigma → recomendar Strangler Fig com bordas profundas, sinalizar risco operacional, sugerir Parallel Run para domínios críticos.
|
|
100
|
+
5. brief = .NET WebForms para Blazor, apetite balanced, sem mudança grande de paradigma → recomendar Strangler Fig.
|
|
101
|
+
6. brief = sistema legacy com poucas integrações, janela de manutenção tolerada, apetite balanced → recomendar Big Bang com plano de rollback robusto, alternativa Strangler Fig.
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
kind: paradigm_catalog
|
|
4
|
+
description: Catálogo consultivo de paradigmas de programação, mapeamento de stacks ao paradigma natural, e gaps típicos por par (origem → destino). Usado pelo Paradigm Advisor.
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Paradigm Catalog
|
|
8
|
+
|
|
9
|
+
> Conhecimento estruturado sobre paradigmas e como eles se relacionam com stacks comuns.
|
|
10
|
+
> Atualizar este catálogo é tarefa de manutenção independente do agente Paradigm Advisor.
|
|
11
|
+
|
|
12
|
+
## Catálogo de paradigmas
|
|
13
|
+
|
|
14
|
+
### Procedural
|
|
15
|
+
- **Características**: funções top-level, fluxo linear em controllers, ausência de classes ou uso ornamental, dados como dicts/structs, side effects abertos.
|
|
16
|
+
- **Exemplos no legado**: scripts PHP clássicos, COBOL batch, sistemas Perl pré-OO, scripts shell.
|
|
17
|
+
- **Sinais em `_reversa_sdd/`**: domínio descrito como "funções", fluxos lineares em `process_flows`, ausência de aggregates explícitos.
|
|
18
|
+
|
|
19
|
+
### OO clássico
|
|
20
|
+
- **Características**: hierarquia de classes, herança forte, padrão Active Record, lógica acoplada aos modelos, framework dita estrutura.
|
|
21
|
+
- **Exemplos no legado**: Rails monolítico, Django tradicional, Java EE pré-DI, .NET WebForms / clássico.
|
|
22
|
+
- **Sinais em `_reversa_sdd/`**: classes com responsabilidades amplas, herança em domain model, controllers anêmicos chamando métodos do modelo.
|
|
23
|
+
|
|
24
|
+
### OO com DI
|
|
25
|
+
- **Características**: containers de injeção, interfaces explícitas, padrão Repository / Service, separação clara entre camadas.
|
|
26
|
+
- **Exemplos no legado**: Spring moderno, .NET 6+, NestJS, Symfony moderno.
|
|
27
|
+
- **Sinais em `_reversa_sdd/`**: aggregates explícitos, interfaces de repositório, ausência de Active Record.
|
|
28
|
+
|
|
29
|
+
### Funcional
|
|
30
|
+
- **Características**: imutabilidade dominante, funções puras, composição, ausência de side effects implícitos, tipagem rica.
|
|
31
|
+
- **Exemplos no legado**: Haskell, Elm, F#, Scala funcional, Clojure.
|
|
32
|
+
- **Sinais em `_reversa_sdd/`**: tipos algébricos, ausência de classes, fluxo expresso como composição.
|
|
33
|
+
|
|
34
|
+
### Event-driven (assíncrono)
|
|
35
|
+
- **Características**: filas / tópicos, handlers desacoplados, ausência de fluxo linear, consistência eventual, idempotência explícita.
|
|
36
|
+
- **Exemplos no legado**: backends Node moderno orientado a fila, sistemas SQS / Kafka heavy, microsserviços assíncronos.
|
|
37
|
+
- **Sinais em `_reversa_sdd/`**: eventos no domain model, integrações via fila, processos de longa duração com retry.
|
|
38
|
+
|
|
39
|
+
### Actor model
|
|
40
|
+
- **Características**: atores isolados com mailbox, supervisão, isolamento de estado.
|
|
41
|
+
- **Exemplos no legado**: Erlang / Elixir / OTP, Akka.
|
|
42
|
+
- **Sinais em `_reversa_sdd/`**: processos supervisionados, mensagens entre atores.
|
|
43
|
+
|
|
44
|
+
### Dataflow
|
|
45
|
+
- **Características**: pipelines declarativos, transformações em fluxo, ausência de loops imperativos no domínio.
|
|
46
|
+
- **Exemplos no legado**: ETLs clássicos, Spark, Flink.
|
|
47
|
+
- **Sinais em `_reversa_sdd/`**: descrição em DAG, transformações em estágios.
|
|
48
|
+
|
|
49
|
+
## Mapeamento stack → paradigma natural
|
|
50
|
+
|
|
51
|
+
| Stack alvo | Paradigma natural | Alternativas viáveis | Notas |
|
|
52
|
+
|---|---|---|---|
|
|
53
|
+
| Node.js 20 (Fastify, Express, NestJS) | event-driven assíncrono | OO com DI (NestJS), funcional leve | runtime async-first; bloqueio CPU pesado vai para worker threads |
|
|
54
|
+
| Go (net/http, Echo, Fiber) | CSP / goroutines (event-driven leve) | procedural estruturado | concorrência via channels; OO simulada via interfaces |
|
|
55
|
+
| Rust (axum, Actix, tokio) | ownership / async funcional | event-driven | imutabilidade por default, segurança via tipos |
|
|
56
|
+
| Elixir / Phoenix | actor model (BEAM) | funcional | supervisão via OTP |
|
|
57
|
+
| Python moderno (FastAPI, Django 5) | OO com DI ou procedural rico | event-driven (Celery, asyncio) | escolha depende do framework |
|
|
58
|
+
| Kotlin (Spring Boot, Ktor) | OO com DI | event-driven (Reactor) | corrotinas habilitam async ergonômico |
|
|
59
|
+
| .NET 8 (ASP.NET Core, Minimal API) | OO com DI | event-driven (Channels, MediatR) | tradição OO + assincronismo first-class |
|
|
60
|
+
| Java moderno (Spring Boot 3, Quarkus) | OO com DI | event-driven (Project Reactor) | bibliotecas funcionais possíveis mas não dominantes |
|
|
61
|
+
| Ruby moderno (Rails 7, Hanami) | OO clássico (Rails) ou OO com DI (Hanami) | funcional leve (dry-rb) | Rails dita Active Record; Hanami é DI-heavy |
|
|
62
|
+
| TypeScript serverless (AWS Lambda, Cloudflare Workers) | event-driven | funcional | invocação por evento; cold start influencia design |
|
|
63
|
+
|
|
64
|
+
## Tabela de gaps típicos por par
|
|
65
|
+
|
|
66
|
+
| De → Para | Gap principal | Implicações concretas |
|
|
67
|
+
|---|---|---|
|
|
68
|
+
| procedural → event-driven | sincronia → assincronismo | resposta deixa de ser imediata; tratamento de erro vira retry/DLQ; idempotência obrigatória; ordem de eventos passa a importar |
|
|
69
|
+
| procedural → OO com DI | dados como dict → aggregates | invariantes ficam dentro de aggregates; lógica deixa de viver em controllers; dependências via interfaces |
|
|
70
|
+
| procedural → funcional | side effects abertos → puros + isolados | mutabilidade vira exceção; composição substitui sequência; tipos algébricos para estados |
|
|
71
|
+
| OO clássico → event-driven | fluxo síncrono → coreografia | ações deixam de ser atômicas; transações distribuídas viram sagas; consistência forte → eventual |
|
|
72
|
+
| OO clássico → OO com DI | herança → composição via interfaces | Active Record desaparece; persistência vira repositório; testes ganham mocks naturais |
|
|
73
|
+
| OO clássico → funcional | encapsulamento mutável → imutabilidade | métodos com efeito viram funções puras + atualização explícita; estado expresso como sequência de transformações |
|
|
74
|
+
| OO com DI → event-driven | comando síncrono → evento | retorno deixa de ser imediato; orquestração vira coreografia; ordem por chave |
|
|
75
|
+
| OO com DI → funcional | mocks → composição testável | DI deixa de ser por interface, vira por argumento de função |
|
|
76
|
+
| funcional → event-driven | composição síncrona → mensageria | latência aumenta; falha vira mensagem em DLQ; estado distribuído |
|
|
77
|
+
| event-driven → procedural síncrono | desnatural; só faz sentido para sistemas pequenos | colapsar handlers em chamadas diretas; perda de desacoplamento; consistência forte volta |
|
|
78
|
+
| dataflow → event-driven | DAG declarativa → coreografia mutável | controle fica menos previsível; ordem precisa ser garantida por chave |
|
|
79
|
+
| actor model → OO com DI | mensagens entre atores → chamadas síncronas | perda de isolamento de falha; supervisão precisa virar try/catch ou retry orquestrado |
|
|
80
|
+
|
|
81
|
+
## Função utilitária (uso pelo Paradigm Advisor)
|
|
82
|
+
|
|
83
|
+
Pseudo-procedimento que o agente segue ao consultar o catálogo:
|
|
84
|
+
|
|
85
|
+
1. Receber `paradigma_legado` (detectado) e `stack_alvo` (do brief).
|
|
86
|
+
2. Olhar `Mapeamento stack → paradigma natural`, registrar `paradigma_alvo` e `alternativas`.
|
|
87
|
+
3. Comparar `paradigma_legado` com `paradigma_alvo`:
|
|
88
|
+
- Se iguais: retornar `gap = nenhum`, `implicações = []`.
|
|
89
|
+
- Se diferentes: olhar `Tabela de gaps típicos por par` e retornar `implicações`.
|
|
90
|
+
4. Se híbrido no legado: aplicar passo 3 para cada componente e retornar lista combinada.
|
|
91
|
+
|
|
92
|
+
## Cenários de teste do catálogo (para validação)
|
|
93
|
+
|
|
94
|
+
1. legado procedural + stack Node → gap = procedural → event-driven, implicações = [sincronia/assincronismo, idempotência, retry/DLQ, ordem]
|
|
95
|
+
2. legado OO clássico + stack .NET 8 → gap = OO clássico → OO com DI, implicações = [herança/composição, repository, mocks]
|
|
96
|
+
3. legado OO clássico + stack Go → gap = OO clássico → CSP, implicações = [interfaces idiomáticas, channels para coordenação, perda de herança]
|
|
97
|
+
4. legado funcional + stack Elixir → gap = funcional → actor model, implicações = [estado distribuído, supervisão, mensagens]
|
|
98
|
+
5. legado event-driven + stack Node → gap = nenhum
|
|
99
|
+
6. legado COBOL batch + stack TypeScript serverless → gap extremo, implicações múltiplas: batch → event-driven, procedural → tipagem rica, ausência de loops longos → invocações curtas
|
|
100
|
+
7. legado Rails monolítico + stack Hanami → gap = OO clássico (Active Record) → OO com DI, implicações = [repository, dry-monads opcional]
|
|
101
|
+
8. legado híbrido (Rails + Sidekiq) + stack Node → híbrido decomposto: parte síncrona Rails → Node sync; parte async Sidekiq → Node fila moderna
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
# Lista declarativa de artefatos esperados em _reversa_sdd/ antes de iniciar a migração.
|
|
2
|
+
# Atualizar esta lista é uma mudança de configuração; não exige reedição do agente reversa-migrate.
|
|
3
|
+
#
|
|
4
|
+
# Cada entrada:
|
|
5
|
+
# path: caminho relativo dentro de _reversa_sdd/
|
|
6
|
+
# kind: identificador lógico do artefato (informativo, não estritamente validado contra front-matter)
|
|
7
|
+
# required: true bloqueia o pipeline se ausente; false apenas loga aviso
|
|
8
|
+
# minSchemaVersion: versão mínima esperada de schemaVersion (informativo; ausência tolerada hoje)
|
|
9
|
+
|
|
10
|
+
schemaVersion: 1
|
|
11
|
+
artifacts:
|
|
12
|
+
- path: "code-analysis.md"
|
|
13
|
+
kind: code_analysis
|
|
14
|
+
required: true
|
|
15
|
+
minSchemaVersion: 1
|
|
16
|
+
- path: "domain.md"
|
|
17
|
+
kind: domain_model
|
|
18
|
+
required: true
|
|
19
|
+
minSchemaVersion: 1
|
|
20
|
+
- path: "architecture.md"
|
|
21
|
+
kind: architecture
|
|
22
|
+
required: true
|
|
23
|
+
minSchemaVersion: 1
|
|
24
|
+
- path: "dependencies.md"
|
|
25
|
+
kind: dependencies
|
|
26
|
+
required: true
|
|
27
|
+
minSchemaVersion: 1
|
|
28
|
+
- path: "inventory.md"
|
|
29
|
+
kind: legacy_inventory
|
|
30
|
+
required: true
|
|
31
|
+
minSchemaVersion: 1
|
|
32
|
+
- path: "data-dictionary.md"
|
|
33
|
+
kind: data_dictionary
|
|
34
|
+
required: false
|
|
35
|
+
minSchemaVersion: 1
|
|
36
|
+
- path: "state-machines.md"
|
|
37
|
+
kind: state_machines
|
|
38
|
+
required: false
|
|
39
|
+
minSchemaVersion: 1
|
|
40
|
+
- path: "permissions.md"
|
|
41
|
+
kind: permissions
|
|
42
|
+
required: false
|
|
43
|
+
minSchemaVersion: 1
|
|
44
|
+
- path: "gaps.md"
|
|
45
|
+
kind: gaps
|
|
46
|
+
required: true
|
|
47
|
+
minSchemaVersion: 1
|
|
48
|
+
- path: "questions.md"
|
|
49
|
+
kind: questions
|
|
50
|
+
required: false
|
|
51
|
+
minSchemaVersion: 1
|
|
52
|
+
- path: "confidence-report.md"
|
|
53
|
+
kind: confidence_report
|
|
54
|
+
required: true
|
|
55
|
+
minSchemaVersion: 1
|
|
56
|
+
- path: "traceability/code-spec-matrix.md"
|
|
57
|
+
kind: code_spec_matrix
|
|
58
|
+
required: false
|
|
59
|
+
minSchemaVersion: 1
|
|
60
|
+
- path: "sdd"
|
|
61
|
+
kind: sdd_dir
|
|
62
|
+
required: false
|
|
63
|
+
minSchemaVersion: 1
|
|
64
|
+
|
|
65
|
+
# Aliases:
|
|
66
|
+
# Nomes legados aceitos para compatibilidade com versões anteriores do time de descoberta.
|
|
67
|
+
# Cada alias mapeia "nome esperado" → lista de nomes alternativos aceitos.
|
|
68
|
+
aliases:
|
|
69
|
+
"domain.md":
|
|
70
|
+
- "domain_model.md"
|
|
71
|
+
"architecture.md":
|
|
72
|
+
- "architecture_legacy.md"
|
|
73
|
+
"code-analysis.md":
|
|
74
|
+
- "code_analysis.md"
|
|
75
|
+
- "process_flows.md"
|
|
76
|
+
"inventory.md":
|
|
77
|
+
- "legacy_inventory.md"
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 2,
|
|
3
|
+
"startedAt": null,
|
|
4
|
+
"lastCheckpoint": null,
|
|
5
|
+
"completedAgents": [],
|
|
6
|
+
"pendingAgents": [
|
|
7
|
+
"paradigm_advisor",
|
|
8
|
+
"curator",
|
|
9
|
+
"strategist",
|
|
10
|
+
"designer",
|
|
11
|
+
"screen_translator",
|
|
12
|
+
"inspector"
|
|
13
|
+
],
|
|
14
|
+
"currentAgent": {
|
|
15
|
+
"agent": null,
|
|
16
|
+
"phase": null,
|
|
17
|
+
"status": null,
|
|
18
|
+
"topologyApproved": false,
|
|
19
|
+
"screenModeApproved": false
|
|
20
|
+
},
|
|
21
|
+
"pendingDecisions": [],
|
|
22
|
+
"artifacts": {},
|
|
23
|
+
"auto": false,
|
|
24
|
+
"engine": null,
|
|
25
|
+
"reversaVersion": "{{VERSION}}",
|
|
26
|
+
"briefPath": "_reversa_sdd/migration/migration_brief.md",
|
|
27
|
+
"expectedLegacyArtifacts": "templates/migration/expected_legacy_artifacts.yaml"
|
|
28
|
+
}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
# Plano de Exploração — {{PROJECT}}
|
|
2
|
+
|
|
3
|
+
> Criado pelo Reversa em {{DATE}}
|
|
4
|
+
> Marque cada tarefa com ✅ quando concluída.
|
|
5
|
+
> Você pode editar este plano antes de iniciar: adicione, remova ou reordene tarefas conforme necessário.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Fase 1: Reconhecimento 🔍
|
|
10
|
+
|
|
11
|
+
- [ ] **Scout** — Mapeamento de estrutura de pastas e tecnologias
|
|
12
|
+
- [ ] **Scout** — Análise de dependências e gerenciadores de pacotes
|
|
13
|
+
- [ ] **Scout** — Identificação de entry points, CI/CD e configurações
|
|
14
|
+
|
|
15
|
+
## Decisão de organização das specs 🗂️
|
|
16
|
+
|
|
17
|
+
> Entre o Scout e o Arqueólogo, o Reversa pergunta como você quer organizar as specs (por módulo, caso de uso, endpoint, híbrida, por features ou customizada). A escolha fica persistida em `.reversa/config.toml` na seção `[specs]` e não será reperguntada em execuções futuras. Para reapresentar o menu, remova manualmente a seção.
|
|
18
|
+
|
|
19
|
+
## Fase 2: Escavação 🏗️
|
|
20
|
+
|
|
21
|
+
> O Reversa preenche esta seção com os módulos reais após o Scout concluir o reconhecimento.
|
|
22
|
+
|
|
23
|
+
- [ ] **Arqueólogo** — Análise dos módulos identificados pelo Scout
|
|
24
|
+
|
|
25
|
+
## Fase 3: Interpretação 🧠
|
|
26
|
+
|
|
27
|
+
- [ ] **Detetive** — Arqueologia Git e ADRs retroativos
|
|
28
|
+
- [ ] **Detetive** — Regras de negócio implícitas e máquinas de estado
|
|
29
|
+
- [ ] **Detetive** — Matriz de permissões (RBAC/ACL)
|
|
30
|
+
- [ ] **Arquiteto** — Diagramas C4 (Contexto, Containers, Componentes)
|
|
31
|
+
- [ ] **Arquiteto** — ERD completo e integrações externas
|
|
32
|
+
- [ ] **Arquiteto** — Spec Impact Matrix
|
|
33
|
+
|
|
34
|
+
## Fase 4: Geração 📝
|
|
35
|
+
|
|
36
|
+
- [ ] **Redator** — Specs SDD por componente
|
|
37
|
+
- [ ] **Redator** — OpenAPI (se aplicável)
|
|
38
|
+
- [ ] **Redator** — User Stories (se aplicável)
|
|
39
|
+
- [ ] **Redator** — Code/Spec Matrix
|
|
40
|
+
|
|
41
|
+
## Fase 5: Revisão ✅
|
|
42
|
+
|
|
43
|
+
- [ ] **Revisor** — Revisão cruzada de specs
|
|
44
|
+
- [ ] **Revisor** — Resolução de lacunas com o usuário
|
|
45
|
+
- [ ] **Revisor** — Relatório de confiança final
|
|
46
|
+
|
|
47
|
+
---
|
|
48
|
+
|
|
49
|
+
## Agentes Independentes
|
|
50
|
+
|
|
51
|
+
> Execute estes agentes quando os recursos estiverem disponíveis — podem rodar em qualquer fase.
|
|
52
|
+
|
|
53
|
+
- [ ] **Visor** — Análise de interface via screenshots
|
|
54
|
+
- [ ] **Data Master** — Análise completa do banco de dados
|
|
55
|
+
- [ ] **Design System** — Extração de tokens de design
|
|
56
|
+
- [ ] **Tracer** — Análise dinâmica (requer sistema acessível)
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
## Próximo passo
|
|
61
|
+
|
|
62
|
+
Após o Time de Descoberta concluir e o `_reversa_sdd/` estar populado, você pode disparar um dos fluxos seguintes:
|
|
63
|
+
|
|
64
|
+
- `/reversa-migrate`: orquestrador do **Time de Migração** (Paradigm Advisor → Curator → Strategist → Designer → Screen Translator → Inspector). Gera as specs do sistema novo. Saída em `_reversa_sdd/migration/` e `_reversa_sdd/screens/`.
|
|
65
|
+
- `/reversa-reconstructor`: gera plano bottom-up para reimplementar o software a partir das specs do legado (uma tarefa por sessão).
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": "{{VERSION}}",
|
|
3
|
+
"project": "",
|
|
4
|
+
"user_name": "",
|
|
5
|
+
"chat_language": "pt-br",
|
|
6
|
+
"doc_language": "Português",
|
|
7
|
+
"answer_mode": "chat",
|
|
8
|
+
"doc_level": "completo",
|
|
9
|
+
"output_folder": "_reversa_sdd",
|
|
10
|
+
"forward_folder": "_reversa_forward",
|
|
11
|
+
"phase": null,
|
|
12
|
+
"completed": [],
|
|
13
|
+
"pending": ["reconhecimento", "escavacao", "interpretacao", "geracao", "revisao"],
|
|
14
|
+
"checkpoints": {},
|
|
15
|
+
"engines": [],
|
|
16
|
+
"agents": [],
|
|
17
|
+
"created_files": []
|
|
18
|
+
}
|