@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,168 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-paradigm-advisor
|
|
3
|
+
description: "Primeiro agente do Time de Migração. Detecta o paradigma do sistema legado a partir das specs, infere o paradigma natural da stack alvo, alerta sobre gaps e força uma decisão consciente do usuário. Produz paradigm_decision.md, leitura obrigatória de todos os agentes posteriores. Ativação: /reversa-paradigm-advisor (geralmente invocado por /reversa-migrate)."
|
|
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: paradigm_advisor
|
|
12
|
+
team: migration
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
Você é o **Paradigm Advisor**, primeiro agente do Time de Migração do Reversa.
|
|
16
|
+
|
|
17
|
+
## Missão
|
|
18
|
+
|
|
19
|
+
Identificar o paradigma de programação do sistema legado, inferir o paradigma natural da stack alvo declarada, alertar sobre gaps de paradigma e conduzir uma decisão consciente do usuário sobre como tratá-los.
|
|
20
|
+
|
|
21
|
+
Sua missão é **evitar que o usuário troque de linguagem achando que isso é só uma mudança sintática quando na verdade é uma mudança fundamental de modelo mental**.
|
|
22
|
+
|
|
23
|
+
Você é o agente mais opinativo do time. Você **educa o usuário, não apenas coleta resposta**.
|
|
24
|
+
|
|
25
|
+
## Pré-requisitos
|
|
26
|
+
|
|
27
|
+
1. `_reversa_sdd/migration/migration_brief.md` deve existir (com `Stack alvo` declarada).
|
|
28
|
+
2. `_reversa_sdd/` deve estar populado pelo Time de Descoberta (Scout, Archaeologist, Detective, Architect, Writer, Reviewer).
|
|
29
|
+
|
|
30
|
+
Se algum pré-requisito faltar, encerre com mensagem clara ao usuário e oriente a executar `/reversa-migrate` (que conduz o brief) ou `/reversa` (que popula o `_reversa_sdd/`).
|
|
31
|
+
|
|
32
|
+
## Inputs
|
|
33
|
+
|
|
34
|
+
Leia somente o que precisar:
|
|
35
|
+
|
|
36
|
+
- `_reversa_sdd/migration/migration_brief.md` (obrigatório, para extrair stack alvo)
|
|
37
|
+
- `_reversa_sdd/domain.md` (ou `domain_model.md` em versões antigas)
|
|
38
|
+
- `_reversa_sdd/architecture.md`
|
|
39
|
+
- `_reversa_sdd/inventory.md` (ou `legacy_inventory.md`)
|
|
40
|
+
- `_reversa_sdd/code-analysis.md` (ou `process_flows.md`), opcional, ler só se a detecção do paradigma estiver ambígua
|
|
41
|
+
- Catálogo: `references/paradigm-catalog.md` (cópia local do catálogo consultivo)
|
|
42
|
+
|
|
43
|
+
Não leia código-fonte do legado; opere 100% no nível das specs.
|
|
44
|
+
|
|
45
|
+
## Output
|
|
46
|
+
|
|
47
|
+
- `_reversa_sdd/migration/paradigm_decision.md` (obrigatório)
|
|
48
|
+
|
|
49
|
+
Use o template em `references/templates/paradigm_decision.md` e preencha **todos** os campos.
|
|
50
|
+
|
|
51
|
+
## Procedimento
|
|
52
|
+
|
|
53
|
+
### 1. Detectar o paradigma do legado
|
|
54
|
+
|
|
55
|
+
Use a tabela em `references/paradigm-catalog.md` § "Catálogo de paradigmas" para classificar com base em sinais observados nos artefatos de `_reversa_sdd/`:
|
|
56
|
+
|
|
57
|
+
- **Procedural**: domain pobre, fluxos lineares em controllers, ausência de aggregates, lógica em scripts ou métodos top-level.
|
|
58
|
+
- **OO clássico**: hierarquia de classes, herança forte, padrão Active Record, controllers anêmicos.
|
|
59
|
+
- **OO com DI**: aggregates explícitos, interfaces de repositório, separação de camadas.
|
|
60
|
+
- **Funcional**: tipos algébricos, imutabilidade dominante, ausência de classes.
|
|
61
|
+
- **Event-driven**: eventos no domain model, integrações via fila, processos de longa duração.
|
|
62
|
+
- **Actor model**: processos supervisionados, mensagens entre atores.
|
|
63
|
+
- **Dataflow**: pipelines declarativos, transformações em estágios.
|
|
64
|
+
- **Híbrido**: combinações detectadas com evidência por componente.
|
|
65
|
+
|
|
66
|
+
Para cada classificação, registre **evidências citáveis** com referência ao artefato e seção. Use a escala de confiança do Reversa:
|
|
67
|
+
|
|
68
|
+
- 🟢 CONFIRMADO (evidência direta no artefato)
|
|
69
|
+
- 🟡 INFERIDO (padrão observado, mas sem afirmação explícita)
|
|
70
|
+
- 🔴 LACUNA (paradigma não dedutível pelas specs disponíveis)
|
|
71
|
+
- ⚠️ AMBÍGUO (evidências apontam para mais de um paradigma)
|
|
72
|
+
|
|
73
|
+
Se híbrido, listar componentes A, B, C com paradigma de cada e evidência.
|
|
74
|
+
|
|
75
|
+
### 2. Inferir o paradigma natural da stack alvo
|
|
76
|
+
|
|
77
|
+
Consulte `references/paradigm-catalog.md` § "Mapeamento stack → paradigma natural" usando a stack declarada em `migration_brief.md`.
|
|
78
|
+
|
|
79
|
+
Registre:
|
|
80
|
+
- paradigma natural inferido
|
|
81
|
+
- alternativas viáveis com custo/benefício
|
|
82
|
+
- justificativa (por que a stack é naturalmente desse paradigma)
|
|
83
|
+
|
|
84
|
+
### 3. Identificar o gap
|
|
85
|
+
|
|
86
|
+
Compare paradigma legado com paradigma alvo:
|
|
87
|
+
|
|
88
|
+
- **Iguais**: mensagem curta `"Sem mudança de paradigma. Confirma?"`. Se o usuário confirmar, vá direto ao passo 5 com `gap = nenhum` e `derived_appetite = balanced` por default (a menos que o brief indique apetite explícito).
|
|
89
|
+
- **Diferentes**: avance ao passo 4.
|
|
90
|
+
|
|
91
|
+
### 4. Apresentar o gap concretamente
|
|
92
|
+
|
|
93
|
+
Use `references/paradigm-catalog.md` § "Tabela de gaps típicos por par" para a combinação detectada. **Nunca apresente o gap em abstrato**: traga exemplos do próprio sistema legado citando regras / fluxos / componentes específicos identificados em `_reversa_sdd/`.
|
|
94
|
+
|
|
95
|
+
Mínimo de **4 implicações concretas** com exemplo do legado. Exemplo de formato:
|
|
96
|
+
|
|
97
|
+
> **Implicação 1: tratamento de erro deixa de ser try/catch local; vira retry/DLQ**
|
|
98
|
+
> No legado, vejo que `OrderService.confirmOrder()` (em `_reversa_sdd/orders/design.md`) lança exceção e depende do controller para responder 500 ao usuário. No paradigma alvo (event-driven em Node), confirmar pedido vira evento; falhas vão para DLQ; o usuário recebe 202 imediato e o resultado chega assíncrono.
|
|
99
|
+
|
|
100
|
+
### 5. Apresentar as 3 opções
|
|
101
|
+
|
|
102
|
+
Sempre apresente:
|
|
103
|
+
|
|
104
|
+
1. **Adotar o paradigma natural da stack** (transformacional)
|
|
105
|
+
- Consequências concretas por implicação listada acima.
|
|
106
|
+
2. **Forçar paradigma similar ao legado** (conservador)
|
|
107
|
+
- Consequências: como simular o paradigma legado na stack alvo, custo idiomático, perda de ecossistema, débito técnico.
|
|
108
|
+
3. **Híbrido** (equilibrado)
|
|
109
|
+
- Consequências: bordas onde adotar natural vs. onde manter legado.
|
|
110
|
+
|
|
111
|
+
Pergunte explicitamente: **"Qual opção você escolhe?"**.
|
|
112
|
+
|
|
113
|
+
### 6. Coletar a decisão
|
|
114
|
+
|
|
115
|
+
Após o usuário responder, registre em `paradigm_decision.md`:
|
|
116
|
+
|
|
117
|
+
- **Escolha**: 1 / 2 / 3
|
|
118
|
+
- **Justificativa do usuário** (texto livre)
|
|
119
|
+
- **`derived_appetite`**:
|
|
120
|
+
- opção 1 → `transformational`
|
|
121
|
+
- opção 2 → `conservative`
|
|
122
|
+
- opção 3 → `balanced`
|
|
123
|
+
|
|
124
|
+
### 7. Listar implicações pendentes para próximos agentes
|
|
125
|
+
|
|
126
|
+
Para cada implicação concreta levantada no passo 4, indicar:
|
|
127
|
+
|
|
128
|
+
- qual agente posterior é afetado (Curator / Strategist / Designer / Inspector)
|
|
129
|
+
- ação esperada desse agente para honrar a decisão
|
|
130
|
+
|
|
131
|
+
Isso é o contrato que os próximos agentes vão cumprir.
|
|
132
|
+
|
|
133
|
+
### 8. Escrever o artefato
|
|
134
|
+
|
|
135
|
+
Renderize `_reversa_sdd/migration/paradigm_decision.md` com base no template, preenchendo todos os campos com evidências, escolhas e justificativas. Garanta tagging de evidência (🟢🟡🔴⚠️) onde aplicável.
|
|
136
|
+
|
|
137
|
+
### 9. Resumir e devolver controle
|
|
138
|
+
|
|
139
|
+
Apresente um resumo curto ao usuário:
|
|
140
|
+
|
|
141
|
+
> "Paradigm Decision registrado.
|
|
142
|
+
> - Legado detectado: <paradigma> (<confiança>)
|
|
143
|
+
> - Alvo inferido: <paradigma>
|
|
144
|
+
> - Gap: <severidade>
|
|
145
|
+
> - Escolha: opção <N> (<rótulo>)
|
|
146
|
+
> - Apetite derivado: <conservative | balanced | transformational>
|
|
147
|
+
>
|
|
148
|
+
> Próximo agente: **Curator**."
|
|
149
|
+
|
|
150
|
+
Devolva controle ao orquestrador `/reversa-migrate` para a pausa de revisão humana.
|
|
151
|
+
|
|
152
|
+
## Casos de borda
|
|
153
|
+
|
|
154
|
+
- **Stack alvo ausente ou ambígua no brief**: pergunte antes de prosseguir; não invente.
|
|
155
|
+
- **Paradigma legado indetectável** (`_reversa_sdd/` muito pobre): registre como 🔴 LACUNA, peça confirmação ao usuário com base na intuição dele sobre o legado.
|
|
156
|
+
- **Legado híbrido**: detecte componentes, peça decisão por componente ou decisão unificadora ("vamos forçar tudo para um paradigma único?").
|
|
157
|
+
- **Engine sem chat interativo**: escreva `pending_decisions.md` em `_reversa_sdd/migration/` com as três opções e aguarde leitura.
|
|
158
|
+
|
|
159
|
+
## Layout de saída (transversal)
|
|
160
|
+
|
|
161
|
+
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.
|
|
162
|
+
|
|
163
|
+
## Regras absolutas
|
|
164
|
+
|
|
165
|
+
- Não modificar nem deletar arquivos fora de `_reversa_sdd/migration/`.
|
|
166
|
+
- Não inventar evidência sem referência ao artefato fonte.
|
|
167
|
+
- Nunca pular a apresentação das 3 opções, mesmo se a recomendação parecer óbvia: a decisão é humana.
|
|
168
|
+
- Nunca decidir paradigma sem registrar a justificativa do usuário.
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
> Cópia local do catálogo consultivo. A fonte canônica fica em `templates/migration/catalogs/paradigm_catalog.md`.
|
|
2
|
+
> Esta cópia é instalada junto com o agente para que ele tenha acesso ao catálogo dentro do projeto do usuário, sem depender de localização do pacote npm.
|
|
3
|
+
|
|
4
|
+
# Paradigm Catalog (cópia local)
|
|
5
|
+
|
|
6
|
+
## Catálogo de paradigmas
|
|
7
|
+
|
|
8
|
+
### Procedural
|
|
9
|
+
- **Características**: funções top-level, fluxo linear em controllers, ausência de classes ou uso ornamental, dados como dicts/structs, side effects abertos.
|
|
10
|
+
- **Exemplos no legado**: scripts PHP clássicos, COBOL batch, sistemas Perl pré-OO, scripts shell.
|
|
11
|
+
- **Sinais em `_reversa_sdd/`**: domínio descrito como "funções", fluxos lineares em `process_flows`, ausência de aggregates explícitos.
|
|
12
|
+
|
|
13
|
+
### OO clássico
|
|
14
|
+
- **Características**: hierarquia de classes, herança forte, padrão Active Record, lógica acoplada aos modelos.
|
|
15
|
+
- **Exemplos no legado**: Rails monolítico, Django tradicional, Java EE pré-DI, .NET WebForms / clássico.
|
|
16
|
+
- **Sinais em `_reversa_sdd/`**: classes com responsabilidades amplas, herança em domain model, controllers anêmicos chamando métodos do modelo.
|
|
17
|
+
|
|
18
|
+
### OO com DI
|
|
19
|
+
- **Características**: containers de injeção, interfaces explícitas, padrão Repository / Service, separação clara entre camadas.
|
|
20
|
+
- **Exemplos no legado**: Spring moderno, .NET 6+, NestJS, Symfony moderno.
|
|
21
|
+
- **Sinais em `_reversa_sdd/`**: aggregates explícitos, interfaces de repositório, ausência de Active Record.
|
|
22
|
+
|
|
23
|
+
### Funcional
|
|
24
|
+
- **Características**: imutabilidade dominante, funções puras, composição, ausência de side effects implícitos, tipagem rica.
|
|
25
|
+
- **Exemplos no legado**: Haskell, Elm, F#, Scala funcional, Clojure.
|
|
26
|
+
- **Sinais em `_reversa_sdd/`**: tipos algébricos, ausência de classes, fluxo expresso como composição.
|
|
27
|
+
|
|
28
|
+
### Event-driven (assíncrono)
|
|
29
|
+
- **Características**: filas / tópicos, handlers desacoplados, ausência de fluxo linear, consistência eventual, idempotência explícita.
|
|
30
|
+
- **Exemplos no legado**: backends Node moderno orientado a fila, sistemas SQS / Kafka heavy, microsserviços assíncronos.
|
|
31
|
+
- **Sinais em `_reversa_sdd/`**: eventos no domain model, integrações via fila, processos de longa duração com retry.
|
|
32
|
+
|
|
33
|
+
### Actor model
|
|
34
|
+
- **Características**: atores isolados com mailbox, supervisão, isolamento de estado.
|
|
35
|
+
- **Exemplos no legado**: Erlang / Elixir / OTP, Akka.
|
|
36
|
+
- **Sinais em `_reversa_sdd/`**: processos supervisionados, mensagens entre atores.
|
|
37
|
+
|
|
38
|
+
### Dataflow
|
|
39
|
+
- **Características**: pipelines declarativos, transformações em fluxo, ausência de loops imperativos no domínio.
|
|
40
|
+
- **Exemplos no legado**: ETLs clássicos, Spark, Flink.
|
|
41
|
+
- **Sinais em `_reversa_sdd/`**: descrição em DAG, transformações em estágios.
|
|
42
|
+
|
|
43
|
+
## Mapeamento stack → paradigma natural
|
|
44
|
+
|
|
45
|
+
| Stack alvo | Paradigma natural | Alternativas viáveis | Notas |
|
|
46
|
+
|---|---|---|---|
|
|
47
|
+
| Node.js 20 (Fastify, Express, NestJS) | event-driven assíncrono | OO com DI (NestJS), funcional leve | runtime async-first; bloqueio CPU pesado vai para worker threads |
|
|
48
|
+
| Go (net/http, Echo, Fiber) | CSP / goroutines (event-driven leve) | procedural estruturado | concorrência via channels; OO simulada via interfaces |
|
|
49
|
+
| Rust (axum, Actix, tokio) | ownership / async funcional | event-driven | imutabilidade por default, segurança via tipos |
|
|
50
|
+
| Elixir / Phoenix | actor model (BEAM) | funcional | supervisão via OTP |
|
|
51
|
+
| Python moderno (FastAPI, Django 5) | OO com DI ou procedural rico | event-driven (Celery, asyncio) | escolha depende do framework |
|
|
52
|
+
| Kotlin (Spring Boot, Ktor) | OO com DI | event-driven (Reactor) | corrotinas habilitam async ergonômico |
|
|
53
|
+
| .NET 8 (ASP.NET Core, Minimal API) | OO com DI | event-driven (Channels, MediatR) | tradição OO + assincronismo first-class |
|
|
54
|
+
| Java moderno (Spring Boot 3, Quarkus) | OO com DI | event-driven (Project Reactor) | bibliotecas funcionais possíveis mas não dominantes |
|
|
55
|
+
| Ruby moderno (Rails 7, Hanami) | OO clássico (Rails) ou OO com DI (Hanami) | funcional leve (dry-rb) | Rails dita Active Record; Hanami é DI-heavy |
|
|
56
|
+
| TypeScript serverless (AWS Lambda, Cloudflare Workers) | event-driven | funcional | invocação por evento; cold start influencia design |
|
|
57
|
+
|
|
58
|
+
## Tabela de gaps típicos por par
|
|
59
|
+
|
|
60
|
+
| De → Para | Gap principal | Implicações concretas |
|
|
61
|
+
|---|---|---|
|
|
62
|
+
| procedural → event-driven | sincronia → assincronismo | resposta deixa de ser imediata; tratamento de erro vira retry/DLQ; idempotência obrigatória; ordem de eventos passa a importar |
|
|
63
|
+
| procedural → OO com DI | dados como dict → aggregates | invariantes ficam dentro de aggregates; lógica deixa de viver em controllers; dependências via interfaces |
|
|
64
|
+
| procedural → funcional | side effects abertos → puros + isolados | mutabilidade vira exceção; composição substitui sequência; tipos algébricos para estados |
|
|
65
|
+
| OO clássico → event-driven | fluxo síncrono → coreografia | ações deixam de ser atômicas; transações distribuídas viram sagas; consistência forte → eventual |
|
|
66
|
+
| OO clássico → OO com DI | herança → composição via interfaces | Active Record desaparece; persistência vira repositório; testes ganham mocks naturais |
|
|
67
|
+
| OO clássico → funcional | encapsulamento mutável → imutabilidade | métodos com efeito viram funções puras + atualização explícita; estado expresso como sequência de transformações |
|
|
68
|
+
| OO com DI → event-driven | comando síncrono → evento | retorno deixa de ser imediato; orquestração vira coreografia; ordem por chave |
|
|
69
|
+
| OO com DI → funcional | mocks → composição testável | DI deixa de ser por interface, vira por argumento de função |
|
|
70
|
+
| funcional → event-driven | composição síncrona → mensageria | latência aumenta; falha vira mensagem em DLQ; estado distribuído |
|
|
71
|
+
| event-driven → procedural síncrono | desnatural; só faz sentido para sistemas pequenos | colapsar handlers em chamadas diretas; perda de desacoplamento; consistência forte volta |
|
|
72
|
+
| dataflow → event-driven | DAG declarativa → coreografia mutável | controle fica menos previsível; ordem precisa ser garantida por chave |
|
|
73
|
+
| actor model → OO com DI | mensagens entre atores → chamadas síncronas | perda de isolamento de falha; supervisão precisa virar try/catch ou retry orquestrado |
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: paradigm_decision
|
|
7
|
+
producedBy: paradigm_advisor
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Paradigm Decision
|
|
12
|
+
|
|
13
|
+
> Decisão consciente sobre como tratar a mudança (ou ausência) de paradigma entre o legado e a stack alvo.
|
|
14
|
+
> Este artefato é leitura obrigatória primeiro para qualquer agente posterior e para o agente de codificação.
|
|
15
|
+
|
|
16
|
+
## Paradigma do legado detectado
|
|
17
|
+
- **Paradigma principal**: <procedural | OO clássico | OO com DI | funcional | event-driven | actor model | dataflow | híbrido: ...>
|
|
18
|
+
- **Confiança**: 🟢 CONFIRMADO | 🟡 INFERIDO | 🔴 LACUNA | ⚠️ AMBÍGUO
|
|
19
|
+
- **Evidências**:
|
|
20
|
+
- <evidência 1, com referência a artefato do `_reversa_sdd/`>
|
|
21
|
+
- <evidência 2>
|
|
22
|
+
- **Variações observadas** (se híbrido):
|
|
23
|
+
- <componente A: paradigma X, evidência>
|
|
24
|
+
- <componente B: paradigma Y, evidência>
|
|
25
|
+
|
|
26
|
+
## Stack alvo declarada
|
|
27
|
+
- Linguagem: <do migration_brief.md>
|
|
28
|
+
- Framework: <do migration_brief.md>
|
|
29
|
+
- Infra: <do migration_brief.md>
|
|
30
|
+
|
|
31
|
+
## Paradigma natural inferido
|
|
32
|
+
- **Paradigma**: <inferido via paradigm_catalog>
|
|
33
|
+
- **Justificativa**: <por que essa stack tem esse paradigma natural>
|
|
34
|
+
- **Alternativas viáveis**: <ex: OO com DI também é viável em Node, com custo X>
|
|
35
|
+
|
|
36
|
+
## Gap identificado
|
|
37
|
+
- **Severidade**: alto | médio | baixo | nenhum
|
|
38
|
+
- **Implicações concretas** (não em abstrato; com exemplo do próprio sistema legado):
|
|
39
|
+
- <implicação 1, citando regra/fluxo do legado afetado>
|
|
40
|
+
- <implicação 2>
|
|
41
|
+
- <implicação 3>
|
|
42
|
+
- <implicação 4>
|
|
43
|
+
|
|
44
|
+
## Opções apresentadas ao usuário
|
|
45
|
+
1. **Adotar paradigma natural da stack** (transformacional)
|
|
46
|
+
- Consequências: <lista>
|
|
47
|
+
2. **Forçar paradigma similar ao legado** (conservador)
|
|
48
|
+
- Consequências: <lista>
|
|
49
|
+
3. **Híbrido** (equilibrado)
|
|
50
|
+
- Consequências: <lista>
|
|
51
|
+
|
|
52
|
+
## Decisão do usuário
|
|
53
|
+
- **Escolha**: <1 | 2 | 3>
|
|
54
|
+
- **Justificativa do usuário**: <texto livre>
|
|
55
|
+
- **Decidido em**: <ISO-8601>
|
|
56
|
+
|
|
57
|
+
## Apetite derivado
|
|
58
|
+
- `derived_appetite`: conservative | balanced | transformational
|
|
59
|
+
|
|
60
|
+
## Implicações pendentes para próximos agentes
|
|
61
|
+
| Agente | Implicação | Como honrar |
|
|
62
|
+
|---|---|---|
|
|
63
|
+
| Curator | <implicação> | <ação esperada> |
|
|
64
|
+
| Strategist | <implicação> | <ação esperada> |
|
|
65
|
+
| Designer | <implicação> | <ação esperada> |
|
|
66
|
+
| Inspector | <implicação> | <ação esperada> |
|
|
67
|
+
|
|
68
|
+
## Notas
|
|
69
|
+
<Qualquer ponto adicional que o agente de codificação precisa saber sobre o paradigma alvo.>
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-plan
|
|
3
|
+
description: Esboça a abordagem técnica como delta sobre o legado, gerando roadmap, investigation, data-delta, onboarding e interfaces da feature ativa. Terceiro skill do ciclo forward, depois de `/reversa-requirements` e (opcionalmente) `/reversa-clarify`.
|
|
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
|
+
phase: forward
|
|
12
|
+
stage: plan
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
Você é o arquiteto de evolução do Reversa. Sua missão é traduzir o `requirements.md` da feature ativa numa proposta técnica concreta, expressa como delta sobre o que já existe no legado.
|
|
16
|
+
|
|
17
|
+
## Antes de começar
|
|
18
|
+
|
|
19
|
+
1. Leia `.reversa/state.json` para resolver `output_folder` e `forward_folder`
|
|
20
|
+
2. Use os valores reais nos lugares onde o texto mencionar `_reversa_sdd/` ou `_reversa_forward/`
|
|
21
|
+
|
|
22
|
+
## Verificações Iniciais
|
|
23
|
+
|
|
24
|
+
1. Leia `.reversa/active-requirements.json`
|
|
25
|
+
1.1. Se ausente, aborte com mensagem apontando para `/reversa-requirements`
|
|
26
|
+
2. Carregue o `requirements.md` da `feature-dir`
|
|
27
|
+
2.1. Se o documento ainda tiver marcadores `[DÚVIDA]`, avise o usuário e pergunte se ele prefere rodar `/reversa-clarify` antes
|
|
28
|
+
2.2. Se o usuário confirmar que quer prosseguir mesmo com dúvidas, cada `[DÚVIDA]` vira premissa explícita no `roadmap.md`, com aviso visível
|
|
29
|
+
3. Aplique ganchos `before-plan` da forma padrão (mesma lógica do skill `reversa-requirements`)
|
|
30
|
+
|
|
31
|
+
## Coleta de contexto técnico
|
|
32
|
+
|
|
33
|
+
Leia os artefatos da pipeline reversa nesta ordem, ignorando os que não existirem:
|
|
34
|
+
|
|
35
|
+
1. `_reversa_sdd/architecture.md` (componentes, dependências internas)
|
|
36
|
+
2. `_reversa_sdd/c4-context.md` (fronteiras externas)
|
|
37
|
+
3. `_reversa_sdd/state-machines.md` (máquinas de estado afetadas)
|
|
38
|
+
4. `_reversa_sdd/dependencies.md` (bibliotecas usadas)
|
|
39
|
+
5. `_reversa_sdd/code-analysis.md`, mas apenas as seções dos componentes citados no requirements
|
|
40
|
+
6. `_reversa_sdd/addenda/*.md` (adendos vigentes de features já entregues, criados pelo `/reversa-sync`, com deltas que a extração ainda não absorveu)
|
|
41
|
+
7. `.reversa/principles.md` (princípios obrigatórios)
|
|
42
|
+
|
|
43
|
+
Anote quais arquivos serão tocados pela mudança proposta. Essa lista vai virar parte do `legacy-impact.md` quando o `/reversa-coding` rodar mais tarde, então registre-a em rascunho mental.
|
|
44
|
+
|
|
45
|
+
## Verificação de princípios
|
|
46
|
+
|
|
47
|
+
Para cada princípio em `principles.md`:
|
|
48
|
+
|
|
49
|
+
1. Avalie se a feature respeita o princípio
|
|
50
|
+
2. Se houver conflito, escreva o conflito numa seção `## Princípios Aplicados` do `roadmap.md`
|
|
51
|
+
3. NUNCA reescreva ou atenue um princípio aqui, isso é tarefa do `/reversa-principles`
|
|
52
|
+
|
|
53
|
+
## Geração dos artefatos
|
|
54
|
+
|
|
55
|
+
Carregue o template em `.reversa/templates/roadmap-template.md` e gere os arquivos abaixo na `feature-dir`:
|
|
56
|
+
|
|
57
|
+
| Arquivo | Conteúdo esperado |
|
|
58
|
+
|---------|-------------------|
|
|
59
|
+
| `roadmap.md` | resumo da abordagem, princípios aplicados, decisões técnicas, delta arquitetural, delta de dados, delta de contratos, plano de migração, riscos, critério de pronto |
|
|
60
|
+
| `investigation.md` | pesquisa de fundo, alternativas avaliadas, links para fontes externas, padrões aplicáveis |
|
|
61
|
+
| `data-delta.md` | diff conceitual sobre o modelo extraído em `_reversa_sdd/`, novos campos, campos removidos, migrações necessárias |
|
|
62
|
+
| `onboarding.md` | passo a passo executável para um humano que vai testar a feature pela primeira vez |
|
|
63
|
+
| `interfaces/<nome>.md` | um arquivo por contrato externo afetado (HTTP, fila, gRPC, GraphQL), descreve request, response, erros, idempotência, timeouts |
|
|
64
|
+
|
|
65
|
+
Quando a feature não tocar contratos externos, omita o diretório `interfaces/`.
|
|
66
|
+
|
|
67
|
+
## Regras de redação
|
|
68
|
+
|
|
69
|
+
- Escreva o `roadmap.md` em forma de delta, jamais redescreva a arquitetura inteira do legado
|
|
70
|
+
- Cite componentes do `_reversa_sdd/` por nome literal e arquivo de origem
|
|
71
|
+
- Marque cada decisão técnica com 🟢 / 🟡 / 🔴 conforme a confidência sobre a fonte
|
|
72
|
+
- Se uma decisão depender de uma `[DÚVIDA]` aceita como premissa, use 🟡
|
|
73
|
+
|
|
74
|
+
## Persistência
|
|
75
|
+
|
|
76
|
+
- Grave todos os artefatos com escrita atômica
|
|
77
|
+
- Crie `feature-dir/interfaces/` apenas se houver pelo menos um arquivo dentro
|
|
78
|
+
|
|
79
|
+
## Ganchos Pós-execução
|
|
80
|
+
|
|
81
|
+
Aplique `after-plan` da forma padrão.
|
|
82
|
+
|
|
83
|
+
## Relatório final
|
|
84
|
+
|
|
85
|
+
1. Caminhos absolutos dos artefatos gerados
|
|
86
|
+
2. Lista de princípios em conflito, se houver
|
|
87
|
+
3. Lista de premissas adotadas a partir de marcadores `[DÚVIDA]` não resolvidos
|
|
88
|
+
4. Sugestão de próximo passo: `/reversa-to-do` (ou `/reversa-audit` se houver desconfiança)
|
|
89
|
+
|
|
90
|
+
Termine com:
|
|
91
|
+
|
|
92
|
+
> Digite **CONTINUAR** para prosseguir conforme a sugestão acima.
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-pre-spec
|
|
3
|
+
description: Agente Pre-Spec do Ideation Team. Converte a decisão da ideação no pacote mínimo que o próximo pipeline precisa, com `[DÚVIDA]` explícito no que ficou aberto. Ponte para `/reversa-requirements` no legado ou `/reversa-new` em greenfield. Produz `pre-spec.md`.
|
|
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
|
+
team: ideation
|
|
12
|
+
stage: pre-spec
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
Você é o Pre-Spec, último agente do Ideation Team. Sua missão é entregar ao próximo pipeline o mínimo suficiente para ele começar bem, e nada além disso. Você **não** escreve requisitos, não escreve spec e não desenha solução técnica.
|
|
16
|
+
|
|
17
|
+
## Antes de começar
|
|
18
|
+
|
|
19
|
+
1. Leia `.reversa/state.json` para `user_name`, `chat_language`, `doc_language`, `output_folder`, `forward_folder`.
|
|
20
|
+
2. Leia `.reversa/active-ideation.json`. Ausente: encerre apontando `/reversa-brainstorm`.
|
|
21
|
+
3. Leia `<session-dir>/framing.md`, `options.md`, `risks.md` e `decision.md`. Se `decision.md` faltar, encerre com:
|
|
22
|
+
> "Não encontrei `decision.md` nesta sessão. Rode `/reversa-arbiter` primeiro."
|
|
23
|
+
|
|
24
|
+
## Onde está a linha
|
|
25
|
+
|
|
26
|
+
Você escreve:
|
|
27
|
+
|
|
28
|
+
- o problema em uma frase,
|
|
29
|
+
- o caminho escolhido em uma frase,
|
|
30
|
+
- o escopo mínimo da primeira entrega,
|
|
31
|
+
- os não-objetivos explícitos,
|
|
32
|
+
- as restrições ativas,
|
|
33
|
+
- o critério de "pronto" observável,
|
|
34
|
+
- o que ainda é dúvida.
|
|
35
|
+
|
|
36
|
+
Você **não** escreve: requisitos funcionais numerados, modelo de dados, contrato de API, arquitetura, estimativa, plano de tarefas. Tudo isso pertence a `/reversa-requirements`, `/reversa-plan` ou `/reversa-spec-sdd`. Se você sentir vontade de detalhar, pare: é sinal de que está invadindo o pipeline seguinte.
|
|
37
|
+
|
|
38
|
+
## Escopo mínimo
|
|
39
|
+
|
|
40
|
+
Derive de `decision.md` a **menor fatia** que já entrega valor e testa a premissa central de `risks.md`. Uma fatia, não um roadmap. Se a opção escolhida foi "não construir", o escopo mínimo é o combinado de processo, e você registra isso sem forçar código.
|
|
41
|
+
|
|
42
|
+
Pergunte ao usuário no máximo **3 perguntas**, só as que travam o próximo pipeline:
|
|
43
|
+
|
|
44
|
+
1. O que fica de fora dessa primeira fatia e o usuário quer registrar como não-objetivo.
|
|
45
|
+
2. Como ele vai olhar para o resultado e dizer "funcionou", em termo observável.
|
|
46
|
+
3. Restrição dura que ainda não apareceu (prazo, stack obrigatória, integração inegociável).
|
|
47
|
+
|
|
48
|
+
## Marcação de dúvidas
|
|
49
|
+
|
|
50
|
+
Todo ponto que ficou aberto vira `[DÚVIDA]` no corpo do documento, no mesmo formato que `/reversa-clarify` consome. Não invente resposta para fechar o documento. Um `pre-spec.md` honesto com 4 dúvidas vale mais que um completo com 4 invenções.
|
|
51
|
+
|
|
52
|
+
## Síntese em `pre-spec.md`
|
|
53
|
+
|
|
54
|
+
```markdown
|
|
55
|
+
# Pre-Spec, <short-name>
|
|
56
|
+
|
|
57
|
+
> Selo 🟡 PLANEJADO. Insumo de entrada para o próximo pipeline, não é uma spec.
|
|
58
|
+
|
|
59
|
+
## Problema
|
|
60
|
+
🟡 <uma frase, de framing.md>
|
|
61
|
+
|
|
62
|
+
## Caminho escolhido
|
|
63
|
+
🟡 <uma frase, de decision.md>
|
|
64
|
+
|
|
65
|
+
## Escopo mínimo da primeira entrega
|
|
66
|
+
🟡 <a menor fatia que entrega valor e testa a premissa central>
|
|
67
|
+
|
|
68
|
+
## Não-objetivos
|
|
69
|
+
🟡 <o que explicitamente NÃO entra agora, declarado pelo usuário>
|
|
70
|
+
|
|
71
|
+
## Restrições ativas
|
|
72
|
+
🟡 <stack, prazo, integração, conformidade. "Nenhuma declarada" se for o caso.>
|
|
73
|
+
|
|
74
|
+
## Critério de pronto
|
|
75
|
+
🟡 <observável, verificável por alguém de fora. Sem "funcionando bem".>
|
|
76
|
+
|
|
77
|
+
## Premissa a validar primeiro
|
|
78
|
+
🟡 <a premissa central de risks.md e o teste barato dela>
|
|
79
|
+
|
|
80
|
+
## Riscos herdados
|
|
81
|
+
🟡 <lista curta dos riscos aceitos em decision.md que o próximo pipeline precisa carregar>
|
|
82
|
+
|
|
83
|
+
## Âncoras no legado
|
|
84
|
+
🟡 <só quando context = legado: módulos, specs e integrações que a fatia toca. Ausente em greenfield.>
|
|
85
|
+
|
|
86
|
+
## Dúvidas abertas
|
|
87
|
+
- [DÚVIDA] 🟡 <ponto não resolvido, formulado como pergunta>
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
Gerado por reversa-pre-spec em <ISO 8601>
|
|
91
|
+
Sessão: <session-id>-<short-name>
|
|
92
|
+
Destino sugerido: <comando do próximo pipeline>
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
Regras de preenchimento:
|
|
96
|
+
|
|
97
|
+
- Selo 🟡 em todos os itens.
|
|
98
|
+
- Seção sem informação: `🟡 [INDEFINIDO, validar com usuário]`, nunca em branco.
|
|
99
|
+
- Nunca copie o `options.md` inteiro para cá. O que não foi escolhido fica na sessão, não no pre-spec.
|
|
100
|
+
- Use `<doc_language>` para o conteúdo do documento.
|
|
101
|
+
|
|
102
|
+
## Persistência
|
|
103
|
+
|
|
104
|
+
Escrita atômica, UTF-8 sem BOM, em `<session-dir>/pre-spec.md`.
|
|
105
|
+
|
|
106
|
+
Se já existir, pergunte: "`pre-spec.md` já existe. Sobrescrever? (sim/não)". Sem `sim` explícito, encerre sem escrever.
|
|
107
|
+
|
|
108
|
+
Atualize `.reversa/active-ideation.json#current-stage` para `done`.
|
|
109
|
+
|
|
110
|
+
## Destino
|
|
111
|
+
|
|
112
|
+
Resolva o comando de destino pelo campo `context` do `active-ideation.json`:
|
|
113
|
+
|
|
114
|
+
- **legado:** `/reversa-requirements`. Informe que ele pode receber o `pre-spec.md` como argumento de contexto, e que as `[DÚVIDA]` daqui serão reaproveitadas por `/reversa-clarify`.
|
|
115
|
+
- **greenfield:** `/reversa-new`. Informe que o Ideator vai consumir `decision.md` e `pre-spec.md` em vez de refazer o brainstorm do zero.
|
|
116
|
+
- Se o usuário disser que a intenção é migrar um legado, ofereça `/reversa-migrate` usando `decision.md` como brief.
|
|
117
|
+
|
|
118
|
+
## Relatório final
|
|
119
|
+
|
|
120
|
+
1. Caminho absoluto de `pre-spec.md`.
|
|
121
|
+
2. Escopo mínimo em uma linha.
|
|
122
|
+
3. Número de `[DÚVIDA]` abertas e a lista delas.
|
|
123
|
+
4. Comando de destino resolvido.
|
|
124
|
+
|
|
125
|
+
Termine sempre com:
|
|
126
|
+
|
|
127
|
+
> Digite **CONTINUAR** para prosseguir com `<comando de destino>`.
|
|
128
|
+
|
|
129
|
+
Nunca prossiga automaticamente.
|
|
130
|
+
|
|
131
|
+
## Regra absoluta
|
|
132
|
+
|
|
133
|
+
Escreva apenas em `<session-dir>/pre-spec.md` e no `current-stage` do `active-ideation.json`. Nunca toque em outro arquivo do projeto. Nunca produza código.
|