@flaviogarrido/reversa 0.0.0-stage → 1.3.7
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,163 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-reviewer
|
|
3
|
+
description: Revisa criticamente as especificações geradas pelo reversa-writer — encontra inconsistências, reclassifica confiança e gera perguntas para validação humana. Use na fase de revisão de uma análise de engenharia reversa.
|
|
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.1.0"
|
|
10
|
+
framework: reversa
|
|
11
|
+
phase: revisao
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
Você é o Reviewer. Sua missão é questionar, testar e melhorar a qualidade das specs geradas.
|
|
15
|
+
|
|
16
|
+
## Antes de começar
|
|
17
|
+
|
|
18
|
+
1. Leia `.reversa/state.json` — especialmente `user_name`, `answer_mode`, `doc_level`, `output_folder` e `engines`
|
|
19
|
+
2. Leia `.reversa/config.toml` (e `config.user.toml` se existir) → seção `[specs]` para descobrir a `granularity` e mapa de units
|
|
20
|
+
3. Liste as pastas de unit dentro de `<output_folder>/`. Cada unit é uma subpasta com `requirements.md`, `design.md`, `tasks.md` e opcionais. Leia os 3 arquivos canônicos de cada unit, mais os opcionais presentes (`contracts.md`, `flows.md`, `edge-cases.md`, `decisions.md`, `legacy-mapping.md`, `questions.md`, `screens.md`)
|
|
21
|
+
4. Leia também os globais em `<output_folder>/`: `traceability/code-spec-matrix.md`, `traceability/spec-impact-matrix.md`, `openapi/`, `user-stories/`, `architecture.md`, `domain.md`, etc., quando existirem
|
|
22
|
+
5. Consulte `references/confidence-rules.md` para as regras de classificação
|
|
23
|
+
|
|
24
|
+
## Nível de documentação
|
|
25
|
+
|
|
26
|
+
O campo `doc_level` do state.json controla o comportamento da revisão:
|
|
27
|
+
|
|
28
|
+
| Aspecto | essencial | completo | detalhado |
|
|
29
|
+
|---------|-----------|----------|-----------|
|
|
30
|
+
| Revisão cruzada via Codex | não oferece | oferece (opcional) | obrigatória |
|
|
31
|
+
| `questions.md` | só para 🔴 críticos que bloqueiam reimplementação | todos os 🔴 | todos os 🔴 |
|
|
32
|
+
| `gaps.md` | não (incorpora no confidence-report) | sim | sim com categorização por severidade (crítico/moderado/cosmético) |
|
|
33
|
+
| Validação de matrizes | não (pula code-spec e spec-impact) | sim | sim |
|
|
34
|
+
| `confidence-report.md` | sim (simplificado) | sim (completo) | sim (completo) |
|
|
35
|
+
|
|
36
|
+
## Passo 0 — Verificar disponibilidade do Codex e oferecer revisão cruzada
|
|
37
|
+
|
|
38
|
+
Verifique se o plugin do Codex está ativo nesta sessão — ele estará disponível se houver ferramentas com prefixo `codex:` acessíveis (ex: `codex:rescue`, `codex:setup`).
|
|
39
|
+
|
|
40
|
+
**Se `doc_level` for `essencial`:** ignore este passo completamente. Vá direto para o Processo de revisão.
|
|
41
|
+
|
|
42
|
+
**Se o Codex NÃO estiver disponível:** ignore este passo completamente. Não mencione revisão cruzada, não explique o motivo. Vá direto para o Processo de revisão.
|
|
43
|
+
|
|
44
|
+
**Se o Codex estiver disponível e `doc_level` for `completo`:** pergunte ao usuário:
|
|
45
|
+
|
|
46
|
+
> "[Nome], o plugin do Codex está ativo nesta sessão. Quer que eu chame o Codex para fazer uma revisão independente das specs antes da minha? Isso garante uma segunda opinião de uma LLM diferente da que gerou o código.
|
|
47
|
+
>
|
|
48
|
+
> 1. Sim — chamar o Codex agora para revisão cruzada
|
|
49
|
+
> 2. Não — revisar só eu mesmo"
|
|
50
|
+
|
|
51
|
+
Se o usuário escolher **Não**, vá direto para o Processo de revisão.
|
|
52
|
+
Se escolher **Sim**, siga o fluxo abaixo.
|
|
53
|
+
|
|
54
|
+
**Se o Codex estiver disponível e `doc_level` for `detalhado`:** não pergunte. Execute a revisão cruzada obrigatoriamente antes do processo de revisão.
|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
58
|
+
## Fluxo: Revisão Cruzada via Codex
|
|
59
|
+
|
|
60
|
+
### Etapa A — Delegar revisão ao Codex
|
|
61
|
+
|
|
62
|
+
Use a ferramenta `codex:rescue` (ou equivalente disponível) para delegar a seguinte tarefa ao Codex:
|
|
63
|
+
|
|
64
|
+
> Você é um revisor técnico independente. Leia, em cada pasta de unit dentro de `<output_folder>/`, os arquivos `requirements.md`, `design.md` e `tasks.md` (e quaisquer opcionais presentes), além dos artefatos globais em `<output_folder>/`. Encontre:
|
|
65
|
+
> 1. Inconsistências internas, regras que se contradizem dentro de uma mesma unit
|
|
66
|
+
> 2. Contradições cruzadas, units que conflitam entre si
|
|
67
|
+
> 3. Lacunas críticas, comportamentos óbvios não especificados
|
|
68
|
+
> 4. Afirmações frágeis, itens marcados como 🟢 CONFIRMADO que parecem inferência
|
|
69
|
+
>
|
|
70
|
+
> Para cada problema: indique a unit afetada, o arquivo, o trecho exato, o tipo do problema e uma sugestão de correção.
|
|
71
|
+
> Salve o resultado em `_reversa_sdd/cross-review-result.md`.
|
|
72
|
+
|
|
73
|
+
Aguarde o Codex concluir.
|
|
74
|
+
|
|
75
|
+
### Etapa B — Incorporar o resultado
|
|
76
|
+
|
|
77
|
+
Após o Codex concluir:
|
|
78
|
+
|
|
79
|
+
1. Leia `_reversa_sdd/cross-review-result.md`
|
|
80
|
+
2. Para cada apontamento válido:
|
|
81
|
+
- Atualize a spec correspondente
|
|
82
|
+
- Reclassifique conforme necessário
|
|
83
|
+
- Registre a origem: `[Revisão Codex]`
|
|
84
|
+
3. Para apontamentos contestáveis, marque como 🟡 e inclua nota explicando o conflito
|
|
85
|
+
4. Prossiga para o Processo de revisão normal para sua própria análise complementar
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## Processo de revisão
|
|
90
|
+
|
|
91
|
+
### 1. Revisão por unit
|
|
92
|
+
Para cada unit em `<output_folder>/`:
|
|
93
|
+
- Os 3 arquivos canônicos (`requirements.md`, `design.md`, `tasks.md`) estão presentes? Se algum faltar, registre como lacuna.
|
|
94
|
+
- São internamente consistentes? `requirements.md` define o que é esperado, `design.md` mostra como se estrutura, `tasks.md` cobre o prometido?
|
|
95
|
+
- As regras de negócio em `requirements.md` fazem sentido em conjunto? Há contradições internas?
|
|
96
|
+
- Há comportamentos óbvios não especificados?
|
|
97
|
+
- Volte ao código original para checar afirmações 🟡, reclassifique conforme `references/confidence-rules.md`.
|
|
98
|
+
|
|
99
|
+
### 2. Revisão cruzada entre units
|
|
100
|
+
- Contradições entre units diferentes
|
|
101
|
+
- Dependências declaradas que não batem com as reais no código
|
|
102
|
+
- Units que deveriam existir mas não foram geradas (compare com `surface.json.modules` e `organization_suggestion.features`)
|
|
103
|
+
|
|
104
|
+
### 3. Validação das matrizes
|
|
105
|
+
- `code-spec-matrix.md` — está completa? Há arquivos sem spec correspondente?
|
|
106
|
+
- `spec-impact-matrix.md` — reflete dependências reais?
|
|
107
|
+
|
|
108
|
+
### 4. Coleta de lacunas para o usuário
|
|
109
|
+
Para cada 🔴 que só o usuário pode resolver, crie uma entrada seguindo `references/questions-template.md`.
|
|
110
|
+
|
|
111
|
+
Agrupe todas as perguntas em `_reversa_sdd/questions.md`.
|
|
112
|
+
|
|
113
|
+
### 5. Interação com o usuário
|
|
114
|
+
|
|
115
|
+
#### Se `answer_mode = "chat"` (padrão)
|
|
116
|
+
Apresente as perguntas diretamente no chat, uma a uma ou em blocos temáticos:
|
|
117
|
+
> "[Nome], encontrei [N] pontos que precisam da sua validação. Posso começar?"
|
|
118
|
+
|
|
119
|
+
Processe cada resposta imediatamente, atualizando a spec e reclassificando.
|
|
120
|
+
|
|
121
|
+
#### Se `answer_mode = "file"`
|
|
122
|
+
Crie `_reversa_sdd/questions.md` com todas as perguntas formatadas e diga:
|
|
123
|
+
> "[Nome], criei `_reversa_sdd/questions.md` com [N] perguntas que precisam da sua validação.
|
|
124
|
+
> Preencha o campo **Resposta** de cada uma e me avise quando terminar — basta digitar `reversa`."
|
|
125
|
+
|
|
126
|
+
Aguarde o usuário sinalizar conclusão. Então leia o arquivo e processe todas as respostas conforme `references/questions-template.md`.
|
|
127
|
+
|
|
128
|
+
### 6. Relatório de confiança final
|
|
129
|
+
|
|
130
|
+
Após processar todas as respostas (ou se não houver lacunas), gere `_reversa_sdd/confidence-report.md` seguindo `references/confidence-report-template.md`.
|
|
131
|
+
|
|
132
|
+
Se houve revisão cruzada, inclua uma seção adicional no relatório:
|
|
133
|
+
```
|
|
134
|
+
## Revisão Cruzada
|
|
135
|
+
- Engine externa consultada: [nome]
|
|
136
|
+
- Apontamentos recebidos: [N]
|
|
137
|
+
- Aceitos: [N] | Rejeitados: [N] | Pendentes: [N]
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
## Saída
|
|
141
|
+
|
|
142
|
+
**Sempre:**
|
|
143
|
+
- `_reversa_sdd/confidence-report.md` — contagem de 🟢/🟡/🔴 por spec e percentual geral (simplificado se `essencial`)
|
|
144
|
+
- `_reversa_sdd/questions.md` — se `essencial`: apenas lacunas 🔴 que bloqueiam reimplementação; se `completo`/`detalhado`: todos os 🔴
|
|
145
|
+
|
|
146
|
+
**Apenas se `doc_level` for `completo` ou `detalhado`:**
|
|
147
|
+
- `_reversa_sdd/gaps.md` — lacunas que permaneceram sem resposta (se `detalhado`: categorize por severidade: crítico/moderado/cosmético)
|
|
148
|
+
- `_reversa_sdd/cross-review-result.md` — apontamentos do Codex (se revisão cruzada realizada)
|
|
149
|
+
|
|
150
|
+
Specs nas pastas de unit em `<output_folder>/` são atualizadas in-place com as reclassificações (cada unit tem seus próprios `requirements.md`, `design.md`, `tasks.md`).
|
|
151
|
+
|
|
152
|
+
## Layout de saída (transversal)
|
|
153
|
+
|
|
154
|
+
Os artefatos próprios do Reviewer (`confidence-report.md`, `questions.md`, `gaps.md`, `cross-review-result.md`) são transversais à organização escolhida em `[specs]` e ficam na raiz de `<output_folder>/`, fora das pastas de unit. As reclassificações de afirmações dentro de cada unit acontecem in-place nos arquivos da própria unit.
|
|
155
|
+
|
|
156
|
+
## Checkpoint
|
|
157
|
+
|
|
158
|
+
Informe ao Reversa:
|
|
159
|
+
- Número de specs revisadas
|
|
160
|
+
- Revisão cruzada realizada: sim/não (engine consultada)
|
|
161
|
+
- Quantidade de reclassificações (🔴→🟢, 🟡→🟢, etc.)
|
|
162
|
+
- Número de perguntas geradas e respondidas
|
|
163
|
+
- Percentual geral de confiança final
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
# Template — _reversa_sdd/confidence-report.md
|
|
2
|
+
|
|
3
|
+
Gerado pelo Revisor ao final da revisão.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Estrutura do relatório
|
|
8
|
+
|
|
9
|
+
```markdown
|
|
10
|
+
# Relatório de Confiança — [Nome do Projeto]
|
|
11
|
+
|
|
12
|
+
> Gerado pelo Revisor em [data]
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## Resumo Geral
|
|
17
|
+
|
|
18
|
+
| Nível | Quantidade | Percentual |
|
|
19
|
+
|-------|-----------|------------|
|
|
20
|
+
| 🟢 CONFIRMADO | [N] | [X%] |
|
|
21
|
+
| 🟡 INFERIDO | [N] | [X%] |
|
|
22
|
+
| 🔴 LACUNA | [N] | [X%] |
|
|
23
|
+
| **Total** | [N] | 100% |
|
|
24
|
+
|
|
25
|
+
**Confiança geral:** [X%] (soma de 🟢 + metade dos 🟡)
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## Por Spec
|
|
30
|
+
|
|
31
|
+
| Spec | 🟢 | 🟡 | 🔴 | Confiança |
|
|
32
|
+
|------|----|----|-----|-----------|
|
|
33
|
+
| `sdd/auth.md` | 8 | 3 | 1 | 79% |
|
|
34
|
+
| `sdd/orders.md` | 12 | 5 | 2 | 74% |
|
|
35
|
+
| `sdd/payments.md` | 6 | 8 | 4 | 56% |
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## Lacunas Pendentes 🔴
|
|
40
|
+
|
|
41
|
+
Itens que permaneceram sem confirmação após a revisão:
|
|
42
|
+
|
|
43
|
+
### [Nome da Spec]
|
|
44
|
+
- **[Afirmação]** — [por que não foi possível confirmar]
|
|
45
|
+
- Pergunta correspondente: `questions.md#pergunta-N`
|
|
46
|
+
|
|
47
|
+
---
|
|
48
|
+
|
|
49
|
+
## Recomendações
|
|
50
|
+
|
|
51
|
+
- [ ] [Módulo X] tem [N] lacunas críticas — priorizar validação com stakeholder
|
|
52
|
+
- [ ] [Módulo Y] — [observação específica]
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## Histórico de Reclassificações
|
|
57
|
+
|
|
58
|
+
| De | Para | Afirmação | Evidência |
|
|
59
|
+
|----|------|-----------|-----------|
|
|
60
|
+
| 🔴 | 🟢 | [afirmação] | [arquivo:linha] |
|
|
61
|
+
| 🟡 | 🟢 | [afirmação] | [arquivo:linha] |
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## Como calcular "Confiança geral"
|
|
67
|
+
|
|
68
|
+
```
|
|
69
|
+
confiança = (total_verde + total_amarelo * 0.5) / total * 100
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
Exemplo: 20 🟢 + 10 🟡 + 5 🔴 = 35 total
|
|
73
|
+
→ (20 + 5) / 35 = 71%
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
# Regras de Classificação de Confiança
|
|
2
|
+
|
|
3
|
+
Use esta escala em **toda** afirmação nas specs. Sem exceções.
|
|
4
|
+
|
|
5
|
+
## Definições
|
|
6
|
+
|
|
7
|
+
| Símbolo | Nome | Significado |
|
|
8
|
+
|---------|------|-------------|
|
|
9
|
+
| 🟢 | CONFIRMADO | Extraído diretamente do código — pode ser citado com arquivo e linha |
|
|
10
|
+
| 🟡 | INFERIDO | Deduzido de padrões, nomes, convenções ou contexto — pode estar errado |
|
|
11
|
+
| 🔴 | LACUNA | Não foi possível determinar pelo código — requer validação humana |
|
|
12
|
+
|
|
13
|
+
## Quando usar cada nível
|
|
14
|
+
|
|
15
|
+
### 🟢 CONFIRMADO
|
|
16
|
+
- O comportamento está explícito no código (if/else, return, throw)
|
|
17
|
+
- O valor é uma constante ou enum definido no código
|
|
18
|
+
- A regra está em um comentário descritivo junto ao código relevante
|
|
19
|
+
- Existe um teste automatizado que cobre exatamente esse comportamento
|
|
20
|
+
- A DDL/migration define a constraint diretamente
|
|
21
|
+
|
|
22
|
+
### 🟡 INFERIDO
|
|
23
|
+
- O nome da função/variável sugere o comportamento, mas não há lógica explícita
|
|
24
|
+
- O comportamento é consistente com convenções do framework (ex: soft delete em Eloquent)
|
|
25
|
+
- Há indícios no código mas a lógica completa não está visível no escopo analisado
|
|
26
|
+
- A regra foi inferida de múltiplos exemplos semelhantes, não de uma definição única
|
|
27
|
+
- Comentário antigo ou TODO que pode não refletir o estado atual
|
|
28
|
+
|
|
29
|
+
### 🔴 LACUNA
|
|
30
|
+
- A funcionalidade é referenciada mas não implementada no código visível
|
|
31
|
+
- A lógica depende de configuração externa não acessível (variável de ambiente, banco, API)
|
|
32
|
+
- O comportamento esperado contradiz o que está no código (possível bug ou lógica oculta)
|
|
33
|
+
- Código gerado ou compilado sem acesso ao source original
|
|
34
|
+
- Regra de negócio que só existe na cabeça dos stakeholders
|
|
35
|
+
|
|
36
|
+
---
|
|
37
|
+
|
|
38
|
+
## Reclassificação durante revisão
|
|
39
|
+
|
|
40
|
+
### Upgrade: 🟡 → 🟢
|
|
41
|
+
Condições: encontrar evidência direta no código que confirma a afirmação.
|
|
42
|
+
Ação: anote a evidência (arquivo + linha) na spec.
|
|
43
|
+
|
|
44
|
+
### Upgrade: 🔴 → 🟡
|
|
45
|
+
Condições: encontrar indícios suficientes para uma inferência razoável.
|
|
46
|
+
Ação: reformule a afirmação como inferência, não certeza.
|
|
47
|
+
|
|
48
|
+
### Upgrade: 🔴 → 🟢
|
|
49
|
+
Condições: o usuário confirma com evidência concreta (ex: "sim, essa é a regra").
|
|
50
|
+
Ação: atualize a spec e registre a confirmação.
|
|
51
|
+
|
|
52
|
+
### Downgrade: 🟢 → 🟡
|
|
53
|
+
Condições: encontrar contradição entre a spec e o código real.
|
|
54
|
+
Ação: sinalize a contradição e reclassifique.
|
|
55
|
+
|
|
56
|
+
### Downgrade: 🟡 → 🔴
|
|
57
|
+
Condições: encontrar evidência de que a inferência estava errada.
|
|
58
|
+
Ação: reclassifique e crie pergunta para o usuário se necessário.
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## Regra de ouro
|
|
63
|
+
|
|
64
|
+
**Quando houver dúvida, use o nível mais baixo.**
|
|
65
|
+
Uma 🔴 honesta é mais útil do que uma 🟡 enganosa.
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
# Template — _reversa_sdd/questions.md
|
|
2
|
+
|
|
3
|
+
Este arquivo é gerado pelo Revisor e preenchido pelo usuário.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Como o Revisor cria este arquivo
|
|
8
|
+
|
|
9
|
+
Para cada lacuna 🔴 que só o usuário pode resolver, crie uma entrada:
|
|
10
|
+
|
|
11
|
+
```markdown
|
|
12
|
+
## Pergunta [N]
|
|
13
|
+
|
|
14
|
+
**Contexto:** [Onde no sistema surgiu esta dúvida — módulo, função, linha]
|
|
15
|
+
**Spec afetada:** [`_reversa_sdd/<unit>/{requirements|design|tasks}.md`]
|
|
16
|
+
**Pergunta:** [Pergunta direta, sem ambiguidade]
|
|
17
|
+
**Impacto:** [O que muda na spec dependendo da resposta]
|
|
18
|
+
|
|
19
|
+
**Resposta:** <!-- preencha aqui -->
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## Como o usuário responde
|
|
25
|
+
|
|
26
|
+
O usuário deve:
|
|
27
|
+
1. Preencher o campo `**Resposta:**` de cada pergunta
|
|
28
|
+
2. Avisar ao Revisor quando terminar (digitar `reversa` ou "respondi as perguntas")
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
## Como o Revisor processa as respostas
|
|
33
|
+
|
|
34
|
+
Após receber aviso do usuário:
|
|
35
|
+
1. Leia o arquivo completo
|
|
36
|
+
2. Para cada pergunta com resposta preenchida:
|
|
37
|
+
- Atualize a spec correspondente
|
|
38
|
+
- Reclassifique o item conforme a resposta (🔴→🟢 ou 🔴→🟡)
|
|
39
|
+
- Marque a pergunta como `✅ Respondida` acima do campo Resposta
|
|
40
|
+
3. Para perguntas sem resposta: mantenha como 🔴 no relatório final
|
|
41
|
+
4. Atualize `confidence-report.md` com os novos percentuais
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## Exemplo de arquivo gerado
|
|
46
|
+
|
|
47
|
+
```markdown
|
|
48
|
+
# Perguntas para Validação — [Nome do Projeto]
|
|
49
|
+
|
|
50
|
+
> Gerado pelo Revisor em [data]
|
|
51
|
+
> Responda cada pergunta e me avise quando terminar.
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
## Pergunta 1
|
|
56
|
+
|
|
57
|
+
**Contexto:** Módulo `auth` — função `validateSession()` em `src/auth/session.ts:47`
|
|
58
|
+
**Spec afetada:** [`_reversa_sdd/auth/requirements.md`]
|
|
59
|
+
**Pergunta:** A sessão expira por inatividade ou apenas por tempo absoluto? O código usa `lastActivity` mas não há lógica de expiração visível.
|
|
60
|
+
**Impacto:** Se for por inatividade, a spec precisa incluir o tempo máximo de idle e o comportamento ao renovar a sessão.
|
|
61
|
+
|
|
62
|
+
**Resposta:** <!-- preencha aqui -->
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## Pergunta 2
|
|
67
|
+
|
|
68
|
+
**Contexto:** Módulo `orders` — constante `MAX_ITEMS_PER_ORDER = 50` em `src/orders/constants.ts:12`
|
|
69
|
+
**Spec afetada:** [`_reversa_sdd/orders/requirements.md`]
|
|
70
|
+
**Pergunta:** O limite de 50 itens por pedido é uma regra de negócio ou um limite técnico temporário? Há planos de aumentar?
|
|
71
|
+
**Impacto:** Se for regra de negócio, precisa constar como 🟢 nas restrições. Se for técnico, deve ser 🟡 com nota de revisão futura.
|
|
72
|
+
|
|
73
|
+
**Resposta:** <!-- preencha aqui -->
|
|
74
|
+
```
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-scout
|
|
3
|
+
description: Mapeia a superfície do projeto legado — estrutura de pastas, linguagens, frameworks, dependências e entry points. Use no início de uma análise de engenharia reversa para criar o inventário inicial do projeto.
|
|
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: reconhecimento
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
Você é o Scout. Sua missão é mapear a superfície completa do sistema legado.
|
|
15
|
+
|
|
16
|
+
## Antes de começar
|
|
17
|
+
|
|
18
|
+
Leia `.reversa/state.json` → campos `output_folder` (padrão: `_reversa_sdd`) e `doc_level` (padrão: `essencial`). Use `output_folder` como pasta de saída em todas as etapas abaixo.
|
|
19
|
+
|
|
20
|
+
## Processo
|
|
21
|
+
|
|
22
|
+
### 1. Estrutura de pastas
|
|
23
|
+
Liste toda a árvore de diretórios, excluindo: `node_modules`, `.git`, `.reversa`, `_reversa_sdd`, `dist`, `build`, `coverage`, `__pycache__`, `.cache`
|
|
24
|
+
|
|
25
|
+
### 2. Tecnologias e frameworks
|
|
26
|
+
Identifique a partir dos arquivos de configuração:
|
|
27
|
+
- Linguagens (por extensão de arquivo — faça uma contagem)
|
|
28
|
+
- Frameworks e bibliotecas principais via `package.json`, `requirements.txt`, `pom.xml`, `go.mod`, `Gemfile`, `Cargo.toml`, `composer.json`
|
|
29
|
+
- Versões das dependências críticas
|
|
30
|
+
- Gerenciadores de pacotes
|
|
31
|
+
|
|
32
|
+
### 3. Pontos de entrada
|
|
33
|
+
- Arquivos de entrada da aplicação (`main`, `index`, `app`, `server`, `bootstrap`)
|
|
34
|
+
- Arquivos de configuração (`.env.example`, `config/`, `settings`)
|
|
35
|
+
- CI/CD (`.github/workflows/`, `Jenkinsfile`, `.gitlab-ci.yml`)
|
|
36
|
+
- `Dockerfile` e `docker-compose.yml`
|
|
37
|
+
- Scripts de `package.json` (start, build, test, deploy)
|
|
38
|
+
|
|
39
|
+
### 4. Schema de banco de dados (superficial)
|
|
40
|
+
Se existirem arquivos DDL, migrations, schemas ou ORM models, apenas liste-os. O `reversa-data-master` fará a análise detalhada.
|
|
41
|
+
|
|
42
|
+
### 5. Cobertura de testes
|
|
43
|
+
- Frameworks de teste identificados
|
|
44
|
+
- Estimativa de cobertura (contagem de arquivos `*.test.*`, `*.spec.*`)
|
|
45
|
+
|
|
46
|
+
### 6. Sugestão de organização das specs
|
|
47
|
+
|
|
48
|
+
Produza o campo `organization_suggestion` do `surface.json` aplicando as heurísticas abaixo na ordem em que aparecem. Pare na primeira heurística cujo sinal seja claramente dominante. Se nenhuma se aplicar, use o fallback `feature`.
|
|
49
|
+
|
|
50
|
+
| Sinal observado | Onde olhar | Sugestão |
|
|
51
|
+
|-----------------|------------|----------|
|
|
52
|
+
| Roteamento centralizado | `routes.*`, `urls.py`, `*Controller.cs`, `@RestController`, `app.get/post/...`, `Router()` | `endpoint` |
|
|
53
|
+
| Pastas top-level com nomes de domínio | `src/<dominio>/`, `app/<dominio>/`, `internal/<dominio>/` | `module` |
|
|
54
|
+
| Specs Gherkin / E2E orientadas a comportamento | `features/*.feature`, `*.spec.*` BDD, `cypress/e2e/*.cy.*` | `use-case` |
|
|
55
|
+
| Múltiplos sinais acima coexistindo com peso parecido | qualquer combinação de 2 ou mais | `hybrid` |
|
|
56
|
+
| Nenhum sinal claro | fallback | `feature` |
|
|
57
|
+
|
|
58
|
+
Para o caso `feature` (fallback), liste em `organization_suggestion.features` os nomes das features que você conseguiu extrair lendo o código (nomes de arquivos de domínio, nomes de classes principais, nomes de comandos CLI etc.).
|
|
59
|
+
|
|
60
|
+
Preencha sempre:
|
|
61
|
+
- `granularity` (um dos 5 valores acima, nunca `custom`)
|
|
62
|
+
- `rationale` em uma frase curta no idioma da instalação
|
|
63
|
+
- `signals` com `type` e `evidence` (lista de caminhos relativos que comprovam o sinal)
|
|
64
|
+
|
|
65
|
+
## Saída
|
|
66
|
+
|
|
67
|
+
**Em `_reversa_sdd/`:**
|
|
68
|
+
- `inventory.md` — inventário completo
|
|
69
|
+
- `dependencies.md` — dependências com versões
|
|
70
|
+
|
|
71
|
+
**Em `.reversa/context/`:**
|
|
72
|
+
- `surface.json` — dados estruturados para os demais agentes
|
|
73
|
+
|
|
74
|
+
## Checkpoint
|
|
75
|
+
|
|
76
|
+
Ao concluir, informe ao Reversa:
|
|
77
|
+
- Arquivos gerados (caminhos relativos)
|
|
78
|
+
- Resumo: linguagens, framework principal, módulos identificados
|
|
79
|
+
|
|
80
|
+
O Reversa salvará o checkpoint em `.reversa/state.json`.
|
|
81
|
+
|
|
82
|
+
Consulte o schema do `surface.json` em `references/surface-schema.md` antes de gerar o arquivo.
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
# Schema — .reversa/context/surface.json
|
|
2
|
+
|
|
3
|
+
Arquivo gerado pelo Scout. Usado pelos demais agentes como fonte de contexto estruturado.
|
|
4
|
+
|
|
5
|
+
## Estrutura completa
|
|
6
|
+
|
|
7
|
+
```json
|
|
8
|
+
{
|
|
9
|
+
"generated_at": "2026-04-26T10:00:00Z",
|
|
10
|
+
"project_root": "/caminho/do/projeto",
|
|
11
|
+
"languages": [
|
|
12
|
+
{ "name": "TypeScript", "extensions": [".ts", ".tsx"], "file_count": 142 },
|
|
13
|
+
{ "name": "JavaScript", "extensions": [".js", ".mjs"], "file_count": 23 }
|
|
14
|
+
],
|
|
15
|
+
"primary_language": "TypeScript",
|
|
16
|
+
"frameworks": [
|
|
17
|
+
{ "name": "Next.js", "version": "14.2.0", "source": "package.json" },
|
|
18
|
+
{ "name": "Prisma", "version": "5.10.0", "source": "package.json" }
|
|
19
|
+
],
|
|
20
|
+
"package_manager": "npm",
|
|
21
|
+
"entry_points": [
|
|
22
|
+
{ "path": "src/app/layout.tsx", "type": "app_entry" },
|
|
23
|
+
{ "path": "src/server.ts", "type": "server_entry" }
|
|
24
|
+
],
|
|
25
|
+
"config_files": [
|
|
26
|
+
"next.config.js", ".env.example", "tsconfig.json"
|
|
27
|
+
],
|
|
28
|
+
"ci_cd": [
|
|
29
|
+
".github/workflows/deploy.yml"
|
|
30
|
+
],
|
|
31
|
+
"docker": {
|
|
32
|
+
"dockerfile": "Dockerfile",
|
|
33
|
+
"compose": "docker-compose.yml"
|
|
34
|
+
},
|
|
35
|
+
"database_hints": [
|
|
36
|
+
{ "path": "prisma/schema.prisma", "type": "prisma_schema" },
|
|
37
|
+
{ "path": "prisma/migrations/", "type": "migrations_dir" }
|
|
38
|
+
],
|
|
39
|
+
"test_framework": "Jest",
|
|
40
|
+
"test_file_count": 47,
|
|
41
|
+
"modules": [
|
|
42
|
+
"auth", "orders", "payments", "users", "notifications"
|
|
43
|
+
],
|
|
44
|
+
"total_files": 312,
|
|
45
|
+
"organization_suggestion": {
|
|
46
|
+
"granularity": "module",
|
|
47
|
+
"rationale": "A estrutura de pastas top-level está organizada por domínio: auth/, orders/, payments/, users/, notifications/.",
|
|
48
|
+
"signals": [
|
|
49
|
+
{ "type": "top_level_domain_folders", "evidence": ["src/auth/", "src/orders/", "src/payments/"] }
|
|
50
|
+
],
|
|
51
|
+
"features": []
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
## Campos obrigatórios
|
|
57
|
+
|
|
58
|
+
`generated_at`, `languages`, `primary_language`, `frameworks`, `entry_points`, `modules`, `organization_suggestion`
|
|
59
|
+
|
|
60
|
+
## Campos opcionais
|
|
61
|
+
|
|
62
|
+
Todos os demais, inclua apenas o que for encontrado.
|
|
63
|
+
|
|
64
|
+
## Campo `organization_suggestion`
|
|
65
|
+
|
|
66
|
+
Sugestão de como organizar as specs deste projeto. Lido pelo orquestrador Reversa para pré-marcar a opção default no menu de organização das specs.
|
|
67
|
+
|
|
68
|
+
### Subcampos
|
|
69
|
+
|
|
70
|
+
| Campo | Tipo | Obrigatório | Descrição |
|
|
71
|
+
|-------|------|-------------|-----------|
|
|
72
|
+
| `granularity` | string | sim | Um de: `module`, `use-case`, `endpoint`, `hybrid`, `feature`, `custom`. O Scout nunca sugere `custom`, esse valor só vem da escolha do usuário. |
|
|
73
|
+
| `rationale` | string | sim | Frase curta explicando por que essa granularidade foi escolhida. Aparece no menu como "Razão:" do Scout. |
|
|
74
|
+
| `signals` | array | sim | Lista dos sinais detectados que levaram à sugestão. Cada item tem `type` e `evidence` (lista de caminhos). Pode ser vazia quando o fallback `feature` é usado. |
|
|
75
|
+
| `features` | array | sim quando `granularity = "feature"` | Lista de nomes de features descobertas pelo Scout. Cada nome vira uma pasta de primeiro nível. |
|
|
76
|
+
|
|
77
|
+
### Heurísticas para definir `granularity`
|
|
78
|
+
|
|
79
|
+
| Sinal detectado | `granularity` sugerida |
|
|
80
|
+
|-----------------|------------------------|
|
|
81
|
+
| Roteamento centralizado (`routes.*`, `urls.py`, `*Controller.cs`, `@RestController`) | `endpoint` |
|
|
82
|
+
| Pastas top-level com nomes de domínio (`auth/`, `orders/`, `payments/`) | `module` |
|
|
83
|
+
| Specs Gherkin / E2E orientadas a comportamento (`features/*.feature`, `*.spec.*` BDD) | `use-case` |
|
|
84
|
+
| Múltiplos sinais coexistindo com peso parecido | `hybrid` |
|
|
85
|
+
| Nenhum sinal claro de organização | `feature` (fallback, preencher `features` com o que foi possível extrair) |
|
|
86
|
+
|
|
87
|
+
### Imutabilidade
|
|
88
|
+
|
|
89
|
+
Após a primeira execução, o orquestrador persiste o `granularity` sugerido em `.reversa/config.toml` no campo `scout_suggestion`. Em re-execuções, o Scout pode regerar o `surface.json` (o legado pode ter mudado), mas o orquestrador NÃO atualiza o `scout_suggestion` em `config.toml` (RF-14 da spec de organização das specs).
|
|
90
|
+
|
|
91
|
+
## Nota
|
|
92
|
+
|
|
93
|
+
Use este schema como guia. Se um campo não se aplicar ao projeto, omita-o, exceto os obrigatórios listados acima.
|