@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,212 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-writer
|
|
3
|
+
description: Gera especificações executáveis do sistema legado como contratos operacionais, em formato de pasta-por-unit com requirements.md, design.md e tasks.md. Use na fase de geração de uma análise de engenharia reversa.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
license: MIT
|
|
6
|
+
compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
|
|
7
|
+
metadata:
|
|
8
|
+
author: sandeco
|
|
9
|
+
version: "1.2.0"
|
|
10
|
+
framework: reversa
|
|
11
|
+
phase: geracao
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
Você é o Writer. Sua missão é transformar o conhecimento extraído em especificações formais, precisas e rastreáveis, no layout de pasta-por-unit definido em `[specs]` do `config.toml`.
|
|
15
|
+
|
|
16
|
+
## Antes de começar
|
|
17
|
+
|
|
18
|
+
Leia, nesta ordem:
|
|
19
|
+
|
|
20
|
+
1. `.reversa/state.json` → campos `output_folder` (padrão: `_reversa_sdd`), `doc_level` (padrão: `completo`) e `doc_language`.
|
|
21
|
+
2. `.reversa/config.toml` → seção `[specs]` (campos `granularity`, `custom_folders`).
|
|
22
|
+
3. `.reversa/config.user.toml` → seção `[specs]` se existir, com precedência chave a chave sobre `config.toml`.
|
|
23
|
+
4. `.reversa/context/surface.json` → especialmente `modules` e `organization_suggestion.features`.
|
|
24
|
+
5. Demais artefatos em `<output_folder>/` e `.reversa/context/` (gerados por agentes anteriores).
|
|
25
|
+
|
|
26
|
+
Se a seção `[specs]` ainda não está decidida (granularity vazia), pare e peça ao orquestrador Reversa para executar `references/step-03-specs-organization.md` antes de continuar.
|
|
27
|
+
|
|
28
|
+
## Layout de saída, pasta-por-unit
|
|
29
|
+
|
|
30
|
+
Toda spec gerada por este agente vai para uma **pasta de unit** dentro de `<output_folder>/`. Cada unit recebe os 3 arquivos canônicos:
|
|
31
|
+
|
|
32
|
+
- `<output_folder>/<unit>/requirements.md`
|
|
33
|
+
- `<output_folder>/<unit>/design.md`
|
|
34
|
+
- `<output_folder>/<unit>/tasks.md`
|
|
35
|
+
|
|
36
|
+
O que é uma "unit" depende da `granularity`:
|
|
37
|
+
|
|
38
|
+
| `granularity` | Unit é... | Fonte para enumerar |
|
|
39
|
+
|---------------|-----------|---------------------|
|
|
40
|
+
| `module` | Um módulo do legado | `surface.json.modules` |
|
|
41
|
+
| `endpoint` | Um endpoint ou contrato HTTP/RPC | Routes/controllers identificados pelo Scout (sinais em `organization_suggestion.signals`) ou inferidos do código |
|
|
42
|
+
| `use-case` | Um caso de uso comportamental | Specs Gherkin/E2E (`features/*.feature`, `*.spec.*`) ou casos extraídos de fluxos no código |
|
|
43
|
+
| `hybrid` | Módulo no topo, casos de uso aninhados | `surface.json.modules` no nível 1 + casos de uso dentro de cada módulo |
|
|
44
|
+
| `feature` | Uma feature listada pelo Scout | `surface.json.organization_suggestion.features` |
|
|
45
|
+
| `custom` | Pasta definida pelo usuário | `[specs].custom_folders` do `config.toml` |
|
|
46
|
+
|
|
47
|
+
### Idioma e nomes de pasta (RF-10)
|
|
48
|
+
|
|
49
|
+
Os nomes das pastas seguem `doc_language` do `state.json`. Em uma instalação `Português`, os nomes saem em pt-br (ex.: `pedidos/`, `autenticacao/`); em `English`, saem em inglês (ex.: `orders/`, `authentication/`). Não pergunte idioma, apenas aplique o já configurado. Sanitize cada nome (substitua espaços por `-`, remova caracteres proibidos pelo OS).
|
|
50
|
+
|
|
51
|
+
### Caso `hybrid`
|
|
52
|
+
|
|
53
|
+
Para cada módulo `M` em `surface.json.modules`, crie a pasta `<output_folder>/<M>/` com os 3 arquivos canônicos no nível do módulo, e abaixo dela uma pasta por caso de uso identificado dentro daquele módulo: `<output_folder>/<M>/<caso-de-uso>/requirements.md`, `design.md`, `tasks.md`.
|
|
54
|
+
|
|
55
|
+
## Artefatos canônicos e opcionais
|
|
56
|
+
|
|
57
|
+
**Sempre, em cada pasta de unit:**
|
|
58
|
+
- `requirements.md`, ver `references/requirements-template.md`
|
|
59
|
+
- `design.md`, ver `references/design-template.md`
|
|
60
|
+
- `tasks.md`, ver `references/tasks-template.md`
|
|
61
|
+
|
|
62
|
+
**Opcionais por unit, conforme `doc_level` e contexto:**
|
|
63
|
+
|
|
64
|
+
| Arquivo | Quando gerar |
|
|
65
|
+
|---------|--------------|
|
|
66
|
+
| `contracts.md` | `doc_level` = `completo` ou `detalhado`, e a unit expõe contrato externo (HTTP, fila, RPC) |
|
|
67
|
+
| `flows.md` | A unit tem 2+ fluxos distintos não cobertos no `design.md` |
|
|
68
|
+
| `edge-cases.md` | `doc_level` = `detalhado`, com pelo menos 2 casos extremos por unit |
|
|
69
|
+
| `decisions.md` | A unit tem decisões arquiteturais explícitas (ADR-style) que mereçam registro |
|
|
70
|
+
| `legacy-mapping.md` | Útil para `module`, mas o Archaeologist é quem normalmente preenche |
|
|
71
|
+
| `questions.md` | A unit tem 🔴 lacunas que dependem de validação humana |
|
|
72
|
+
|
|
73
|
+
`tests.md` pode ser gerado quando há um corpo de testes legado significativo a documentar separadamente.
|
|
74
|
+
|
|
75
|
+
**Globais, FORA das pastas de unit:**
|
|
76
|
+
|
|
77
|
+
Estes ficam na raiz de `<output_folder>/`, não dentro de feature folders:
|
|
78
|
+
|
|
79
|
+
- `traceability/code-spec-matrix.md`, apenas se `doc_level` = `completo` ou `detalhado`
|
|
80
|
+
- `openapi/<api>.yaml`, apenas se `doc_level` = `completo` ou `detalhado` (ou se a API for o produto principal no `essencial`)
|
|
81
|
+
- `user-stories/<fluxo>.md`, apenas se `doc_level` = `completo` ou `detalhado`
|
|
82
|
+
|
|
83
|
+
## Princípio fundamental
|
|
84
|
+
|
|
85
|
+
**Specs são contratos operacionais, não texto bonito.** Uma spec deve ser suficientemente detalhada para que um agente de IA, sem acesso ao código original, possa reimplementar a funcionalidade com fidelidade.
|
|
86
|
+
|
|
87
|
+
## Regra de execução obrigatória
|
|
88
|
+
|
|
89
|
+
**Nunca gere tudo de uma vez.** Projetos grandes têm muitas units. Gerar tudo em uma única resposta consome contexto excessivo, reduz a qualidade e impede revisão incremental.
|
|
90
|
+
|
|
91
|
+
## Fluxo obrigatório
|
|
92
|
+
|
|
93
|
+
### Passo 1, Montar o plano
|
|
94
|
+
|
|
95
|
+
1. Resolva a lista de units conforme a tabela de `granularity` acima.
|
|
96
|
+
2. Para cada unit, monte a lista de arquivos a gerar: sempre os 3 canônicos, mais opcionais aplicáveis.
|
|
97
|
+
3. Adicione, ao final, os globais aplicáveis (traceability, openapi, user-stories).
|
|
98
|
+
|
|
99
|
+
Apresente o plano ao usuário neste formato (ajuste o idioma conforme `chat_language`):
|
|
100
|
+
|
|
101
|
+
```
|
|
102
|
+
📋 Plano de geração, X units, Y arquivos no total
|
|
103
|
+
|
|
104
|
+
Units:
|
|
105
|
+
[ ] 1. <unit-1>/requirements.md
|
|
106
|
+
[ ] 2. <unit-1>/design.md
|
|
107
|
+
[ ] 3. <unit-1>/tasks.md
|
|
108
|
+
[ ] 4. <unit-1>/contracts.md (opcional, se aplicável)
|
|
109
|
+
...
|
|
110
|
+
|
|
111
|
+
Globais (se aplicáveis):
|
|
112
|
+
[ ] N. openapi/<api>.yaml
|
|
113
|
+
[ ] N+1. user-stories/<fluxo>.md
|
|
114
|
+
[ ] N+2. traceability/code-spec-matrix.md
|
|
115
|
+
|
|
116
|
+
Digite CONTINUAR para iniciar, ou me diga se quer ajustar o plano.
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
Aguarde a confirmação do usuário antes de prosseguir.
|
|
120
|
+
|
|
121
|
+
### Passo 2, Gerar um arquivo por vez
|
|
122
|
+
|
|
123
|
+
Para cada item do plano, em sequência:
|
|
124
|
+
|
|
125
|
+
1. Informe: `"Gerando [N/total]: [caminho do arquivo]..."`
|
|
126
|
+
2. Gere apenas aquele arquivo, baseando-se no template correspondente em `references/`.
|
|
127
|
+
3. Se a pasta da unit ainda não existe, crie-a; se já existe (EC-05), preserve qualquer conteúdo presente e apenas adicione os arquivos faltantes. Nunca sobrescreva arquivos já existentes sem confirmação.
|
|
128
|
+
4. Marque o item como concluído no plano.
|
|
129
|
+
5. Salve o progresso em `.reversa/state.json` (campo `redator_progress`).
|
|
130
|
+
6. Informe: `"✅ [arquivo] concluído. Próximo: [próximo item]. Digite CONTINUAR para prosseguir."`
|
|
131
|
+
7. Pare e aguarde a resposta do usuário.
|
|
132
|
+
|
|
133
|
+
Só avance para o próximo item após resposta. Isso permite que o usuário revise, ajuste ou interrompa a qualquer momento.
|
|
134
|
+
|
|
135
|
+
**Pausa preventiva entre units:** quando você concluir o último arquivo (`tasks.md`) de uma unit e a sessão já gerou **3 units ou mais** sem pausa, troque a mensagem padrão "Digite CONTINUAR" pela versão com pausa preventiva:
|
|
136
|
+
|
|
137
|
+
> "✅ [arquivo] concluído. Unit **[X]** está completa e o checkpoint está salvo. Próxima unit: **[Y]**. Você quer:
|
|
138
|
+
>
|
|
139
|
+
> 1. Continuar agora
|
|
140
|
+
> 2. Pausar aqui, digitar `/clear` e retomar com `/reversa` em sessão nova (recomendado se a sessão atual já está longa, preserva qualidade nas próximas units)
|
|
141
|
+
>
|
|
142
|
+
> Pressione 1, 2, ou digite CONTINUAR para opção 1."
|
|
143
|
+
|
|
144
|
+
Antes de oferecer a opção 2, confirme que `redator_progress` em `.reversa/state.json` reflete o último arquivo concluído. Não force a pausa, o usuário decide.
|
|
145
|
+
|
|
146
|
+
### Passo 3, Globais
|
|
147
|
+
|
|
148
|
+
Após todos os arquivos de unit, gere os globais aplicáveis na ordem: `openapi/`, `user-stories/`, `traceability/code-spec-matrix.md` por último.
|
|
149
|
+
|
|
150
|
+
A code-spec matrix lista, por arquivo do legado, qual unit cobre o quê:
|
|
151
|
+
|
|
152
|
+
| Arquivo do legado | Unit correspondente | Cobertura |
|
|
153
|
+
|---------|---------------------|-----------|
|
|
154
|
+
| `caminho/arquivo.ext` | `<unit>/` | 🟢 / 🟡 / n/a |
|
|
155
|
+
|
|
156
|
+
Arquivos sem unit correspondente ficam com `n/a`, são candidatos a análise adicional.
|
|
157
|
+
|
|
158
|
+
### Passo 4, Encerramento
|
|
159
|
+
|
|
160
|
+
Ao concluir, informe ao Reversa:
|
|
161
|
+
- Units geradas (quantidade)
|
|
162
|
+
- Total de arquivos canônicos + opcionais
|
|
163
|
+
- Globais gerados
|
|
164
|
+
- % de cobertura estimada (arquivos do legado mapeados a alguma unit)
|
|
165
|
+
|
|
166
|
+
## Confiança em cada afirmação
|
|
167
|
+
|
|
168
|
+
Marque toda afirmação com 🟢 (CONFIRMADO no código), 🟡 (INFERIDO) ou 🔴 (LACUNA). Sem exceções.
|
|
169
|
+
|
|
170
|
+
## Como preencher seções críticas
|
|
171
|
+
|
|
172
|
+
**Requisitos Não Funcionais** (em `requirements.md`)
|
|
173
|
+
Infira a partir do código, não invente. Sinais a procurar:
|
|
174
|
+
- Timeouts explícitos → Performance
|
|
175
|
+
- Middleware de autenticação/autorização → Segurança
|
|
176
|
+
- Uso de cache, filas, workers → Escalabilidade
|
|
177
|
+
- Retry logic, circuit breakers → Disponibilidade
|
|
178
|
+
Se não encontrar evidência, omita a linha. Nunca preencha sem rastreabilidade.
|
|
179
|
+
|
|
180
|
+
**Critérios de Aceitação** (em `requirements.md`)
|
|
181
|
+
Derive dos fluxos e regras de negócio documentados em `design.md` (ou diretamente do código). Para cada fluxo principal, gere ao menos um cenário feliz e um cenário de falha. Use `Dado / Quando / Então` sem exceção.
|
|
182
|
+
|
|
183
|
+
**MoSCoW** (em `requirements.md`)
|
|
184
|
+
- **Must:** caminho crítico ou chamado por múltiplos componentes
|
|
185
|
+
- **Should:** importante mas com alternativa ou fallback
|
|
186
|
+
- **Could:** acionada raramente ou em casos de borda
|
|
187
|
+
- **Won't:** código comentado, flags desativadas, deprecado
|
|
188
|
+
|
|
189
|
+
Baseie em frequência de chamada, posição na cadeia de dependências e presença de testes.
|
|
190
|
+
|
|
191
|
+
**Tasks** (em `tasks.md`)
|
|
192
|
+
Cada tarefa cita o arquivo do legado de onde o comportamento foi extraído. Critério de pronto sempre presente. Confiança 🟢/🟡/🔴 sempre presente.
|
|
193
|
+
|
|
194
|
+
## Saída resumo
|
|
195
|
+
|
|
196
|
+
```
|
|
197
|
+
<output_folder>/
|
|
198
|
+
├── <unit-1>/
|
|
199
|
+
│ ├── requirements.md
|
|
200
|
+
│ ├── design.md
|
|
201
|
+
│ ├── tasks.md
|
|
202
|
+
│ └── (opcionais aplicáveis)
|
|
203
|
+
├── <unit-2>/
|
|
204
|
+
│ └── ...
|
|
205
|
+
├── traceability/code-spec-matrix.md # apenas completo/detalhado
|
|
206
|
+
├── openapi/<api>.yaml # apenas completo/detalhado
|
|
207
|
+
└── user-stories/<fluxo>.md # apenas completo/detalhado
|
|
208
|
+
```
|
|
209
|
+
|
|
210
|
+
## Diretiva non-destructive
|
|
211
|
+
|
|
212
|
+
Nunca apague, mova ou modifique pastas e arquivos já existentes em `<output_folder>/`. Em caso de pasta de unit pré-existente, adicione apenas os arquivos faltantes. Em caso de arquivo canônico já presente, deixe-o como está e informe ao usuário.
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# [Nome da Unit], Design Técnico
|
|
2
|
+
|
|
3
|
+
> Template do arquivo `design.md`. Foca no COMO a unit é construída, com base no código legado lido.
|
|
4
|
+
|
|
5
|
+
## Interface
|
|
6
|
+
[Entradas, saídas, parâmetros, tipos de dados]
|
|
7
|
+
|
|
8
|
+
Para endpoints HTTP:
|
|
9
|
+
|
|
10
|
+
| Método | Caminho | Entrada | Saída | Status codes |
|
|
11
|
+
|--------|---------|---------|-------|--------------|
|
|
12
|
+
| GET | `/recurso/:id` | `id: string` | `Recurso` | 200, 404 |
|
|
13
|
+
| POST | `/recurso` | `RecursoCreate` | `Recurso` | 201, 400, 409 |
|
|
14
|
+
|
|
15
|
+
Para classes/funções:
|
|
16
|
+
|
|
17
|
+
| Símbolo | Assinatura | Retorno | Observação |
|
|
18
|
+
|---------|-----------|---------|------------|
|
|
19
|
+
| `NomeDaClasse.metodo` | `(arg1: T, arg2: U)` | `V` | [Detalhe relevante] |
|
|
20
|
+
|
|
21
|
+
## Fluxo Principal
|
|
22
|
+
1. [Passo 1, com referência ao arquivo legado quando aplicável]
|
|
23
|
+
2. [Passo 2]
|
|
24
|
+
3. [Passo N]
|
|
25
|
+
|
|
26
|
+
## Fluxos Alternativos
|
|
27
|
+
- **[Condição especial]:** [comportamento]
|
|
28
|
+
- **[Caso de erro]:** [comportamento]
|
|
29
|
+
|
|
30
|
+
## Dependências
|
|
31
|
+
- [Componente X], [motivo, como usa]
|
|
32
|
+
- [Serviço Y], [motivo, como usa]
|
|
33
|
+
|
|
34
|
+
## Decisões de Design Identificadas
|
|
35
|
+
|
|
36
|
+
| Decisão | Evidência no código | Confiança |
|
|
37
|
+
|---------|---------------------|-----------|
|
|
38
|
+
| [ex: persistência via Prisma com soft-delete] | `prisma/schema.prisma:42` | 🟢 |
|
|
39
|
+
| [ex: cache em memória com TTL de 5min] | `cache/store.ts:18` | 🟡 |
|
|
40
|
+
|
|
41
|
+
## Estado Interno
|
|
42
|
+
[Se a unit mantém estado, descrever quais campos, onde são armazenados, como evoluem]
|
|
43
|
+
|
|
44
|
+
## Observabilidade
|
|
45
|
+
[Logs, métricas, traces emitidos pela unit, com referência ao código]
|
|
46
|
+
|
|
47
|
+
## Riscos e Lacunas
|
|
48
|
+
- 🔴 [Comportamento que não foi possível inferir do código, requer validação humana]
|
|
49
|
+
- 🟡 [Suposição que pode estar errada]
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# [Nome da Unit]
|
|
2
|
+
|
|
3
|
+
> Template do arquivo `requirements.md`. Foca no QUE a unit faz, não no como.
|
|
4
|
+
|
|
5
|
+
## Visão Geral
|
|
6
|
+
[O que é, qual problema resolve, 2 a 3 linhas]
|
|
7
|
+
|
|
8
|
+
## Responsabilidades
|
|
9
|
+
- [Responsabilidade 1]
|
|
10
|
+
- [Responsabilidade 2]
|
|
11
|
+
|
|
12
|
+
## Regras de Negócio
|
|
13
|
+
- [Regra 1] 🟢
|
|
14
|
+
- [Regra 2] 🟡
|
|
15
|
+
- [Comportamento desconhecido] 🔴
|
|
16
|
+
|
|
17
|
+
## Requisitos Funcionais
|
|
18
|
+
|
|
19
|
+
| ID | Requisito | Prioridade | Critério de Aceite |
|
|
20
|
+
|----|-----------|-----------|-------------------|
|
|
21
|
+
| RF-01 | [Descrição] | Must | [Como validar] |
|
|
22
|
+
| RF-02 | [Descrição] | Should | [Como validar] |
|
|
23
|
+
|
|
24
|
+
## Requisitos Não Funcionais
|
|
25
|
+
|
|
26
|
+
| Tipo | Requisito inferido | Evidência no código | Confiança |
|
|
27
|
+
|------|--------------------|---------------------|-----------|
|
|
28
|
+
| Performance | [ex: timeout de 30s em chamadas externas] | `caminho/arquivo.ext:linha` | 🟢 |
|
|
29
|
+
| Segurança | [ex: autenticação obrigatória na rota] | `caminho/arquivo.ext:linha` | 🟡 |
|
|
30
|
+
| Escalabilidade | [ex: uso de cache Redis] | `caminho/arquivo.ext:linha` | 🟢 |
|
|
31
|
+
| Disponibilidade | [ex: retry automático em falha] | `caminho/arquivo.ext:linha` | 🟡 |
|
|
32
|
+
|
|
33
|
+
> Inferido a partir do código. Validar com equipe de operações.
|
|
34
|
+
|
|
35
|
+
## Critérios de Aceitação
|
|
36
|
+
|
|
37
|
+
```gherkin
|
|
38
|
+
Dado [pré-condição]
|
|
39
|
+
Quando [ação]
|
|
40
|
+
Então [resultado esperado]
|
|
41
|
+
|
|
42
|
+
Dado [condição de erro]
|
|
43
|
+
Quando [ação inválida]
|
|
44
|
+
Então [comportamento de falha esperado]
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## Prioridade (MoSCoW)
|
|
48
|
+
|
|
49
|
+
| Requisito | MoSCoW | Justificativa |
|
|
50
|
+
|-----------|--------|---------------|
|
|
51
|
+
| [Responsabilidade principal] | Must | Caminho crítico, chamado em todo fluxo |
|
|
52
|
+
| [Regra de negócio central] | Must | Regra de negócio sem fallback |
|
|
53
|
+
| [Funcionalidade secundária] | Should | Importante mas com alternativa |
|
|
54
|
+
| [Caso de borda] | Could | Raramente acionado |
|
|
55
|
+
|
|
56
|
+
> Prioridade inferida por frequência de chamada e posição na cadeia de dependências.
|
|
57
|
+
|
|
58
|
+
## Rastreabilidade de Código
|
|
59
|
+
|
|
60
|
+
| Arquivo | Função / Classe | Cobertura |
|
|
61
|
+
|---------|-----------------|-----------|
|
|
62
|
+
| `caminho/arquivo.ext` | `NomeDaClasse` | 🟢 |
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# [Nome da Unit], Tarefas de Implementação
|
|
2
|
+
|
|
3
|
+
> Template do arquivo `tasks.md`. Foca em uma sequência de tarefas executáveis para reimplementar a unit a partir do legado, com rastreabilidade ao código original.
|
|
4
|
+
|
|
5
|
+
## Pré-requisitos
|
|
6
|
+
- [ ] Dependências da unit listadas em `design.md` estão disponíveis
|
|
7
|
+
- [ ] Schema/migrations do banco compatíveis (se aplicável)
|
|
8
|
+
- [ ] Variáveis de ambiente / configs necessárias documentadas
|
|
9
|
+
|
|
10
|
+
## Tarefas
|
|
11
|
+
|
|
12
|
+
> Cada tarefa referencia o arquivo do legado de onde o comportamento foi extraído.
|
|
13
|
+
|
|
14
|
+
- [ ] T-01, [Descrição da tarefa]
|
|
15
|
+
- Origem no legado: `caminho/arquivo.ext:linha`
|
|
16
|
+
- Critério de pronto: [como validar]
|
|
17
|
+
- Confiança: 🟢 / 🟡 / 🔴
|
|
18
|
+
|
|
19
|
+
- [ ] T-02, [Descrição da tarefa]
|
|
20
|
+
- Origem no legado: `caminho/arquivo.ext:linha`
|
|
21
|
+
- Critério de pronto: [como validar]
|
|
22
|
+
- Confiança: 🟢 / 🟡 / 🔴
|
|
23
|
+
|
|
24
|
+
## Tarefas de Teste
|
|
25
|
+
|
|
26
|
+
- [ ] TT-01, Teste do happy path do fluxo principal (ver `requirements.md`, Critérios de Aceitação)
|
|
27
|
+
- [ ] TT-02, Teste do caso de erro principal
|
|
28
|
+
- [ ] TT-03, [Outros cenários relevantes]
|
|
29
|
+
|
|
30
|
+
## Tarefas de Migração de Dados (se aplicável)
|
|
31
|
+
|
|
32
|
+
- [ ] TM-01, [Migração de dados X, com referência ao schema legado]
|
|
33
|
+
|
|
34
|
+
## Ordem Sugerida
|
|
35
|
+
1. [Quais tarefas devem ser feitas primeiro e por quê]
|
|
36
|
+
2. [Bloqueios entre tarefas]
|
|
37
|
+
|
|
38
|
+
## Lacunas Pendentes (🔴)
|
|
39
|
+
[Liste aqui as decisões que dependem de validação humana antes da implementação]
|
package/bin/reversa.js
ADDED
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
import { readFileSync } from 'fs';
|
|
4
|
+
import { fileURLToPath } from 'url';
|
|
5
|
+
import { dirname, join } from 'path';
|
|
6
|
+
import chalk from 'chalk';
|
|
7
|
+
import { clearTerminalForLogo, renderReversaLogo } from '../lib/utils/banner.js';
|
|
8
|
+
|
|
9
|
+
const __dirname = dirname(fileURLToPath(import.meta.url));
|
|
10
|
+
const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf8'));
|
|
11
|
+
|
|
12
|
+
const [,, command, ...args] = process.argv;
|
|
13
|
+
|
|
14
|
+
const commands = {
|
|
15
|
+
install: () => import('../lib/commands/install.js'),
|
|
16
|
+
update: () => import('../lib/commands/update.js'),
|
|
17
|
+
status: () => import('../lib/commands/status.js'),
|
|
18
|
+
uninstall: () => import('../lib/commands/uninstall.js'),
|
|
19
|
+
'add-engine': () => import('../lib/commands/add-engine.js'),
|
|
20
|
+
'export-diagrams': () => import('../lib/commands/export-diagrams.js'),
|
|
21
|
+
};
|
|
22
|
+
|
|
23
|
+
if (!command || command === '--help' || command === '-h') {
|
|
24
|
+
clearTerminalForLogo();
|
|
25
|
+
console.log(renderReversaLogo(chalk) + `
|
|
26
|
+
|
|
27
|
+
reversa v${pkg.version}
|
|
28
|
+
|
|
29
|
+
Uso: npx ${pkg.name} <comando>
|
|
30
|
+
|
|
31
|
+
Comandos:
|
|
32
|
+
install Instala o Reversa no projeto atual (todos os agentes)
|
|
33
|
+
update Atualiza tudo para a última versão (todos os agentes)
|
|
34
|
+
status Mostra o estado atual da análise
|
|
35
|
+
uninstall Remove o Reversa do projeto
|
|
36
|
+
add-engine Adiciona suporte a uma engine
|
|
37
|
+
export-diagrams Exporta diagramas Mermaid como imagens SVG/PNG
|
|
38
|
+
Opções: --format=svg|png --output=<pasta>
|
|
39
|
+
Requer: npm install -g @mermaid-js/mermaid-cli
|
|
40
|
+
|
|
41
|
+
Fluxos principais no chat (após a instalação):
|
|
42
|
+
/reversa Descobre e documenta um sistema existente
|
|
43
|
+
/reversa-new Cria PRD e specs para um projeto novo
|
|
44
|
+
/reversa-forward Implementa ou evolui código a partir das specs
|
|
45
|
+
/reversa-migrate Planeja a migração de um sistema legado
|
|
46
|
+
/reversa-docs Gera o mini-site visual da documentação
|
|
47
|
+
|
|
48
|
+
Documentação: https://github.com/sandeco/reversa
|
|
49
|
+
`);
|
|
50
|
+
process.exit(0);
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
if (command === '--version' || command === '-v') {
|
|
54
|
+
console.log(pkg.version);
|
|
55
|
+
process.exit(0);
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
if (!commands[command]) {
|
|
59
|
+
console.error(`\n Comando desconhecido: "${command}"`);
|
|
60
|
+
console.error(` Execute "npx ${pkg.name} --help" para ver os comandos disponíveis.\n`);
|
|
61
|
+
process.exit(1);
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
const mod = await commands[command]();
|
|
65
|
+
await mod.default(args);
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
import { existsSync, readFileSync, writeFileSync } from 'fs';
|
|
2
|
+
import { join, resolve } from 'path';
|
|
3
|
+
import { npxCommand } from '../utils/package-info.js';
|
|
4
|
+
import { checkExistingInstallation } from '../installer/validator.js';
|
|
5
|
+
import { detectEngines, ENGINES } from '../installer/detector.js';
|
|
6
|
+
import { Writer } from '../installer/writer.js';
|
|
7
|
+
import { loadManifest, saveManifest, buildManifest } from '../installer/manifest.js';
|
|
8
|
+
import { applyOrangeTheme, ORANGE_PREFIX } from '../installer/orange-prompts.js';
|
|
9
|
+
import { readJsonSafe } from '../utils/json-safe.js';
|
|
10
|
+
|
|
11
|
+
export default async function addEngine(args) {
|
|
12
|
+
const { default: chalk } = await import('chalk');
|
|
13
|
+
const { default: inquirer } = await import('inquirer');
|
|
14
|
+
applyOrangeTheme();
|
|
15
|
+
|
|
16
|
+
const projectRoot = resolve(process.cwd());
|
|
17
|
+
|
|
18
|
+
console.log(chalk.bold('\n Reversa: Add Engine\n'));
|
|
19
|
+
|
|
20
|
+
const existing = checkExistingInstallation(projectRoot);
|
|
21
|
+
if (!existing.installed) {
|
|
22
|
+
console.log(chalk.yellow(' Reversa is not installed in this directory.'));
|
|
23
|
+
console.log(' Run ' + chalk.bold(npxCommand('install')) + ' to install.\n');
|
|
24
|
+
return;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
const state = existing.state;
|
|
28
|
+
|
|
29
|
+
// Validate required fields
|
|
30
|
+
if (!Array.isArray(state.agents) || state.agents.length === 0) {
|
|
31
|
+
console.log(chalk.red(' state.json has no registered agents.'));
|
|
32
|
+
console.log(' Run ' + chalk.bold(npxCommand('install')) + ' first.\n');
|
|
33
|
+
return;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
const installedEngineIds = new Set(state.engines ?? []);
|
|
37
|
+
const installedAgents = state.agents;
|
|
38
|
+
|
|
39
|
+
const allEngines = detectEngines(projectRoot);
|
|
40
|
+
const notInstalled = allEngines.filter(e => !installedEngineIds.has(e.id));
|
|
41
|
+
|
|
42
|
+
if (notInstalled.length === 0) {
|
|
43
|
+
console.log(chalk.hex('#ffa203')(' All detected engines are already configured.\n'));
|
|
44
|
+
return;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
const choices = notInstalled.map(e => ({
|
|
48
|
+
name: `${e.name}${e.star ? ' ⭐' : ''}${e.detected ? chalk.gray(' (detected)') : ''}`,
|
|
49
|
+
value: e.id,
|
|
50
|
+
checked: e.detected,
|
|
51
|
+
}));
|
|
52
|
+
|
|
53
|
+
const { selected } = await inquirer.prompt([{
|
|
54
|
+
prefix: ORANGE_PREFIX,
|
|
55
|
+
type: 'checkbox',
|
|
56
|
+
name: 'selected',
|
|
57
|
+
message: '\nSelect engines to add:\n\n',
|
|
58
|
+
choices,
|
|
59
|
+
validate: (v) => v.length > 0 || 'Select at least one engine.',
|
|
60
|
+
}]);
|
|
61
|
+
|
|
62
|
+
const selectedEngines = ENGINES.filter(e => selected.includes(e.id));
|
|
63
|
+
const writer = new Writer(projectRoot);
|
|
64
|
+
|
|
65
|
+
const seenEntryFiles = new Set();
|
|
66
|
+
for (const engine of selectedEngines) {
|
|
67
|
+
if (engine.entryFile && !seenEntryFiles.has(engine.entryFile)) {
|
|
68
|
+
seenEntryFiles.add(engine.entryFile);
|
|
69
|
+
await writer.installEntryFile(engine, {
|
|
70
|
+
outputFolder: state.output_folder,
|
|
71
|
+
forwardFolder: state.forward_folder,
|
|
72
|
+
});
|
|
73
|
+
}
|
|
74
|
+
for (const agent of installedAgents) {
|
|
75
|
+
await writer.installSkill(agent, engine.skillsDir);
|
|
76
|
+
if (engine.universalSkillsDir && engine.universalSkillsDir !== engine.skillsDir) {
|
|
77
|
+
await writer.installSkill(agent, engine.universalSkillsDir);
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
console.log(chalk.hex('#ffa203')(` ✓ ${engine.name}`));
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
// Atualizar state.json
|
|
84
|
+
const statePath = join(projectRoot, '.reversa', 'state.json');
|
|
85
|
+
const s = readJsonSafe(statePath);
|
|
86
|
+
s.engines = [...new Set([...(s.engines ?? []), ...selected])];
|
|
87
|
+
writeFileSync(statePath, JSON.stringify(s, null, 2), 'utf8');
|
|
88
|
+
|
|
89
|
+
writer.saveCreatedFiles();
|
|
90
|
+
|
|
91
|
+
// Atualizar manifest com caminhos relativos
|
|
92
|
+
const existingManifest = loadManifest(projectRoot);
|
|
93
|
+
const newManifest = buildManifest(projectRoot, writer.manifestPaths);
|
|
94
|
+
saveManifest(projectRoot, { ...existingManifest, ...newManifest });
|
|
95
|
+
|
|
96
|
+
console.log(chalk.bold(`\n ${selected.length} engine(s) added successfully.\n`));
|
|
97
|
+
}
|