@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,176 @@
|
|
|
1
|
+
# Paletas por Estilo Visual
|
|
2
|
+
|
|
3
|
+
Tabela das paletas usadas pelo selo, derivadas do estilo visual escolhido pelo usuário do `/reversa-documentation`.
|
|
4
|
+
|
|
5
|
+
Cada paleta tem 4 campos:
|
|
6
|
+
|
|
7
|
+
- `bg`: cor de fundo do canvas.
|
|
8
|
+
- `foreground`: lista de cores principais usadas pelo padrão (3 a 5 cores).
|
|
9
|
+
- `accent`: cor de destaque para elementos centrais (1 cor).
|
|
10
|
+
- `fg`: cor do texto do label fora do canvas.
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## Paleta: `sober`
|
|
15
|
+
|
|
16
|
+
Estilo sóbrio, técnico, neutro. Foco em legibilidade e atemporalidade.
|
|
17
|
+
|
|
18
|
+
```json
|
|
19
|
+
{
|
|
20
|
+
"bg": "#f5f3ee",
|
|
21
|
+
"foreground": ["#3d4a5c", "#7c8a99", "#a06b4a", "#4f6b5d", "#bdb4a4"],
|
|
22
|
+
"accent": "#1e2937",
|
|
23
|
+
"fg": "#1e2937"
|
|
24
|
+
}
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
Tradução visual:
|
|
28
|
+
- Fundo: papel quebrado.
|
|
29
|
+
- Foreground: azul-petróleo, cinza-pedra, terracota, verde-musgo, areia.
|
|
30
|
+
- Accent: azul-meia-noite profundo.
|
|
31
|
+
|
|
32
|
+
**Variante dark**: para uso em mini-selo sobre header escuro, espelhar (bg ↔ fg).
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## Paleta: `premium`
|
|
37
|
+
|
|
38
|
+
Estilo cinematográfico, luxuoso, dark. Foco em contraste e brilho.
|
|
39
|
+
|
|
40
|
+
```json
|
|
41
|
+
{
|
|
42
|
+
"bg": "#0a0a14",
|
|
43
|
+
"foreground": ["#d4af37", "#7a1c2a", "#b8b8b8", "#1e2b4f", "#3a3a4a"],
|
|
44
|
+
"accent": "#f4d03f",
|
|
45
|
+
"fg": "#eaeaea"
|
|
46
|
+
}
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
Tradução visual:
|
|
50
|
+
- Fundo: preto noite-azulada.
|
|
51
|
+
- Foreground: dourado, vermelho-vinho, prata, azul-meia-noite, cinza-fumaça.
|
|
52
|
+
- Accent: dourado claro (mais brilhante que o dourado base).
|
|
53
|
+
|
|
54
|
+
**Uso típico**: hero de apresentação executiva, selo de capa de documentação premium.
|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
58
|
+
## Paleta: `dense`
|
|
59
|
+
|
|
60
|
+
Estilo denso, saturado, alta densidade visual. Foco em distinção entre múltiplas categorias.
|
|
61
|
+
|
|
62
|
+
```json
|
|
63
|
+
{
|
|
64
|
+
"bg": "#f8f9fa",
|
|
65
|
+
"foreground": ["#ff7a3e", "#00c6c6", "#e93f8f", "#a3d930", "#5b3fce"],
|
|
66
|
+
"accent": "#1a1a2e",
|
|
67
|
+
"fg": "#1a1a2e"
|
|
68
|
+
}
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
Tradução visual:
|
|
72
|
+
- Fundo: branco gelo.
|
|
73
|
+
- Foreground: laranja, ciano, magenta, lima, índigo.
|
|
74
|
+
- Accent: preto-azulado.
|
|
75
|
+
|
|
76
|
+
**Uso típico**: documentação de sistema com muitos componentes para distinguir; selo cobre múltiplos hues.
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## Paleta: `exploratory`
|
|
81
|
+
|
|
82
|
+
Estilo exploratório, etéreo, luminoso. Foco em 3D e contemplação.
|
|
83
|
+
|
|
84
|
+
```json
|
|
85
|
+
{
|
|
86
|
+
"bg": "#0d0d1a",
|
|
87
|
+
"foreground": ["#ffb3ba", "#a0e7e5", "#c9b6e8", "#fff5b8", "#b8e0d2"],
|
|
88
|
+
"accent": "#ffffff",
|
|
89
|
+
"fg": "#eaeaea"
|
|
90
|
+
}
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
Tradução visual:
|
|
94
|
+
- Fundo: preto-violeta profundo.
|
|
95
|
+
- Foreground: rosa-aurora, ciano-glaciar, lilás-névoa, amarelo-suave, verde-aquoso.
|
|
96
|
+
- Accent: branco luz.
|
|
97
|
+
|
|
98
|
+
**Uso típico**: documentação com forte presença de cenas 3D; o selo dialoga com a estética da `arquitetura.html`.
|
|
99
|
+
|
|
100
|
+
---
|
|
101
|
+
|
|
102
|
+
## Paleta `other` (fallback)
|
|
103
|
+
|
|
104
|
+
Quando o usuário escolhe "Outro" no menu de estilo e fornece descrição livre, a skill mapeia a descrição para a paleta mais próxima, ou aplica heurística básica:
|
|
105
|
+
|
|
106
|
+
```javascript
|
|
107
|
+
function paletteFromFreeform(text) {
|
|
108
|
+
const lower = text.toLowerCase();
|
|
109
|
+
if (/(luxo|premium|cinematogr|dark)/.test(lower)) return palettes.premium;
|
|
110
|
+
if (/(t[ée]cnico|s[óo]brio|clean|minimal)/.test(lower)) return palettes.sober;
|
|
111
|
+
if (/(denso|saturado|colorido|vibra)/.test(lower)) return palettes.dense;
|
|
112
|
+
if (/(explora|3D|luminoso|et[ée]reo)/.test(lower)) return palettes.exploratory;
|
|
113
|
+
return palettes.sober; // fallback seguro
|
|
114
|
+
}
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
---
|
|
118
|
+
|
|
119
|
+
## Distribuição de cores dentro da paleta
|
|
120
|
+
|
|
121
|
+
Mesmo com 5 cores em `foreground`, o selo não usa todas igualmente. Regra de proporção visual:
|
|
122
|
+
|
|
123
|
+
| Posição na paleta | Proporção visual no selo |
|
|
124
|
+
|---|---|
|
|
125
|
+
| 1ª cor | 50% (dominante) |
|
|
126
|
+
| 2ª cor | 25% (secundária) |
|
|
127
|
+
| 3ª cor | 15% |
|
|
128
|
+
| 4ª cor | 7% |
|
|
129
|
+
| 5ª cor | 3% (vestígio) |
|
|
130
|
+
|
|
131
|
+
Padrões como `flow-field` e `wave-interference` herdam essa distribuição automaticamente (a cor 1 aparece em mais partículas).
|
|
132
|
+
|
|
133
|
+
Padrões como `crystal-lattice` usam cores em camadas distintas, mas as camadas mais visíveis (externas) usam as cores 1 e 2; camadas internas usam 3, 4, 5.
|
|
134
|
+
|
|
135
|
+
---
|
|
136
|
+
|
|
137
|
+
## Adaptação automática para mini-selo
|
|
138
|
+
|
|
139
|
+
Em mini-selos (<200px), a paleta é simplificada para 3 cores apenas:
|
|
140
|
+
|
|
141
|
+
```javascript
|
|
142
|
+
function simplifyForMini(palette) {
|
|
143
|
+
return {
|
|
144
|
+
...palette,
|
|
145
|
+
foreground: palette.foreground.slice(0, 3)
|
|
146
|
+
};
|
|
147
|
+
}
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
Mantém legibilidade e impacto visual mesmo em tamanho reduzido.
|
|
151
|
+
|
|
152
|
+
---
|
|
153
|
+
|
|
154
|
+
## Verificação de contraste
|
|
155
|
+
|
|
156
|
+
Antes de renderizar, verificar que `accent` tem contraste suficiente com `bg` para padrões que destacam centro (ratio mínimo 4.5:1 conforme WCAG AA).
|
|
157
|
+
|
|
158
|
+
```javascript
|
|
159
|
+
function contrastRatio(hex1, hex2) {
|
|
160
|
+
const lum = (hex) => {
|
|
161
|
+
const { r, g, b } = hexToRgb(hex);
|
|
162
|
+
const sRGB = [r, g, b].map((c) => {
|
|
163
|
+
const v = c / 255;
|
|
164
|
+
return v <= 0.03928 ? v / 12.92 : ((v + 0.055) / 1.055) ** 2.4;
|
|
165
|
+
});
|
|
166
|
+
return 0.2126 * sRGB[0] + 0.7152 * sRGB[1] + 0.0722 * sRGB[2];
|
|
167
|
+
};
|
|
168
|
+
const l1 = lum(hex1);
|
|
169
|
+
const l2 = lum(hex2);
|
|
170
|
+
const lighter = Math.max(l1, l2);
|
|
171
|
+
const darker = Math.min(l1, l2);
|
|
172
|
+
return (lighter + 0.05) / (darker + 0.05);
|
|
173
|
+
}
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
Se o contraste falhar, substituir `accent` por uma versão mais clara/escura derivada automaticamente.
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-simplify
|
|
3
|
+
description: 'Simplificação algorítmica: troca lógica complexa por solução mais simples e clara, sem mudar o resultado, com prova de equivalência. Foca clareza, não custo de recurso (isso é /reversa-optimize).'
|
|
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 simplificador. Sua missão é trocar uma lógica complexa por uma solução mais simples e clara, sem mudar o resultado. Seu objetivo primário é reduzir a complexidade cognitiva de quem lê a lógica; costuma reduzir também o custo de recurso, mas isso é efeito colateral, não a meta.
|
|
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`, `safety_net_policy`). 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-simplify OPP-...`): resolva no `opportunities/` do contexto
|
|
27
|
+
2. Sem argumento: aceite um alvo natural, resolva o contexto, crie a oportunidade `simplify` se preciso
|
|
28
|
+
3. Se o alvo real é ganho de desempenho medido (não clareza da lógica), reencaminhe a `/reversa-optimize`
|
|
29
|
+
|
|
30
|
+
## Modo de controle
|
|
31
|
+
|
|
32
|
+
Siga o `control_mode` do README (`gated` por padrão): análise e prova fluem; todo passo que toca o código passa por gate com diff.
|
|
33
|
+
|
|
34
|
+
## Rede de segurança e equivalência (obrigatórias antes de tocar o código)
|
|
35
|
+
|
|
36
|
+
1. Exija testes que fixem a saída do alvo; sem cobertura, ofereça testes de caracterização verdes antes de simplificar
|
|
37
|
+
2. **Equivalência de saída**: comprove que o algoritmo simples produz a mesma saída para o mesmo conjunto de entradas, incluindo edge cases (vazio, nulo, limites, concorrência). Simplificar que muda um edge case não é simplificação, é bug
|
|
38
|
+
3. Recusada a rede, rebaixe para 🔴 e registre a ausência de prova
|
|
39
|
+
|
|
40
|
+
## Preservação de comportamento
|
|
41
|
+
|
|
42
|
+
Consulte `<output_folder>/soul.md` e as specs confirmadas. Uma lógica complexa às vezes esconde uma regra de negócio confirmada (caso especial que existe por um motivo). Antes de simplificar, verifique se a complexidade é acidental (dá para remover) ou essencial (a regra exige). Complexidade essencial não é simplificada; é documentada.
|
|
43
|
+
|
|
44
|
+
## Fluxo
|
|
45
|
+
|
|
46
|
+
1. Descreva a lógica atual e por que ela é complexa (aninhamento, ramos redundantes, estado desnecessário)
|
|
47
|
+
2. Proponha a solução mais simples e mostre que ela cobre os mesmos casos
|
|
48
|
+
3. Quando simplicidade e desempenho conflitarem, deixe a escolha explícita para o usuário no gate em vez de decidir sozinho
|
|
49
|
+
4. Gere `transformations/OPP-.../plan.html` autocontido: lógica hoje, por que é acidentalmente complexa, solução proposta, tabela de casos (entrada -> saída) provando equivalência. Peça aprovação antes de tocar arquivo
|
|
50
|
+
5. **Gate**: mostre o diff (antes/depois), aguarde aprovação, aplique
|
|
51
|
+
6. **Prove**: rode a rede de segurança e cole a saída verde. Vermelho, reverta pelo diff
|
|
52
|
+
|
|
53
|
+
## Persistência
|
|
54
|
+
|
|
55
|
+
Grave em `transformations/OPP-.../`: `transformation.md` (schema em `../reversa-refactor/references/opportunity-schema.md`, com `preservation.method: equivalence-proof` e `measurement` da complexidade cognitiva antes/depois quando aplicável), `CHG-NNN.diff`, evidência em `before-after/` e `safety-net/`. Atualize `state` e views. Escrita atômica.
|
|
56
|
+
|
|
57
|
+
## Relatório final ao usuário
|
|
58
|
+
|
|
59
|
+
1. Lógica antes e depois, e por que a nova é mais simples
|
|
60
|
+
2. Prova de equivalência de saída (tabela de casos, incluindo edge cases)
|
|
61
|
+
3. Caminhos: pasta da transformação, diffs, evidência
|
|
62
|
+
|
|
63
|
+
Termine com:
|
|
64
|
+
|
|
65
|
+
> Digite **CONTINUAR** para a próxima oportunidade, ou volte ao `/reversa-refactor`.
|
|
66
|
+
|
|
67
|
+
## Regra absoluta
|
|
68
|
+
|
|
69
|
+
**Nunca apague, modifique ou sobrescreva código do projeto sem gate aprovado.** Fora do gate, escreve só em `_reversa_refactor/`. O resultado nunca muda; complexidade essencial exigida por regra confirmada não é removida.
|
|
70
|
+
|
|
71
|
+
## Política de edição do legado
|
|
72
|
+
|
|
73
|
+
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):
|
|
74
|
+
|
|
75
|
+
- 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).
|
|
76
|
+
- `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.
|
|
77
|
+
- `allowLegacyEdits: true` sem `allowedPaths`: liberado; avise uma vez por sessão que a liberação é irrestrita.
|
|
78
|
+
- 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.
|
|
79
|
+
- Deleção de arquivo pré-existente liberado: confirme com o usuário antes, listando o arquivo.
|
|
@@ -0,0 +1,278 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-spec-sdd
|
|
3
|
+
description: 'Agente final do time Code New Project: decompõe um PRD em componentes e gera specs SDD por componente com score de qualidade (0 a 100) e análise de gaps, lendo `_reversa_sdd/prd.md`. Também avalia specs existentes. Faz handoff para /reversa-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
|
+
team: newproject
|
|
12
|
+
stage: spec-sdd
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# reversa-spec-sdd, Spec-Driven Development no Reversa
|
|
16
|
+
|
|
17
|
+
Esta skill conduz o processo completo de SDD dentro do pipeline Code New Project Agents: **decompor → redigir → avaliar → iterar** até cada spec estar pronta para o ciclo forward.
|
|
18
|
+
|
|
19
|
+
A skill é uma versão vendored da `sdd-spec` global, adaptada para o contexto Reversa: lê `prd.md` como fonte primária, escreve em `_reversa_sdd/sdd/`, marca tudo com selo 🟡 e termina com handoff para `/reversa-forward`.
|
|
20
|
+
|
|
21
|
+
## Por que SDD?
|
|
22
|
+
|
|
23
|
+
Specs escritas antes do código economizam tempo porque:
|
|
24
|
+
|
|
25
|
+
- Tornam ambiguidades visíveis antes de virarem bugs
|
|
26
|
+
- Alinham expectativas entre quem pede e quem implementa
|
|
27
|
+
- Servem de referência permanente para testes, revisões e onboarding
|
|
28
|
+
- Permitem que LLMs implementem com muito mais precisão
|
|
29
|
+
|
|
30
|
+
A metodologia aqui é **RFC Pragmático mais LLM-First**: estruturada como um RFC (Problem / Goals / Design / Edge Cases), mas otimizada para ser consumida por humanos e por agentes de IA.
|
|
31
|
+
|
|
32
|
+
## Antes de começar
|
|
33
|
+
|
|
34
|
+
1. Leia `.reversa/state.json` para `user_name`, `chat_language`, `doc_language`, `output_folder` (padrão `_reversa_sdd`).
|
|
35
|
+
2. Verifique pré-condição: **`<output_folder>/prd.md` deve existir**. Se ausente, encerre com mensagem clara:
|
|
36
|
+
> "Não encontrei `<output_folder>/prd.md`. Rode `/reversa-drafter` primeiro, ou invoque `/reversa-new` para conduzir o pipeline completo."
|
|
37
|
+
3. Garanta que a pasta `<output_folder>/sdd/` existe. Crie se ausente.
|
|
38
|
+
|
|
39
|
+
## Output path padrão
|
|
40
|
+
|
|
41
|
+
Cada spec gerada vai para:
|
|
42
|
+
|
|
43
|
+
```
|
|
44
|
+
<output_folder>/sdd/<componente-kebab-case>.md
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
Por exemplo: `_reversa_sdd/sdd/user-authentication.md`, `_reversa_sdd/sdd/payment-checkout.md`.
|
|
48
|
+
|
|
49
|
+
O componente é decomposto a partir do `prd.md` na primeira fase.
|
|
50
|
+
|
|
51
|
+
## Selo 🟡 obrigatório
|
|
52
|
+
|
|
53
|
+
Todos os itens das specs geradas pelo `reversa-spec-sdd` devem usar o selo **🟡 PLANEJADO** (variante de 🟡 INFERIDO usado em outros contextos do Reversa). O selo 🟢 CONFIRMADO é reservado para fatos extraídos de código existente pelo Time de Descoberta, regra herdada para evitar confusão entre "fato do legado" e "hipótese forward".
|
|
54
|
+
|
|
55
|
+
Cada requisito, comportamento, edge case e critério de aceite das specs deve começar com 🟡.
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
## Fluxo de trabalho
|
|
60
|
+
|
|
61
|
+
### Fase 0, Decomposição em componentes
|
|
62
|
+
|
|
63
|
+
Leia `<output_folder>/prd.md` na íntegra. A partir das seções "Escopo", "Personas-alvo" e "Critérios de aceite", proponha uma decomposição do produto em componentes lógicos. Cada componente deve representar uma unidade coesa que vai virar uma spec SDD individual.
|
|
64
|
+
|
|
65
|
+
Apresente a decomposição ao usuário:
|
|
66
|
+
|
|
67
|
+
> "Pelo PRD, identifiquei estes componentes lógicos:
|
|
68
|
+
>
|
|
69
|
+
> 1. **<componente 1>**: <descrição em uma frase>
|
|
70
|
+
> 2. **<componente 2>**: <descrição em uma frase>
|
|
71
|
+
> 3. **<componente N>**: ...
|
|
72
|
+
>
|
|
73
|
+
> Concorda com essa decomposição? Quer adicionar, remover ou renomear algum?"
|
|
74
|
+
|
|
75
|
+
Aguarde resposta. Itere até confirmação (máximo 2 ajustes). Para cada componente confirmado, normalize o nome em kebab-case ASCII.
|
|
76
|
+
|
|
77
|
+
### Fase 1, Entrevista por componente (opcional)
|
|
78
|
+
|
|
79
|
+
Para cada componente, decida se a informação no `prd.md` já basta:
|
|
80
|
+
|
|
81
|
+
- **Basta:** vá direto para Fase 2.
|
|
82
|
+
- **Falta:** faça no máximo 3 perguntas focadas, cobrindo os pontos abaixo que estiverem ausentes:
|
|
83
|
+
1. **O problema específico daquele componente:** "Qual o papel do `<componente>` no produto?"
|
|
84
|
+
2. **O sucesso:** "Como você saberá que esse componente funcionou? O que o usuário consegue fazer?"
|
|
85
|
+
3. **Escopo:** "O que está explicitamente FORA do escopo desse componente?"
|
|
86
|
+
4. **Edge cases:** "Já consegue antecipar casos difíceis ou situações de erro nesse componente?"
|
|
87
|
+
|
|
88
|
+
Limite total: 3 perguntas por componente, escolhendo as mais críticas.
|
|
89
|
+
|
|
90
|
+
### Fase 2, Redigir a spec
|
|
91
|
+
|
|
92
|
+
Use o template em `references/spec_template.md` como base. Preencha **todas** as seções:
|
|
93
|
+
|
|
94
|
+
- **Requisitos funcionais:** formato `RF-01`, `RF-02`. Cada um testável isoladamente. Selo 🟡 obrigatório.
|
|
95
|
+
- **Comportamentos:** descreva o que acontece, não como implementar. A spec define o **quê**, não o **como**.
|
|
96
|
+
- **Ambiguidade zero:** se não tiver certeza, marque com `⚠️ ABERTO:` e adicione à lista de Open Questions.
|
|
97
|
+
- **LLM-readiness:** escreva como se um desenvolvedor ou LLM fosse implementar sem perguntar nada.
|
|
98
|
+
- **Selo 🟡 em todos os itens da spec**, incluindo RFs, edge cases, critérios.
|
|
99
|
+
|
|
100
|
+
Use `<doc_language>` no conteúdo das specs.
|
|
101
|
+
|
|
102
|
+
### Fase 3, Avaliação automática de qualidade
|
|
103
|
+
|
|
104
|
+
Após redigir cada spec, execute o scorer.
|
|
105
|
+
|
|
106
|
+
**Detecção de Python:** tente `python --version` ou `python3 --version` via shell.
|
|
107
|
+
|
|
108
|
+
- **Se Python disponível:**
|
|
109
|
+
|
|
110
|
+
```
|
|
111
|
+
python scripts/spec_scorer.py --spec <output_folder>/sdd/<componente>.md
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
Use a saída literal do script.
|
|
115
|
+
|
|
116
|
+
- **Se Python não disponível (modo manual):** aplique o procedimento da seção "Scoring em engines sem Python" mais abaixo.
|
|
117
|
+
|
|
118
|
+
O scoring retorna:
|
|
119
|
+
|
|
120
|
+
- **Score total** (0 a 100) com breakdown por dimensão
|
|
121
|
+
- **Gaps críticos** que precisam de resolução
|
|
122
|
+
- **Sugestões** ordenadas por impacto
|
|
123
|
+
|
|
124
|
+
Dimensões avaliadas (ver `references/evaluation_rubric.md` para detalhes):
|
|
125
|
+
|
|
126
|
+
| Dimensão | Peso | O que avalia |
|
|
127
|
+
|---|---|---|
|
|
128
|
+
| Completude | 30% | Todas as seções preenchidas, requisitos cobertos |
|
|
129
|
+
| Testabilidade | 25% | Requisitos verificáveis, critérios de aceite claros |
|
|
130
|
+
| Clareza | 20% | Ausência de ambiguidades, linguagem precisa |
|
|
131
|
+
| Escopo | 15% | Non-goals definidos, limites claros |
|
|
132
|
+
| Edge Cases | 10% | Casos de erro e limites do sistema cobertos |
|
|
133
|
+
|
|
134
|
+
### Fase 4, Iteração
|
|
135
|
+
|
|
136
|
+
Com base no score:
|
|
137
|
+
|
|
138
|
+
1. Score **≥ 80**: spec pronta. Persista e siga para o próximo componente.
|
|
139
|
+
2. Score **60 a 79**: corrija os gaps óbvios automaticamente, depois confirme com o usuário se faltou algo crítico. Refaça scoring.
|
|
140
|
+
3. Score **< 60**: volte para Fase 1 com perguntas focadas nos gaps. Refaça scoring.
|
|
141
|
+
|
|
142
|
+
Limite: **3 iterações por componente**. Após 3 tentativas, persista com o score atual e adicione seção `## Pendências de qualidade` no arquivo.
|
|
143
|
+
|
|
144
|
+
A cada iteração, mostre o delta: "subiu de 54 para 71, faltam 2 gaps críticos".
|
|
145
|
+
|
|
146
|
+
### Fase 5, Persistência e handoff
|
|
147
|
+
|
|
148
|
+
Para cada componente concluído:
|
|
149
|
+
|
|
150
|
+
1. Escreva `<output_folder>/sdd/<componente-kebab-case>.md` com escrita atômica (tempfile mais rename), UTF-8 sem BOM.
|
|
151
|
+
2. Inclua no final do arquivo o **relatório de avaliação** (score + gaps + sugestões).
|
|
152
|
+
3. Se o arquivo já existir, pergunte ao usuário se quer sobrescrever.
|
|
153
|
+
|
|
154
|
+
Após gerar **todas** as specs, exiba relatório consolidado:
|
|
155
|
+
|
|
156
|
+
> "`<user_name>`, geração SDD concluída. Specs criadas em `<output_folder>/sdd/`:
|
|
157
|
+
>
|
|
158
|
+
> | Componente | Caminho | Score | Iterações |
|
|
159
|
+
> |---|---|---|---|
|
|
160
|
+
> | <comp1> | <output_folder>/sdd/<comp1>.md | 87 | 1 |
|
|
161
|
+
> | <comp2> | <output_folder>/sdd/<comp2>.md | 73 | 2 |
|
|
162
|
+
> | <comp3> | <output_folder>/sdd/<comp3>.md | 68 | 3 (com pendências) |
|
|
163
|
+
>
|
|
164
|
+
> Todos os itens marcados com selo 🟡 (planejado).
|
|
165
|
+
>
|
|
166
|
+
> Próximo passo: rodar `/reversa-forward`, que vai consumir essas specs e iniciar o ciclo de evolução até o código.
|
|
167
|
+
>
|
|
168
|
+
> Digite **CONTINUAR** para iniciar `/reversa-forward`, ou pause aqui."
|
|
169
|
+
|
|
170
|
+
Nunca prossiga automaticamente.
|
|
171
|
+
|
|
172
|
+
---
|
|
173
|
+
|
|
174
|
+
## Scoring em engines sem Python
|
|
175
|
+
|
|
176
|
+
Quando `python --version` e `python3 --version` falham, ative o modo manual:
|
|
177
|
+
|
|
178
|
+
1. **Leia `references/evaluation_rubric.md`** para os critérios de cada dimensão.
|
|
179
|
+
2. Para cada uma das 5 dimensões, avalie a spec mentalmente e atribua nota 0 a 100, justificando em 1 a 2 frases:
|
|
180
|
+
|
|
181
|
+
- **Completude (30%):** todas as 9 seções obrigatórias preenchidas? RFs cobrem o escopo declarado?
|
|
182
|
+
- **Testabilidade (25%):** RFs são verificáveis isoladamente? Critérios de aceite têm formato Dado/Quando/Então ou equivalente?
|
|
183
|
+
- **Clareza (20%):** há frases vagas (intuitivo, rápido, fácil)? Há contradições?
|
|
184
|
+
- **Escopo (15%):** non-goals declarados explicitamente? Limites claros?
|
|
185
|
+
- **Edge cases (10%):** pelo menos 3 casos de erro/limite cobertos?
|
|
186
|
+
|
|
187
|
+
3. **Calcule o score ponderado:**
|
|
188
|
+
|
|
189
|
+
```
|
|
190
|
+
score = (Completude * 0.30) + (Testabilidade * 0.25) + (Clareza * 0.20)
|
|
191
|
+
+ (Escopo * 0.15) + (Edge Cases * 0.10)
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
4. **Liste os gaps** em ordem de criticidade (bloqueadores, importantes, melhorias).
|
|
195
|
+
|
|
196
|
+
5. **Renderize a saída** no mesmo formato do script:
|
|
197
|
+
|
|
198
|
+
```
|
|
199
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
200
|
+
SCORE TOTAL: <NN>/100
|
|
201
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
202
|
+
|
|
203
|
+
Breakdown:
|
|
204
|
+
Completude: <NN>/100 (peso 30%)
|
|
205
|
+
Testabilidade: <NN>/100 (peso 25%)
|
|
206
|
+
Clareza: <NN>/100 (peso 20%)
|
|
207
|
+
Escopo: <NN>/100 (peso 15%)
|
|
208
|
+
Edge Cases: <NN>/100 (peso 10%)
|
|
209
|
+
|
|
210
|
+
Gaps críticos:
|
|
211
|
+
- <gap 1>
|
|
212
|
+
- <gap 2>
|
|
213
|
+
|
|
214
|
+
Sugestões (por impacto):
|
|
215
|
+
1. <sugestão>
|
|
216
|
+
2. <sugestão>
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
O resultado em modo manual deve ser equivalente ao do script para uma mesma spec.
|
|
220
|
+
|
|
221
|
+
---
|
|
222
|
+
|
|
223
|
+
## Modo: avaliação de spec existente
|
|
224
|
+
|
|
225
|
+
Se o usuário invocar `/reversa-spec-sdd` fora do pipeline `/reversa-new`, com uma spec já escrita para avaliação:
|
|
226
|
+
|
|
227
|
+
1. Pergunte o caminho do arquivo.
|
|
228
|
+
2. Execute scoring (script ou manual).
|
|
229
|
+
3. Apresente score com análise detalhada por dimensão.
|
|
230
|
+
4. Liste gaps em ordem de criticidade.
|
|
231
|
+
5. Pergunte se quer que você corrija os pontos apontados.
|
|
232
|
+
|
|
233
|
+
Esse modo não exige `prd.md` nem entra no pipeline. É uma utilidade avulsa herdada da skill original.
|
|
234
|
+
|
|
235
|
+
---
|
|
236
|
+
|
|
237
|
+
## Arquivos de referência
|
|
238
|
+
|
|
239
|
+
| Arquivo | Quando usar |
|
|
240
|
+
|---|---|
|
|
241
|
+
| `references/spec_template.md` | Template completo com todas as seções, use como base para redigir |
|
|
242
|
+
| `references/evaluation_rubric.md` | Critérios detalhados de avaliação por dimensão |
|
|
243
|
+
| `references/sdd_guide.md` | Princípios da metodologia e boas práticas |
|
|
244
|
+
| `assets/spec_examples.md` | Exemplos de spec boa vs. ruim com anotações |
|
|
245
|
+
| `scripts/spec_scorer.py` | Script de scoring automático, usado quando Python está disponível |
|
|
246
|
+
|
|
247
|
+
---
|
|
248
|
+
|
|
249
|
+
## Sinais de uma spec ruim (evite)
|
|
250
|
+
|
|
251
|
+
- Requisitos que não podem ser testados ("o sistema deve ser intuitivo")
|
|
252
|
+
- Seção de escopo ausente ou vaga ("vamos ver o que faz sentido")
|
|
253
|
+
- Misturar design técnico de implementação com comportamento esperado
|
|
254
|
+
- Requisitos contraditórios não sinalizados
|
|
255
|
+
- Nenhum critério de aceite definido
|
|
256
|
+
- Edge cases de erro completamente ausentes
|
|
257
|
+
|
|
258
|
+
## Sinais de uma spec boa (busque)
|
|
259
|
+
|
|
260
|
+
- Qualquer desenvolvedor pode implementar sem fazer perguntas
|
|
261
|
+
- Qualquer QA pode escrever testes a partir dela
|
|
262
|
+
- Os non-goals estão tão claros quanto os goals
|
|
263
|
+
- Casos de erro têm comportamento definido
|
|
264
|
+
- Cada requisito tem um ID único rastreável
|
|
265
|
+
|
|
266
|
+
---
|
|
267
|
+
|
|
268
|
+
## Regra absoluta
|
|
269
|
+
|
|
270
|
+
Escreva apenas em `<output_folder>/sdd/`. Nunca toque em arquivos do projeto fora dessa pasta. Em sobrescrita, sempre peça confirmação `sim/não`.
|
|
271
|
+
|
|
272
|
+
## Saída final
|
|
273
|
+
|
|
274
|
+
Após gerar todas as specs do PRD, termine sempre com:
|
|
275
|
+
|
|
276
|
+
> Digite **CONTINUAR** para prosseguir com `/reversa-forward`, ou pause aqui.
|
|
277
|
+
|
|
278
|
+
Nunca prossiga automaticamente.
|