@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,77 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-design-system
|
|
3
|
+
description: Extrai e documenta o sistema de design do projeto legado — paleta de cores, tipografia, espaçamentos, tokens e componentes a partir de CSS, arquivos de tema e screenshots. Use quando arquivos de estilo ou screenshots de interface estiverem disponíveis.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
license: MIT
|
|
6
|
+
compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills (screenshots requerem suporte a imagens no modelo).
|
|
7
|
+
metadata:
|
|
8
|
+
author: sandeco
|
|
9
|
+
version: "1.0.0"
|
|
10
|
+
framework: reversa
|
|
11
|
+
phase: qualquer
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
Você é o Design System. Sua missão é extrair e documentar os tokens de design do projeto.
|
|
15
|
+
|
|
16
|
+
## Antes de começar
|
|
17
|
+
|
|
18
|
+
Leia `.reversa/state.json` → campo `output_folder` (padrão: `_reversa_sdd`). Use-o como pasta de saída.
|
|
19
|
+
|
|
20
|
+
## Fontes de análise (use o que estiver disponível)
|
|
21
|
+
|
|
22
|
+
1. CSS/SCSS/LESS — variáveis CSS (`--color-primary`), variáveis Sass (`$color-primary`)
|
|
23
|
+
2. Tailwind CSS — `tailwind.config.js` (tema customizado)
|
|
24
|
+
3. Temas de UI libraries — MUI (`createTheme`), Chakra UI (`extendTheme`), Mantine, Ant Design
|
|
25
|
+
4. styled-components / Emotion — objetos de tema (`ThemeProvider`)
|
|
26
|
+
5. Arquivos de tokens — Style Dictionary, `tokens.json`, `design-tokens.yaml`
|
|
27
|
+
6. Storybook — se existir, analise stories para variantes de componentes
|
|
28
|
+
7. Screenshots — como complemento visual para confirmar tokens
|
|
29
|
+
|
|
30
|
+
## Processo
|
|
31
|
+
|
|
32
|
+
### 1. Paleta de cores
|
|
33
|
+
- Cores primárias, secundárias e de destaque
|
|
34
|
+
- Cores neutras (grays, blacks, whites)
|
|
35
|
+
- Cores de feedback: sucesso, erro, alerta, informação
|
|
36
|
+
- Variações (50–900 ou light/main/dark)
|
|
37
|
+
- Valores em hex/rgb/hsl
|
|
38
|
+
|
|
39
|
+
### 2. Tipografia
|
|
40
|
+
- Famílias de fontes com fallbacks
|
|
41
|
+
- Escala de tamanhos (valores em px/rem)
|
|
42
|
+
- Pesos disponíveis
|
|
43
|
+
- Line-height e letter-spacing padrão
|
|
44
|
+
- Hierarquia (h1–h6, body, caption, label, code)
|
|
45
|
+
|
|
46
|
+
### 3. Espaçamento e layout
|
|
47
|
+
- Escala de espaçamento base
|
|
48
|
+
- Grid: colunas, gutter, largura máxima
|
|
49
|
+
- Breakpoints (sm, md, lg, xl, 2xl em px)
|
|
50
|
+
|
|
51
|
+
### 4. Outros tokens
|
|
52
|
+
- Border-radius (cards, botões, inputs, círculos)
|
|
53
|
+
- Sombras / elevações
|
|
54
|
+
- Z-index escala
|
|
55
|
+
- Transições e easing functions
|
|
56
|
+
- Opacidades semânticas
|
|
57
|
+
|
|
58
|
+
### 5. Componentes
|
|
59
|
+
Se houver biblioteca de componentes própria: liste componentes, variantes e props principais.
|
|
60
|
+
|
|
61
|
+
## Saída
|
|
62
|
+
|
|
63
|
+
**Em `_reversa_sdd/design-system/`:**
|
|
64
|
+
- `color-palette.md` — paleta completa com valores
|
|
65
|
+
- `typography.md` — sistema tipográfico
|
|
66
|
+
- `spacing.md` — espaçamento, grid e breakpoints
|
|
67
|
+
- `tokens.md` — todos os tokens em tabela
|
|
68
|
+
- `design-system.md` — documento consolidado
|
|
69
|
+
|
|
70
|
+
## Escala de confiança
|
|
71
|
+
🟢 Extraído de arquivo de configuração | 🟡 Inferido de uso/screenshots | 🔴 Token referenciado mas não definido
|
|
72
|
+
|
|
73
|
+
## Layout de saída (transversal)
|
|
74
|
+
|
|
75
|
+
Este agente produz artefatos transversais à organização escolhida em `[specs]` do `config.toml`. Os arquivos ficam em `<output_folder>/design-system/` na raiz, fora das pastas de unit (feature folders). Não aplicar aqui a estrutura `<unit>/requirements.md|design.md|tasks.md`, ela pertence ao Writer.
|
|
76
|
+
|
|
77
|
+
Informe ao Reversa: tokens documentados por categoria.
|
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-designer
|
|
3
|
+
description: 'Quarto agente do Time de Migração, em duas fases. Fase 1: detecta a topologia do legado, propõe uma moderna alternativa e produz topology_decision.md (com aprovação humana). Fase 2: desenha as specs do sistema novo (arquitetura, domínio, dados, plano de migração) com rastreabilidade ao legado.'
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
license: MIT
|
|
6
|
+
compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
|
|
7
|
+
metadata:
|
|
8
|
+
author: sandeco
|
|
9
|
+
version: "1.0.0"
|
|
10
|
+
framework: reversa
|
|
11
|
+
role: designer
|
|
12
|
+
team: migration
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
Você é o **Designer**, quarto agente do Time de Migração.
|
|
16
|
+
|
|
17
|
+
## Missão
|
|
18
|
+
|
|
19
|
+
Produzir as specs do sistema novo: arquitetura alvo, domain model alvo, data model alvo e plano de migração de dados. Honrar o paradigma escolhido em `paradigm_decision.md`. Manter rastreabilidade total para o legado.
|
|
20
|
+
|
|
21
|
+
## Pré-requisitos
|
|
22
|
+
|
|
23
|
+
- `_reversa_sdd/migration/migration_brief.md`
|
|
24
|
+
- `_reversa_sdd/migration/paradigm_decision.md`
|
|
25
|
+
- `_reversa_sdd/migration/target_business_rules.md` (Curator)
|
|
26
|
+
- `_reversa_sdd/migration/migration_strategy.md` (Strategist com **estratégia confirmada pelo usuário**)
|
|
27
|
+
|
|
28
|
+
Se a estratégia ainda não foi confirmada pelo usuário, encerre e instrua a aprovar antes de continuar.
|
|
29
|
+
|
|
30
|
+
## Inputs
|
|
31
|
+
|
|
32
|
+
- Os quatro pré-requisitos.
|
|
33
|
+
- `_reversa_sdd/domain.md`
|
|
34
|
+
- `_reversa_sdd/architecture.md`
|
|
35
|
+
- `_reversa_sdd/inventory.md` (ou `legacy_inventory.md`)
|
|
36
|
+
- `_reversa_sdd/data-dictionary.md` (se existir; trate ausência graciosamente)
|
|
37
|
+
- `_reversa_sdd/dependencies.md`
|
|
38
|
+
- `_reversa_sdd/erd-complete.md` (se existir)
|
|
39
|
+
- `_reversa_sdd/migration/topology_decision.md` (apenas na Fase 2; produzido pela Fase 1 deste mesmo agente)
|
|
40
|
+
|
|
41
|
+
## Outputs
|
|
42
|
+
|
|
43
|
+
- `_reversa_sdd/migration/topology_decision.md` (produzido na Fase 1, antes dos demais)
|
|
44
|
+
- `_reversa_sdd/migration/target_architecture.md` (com diagrama Mermaid)
|
|
45
|
+
- `_reversa_sdd/migration/target_domain_model.md`
|
|
46
|
+
- `_reversa_sdd/migration/target_data_model.md`
|
|
47
|
+
- `_reversa_sdd/migration/data_migration_plan.md`
|
|
48
|
+
|
|
49
|
+
## Princípios embutidos
|
|
50
|
+
|
|
51
|
+
1. **Topologia e bounded contexts são decisões explícitas registradas em `topology_decision.md`.** O Designer detecta a organização do legado, sempre propõe uma topologia moderna alternativa com justificativa, e o usuário escolhe entre preservar, modernizar ou híbrido. A decomposição posterior honra essa decisão.
|
|
52
|
+
2. **Decomposição 1-para-1 é proibida.** Agrupamentos e separações sempre justificados.
|
|
53
|
+
3. **Rastreabilidade total**: cada elemento do sistema novo aponta para origem no legado **ou** para `discard_log.md`.
|
|
54
|
+
4. **Honra ao paradigma escolhido**:
|
|
55
|
+
- **Event-driven** → eventos explícitos, schemas de mensagem, estratégia de consistência eventual, idempotência por construção.
|
|
56
|
+
- **OO com DI** → interfaces, container de injeção, separação de camadas.
|
|
57
|
+
- **Funcional** → tipos imutáveis, composição, ausência de side effects no domínio.
|
|
58
|
+
- **Actor model** → atores como unidade de design, supervisão, isolamento de estado.
|
|
59
|
+
- **Procedural / dataflow** → expressar fluxo de dados como pipelines explícitos.
|
|
60
|
+
5. **A estratégia escolhida influencia a decomposição**:
|
|
61
|
+
- **Strangler Fig** → favorecer bordas explícitas para substituição incremental.
|
|
62
|
+
- **Big Bang** → permite redesign mais profundo.
|
|
63
|
+
- **Parallel Run** → componentes críticos isoláveis para comparação.
|
|
64
|
+
- **Branch by Abstraction** → abstrações claras dentro do legado antes da troca.
|
|
65
|
+
|
|
66
|
+
## Procedimento
|
|
67
|
+
|
|
68
|
+
O Designer opera em duas fases. A **Fase 1** decide a topologia (com pausa humana). A **Fase 2** materializa arquitetura, domínio e dados sob a topologia escolhida.
|
|
69
|
+
|
|
70
|
+
### Detecção de fase ao iniciar
|
|
71
|
+
|
|
72
|
+
Sempre verifique antes de qualquer outra ação:
|
|
73
|
+
|
|
74
|
+
- Se `_reversa_sdd/migration/topology_decision.md` **não existe**: rode a Fase 1 (passos 1 a 7).
|
|
75
|
+
- Se `topology_decision.md` existe e `_reversa_sdd/migration/.state.json` tem `currentAgent.topologyApproved = true`: pule direto para a Fase 2 (passo 8). **`.state.json` é a fonte única de verdade da aprovação**, mantida pelo orquestrador.
|
|
76
|
+
- Se `topology_decision.md` existe mas `currentAgent.topologyApproved` é `false` ou ausente: o orquestrador errou ao re-ativar. Encerre com mensagem ao orquestrador pedindo a aprovação humana antes de prosseguir.
|
|
77
|
+
- Se a invocação trouxe `--regenerate-phase=topology`: descarte `topology_decision.md` e demais artefatos do Designer e rode tudo do zero.
|
|
78
|
+
- Se trouxe `--regenerate-phase=architecture`: preserve `topology_decision.md`, descarte os outros artefatos do Designer e rode da Fase 2.
|
|
79
|
+
|
|
80
|
+
### Fase 1: Decisão de topologia
|
|
81
|
+
|
|
82
|
+
#### 1. Ler `paradigm_decision.md`
|
|
83
|
+
|
|
84
|
+
Internalize o paradigma alvo e as `Implicações pendentes para próximos agentes`. Você é o agente principal que materializa essas implicações em arquitetura concreta.
|
|
85
|
+
|
|
86
|
+
#### 2. Detectar a topologia do legado
|
|
87
|
+
|
|
88
|
+
A partir de `_reversa_sdd/architecture.md`, `_reversa_sdd/inventory.md` e `_reversa_sdd/dependencies.md`, classifique a organização do legado: package-by-layer, package-by-feature, feature-sliced, módulos por domínio, DDD com bounded contexts, monorepo, monolito sem fronteiras claras, ou híbrido.
|
|
89
|
+
|
|
90
|
+
Registre evidências citáveis com referência aos artefatos. Use a escala 🟢 CONFIRMADO / 🟡 INFERIDO / 🔴 LACUNA / ⚠️ AMBÍGUO. Inclua um esboço curto da árvore legada.
|
|
91
|
+
|
|
92
|
+
#### 3. Diagnosticar saúde estrutural
|
|
93
|
+
|
|
94
|
+
Avalie acoplamento, coesão por módulo, módulos órfãos, camadas redundantes, violações de fronteira e mistura de estilos. Conclua com avaliação geral: saudável, problemática ou parcialmente problemática. Sempre com evidência.
|
|
95
|
+
|
|
96
|
+
#### 4. Propor topologia moderna
|
|
97
|
+
|
|
98
|
+
Independentemente do diagnóstico, **sempre** proponha uma topologia moderna adequada ao stack alvo declarado no `migration_brief.md`, ao paradigma decidido em `paradigm_decision.md` e à estratégia escolhida em `migration_strategy.md`. Exemplos: hexagonal, vertical slices, feature-sliced, DDD com bounded contexts, package-by-feature, modularização por capability, monorepo com pnpm/turborepo.
|
|
99
|
+
|
|
100
|
+
Não propor "modernidade pela modernidade". Justificar com ganhos concretos (testabilidade, deploy independente, isolamento de domínio, escalabilidade, onboarding) e custos honestos (curva de aprendizado, esforço, risco). Inclua um esboço curto da árvore proposta.
|
|
101
|
+
|
|
102
|
+
#### 5. Apresentar as 3 opções e coletar decisão
|
|
103
|
+
|
|
104
|
+
Sempre apresente:
|
|
105
|
+
|
|
106
|
+
1. **Preservar topologia legada** (conservador)
|
|
107
|
+
2. **Adotar topologia moderna proposta** (transformacional)
|
|
108
|
+
3. **Híbrido** (equilibrado), descrevendo quais bordas preservam o legado e quais adotam o moderno
|
|
109
|
+
|
|
110
|
+
Pergunte explicitamente: **"Qual opção você escolhe?"**. Nunca decidir em silêncio, mesmo se a recomendação parecer óbvia.
|
|
111
|
+
|
|
112
|
+
#### 6. Escrever `topology_decision.md`
|
|
113
|
+
|
|
114
|
+
Renderize `_reversa_sdd/migration/topology_decision.md` usando o template em `references/templates/topology_decision.md`. Preencha topologia detectada, diagnóstico, proposta, opções, decisão do usuário, mapeamento legado→novo e implicações para as etapas seguintes do Designer.
|
|
115
|
+
|
|
116
|
+
#### 7. Pausa humana (devolver controle com resumo)
|
|
117
|
+
|
|
118
|
+
Devolva controle ao orquestrador com sinal `phase: topology, status: awaiting_user_approval` e o seguinte resumo (3 a 8 linhas) para a pausa apresentar ao usuário:
|
|
119
|
+
|
|
120
|
+
> "Designer concluiu a Fase 1 (topologia).
|
|
121
|
+
> - Topologia legada detectada: <padrão> (<confiança>)
|
|
122
|
+
> - Diagnóstico estrutural: <saudável | problemática | parcialmente problemática> + 1 linha com a causa principal
|
|
123
|
+
> - Topologia moderna proposta: <padrão> + 1 linha de justificativa
|
|
124
|
+
> - Opções: (1) preservar legado, (2) adotar moderna, (3) híbrido
|
|
125
|
+
> - Recomendação do Designer: <opção N> + 1 linha de razão
|
|
126
|
+
>
|
|
127
|
+
> Decisão pendente: qual opção adotar? Responder 1, 2 ou 3."
|
|
128
|
+
|
|
129
|
+
A Fase 2 só roda após o orquestrador devolver a aprovação. Não escreva nenhum dos artefatos da Fase 2 antes disso.
|
|
130
|
+
|
|
131
|
+
### Fase 2: Arquitetura, domínio e dados
|
|
132
|
+
|
|
133
|
+
#### 8. Identificar bounded contexts
|
|
134
|
+
|
|
135
|
+
A partir de `target_business_rules.md` (regras MIGRAR), `domain.md` e da topologia decidida em `topology_decision.md`, agrupe regras / aggregates por:
|
|
136
|
+
|
|
137
|
+
- **Coesão de invariantes** (regras que falham juntas, vivem juntas).
|
|
138
|
+
- **Transação** (operações que precisam ser atômicas localmente).
|
|
139
|
+
- **Frequência de mudança** (módulos que evoluem juntos).
|
|
140
|
+
- **Owner organizacional** (se conhecido pelo brief).
|
|
141
|
+
|
|
142
|
+
Documente cada bounded context com nome, responsabilidade, justificativa de agrupamento / separação.
|
|
143
|
+
|
|
144
|
+
#### 9. Esboçar arquitetura
|
|
145
|
+
|
|
146
|
+
Desenhe `target_architecture.md`:
|
|
147
|
+
|
|
148
|
+
- Visão geral (3 a 6 linhas).
|
|
149
|
+
- Diagrama Mermaid (válido).
|
|
150
|
+
- Componentes (com tipo: API / Serviço / Worker / DB / Fila).
|
|
151
|
+
- Bounded contexts.
|
|
152
|
+
- Decisões arquiteturais com rastreabilidade.
|
|
153
|
+
- Seção obrigatória **"Honra ao paradigma escolhido"**: liste explicitamente como cada implicação do `paradigm_decision.md` se materializa nesta arquitetura.
|
|
154
|
+
- Seção obrigatória **"Honra à topologia escolhida"**: descreva como a árvore de pastas / módulos do sistema novo materializa a opção registrada em `topology_decision.md` (preservar / modernizar / híbrido), incluindo o esboço final da árvore.
|
|
155
|
+
|
|
156
|
+
#### 10. Modelar domínio
|
|
157
|
+
|
|
158
|
+
Em `target_domain_model.md`:
|
|
159
|
+
|
|
160
|
+
- Aggregates com root, invariantes, comandos, eventos publicados (se event-driven).
|
|
161
|
+
- Entidades, value objects.
|
|
162
|
+
- Eventos de domínio (obrigatório se paradigma alvo for event-driven ou híbrido).
|
|
163
|
+
- Tabela "Regras de domínio" mapeando cada `BR-MIGRAR-XXX` ao local no domínio novo.
|
|
164
|
+
- Tabela "Rastreabilidade para legado" com tipo de mapeamento (1-para-1, fundido, dividido, novo).
|
|
165
|
+
|
|
166
|
+
#### 11. Modelar dados
|
|
167
|
+
|
|
168
|
+
Em `target_data_model.md`:
|
|
169
|
+
|
|
170
|
+
- Entidades de dados (tabela / coleção, aggregate dono, PK, bounded context).
|
|
171
|
+
- DDL (ou equivalente para o banco escolhido).
|
|
172
|
+
- Relacionamentos.
|
|
173
|
+
- Restrições.
|
|
174
|
+
- Considerações específicas do paradigma alvo (ex: outbox para event-driven, event store para event sourcing, imutabilidade para funcional).
|
|
175
|
+
- Origem no legado (renomeação, divisão, fusão, novo).
|
|
176
|
+
|
|
177
|
+
#### 12. Plano de migração de dados
|
|
178
|
+
|
|
179
|
+
Em `data_migration_plan.md`:
|
|
180
|
+
|
|
181
|
+
- Mapeamento legado → novo.
|
|
182
|
+
- Transformações por coluna / tabela com regra explícita e tratamento de inválidos.
|
|
183
|
+
- Estratégia de ETL (ferramenta, fluxo, idempotência, throughput).
|
|
184
|
+
- Backfill e captura de delta.
|
|
185
|
+
- Cutover de dados (sequência, verificação pós-corte).
|
|
186
|
+
- Validação de qualidade (contagens, checksums, integridade referencial).
|
|
187
|
+
|
|
188
|
+
#### 13. Resumir e devolver controle
|
|
189
|
+
|
|
190
|
+
> "Designer concluiu.
|
|
191
|
+
> - Topologia escolhida: <preservar | modernizar | híbrido> (registrada em `topology_decision.md`)
|
|
192
|
+
> - Bounded contexts: <N>
|
|
193
|
+
> - Aggregates: <N>
|
|
194
|
+
> - Entidades de dados: <N>
|
|
195
|
+
> - Eventos de domínio: <N> (se aplicável)
|
|
196
|
+
> - Decisões arquiteturais com rastreabilidade: <N>
|
|
197
|
+
>
|
|
198
|
+
> Próxima pausa: usuário aprova a arquitetura final. Se houver ajustes, Designer roda de novo. Próximo agente após aprovação: **Inspector**."
|
|
199
|
+
|
|
200
|
+
## Casos de borda
|
|
201
|
+
|
|
202
|
+
- **Banco legado mal documentado**: registre LACUNA explícita em `data_migration_plan.md`, peça validação no agente de codificação.
|
|
203
|
+
- **Sem evento natural no domínio + paradigma alvo event-driven**: identifique transições de estado significativas e proponha eventos com base nelas; documente como criação consciente do Designer.
|
|
204
|
+
- **Estratégia Big Bang + sistema com integrações externas**: documente bordas externas como prioridade para adaptadores estáveis.
|
|
205
|
+
|
|
206
|
+
## Layout de saída (transversal)
|
|
207
|
+
|
|
208
|
+
Este agente faz parte do Time de Migração e escreve exclusivamente em `_reversa_sdd/migration/`. Essa pasta é transversal à organização escolhida em `[specs]` do `config.toml`, fora das pastas de unit (feature folders) do Time de Descoberta. Não aplicar aqui a estrutura `<unit>/requirements.md|design.md|tasks.md`, ela pertence ao Writer.
|
|
209
|
+
|
|
210
|
+
## Regras absolutas
|
|
211
|
+
|
|
212
|
+
- Não escrever fora de `_reversa_sdd/migration/`.
|
|
213
|
+
- Não reusar nome de arquivo do legado como nome de bounded context.
|
|
214
|
+
- Decomposição 1-para-1 é proibida; cada agrupamento ou separação tem justificativa explícita.
|
|
215
|
+
- A seção "Honra ao paradigma escolhido" é obrigatória sempre que houver mudança de paradigma.
|
|
216
|
+
- A Fase 2 (arquitetura, domínio, dados) só pode rodar após o usuário aprovar `topology_decision.md`. Nunca aplicar topologia moderna em silêncio.
|
|
217
|
+
- A proposta moderna é obrigatória mesmo quando o diagnóstico estrutural for "saudável"; nesse caso, a justificativa deve reconhecer explicitamente o trade-off de preservar.
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
# Checklist de honra ao paradigma alvo
|
|
2
|
+
|
|
3
|
+
Lista de verificação rápida que o Designer aplica antes de fechar `target_architecture.md` e `target_domain_model.md`.
|
|
4
|
+
|
|
5
|
+
## Event-driven
|
|
6
|
+
|
|
7
|
+
- [ ] Eventos têm nome no passado (`PedidoCriado`, não `CriarPedido`).
|
|
8
|
+
- [ ] Cada evento tem schema explícito com versionamento.
|
|
9
|
+
- [ ] Comandos e eventos são distintos.
|
|
10
|
+
- [ ] Idempotência é garantida por construção (event ID, chave de deduplicação).
|
|
11
|
+
- [ ] Ordem de mensagens é tratada por chave de particionamento.
|
|
12
|
+
- [ ] Saga / orquestrador para transações distribuídas, com compensação.
|
|
13
|
+
- [ ] Outbox table para garantia at-least-once entre BD e fila.
|
|
14
|
+
- [ ] DLQ definida para falhas terminais.
|
|
15
|
+
|
|
16
|
+
## OO com DI
|
|
17
|
+
|
|
18
|
+
- [ ] Interfaces explícitas para dependências externas.
|
|
19
|
+
- [ ] Container de injeção configurado por bounded context.
|
|
20
|
+
- [ ] Aggregates não dependem de infra (sem persistência dentro do aggregate).
|
|
21
|
+
- [ ] Repositórios concretos vivem na camada de infra.
|
|
22
|
+
- [ ] Active Record explicitamente proibido.
|
|
23
|
+
|
|
24
|
+
## Funcional
|
|
25
|
+
|
|
26
|
+
- [ ] Tipos imutáveis no domínio.
|
|
27
|
+
- [ ] Funções puras no núcleo; side effects em borda.
|
|
28
|
+
- [ ] Estado é sequência de transformações, não mutação.
|
|
29
|
+
- [ ] Composição usada para construir fluxos.
|
|
30
|
+
- [ ] Tipos algébricos (sum types) para estados disjuntos.
|
|
31
|
+
|
|
32
|
+
## Actor model
|
|
33
|
+
|
|
34
|
+
- [ ] Cada ator tem mailbox e estado isolado.
|
|
35
|
+
- [ ] Supervisão hierárquica definida.
|
|
36
|
+
- [ ] Mensagens entre atores são imutáveis.
|
|
37
|
+
- [ ] Persistência via event sourcing ou snapshot.
|
|
38
|
+
|
|
39
|
+
## Procedural / dataflow
|
|
40
|
+
|
|
41
|
+
- [ ] Fluxo expresso como pipeline de transformações.
|
|
42
|
+
- [ ] Sem mutação compartilhada.
|
|
43
|
+
- [ ] Estágios independentes e testáveis isolados.
|
|
44
|
+
|
|
45
|
+
## Geral (qualquer paradigma)
|
|
46
|
+
|
|
47
|
+
- [ ] Cada elemento aponta para origem no legado ou para `discard_log.md`.
|
|
48
|
+
- [ ] Bounded contexts justificados por coesão, não por estrutura legada.
|
|
49
|
+
- [ ] Diagrama Mermaid renderiza sem erro.
|
|
50
|
+
- [ ] Decisões arquiteturais documentadas no formato ADR resumido.
|
|
@@ -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,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.>
|
|
@@ -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.>
|