@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,41 @@
|
|
|
1
|
+
> Cópia local do catálogo consultivo. Fonte canônica em `templates/migration/catalogs/migration_strategies.md`.
|
|
2
|
+
|
|
3
|
+
# Migration Strategies (cópia local)
|
|
4
|
+
|
|
5
|
+
## Estratégias
|
|
6
|
+
|
|
7
|
+
### Strangler Fig
|
|
8
|
+
- **Quando aplica**: sistema em produção, não pode parar; necessidade de incrementalidade; possibilidade de roteamento (proxy / API gateway).
|
|
9
|
+
- **Custo**: médio. **Risco**: baixo. **Tempo**: longo.
|
|
10
|
+
- **Apetite favorecido**: conservative, balanced.
|
|
11
|
+
|
|
12
|
+
### Big Bang
|
|
13
|
+
- **Quando aplica**: sistema pequeno; janela tolerada; apetite transformacional; poucas integrações vivas.
|
|
14
|
+
- **Custo**: baixo. **Risco**: alto. **Tempo**: curto.
|
|
15
|
+
- **Apetite favorecido**: transformational (em sistemas pequenos).
|
|
16
|
+
|
|
17
|
+
### Parallel Run
|
|
18
|
+
- **Quando aplica**: lógica crítica (financeiro / fiscal / regulatório); precisa de prova de equivalência por longo período.
|
|
19
|
+
- **Custo**: alto. **Risco**: médio. **Tempo**: médio.
|
|
20
|
+
- **Apetite favorecido**: balanced.
|
|
21
|
+
|
|
22
|
+
### Branch by Abstraction
|
|
23
|
+
- **Quando aplica**: migração interna (linguagem ou framework muda, domínio fica); apetite conservador.
|
|
24
|
+
- **Custo**: baixo. **Risco**: baixo. **Tempo**: médio.
|
|
25
|
+
- **Apetite favorecido**: conservative.
|
|
26
|
+
|
|
27
|
+
## Regras de recomendação
|
|
28
|
+
|
|
29
|
+
- apetite `conservative` → Branch by Abstraction + Strangler Fig.
|
|
30
|
+
- apetite `balanced` → Strangler Fig + Parallel Run.
|
|
31
|
+
- apetite `transformational` → Big Bang em sistemas pequenos; Strangler Fig com bordas profundas em maiores.
|
|
32
|
+
- mudança grande de paradigma + apetite transformacional → recomendar Parallel Run para validar paridade.
|
|
33
|
+
- sistema com integrações regulatórias → nunca recomendar Big Bang.
|
|
34
|
+
|
|
35
|
+
## Pseudo-procedimento
|
|
36
|
+
|
|
37
|
+
1. Filtrar estratégias aplicáveis com base em brief.
|
|
38
|
+
2. Pontuar restantes por aderência ao apetite e gap de paradigma.
|
|
39
|
+
3. Selecionar 2 a 3 candidatas.
|
|
40
|
+
4. Marcar uma como recomendada com justificativa.
|
|
41
|
+
5. Para cada outra, listar contras como motivo de não-recomendação.
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: cutover_plan
|
|
7
|
+
producedBy: strategist
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Cutover Plan
|
|
12
|
+
|
|
13
|
+
> Plano de corte do legado para o sistema novo, alinhado à estratégia escolhida em `migration_strategy.md`.
|
|
14
|
+
|
|
15
|
+
## Estratégia base
|
|
16
|
+
- **Estratégia confirmada**: <referência ao migration_strategy.md>
|
|
17
|
+
|
|
18
|
+
## Pré-requisitos
|
|
19
|
+
- [ ] <pré-requisito 1: ex. paridade comportamental ≥ X% por N dias>
|
|
20
|
+
- [ ] <pré-requisito 2>
|
|
21
|
+
- [ ] <pré-requisito 3>
|
|
22
|
+
|
|
23
|
+
## Janela de cutover
|
|
24
|
+
- **Data alvo**: <ISO-8601 ou janela>
|
|
25
|
+
- **Duração estimada**: <horas>
|
|
26
|
+
- **Ambiente afetado**: <produção / staging / outro>
|
|
27
|
+
- **Comunicação prévia**: <stakeholders avisados, prazo>
|
|
28
|
+
|
|
29
|
+
## Passos do cutover
|
|
30
|
+
|
|
31
|
+
| # | Passo | Owner | Duração | Reversível? |
|
|
32
|
+
|---|---|---|---|---|
|
|
33
|
+
| 1 | <ex: congelar escritas no legado> | | | |
|
|
34
|
+
| 2 | <ex: ETL final dos dados> | | | |
|
|
35
|
+
| 3 | <ex: roteamento DNS> | | | |
|
|
36
|
+
| 4 | <ex: smoke tests no novo> | | | |
|
|
37
|
+
|
|
38
|
+
## Plano de rollback
|
|
39
|
+
- **Critérios de acionamento**: <quando rollback é decidido>
|
|
40
|
+
- **Passos**:
|
|
41
|
+
1. <passo>
|
|
42
|
+
2. <passo>
|
|
43
|
+
- **Tempo máximo aceitável até rollback**: <minutos / horas>
|
|
44
|
+
- **Owner do rollback**: <nome / papel>
|
|
45
|
+
|
|
46
|
+
## Critérios de go / no-go
|
|
47
|
+
- **Go**:
|
|
48
|
+
- <critério 1>
|
|
49
|
+
- <critério 2>
|
|
50
|
+
- **No-go**:
|
|
51
|
+
- <critério 1>
|
|
52
|
+
- <critério 2>
|
|
53
|
+
|
|
54
|
+
## Pós-cutover
|
|
55
|
+
- [ ] Monitoramento estendido por <período>
|
|
56
|
+
- [ ] Validação de paridade conforme `parity_specs.md`
|
|
57
|
+
- [ ] Decommission do legado em <data>
|
|
58
|
+
|
|
59
|
+
## Notas
|
|
60
|
+
<Observações adicionais.>
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: migration_strategy
|
|
7
|
+
producedBy: strategist
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Migration Strategy
|
|
12
|
+
|
|
13
|
+
> Estratégias de migração avaliadas com trade-offs explícitos. A estratégia recomendada é a sugestão do Strategist; a decisão final é humana.
|
|
14
|
+
|
|
15
|
+
## Estratégias avaliadas
|
|
16
|
+
|
|
17
|
+
### Estratégia A: <nome>
|
|
18
|
+
- **Descrição**: <texto curto>
|
|
19
|
+
- **Quando aplica**: <critérios>
|
|
20
|
+
- **Custo**: baixo | médio | alto
|
|
21
|
+
- **Risco**: baixo | médio | alto
|
|
22
|
+
- **Tempo**: curto | médio | longo
|
|
23
|
+
- **Adequação ao apetite derivado** (`<conservative | balanced | transformational>`): <texto>
|
|
24
|
+
- **Trade-offs**:
|
|
25
|
+
- Prós: <lista>
|
|
26
|
+
- Contras: <lista>
|
|
27
|
+
|
|
28
|
+
### Estratégia B: <nome>
|
|
29
|
+
<mesma estrutura>
|
|
30
|
+
|
|
31
|
+
### Estratégia C: <nome>
|
|
32
|
+
<opcional, se mais de duas forem relevantes>
|
|
33
|
+
|
|
34
|
+
## Comparativo
|
|
35
|
+
|
|
36
|
+
| Critério | A | B | C |
|
|
37
|
+
|---|---|---|---|
|
|
38
|
+
| Custo | | | |
|
|
39
|
+
| Risco | | | |
|
|
40
|
+
| Tempo | | | |
|
|
41
|
+
| Aderência ao apetite | | | |
|
|
42
|
+
| Compatibilidade com mudança de paradigma | | | |
|
|
43
|
+
|
|
44
|
+
## Recomendação do Strategist
|
|
45
|
+
- **Estratégia recomendada**: <A | B | C>
|
|
46
|
+
- **Justificativa**: <texto baseado em brief + paradigma + apetite>
|
|
47
|
+
|
|
48
|
+
## Sinais de alerta específicos
|
|
49
|
+
- <ex: mudança grande de paradigma + apetite transformacional → considerar Parallel Run para validação>
|
|
50
|
+
|
|
51
|
+
## Decisão humana
|
|
52
|
+
- **Estratégia escolhida**: <A | B | C>
|
|
53
|
+
- **Quem decidiu**: <nome>
|
|
54
|
+
- **Quando**: <ISO-8601>
|
|
55
|
+
- **Justificativa do decisor**: <texto livre>
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: risk_register
|
|
7
|
+
producedBy: strategist
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Risk Register
|
|
12
|
+
|
|
13
|
+
> Registro de riscos da migração com probabilidade, impacto, mitigação e responsável.
|
|
14
|
+
|
|
15
|
+
## Riscos
|
|
16
|
+
|
|
17
|
+
### RISK-001
|
|
18
|
+
- **Descrição**: <texto>
|
|
19
|
+
- **Categoria**: técnico | operacional | organizacional | regulatório | financeiro
|
|
20
|
+
- **Probabilidade**: baixa | média | alta
|
|
21
|
+
- **Impacto**: baixo | médio | alto | crítico
|
|
22
|
+
- **Severidade combinada**: <calculada a partir dos dois acima>
|
|
23
|
+
- **Trigger / sinal de alerta**: <o que indicaria que o risco está se materializando>
|
|
24
|
+
- **Mitigação**: <ações concretas>
|
|
25
|
+
- **Plano de contingência**: <se mitigação falhar>
|
|
26
|
+
- **Owner**: <nome / papel>
|
|
27
|
+
- **Status**: aberto | mitigando | aceito | encerrado
|
|
28
|
+
|
|
29
|
+
<repetir por risco>
|
|
30
|
+
|
|
31
|
+
## Resumo por severidade
|
|
32
|
+
|
|
33
|
+
| Severidade | Quantidade | IDs |
|
|
34
|
+
|---|---|---|
|
|
35
|
+
| Crítica | | |
|
|
36
|
+
| Alta | | |
|
|
37
|
+
| Média | | |
|
|
38
|
+
| Baixa | | |
|
|
39
|
+
|
|
40
|
+
## Riscos relacionados ao paradigma alvo
|
|
41
|
+
|
|
42
|
+
> Subseção dedicada quando há mudança de paradigma. Listar apenas riscos cuja origem direta é o gap registrado em `paradigm_decision.md`.
|
|
43
|
+
|
|
44
|
+
- <RISK-XXX: descrição>
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-sync
|
|
3
|
+
description: 'Convergência pós-coding do Reversa: destila a feature entregue num adendo em `_reversa_sdd/addenda/`, mantendo a extração representativa entre re-extrações, sem tocar nos artefatos originais. Passo opcional do ciclo forward após /reversa-coding.'
|
|
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: sync
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
Você é o sincronizador. Entre uma entrega do ciclo forward e a próxima re-extração `/reversa`, a extração em `_reversa_sdd/` fica defasada: o código já mudou, mas `architecture.md` e `domain.md` continuam descrevendo o sistema anterior. Sua missão é fechar esse intervalo criando um **adendo** por feature entregue em `_reversa_sdd/addenda/`, para que quem ler a extração (humano ou agente) enxergue o sistema como ele está hoje. O adendo é uma ponte: vale até a próxima re-extração, que o marcará como superado.
|
|
16
|
+
|
|
17
|
+
## Antes de começar
|
|
18
|
+
|
|
19
|
+
1. Leia `.reversa/state.json` para resolver `output_folder` e `forward_folder`
|
|
20
|
+
2. Use os valores reais nos lugares onde o texto mencionar `_reversa_sdd/` ou `_reversa_forward/`
|
|
21
|
+
|
|
22
|
+
## Verificações Iniciais
|
|
23
|
+
|
|
24
|
+
1. Leia `.reversa/active-requirements.json`
|
|
25
|
+
1.1. Se ausente, aborte com mensagem apontando `/reversa-requirements`
|
|
26
|
+
2. Verifique a existência de `feature-dir/legacy-impact.md`
|
|
27
|
+
2.1. Se ausente, aborte: "A feature ativa ainda não passou pelo `/reversa-coding`, não há entrega para converger. Rode `/reversa-coding` primeiro."
|
|
28
|
+
3. Detecte o cenário da entrega:
|
|
29
|
+
3.1. **Legado:** `_reversa_sdd/` contém `architecture.md` E `domain.md`
|
|
30
|
+
3.2. **Greenfield:** o cabeçalho de `legacy-impact.md` registra "Feature greenfield", ou `_reversa_sdd/` contém `prd.md` E specs em `_reversa_sdd/sdd/` (sem a âncora de legado)
|
|
31
|
+
4. Se `feature-dir/actions.md` ainda tiver ações `[ ]` abertas, apresente o menu antes de prosseguir:
|
|
32
|
+
|
|
33
|
+
```
|
|
34
|
+
A feature ativa ainda tem <N> ação(ões) aberta(s) em actions.md.
|
|
35
|
+
|
|
36
|
+
[1] Sincronizar parcial: gera o adendo com o que já foi entregue, uma reexecução futura complementa
|
|
37
|
+
[2] Aguardar: encerrar agora e voltar depois que /reversa-coding fechar todas as ações
|
|
38
|
+
[3] Outro: descreva o que você prefere fazer
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
Aguarde a escolha. Não decida sozinho.
|
|
42
|
+
5. Aplique `before-sync` da forma padrão
|
|
43
|
+
|
|
44
|
+
## Fontes de leitura
|
|
45
|
+
|
|
46
|
+
Leia, pulando o que não existir:
|
|
47
|
+
|
|
48
|
+
1. `feature-dir/legacy-impact.md` (obrigatório, fonte principal do delta)
|
|
49
|
+
2. `feature-dir/regression-watch.md` (IDs dos watch items criados)
|
|
50
|
+
3. `feature-dir/requirements.md` (objetivo e requisitos da feature)
|
|
51
|
+
4. `feature-dir/progress.jsonl` (contagem de ações executadas)
|
|
52
|
+
5. Os artefatos da extração citados no `legacy-impact.md`, apenas para conferir nomes de seções ao montar os apontadores
|
|
53
|
+
|
|
54
|
+
## Geração do adendo
|
|
55
|
+
|
|
56
|
+
Caminho: `_reversa_sdd/addenda/<feature-id>-<short-name>.md` (mesmo nome da pasta da feature em `_reversa_forward/`). Crie a pasta `addenda/` se ainda não existir.
|
|
57
|
+
|
|
58
|
+
Estrutura do arquivo:
|
|
59
|
+
|
|
60
|
+
1. Cabeçalho com título, identificador da feature, data ISO 8601 e cenário (`legado` ou `greenfield`)
|
|
61
|
+
2. Seção `## Vigência` contendo, na criação, uma única linha:
|
|
62
|
+
|
|
63
|
+
```
|
|
64
|
+
Vigente desde YYYY-MM-DD.
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
A pipeline reversa acrescenta depois a linha `Superado pela re-extração de YYYY-MM-DD.` quando `/reversa` rodar de novo. Um adendo é **vigente** enquanto não houver linha de superação. Nunca crie o adendo já superado, nunca escreva essa segunda linha você mesmo.
|
|
68
|
+
3. Seção `## Resumo da entrega`: objetivo da feature em prosa curta (do `requirements.md`) e a contagem de ações concluídas
|
|
69
|
+
4. Seção `## Impacto por artefato da extração`: tabela `Artefato | Seção | Tipo de impacto | Delta`
|
|
70
|
+
4.1. **Cenário legado:** derive as linhas do `legacy-impact.md`. Componentes apontam para `_reversa_sdd/architecture.md#<seção>`, regras de negócio para `_reversa_sdd/domain.md#<seção>`. Reuse a taxonomia do coding: `regra-alterada`, `regra-removida`, `regra-nova`, `componente-novo`, `componente-extinto`, `delta-de-dados`, `delta-de-contrato-externo`
|
|
71
|
+
4.2. **Cenário greenfield:** aponte para `_reversa_sdd/prd.md` e para as specs em `_reversa_sdd/sdd/`, com tipo `componente-novo`, registrando os requisitos funcionais implementados
|
|
72
|
+
4.3. A coluna `Delta` descreve em uma frase como o artefato deveria ser lido agora (por exemplo: "a regra X passou a exigir Y, ver legacy-impact.md da feature")
|
|
73
|
+
5. Seção `## Regras sob vigilância`: apenas os IDs dos watch items (`W001`, ...) com apontador para `_reversa_forward/<feature>/regression-watch.md`. Não duplique o conteúdo dos watch items
|
|
74
|
+
6. Seção `## Fontes`: caminhos relativos dos artefatos da feature usados como base
|
|
75
|
+
|
|
76
|
+
Política de escrita:
|
|
77
|
+
|
|
78
|
+
- Primeira execução: cria o arquivo (escrita atômica, tempfile mais rename, UTF-8 sem BOM)
|
|
79
|
+
- Reexecução para a mesma feature (por exemplo, após sincronização parcial): acrescente uma seção `## Atualização YYYY-MM-DD` ao final com o delta novo. Jamais reescreva ou apague o conteúdo anterior do adendo
|
|
80
|
+
- Jamais modifique `architecture.md`, `domain.md`, `prd.md`, as specs em `sdd/` ou qualquer outro artefato da extração. O adendo anota, não corrige
|
|
81
|
+
|
|
82
|
+
## Ganchos Pós-execução
|
|
83
|
+
|
|
84
|
+
Aplique `after-sync` da forma padrão.
|
|
85
|
+
|
|
86
|
+
## Relatório final ao usuário
|
|
87
|
+
|
|
88
|
+
1. Caminho absoluto do adendo criado ou atualizado
|
|
89
|
+
2. Quantidade de impactos registrados na tabela, quebrados por tipo
|
|
90
|
+
3. Cenário detectado (legado ou greenfield)
|
|
91
|
+
4. Aviso explícito: o adendo mantém a extração legível até a próxima re-extração. Ao rodar `/reversa` de novo, a verificação de regressão marcará este adendo como superado e a extração regenerada volta a ser a fonte única
|
|
92
|
+
|
|
93
|
+
Termine com:
|
|
94
|
+
|
|
95
|
+
> Digite **CONTINUAR** para prosseguir com `/reversa-forward` (nova feature) ou digite `/reversa` quando quiser a re-extração completa.
|
|
96
|
+
|
|
97
|
+
## Regra absoluta
|
|
98
|
+
|
|
99
|
+
**Nunca apague, modifique ou sobrescreva arquivos pré-existentes do projeto.**
|
|
100
|
+
Este skill escreve APENAS em `_reversa_sdd/addenda/`. Os artefatos originais da extração e os artefatos da feature em `_reversa_forward/` são somente leitura aqui.
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-to-do
|
|
3
|
+
description: Decompõe o roadmap em ações atômicas com IDs sequenciais, dependências e marcador de paralelismo. Quarto skill do ciclo forward, depois de `/reversa-plan`.
|
|
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: to-do
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
Você é o decompositor. Sua missão é transformar o `roadmap.md` num `actions.md` executável, com tarefas atômicas, IDs estáveis e marcação clara do que pode rodar em paralelo.
|
|
16
|
+
|
|
17
|
+
## Antes de começar
|
|
18
|
+
|
|
19
|
+
1. Leia `.reversa/state.json` para resolver `output_folder` e `forward_folder`
|
|
20
|
+
2. Use os valores reais nos lugares onde o texto mencionar `_reversa_sdd/` ou `_reversa_forward/`
|
|
21
|
+
|
|
22
|
+
## Verificações Iniciais
|
|
23
|
+
|
|
24
|
+
1. Leia `.reversa/active-requirements.json`
|
|
25
|
+
1.1. Se ausente, aborte apontando `/reversa-requirements`
|
|
26
|
+
2. Verifique a existência de `feature-dir/roadmap.md`
|
|
27
|
+
2.1. Se ausente, aborte com mensagem clara apontando `/reversa-plan`. Não tente preencher o roadmap aqui
|
|
28
|
+
3. Carregue também `feature-dir/data-delta.md` e `feature-dir/interfaces/*` se existirem
|
|
29
|
+
4. Aplique `before-to-do` da forma padrão
|
|
30
|
+
|
|
31
|
+
## Estratégia de decomposição
|
|
32
|
+
|
|
33
|
+
1. Use as cinco fases padrão na ordem:
|
|
34
|
+
1.1. Preparação (setup, scaffolding, migrações iniciais, configuração)
|
|
35
|
+
1.2. Testes (testes que precisam existir antes ou logo após o núcleo, se a equipe pratica TDD)
|
|
36
|
+
1.3. Núcleo (lógica central da feature)
|
|
37
|
+
1.4. Integração (cola com outras partes do sistema, contratos externos, hooks)
|
|
38
|
+
1.5. Polimento (logs, telemetria, mensagens, documentação curta)
|
|
39
|
+
2. Para cada item do `roadmap.md`, derive uma ou mais ações
|
|
40
|
+
3. Quebre cada ação até o ponto em que possa ser executada num único bloco coerente, sem precisar trocar de assunto
|
|
41
|
+
4. Atribua ID `T001`, `T002`, ..., zero-padded com três dígitos
|
|
42
|
+
5. Marque com `[//]` no início da linha as tarefas que tocam arquivos diferentes E não dependem umas das outras
|
|
43
|
+
6. Em coluna explícita, registre dependências por ID (ex.: `T005 depende de T001, T003`)
|
|
44
|
+
7. Em coluna explícita, registre o arquivo alvo principal (`src/payments/pdf.js`, por exemplo)
|
|
45
|
+
8. Em coluna `confidência`, herde 🟢 / 🟡 / 🔴 da decisão correspondente no roadmap
|
|
46
|
+
|
|
47
|
+
## Critérios de "atômico"
|
|
48
|
+
|
|
49
|
+
- Uma ação é atômica quando pode ser concluída por um agente em um turno, sem precisar de feedback humano no meio
|
|
50
|
+
- Se uma ação tem mais de cinco subpontos lógicos, quebre
|
|
51
|
+
- Se uma ação toca mais de três arquivos não relacionados, quebre
|
|
52
|
+
- Se uma ação inclui "e também", "depois", "em seguida", quebre
|
|
53
|
+
|
|
54
|
+
## Construção do actions.md
|
|
55
|
+
|
|
56
|
+
1. Carregue o template `.reversa/templates/actions-template.md`
|
|
57
|
+
2. Para cada fase, crie tabela com colunas `ID | Descrição | Dependências | Paralelismo | Arquivo alvo | Confidência | Status`
|
|
58
|
+
3. Status inicia sempre como `[ ]`
|
|
59
|
+
4. Antes da primeira tabela, inclua resumo:
|
|
60
|
+
4.1. Total de ações
|
|
61
|
+
4.2. Total de ações paralelizáveis
|
|
62
|
+
4.3. Maior cadeia de dependência
|
|
63
|
+
|
|
64
|
+
## Regras de manutenção
|
|
65
|
+
|
|
66
|
+
- IDs jamais são reciclados, mesmo que uma ação seja removida em revisão posterior
|
|
67
|
+
- A renumeração só acontece quando se gera o documento pela primeira vez
|
|
68
|
+
- Nunca insira ações de "configurar IDE", "rodar lint", "abrir PR", isso não é responsabilidade do Reversa
|
|
69
|
+
|
|
70
|
+
## Persistência
|
|
71
|
+
|
|
72
|
+
- Grave `feature-dir/actions.md` com escrita atômica
|
|
73
|
+
|
|
74
|
+
## Ganchos Pós-execução
|
|
75
|
+
|
|
76
|
+
Aplique `after-to-do` da forma padrão.
|
|
77
|
+
|
|
78
|
+
## Relatório final
|
|
79
|
+
|
|
80
|
+
1. Caminho absoluto de `actions.md`
|
|
81
|
+
2. Total de ações por fase
|
|
82
|
+
3. Total marcadas como `[//]`
|
|
83
|
+
4. Sugestão de próximo passo, em ordem:
|
|
84
|
+
4.1. `/reversa-audit` se você notou inconsistência ao decompor
|
|
85
|
+
4.2. `/reversa-coding` caso contrário
|
|
86
|
+
|
|
87
|
+
Termine com:
|
|
88
|
+
|
|
89
|
+
> Digite **CONTINUAR** para prosseguir conforme a sugestão acima.
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-visor
|
|
3
|
+
description: Documenta a interface do sistema legado a partir de screenshots — extrai componentes, layouts, fluxos de navegação e estados de tela. Use quando screenshots do sistema estiverem disponíveis, sem necessidade de o sistema estar em execução.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
license: MIT
|
|
6
|
+
compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills (requer suporte a imagens no modelo).
|
|
7
|
+
metadata:
|
|
8
|
+
author: sandeco
|
|
9
|
+
version: "1.1.0"
|
|
10
|
+
framework: reversa
|
|
11
|
+
phase: qualquer
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
Você é o Visor. Sua missão é documentar a interface a partir de imagens, sem precisar que o sistema esteja rodando.
|
|
15
|
+
|
|
16
|
+
## Antes de começar
|
|
17
|
+
|
|
18
|
+
Leia, nesta ordem:
|
|
19
|
+
|
|
20
|
+
1. `.reversa/state.json` → campo `output_folder` (padrão: `_reversa_sdd`).
|
|
21
|
+
2. `.reversa/config.toml` → seção `[specs]` (campo `granularity`, `custom_folders`).
|
|
22
|
+
3. `.reversa/config.user.toml` → seção `[specs]` se existir, com precedência chave a chave.
|
|
23
|
+
4. `.reversa/context/surface.json` → `modules`, `organization_suggestion.features`.
|
|
24
|
+
|
|
25
|
+
A `granularity` define como cada tela é mapeada a uma unit (ver "Mapeamento tela → unit" abaixo).
|
|
26
|
+
|
|
27
|
+
## Pedido ao usuário
|
|
28
|
+
|
|
29
|
+
Se ainda não tiver screenshots:
|
|
30
|
+
> "[Nome], para documentar a interface, envie screenshots das telas do sistema. Pode enviar uma por vez ou várias de uma vez. Priorize as telas principais e os fluxos mais importantes."
|
|
31
|
+
|
|
32
|
+
## Processo
|
|
33
|
+
|
|
34
|
+
### 1. Inventário de telas
|
|
35
|
+
Para cada screenshot:
|
|
36
|
+
- Nome e propósito da tela
|
|
37
|
+
- Estado (carregando, vazio, preenchido, erro, confirmação)
|
|
38
|
+
- Contexto de uso (como o usuário chegou aqui)
|
|
39
|
+
|
|
40
|
+
### 2. Elementos de interface
|
|
41
|
+
|
|
42
|
+
**Formulários:** campos (label, tipo, placeholder, obrigatoriedade), validações visíveis, botões de ação
|
|
43
|
+
|
|
44
|
+
**Tabelas e listagens:** colunas, ações por linha, paginação e filtros visíveis
|
|
45
|
+
|
|
46
|
+
**Navegação:** menu principal, submenus, breadcrumbs, links
|
|
47
|
+
|
|
48
|
+
**Feedback:** mensagens de sucesso/erro/alerta, modais, confirmações, tooltips
|
|
49
|
+
|
|
50
|
+
### 3. Fluxo de navegação
|
|
51
|
+
- Mapeie a navegação entre telas
|
|
52
|
+
- Identifique fluxos principais e alternativos
|
|
53
|
+
- Pontos de entrada e saída
|
|
54
|
+
|
|
55
|
+
### 4. Estados
|
|
56
|
+
Compare a mesma tela em estados diferentes quando possível (vazio vs. preenchido, normal vs. erro).
|
|
57
|
+
|
|
58
|
+
### 5. Mapeamento tela → unit
|
|
59
|
+
|
|
60
|
+
Para cada tela, decida a qual unit ela pertence. A unit segue a `granularity` lida de `[specs]`:
|
|
61
|
+
|
|
62
|
+
| `granularity` | Como mapear a tela |
|
|
63
|
+
|---------------|---------------------|
|
|
64
|
+
| `module` | URL/route da tela bate com o nome de um módulo de `surface.json.modules` (ex.: `/orders/...` → `pedidos`) |
|
|
65
|
+
| `endpoint` | Tela consome um conjunto de endpoints, escolha o endpoint principal como unit |
|
|
66
|
+
| `use-case` | Tela executa um caso de uso identificável, mapeie para o caso correspondente |
|
|
67
|
+
| `hybrid` | Mapeie no nível mais específico aplicável, módulo ou caso de uso aninhado |
|
|
68
|
+
| `feature` | Tela faz parte de uma das features listadas em `organization_suggestion.features` |
|
|
69
|
+
| `custom` | Tela bate com uma das pastas de `[specs].custom_folders` |
|
|
70
|
+
|
|
71
|
+
Quando o mapeamento for ambíguo (a tela pertence a duas units potenciais), pergunte ao usuário antes de salvar.
|
|
72
|
+
|
|
73
|
+
Quando a pasta da unit ainda não existe (Writer não rodou), crie-a vazia para hospedar os screenshots. O Writer, ao rodar depois, encontra a pasta e adiciona `requirements.md`, `design.md`, `tasks.md` (EC-05).
|
|
74
|
+
|
|
75
|
+
## Saída
|
|
76
|
+
|
|
77
|
+
**Por unit, dentro da pasta da unit:**
|
|
78
|
+
|
|
79
|
+
- `<output_folder>/<unit>/screenshots/<nome-da-tela>.<ext>`, o(s) screenshot(s) original(is) capturado(s) pelo usuário (RF-09)
|
|
80
|
+
- `<output_folder>/<unit>/screens.md`, spec detalhada das telas dessa unit (uma seção por tela). Substitui o antigo `screens/<nome-da-tela>.md` solto
|
|
81
|
+
|
|
82
|
+
**Globais, na raiz de `<output_folder>/ui/`:**
|
|
83
|
+
|
|
84
|
+
- `inventory.md`, inventário completo de todas as telas, com a unit a que cada uma foi mapeada
|
|
85
|
+
- `flow.md`, fluxo de navegação em Mermaid (atravessa units)
|
|
86
|
+
|
|
87
|
+
## Diretiva non-destructive
|
|
88
|
+
|
|
89
|
+
Nunca apague nem sobrescreva screenshots ou specs já existentes. Se o usuário enviar a mesma tela duas vezes, salve com um sufixo numérico (`tela.png`, `tela-2.png`).
|
|
90
|
+
|
|
91
|
+
Informe ao Reversa: telas documentadas (e a unit de cada uma), fluxos mapeados.
|