@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,120 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"$id": "reversa-pricing-size-v1.1",
|
|
4
|
+
"title": "Reversa Pricing Size",
|
|
5
|
+
"description": "Métricas estruturais e score de tamanho de uma feature, gerado pelo agente reversa-pricing-size e consumido pelo agente reversa-pricing-estimate.",
|
|
6
|
+
"type": "object",
|
|
7
|
+
"additionalProperties": false,
|
|
8
|
+
"required": [
|
|
9
|
+
"schema_version",
|
|
10
|
+
"formula_version",
|
|
11
|
+
"created_at",
|
|
12
|
+
"feature_dir",
|
|
13
|
+
"metrics",
|
|
14
|
+
"sizing_method",
|
|
15
|
+
"base_complexity_class",
|
|
16
|
+
"risk_points",
|
|
17
|
+
"risk_adjustment_classes",
|
|
18
|
+
"size_score",
|
|
19
|
+
"complexity_class"
|
|
20
|
+
],
|
|
21
|
+
"properties": {
|
|
22
|
+
"schema_version": {
|
|
23
|
+
"type": "string",
|
|
24
|
+
"const": "1.1"
|
|
25
|
+
},
|
|
26
|
+
"formula_version": {
|
|
27
|
+
"type": "string",
|
|
28
|
+
"pattern": "^\\d+\\.\\d+$"
|
|
29
|
+
},
|
|
30
|
+
"created_at": {
|
|
31
|
+
"type": "string",
|
|
32
|
+
"format": "date-time"
|
|
33
|
+
},
|
|
34
|
+
"feature_dir": {
|
|
35
|
+
"type": "string",
|
|
36
|
+
"minLength": 1
|
|
37
|
+
},
|
|
38
|
+
"metrics": {
|
|
39
|
+
"type": "object",
|
|
40
|
+
"additionalProperties": false,
|
|
41
|
+
"required": ["requirements", "doubts", "tasks", "plan_depth", "principles_touched"],
|
|
42
|
+
"properties": {
|
|
43
|
+
"requirements": {
|
|
44
|
+
"type": "object",
|
|
45
|
+
"additionalProperties": false,
|
|
46
|
+
"required": ["total"],
|
|
47
|
+
"properties": {
|
|
48
|
+
"total": { "type": "integer", "minimum": 0 },
|
|
49
|
+
"functional": { "type": "integer", "minimum": 0 },
|
|
50
|
+
"non_functional": { "type": "integer", "minimum": 0 },
|
|
51
|
+
"constraint": { "type": "integer", "minimum": 0 }
|
|
52
|
+
}
|
|
53
|
+
},
|
|
54
|
+
"doubts": {
|
|
55
|
+
"type": "object",
|
|
56
|
+
"additionalProperties": false,
|
|
57
|
+
"required": ["total"],
|
|
58
|
+
"properties": {
|
|
59
|
+
"total": { "type": "integer", "minimum": 0 },
|
|
60
|
+
"high": { "type": "integer", "minimum": 0 },
|
|
61
|
+
"medium": { "type": "integer", "minimum": 0 },
|
|
62
|
+
"low": { "type": "integer", "minimum": 0 }
|
|
63
|
+
}
|
|
64
|
+
},
|
|
65
|
+
"tasks": {
|
|
66
|
+
"type": "object",
|
|
67
|
+
"additionalProperties": false,
|
|
68
|
+
"required": ["total"],
|
|
69
|
+
"properties": {
|
|
70
|
+
"total": { "type": "integer", "minimum": 0 },
|
|
71
|
+
"new": { "type": "integer", "minimum": 0 },
|
|
72
|
+
"modify": { "type": "integer", "minimum": 0 },
|
|
73
|
+
"delete": { "type": "integer", "minimum": 0 },
|
|
74
|
+
"test": { "type": "integer", "minimum": 0 },
|
|
75
|
+
"infra": { "type": "integer", "minimum": 0 }
|
|
76
|
+
}
|
|
77
|
+
},
|
|
78
|
+
"plan_depth": {
|
|
79
|
+
"type": "integer",
|
|
80
|
+
"minimum": 0,
|
|
81
|
+
"maximum": 10
|
|
82
|
+
},
|
|
83
|
+
"principles_touched": {
|
|
84
|
+
"type": "array",
|
|
85
|
+
"items": { "type": "string", "minLength": 1 },
|
|
86
|
+
"uniqueItems": true
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
},
|
|
90
|
+
"sizing_method": {
|
|
91
|
+
"type": "string",
|
|
92
|
+
"const": "task_tshirt_with_risk_adjustment"
|
|
93
|
+
},
|
|
94
|
+
"base_complexity_class": {
|
|
95
|
+
"type": "string",
|
|
96
|
+
"enum": ["S", "M", "L", "XL", "XXL"]
|
|
97
|
+
},
|
|
98
|
+
"risk_points": {
|
|
99
|
+
"type": "integer",
|
|
100
|
+
"minimum": 0
|
|
101
|
+
},
|
|
102
|
+
"risk_adjustment_classes": {
|
|
103
|
+
"type": "integer",
|
|
104
|
+
"minimum": 0,
|
|
105
|
+
"maximum": 2
|
|
106
|
+
},
|
|
107
|
+
"size_score": {
|
|
108
|
+
"type": "integer",
|
|
109
|
+
"minimum": 0,
|
|
110
|
+
"maximum": 100
|
|
111
|
+
},
|
|
112
|
+
"complexity_class": {
|
|
113
|
+
"type": "string",
|
|
114
|
+
"enum": ["S", "M", "L", "XL", "XXL"]
|
|
115
|
+
},
|
|
116
|
+
"notes": {
|
|
117
|
+
"type": "string"
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
}
|
|
@@ -0,0 +1,183 @@
|
|
|
1
|
+
# Formula de dimensionamento (sizing-formula.md)
|
|
2
|
+
|
|
3
|
+
**Versao da formula:** 2.0
|
|
4
|
+
**Versao do schema do size.json:** 1.1
|
|
5
|
+
|
|
6
|
+
Documenta o calculo deterministico que o agente `reversa-pricing-size` aplica para transformar os artefatos do ciclo forward em uma classe de complexidade (`S/M/L/XL/XXL`). A formula v2 abandona a soma linear de pesos arbitrarios e passa a usar T-shirt sizing baseado em tasks, com ajuste separado de risco.
|
|
7
|
+
|
|
8
|
+
## Fonte e criterio
|
|
9
|
+
|
|
10
|
+
O Reversa v1 precisa de uma medida compreensivel para usuario leigo, multi-engine e derivada dos arquivos ja produzidos em `_reversa_sdd/forward/<feature>/`.
|
|
11
|
+
|
|
12
|
+
Function Points (IFPUG, ISO/IEC 20926) e COSMIC (ISO/IEC 19761) sao padroes formais de medicao funcional, mas exigem classificacao especializada. Para a UX do Reversa, a melhor base e estimativa agil aproximada, inspirada em Story Points e T-shirt sizing. Mike Cohn, em *Agile Estimating and Planning* (Addison-Wesley, 2005), descreve estimativas relativas e tamanhos aproximados como praticas de planejamento agil.
|
|
13
|
+
|
|
14
|
+
Esta formula nao afirma que as faixas sao padrao universal. Ela documenta uma heuristica simples do Reversa, com base em T-shirt sizing, e mantem os fatores de risco separados para evitar falsa precisao.
|
|
15
|
+
|
|
16
|
+
## Entradas
|
|
17
|
+
|
|
18
|
+
As entradas continuam vindo de `metrics`:
|
|
19
|
+
|
|
20
|
+
- `tasks.total`
|
|
21
|
+
- `doubts.high`, `doubts.medium`, `doubts.low`, `doubts.total`
|
|
22
|
+
- `plan_depth`
|
|
23
|
+
- `principles_touched`
|
|
24
|
+
- `requirements.total`, usado apenas como alerta de consistencia, nao como driver primario
|
|
25
|
+
|
|
26
|
+
## Passo 1: classe base por quantidade de tasks
|
|
27
|
+
|
|
28
|
+
`tasks.total` e a melhor proxy de tamanho porque o ciclo forward ja quebrou a feature em unidades de trabalho.
|
|
29
|
+
|
|
30
|
+
```
|
|
31
|
+
if tasks.total <= 0: base_complexity_class = "S"
|
|
32
|
+
elif tasks.total <= 3: base_complexity_class = "S"
|
|
33
|
+
elif tasks.total <= 7: base_complexity_class = "M"
|
|
34
|
+
elif tasks.total <= 15: base_complexity_class = "L"
|
|
35
|
+
elif tasks.total <= 30: base_complexity_class = "XL"
|
|
36
|
+
else: base_complexity_class = "XXL"
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Passo 2: pontos de risco
|
|
40
|
+
|
|
41
|
+
Risco nao e tamanho. Ele ajusta a classe para cima quando a feature tem incerteza, profundidade ou impacto transversal.
|
|
42
|
+
|
|
43
|
+
```
|
|
44
|
+
unclassified_doubts =
|
|
45
|
+
max(0, doubts.total - doubts.high - doubts.medium - doubts.low)
|
|
46
|
+
|
|
47
|
+
risk_points =
|
|
48
|
+
doubts.high * 2 +
|
|
49
|
+
doubts.medium * 1 +
|
|
50
|
+
unclassified_doubts * 1 +
|
|
51
|
+
max(0, plan_depth - 3) +
|
|
52
|
+
floor(len(principles_touched) / 3)
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
`doubts.low` nao sobe risco na v2. Duvida baixa e ruido esperado de refinamento.
|
|
56
|
+
|
|
57
|
+
## Passo 3: ajuste de risco
|
|
58
|
+
|
|
59
|
+
```
|
|
60
|
+
if risk_points <= 2: risk_adjustment_classes = 0
|
|
61
|
+
elif risk_points <= 5: risk_adjustment_classes = 1
|
|
62
|
+
else: risk_adjustment_classes = 2
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
## Passo 4: classe final
|
|
66
|
+
|
|
67
|
+
Classes sao ordenadas assim:
|
|
68
|
+
|
|
69
|
+
```
|
|
70
|
+
S=0, M=1, L=2, XL=3, XXL=4
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
```
|
|
74
|
+
complexity_class =
|
|
75
|
+
class_from_index(min(4, index(base_complexity_class) + risk_adjustment_classes))
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
## Passo 5: size_score auxiliar
|
|
79
|
+
|
|
80
|
+
`size_score` fica apenas para compatibilidade e leitura rapida. Ele nao deve mais dirigir horas diretamente.
|
|
81
|
+
|
|
82
|
+
```
|
|
83
|
+
size_score_by_class:
|
|
84
|
+
S: 15
|
|
85
|
+
M: 35
|
|
86
|
+
L: 60
|
|
87
|
+
XL: 80
|
|
88
|
+
XXL: 95
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
## Campos recomendados no size.json
|
|
92
|
+
|
|
93
|
+
O agente deve gravar estes campos alem dos campos antigos:
|
|
94
|
+
|
|
95
|
+
```
|
|
96
|
+
sizing_method = "task_tshirt_with_risk_adjustment"
|
|
97
|
+
base_complexity_class = <classe antes do risco>
|
|
98
|
+
risk_points = <inteiro>
|
|
99
|
+
risk_adjustment_classes = <0, 1 ou 2>
|
|
100
|
+
size_score = <midpoint auxiliar da classe final>
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
## Exemplos de calculo
|
|
104
|
+
|
|
105
|
+
### Exemplo 1: feature pequena (S)
|
|
106
|
+
|
|
107
|
+
```
|
|
108
|
+
tasks.total = 3
|
|
109
|
+
doubts.high = 0
|
|
110
|
+
doubts.medium = 0
|
|
111
|
+
doubts.low = 0
|
|
112
|
+
doubts.total = 0
|
|
113
|
+
plan_depth = 2
|
|
114
|
+
principles_touched = []
|
|
115
|
+
|
|
116
|
+
base_complexity_class = S
|
|
117
|
+
risk_points = 0
|
|
118
|
+
risk_adjustment_classes = 0
|
|
119
|
+
complexity_class = S
|
|
120
|
+
size_score = 15
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
### Exemplo 2: feature media que sobe para L por risco
|
|
124
|
+
|
|
125
|
+
```
|
|
126
|
+
tasks.total = 7
|
|
127
|
+
doubts.total = 3 (high=1, medium=2, low=0)
|
|
128
|
+
plan_depth = 3
|
|
129
|
+
principles_touched = ["non_destructive", "multi_engine", "handoff_pattern"]
|
|
130
|
+
|
|
131
|
+
base_complexity_class = M
|
|
132
|
+
risk_points = 1*2 + 2*1 + 0 + 0 + floor(3/3) = 5
|
|
133
|
+
risk_adjustment_classes = 1
|
|
134
|
+
complexity_class = L
|
|
135
|
+
size_score = 60
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
### Exemplo 3: feature grande (XL)
|
|
139
|
+
|
|
140
|
+
```
|
|
141
|
+
tasks.total = 12
|
|
142
|
+
doubts.total = 1 (high=0, medium=1, low=0)
|
|
143
|
+
plan_depth = 4
|
|
144
|
+
principles_touched = 2
|
|
145
|
+
|
|
146
|
+
base_complexity_class = L
|
|
147
|
+
risk_points = 0 + 1 + 0 + 1 + 0 = 2
|
|
148
|
+
risk_adjustment_classes = 0
|
|
149
|
+
complexity_class = L
|
|
150
|
+
size_score = 60
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
### Exemplo 4: feature gigante (XXL)
|
|
154
|
+
|
|
155
|
+
```
|
|
156
|
+
tasks.total = 31
|
|
157
|
+
doubts.total = 6 (high=2, medium=3, low=1)
|
|
158
|
+
plan_depth = 6
|
|
159
|
+
principles_touched = 8
|
|
160
|
+
|
|
161
|
+
base_complexity_class = XXL
|
|
162
|
+
risk_points = 2*2 + 3*1 + 0 + 3 + floor(8/3) = 12
|
|
163
|
+
risk_adjustment_classes = 2
|
|
164
|
+
complexity_class = XXL
|
|
165
|
+
size_score = 95
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
## Alertas de consistencia
|
|
169
|
+
|
|
170
|
+
Requisitos nao entram no calculo primario, mas podem gerar nota:
|
|
171
|
+
|
|
172
|
+
```
|
|
173
|
+
if requirements.total >= 12 and tasks.total <= 3:
|
|
174
|
+
notes += "Muitos requisitos para poucas tasks. Verifique se tasks.md esta granular o bastante."
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
## Limites e premissas
|
|
178
|
+
|
|
179
|
+
1. A formula mede tamanho estrutural antes do coding, portanto nao usa LOC
|
|
180
|
+
2. Tokens nao sao contados
|
|
181
|
+
3. `size_score` e auxiliar, nao deve ser convertido diretamente em horas
|
|
182
|
+
4. XXL deve gerar recomendacao de quebrar escopo antes de precificar ou codar
|
|
183
|
+
5. Se mudar limite de classe, bump em `formula_version`
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-principles
|
|
3
|
+
description: Cria ou atualiza os princípios duradouros do projeto e propaga sugestões de ajuste nos templates dependentes. Princípios são raros, mudam pouco e influenciam todos os artefatos. Pode rodar antes mesmo da primeira feature.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
license: MIT
|
|
6
|
+
compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
|
|
7
|
+
metadata:
|
|
8
|
+
author: sandeco
|
|
9
|
+
version: "1.0.0"
|
|
10
|
+
framework: reversa
|
|
11
|
+
phase: forward
|
|
12
|
+
stage: principles
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
Você é o guardião dos princípios. Esse skill lida com regras duradouras do projeto, separadas dos requisitos específicos de cada feature. Princípios mudam pouco e influenciam todos os outros artefatos.
|
|
16
|
+
|
|
17
|
+
Esse skill é raro, frequência tipicamente menor que uma vez por mês. Ele NÃO faz parte do pipeline `requirements`, `plan`, `to-do`, `coding`. Pode rodar sozinho, antes mesmo da primeira feature.
|
|
18
|
+
|
|
19
|
+
## Antes de começar
|
|
20
|
+
|
|
21
|
+
1. Leia `.reversa/state.json` para resolver `output_folder` e `forward_folder`
|
|
22
|
+
2. Use os valores reais nos lugares onde o texto mencionar `_reversa_sdd/` ou `_reversa_forward/`
|
|
23
|
+
|
|
24
|
+
## Verificações Iniciais
|
|
25
|
+
|
|
26
|
+
1. Tente ler `.reversa/principles.md`
|
|
27
|
+
1.1. Se ausente, modo é `criar`
|
|
28
|
+
1.2. Se presente, modo é `atualizar`
|
|
29
|
+
2. Aplique `before-principles` da forma padrão
|
|
30
|
+
|
|
31
|
+
## Modo criar
|
|
32
|
+
|
|
33
|
+
1. Carregue `.reversa/templates/principles-template.md`
|
|
34
|
+
2. Pergunte ao usuário pelos princípios candidatos, em batch ou um a um
|
|
35
|
+
3. Para cada princípio:
|
|
36
|
+
3.1. Atribua numeração romana sequencial (I, II, III, ...)
|
|
37
|
+
3.2. Pergunte por título curto, descrição e um exemplo concreto de aplicação
|
|
38
|
+
3.3. Registre data de criação
|
|
39
|
+
4. Liste, na seção "Impacto", quais templates serão afetados quando o princípio mudar (sempre `requirements-template.md`, `roadmap-template.md`, e potencialmente `actions-template.md`)
|
|
40
|
+
5. Inicie a seção "Histórico de Alterações" com a entrada inicial
|
|
41
|
+
|
|
42
|
+
## Modo atualizar
|
|
43
|
+
|
|
44
|
+
1. Apresente ao usuário a lista atual de princípios numerados
|
|
45
|
+
2. Pergunte qual operação ele quer:
|
|
46
|
+
2.1. Adicionar novo (continua na próxima numeração romana, jamais recicla)
|
|
47
|
+
2.2. Alterar texto de um existente (mantém numeração, registra alteração no histórico)
|
|
48
|
+
2.3. Aposentar um (NÃO apaga, marca como `aposentado em YYYY-MM-DD` e move para o final do documento)
|
|
49
|
+
3. Após a operação:
|
|
50
|
+
3.1. Atualize a seção "Impacto" se necessário
|
|
51
|
+
3.2. Adicione entrada à "Histórico de Alterações"
|
|
52
|
+
|
|
53
|
+
## Propagação de impacto
|
|
54
|
+
|
|
55
|
+
1. Para cada template listado na seção "Impacto":
|
|
56
|
+
1.1. Leia o template em `.reversa/templates/<nome>`
|
|
57
|
+
1.2. Verifique se o template precisa de novo placeholder ou seção para refletir o princípio
|
|
58
|
+
1.3. NUNCA reescreva o template inteiro automaticamente, gere apenas um relatório de impacto em `.reversa/principles-impact-YYYYMMDD.md`
|
|
59
|
+
2. O relatório lista, por template, sugestões textuais de ajuste
|
|
60
|
+
3. Aplicar essas sugestões é decisão do humano, esse skill só sugere
|
|
61
|
+
|
|
62
|
+
## Persistência
|
|
63
|
+
|
|
64
|
+
- Grave `.reversa/principles.md` com escrita atômica
|
|
65
|
+
- Grave o relatório de impacto em `.reversa/principles-impact-YYYYMMDD.md`
|
|
66
|
+
- Jamais sobrescreva relatórios de impacto antigos, cada execução cria um arquivo datado
|
|
67
|
+
|
|
68
|
+
## Ganchos Pós-execução
|
|
69
|
+
|
|
70
|
+
Aplique `after-principles` da forma padrão.
|
|
71
|
+
|
|
72
|
+
## Relatório final ao usuário
|
|
73
|
+
|
|
74
|
+
1. Caminho absoluto de `principles.md`
|
|
75
|
+
2. Lista de princípios ativos, com numeração e título curto
|
|
76
|
+
3. Lista de princípios aposentados, se houver
|
|
77
|
+
4. Caminho do relatório de impacto gerado
|
|
78
|
+
5. Aviso: princípios novos ou alterados só passam a valer em features iniciadas após essa data
|
|
79
|
+
|
|
80
|
+
Termine com:
|
|
81
|
+
|
|
82
|
+
> Digite **CONTINUAR** para prosseguir com a próxima ação que desejar.
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-prune
|
|
3
|
+
description: 'Remoção de código morto: só remove o que provar ser morto (sem referência estática nem entrada dinâmica), distinguindo morto de órfão suspeito e conferindo contra a alma. Reversível pelo diff.'
|
|
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 podador. Sua missão é remover código morto, e só o que PROVAR ser morto. Código sem uso aparente engana: pode ter entrada dinâmica, pode implementar uma regra confirmada que ainda não foi religada. Na dúvida, você não remove: você sinaliza.
|
|
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-prune OPP-...`): resolva no `opportunities/` do contexto
|
|
27
|
+
2. Sem argumento: aceite um alvo natural, resolva o contexto, crie a oportunidade `prune` se preciso
|
|
28
|
+
|
|
29
|
+
## Modo de controle
|
|
30
|
+
|
|
31
|
+
Siga o `control_mode` do README (`gated` por padrão). Remover código tem gate obrigatório em QUALQUER modo, inclusive autonomous.
|
|
32
|
+
|
|
33
|
+
## Prova de morte (o critério deste agente)
|
|
34
|
+
|
|
35
|
+
Um candidato só é **morto** se cumprir as duas condições:
|
|
36
|
+
|
|
37
|
+
1. **Sem referência estática**: nenhum ponto do código o chama, importa ou referencia (varredura completa de usos, não amostra)
|
|
38
|
+
2. **Sem entrada dinâmica conhecida**: não é alcançado por rota, evento, reflexão, meta-programação, carregamento por string, configuração, cron ou feature flag que possa religar
|
|
39
|
+
|
|
40
|
+
Classifique cada candidato:
|
|
41
|
+
|
|
42
|
+
- **morto**: cumpre as duas condições, com a prova anexada -> elegível para remoção
|
|
43
|
+
- **órfão suspeito**: sem referência estática, mas com possível entrada dinâmica -> fica no relatório com `promoted_to: null`, NUNCA é removido automaticamente
|
|
44
|
+
|
|
45
|
+
Para linguagens com forte entrada dinâmica (reflexão, meta-programação), eleve o rigor: na dúvida, é órfão suspeito, não morto.
|
|
46
|
+
|
|
47
|
+
## Conferência contra a alma (trava dura)
|
|
48
|
+
|
|
49
|
+
Antes de marcar qualquer coisa como morta, confira contra `<output_folder>/soul.md` e as specs confirmadas. **Código que implementa uma regra de negócio confirmada nunca é morto**, mesmo que pareça sem uso: pode ser um caminho temporariamente desligado. Nesse caso, é órfão suspeito e o relatório aponta a regra que ele serve.
|
|
50
|
+
|
|
51
|
+
## Fluxo
|
|
52
|
+
|
|
53
|
+
1. Levante os candidatos e produza a prova de morte de cada um (evidência da varredura de usos + checagem de entradas dinâmicas + conferência com a alma)
|
|
54
|
+
2. Gere `transformations/OPP-.../plan.html` autocontido: candidatos, classificação (morto x órfão suspeito), a prova por trecho, e o que NÃO será removido e por quê. Peça aprovação antes de remover
|
|
55
|
+
3. **Gate**: mostre o diff de remoção com a prova anexada por trecho, aguarde aprovação, aplique. Só remove os classificados como mortos
|
|
56
|
+
4. **Confirme**: se houver suíte de testes, rode e cole a saída verde. A remoção é sempre revertível pelo `CHG-NNN.diff`
|
|
57
|
+
|
|
58
|
+
## Persistência
|
|
59
|
+
|
|
60
|
+
Grave em `transformations/OPP-.../`: `transformation.md` (schema em `../reversa-refactor/references/opportunity-schema.md`, com `preservation.method: death-proof` e a prova em `before-after/`), `CHG-NNN.diff`. Os órfãos suspeitos ficam registrados na oportunidade com `promoted_to: null`. Atualize `state` e views. Escrita atômica.
|
|
61
|
+
|
|
62
|
+
## Relatório final ao usuário
|
|
63
|
+
|
|
64
|
+
1. Removidos: o que saiu, com a prova de morte por trecho
|
|
65
|
+
2. Órfãos suspeitos: o que NÃO foi removido e por que (entrada dinâmica ou regra da alma)
|
|
66
|
+
3. Confirmação de suíte verde (se houver) e o caminho de reversão
|
|
67
|
+
4. Caminhos: pasta da transformação, diffs, provas
|
|
68
|
+
|
|
69
|
+
Termine com:
|
|
70
|
+
|
|
71
|
+
> Digite **CONTINUAR** para a próxima oportunidade, ou volte ao `/reversa-refactor`.
|
|
72
|
+
|
|
73
|
+
## Regra absoluta
|
|
74
|
+
|
|
75
|
+
**Nunca remova código sem gate aprovado e sem prova de morte anexada.** Fora do gate, escreve só em `_reversa_refactor/`. Na dúvida, não remove: sinaliza como órfão suspeito. Regra de negócio confirmada nunca é tratada como morta.
|
|
76
|
+
|
|
77
|
+
## Política de edição do legado
|
|
78
|
+
|
|
79
|
+
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):
|
|
80
|
+
|
|
81
|
+
- 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).
|
|
82
|
+
- `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.
|
|
83
|
+
- `allowLegacyEdits: true` sem `allowedPaths`: liberado; avise uma vez por sessão que a liberação é irrestrita.
|
|
84
|
+
- 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.
|
|
85
|
+
- Deleção de arquivo pré-existente liberado: confirme com o usuário antes, listando o arquivo.
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-quality
|
|
3
|
+
description: Auditoria de clareza textual do requirements. Verifica se a prosa é boa o bastante para gerar plano sem ambiguidade. NÃO mistura com auditoria de testes de implementação. Etapa opcional do ciclo forward.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
license: MIT
|
|
6
|
+
compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
|
|
7
|
+
metadata:
|
|
8
|
+
author: sandeco
|
|
9
|
+
version: "1.0.0"
|
|
10
|
+
framework: reversa
|
|
11
|
+
phase: forward
|
|
12
|
+
stage: quality
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
Você é o revisor textual. Sua missão é checar se o `requirements.md` da feature ativa está bem escrito, completo e coerente o bastante para virar plano e código sem retrabalho. Esse skill é puramente leitor sobre o `requirements.md`. A única escrita permitida é o relatório de auditoria.
|
|
16
|
+
|
|
17
|
+
Esse skill avalia QUALIDADE DE ESCRITA, não COBERTURA DE TESTES de implementação. Se você sentir vontade de incluir item como "verificar se o botão funciona", pare, esse item NÃO pertence aqui.
|
|
18
|
+
|
|
19
|
+
## Antes de começar
|
|
20
|
+
|
|
21
|
+
1. Leia `.reversa/state.json` para resolver `output_folder` e `forward_folder`
|
|
22
|
+
2. Use os valores reais nos lugares onde o texto mencionar `_reversa_sdd/` ou `_reversa_forward/`
|
|
23
|
+
|
|
24
|
+
## Verificações Iniciais
|
|
25
|
+
|
|
26
|
+
1. Leia `.reversa/active-requirements.json`
|
|
27
|
+
1.1. Se ausente, aborte
|
|
28
|
+
2. Verifique a existência de `feature-dir/requirements.md`
|
|
29
|
+
3. Aplique `before-quality` da forma padrão
|
|
30
|
+
|
|
31
|
+
## Categorias da auditoria
|
|
32
|
+
|
|
33
|
+
Cada item do relatório se encaixa em uma destas categorias:
|
|
34
|
+
|
|
35
|
+
| Categoria | Pergunta-guia |
|
|
36
|
+
|-----------|---------------|
|
|
37
|
+
| Clareza | Cada frase tem um sujeito, um verbo e um significado único? |
|
|
38
|
+
| Completude | Todas as seções obrigatórias do template estão preenchidas? |
|
|
39
|
+
| Consistência | Termos do glossário do projeto são usados sempre da mesma forma? |
|
|
40
|
+
| Cobertura de cenários | Casos felizes, casos tristes e edge cases aparecem em Gherkin? |
|
|
41
|
+
| Edge cases | Limites numéricos, vazios, nulos, concorrência foram considerados? |
|
|
42
|
+
| Ausência de jargão | A escrita seria entendida por um humano novo no time? |
|
|
43
|
+
| Ausência de solução implícita | O texto descreve o quê, não o como (sem nome de biblioteca, sem framework) |
|
|
44
|
+
| Alinhamento com princípios | Cada regra do requirements respeita `.reversa/principles.md` |
|
|
45
|
+
|
|
46
|
+
## Como gerar os itens
|
|
47
|
+
|
|
48
|
+
1. Carregue o template `.reversa/templates/quality-template.md`
|
|
49
|
+
2. Para cada categoria, gere de uma a cinco perguntas avaliativas baseadas no conteúdo real do `requirements.md`
|
|
50
|
+
3. Total entre dez e trinta itens
|
|
51
|
+
4. Cada item segue formato `- [ ] Q-NNN | <categoria> | <pergunta>`
|
|
52
|
+
5. Após avaliar, marque `[X]` os aprovados, `[ ]` os reprovados
|
|
53
|
+
6. Para reprovados, adicione linha extra `> motivo: <razão objetiva>`
|
|
54
|
+
7. Para reprovados que poderiam ser auto-corrigidos pelo redator, adicione linha extra `> sugestão: <texto curto>`
|
|
55
|
+
|
|
56
|
+
## Veredito final
|
|
57
|
+
|
|
58
|
+
Ao final do relatório, emita uma de três classificações:
|
|
59
|
+
|
|
60
|
+
- **Aprovado**, todos os itens passaram
|
|
61
|
+
- **Aprovado com ressalvas**, até três itens reprovados, nenhum CRITICAL
|
|
62
|
+
- **Reprovado**, mais de três itens reprovados, ou pelo menos um CRITICAL (cobertura de cenários ausente, princípio violado, contradição interna)
|
|
63
|
+
|
|
64
|
+
## Persistência
|
|
65
|
+
|
|
66
|
+
- Crie `feature-dir/audit/` se não existir
|
|
67
|
+
- Grave `requirements-audit.md` com escrita atômica
|
|
68
|
+
- Sempre rewrite completo
|
|
69
|
+
|
|
70
|
+
## Ganchos Pós-execução
|
|
71
|
+
|
|
72
|
+
Aplique `after-quality` da forma padrão.
|
|
73
|
+
|
|
74
|
+
## Relatório final ao usuário
|
|
75
|
+
|
|
76
|
+
1. Caminho absoluto de `requirements-audit.md`
|
|
77
|
+
2. Veredito (Aprovado, Aprovado com ressalvas, Reprovado)
|
|
78
|
+
3. Top três itens reprovados, com motivo, se houver
|
|
79
|
+
4. Aviso explícito: o `requirements.md` NÃO foi modificado
|
|
80
|
+
5. Sugestão de próximo passo:
|
|
81
|
+
5.1. Aprovado, sugerir `/reversa-plan`
|
|
82
|
+
5.2. Aprovado com ressalvas, sugerir `/reversa-clarify`
|
|
83
|
+
5.3. Reprovado, sugerir reescrita manual ou nova execução de `/reversa-requirements`
|
|
84
|
+
|
|
85
|
+
Termine com:
|
|
86
|
+
|
|
87
|
+
> Digite **CONTINUAR** para prosseguir conforme a sugestão acima.
|