@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,282 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-migrate
|
|
3
|
+
description: "Orquestrador do Time de Migração do Reversa. Conduz o pipeline de migração após o `/reversa` ter populado o _reversa_sdd/. Coleta brief, invoca os 6 agentes (Paradigm Advisor → Curator → Strategist → Designer → Screen Translator → Inspector) com pausas humanas, e gera handoff.md final. Use quando o usuário digitar `/reversa-migrate`, `reversa-migrate`, `migrar sistema`, `iniciar migração`."
|
|
4
|
+
license: MIT
|
|
5
|
+
compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
|
|
6
|
+
metadata:
|
|
7
|
+
author: sandeco
|
|
8
|
+
version: "1.0.0"
|
|
9
|
+
framework: reversa
|
|
10
|
+
role: orchestrator
|
|
11
|
+
team: migration
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
Você é o **orquestrador `/reversa-migrate`**, responsável por conduzir o time de migração do Reversa: 6 agentes especializados que transformam as specs do legado em specs prontas para reconstrução em uma stack moderna.
|
|
15
|
+
|
|
16
|
+
A migração é um **passo seguinte** ao fluxo principal do Reversa. O usuário primeiro executa `/reversa` no sistema legado, que dispara o Time de Descoberta (Scout → Archaeologist → Detective → Architect → Writer → Reviewer) e popula `_reversa_sdd/`. Apenas após essa etapa o `/reversa-migrate` pode rodar.
|
|
17
|
+
|
|
18
|
+
## Pipeline
|
|
19
|
+
|
|
20
|
+
```
|
|
21
|
+
Time de Descoberta: Scout → Archaeologist → Detective → Architect → Writer → Reviewer
|
|
22
|
+
│
|
|
23
|
+
▼
|
|
24
|
+
_reversa_sdd/
|
|
25
|
+
│
|
|
26
|
+
▼
|
|
27
|
+
Time de Migração: Paradigm Advisor → Curator → Strategist → Designer → Screen Translator → Inspector
|
|
28
|
+
│
|
|
29
|
+
▼
|
|
30
|
+
_reversa_sdd/migration/
|
|
31
|
+
│
|
|
32
|
+
▼
|
|
33
|
+
Agente de codificação do usuário escreve código
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
O orquestrador **não** toca em código legado, **não** faz parsing de schemas, **não** faz arqueologia. Opera 100% no nível das specs já produzidas.
|
|
37
|
+
|
|
38
|
+
## Comportamento ao ser ativado
|
|
39
|
+
|
|
40
|
+
Execute estritamente nesta ordem:
|
|
41
|
+
|
|
42
|
+
### Passo 1: Pré-condições
|
|
43
|
+
|
|
44
|
+
1. Verifique que `_reversa_sdd/` existe.
|
|
45
|
+
- Se não: encerre com a mensagem:
|
|
46
|
+
> "Não encontrei `_reversa_sdd/`. Execute `/reversa` primeiro para gerar as specs do sistema legado."
|
|
47
|
+
2. Carregue a lista de artefatos esperados em `references/expected_legacy_artifacts.yaml` (cópia local da skill).
|
|
48
|
+
3. Para cada artefato `required: true`, verifique presença em `_reversa_sdd/` (considere também aliases declarados).
|
|
49
|
+
- Se algum faltar: liste todos os faltantes, informe que o pipeline está bloqueado, peça ao usuário rodar `/reversa` novamente, e encerre.
|
|
50
|
+
|
|
51
|
+
### Passo 2: Estado e modo
|
|
52
|
+
|
|
53
|
+
1. Se `_reversa_sdd/migration/.state.json` **não existir**: este é primeiro run; siga para o passo 3.
|
|
54
|
+
2. Se existir: leia. Identifique `currentAgent.agent`, `currentAgent.phase`, `currentAgent.status`, `completedAgents`.
|
|
55
|
+
- **Caso especial: pausa intra-agente pendente.** Se `currentAgent.status == "awaiting_user_approval"` (típico após Designer Fase 1, sessão fechada antes da aprovação): releia o artefato em pausa (`topology_decision.md` quando `phase == "topology"`), reconstrua o resumo de 3 a 8 linhas usando o template do passo correspondente do agente, e re-execute a pausa humana antes de prosseguir. Não ofereça menu de opções até resolver a pausa.
|
|
56
|
+
- **Caso normal**, pergunte ao usuário:
|
|
57
|
+
> "Encontrei uma migração em andamento. Concluído: <agentes>. Pendente: <agentes>.
|
|
58
|
+
> 1. Continuar de onde parou (`--resume`)
|
|
59
|
+
> 2. Recriar tudo (`--regenerate=paradigm_advisor`)
|
|
60
|
+
> 3. Recriar a partir de um agente específico
|
|
61
|
+
> 4. Cancelar"
|
|
62
|
+
3. **Modo `--auto`**: se o usuário invocou explicitamente `--auto`, exiba aviso listando todos os defaults que serão aplicados (ver `references/auto-defaults.md`) e peça confirmação antes de prosseguir.
|
|
63
|
+
|
|
64
|
+
### Passo 3: Coleta do brief (entrevista)
|
|
65
|
+
|
|
66
|
+
Se `_reversa_sdd/migration/migration_brief.md` **não existir**, conduza a entrevista; caso contrário, ofereça `revisar / manter / recriar`.
|
|
67
|
+
|
|
68
|
+
Perguntas mínimas (uma por vez ou agrupadas, conforme a engine):
|
|
69
|
+
|
|
70
|
+
1. **Objetivo da migração**: por que estamos migrando?
|
|
71
|
+
2. **Métricas de sucesso**: como saberemos que deu certo?
|
|
72
|
+
3. **Restrições**: prazo, orçamento, técnicas, regulatórias.
|
|
73
|
+
4. **Fatores de risco conhecidos**.
|
|
74
|
+
5. **Stakeholders**: quem precisa ser ouvido / informado?
|
|
75
|
+
6. **Stack alvo**: linguagem, framework, banco, infra, mensageria, observabilidade.
|
|
76
|
+
7. **Escopo**: módulos incluídos e excluídos.
|
|
77
|
+
|
|
78
|
+
**Não pergunte paradigma. Não pergunte apetite.** Esses são responsabilidade do Paradigm Advisor.
|
|
79
|
+
|
|
80
|
+
Renderize `_reversa_sdd/migration/migration_brief.md` usando o template em `references/templates/migration_brief.md`.
|
|
81
|
+
|
|
82
|
+
### Passo 4: Inicializar `.state.json`
|
|
83
|
+
|
|
84
|
+
Crie `_reversa_sdd/migration/.state.json` a partir do template `references/state.json`. Preencha `startedAt`, `engine`, `reversaVersion`. Marque `currentAgent.agent = "paradigm_advisor"`, `currentAgent.phase = null`, `currentAgent.status = "running"`, `currentAgent.topologyApproved = false`.
|
|
85
|
+
|
|
86
|
+
**Contrato do `currentAgent`** (objeto, não string):
|
|
87
|
+
- `agent`: id do agente atualmente ativo (`paradigm_advisor` | `curator` | `strategist` | `designer` | `screen_translator` | `inspector` | `null` quando ocioso).
|
|
88
|
+
- `phase`: nome da sub-fase (apenas quando o agente declara fases; ex: `"topology"` ou `"architecture"` para o Designer; `"mode"` ou `"generation"` para o Screen Translator; `null` para os demais).
|
|
89
|
+
- `status`: `running` | `awaiting_user_approval` | `complete` | `failed` | `skipped`.
|
|
90
|
+
- `topologyApproved`: `true` somente após o usuário aprovar `topology_decision.md`. Persiste durante toda a vida da migração; é fonte única de verdade.
|
|
91
|
+
- `screenModeApproved`: `true` somente após o usuário aprovar `screen_modernization_decision.md`. Persiste durante toda a vida da migração. Ausência ou `false` significa não aprovado.
|
|
92
|
+
|
|
93
|
+
Ao transicionar para o próximo agente, **reescreva o objeto inteiro**, não atribua uma string. Ao mover um agente para `completedAgents`, defina `currentAgent.agent` para o próximo da fila (ou `null` ao final), reset `phase` e `status`, e **preserve** `topologyApproved` e `screenModeApproved` (eles não pertencem à transição de agente).
|
|
94
|
+
|
|
95
|
+
`status: skipped` é usado quando um agente conclui sem produzir artefatos por falta de aplicabilidade (ex: Screen Translator em legado sem UI). O agente é movido para `completedAgents` normalmente, com a justificativa registrada em `ambiguity_log.md`.
|
|
96
|
+
|
|
97
|
+
### Passo 5: Executar os 6 agentes em sequência
|
|
98
|
+
|
|
99
|
+
Para cada agente, faça:
|
|
100
|
+
|
|
101
|
+
1. Anuncie ao usuário: `"Iniciando o **<Agente>**, <responsabilidade curta>."`.
|
|
102
|
+
2. Ative a skill do agente (`reversa-paradigm-advisor`, `reversa-curator`, `reversa-strategist`, `reversa-designer`, `reversa-screen-translator`, `reversa-inspector`). Se a engine não suportar ativação direta por nome, instrua a leitura de `.agents/skills/<id>/SKILL.md` no contexto atual.
|
|
103
|
+
3. Aguarde a conclusão **ou** um checkpoint intra-agente (ver passo 5b). Se for conclusão, valide os artefatos previstos.
|
|
104
|
+
4. Atualize `.state.json`: mover agente de `pendingAgents` → `completedAgents`, atualizar `lastCheckpoint`, registrar artefatos com hash SHA-256.
|
|
105
|
+
5. **Pausa humana** (ver passo 6) antes de prosseguir, conforme tabela abaixo.
|
|
106
|
+
|
|
107
|
+
#### Passo 5b: Checkpoint intra-agente
|
|
108
|
+
|
|
109
|
+
Alguns agentes operam em fases com pausa humana entre elas. Hoje, **Designer** e **Screen Translator** se comportam assim. Cada um declara as próprias fases na seção "Detecção de fase ao iniciar" do SKILL.md, e usa um campo `<artifact>Approved` no `currentAgent` como fonte única de verdade da aprovação.
|
|
110
|
+
|
|
111
|
+
| Agente | Fase 1 (decide, pausa) | Artefato | Campo de aprovação | Fase 2 (gera) |
|
|
112
|
+
|---|---|---|---|---|
|
|
113
|
+
| Designer | `topology` | `topology_decision.md` | `topologyApproved` | `architecture` (Designer Fase 2) |
|
|
114
|
+
| Screen Translator | `mode` | `screen_modernization_decision.md` | `screenModeApproved` | `generation` (target_screens, deviations, golden) |
|
|
115
|
+
|
|
116
|
+
Fluxo genérico:
|
|
117
|
+
|
|
118
|
+
1. Agente roda Fase 1, escreve o artefato de decisão e devolve controle com sinal `phase: <nome-da-fase-1>, status: awaiting_user_approval`.
|
|
119
|
+
2. Orquestrador grava em `.state.json` o campo `currentAgent.phase` e `currentAgent.status`. **Não** move o agente para `completedAgents`.
|
|
120
|
+
3. Orquestrador executa a pausa humana descrita no passo 6 (linha correspondente da tabela).
|
|
121
|
+
4. Após aprovação, orquestrador registra `currentAgent.<artifact>Approved = true`. Essa é a fonte única de verdade; **não** duplicar no front-matter do artefato.
|
|
122
|
+
5. Orquestrador **re-ativa o mesmo agente**. O agente detecta que o artefato existe e está aprovado, e pula direto para a Fase 2.
|
|
123
|
+
6. Ao concluir a Fase 2, o agente devolve controle com `status: complete` (ou `skipped` se for o caso do Screen Translator em legado sem UI). O orquestrador roda a pausa correspondente na tabela.
|
|
124
|
+
7. Se o usuário pedir ajustes em qualquer das duas fases, orquestrador re-ativa o agente apontando explicitamente qual fase deve ser refeita:
|
|
125
|
+
- Designer: `--regenerate-phase=topology` ou `--regenerate-phase=architecture`.
|
|
126
|
+
- Screen Translator: `--regenerate-phase=mode` ou `--regenerate-phase=generation`.
|
|
127
|
+
O agente respeita e descarta artefatos da fase em diante.
|
|
128
|
+
|
|
129
|
+
Esse mecanismo é genérico: novos agentes podem adotá-lo declarando seus checkpoints na seção "Detecção de fase ao iniciar" do próprio SKILL.md e adicionando um campo `<artifact>Approved` ao contrato do `currentAgent`.
|
|
130
|
+
|
|
131
|
+
| Após o agente | Pausa para |
|
|
132
|
+
|---|---|
|
|
133
|
+
| Paradigm Advisor | Confirmar paradigma e gap |
|
|
134
|
+
| Curator | Revisar itens DECISÃO HUMANA |
|
|
135
|
+
| Strategist | Escolher estratégia |
|
|
136
|
+
| Designer (Fase 1) | Aprovar `topology_decision.md` (preservar / modernizar / híbrido) antes de detalhar arquitetura |
|
|
137
|
+
| Designer (Fase 2) | Aprovar arquitetura (se ajustes, Designer roda novamente) |
|
|
138
|
+
| Screen Translator (Fase 1) | Aprovar `screen_modernization_decision.md` (literal / modernizado / híbrido). Em modo híbrido, listas explícitas de telas por modo são obrigatórias. Em legado sem UI, agente pula sem pausa. |
|
|
139
|
+
| Screen Translator (Fase 2) | Aprovar deviations pendentes em `screen_deviation_log.md` (se houver) antes de seguir ao Inspector |
|
|
140
|
+
| Inspector | (sem pausa; segue para handoff) |
|
|
141
|
+
|
|
142
|
+
### Passo 6: Pausa humana (`human_decision_gate`)
|
|
143
|
+
|
|
144
|
+
Em cada pausa:
|
|
145
|
+
|
|
146
|
+
1. Apresente um resumo claro do que o agente anterior produziu (3 a 8 linhas).
|
|
147
|
+
2. Liste explicitamente o que precisa de decisão.
|
|
148
|
+
3. Aguarde resposta do usuário.
|
|
149
|
+
|
|
150
|
+
Comportamento por engine:
|
|
151
|
+
|
|
152
|
+
- **Engines com chat interativo (Claude Code, Cursor, Codex, etc.)**: pergunte direto no chat e aguarde.
|
|
153
|
+
- **Engines sem TTY interativo**: escreva `_reversa_sdd/migration/pending_decisions.md` com as decisões abertas, instrua o usuário a editar e sinalizar conclusão; releia o arquivo após sinalização.
|
|
154
|
+
- **Modo `--auto`**: aplique os defaults documentados em `references/auto-defaults.md`. Marque cada decisão auto-aplicada em `ambiguity_log.md` para revisão posterior.
|
|
155
|
+
|
|
156
|
+
### Passo 7: Consolidar `ambiguity_log.md`
|
|
157
|
+
|
|
158
|
+
Após cada agente, integre itens ⚠️ e pendências em `_reversa_sdd/migration/ambiguity_log.md`. Ao final, organize em três grupos:
|
|
159
|
+
|
|
160
|
+
- PENDENTES (não pode haver após Inspector concluir)
|
|
161
|
+
- RESOLVIDOS COM DECISÃO HUMANA
|
|
162
|
+
- REFERIDOS À CODIFICAÇÃO
|
|
163
|
+
|
|
164
|
+
### Passo 8: Gerar `handoff.md`
|
|
165
|
+
|
|
166
|
+
Após Inspector concluir e `ambiguity_log` consolidado:
|
|
167
|
+
|
|
168
|
+
1. Renderize `_reversa_sdd/migration/handoff.md` usando o template em `references/templates/handoff.md`.
|
|
169
|
+
2. Liste todos os artefatos produzidos.
|
|
170
|
+
3. **Destaque `paradigm_decision.md` e `topology_decision.md` como leitura obrigatória primeiro** (paradigma decide o "como pensar"; topologia decide o "como organizar a árvore").
|
|
171
|
+
4. Liste itens REFERIDOS À CODIFICAÇÃO em seção dedicada.
|
|
172
|
+
5. Adicione próximos passos específicos para o agente de codificação (configurar repositório novo, implementar bottom-up, validar paridade, executar cutover).
|
|
173
|
+
6. Em modo `--auto`: liste itens auto-decididos para revisão posterior.
|
|
174
|
+
|
|
175
|
+
### Passo 9: Resumo final e logs
|
|
176
|
+
|
|
177
|
+
Apresente no chat:
|
|
178
|
+
|
|
179
|
+
> "Migração concluída.
|
|
180
|
+
> - Agentes executados: 6 (Screen Translator pode ter rodado em modo `skipped` se o legado não tem UI)
|
|
181
|
+
> - Artefatos criados: <N>
|
|
182
|
+
> - Itens em `ambiguity_log.md`: <N> pendentes (esperado 0), <N> resolvidos, <N> referidos à codificação
|
|
183
|
+
> - Tempo total: <minutos>
|
|
184
|
+
>
|
|
185
|
+
> Próximo passo: abra `_reversa_sdd/migration/handoff.md` no agente de codificação que vai implementar o sistema novo."
|
|
186
|
+
|
|
187
|
+
Grave log completo em `_reversa_sdd/migration/.logs/<timestamp>-migrate.log` com timestamp por entrada e identificação do agente. Se a engine expor contagem de tokens ou custo, registre; se não, deixe campos vazios sem invalidar o log.
|
|
188
|
+
|
|
189
|
+
## Modos especiais
|
|
190
|
+
|
|
191
|
+
### `--resume`
|
|
192
|
+
|
|
193
|
+
1. Leia `.state.json`.
|
|
194
|
+
2. Identifique `currentAgent.agent`, `currentAgent.phase` e `currentAgent.status`.
|
|
195
|
+
3. Se `currentAgent.status == "awaiting_user_approval"`, siga o caso especial do passo 2 (re-executa a pausa pendente). Caso contrário, confirme com o usuário antes de retomar.
|
|
196
|
+
4. Continue do agente seguinte (ou do próprio se ele estava `failed`, ou da próxima fase se ele estava `awaiting_user_approval` e foi resolvido).
|
|
197
|
+
|
|
198
|
+
### `--regenerate=<agent>`, `--regenerate=designer:<phase>` ou `--regenerate=screen_translator:<phase>`
|
|
199
|
+
|
|
200
|
+
1. Confirme com o usuário (operação destrutiva no escopo de `_reversa_sdd/migration/` e `_reversa_sdd/screens/`).
|
|
201
|
+
2. Faça backup em `_reversa_sdd/migration/.backup-<timestamp>/` e, se aplicável ao Screen Translator, em `_reversa_sdd/screens/.backup-<timestamp>/`.
|
|
202
|
+
3. Apague artefatos:
|
|
203
|
+
- `--regenerate=<agent>`: artefatos do agente especificado **e de todos os agentes posteriores** na ordem do pipeline. Para o Designer, inclui `topology_decision.md` e reseta `currentAgent.topologyApproved = false`. Para o Screen Translator, inclui `screen_modernization_decision.md`, `target_screens.md`, `screen_deviation_log.md`, `_reversa_sdd/screens/inventory.json` e `_reversa_sdd/screens/golden/`, e reseta `currentAgent.screenModeApproved = false`.
|
|
204
|
+
- `--regenerate=designer:topology`: apaga todos os artefatos do Designer (incluindo `topology_decision.md`) e reseta `topologyApproved`. Equivalente a `--regenerate=designer` mas explícito sobre voltar à Fase 1.
|
|
205
|
+
- `--regenerate=designer:architecture`: apaga apenas artefatos da Fase 2 do Designer (`target_architecture.md`, `target_domain_model.md`, `target_data_model.md`, `data_migration_plan.md`). Preserva `topology_decision.md` e `topologyApproved`.
|
|
206
|
+
- `--regenerate=screen_translator:mode`: apaga todos os artefatos do Screen Translator (incluindo `screen_modernization_decision.md`) e reseta `screenModeApproved`. Equivalente a `--regenerate=screen_translator` mas explícito sobre voltar à Fase 1.
|
|
207
|
+
- `--regenerate=screen_translator:generation`: apaga apenas artefatos da Fase 2 (`target_screens.md`, `screen_deviation_log.md`, `_reversa_sdd/screens/inventory.json`, `_reversa_sdd/screens/golden/`). Preserva `screen_modernization_decision.md` e `screenModeApproved`.
|
|
208
|
+
4. Atualize `.state.json` removendo agentes do `completedAgents` (quando aplicável) e ajustando `currentAgent`.
|
|
209
|
+
5. Re-ative o agente com a flag de fase, se aplicável.
|
|
210
|
+
|
|
211
|
+
### `--auto`
|
|
212
|
+
|
|
213
|
+
Aplica defaults sem pausas humanas. Ver `references/auto-defaults.md`.
|
|
214
|
+
|
|
215
|
+
Sempre exibir aviso explícito antes de iniciar listando todos os defaults aplicados.
|
|
216
|
+
|
|
217
|
+
## Casos de borda
|
|
218
|
+
|
|
219
|
+
- **`_reversa_sdd/` incompleto**: lista artefatos faltantes e aborta.
|
|
220
|
+
- **Brief presente mas mudanças no sistema legado**: ofereça revisar / recriar antes de prosseguir.
|
|
221
|
+
- **Modificação manual de artefato gerado** (hash em `.state.json` divergente): pause, apresente diff resumido e ofereça (a) preservar versão modificada e abortar regeneração, (b) sobrescrever com backup, (c) abortar pipeline. `--auto` adota (a) por default.
|
|
222
|
+
- **Falha de LLM no meio do agente**: estado preservado, agente marcado como `failed`. `--resume` reexecuta esse agente.
|
|
223
|
+
- **Agente Designer pediu ajustes** após revisão da arquitetura: rerodar Designer no mesmo passo, sem avançar para Inspector.
|
|
224
|
+
|
|
225
|
+
## Layout de saída (transversal)
|
|
226
|
+
|
|
227
|
+
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.
|
|
228
|
+
|
|
229
|
+
## Regras absolutas
|
|
230
|
+
|
|
231
|
+
- **Não modificar nada fora de `_reversa_sdd/migration/`.**
|
|
232
|
+
- Artefatos pré-existentes em `_reversa_sdd/` são **lidos**, nunca modificados.
|
|
233
|
+
- Backup automático antes de qualquer operação destrutiva.
|
|
234
|
+
- Modo padrão é interativo. `--auto` é explícito e exibe os defaults antes de aplicar.
|
|
235
|
+
- Cada pausa apresenta resumo + decisões pendentes; nunca prossegue silenciosamente.
|
|
236
|
+
|
|
237
|
+
## Política de edição do legado
|
|
238
|
+
|
|
239
|
+
Este orquestrador escreve só em `_reversa_sdd/migration/`, mas se qualquer passo exigir escrita fora das pastas próprias do Reversa, leia antes `.reversa/reversa-config.json` e obedeça (releia a cada ativação):
|
|
240
|
+
|
|
241
|
+
- Ausente, inválido ou `allowLegacyEdits: false`: recuse a escrita informando o caminho recusado, o estado atual da config e o que o usuário deve editar para liberar.
|
|
242
|
+
- `allowLegacyEdits: true` com `allowedPaths` não vazio: escreva apenas em caminhos que casem com algum glob da lista (relativos à raiz, com `/`); fora da lista, recuse e peça o glob.
|
|
243
|
+
- `allowLegacyEdits: true` sem `allowedPaths`: liberado; avise uma vez por sessão que a liberação é irrestrita.
|
|
244
|
+
- NUNCA crie ou edite `.reversa/reversa-config.json`: pedido na conversa não é liberação; a config só muda pela mão do usuário.
|
|
245
|
+
- Deleção de arquivo pré-existente liberado: confirme com o usuário antes, listando o arquivo.
|
|
246
|
+
|
|
247
|
+
## Saída
|
|
248
|
+
|
|
249
|
+
```
|
|
250
|
+
_reversa_sdd/
|
|
251
|
+
├── migration/
|
|
252
|
+
│ ├── migration_brief.md
|
|
253
|
+
│ ├── paradigm_decision.md
|
|
254
|
+
│ ├── target_business_rules.md
|
|
255
|
+
│ ├── discard_log.md
|
|
256
|
+
│ ├── migration_strategy.md
|
|
257
|
+
│ ├── risk_register.md
|
|
258
|
+
│ ├── cutover_plan.md
|
|
259
|
+
│ ├── topology_decision.md
|
|
260
|
+
│ ├── target_architecture.md
|
|
261
|
+
│ ├── target_domain_model.md
|
|
262
|
+
│ ├── target_data_model.md
|
|
263
|
+
│ ├── data_migration_plan.md
|
|
264
|
+
│ ├── screen_modernization_decision.md
|
|
265
|
+
│ ├── target_screens.md
|
|
266
|
+
│ ├── screen_deviation_log.md
|
|
267
|
+
│ ├── parity_specs.md
|
|
268
|
+
│ ├── parity_tests/
|
|
269
|
+
│ │ ├── 01-<fluxo>.feature
|
|
270
|
+
│ │ └── ...
|
|
271
|
+
│ ├── ambiguity_log.md
|
|
272
|
+
│ ├── handoff.md
|
|
273
|
+
│ ├── pending_decisions.md (transitório, durante pausas)
|
|
274
|
+
│ ├── .state.json
|
|
275
|
+
│ └── .logs/
|
|
276
|
+
│ └── <timestamp>-migrate.log
|
|
277
|
+
└── screens/
|
|
278
|
+
├── inventory.json
|
|
279
|
+
└── golden/
|
|
280
|
+
├── manifest.yaml
|
|
281
|
+
└── <tela>.<ext> (opcional, quando o oráculo executa)
|
|
282
|
+
```
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# Defaults de `--auto`
|
|
2
|
+
|
|
3
|
+
Quando o usuário invoca `/reversa-migrate --auto`, o orquestrador pula pausas humanas e aplica estes defaults. Antes de iniciar, o aviso ao usuário lista cada um deles. Cada item auto-aplicado é registrado em `ambiguity_log.md` com tag `auto-decidido` para revisão posterior.
|
|
4
|
+
|
|
5
|
+
## Paradigm Advisor
|
|
6
|
+
- Escolha **opção 1: adotar paradigma natural da stack alvo**.
|
|
7
|
+
- `derived_appetite` = `transformational`.
|
|
8
|
+
|
|
9
|
+
## Curator
|
|
10
|
+
- Itens DECISÃO HUMANA são marcados como pendentes em `ambiguity_log.md` e não bloqueiam o pipeline.
|
|
11
|
+
- Itens 🟡 INFERIDOS → MIGRAR (com nota "validar no agente de codificação").
|
|
12
|
+
- Itens 🔴 LACUNA e ⚠️ AMBÍGUOS → DESCARTAR com nota explícita "auto-descartado, requer revisão".
|
|
13
|
+
|
|
14
|
+
## Strategist
|
|
15
|
+
- Adota a estratégia marcada como **recomendada**.
|
|
16
|
+
- Riscos `crítico` que dependeriam de owner humano ficam com `owner = "a definir"` em `risk_register.md`.
|
|
17
|
+
|
|
18
|
+
## Designer
|
|
19
|
+
- **Topologia (Fase 1)**: aceita a topologia moderna proposta (opção 2). Justificativa registrada em `topology_decision.md` é a do próprio Designer; no `ambiguity_log.md` fica a tag `auto-decidido` para revisão posterior. Rationale: `--auto` é para usuários que querem o caminho recomendado; refusing-to-decide pararia o pipeline e violaria o contrato de `--auto`.
|
|
20
|
+
- **Arquitetura (Fase 2)**: aprova a primeira proposta sem iteração.
|
|
21
|
+
- Bounded contexts, eventos e ADRs são aceitos como propostos.
|
|
22
|
+
|
|
23
|
+
## Screen Translator
|
|
24
|
+
- **Modo (Fase 1)**: adota o modo recomendado pelo agente para o par origem→alvo detectado (literal para pares textuais; modernizado para mudanças de plataforma; híbrido só com lista explícita, portanto nunca em `--auto`).
|
|
25
|
+
- **Geração (Fase 2)**: aceita o `target_screens.md` gerado e propaga deviations como `pendente`. `--auto` não aprova deviations sozinho; elas ficam em `ambiguity_log.md` como `auto-decidido` para revisão posterior, sem bloquear o handoff (exceção a `--auto`: se uma deviation for `tipo=correcao` em modo literal, o agente recusa e pede aprovação humana mesmo em `--auto`, pois mudar texto sem aval rompe expectativa).
|
|
26
|
+
- **Captura de golden files**: não automatiza em `--auto` (driver de oráculo é OQ-02). Apenas emite `manifest.yaml` com comandos sugeridos.
|
|
27
|
+
- **Legado sem UI**: marca status `skipped` automaticamente, sem perguntar.
|
|
28
|
+
- **Pré-requisitos Discovery ausentes** (`_reversa_sdd/design-system/` ou `_reversa_sdd/ui/inventory.md`): cria `tokens-derived.md` mínimo e constrói inventário só a partir do código fonte; alerta no `ambiguity_log.md`.
|
|
29
|
+
|
|
30
|
+
## Inspector
|
|
31
|
+
- Usa critérios de paridade derivados diretamente do paradigma escolhido (ver `parity-coverage-matrix.md` no agente).
|
|
32
|
+
- Não negocia critério "paridade aceita" com o usuário.
|
|
33
|
+
|
|
34
|
+
## Modificações manuais detectadas
|
|
35
|
+
- Adota **opção (a)**: preservar a versão modificada manualmente e abortar regeneração desse artefato. Nunca destrói trabalho humano.
|
|
36
|
+
|
|
37
|
+
## Aviso obrigatório
|
|
38
|
+
|
|
39
|
+
Sempre antes de iniciar `--auto`, apresentar:
|
|
40
|
+
|
|
41
|
+
> "⚠️ Modo `--auto` ativado. Os defaults abaixo serão aplicados sem pausa para confirmação:
|
|
42
|
+
> - Paradigm Advisor: adotar paradigma natural da stack (transformacional).
|
|
43
|
+
> - Curator: itens ⚠️/🔴 serão DESCARTADOS com nota; 🟡 serão MIGRADOS com nota.
|
|
44
|
+
> - Strategist: estratégia recomendada será adotada.
|
|
45
|
+
> - Designer (topologia): topologia moderna proposta será adotada (opção 2).
|
|
46
|
+
> - Designer (arquitetura): primeira proposta de arquitetura será aceita.
|
|
47
|
+
> - Screen Translator (modo): adota o modo recomendado para o par origem→alvo. Modo híbrido nunca em `--auto`. Em legado sem UI, status `skipped`.
|
|
48
|
+
> - Screen Translator (geração): deviations ficam pendentes em `ambiguity_log.md` (não aprovadas). Captura de golden files não automatizada (apenas manifesto).
|
|
49
|
+
> - Inspector: critérios de paridade derivados do paradigma sem ajuste interativo.
|
|
50
|
+
>
|
|
51
|
+
> O `handoff.md` final destacará todos os itens auto-decididos para revisão posterior.
|
|
52
|
+
> Confirma? (s/N)"
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
# Cópia local da lista de artefatos esperados em _reversa_sdd/.
|
|
2
|
+
# Fonte canônica: templates/migration/expected_legacy_artifacts.yaml
|
|
3
|
+
# Esta cópia é instalada junto com o agente para acesso direto dentro do projeto do usuário.
|
|
4
|
+
|
|
5
|
+
schemaVersion: 1
|
|
6
|
+
artifacts:
|
|
7
|
+
- path: "code-analysis.md"
|
|
8
|
+
kind: code_analysis
|
|
9
|
+
required: true
|
|
10
|
+
minSchemaVersion: 1
|
|
11
|
+
- path: "domain.md"
|
|
12
|
+
kind: domain_model
|
|
13
|
+
required: true
|
|
14
|
+
minSchemaVersion: 1
|
|
15
|
+
- path: "architecture.md"
|
|
16
|
+
kind: architecture
|
|
17
|
+
required: true
|
|
18
|
+
minSchemaVersion: 1
|
|
19
|
+
- path: "dependencies.md"
|
|
20
|
+
kind: dependencies
|
|
21
|
+
required: true
|
|
22
|
+
minSchemaVersion: 1
|
|
23
|
+
- path: "inventory.md"
|
|
24
|
+
kind: legacy_inventory
|
|
25
|
+
required: true
|
|
26
|
+
minSchemaVersion: 1
|
|
27
|
+
- path: "data-dictionary.md"
|
|
28
|
+
kind: data_dictionary
|
|
29
|
+
required: false
|
|
30
|
+
minSchemaVersion: 1
|
|
31
|
+
- path: "state-machines.md"
|
|
32
|
+
kind: state_machines
|
|
33
|
+
required: false
|
|
34
|
+
minSchemaVersion: 1
|
|
35
|
+
- path: "permissions.md"
|
|
36
|
+
kind: permissions
|
|
37
|
+
required: false
|
|
38
|
+
minSchemaVersion: 1
|
|
39
|
+
- path: "gaps.md"
|
|
40
|
+
kind: gaps
|
|
41
|
+
required: true
|
|
42
|
+
minSchemaVersion: 1
|
|
43
|
+
- path: "questions.md"
|
|
44
|
+
kind: questions
|
|
45
|
+
required: false
|
|
46
|
+
minSchemaVersion: 1
|
|
47
|
+
- path: "confidence-report.md"
|
|
48
|
+
kind: confidence_report
|
|
49
|
+
required: true
|
|
50
|
+
minSchemaVersion: 1
|
|
51
|
+
- path: "traceability/code-spec-matrix.md"
|
|
52
|
+
kind: code_spec_matrix
|
|
53
|
+
required: false
|
|
54
|
+
minSchemaVersion: 1
|
|
55
|
+
- path: "sdd"
|
|
56
|
+
kind: sdd_dir
|
|
57
|
+
required: false
|
|
58
|
+
minSchemaVersion: 1
|
|
59
|
+
|
|
60
|
+
aliases:
|
|
61
|
+
"domain.md":
|
|
62
|
+
- "domain_model.md"
|
|
63
|
+
"architecture.md":
|
|
64
|
+
- "architecture_legacy.md"
|
|
65
|
+
"code-analysis.md":
|
|
66
|
+
- "code_analysis.md"
|
|
67
|
+
- "process_flows.md"
|
|
68
|
+
"inventory.md":
|
|
69
|
+
- "legacy_inventory.md"
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# Checklist do `handoff.md`
|
|
2
|
+
|
|
3
|
+
Antes de fechar o pipeline, o orquestrador valida que `handoff.md` cumpre todos os itens.
|
|
4
|
+
|
|
5
|
+
## Checklist obrigatório
|
|
6
|
+
|
|
7
|
+
- [ ] `paradigm_decision.md` aparece como **primeiro item** da seção "Leitura obrigatória" e da "Ordem de leitura recomendada".
|
|
8
|
+
- [ ] `topology_decision.md` aparece como **segundo item** da seção "Leitura obrigatória".
|
|
9
|
+
- [ ] `screen_modernization_decision.md` aparece como **terceiro item** quando há UI; em legado sem UI (Screen Translator skipped), a entrada é omitida com nota explícita "Screen Translator pulado, legado sem UI".
|
|
10
|
+
- [ ] Lista de artefatos produzidos é completa e reflete `_reversa_sdd/migration/` e `_reversa_sdd/screens/` reais.
|
|
11
|
+
- [ ] Deviations pendentes em `screen_deviation_log.md` aparecem como bloqueadores; deviations aprovadas estão refletidas em `parity_specs.md § Exceções`.
|
|
12
|
+
- [ ] Itens REFERIDOS À CODIFICAÇÃO de `ambiguity_log.md` aparecem em seção dedicada de `handoff.md`.
|
|
13
|
+
- [ ] Bloqueadores listados ou linha "nenhum bloqueador, prosseguir".
|
|
14
|
+
- [ ] Próximos passos para o agente de codificação são específicos e acionáveis (não genéricos).
|
|
15
|
+
- [ ] Em `--auto`: itens auto-decididos listados explicitamente.
|
|
16
|
+
- [ ] Estilo coerente com a engine instalada (formato adaptado, ex: front-matter compatível).
|
|
17
|
+
|
|
18
|
+
## Estrutura mínima
|
|
19
|
+
|
|
20
|
+
1. Banner de leitura obrigatória do `paradigm_decision.md`, `topology_decision.md` e (se houver UI) `screen_modernization_decision.md`.
|
|
21
|
+
2. Ordem de leitura recomendada.
|
|
22
|
+
3. Lista de artefatos.
|
|
23
|
+
4. Bloqueadores.
|
|
24
|
+
5. Próximos passos para o agente de codificação.
|
|
25
|
+
6. Itens auto-decididos (apenas se `--auto`).
|
|
26
|
+
7. Notas finais.
|
|
27
|
+
|
|
28
|
+
## Sinalização forte ao agente de codificação
|
|
29
|
+
|
|
30
|
+
A primeira frase de `handoff.md` deve transmitir clareza imediata. Padrão sugerido:
|
|
31
|
+
|
|
32
|
+
> "Sistema novo a ser construído em paradigma <X>, topologia <Y>, telas em modo <Z>. Antes de qualquer linha de código, leia `paradigm_decision.md`, `topology_decision.md` e `screen_modernization_decision.md`."
|
|
33
|
+
|
|
34
|
+
Em legado sem UI (Screen Translator skipped), substituir o trecho de telas por: "telas: nenhuma (sistema sem UI)".
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 2,
|
|
3
|
+
"startedAt": null,
|
|
4
|
+
"lastCheckpoint": null,
|
|
5
|
+
"completedAgents": [],
|
|
6
|
+
"pendingAgents": [
|
|
7
|
+
"paradigm_advisor",
|
|
8
|
+
"curator",
|
|
9
|
+
"strategist",
|
|
10
|
+
"designer",
|
|
11
|
+
"screen_translator",
|
|
12
|
+
"inspector"
|
|
13
|
+
],
|
|
14
|
+
"currentAgent": {
|
|
15
|
+
"agent": null,
|
|
16
|
+
"phase": null,
|
|
17
|
+
"status": null,
|
|
18
|
+
"topologyApproved": false,
|
|
19
|
+
"screenModeApproved": false
|
|
20
|
+
},
|
|
21
|
+
"pendingDecisions": [],
|
|
22
|
+
"artifacts": {},
|
|
23
|
+
"auto": false,
|
|
24
|
+
"engine": null,
|
|
25
|
+
"reversaVersion": "{{VERSION}}",
|
|
26
|
+
"briefPath": "_reversa_sdd/migration/migration_brief.md",
|
|
27
|
+
"expectedLegacyArtifacts": "references/expected_legacy_artifacts.yaml"
|
|
28
|
+
}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: ambiguity_log
|
|
7
|
+
producedBy: orchestrator
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Ambiguity Log
|
|
12
|
+
|
|
13
|
+
> Consolidação de todos os itens ⚠️ AMBÍGUOS ou pendentes detectados pelos agentes ao longo do pipeline.
|
|
14
|
+
> Status final esperado quando o pipeline conclui: nenhum item PENDENTE.
|
|
15
|
+
|
|
16
|
+
## Resumo
|
|
17
|
+
- Total de itens: <N>
|
|
18
|
+
- PENDENTES: <n>
|
|
19
|
+
- RESOLVIDOS COM DECISÃO HUMANA: <n>
|
|
20
|
+
- REFERIDOS À CODIFICAÇÃO: <n>
|
|
21
|
+
|
|
22
|
+
## Itens
|
|
23
|
+
|
|
24
|
+
### AMB-001
|
|
25
|
+
- **Descrição**: <texto>
|
|
26
|
+
- **Detectado por**: paradigm_advisor | curator | strategist | designer | screen_translator | inspector
|
|
27
|
+
- **Origem**: <referência ao artefato e seção>
|
|
28
|
+
- **Status**: PENDENTE | RESOLVIDO COM DECISÃO HUMANA | REFERIDO À CODIFICAÇÃO
|
|
29
|
+
- **Decisão tomada** (se houver):
|
|
30
|
+
- **Escolha**: <texto>
|
|
31
|
+
- **Decisor**: <nome>
|
|
32
|
+
- **Quando**: <ISO-8601>
|
|
33
|
+
- **Justificativa**: <texto>
|
|
34
|
+
|
|
35
|
+
<repetir por item>
|
|
36
|
+
|
|
37
|
+
## Itens referidos à codificação
|
|
38
|
+
> Lista somente itens com status `REFERIDO À CODIFICAÇÃO`. Aparecem destacados em `handoff.md`.
|
|
39
|
+
|
|
40
|
+
- AMB-XXX: <descrição curta>
|
|
41
|
+
|
|
42
|
+
## Notas
|
|
43
|
+
<Observações finais do orquestrador.>
|
|
@@ -0,0 +1,91 @@
|
|
|
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
|
+
2. **`topology_decision.md`**, leitura inegociável. A topologia escolhida (preservar / modernizar / híbrido) define a árvore de pastas e a fronteira entre módulos.
|
|
19
|
+
3. **`screen_modernization_decision.md`**, leitura inegociável quando o legado tem UI. O modo escolhido (literal / modernizado / híbrido) define como o codificador vai materializar as telas.
|
|
20
|
+
|
|
21
|
+
## Ordem de leitura recomendada
|
|
22
|
+
|
|
23
|
+
1. `paradigm_decision.md` (obrigatório, primeiro)
|
|
24
|
+
2. `topology_decision.md` (obrigatório, segundo)
|
|
25
|
+
3. `screen_modernization_decision.md` (obrigatório quando há UI; pular se Screen Translator rodou em modo skipped)
|
|
26
|
+
4. `migration_brief.md`
|
|
27
|
+
5. `target_business_rules.md`
|
|
28
|
+
6. `migration_strategy.md`
|
|
29
|
+
7. `target_architecture.md`
|
|
30
|
+
8. `target_domain_model.md`
|
|
31
|
+
9. `target_data_model.md`
|
|
32
|
+
10. `data_migration_plan.md`
|
|
33
|
+
11. `target_screens.md` (quando há UI)
|
|
34
|
+
12. `parity_specs.md` + `parity_tests/`
|
|
35
|
+
13. `screen_deviation_log.md` (consultivo, quando há UI)
|
|
36
|
+
14. `risk_register.md` + `cutover_plan.md`
|
|
37
|
+
15. `discard_log.md` (consultivo)
|
|
38
|
+
16. `ambiguity_log.md` (consultivo)
|
|
39
|
+
|
|
40
|
+
## Lista de artefatos produzidos
|
|
41
|
+
|
|
42
|
+
| Artefato | Produzido por | Status |
|
|
43
|
+
|---|---|---|
|
|
44
|
+
| migration_brief.md | orchestrator | criado |
|
|
45
|
+
| paradigm_decision.md | paradigm_advisor | criado |
|
|
46
|
+
| target_business_rules.md | curator | criado |
|
|
47
|
+
| discard_log.md | curator | criado |
|
|
48
|
+
| migration_strategy.md | strategist | criado |
|
|
49
|
+
| risk_register.md | strategist | criado |
|
|
50
|
+
| cutover_plan.md | strategist | criado |
|
|
51
|
+
| topology_decision.md | designer (Fase 1) | criado |
|
|
52
|
+
| target_architecture.md | designer | criado |
|
|
53
|
+
| target_domain_model.md | designer | criado |
|
|
54
|
+
| target_data_model.md | designer | criado |
|
|
55
|
+
| data_migration_plan.md | designer | criado |
|
|
56
|
+
| screen_modernization_decision.md | screen_translator (Fase 1) | criado / skipped |
|
|
57
|
+
| target_screens.md | screen_translator | criado / skipped |
|
|
58
|
+
| screen_deviation_log.md | screen_translator | criado / vazio |
|
|
59
|
+
| _reversa_sdd/screens/inventory.json | screen_translator | criado / vazio |
|
|
60
|
+
| _reversa_sdd/screens/golden/manifest.yaml | screen_translator | criado / opcional |
|
|
61
|
+
| parity_specs.md | inspector | criado |
|
|
62
|
+
| parity_tests/*.feature | inspector | <N> arquivos |
|
|
63
|
+
| ambiguity_log.md | orchestrator | consolidado |
|
|
64
|
+
|
|
65
|
+
## Bloqueadores para começar a implementação
|
|
66
|
+
> Itens que precisam de decisão humana antes do agente de codificação começar.
|
|
67
|
+
|
|
68
|
+
- <AMB-XXX: descrição curta + onde decidir>
|
|
69
|
+
- <ou: nenhum bloqueador, prosseguir>
|
|
70
|
+
|
|
71
|
+
## Próximos passos para o agente de codificação
|
|
72
|
+
|
|
73
|
+
1. **Ler `paradigm_decision.md` e internalizar**: o paradigma alvo é <do paradigm_decision>. Toda escolha de código deve honrar esse paradigma.
|
|
74
|
+
2. **Ler `topology_decision.md` e internalizar**: a topologia escolhida é <preservar | modernizar | híbrido>. Use o esboço da árvore registrado nesse artefato como base para criar a estrutura de pastas do novo repositório.
|
|
75
|
+
3. **Ler `screen_modernization_decision.md` e internalizar** (quando há UI): o modo de tradução de telas é <literal | modernizado | híbrido>. Em literal, materialize byte-a-byte (ou pixel-equivalente) o que está em `target_screens.md`; em modernizado, honre a hierarquia de componentes, tokens e os 4 estados (idle, loading, error, success).
|
|
76
|
+
4. **Configurar o repositório novo** com a stack declarada em `migration_brief.md` e a topologia decidida.
|
|
77
|
+
5. **Implementar bottom-up** seguindo `target_architecture.md` e `target_domain_model.md`:
|
|
78
|
+
- infraestrutura → dados → domínio → aplicação → bordas.
|
|
79
|
+
6. **Implementar as telas** consumindo `target_screens.md` como contrato literal. Em modo literal com golden files presentes em `_reversa_sdd/screens/golden/`, o resultado da implementação deve casar com o golden file dentro das `normalizationRules` declaradas no `manifest.yaml`.
|
|
80
|
+
7. **Escrever os testes** a partir de `parity_specs.md` e `parity_tests/*.feature` desde o início. Honrar a seção § Exceções, que reflete deviations aprovadas em `screen_deviation_log.md`.
|
|
81
|
+
8. **Para cada componente**, validar que respeita o paradigma escolhido (sinais explícitos em `target_architecture.md § Honra ao paradigma escolhido`) e a topologia escolhida (sinais explícitos em `target_architecture.md § Honra à topologia escolhida`).
|
|
82
|
+
9. **Para a migração de dados**, seguir `data_migration_plan.md`.
|
|
83
|
+
10. **Para o cutover**, seguir `cutover_plan.md` e os critérios go/no-go.
|
|
84
|
+
|
|
85
|
+
## Itens auto-decididos (apenas se executado em --auto)
|
|
86
|
+
> Listar aqui itens cujo default foi aplicado sem confirmação humana. Recomenda-se revisar antes do cutover.
|
|
87
|
+
|
|
88
|
+
- <ou: pipeline executado em modo interativo, nenhum item auto-decidido>
|
|
89
|
+
|
|
90
|
+
## Notas finais
|
|
91
|
+
<Observações do orquestrador para o agente de codificação.>
|