@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,60 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: cutover_plan
|
|
7
|
+
producedBy: strategist
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Cutover Plan
|
|
12
|
+
|
|
13
|
+
> Plano de corte do legado para o sistema novo, alinhado à estratégia escolhida em `migration_strategy.md`.
|
|
14
|
+
|
|
15
|
+
## Estratégia base
|
|
16
|
+
- **Estratégia confirmada**: <referência ao migration_strategy.md>
|
|
17
|
+
|
|
18
|
+
## Pré-requisitos
|
|
19
|
+
- [ ] <pré-requisito 1: ex. paridade comportamental ≥ X% por N dias>
|
|
20
|
+
- [ ] <pré-requisito 2>
|
|
21
|
+
- [ ] <pré-requisito 3>
|
|
22
|
+
|
|
23
|
+
## Janela de cutover
|
|
24
|
+
- **Data alvo**: <ISO-8601 ou janela>
|
|
25
|
+
- **Duração estimada**: <horas>
|
|
26
|
+
- **Ambiente afetado**: <produção / staging / outro>
|
|
27
|
+
- **Comunicação prévia**: <stakeholders avisados, prazo>
|
|
28
|
+
|
|
29
|
+
## Passos do cutover
|
|
30
|
+
|
|
31
|
+
| # | Passo | Owner | Duração | Reversível? |
|
|
32
|
+
|---|---|---|---|---|
|
|
33
|
+
| 1 | <ex: congelar escritas no legado> | | | |
|
|
34
|
+
| 2 | <ex: ETL final dos dados> | | | |
|
|
35
|
+
| 3 | <ex: roteamento DNS> | | | |
|
|
36
|
+
| 4 | <ex: smoke tests no novo> | | | |
|
|
37
|
+
|
|
38
|
+
## Plano de rollback
|
|
39
|
+
- **Critérios de acionamento**: <quando rollback é decidido>
|
|
40
|
+
- **Passos**:
|
|
41
|
+
1. <passo>
|
|
42
|
+
2. <passo>
|
|
43
|
+
- **Tempo máximo aceitável até rollback**: <minutos / horas>
|
|
44
|
+
- **Owner do rollback**: <nome / papel>
|
|
45
|
+
|
|
46
|
+
## Critérios de go / no-go
|
|
47
|
+
- **Go**:
|
|
48
|
+
- <critério 1>
|
|
49
|
+
- <critério 2>
|
|
50
|
+
- **No-go**:
|
|
51
|
+
- <critério 1>
|
|
52
|
+
- <critério 2>
|
|
53
|
+
|
|
54
|
+
## Pós-cutover
|
|
55
|
+
- [ ] Monitoramento estendido por <período>
|
|
56
|
+
- [ ] Validação de paridade conforme `parity_specs.md`
|
|
57
|
+
- [ ] Decommission do legado em <data>
|
|
58
|
+
|
|
59
|
+
## Notas
|
|
60
|
+
<Observações adicionais.>
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: data_migration_plan
|
|
7
|
+
producedBy: designer
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Data Migration Plan
|
|
12
|
+
|
|
13
|
+
> Plano de migração dos dados do legado para o sistema novo: mapeamento, transformações, ETL, cutover de dados e validação.
|
|
14
|
+
|
|
15
|
+
## Resumo
|
|
16
|
+
- Volume estimado: <linhas / GB por entidade principal>
|
|
17
|
+
- Janela de migração: <ver `cutover_plan.md`>
|
|
18
|
+
- Estratégia: backfill prévio + delta + corte | bulk único | replicação contínua
|
|
19
|
+
|
|
20
|
+
## Mapeamento legado → novo
|
|
21
|
+
|
|
22
|
+
| Origem | Destino | Tipo | Notas |
|
|
23
|
+
|---|---|---|---|
|
|
24
|
+
| `<schema legado>.tb_pedidos` | `pedidos` | renomeação | normalização de tipos |
|
|
25
|
+
| `<schema legado>.tb_pedido_item` | `pedido_itens` | renomeação | FK ajustada |
|
|
26
|
+
| `<schema legado>.usr_x` | `usuarios` (parcial) + `perfis` | divisão | extrai dados de perfil |
|
|
27
|
+
|
|
28
|
+
## Transformações
|
|
29
|
+
|
|
30
|
+
### Transformação T-01: <nome>
|
|
31
|
+
- **Aplica em**: <coluna ou tabela>
|
|
32
|
+
- **Regra**: <texto explícito>
|
|
33
|
+
- **Tratamento de inválidos**: <descartar | rejeitar | preencher com default>
|
|
34
|
+
- **Origem da regra**: <referência a `target_business_rules.md` ou `discard_log.md`>
|
|
35
|
+
|
|
36
|
+
<repetir por transformação>
|
|
37
|
+
|
|
38
|
+
## Estratégia de ETL
|
|
39
|
+
|
|
40
|
+
- **Ferramenta**: <ex: scripts SQL, dbt, Airbyte, custom>
|
|
41
|
+
- **Fluxo**:
|
|
42
|
+
1. <extração>
|
|
43
|
+
2. <transformação>
|
|
44
|
+
3. <carga>
|
|
45
|
+
- **Idempotência**: <como o ETL é seguro para reexecução>
|
|
46
|
+
- **Throughput esperado**: <ex: 50k linhas/s>
|
|
47
|
+
|
|
48
|
+
## Backfill e delta
|
|
49
|
+
|
|
50
|
+
- **Backfill**: <data inicial, escopo, duração>
|
|
51
|
+
- **Captura de delta**:
|
|
52
|
+
- **Mecanismo**: CDC | log mining | timestamps | replicação | trigger
|
|
53
|
+
- **Latência aceitável**: <segundos>
|
|
54
|
+
- **Reconciliação periódica**: <frequência, escopo>
|
|
55
|
+
|
|
56
|
+
## Cutover de dados
|
|
57
|
+
|
|
58
|
+
> Ver também `cutover_plan.md`. Aqui apenas a parte específica de dados.
|
|
59
|
+
|
|
60
|
+
- **Janela**: <ISO-8601>
|
|
61
|
+
- **Sequência de corte**:
|
|
62
|
+
1. <passo>
|
|
63
|
+
2. <passo>
|
|
64
|
+
- **Verificação pós-corte**:
|
|
65
|
+
- **Contagens**: <quais tabelas, tolerância>
|
|
66
|
+
- **Checksums**: <colunas críticas>
|
|
67
|
+
|
|
68
|
+
## Validação de qualidade
|
|
69
|
+
|
|
70
|
+
| Métrica | Alvo | Fonte de medição |
|
|
71
|
+
|---|---|---|
|
|
72
|
+
| Contagem por entidade | igual ± 0% | comparação direta |
|
|
73
|
+
| Soma de valores monetários | igual ± 0,01% | reconciliação financeira |
|
|
74
|
+
| Integridade referencial | 0 órfãos | scripts de auditoria |
|
|
75
|
+
|
|
76
|
+
## Riscos específicos de dados
|
|
77
|
+
- <RISK-XXX: ver `risk_register.md`>
|
|
78
|
+
|
|
79
|
+
## Notas
|
|
80
|
+
<Observações adicionais.>
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: discard_log
|
|
7
|
+
producedBy: curator
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Discard Log
|
|
12
|
+
|
|
13
|
+
> Registro completo do que foi descartado da migração e por quê. Cada item tem rastreabilidade para a origem no legado.
|
|
14
|
+
|
|
15
|
+
## Itens descartados
|
|
16
|
+
|
|
17
|
+
### BR-DESCARTAR-001
|
|
18
|
+
- **Origem**: `_reversa_sdd/<unit>/{requirements,design}.md` § <seção>
|
|
19
|
+
- **Descrição**: <regra ou comportamento descartado>
|
|
20
|
+
- **Justificativa**: <texto>
|
|
21
|
+
- **Vinculado a paradigma**: sim | não
|
|
22
|
+
- Se sim: <qual paradigma e como o paradigma alvo absorve o caso>
|
|
23
|
+
- **Reposição no sistema novo**: <none | substituído por X>
|
|
24
|
+
- **Risco de descartar**: baixo | médio | alto, com nota explicativa
|
|
25
|
+
|
|
26
|
+
<repetir por item>
|
|
27
|
+
|
|
28
|
+
## Itens descartados por mudança de paradigma (subseção dedicada)
|
|
29
|
+
|
|
30
|
+
> Lista apenas dos itens cujo `Vinculado a paradigma = sim`. Auditoria explícita para o agente de codificação.
|
|
31
|
+
|
|
32
|
+
| ID | Origem | Paradigma legado | Substituto no paradigma alvo |
|
|
33
|
+
|---|---|---|---|
|
|
34
|
+
| BR-DESCARTAR-XXX | <ref> | <ex: lock pessimista síncrono> | <ex: idempotência via event ID> |
|
|
35
|
+
|
|
36
|
+
## Notas
|
|
37
|
+
<Observações finais do Curator sobre o conjunto descartado.>
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: handoff
|
|
7
|
+
producedBy: orchestrator
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Handoff para o Agente de Codificação
|
|
12
|
+
|
|
13
|
+
> Este documento é a porta de entrada para o agente de codificação (Claude Code, Codex, Cursor, Antigravity, etc.) que vai escrever o sistema novo a partir das specs.
|
|
14
|
+
|
|
15
|
+
## ⚠️ Leitura obrigatória primeiro
|
|
16
|
+
|
|
17
|
+
1. **`paradigm_decision.md`**, leitura inegociável. O paradigma alvo molda como toda a codificação deve acontecer.
|
|
18
|
+
|
|
19
|
+
## Ordem de leitura recomendada
|
|
20
|
+
|
|
21
|
+
1. `paradigm_decision.md` (obrigatório, primeiro)
|
|
22
|
+
2. `migration_brief.md`
|
|
23
|
+
3. `target_business_rules.md`
|
|
24
|
+
4. `migration_strategy.md`
|
|
25
|
+
5. `target_architecture.md`
|
|
26
|
+
6. `target_domain_model.md`
|
|
27
|
+
7. `target_data_model.md`
|
|
28
|
+
8. `data_migration_plan.md`
|
|
29
|
+
9. `parity_specs.md` + `parity_tests/`
|
|
30
|
+
10. `risk_register.md` + `cutover_plan.md`
|
|
31
|
+
11. `discard_log.md` (consultivo)
|
|
32
|
+
12. `ambiguity_log.md` (consultivo)
|
|
33
|
+
|
|
34
|
+
## Lista de artefatos produzidos
|
|
35
|
+
|
|
36
|
+
| Artefato | Produzido por | Status |
|
|
37
|
+
|---|---|---|
|
|
38
|
+
| migration_brief.md | orchestrator | criado |
|
|
39
|
+
| paradigm_decision.md | paradigm_advisor | criado |
|
|
40
|
+
| target_business_rules.md | curator | criado |
|
|
41
|
+
| discard_log.md | curator | criado |
|
|
42
|
+
| migration_strategy.md | strategist | criado |
|
|
43
|
+
| risk_register.md | strategist | criado |
|
|
44
|
+
| cutover_plan.md | strategist | criado |
|
|
45
|
+
| target_architecture.md | designer | criado |
|
|
46
|
+
| target_domain_model.md | designer | criado |
|
|
47
|
+
| target_data_model.md | designer | criado |
|
|
48
|
+
| data_migration_plan.md | designer | criado |
|
|
49
|
+
| parity_specs.md | inspector | criado |
|
|
50
|
+
| parity_tests/*.feature | inspector | <N> arquivos |
|
|
51
|
+
| ambiguity_log.md | orchestrator | consolidado |
|
|
52
|
+
|
|
53
|
+
## Bloqueadores para começar a implementação
|
|
54
|
+
> Itens que precisam de decisão humana antes do agente de codificação começar.
|
|
55
|
+
|
|
56
|
+
- <AMB-XXX: descrição curta + onde decidir>
|
|
57
|
+
- <ou: nenhum bloqueador, prosseguir>
|
|
58
|
+
|
|
59
|
+
## Próximos passos para o agente de codificação
|
|
60
|
+
|
|
61
|
+
1. **Ler `paradigm_decision.md` e internalizar**: o paradigma alvo é <do paradigm_decision>. Toda escolha de código deve honrar esse paradigma.
|
|
62
|
+
2. **Configurar o repositório novo** com a stack declarada em `migration_brief.md`.
|
|
63
|
+
3. **Implementar bottom-up** seguindo `target_architecture.md` e `target_domain_model.md`:
|
|
64
|
+
- infraestrutura → dados → domínio → aplicação → bordas.
|
|
65
|
+
4. **Escrever os testes** a partir de `parity_specs.md` e `parity_tests/*.feature` desde o início.
|
|
66
|
+
5. **Para cada componente**, validar que respeita o paradigma escolhido (sinais explícitos em `target_architecture.md § Honra ao paradigma escolhido`).
|
|
67
|
+
6. **Para a migração de dados**, seguir `data_migration_plan.md`.
|
|
68
|
+
7. **Para o cutover**, seguir `cutover_plan.md` e os critérios go/no-go.
|
|
69
|
+
|
|
70
|
+
## Itens auto-decididos (apenas se executado em --auto)
|
|
71
|
+
> Listar aqui itens cujo default foi aplicado sem confirmação humana. Recomenda-se revisar antes do cutover.
|
|
72
|
+
|
|
73
|
+
- <ou: pipeline executado em modo interativo, nenhum item auto-decidido>
|
|
74
|
+
|
|
75
|
+
## Notas finais
|
|
76
|
+
<Observações do orquestrador para o agente de codificação.>
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: migration_brief
|
|
7
|
+
producedBy: orchestrator
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Migration Brief
|
|
12
|
+
|
|
13
|
+
> Documento de critério de migração coletado em entrevista no início do `/reversa-migrate`.
|
|
14
|
+
> Consumido pelos seis agentes do Time de Migração. Não pergunta paradigma (responsabilidade do Paradigm Advisor) nem apetite (derivado em `paradigm_decision.md`).
|
|
15
|
+
|
|
16
|
+
## Objetivo da migração
|
|
17
|
+
<Por que esta migração existe? O que muda no negócio se ela acontecer ou não.>
|
|
18
|
+
|
|
19
|
+
## Métricas de sucesso
|
|
20
|
+
- <métrica 1, com alvo numérico ou qualitativo claro>
|
|
21
|
+
- <métrica 2>
|
|
22
|
+
- <métrica 3>
|
|
23
|
+
|
|
24
|
+
## Restrições
|
|
25
|
+
- **Prazo**: <data ou janela>
|
|
26
|
+
- **Orçamento**: <faixa, time, contratação envolvida>
|
|
27
|
+
- **Técnicas**: <APIs externas que não podem mudar, contratos, regras regulatórias>
|
|
28
|
+
- **Operacionais**: <janelas de manutenção, SLAs durante a migração>
|
|
29
|
+
|
|
30
|
+
## Fatores de risco conhecidos
|
|
31
|
+
- <risco 1: descrição curta>
|
|
32
|
+
- <risco 2>
|
|
33
|
+
|
|
34
|
+
## Stakeholders
|
|
35
|
+
| Nome / papel | Responsabilidade na migração |
|
|
36
|
+
|---|---|
|
|
37
|
+
| <nome> | <responsabilidade> |
|
|
38
|
+
|
|
39
|
+
## Stack alvo
|
|
40
|
+
- **Linguagem**: <ex: Node.js 20>
|
|
41
|
+
- **Framework**: <ex: Fastify>
|
|
42
|
+
- **Banco**: <ex: PostgreSQL 16>
|
|
43
|
+
- **Mensageria** (se houver): <ex: SQS, Kafka, none>
|
|
44
|
+
- **Infra**: <ex: AWS Lambda, Kubernetes, on-premise>
|
|
45
|
+
- **Outros componentes relevantes**: <cache, observabilidade, gateway>
|
|
46
|
+
|
|
47
|
+
## Escopo declarado
|
|
48
|
+
- **Incluído**: <módulos do legado que entram>
|
|
49
|
+
- **Excluído**: <módulos que ficam de fora ou serão descontinuados>
|
|
50
|
+
|
|
51
|
+
## Notas livres
|
|
52
|
+
<Qualquer contexto que o usuário queira deixar registrado para os agentes lerem.>
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: migration_strategy
|
|
7
|
+
producedBy: strategist
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Migration Strategy
|
|
12
|
+
|
|
13
|
+
> Estratégias de migração avaliadas com trade-offs explícitos. A estratégia recomendada é a sugestão do Strategist; a decisão final é humana.
|
|
14
|
+
|
|
15
|
+
## Estratégias avaliadas
|
|
16
|
+
|
|
17
|
+
### Estratégia A: <nome>
|
|
18
|
+
- **Descrição**: <texto curto>
|
|
19
|
+
- **Quando aplica**: <critérios>
|
|
20
|
+
- **Custo**: baixo | médio | alto
|
|
21
|
+
- **Risco**: baixo | médio | alto
|
|
22
|
+
- **Tempo**: curto | médio | longo
|
|
23
|
+
- **Adequação ao apetite derivado** (`<conservative | balanced | transformational>`): <texto>
|
|
24
|
+
- **Trade-offs**:
|
|
25
|
+
- Prós: <lista>
|
|
26
|
+
- Contras: <lista>
|
|
27
|
+
|
|
28
|
+
### Estratégia B: <nome>
|
|
29
|
+
<mesma estrutura>
|
|
30
|
+
|
|
31
|
+
### Estratégia C: <nome>
|
|
32
|
+
<opcional, se mais de duas forem relevantes>
|
|
33
|
+
|
|
34
|
+
## Comparativo
|
|
35
|
+
|
|
36
|
+
| Critério | A | B | C |
|
|
37
|
+
|---|---|---|---|
|
|
38
|
+
| Custo | | | |
|
|
39
|
+
| Risco | | | |
|
|
40
|
+
| Tempo | | | |
|
|
41
|
+
| Aderência ao apetite | | | |
|
|
42
|
+
| Compatibilidade com mudança de paradigma | | | |
|
|
43
|
+
|
|
44
|
+
## Recomendação do Strategist
|
|
45
|
+
- **Estratégia recomendada**: <A | B | C>
|
|
46
|
+
- **Justificativa**: <texto baseado em brief + paradigma + apetite>
|
|
47
|
+
|
|
48
|
+
## Sinais de alerta específicos
|
|
49
|
+
- <ex: mudança grande de paradigma + apetite transformacional → considerar Parallel Run para validação>
|
|
50
|
+
|
|
51
|
+
## Decisão humana
|
|
52
|
+
- **Estratégia escolhida**: <A | B | C>
|
|
53
|
+
- **Quem decidiu**: <nome>
|
|
54
|
+
- **Quando**: <ISO-8601>
|
|
55
|
+
- **Justificativa do decisor**: <texto livre>
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: paradigm_decision
|
|
7
|
+
producedBy: paradigm_advisor
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Paradigm Decision
|
|
12
|
+
|
|
13
|
+
> Decisão consciente sobre como tratar a mudança (ou ausência) de paradigma entre o legado e a stack alvo.
|
|
14
|
+
> Este artefato é leitura obrigatória primeiro para qualquer agente posterior e para o agente de codificação.
|
|
15
|
+
|
|
16
|
+
## Paradigma do legado detectado
|
|
17
|
+
- **Paradigma principal**: <procedural | OO clássico | OO com DI | funcional | event-driven | actor model | dataflow | híbrido: ...>
|
|
18
|
+
- **Confiança**: 🟢 CONFIRMADO | 🟡 INFERIDO | 🔴 LACUNA | ⚠️ AMBÍGUO
|
|
19
|
+
- **Evidências**:
|
|
20
|
+
- <evidência 1, com referência a artefato do `_reversa_sdd/`>
|
|
21
|
+
- <evidência 2>
|
|
22
|
+
- **Variações observadas** (se híbrido):
|
|
23
|
+
- <componente A: paradigma X, evidência>
|
|
24
|
+
- <componente B: paradigma Y, evidência>
|
|
25
|
+
|
|
26
|
+
## Stack alvo declarada
|
|
27
|
+
- Linguagem: <do migration_brief.md>
|
|
28
|
+
- Framework: <do migration_brief.md>
|
|
29
|
+
- Infra: <do migration_brief.md>
|
|
30
|
+
|
|
31
|
+
## Paradigma natural inferido
|
|
32
|
+
- **Paradigma**: <inferido via paradigm_catalog>
|
|
33
|
+
- **Justificativa**: <por que essa stack tem esse paradigma natural>
|
|
34
|
+
- **Alternativas viáveis**: <ex: OO com DI também é viável em Node, com custo X>
|
|
35
|
+
|
|
36
|
+
## Gap identificado
|
|
37
|
+
- **Severidade**: alto | médio | baixo | nenhum
|
|
38
|
+
- **Implicações concretas** (não em abstrato; com exemplo do próprio sistema legado):
|
|
39
|
+
- <implicação 1, citando regra/fluxo do legado afetado>
|
|
40
|
+
- <implicação 2>
|
|
41
|
+
- <implicação 3>
|
|
42
|
+
- <implicação 4>
|
|
43
|
+
|
|
44
|
+
## Opções apresentadas ao usuário
|
|
45
|
+
1. **Adotar paradigma natural da stack** (transformacional)
|
|
46
|
+
- Consequências: <lista>
|
|
47
|
+
2. **Forçar paradigma similar ao legado** (conservador)
|
|
48
|
+
- Consequências: <lista>
|
|
49
|
+
3. **Híbrido** (equilibrado)
|
|
50
|
+
- Consequências: <lista>
|
|
51
|
+
|
|
52
|
+
## Decisão do usuário
|
|
53
|
+
- **Escolha**: <1 | 2 | 3>
|
|
54
|
+
- **Justificativa do usuário**: <texto livre>
|
|
55
|
+
- **Decidido em**: <ISO-8601>
|
|
56
|
+
|
|
57
|
+
## Apetite derivado
|
|
58
|
+
- `derived_appetite`: conservative | balanced | transformational
|
|
59
|
+
|
|
60
|
+
## Implicações pendentes para próximos agentes
|
|
61
|
+
| Agente | Implicação | Como honrar |
|
|
62
|
+
|---|---|---|
|
|
63
|
+
| Curator | <implicação> | <ação esperada> |
|
|
64
|
+
| Strategist | <implicação> | <ação esperada> |
|
|
65
|
+
| Designer | <implicação> | <ação esperada> |
|
|
66
|
+
| Inspector | <implicação> | <ação esperada> |
|
|
67
|
+
|
|
68
|
+
## Notas
|
|
69
|
+
<Qualquer ponto adicional que o agente de codificação precisa saber sobre o paradigma alvo.>
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: parity_specs
|
|
7
|
+
producedBy: inspector
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Parity Specs
|
|
12
|
+
|
|
13
|
+
> Estratégia de validação de equivalência comportamental entre legado e sistema novo, adaptada ao paradigma escolhido em `paradigm_decision.md`.
|
|
14
|
+
|
|
15
|
+
## Estratégia geral
|
|
16
|
+
- **Modos de validação aplicáveis** (marcar os usados):
|
|
17
|
+
- [ ] Shadow mode (espelhamento de tráfego com comparação assíncrona)
|
|
18
|
+
- [ ] Characterization tests (suíte derivada do comportamento atual do legado)
|
|
19
|
+
- [ ] Contract tests (interfaces externas)
|
|
20
|
+
- [ ] Data parity (snapshots e checksums)
|
|
21
|
+
- [ ] Outro: <especificar>
|
|
22
|
+
|
|
23
|
+
## Critérios de "paridade aceita"
|
|
24
|
+
- **Métrica primária**: <ex: índice de divergência funcional < 0,01% em N dias consecutivos>
|
|
25
|
+
- **Janela de observação**: <período de avaliação>
|
|
26
|
+
- **Critério de bloqueio**: <quando paridade insuficiente bloqueia o cutover>
|
|
27
|
+
|
|
28
|
+
## Cobertura adaptada ao paradigma
|
|
29
|
+
|
|
30
|
+
> Esta seção muda conforme o paradigma alvo confirmado em `paradigm_decision.md`.
|
|
31
|
+
|
|
32
|
+
### Sem mudança de paradigma
|
|
33
|
+
- Equivalência funcional padrão: mesma entrada → mesma saída → mesmo efeito colateral observável.
|
|
34
|
+
|
|
35
|
+
### Mudança síncrono → event-driven
|
|
36
|
+
- **Ordem de mensagens**: <critério de aceitação por canal / partição>
|
|
37
|
+
- **Idempotência**: <prova de que reprocessamento não duplica efeito>
|
|
38
|
+
- **Consistência eventual**: <janela máxima de propagação aceita>
|
|
39
|
+
- **Comportamento sob falha de fila**: <retry, DLQ, replay>
|
|
40
|
+
|
|
41
|
+
### Mudança procedural → OO
|
|
42
|
+
- **Invariantes em aggregates**: <conjunto a validar>
|
|
43
|
+
- **Validação em factories / construtores**: <casos críticos>
|
|
44
|
+
|
|
45
|
+
### Mudança OO → funcional
|
|
46
|
+
- **Imutabilidade**: <pontos críticos a observar>
|
|
47
|
+
- **Ausência de side effects esperados**: <onde o legado tinha efeito colateral implícito>
|
|
48
|
+
- **Equivalência sob composição**: <funções compostas equivalem ao fluxo legado>
|
|
49
|
+
|
|
50
|
+
## Tipos de teste a aplicar
|
|
51
|
+
- **Funcionais**: <descrição, ferramenta>
|
|
52
|
+
- **Contrato**: <descrição, ferramenta>
|
|
53
|
+
- **Carga / performance**: <descrição, alvos>
|
|
54
|
+
- **Resiliência** (se aplicável): <falha de fila, dependência externa indisponível>
|
|
55
|
+
|
|
56
|
+
## Reuso de characterization_specs do time de descoberta
|
|
57
|
+
- **Origem**: `_reversa_sdd/characterization_specs/` ou equivalente disponível.
|
|
58
|
+
- **Adaptações necessárias para o sistema novo**: <texto>
|
|
59
|
+
|
|
60
|
+
## Saídas
|
|
61
|
+
- `parity_tests/*.feature`: cenários em Gherkin para os fluxos críticos.
|
|
62
|
+
|
|
63
|
+
## Notas
|
|
64
|
+
<Observações adicionais.>
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# Template de cenário Gherkin para parity_tests/.
|
|
2
|
+
# Cada arquivo deve cobrir um fluxo crítico identificado em process_flows do legado.
|
|
3
|
+
# Adaptar critérios ao paradigma alvo conforme `parity_specs.md`.
|
|
4
|
+
|
|
5
|
+
# language: pt
|
|
6
|
+
# spec-id: PT-001
|
|
7
|
+
# rastreabilidade:
|
|
8
|
+
# process_flows: <ref ao fluxo no _reversa_sdd>
|
|
9
|
+
# target_architecture: <ref a componente no target_architecture.md>
|
|
10
|
+
# paradigma_alvo: <do paradigm_decision.md>
|
|
11
|
+
|
|
12
|
+
Funcionalidade: <Nome do fluxo>
|
|
13
|
+
Como <ator>
|
|
14
|
+
Quero <ação>
|
|
15
|
+
Para <objetivo>
|
|
16
|
+
|
|
17
|
+
# Critério geral de paridade aplicado a este cenário.
|
|
18
|
+
# Quando o paradigma alvo é event-driven, expressar tolerância de consistência eventual aqui.
|
|
19
|
+
@paridade @critico
|
|
20
|
+
Cenário: <descrição>
|
|
21
|
+
Dado <pré-condição observável>
|
|
22
|
+
E <pré-condição secundária>
|
|
23
|
+
Quando <ação executada via API / comando / evento de entrada>
|
|
24
|
+
Então <efeito observável no sistema novo>
|
|
25
|
+
E <efeito observável persiste após <janela de propagação>>
|
|
26
|
+
|
|
27
|
+
# Cenário específico para validar idempotência (event-driven, retry seguro).
|
|
28
|
+
@paridade @idempotencia
|
|
29
|
+
Cenário: Reprocessamento não duplica efeito
|
|
30
|
+
Dado <pré-condição>
|
|
31
|
+
Quando <ação> é processada uma vez
|
|
32
|
+
E <ação> é reentregue por retry
|
|
33
|
+
Então o efeito observável é idêntico ao da primeira entrega
|
|
34
|
+
|
|
35
|
+
# Cenário específico para validar ordem em paradigma event-driven.
|
|
36
|
+
@paridade @ordem
|
|
37
|
+
Cenário: Ordem de eventos é respeitada por chave
|
|
38
|
+
Dado <chave de particionamento>
|
|
39
|
+
Quando <evento A> é publicado antes de <evento B> com a mesma chave
|
|
40
|
+
Então <efeito observável> reflete a ordem A → B
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: pending_decisions
|
|
7
|
+
producedBy: orchestrator
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Pending Decisions
|
|
12
|
+
|
|
13
|
+
> Arquivo transitório usado durante pausas humanas. Cada item descreve uma decisão aberta com contexto e opções.
|
|
14
|
+
> Após o usuário responder, o item é movido para `ambiguity_log.md` (ou para o artefato dono da decisão) e este arquivo pode ser apagado.
|
|
15
|
+
|
|
16
|
+
## Decisões abertas
|
|
17
|
+
|
|
18
|
+
### PD-001
|
|
19
|
+
- **Agente que solicitou**: paradigm_advisor | curator | strategist | designer | screen_translator | inspector
|
|
20
|
+
- **Tópico**: <título curto>
|
|
21
|
+
- **Contexto**:
|
|
22
|
+
<texto explicando por que essa decisão é necessária aqui>
|
|
23
|
+
- **Opções**:
|
|
24
|
+
1. <opção 1>
|
|
25
|
+
2. <opção 2>
|
|
26
|
+
3. <opção 3>
|
|
27
|
+
- **Default proposto** (usado em `--auto`): <opção número>
|
|
28
|
+
- **Impacto se decidido errado**: <texto>
|
|
29
|
+
- **Onde a decisão será gravada**: <ex: `paradigm_decision.md § Decisão do usuário`>
|
|
30
|
+
|
|
31
|
+
<repetir por decisão>
|
|
32
|
+
|
|
33
|
+
## Como responder
|
|
34
|
+
|
|
35
|
+
- No chat: respondendo direto ao agente com o número da opção e justificativa.
|
|
36
|
+
- Em arquivo: editando este `pending_decisions.md`, adicionando um campo `Resposta:` em cada item.
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: risk_register
|
|
7
|
+
producedBy: strategist
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Risk Register
|
|
12
|
+
|
|
13
|
+
> Registro de riscos da migração com probabilidade, impacto, mitigação e responsável.
|
|
14
|
+
|
|
15
|
+
## Riscos
|
|
16
|
+
|
|
17
|
+
### RISK-001
|
|
18
|
+
- **Descrição**: <texto>
|
|
19
|
+
- **Categoria**: técnico | operacional | organizacional | regulatório | financeiro
|
|
20
|
+
- **Probabilidade**: baixa | média | alta
|
|
21
|
+
- **Impacto**: baixo | médio | alto | crítico
|
|
22
|
+
- **Severidade combinada**: <calculada a partir dos dois acima>
|
|
23
|
+
- **Trigger / sinal de alerta**: <o que indicaria que o risco está se materializando>
|
|
24
|
+
- **Mitigação**: <ações concretas>
|
|
25
|
+
- **Plano de contingência**: <se mitigação falhar>
|
|
26
|
+
- **Owner**: <nome / papel>
|
|
27
|
+
- **Status**: aberto | mitigando | aceito | encerrado
|
|
28
|
+
|
|
29
|
+
<repetir por risco>
|
|
30
|
+
|
|
31
|
+
## Resumo por severidade
|
|
32
|
+
|
|
33
|
+
| Severidade | Quantidade | IDs |
|
|
34
|
+
|---|---|---|
|
|
35
|
+
| Crítica | | |
|
|
36
|
+
| Alta | | |
|
|
37
|
+
| Média | | |
|
|
38
|
+
| Baixa | | |
|
|
39
|
+
|
|
40
|
+
## Riscos relacionados ao paradigma alvo
|
|
41
|
+
|
|
42
|
+
> Subseção dedicada quando há mudança de paradigma. Listar apenas riscos cuja origem direta é o gap registrado em `paradigm_decision.md`.
|
|
43
|
+
|
|
44
|
+
- <RISK-XXX: descrição>
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: target_architecture
|
|
7
|
+
producedBy: designer
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Target Architecture
|
|
12
|
+
|
|
13
|
+
> Arquitetura alvo do sistema novo, respeitando o paradigma escolhido em `paradigm_decision.md` e a estratégia confirmada em `migration_strategy.md`.
|
|
14
|
+
|
|
15
|
+
## Visão geral
|
|
16
|
+
<Resumo em 3 a 6 linhas: o que é o sistema novo, qual paradigma ele segue, quais bordas tem com o legado durante a migração.>
|
|
17
|
+
|
|
18
|
+
## Diagrama (Mermaid)
|
|
19
|
+
|
|
20
|
+
```mermaid
|
|
21
|
+
flowchart LR
|
|
22
|
+
%% Substituir pelo diagrama real
|
|
23
|
+
Cliente -->|HTTP| API
|
|
24
|
+
API --> Servico
|
|
25
|
+
Servico --> Banco[(DB)]
|
|
26
|
+
Servico -.eventos.-> Fila[[Mensageria]]
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## Componentes
|
|
30
|
+
|
|
31
|
+
| Componente | Tipo | Responsabilidade | Origem (legado / novo / fundido) |
|
|
32
|
+
|---|---|---|---|
|
|
33
|
+
| <nome> | API / Serviço / Worker / DB / Fila | <texto> | <ref para legado ou "novo"> |
|
|
34
|
+
|
|
35
|
+
## Bounded contexts
|
|
36
|
+
|
|
37
|
+
### BC-01: <nome>
|
|
38
|
+
- **Responsabilidade**: <texto>
|
|
39
|
+
- **Justificativa do agrupamento / separação**: <por que esse contexto não foi decomposto 1-para-1 a partir do legado>
|
|
40
|
+
- **Componentes internos**: <lista>
|
|
41
|
+
- **Eventos publicados** (se paradigma event-driven): <lista>
|
|
42
|
+
- **Eventos consumidos**: <lista>
|
|
43
|
+
|
|
44
|
+
<repetir por contexto>
|
|
45
|
+
|
|
46
|
+
## Decisões arquiteturais (ADR-style resumido)
|
|
47
|
+
|
|
48
|
+
### AD-01: <título>
|
|
49
|
+
- **Decisão**: <texto>
|
|
50
|
+
- **Alternativas descartadas**: <lista>
|
|
51
|
+
- **Justificativa**: <texto, ligando a paradigma, estratégia e apetite>
|
|
52
|
+
- **Rastreabilidade**: <referência ao legado ou ao discard_log>
|
|
53
|
+
|
|
54
|
+
## Honra ao paradigma escolhido
|
|
55
|
+
|
|
56
|
+
> Seção obrigatória quando há mudança de paradigma. Demonstra que a arquitetura honra a decisão de `paradigm_decision.md`.
|
|
57
|
+
|
|
58
|
+
- **Paradigma alvo**: <do `paradigm_decision.md`>
|
|
59
|
+
- **Como a arquitetura honra esse paradigma**:
|
|
60
|
+
- <ex: event-driven → eventos explícitos, schemas de mensagem, estratégia de consistência eventual>
|
|
61
|
+
- <ex: OO com DI → interfaces, container de injeção, bordas claras entre camadas>
|
|
62
|
+
- <ex: funcional → tipos imutáveis, composição, ausência de side effects no domínio>
|
|
63
|
+
|
|
64
|
+
## Bordas com o legado durante a migração
|
|
65
|
+
- <ex: durante o Strangler Fig, a API nova reroteia chamadas do legado X até a fase Y>
|
|
66
|
+
|
|
67
|
+
## Notas
|
|
68
|
+
<Observações de design adicionais.>
|