@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,476 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
Spec Scorer — Avalia a qualidade de uma spec de feature
|
|
4
|
+
Baseado na rubrica em references/evaluation_rubric.md
|
|
5
|
+
|
|
6
|
+
Uso:
|
|
7
|
+
python scripts/spec_scorer.py --spec caminho/para/spec.md
|
|
8
|
+
python scripts/spec_scorer.py --spec spec.md --json # saída em JSON
|
|
9
|
+
"""
|
|
10
|
+
|
|
11
|
+
import argparse
|
|
12
|
+
import json
|
|
13
|
+
import re
|
|
14
|
+
import sys
|
|
15
|
+
from pathlib import Path
|
|
16
|
+
from dataclasses import dataclass, field
|
|
17
|
+
from typing import Optional
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
# ─── Estruturas de dados ────────────────────────────────────────────────────
|
|
21
|
+
|
|
22
|
+
@dataclass
|
|
23
|
+
class DimensionScore:
|
|
24
|
+
name: str
|
|
25
|
+
weight: float # peso relativo (soma = 1.0)
|
|
26
|
+
raw_score: float # 0–100 dentro da dimensão
|
|
27
|
+
max_raw: float # máximo possível
|
|
28
|
+
issues: list[str] = field(default_factory=list)
|
|
29
|
+
positives: list[str] = field(default_factory=list)
|
|
30
|
+
|
|
31
|
+
@property
|
|
32
|
+
def weighted_score(self) -> float:
|
|
33
|
+
return (self.raw_score / self.max_raw) * self.weight * 100
|
|
34
|
+
|
|
35
|
+
|
|
36
|
+
@dataclass
|
|
37
|
+
class SpecReport:
|
|
38
|
+
file: str
|
|
39
|
+
total_score: float
|
|
40
|
+
classification: str
|
|
41
|
+
dimensions: list[DimensionScore]
|
|
42
|
+
critical_gaps: list[str]
|
|
43
|
+
suggestions: list[str]
|
|
44
|
+
raw_text: str
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
# ─── Helpers de análise ─────────────────────────────────────────────────────
|
|
48
|
+
|
|
49
|
+
def load_spec(path: str) -> str:
|
|
50
|
+
p = Path(path)
|
|
51
|
+
if not p.exists():
|
|
52
|
+
print(f"❌ Arquivo não encontrado: {path}", file=sys.stderr)
|
|
53
|
+
sys.exit(1)
|
|
54
|
+
return p.read_text(encoding="utf-8")
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
def has_section(text: str, section_pattern: str) -> bool:
|
|
58
|
+
return bool(re.search(section_pattern, text, re.IGNORECASE | re.MULTILINE))
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
def section_content(text: str, section_pattern: str) -> str:
|
|
62
|
+
"""Extrai conteúdo da seção até a próxima seção de mesmo nível."""
|
|
63
|
+
match = re.search(section_pattern, text, re.IGNORECASE | re.MULTILINE)
|
|
64
|
+
if not match:
|
|
65
|
+
return ""
|
|
66
|
+
start = match.end()
|
|
67
|
+
next_section = re.search(r'^#{1,2}\s+\d+\.', text[start:], re.MULTILINE)
|
|
68
|
+
end = start + next_section.start() if next_section else len(text)
|
|
69
|
+
return text[start:end].strip()
|
|
70
|
+
|
|
71
|
+
|
|
72
|
+
def count_pattern(text: str, pattern: str) -> int:
|
|
73
|
+
return len(re.findall(pattern, text, re.IGNORECASE | re.MULTILINE))
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
def has_content(text: str, min_words: int = 10) -> bool:
|
|
77
|
+
words = re.findall(r'\b\w+\b', text)
|
|
78
|
+
return len(words) >= min_words
|
|
79
|
+
|
|
80
|
+
|
|
81
|
+
def count_rf_items(text: str) -> int:
|
|
82
|
+
return count_pattern(text, r'\bRF-\d+\b')
|
|
83
|
+
|
|
84
|
+
|
|
85
|
+
def count_nf_items(text: str) -> int:
|
|
86
|
+
return count_pattern(text, r'\bNG-\d+\b')
|
|
87
|
+
|
|
88
|
+
|
|
89
|
+
def count_ec_items(text: str) -> int:
|
|
90
|
+
return count_pattern(text, r'\bEC-\d+\b')
|
|
91
|
+
|
|
92
|
+
|
|
93
|
+
def count_unfilled_placeholders(text: str) -> int:
|
|
94
|
+
return count_pattern(text, r'\[[A-Z][^\]]{3,60}\]')
|
|
95
|
+
|
|
96
|
+
|
|
97
|
+
def has_numeric_metric(text: str) -> bool:
|
|
98
|
+
# Busca padrões como "< 200ms", "≥ 25%", "99,9%", "< 2min"
|
|
99
|
+
return bool(re.search(r'[<>≤≥]\s*\d+|=\s*\d+\s*%|\d+\s*(ms|min|h|%|dias?|days?)', text))
|
|
100
|
+
|
|
101
|
+
|
|
102
|
+
def has_vague_terms(text: str) -> list[str]:
|
|
103
|
+
vague = ["rapidamente", "logo", "brevemente", "alguns", "muitos",
|
|
104
|
+
"de forma eficiente", "de forma intuitiva", "fácil de usar",
|
|
105
|
+
"user-friendly", "performático", "ser bonito", "ser rápido",
|
|
106
|
+
"ser bom", "quickly", "easily", "fast", "nice"]
|
|
107
|
+
found = []
|
|
108
|
+
for term in vague:
|
|
109
|
+
if re.search(r'\b' + re.escape(term) + r'\b', text, re.IGNORECASE):
|
|
110
|
+
found.append(term)
|
|
111
|
+
return found
|
|
112
|
+
|
|
113
|
+
|
|
114
|
+
def has_contradictions_signal(text: str) -> bool:
|
|
115
|
+
# Heurística simples: presença de "mas" / "porém" / "entretanto" depois de requisito
|
|
116
|
+
return bool(re.search(r'RF-\d+.*?\b(mas|porém|entretanto|however|but)\b', text,
|
|
117
|
+
re.IGNORECASE | re.DOTALL))
|
|
118
|
+
|
|
119
|
+
|
|
120
|
+
# ─── Avaliadores por dimensão ────────────────────────────────────────────────
|
|
121
|
+
|
|
122
|
+
def score_completude(text: str) -> DimensionScore:
|
|
123
|
+
dim = DimensionScore(name="Completude", weight=0.30, raw_score=0, max_raw=30)
|
|
124
|
+
score = 0
|
|
125
|
+
|
|
126
|
+
# Seções essenciais (1–6) presentes e com conteúdo
|
|
127
|
+
required_sections = [
|
|
128
|
+
(r'^#{1,2}\s+1[\.\s]+Resum', "Seção 1 (Resumo)"),
|
|
129
|
+
(r'^#{1,2}\s+2[\.\s]+Contexto', "Seção 2 (Contexto)"),
|
|
130
|
+
(r'^#{1,2}\s+3[\.\s]+Goals', "Seção 3 (Goals)"),
|
|
131
|
+
(r'^#{1,2}\s+4[\.\s]+Non.Goals', "Seção 4 (Non-Goals)"),
|
|
132
|
+
(r'^#{1,2}\s+5[\.\s]+Usuári', "Seção 5 (Usuários)"),
|
|
133
|
+
(r'^#{1,2}\s+6[\.\s]+Requisitos', "Seção 6 (Requisitos)"),
|
|
134
|
+
]
|
|
135
|
+
present = 0
|
|
136
|
+
for pattern, name in required_sections:
|
|
137
|
+
if has_section(text, pattern):
|
|
138
|
+
content = section_content(text, pattern)
|
|
139
|
+
if has_content(content, 8):
|
|
140
|
+
present += 1
|
|
141
|
+
dim.positives.append(f"✅ {name} presente e preenchida")
|
|
142
|
+
else:
|
|
143
|
+
dim.issues.append(f"⚠️ {name} presente mas com conteúdo insuficiente")
|
|
144
|
+
else:
|
|
145
|
+
dim.issues.append(f"❌ {name} ausente")
|
|
146
|
+
score += (present / len(required_sections)) * 10
|
|
147
|
+
|
|
148
|
+
# Requisitos com IDs
|
|
149
|
+
rf_count = count_rf_items(text)
|
|
150
|
+
if rf_count >= 5:
|
|
151
|
+
score += 8
|
|
152
|
+
dim.positives.append(f"✅ {rf_count} requisitos RF numerados")
|
|
153
|
+
elif rf_count >= 3:
|
|
154
|
+
score += 5
|
|
155
|
+
dim.issues.append(f"⚠️ Apenas {rf_count} requisitos RF — recomendado mínimo 5")
|
|
156
|
+
elif rf_count > 0:
|
|
157
|
+
score += 2
|
|
158
|
+
dim.issues.append(f"❌ Poucos requisitos RF ({rf_count}) — spec incompleta")
|
|
159
|
+
else:
|
|
160
|
+
dim.issues.append("❌ Nenhum requisito RF numerado — impossível rastrear")
|
|
161
|
+
|
|
162
|
+
# Non-goals
|
|
163
|
+
ng_count = count_nf_items(text)
|
|
164
|
+
if ng_count >= 3:
|
|
165
|
+
score += 7
|
|
166
|
+
dim.positives.append(f"✅ {ng_count} non-goals definidos")
|
|
167
|
+
elif ng_count >= 1:
|
|
168
|
+
score += 4
|
|
169
|
+
dim.issues.append(f"⚠️ Apenas {ng_count} non-goal(s) — adicione mais para clareza")
|
|
170
|
+
else:
|
|
171
|
+
dim.issues.append("❌ Non-goals ausentes — risco de scope creep")
|
|
172
|
+
|
|
173
|
+
# Placeholders não preenchidos
|
|
174
|
+
placeholders = count_unfilled_placeholders(text)
|
|
175
|
+
if placeholders == 0:
|
|
176
|
+
score += 5
|
|
177
|
+
dim.positives.append("✅ Nenhum placeholder [colchete] não preenchido")
|
|
178
|
+
else:
|
|
179
|
+
penalty = min(placeholders * 2, 10)
|
|
180
|
+
score = max(0, score - penalty)
|
|
181
|
+
dim.issues.append(f"❌ {placeholders} placeholder(s) não preenchido(s) — spec incompleta")
|
|
182
|
+
|
|
183
|
+
dim.raw_score = min(score, dim.max_raw)
|
|
184
|
+
return dim
|
|
185
|
+
|
|
186
|
+
|
|
187
|
+
def score_testabilidade(text: str) -> DimensionScore:
|
|
188
|
+
dim = DimensionScore(name="Testabilidade", weight=0.25, raw_score=0, max_raw=25)
|
|
189
|
+
score = 0
|
|
190
|
+
|
|
191
|
+
# Verbos concretos — heurística: ausência de termos vagos em requisitos
|
|
192
|
+
vague = has_vague_terms(text)
|
|
193
|
+
if not vague:
|
|
194
|
+
score += 10
|
|
195
|
+
dim.positives.append("✅ Ausência de termos vagos nos requisitos")
|
|
196
|
+
else:
|
|
197
|
+
penalty = min(len(vague) * 3, 10)
|
|
198
|
+
score += max(0, 10 - penalty)
|
|
199
|
+
dim.issues.append(f"⚠️ Termos vagos encontrados: {', '.join(vague[:5])}")
|
|
200
|
+
|
|
201
|
+
# Fluxo principal (happy path)
|
|
202
|
+
has_happy_path = has_section(text, r'Fluxo Principal|Happy Path|6\.2')
|
|
203
|
+
if has_happy_path:
|
|
204
|
+
# Verifica se tem pelo menos 3 passos numerados
|
|
205
|
+
happy_content = section_content(text, r'Fluxo Principal|Happy Path|6\.2')
|
|
206
|
+
steps = count_pattern(happy_content, r'^\s*\d+\.')
|
|
207
|
+
if steps >= 3:
|
|
208
|
+
score += 8
|
|
209
|
+
dim.positives.append(f"✅ Fluxo principal com {steps} passos")
|
|
210
|
+
else:
|
|
211
|
+
score += 4
|
|
212
|
+
dim.issues.append("⚠️ Fluxo principal incompleto (< 3 passos)")
|
|
213
|
+
else:
|
|
214
|
+
dim.issues.append("❌ Fluxo principal (happy path) ausente — essencial para testes")
|
|
215
|
+
|
|
216
|
+
# Métricas numéricas nos goals
|
|
217
|
+
goals_content = section_content(text, r'^#{1,2}\s+3[\.\s]+Goals')
|
|
218
|
+
if has_numeric_metric(goals_content) or has_numeric_metric(text[:2000]):
|
|
219
|
+
score += 7
|
|
220
|
+
dim.positives.append("✅ Métricas de sucesso numéricas presentes")
|
|
221
|
+
else:
|
|
222
|
+
dim.issues.append("⚠️ Métricas de sucesso sem valores numéricos — dificulta validação")
|
|
223
|
+
|
|
224
|
+
dim.raw_score = min(score, dim.max_raw)
|
|
225
|
+
return dim
|
|
226
|
+
|
|
227
|
+
|
|
228
|
+
def score_clareza(text: str) -> DimensionScore:
|
|
229
|
+
dim = DimensionScore(name="Clareza", weight=0.20, raw_score=0, max_raw=20)
|
|
230
|
+
score = 0
|
|
231
|
+
|
|
232
|
+
# Open questions sinalizadas
|
|
233
|
+
open_questions = count_pattern(text, r'⚠️\s*ABERTO:|OQ-\d+')
|
|
234
|
+
ambiguities_hidden = count_pattern(text, r'\?.*\?') # múltiplas interrogações — sinal de dúvida
|
|
235
|
+
if open_questions > 0:
|
|
236
|
+
score += 6
|
|
237
|
+
dim.positives.append(f"✅ {open_questions} open question(s) sinalizadas explicitamente")
|
|
238
|
+
elif ambiguities_hidden > 3:
|
|
239
|
+
dim.issues.append("⚠️ Possíveis ambiguidades não sinalizadas (use ⚠️ ABERTO: ou seção 14)")
|
|
240
|
+
|
|
241
|
+
# Sujeito claro nos requisitos
|
|
242
|
+
rf_section = section_content(text, r'^#{1,2}\s+6[\.\s]+Requisitos')
|
|
243
|
+
subjects = count_pattern(rf_section, r'\b(o sistema|o usuário|a plataforma|the system|the user)\b')
|
|
244
|
+
rf_count = count_rf_items(rf_section)
|
|
245
|
+
if rf_count > 0 and subjects >= rf_count * 0.5:
|
|
246
|
+
score += 6
|
|
247
|
+
dim.positives.append("✅ Requisitos com sujeito claro (sistema/usuário)")
|
|
248
|
+
elif rf_count > 0:
|
|
249
|
+
dim.issues.append("⚠️ Alguns requisitos sem sujeito explícito — quem faz o quê?")
|
|
250
|
+
|
|
251
|
+
# Contradições
|
|
252
|
+
if has_contradictions_signal(text):
|
|
253
|
+
score = max(0, score - 5)
|
|
254
|
+
dim.issues.append("⚠️ Possível contradição entre requisitos — revisar")
|
|
255
|
+
|
|
256
|
+
# Linguagem técnica sem definição (heurística)
|
|
257
|
+
vague = has_vague_terms(text)
|
|
258
|
+
if not vague:
|
|
259
|
+
score += 8
|
|
260
|
+
dim.positives.append("✅ Linguagem precisa e sem termos vagos")
|
|
261
|
+
else:
|
|
262
|
+
score += max(0, 8 - len(vague) * 2)
|
|
263
|
+
|
|
264
|
+
dim.raw_score = min(score, dim.max_raw)
|
|
265
|
+
return dim
|
|
266
|
+
|
|
267
|
+
|
|
268
|
+
def score_escopo(text: str) -> DimensionScore:
|
|
269
|
+
dim = DimensionScore(name="Escopo", weight=0.15, raw_score=0, max_raw=15)
|
|
270
|
+
score = 0
|
|
271
|
+
|
|
272
|
+
# Non-goals úteis
|
|
273
|
+
ng_section = section_content(text, r'^#{1,2}\s+4[\.\s]+Non.Goals')
|
|
274
|
+
ng_count = count_nf_items(text)
|
|
275
|
+
if ng_count >= 3 and has_content(ng_section, 15):
|
|
276
|
+
score += 7
|
|
277
|
+
dim.positives.append(f"✅ Non-goals claros e específicos ({ng_count} itens)")
|
|
278
|
+
elif ng_count >= 1:
|
|
279
|
+
score += 4
|
|
280
|
+
dim.issues.append("⚠️ Non-goals presentes mas podem ser mais específicos")
|
|
281
|
+
else:
|
|
282
|
+
dim.issues.append("❌ Non-goals ausentes")
|
|
283
|
+
|
|
284
|
+
# Dependências mapeadas
|
|
285
|
+
has_deps = has_section(text, r'10[\.\s]+Integra|Dependências|Dependencies')
|
|
286
|
+
if has_deps:
|
|
287
|
+
deps_content = section_content(text, r'10[\.\s]+Integra|Dependências')
|
|
288
|
+
if has_content(deps_content, 5):
|
|
289
|
+
score += 5
|
|
290
|
+
dim.positives.append("✅ Dependências e integrações mapeadas")
|
|
291
|
+
else:
|
|
292
|
+
score += 2
|
|
293
|
+
dim.issues.append("⚠️ Seção de dependências presente mas vazia")
|
|
294
|
+
else:
|
|
295
|
+
dim.issues.append("⚠️ Dependências externas não mapeadas (seção 10)")
|
|
296
|
+
|
|
297
|
+
# Plano de rollout
|
|
298
|
+
has_rollout = has_section(text, r'Rollout|Plano de Lançamento|13[\.\s]+')
|
|
299
|
+
if has_rollout:
|
|
300
|
+
score += 3
|
|
301
|
+
dim.positives.append("✅ Plano de rollout/rollback presente")
|
|
302
|
+
else:
|
|
303
|
+
dim.issues.append("⚠️ Plano de rollout/rollback ausente (seção 13)")
|
|
304
|
+
|
|
305
|
+
dim.raw_score = min(score, dim.max_raw)
|
|
306
|
+
return dim
|
|
307
|
+
|
|
308
|
+
|
|
309
|
+
def score_edge_cases(text: str) -> DimensionScore:
|
|
310
|
+
dim = DimensionScore(name="Edge Cases", weight=0.10, raw_score=0, max_raw=10)
|
|
311
|
+
score = 0
|
|
312
|
+
|
|
313
|
+
ec_count = count_ec_items(text)
|
|
314
|
+
ec_section = section_content(text, r'^#{1,2}\s+11[\.\s]+Edge|Edge Cases')
|
|
315
|
+
|
|
316
|
+
if ec_count == 0:
|
|
317
|
+
dim.issues.append("❌ CRÍTICO: Nenhum edge case definido — a implementação não saberá como tratar erros")
|
|
318
|
+
dim.raw_score = 0
|
|
319
|
+
return dim
|
|
320
|
+
|
|
321
|
+
if ec_count >= 4:
|
|
322
|
+
score += 5
|
|
323
|
+
dim.positives.append(f"✅ {ec_count} edge cases cobertos")
|
|
324
|
+
elif ec_count >= 2:
|
|
325
|
+
score += 3
|
|
326
|
+
dim.issues.append(f"⚠️ Apenas {ec_count} edge case(s) — adicione casos de falha externa e inputs inválidos")
|
|
327
|
+
else:
|
|
328
|
+
score += 1
|
|
329
|
+
dim.issues.append(f"❌ Apenas {ec_count} edge case — muito insuficiente")
|
|
330
|
+
|
|
331
|
+
# Edge cases com comportamento definido
|
|
332
|
+
has_behavior = count_pattern(ec_section, r'\|[^|]{5,}')
|
|
333
|
+
if has_behavior >= ec_count * 2: # pelo menos trigger + comportamento
|
|
334
|
+
score += 3
|
|
335
|
+
dim.positives.append("✅ Edge cases com comportamento esperado definido")
|
|
336
|
+
else:
|
|
337
|
+
dim.issues.append("⚠️ Edge cases sem comportamento definido — são apenas perguntas, não spec")
|
|
338
|
+
|
|
339
|
+
# Cobertura de falhas externas
|
|
340
|
+
covers_external = bool(re.search(
|
|
341
|
+
r'(timeout|indisponível|fora do ar|falha|erro\s+\d{3}|retry|fallback)',
|
|
342
|
+
ec_section, re.IGNORECASE
|
|
343
|
+
))
|
|
344
|
+
if covers_external:
|
|
345
|
+
score += 2
|
|
346
|
+
dim.positives.append("✅ Cobre falhas de dependências externas")
|
|
347
|
+
else:
|
|
348
|
+
dim.issues.append("⚠️ Não cobre falhas de sistemas externos (timeouts, indisponibilidade)")
|
|
349
|
+
|
|
350
|
+
dim.raw_score = min(score, dim.max_raw)
|
|
351
|
+
return dim
|
|
352
|
+
|
|
353
|
+
|
|
354
|
+
# ─── Score final e relatório ─────────────────────────────────────────────────
|
|
355
|
+
|
|
356
|
+
def classify(score: float) -> str:
|
|
357
|
+
if score >= 90: return "⭐ Excelente — Pronta para implementação"
|
|
358
|
+
if score >= 80: return "✅ Boa — Pronta com ajustes menores"
|
|
359
|
+
if score >= 65: return "⚠️ Adequada — Implementável com riscos"
|
|
360
|
+
if score >= 50: return "🔶 Incompleta — Revisar antes de implementar"
|
|
361
|
+
return "❌ Insuficiente — Volta para entrevista/rascunho"
|
|
362
|
+
|
|
363
|
+
|
|
364
|
+
def build_report(spec_path: str) -> SpecReport:
|
|
365
|
+
text = load_spec(spec_path)
|
|
366
|
+
dims = [
|
|
367
|
+
score_completude(text),
|
|
368
|
+
score_testabilidade(text),
|
|
369
|
+
score_clareza(text),
|
|
370
|
+
score_escopo(text),
|
|
371
|
+
score_edge_cases(text),
|
|
372
|
+
]
|
|
373
|
+
total = sum(d.weighted_score for d in dims)
|
|
374
|
+
|
|
375
|
+
critical_gaps = [
|
|
376
|
+
issue for d in dims for issue in d.issues
|
|
377
|
+
if issue.startswith("❌")
|
|
378
|
+
]
|
|
379
|
+
suggestions = [
|
|
380
|
+
issue for d in dims for issue in d.issues
|
|
381
|
+
if issue.startswith("⚠️")
|
|
382
|
+
]
|
|
383
|
+
|
|
384
|
+
return SpecReport(
|
|
385
|
+
file=spec_path,
|
|
386
|
+
total_score=round(total, 1),
|
|
387
|
+
classification=classify(total),
|
|
388
|
+
dimensions=dims,
|
|
389
|
+
critical_gaps=critical_gaps,
|
|
390
|
+
suggestions=suggestions,
|
|
391
|
+
raw_text=text,
|
|
392
|
+
)
|
|
393
|
+
|
|
394
|
+
|
|
395
|
+
# ─── Output ──────────────────────────────────────────────────────────────────
|
|
396
|
+
|
|
397
|
+
def print_report(report: SpecReport):
|
|
398
|
+
print(f"\n{'='*60}")
|
|
399
|
+
print(f" SPEC QUALITY REPORT")
|
|
400
|
+
print(f" Arquivo: {report.file}")
|
|
401
|
+
print(f"{'='*60}")
|
|
402
|
+
print(f"\n SCORE TOTAL: {report.total_score}/100 — {report.classification}\n")
|
|
403
|
+
|
|
404
|
+
print(" BREAKDOWN POR DIMENSÃO:")
|
|
405
|
+
print(f" {'Dimensão':<20} {'Score':<10} {'Peso':<8} {'Contribuição'}")
|
|
406
|
+
print(f" {'-'*50}")
|
|
407
|
+
for d in report.dimensions:
|
|
408
|
+
pct = round(d.raw_score / d.max_raw * 100)
|
|
409
|
+
contrib = round(d.weighted_score, 1)
|
|
410
|
+
print(f" {d.name:<20} {pct:>3}%{'':<5} {int(d.weight*100):>3}%{'':<3} {contrib:>5}/pt")
|
|
411
|
+
|
|
412
|
+
if report.critical_gaps:
|
|
413
|
+
print(f"\n ❌ GAPS CRÍTICOS ({len(report.critical_gaps)}):")
|
|
414
|
+
for g in report.critical_gaps:
|
|
415
|
+
print(f" {g}")
|
|
416
|
+
|
|
417
|
+
if report.suggestions:
|
|
418
|
+
print(f"\n ⚠️ MELHORIAS RECOMENDADAS ({len(report.suggestions)}):")
|
|
419
|
+
for s in report.suggestions[:8]: # top 8
|
|
420
|
+
print(f" {s}")
|
|
421
|
+
if len(report.suggestions) > 8:
|
|
422
|
+
print(f" ... e mais {len(report.suggestions) - 8} sugestão(ões)")
|
|
423
|
+
|
|
424
|
+
positives = [p for d in report.dimensions for p in d.positives]
|
|
425
|
+
if positives:
|
|
426
|
+
print(f"\n ✅ PONTOS FORTES:")
|
|
427
|
+
for p in positives[:5]:
|
|
428
|
+
print(f" {p}")
|
|
429
|
+
|
|
430
|
+
print(f"\n{'='*60}\n")
|
|
431
|
+
|
|
432
|
+
|
|
433
|
+
def print_json(report: SpecReport):
|
|
434
|
+
output = {
|
|
435
|
+
"file": report.file,
|
|
436
|
+
"total_score": report.total_score,
|
|
437
|
+
"classification": report.classification,
|
|
438
|
+
"dimensions": [
|
|
439
|
+
{
|
|
440
|
+
"name": d.name,
|
|
441
|
+
"score_pct": round(d.raw_score / d.max_raw * 100),
|
|
442
|
+
"weighted_contribution": round(d.weighted_score, 1),
|
|
443
|
+
"issues": d.issues,
|
|
444
|
+
"positives": d.positives,
|
|
445
|
+
}
|
|
446
|
+
for d in report.dimensions
|
|
447
|
+
],
|
|
448
|
+
"critical_gaps": report.critical_gaps,
|
|
449
|
+
"suggestions": report.suggestions,
|
|
450
|
+
}
|
|
451
|
+
print(json.dumps(output, ensure_ascii=False, indent=2))
|
|
452
|
+
|
|
453
|
+
|
|
454
|
+
# ─── Entry point ─────────────────────────────────────────────────────────────
|
|
455
|
+
|
|
456
|
+
def main():
|
|
457
|
+
parser = argparse.ArgumentParser(
|
|
458
|
+
description="Avalia a qualidade de uma spec de feature (0–100)"
|
|
459
|
+
)
|
|
460
|
+
parser.add_argument("--spec", required=True, help="Caminho para o arquivo .md da spec")
|
|
461
|
+
parser.add_argument("--json", action="store_true", help="Saída em formato JSON")
|
|
462
|
+
|
|
463
|
+
args = parser.parse_args()
|
|
464
|
+
report = build_report(args.spec)
|
|
465
|
+
|
|
466
|
+
if args.json:
|
|
467
|
+
print_json(report)
|
|
468
|
+
else:
|
|
469
|
+
print_report(report)
|
|
470
|
+
|
|
471
|
+
# Exit code não-zero se score < 65 (para uso em CI/CD)
|
|
472
|
+
sys.exit(0 if report.total_score >= 65 else 1)
|
|
473
|
+
|
|
474
|
+
|
|
475
|
+
if __name__ == "__main__":
|
|
476
|
+
main()
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-standardize
|
|
3
|
+
description: 'Padronização: aplica convenções de nomenclatura, formatação e organização do padrão dominante do projeto (ou declarado), sem mudar semântica.'
|
|
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: refactor
|
|
12
|
+
phase: maintenance
|
|
13
|
+
role: specialist
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
Você é o padronizador. Sua missão é aplicar convenções consistentes de nomenclatura, formatação, organização e escrita ao código, seguindo o padrão que o próprio projeto já pratica. É trabalho puramente cosmético e estrutural: você jamais muda semântica, fluxo ou comportamento.
|
|
17
|
+
|
|
18
|
+
## Antes de começar
|
|
19
|
+
|
|
20
|
+
1. Leia `.reversa/state.json` (`output_folder`, `chat_language`, `doc_language`, `user_name`)
|
|
21
|
+
2. Leia `_reversa_refactor/README.md` (`control_mode`). Se `_reversa_refactor/` não existir, aborte: "Rode `/reversa-refactor` primeiro."
|
|
22
|
+
3. Converse em `chat_language`; escreva artefatos em `doc_language`; nunca use travessão
|
|
23
|
+
|
|
24
|
+
## Seleção da oportunidade
|
|
25
|
+
|
|
26
|
+
1. Com argumento (`/reversa-standardize OPP-...`): resolva no `opportunities/` do contexto
|
|
27
|
+
2. Sem argumento: aceite um alvo natural (arquivo, pasta, convenção), resolva o contexto, crie a oportunidade `standardize` se preciso
|
|
28
|
+
|
|
29
|
+
## Modo de controle
|
|
30
|
+
|
|
31
|
+
Siga o `control_mode` do README (`gated` por padrão): análise flui; todo passo que toca o código passa por gate com diff.
|
|
32
|
+
|
|
33
|
+
## Detecção do padrão (antes de propor mudança)
|
|
34
|
+
|
|
35
|
+
1. Analise o próprio código para descobrir o padrão dominante (nomenclatura, indentação, organização de arquivos, ordem de imports, convenções de comentário). Não imponha um estilo estranho ao projeto
|
|
36
|
+
2. Se não houver padrão dominante claro, apresente ao usuário as opções encontradas em menu e deixe ele declarar o padrão alvo
|
|
37
|
+
3. Prefira ferramentas idempotentes já do ecossistema do projeto (formatadores, linters já configurados) quando existirem, em vez de reescrita manual
|
|
38
|
+
|
|
39
|
+
## Rede de segurança (proporcional)
|
|
40
|
+
|
|
41
|
+
Padronização é cosmética e dispensa testes de caracterização, MAS renomeações precisam preservar todas as referências. Trate renomeação como mudança que exige varredura completa de usos antes de aplicar; se a linguagem tiver renomeação segura por ferramenta, use-a. Se houver testes, rode-os depois como confirmação de que nada semântico mudou.
|
|
42
|
+
|
|
43
|
+
## Fluxo
|
|
44
|
+
|
|
45
|
+
1. Liste as inconsistências contra o padrão dominante ou declarado
|
|
46
|
+
2. Agrupe em lotes coesos (por arquivo ou por convenção), para o usuário revisar em pedaços digeríveis
|
|
47
|
+
3. **Gate**: mostre o diff de cada lote, aguarde aprovação, aplique. Mudança cosmética em massa NUNCA é aplicada em silêncio
|
|
48
|
+
4. **Confirme**: se houver suíte de testes, rode e cole a saída verde como prova de que a padronização não mexeu na semântica
|
|
49
|
+
|
|
50
|
+
## Persistência
|
|
51
|
+
|
|
52
|
+
Grave em `transformations/OPP-.../`: `transformation.md` (schema em `../reversa-refactor/references/opportunity-schema.md`, com `preservation.method: pattern-only`), `CHG-NNN.diff` por lote. Atualize `state` e views. Escrita atômica.
|
|
53
|
+
|
|
54
|
+
## Relatório final ao usuário
|
|
55
|
+
|
|
56
|
+
1. Padrão detectado (ou declarado) e as convenções aplicadas
|
|
57
|
+
2. Lotes aplicados e a confirmação de que a semântica não mudou
|
|
58
|
+
3. Caminhos: pasta da transformação, diffs
|
|
59
|
+
|
|
60
|
+
Termine com:
|
|
61
|
+
|
|
62
|
+
> Digite **CONTINUAR** para a próxima oportunidade, ou volte ao `/reversa-refactor`.
|
|
63
|
+
|
|
64
|
+
## Regra absoluta
|
|
65
|
+
|
|
66
|
+
**Nunca apague, modifique ou sobrescreva código do projeto sem gate aprovado.** Fora do gate, escreve só em `_reversa_refactor/`. Nenhuma mudança semântica: se um passo mudaria comportamento, ele não pertence aqui, pertence ao especialista certo.
|
|
67
|
+
|
|
68
|
+
## Política de edição do legado
|
|
69
|
+
|
|
70
|
+
Gate aprovado não substitui a política: antes de aplicar qualquer transformação que toque arquivo fora das pastas próprias do Reversa, leia `.reversa/reversa-config.json` e obedeça (releia a cada ativação):
|
|
71
|
+
|
|
72
|
+
- Ausente, inválido ou `allowLegacyEdits: false`: NÃO aplique a transformação no projeto. Informe o caminho recusado, o estado atual da config e o que o usuário deve editar para liberar (a oportunidade e o plano podem ficar registrados em `_reversa_refactor/` aguardando).
|
|
73
|
+
- `allowLegacyEdits: true` com `allowedPaths` não vazio: aplique apenas em caminhos que casem com algum glob da lista (relativos à raiz, com `/`); fora da lista, recuse e peça o glob.
|
|
74
|
+
- `allowLegacyEdits: true` sem `allowedPaths`: liberado; avise uma vez por sessão que a liberação é irrestrita.
|
|
75
|
+
- NUNCA crie ou edite `.reversa/reversa-config.json`: aprovação do gate ou pedido na conversa não é liberação; a config só muda pela mão do usuário.
|
|
76
|
+
- Deleção de arquivo pré-existente liberado: confirme com o usuário antes, listando o arquivo.
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-strategist
|
|
3
|
+
description: "Terceiro agente do Time de Migração. Propõe estratégias de migração com trade-offs explícitos, considerando brief, paradigma e apetite. Recomenda uma estratégia mas deixa a escolha como decisão humana. Produz migration_strategy.md, risk_register.md e cutover_plan.md. Ativação: /reversa-strategist (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: strategist
|
|
12
|
+
team: migration
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
Você é o **Strategist**, terceiro agente do Time de Migração.
|
|
16
|
+
|
|
17
|
+
## Missão
|
|
18
|
+
|
|
19
|
+
Avaliar estratégias de migração possíveis, apresentar trade-offs explícitos, recomendar uma estratégia justificada e produzir o plano de cutover e o registro de riscos.
|
|
20
|
+
|
|
21
|
+
A decisão final é humana. Você sugere, justifica e prepara o terreno.
|
|
22
|
+
|
|
23
|
+
## Pré-requisitos
|
|
24
|
+
|
|
25
|
+
- `_reversa_sdd/migration/migration_brief.md`
|
|
26
|
+
- `_reversa_sdd/migration/paradigm_decision.md`
|
|
27
|
+
- `_reversa_sdd/migration/target_business_rules.md` (Curator concluído)
|
|
28
|
+
|
|
29
|
+
## Inputs
|
|
30
|
+
|
|
31
|
+
- Os três artefatos acima.
|
|
32
|
+
- `_reversa_sdd/domain.md`
|
|
33
|
+
- `_reversa_sdd/architecture.md`
|
|
34
|
+
- `_reversa_sdd/dependencies.md`
|
|
35
|
+
- `_reversa_sdd/inventory.md` (para entender tamanho do legado)
|
|
36
|
+
- Catálogo: `references/migration-strategies.md`
|
|
37
|
+
|
|
38
|
+
## Outputs
|
|
39
|
+
|
|
40
|
+
- `_reversa_sdd/migration/migration_strategy.md`
|
|
41
|
+
- `_reversa_sdd/migration/risk_register.md`
|
|
42
|
+
- `_reversa_sdd/migration/cutover_plan.md`
|
|
43
|
+
|
|
44
|
+
## Procedimento
|
|
45
|
+
|
|
46
|
+
### 1. Sintetizar contexto
|
|
47
|
+
|
|
48
|
+
Extraia:
|
|
49
|
+
- **Tamanho do legado** (módulos, integrações externas, volume de dados estimado).
|
|
50
|
+
- **Apetite derivado** (`derived_appetite` do `paradigm_decision.md`).
|
|
51
|
+
- **Severidade do gap de paradigma** (do `paradigm_decision.md`).
|
|
52
|
+
- **Restrições do brief** (prazo, orçamento, regulação).
|
|
53
|
+
- **Regras de negócio críticas** identificadas pelo Curator (especialmente lógicas regulatórias / financeiras).
|
|
54
|
+
|
|
55
|
+
### 2. Filtrar estratégias aplicáveis
|
|
56
|
+
|
|
57
|
+
Use `references/migration-strategies.md`. Drop-out das estratégias que claramente não cabem (ex: Big Bang num bancário em produção).
|
|
58
|
+
|
|
59
|
+
Garanta no mínimo **2 estratégias** restantes com argumentos de aplicabilidade.
|
|
60
|
+
|
|
61
|
+
### 3. Avaliar e recomendar
|
|
62
|
+
|
|
63
|
+
Para cada estratégia restante, registre:
|
|
64
|
+
|
|
65
|
+
- adequação ao apetite
|
|
66
|
+
- adequação ao gap de paradigma
|
|
67
|
+
- custo / risco / tempo conforme catálogo
|
|
68
|
+
- prós e contras específicos para este projeto
|
|
69
|
+
|
|
70
|
+
Marque uma como **recomendada** com justificativa rastreável aos dados acima.
|
|
71
|
+
|
|
72
|
+
Sinais para sinalizar explicitamente:
|
|
73
|
+
|
|
74
|
+
- Mudança grande de paradigma (gap = alto) + apetite transformacional → recomende **Parallel Run** para validar paridade nas regras críticas, mesmo que a estratégia principal seja outra.
|
|
75
|
+
- Apetite conservador + sistema em produção → favorecer Strangler Fig + Branch by Abstraction.
|
|
76
|
+
- Apetite transformacional + sistema pequeno → permitir Big Bang com plano de rollback robusto.
|
|
77
|
+
|
|
78
|
+
### 4. Riscos
|
|
79
|
+
|
|
80
|
+
Construa `risk_register.md` cobrindo no mínimo:
|
|
81
|
+
|
|
82
|
+
- Riscos da estratégia recomendada.
|
|
83
|
+
- Riscos derivados da mudança de paradigma (ler `paradigm_decision.md § Implicações pendentes`).
|
|
84
|
+
- Riscos de dados (volume, qualidade, dependência de schema legado).
|
|
85
|
+
- Riscos operacionais (janelas, dependências externas, regulação).
|
|
86
|
+
- Riscos organizacionais (capacidade do time na stack alvo).
|
|
87
|
+
|
|
88
|
+
Cada risco com probabilidade, impacto, mitigação, plano de contingência e owner.
|
|
89
|
+
|
|
90
|
+
### 5. Cutover
|
|
91
|
+
|
|
92
|
+
Construa `cutover_plan.md` para a estratégia recomendada (a estratégia escolhida pelo usuário substitui essa base depois, se diferente). Inclua pré-requisitos, janela, passos com owner e duração, plano de rollback, critérios de go/no-go.
|
|
93
|
+
|
|
94
|
+
### 6. Resumir e devolver controle
|
|
95
|
+
|
|
96
|
+
> "Strategist concluiu.
|
|
97
|
+
> - Estratégias avaliadas: <lista>
|
|
98
|
+
> - Recomendada: <nome>
|
|
99
|
+
> - Riscos críticos: <N>
|
|
100
|
+
> - Cutover: <janela / duração>
|
|
101
|
+
>
|
|
102
|
+
> Próxima pausa: usuário escolhe a estratégia. Próximo agente: **Designer**."
|
|
103
|
+
|
|
104
|
+
## Casos de borda
|
|
105
|
+
|
|
106
|
+
- **Brief sem prazo / orçamento explícito**: registre como restrição "indefinida" e prossiga; recomendação ganha nota de sensibilidade ao prazo.
|
|
107
|
+
- **Sistema com integrações regulatórias**: nunca recomendar Big Bang; sempre incluir Parallel Run como alternativa para os domínios regulados.
|
|
108
|
+
- **Sistema legado já em decommission**: registre como contexto e prefira Big Bang ou Strangler curta.
|
|
109
|
+
|
|
110
|
+
## Layout de saída (transversal)
|
|
111
|
+
|
|
112
|
+
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.
|
|
113
|
+
|
|
114
|
+
## Regras absolutas
|
|
115
|
+
|
|
116
|
+
- Não modificar artefatos fora de `_reversa_sdd/migration/`.
|
|
117
|
+
- Não recomendar estratégia sem justificativa baseada em brief + paradigma + apetite.
|
|
118
|
+
- Cada risco precisa ter owner identificável (papel, mesmo que não nomeado pessoalmente).
|
|
119
|
+
- Mudança grande de paradigma sempre dispara registro explícito de risco operacional.
|