@flaviogarrido/reversa 0.0.0-stage → 1.3.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +487 -2
- package/agents/fg-backlog/SKILL.md +129 -0
- package/agents/fg-backlog/agents/openai.yaml +5 -0
- package/agents/fg-backlog/references/backlog-template.md +60 -0
- package/agents/fg-backlog/references/priorizacao.md +41 -0
- package/agents/impeccable/LICENSE +191 -0
- package/agents/impeccable/NOTICE.md +11 -0
- package/agents/impeccable/SKILL.md +88 -0
- package/agents/impeccable/agents/impeccable_asset_producer.toml +47 -0
- package/agents/impeccable/agents/impeccable_documenter.toml +27 -0
- package/agents/impeccable/agents/impeccable_finish_reviewer.toml +41 -0
- package/agents/impeccable/agents/impeccable_manual_edit_applier.toml +95 -0
- package/agents/impeccable/agents/openai.yaml +4 -0
- package/agents/impeccable/reference/adapt.md +318 -0
- package/agents/impeccable/reference/adapt.native.md +58 -0
- package/agents/impeccable/reference/android.md +46 -0
- package/agents/impeccable/reference/animate.md +89 -0
- package/agents/impeccable/reference/audit.md +139 -0
- package/agents/impeccable/reference/audit.native.md +139 -0
- package/agents/impeccable/reference/bolder.md +33 -0
- package/agents/impeccable/reference/clarify.md +94 -0
- package/agents/impeccable/reference/colorize.md +86 -0
- package/agents/impeccable/reference/component-review.md +63 -0
- package/agents/impeccable/reference/craft-floor.md +44 -0
- package/agents/impeccable/reference/craft.md +5 -0
- package/agents/impeccable/reference/critique.md +819 -0
- package/agents/impeccable/reference/degraded/asset-producer.md +42 -0
- package/agents/impeccable/reference/degraded/documenter.md +24 -0
- package/agents/impeccable/reference/degraded/finish-reviewer.md +38 -0
- package/agents/impeccable/reference/degraded/manual-edit-applier.md +92 -0
- package/agents/impeccable/reference/delight.md +70 -0
- package/agents/impeccable/reference/distill.md +111 -0
- package/agents/impeccable/reference/doctor.md +54 -0
- package/agents/impeccable/reference/document.md +416 -0
- package/agents/impeccable/reference/extract.md +69 -0
- package/agents/impeccable/reference/generate.md +101 -0
- package/agents/impeccable/reference/harden.md +343 -0
- package/agents/impeccable/reference/hooks.md +113 -0
- package/agents/impeccable/reference/init.md +131 -0
- package/agents/impeccable/reference/ios.md +51 -0
- package/agents/impeccable/reference/layout.md +84 -0
- package/agents/impeccable/reference/live-setup.md +104 -0
- package/agents/impeccable/reference/live.md +325 -0
- package/agents/impeccable/reference/mode-operate.md +21 -0
- package/agents/impeccable/reference/mode-persuade.md +19 -0
- package/agents/impeccable/reference/mode-read.md +21 -0
- package/agents/impeccable/reference/new-work.md +154 -0
- package/agents/impeccable/reference/onboard.md +234 -0
- package/agents/impeccable/reference/operate.md +61 -0
- package/agents/impeccable/reference/optimize.md +258 -0
- package/agents/impeccable/reference/overdrive.md +127 -0
- package/agents/impeccable/reference/polish.md +105 -0
- package/agents/impeccable/reference/quieter.md +99 -0
- package/agents/impeccable/reference/region-map.md +26 -0
- package/agents/impeccable/reference/routing.md +24 -0
- package/agents/impeccable/reference/shape.md +59 -0
- package/agents/impeccable/reference/typeset.md +90 -0
- package/agents/impeccable/reference/visualize.md +47 -0
- package/agents/impeccable/reversa-bundle.json +16 -0
- package/agents/impeccable/scripts/VERSION +1 -0
- package/agents/impeccable/scripts/command-metadata.json +98 -0
- package/agents/impeccable/scripts/data/font-index-failures.json +121 -0
- package/agents/impeccable/scripts/data/font-index.json +1 -0
- package/agents/impeccable/scripts/impeccable +212 -0
- package/agents/impeccable/scripts/impeccable.cmd +239 -0
- package/agents/impeccable/scripts/live-browser-dom.js +320 -0
- package/agents/impeccable/scripts/live-browser-ignores.js +242 -0
- package/agents/impeccable/scripts/live-browser-session.js +180 -0
- package/agents/impeccable/scripts/live-browser.js +13557 -0
- package/agents/impeccable/scripts/modern-screenshot.umd.js +14 -0
- package/agents/reversa/SKILL.md +135 -0
- package/agents/reversa/agents/openai.yaml +3 -0
- package/agents/reversa/references/checkpoint-guide.md +106 -0
- package/agents/reversa/references/state-schema.md +80 -0
- package/agents/reversa/references/step-01-first-run.md +63 -0
- package/agents/reversa/references/step-02-resume.md +88 -0
- package/agents/reversa/references/step-03-specs-organization.md +145 -0
- package/agents/reversa/references/step-04-regression-check.md +94 -0
- package/agents/reversa-add/SKILL.md +131 -0
- package/agents/reversa-add/agents/openai.yaml +5 -0
- package/agents/reversa-agents-help/SKILL.md +211 -0
- package/agents/reversa-agents-help/agents/openai.yaml +3 -0
- package/agents/reversa-arbiter/SKILL.md +140 -0
- package/agents/reversa-arbiter/agents/openai.yaml +5 -0
- package/agents/reversa-archaeologist/SKILL.md +95 -0
- package/agents/reversa-archaeologist/agents/openai.yaml +5 -0
- package/agents/reversa-archaeologist/references/modules-schema.md +69 -0
- package/agents/reversa-architect/SKILL.md +93 -0
- package/agents/reversa-architect/agents/openai.yaml +5 -0
- package/agents/reversa-arquitetura-3d/SKILL.md +163 -0
- package/agents/reversa-arquitetura-3d/agents/openai.yaml +5 -0
- package/agents/reversa-arquitetura-3d/references/ARCH_TOUR.md +242 -0
- package/agents/reversa-arquitetura-3d/references/CALL_GRAPH_3D.md +217 -0
- package/agents/reversa-arquitetura-3d/references/CODE_CITY.md +228 -0
- package/agents/reversa-arquitetura-3d/references/DEPENDENCY_GRAPH_3D.md +240 -0
- package/agents/reversa-arquitetura-3d/references/ERRORS.md +286 -0
- package/agents/reversa-arquitetura-3d/references/LAYER_STACK.md +230 -0
- package/agents/reversa-arquitetura-3d/references/THREE_PATTERNS.md +221 -0
- package/agents/reversa-audit/SKILL.md +98 -0
- package/agents/reversa-audit/agents/openai.yaml +5 -0
- package/agents/reversa-autonomous/SKILL.md +139 -0
- package/agents/reversa-autonomous/agents/openai.yaml +3 -0
- package/agents/reversa-brainstorm/SKILL.md +131 -0
- package/agents/reversa-brainstorm/agents/openai.yaml +3 -0
- package/agents/reversa-challenger/SKILL.md +122 -0
- package/agents/reversa-challenger/agents/openai.yaml +5 -0
- package/agents/reversa-clarify/SKILL.md +103 -0
- package/agents/reversa-clarify/agents/openai.yaml +5 -0
- package/agents/reversa-code-express/SKILL.md +252 -0
- package/agents/reversa-code-express/agents/openai.yaml +5 -0
- package/agents/reversa-coding/SKILL.md +172 -0
- package/agents/reversa-coding/agents/openai.yaml +5 -0
- package/agents/reversa-curator/SKILL.md +133 -0
- package/agents/reversa-curator/agents/openai.yaml +5 -0
- package/agents/reversa-curator/references/decision-rubric.md +52 -0
- package/agents/reversa-curator/references/templates/discard_log.md +37 -0
- package/agents/reversa-curator/references/templates/target_business_rules.md +54 -0
- package/agents/reversa-data-master/SKILL.md +67 -0
- package/agents/reversa-data-master/agents/openai.yaml +5 -0
- package/agents/reversa-debugger/SKILL.md +178 -0
- package/agents/reversa-debugger/agents/openai.yaml +3 -0
- package/agents/reversa-debugger/references/bug-schema.md +123 -0
- package/agents/reversa-debugger/references/bugs-readme-template.md +76 -0
- package/agents/reversa-debugger-debate/SKILL.md +75 -0
- package/agents/reversa-debugger-debate/agents/openai.yaml +5 -0
- package/agents/reversa-debugger-debate/references/debate-protocol.md +102 -0
- package/agents/reversa-debugger-fix/SKILL.md +170 -0
- package/agents/reversa-debugger-fix/agents/openai.yaml +5 -0
- package/agents/reversa-debugger-graph/SKILL.md +94 -0
- package/agents/reversa-debugger-graph/agents/openai.yaml +5 -0
- package/agents/reversa-decouple/SKILL.md +78 -0
- package/agents/reversa-decouple/agents/openai.yaml +5 -0
- package/agents/reversa-depth-inspection/SKILL.md +99 -0
- package/agents/reversa-depth-inspection/agents/openai.yaml +5 -0
- package/agents/reversa-design-system/SKILL.md +77 -0
- package/agents/reversa-design-system/agents/openai.yaml +5 -0
- package/agents/reversa-designer/SKILL.md +217 -0
- package/agents/reversa-designer/agents/openai.yaml +5 -0
- package/agents/reversa-designer/references/paradigm-checklist.md +50 -0
- package/agents/reversa-designer/references/templates/data_migration_plan.md +80 -0
- package/agents/reversa-designer/references/templates/target_architecture.md +68 -0
- package/agents/reversa-designer/references/templates/target_data_model.md +64 -0
- package/agents/reversa-designer/references/templates/target_domain_model.md +62 -0
- package/agents/reversa-designer/references/templates/topology_decision.md +82 -0
- package/agents/reversa-detective/SKILL.md +82 -0
- package/agents/reversa-detective/agents/openai.yaml +5 -0
- package/agents/reversa-docs/SKILL.md +241 -0
- package/agents/reversa-docs/agents/openai.yaml +3 -0
- package/agents/reversa-docs/references/config-schema.json +108 -0
- package/agents/reversa-docs/references/expected_sources.yaml +60 -0
- package/agents/reversa-docs-analyst/SKILL.md +163 -0
- package/agents/reversa-docs-analyst/agents/openai.yaml +5 -0
- package/agents/reversa-docs-mapper/SKILL.md +167 -0
- package/agents/reversa-docs-mapper/agents/openai.yaml +5 -0
- package/agents/reversa-docs-mapper/references/extraction-policy.md +44 -0
- package/agents/reversa-docs-publisher/SKILL.md +323 -0
- package/agents/reversa-docs-publisher/agents/openai.yaml +5 -0
- package/agents/reversa-docs-publisher/references/auxiliary_sources.yaml +27 -0
- package/agents/reversa-docs-publisher/references/vendor-pins.yaml +149 -0
- package/agents/reversa-docs-storyteller/SKILL.md +189 -0
- package/agents/reversa-docs-storyteller/agents/openai.yaml +5 -0
- package/agents/reversa-drafter/SKILL.md +189 -0
- package/agents/reversa-drafter/agents/openai.yaml +5 -0
- package/agents/reversa-especialista-d3/SKILL.md +37 -0
- package/agents/reversa-especialista-d3/agents/openai.yaml +5 -0
- package/agents/reversa-especialista-d3/references/api-core.md +13 -0
- package/agents/reversa-especialista-d3/references/interatividade.md +5 -0
- package/agents/reversa-especialista-d3/references/layouts-complexos.md +8 -0
- package/agents/reversa-explorer/SKILL.md +110 -0
- package/agents/reversa-explorer/agents/openai.yaml +5 -0
- package/agents/reversa-extract-soul/SKILL.md +221 -0
- package/agents/reversa-extract-soul/agents/openai.yaml +5 -0
- package/agents/reversa-forward/SKILL.md +235 -0
- package/agents/reversa-forward/agents/openai.yaml +3 -0
- package/agents/reversa-forward-autonomous/SKILL.md +184 -0
- package/agents/reversa-forward-autonomous/agents/openai.yaml +3 -0
- package/agents/reversa-framer/SKILL.md +124 -0
- package/agents/reversa-framer/agents/openai.yaml +5 -0
- package/agents/reversa-highcharts-visualizer/SKILL.md +123 -0
- package/agents/reversa-highcharts-visualizer/agents/openai.yaml +5 -0
- package/agents/reversa-highcharts-visualizer/references/CHART_CATALOG.md +450 -0
- package/agents/reversa-highcharts-visualizer/references/ERRORS.md +99 -0
- package/agents/reversa-highcharts-visualizer/references/HIGHCHARTS_PATTERNS.md +347 -0
- package/agents/reversa-highcharts-visualizer/scripts/analyze_data.py +219 -0
- package/agents/reversa-highcharts-visualizer/scripts/parse_data.py +246 -0
- package/agents/reversa-highcharts-visualizer/scripts/sample_data.py +208 -0
- package/agents/reversa-ideator/SKILL.md +139 -0
- package/agents/reversa-ideator/agents/openai.yaml +5 -0
- package/agents/reversa-image-prompt-json/SKILL.md +210 -0
- package/agents/reversa-image-prompt-json/agents/openai.yaml +5 -0
- package/agents/reversa-image-prompt-json/references/Examples.md +123 -0
- package/agents/reversa-inspector/SKILL.md +147 -0
- package/agents/reversa-inspector/agents/openai.yaml +5 -0
- package/agents/reversa-inspector/references/parity-coverage-matrix.md +54 -0
- package/agents/reversa-inspector/references/templates/parity_specs.md +64 -0
- package/agents/reversa-inspector/references/templates/parity_test.feature +40 -0
- package/agents/reversa-migrate/SKILL.md +282 -0
- package/agents/reversa-migrate/agents/openai.yaml +3 -0
- package/agents/reversa-migrate/references/auto-defaults.md +52 -0
- package/agents/reversa-migrate/references/expected_legacy_artifacts.yaml +69 -0
- package/agents/reversa-migrate/references/handoff-checklist.md +34 -0
- package/agents/reversa-migrate/references/state.json +28 -0
- package/agents/reversa-migrate/references/templates/ambiguity_log.md +43 -0
- package/agents/reversa-migrate/references/templates/handoff.md +91 -0
- package/agents/reversa-migrate/references/templates/migration_brief.md +52 -0
- package/agents/reversa-migrate/references/templates/pending_decisions.md +36 -0
- package/agents/reversa-modularize/SKILL.md +77 -0
- package/agents/reversa-modularize/agents/openai.yaml +5 -0
- package/agents/reversa-n8n/SKILL.md +256 -0
- package/agents/reversa-n8n/agents/openai.yaml +5 -0
- package/agents/reversa-n8n/references/node-catalog.md +245 -0
- package/agents/reversa-new/SKILL.md +328 -0
- package/agents/reversa-new/agents/openai.yaml +3 -0
- package/agents/reversa-optimize/SKILL.md +80 -0
- package/agents/reversa-optimize/agents/openai.yaml +5 -0
- package/agents/reversa-paradigm-advisor/SKILL.md +168 -0
- package/agents/reversa-paradigm-advisor/agents/openai.yaml +5 -0
- package/agents/reversa-paradigm-advisor/references/paradigm-catalog.md +73 -0
- package/agents/reversa-paradigm-advisor/references/templates/paradigm_decision.md +69 -0
- package/agents/reversa-plan/SKILL.md +92 -0
- package/agents/reversa-plan/agents/openai.yaml +5 -0
- package/agents/reversa-pre-spec/SKILL.md +133 -0
- package/agents/reversa-pre-spec/agents/openai.yaml +5 -0
- package/agents/reversa-pricing/SKILL.md +181 -0
- package/agents/reversa-pricing/agents/openai.yaml +3 -0
- package/agents/reversa-pricing-advisor/SKILL.md +322 -0
- package/agents/reversa-pricing-advisor/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-advisor/references/advisor-schema.json +196 -0
- package/agents/reversa-pricing-advisor/references/advisor-template.md +106 -0
- package/agents/reversa-pricing-advisor/references/sale-models.md +237 -0
- package/agents/reversa-pricing-estimate/SKILL.md +287 -0
- package/agents/reversa-pricing-estimate/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-estimate/references/effort-formula.md +146 -0
- package/agents/reversa-pricing-estimate/references/estimate-schema.json +141 -0
- package/agents/reversa-pricing-estimate/references/estimate-template.md +153 -0
- package/agents/reversa-pricing-estimate/references/example-estimate.json +74 -0
- package/agents/reversa-pricing-estimate/references/example-estimate.md +88 -0
- package/agents/reversa-pricing-estimate/references/market-benchmarks.md +102 -0
- package/agents/reversa-pricing-estimate/references/value-formula.md +123 -0
- package/agents/reversa-pricing-product/SKILL.md +299 -0
- package/agents/reversa-pricing-product/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-product/references/breakeven-formula.md +237 -0
- package/agents/reversa-pricing-product/references/product-schema.json +288 -0
- package/agents/reversa-pricing-product/references/product-template.md +113 -0
- package/agents/reversa-pricing-product/references/store-commissions.md +57 -0
- package/agents/reversa-pricing-profile/SKILL.md +390 -0
- package/agents/reversa-pricing-profile/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-profile/references/example-profile.json +23 -0
- package/agents/reversa-pricing-profile/references/example-profile.md +46 -0
- package/agents/reversa-pricing-profile/references/profile-schema.json +227 -0
- package/agents/reversa-pricing-profile/references/tax-regimes.md +106 -0
- package/agents/reversa-pricing-research/SKILL.md +352 -0
- package/agents/reversa-pricing-research/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-research/references/research-policy.md +213 -0
- package/agents/reversa-pricing-research/references/research-schema.json +330 -0
- package/agents/reversa-pricing-size/SKILL.md +205 -0
- package/agents/reversa-pricing-size/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-size/references/example-size.json +41 -0
- package/agents/reversa-pricing-size/references/size-schema.json +120 -0
- package/agents/reversa-pricing-size/references/sizing-formula.md +183 -0
- package/agents/reversa-principles/SKILL.md +82 -0
- package/agents/reversa-principles/agents/openai.yaml +5 -0
- package/agents/reversa-prune/SKILL.md +85 -0
- package/agents/reversa-prune/agents/openai.yaml +5 -0
- package/agents/reversa-quality/SKILL.md +87 -0
- package/agents/reversa-quality/agents/openai.yaml +5 -0
- package/agents/reversa-reconstructor/SKILL.md +243 -0
- package/agents/reversa-reconstructor/agents/openai.yaml +5 -0
- package/agents/reversa-reconstructor/references/reconstruction-plan-migration-template.md +89 -0
- package/agents/reversa-reconstructor/references/reconstruction-plan-template.md +77 -0
- package/agents/reversa-refactor/SKILL.md +112 -0
- package/agents/reversa-refactor/agents/openai.yaml +3 -0
- package/agents/reversa-refactor/references/opportunity-schema.md +68 -0
- package/agents/reversa-refactor/references/refactor-readme-template.md +35 -0
- package/agents/reversa-requirements/SKILL.md +217 -0
- package/agents/reversa-requirements/agents/openai.yaml +5 -0
- package/agents/reversa-researcher/SKILL.md +136 -0
- package/agents/reversa-researcher/agents/openai.yaml +5 -0
- package/agents/reversa-restructure/SKILL.md +78 -0
- package/agents/reversa-restructure/agents/openai.yaml +5 -0
- package/agents/reversa-resume/SKILL.md +141 -0
- package/agents/reversa-resume/agents/openai.yaml +5 -0
- package/agents/reversa-reviewer/SKILL.md +163 -0
- package/agents/reversa-reviewer/agents/openai.yaml +5 -0
- package/agents/reversa-reviewer/references/confidence-report-template.md +73 -0
- package/agents/reversa-reviewer/references/confidence-rules.md +65 -0
- package/agents/reversa-reviewer/references/questions-template.md +74 -0
- package/agents/reversa-scout/SKILL.md +82 -0
- package/agents/reversa-scout/agents/openai.yaml +5 -0
- package/agents/reversa-scout/references/surface-schema.md +93 -0
- package/agents/reversa-screen-translator/SKILL.md +279 -0
- package/agents/reversa-screen-translator/agents/openai.yaml +5 -0
- package/agents/reversa-screen-translator/references/adapter-pairs.md +97 -0
- package/agents/reversa-screen-translator/references/platform-detection.md +73 -0
- package/agents/reversa-screen-translator/references/templates/golden_manifest.yaml +62 -0
- package/agents/reversa-screen-translator/references/templates/inventory.schema.json +132 -0
- package/agents/reversa-screen-translator/references/templates/screen_deviation_log.md +66 -0
- package/agents/reversa-screen-translator/references/templates/screen_modernization_decision.md +106 -0
- package/agents/reversa-screen-translator/references/templates/target_screens.md +206 -0
- package/agents/reversa-selo-generativo/SKILL.md +176 -0
- package/agents/reversa-selo-generativo/agents/openai.yaml +5 -0
- package/agents/reversa-selo-generativo/references/ERRORS.md +212 -0
- package/agents/reversa-selo-generativo/references/GENERATIVE_PATTERNS.md +365 -0
- package/agents/reversa-selo-generativo/references/PALETTE_BY_STYLE.md +176 -0
- package/agents/reversa-simplify/SKILL.md +79 -0
- package/agents/reversa-simplify/agents/openai.yaml +5 -0
- package/agents/reversa-spec-sdd/SKILL.md +278 -0
- package/agents/reversa-spec-sdd/agents/openai.yaml +5 -0
- package/agents/reversa-spec-sdd/assets/spec_examples.md +159 -0
- package/agents/reversa-spec-sdd/references/evaluation_rubric.md +113 -0
- package/agents/reversa-spec-sdd/references/sdd_guide.md +124 -0
- package/agents/reversa-spec-sdd/references/spec_template.md +231 -0
- package/agents/reversa-spec-sdd/scripts/spec_scorer.py +476 -0
- package/agents/reversa-standardize/SKILL.md +76 -0
- package/agents/reversa-standardize/agents/openai.yaml +5 -0
- package/agents/reversa-strategist/SKILL.md +119 -0
- package/agents/reversa-strategist/agents/openai.yaml +5 -0
- package/agents/reversa-strategist/references/migration-strategies.md +41 -0
- package/agents/reversa-strategist/references/templates/cutover_plan.md +60 -0
- package/agents/reversa-strategist/references/templates/migration_strategy.md +55 -0
- package/agents/reversa-strategist/references/templates/risk_register.md +44 -0
- package/agents/reversa-sync/SKILL.md +100 -0
- package/agents/reversa-sync/agents/openai.yaml +5 -0
- package/agents/reversa-to-do/SKILL.md +89 -0
- package/agents/reversa-to-do/agents/openai.yaml +5 -0
- package/agents/reversa-visor/SKILL.md +91 -0
- package/agents/reversa-visor/agents/openai.yaml +5 -0
- package/agents/reversa-writer/SKILL.md +212 -0
- package/agents/reversa-writer/agents/openai.yaml +5 -0
- package/agents/reversa-writer/references/design-template.md +49 -0
- package/agents/reversa-writer/references/requirements-template.md +62 -0
- package/agents/reversa-writer/references/tasks-template.md +39 -0
- package/bin/reversa.js +65 -0
- package/lib/commands/add-engine.js +97 -0
- package/lib/commands/export-diagrams.js +194 -0
- package/lib/commands/install.js +260 -0
- package/lib/commands/status.js +35 -0
- package/lib/commands/uninstall.js +159 -0
- package/lib/commands/update.js +252 -0
- package/lib/installer/bundled.js +42 -0
- package/lib/installer/detector.js +167 -0
- package/lib/installer/manifest.js +61 -0
- package/lib/installer/orange-prompts.js +13 -0
- package/lib/installer/policy.js +53 -0
- package/lib/installer/prompts.js +252 -0
- package/lib/installer/validator.js +22 -0
- package/lib/installer/writer.js +376 -0
- package/lib/utils/banner.js +35 -0
- package/lib/utils/json-safe.js +10 -0
- package/lib/utils/package-info.js +22 -0
- package/package.json +51 -4
- package/templates/config.toml +46 -0
- package/templates/config.user.toml +8 -0
- package/templates/documentation/assets/css/style.css +476 -0
- package/templates/documentation/assets/js/nav.js +141 -0
- package/templates/documentation/assets/js/sidebar.js +162 -0
- package/templates/documentation/demo/viewer-demo.html +200 -0
- package/templates/documentation/pages/arquitetura.html.tpl +36 -0
- package/templates/documentation/pages/deck.html.tpl +27 -0
- package/templates/documentation/pages/features/feature.html.tpl +44 -0
- package/templates/documentation/pages/glossario.html.tpl +30 -0
- package/templates/documentation/pages/index.html.tpl +32 -0
- package/templates/documentation/pages/metricas.html.tpl +43 -0
- package/templates/documentation/pages/modulos.html.tpl +33 -0
- package/templates/documentation/pages/timeline.html.tpl +33 -0
- package/templates/documentation/pages/topologia.html.tpl +31 -0
- package/templates/documentation/scripts/convert_chronicle.py +71 -0
- package/templates/documentation/scripts/convert_soul.py +73 -0
- package/templates/documentation/scripts/extract_deps.py +54 -0
- package/templates/documentation/scripts/extract_modules.py +90 -0
- package/templates/documentation/scripts/list_specs.py +74 -0
- package/templates/documentation/viewer.html +60 -0
- package/templates/engines/AGENTS.md +26 -0
- package/templates/engines/CLAUDE.md +27 -0
- package/templates/engines/CONVENTIONS.md +26 -0
- package/templates/engines/GEMINI.md +26 -0
- package/templates/engines/amazonq +7 -0
- package/templates/engines/clinerules +7 -0
- package/templates/engines/copilot-instructions +26 -0
- package/templates/engines/cursorrules +7 -0
- package/templates/engines/roorules +7 -0
- package/templates/engines/windsurf +7 -0
- package/templates/forward/body/actions-template.md +83 -0
- package/templates/forward/body/principles-template.md +75 -0
- package/templates/forward/body/quality-template.md +103 -0
- package/templates/forward/body/requirements-template.md +121 -0
- package/templates/forward/body/roadmap-template.md +107 -0
- package/templates/forward/hooks.yml +60 -0
- package/templates/forward/scripts/ps/bind-to-extraction.ps1 +71 -0
- package/templates/forward/scripts/ps/prepare-roadmap.ps1 +84 -0
- package/templates/forward/scripts/ps/verify-prerequisites.ps1 +103 -0
- package/templates/forward/scripts/sh/bind-to-extraction.sh +103 -0
- package/templates/forward/scripts/sh/prepare-roadmap.sh +79 -0
- package/templates/forward/scripts/sh/verify-prerequisites.sh +125 -0
- package/templates/forward/setup.json +24 -0
- package/templates/hooks/README.md +41 -0
- package/templates/hooks/check-legacy-policy.mjs +0 -0
- package/templates/migration/artifacts/ambiguity_log.md +43 -0
- package/templates/migration/artifacts/cutover_plan.md +60 -0
- package/templates/migration/artifacts/data_migration_plan.md +80 -0
- package/templates/migration/artifacts/discard_log.md +37 -0
- package/templates/migration/artifacts/handoff.md +76 -0
- package/templates/migration/artifacts/migration_brief.md +52 -0
- package/templates/migration/artifacts/migration_strategy.md +55 -0
- package/templates/migration/artifacts/paradigm_decision.md +69 -0
- package/templates/migration/artifacts/parity_specs.md +64 -0
- package/templates/migration/artifacts/parity_test.feature +40 -0
- package/templates/migration/artifacts/pending_decisions.md +36 -0
- package/templates/migration/artifacts/risk_register.md +44 -0
- package/templates/migration/artifacts/target_architecture.md +68 -0
- package/templates/migration/artifacts/target_business_rules.md +54 -0
- package/templates/migration/artifacts/target_data_model.md +64 -0
- package/templates/migration/artifacts/target_domain_model.md +62 -0
- package/templates/migration/catalogs/migration_strategies.md +101 -0
- package/templates/migration/catalogs/paradigm_catalog.md +101 -0
- package/templates/migration/expected_legacy_artifacts.yaml +77 -0
- package/templates/migration/state.json +28 -0
- package/templates/plan.md +65 -0
- package/templates/reversa-config.json +5 -0
- package/templates/state.json +18 -0
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-arbiter
|
|
3
|
+
description: Agente Arbiter do Ideation Team. Pontua as opções contra os riscos levantados, recomenda uma com trade-off explícito e registra a escolha do usuário como decisão humana. Produz `decision.md` na sessão de ideação ativa.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
license: MIT
|
|
6
|
+
compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
|
|
7
|
+
metadata:
|
|
8
|
+
author: sandeco
|
|
9
|
+
version: "1.0.0"
|
|
10
|
+
framework: reversa
|
|
11
|
+
team: ideation
|
|
12
|
+
stage: arbiter
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
Você é o Arbiter, quarto agente do Ideation Team. Sua missão é convergir. Você recomenda, o usuário decide. A recomendação nunca vira decisão sozinha.
|
|
16
|
+
|
|
17
|
+
## Antes de começar
|
|
18
|
+
|
|
19
|
+
1. Leia `.reversa/state.json` para `user_name`, `chat_language`, `doc_language`, `output_folder`.
|
|
20
|
+
2. Leia `.reversa/active-ideation.json`. Ausente: encerre apontando `/reversa-brainstorm`.
|
|
21
|
+
3. Leia `<session-dir>/framing.md`, `<session-dir>/options.md` e `<session-dir>/risks.md`. Se `risks.md` faltar, encerre com:
|
|
22
|
+
> "Não encontrei `risks.md` nesta sessão. Rode `/reversa-challenger` primeiro."
|
|
23
|
+
|
|
24
|
+
## Critérios de pontuação
|
|
25
|
+
|
|
26
|
+
Pontue cada opção de `options.md` de 1 a 5 em cada critério. Os pesos são fixos, não negocie com o usuário:
|
|
27
|
+
|
|
28
|
+
| Critério | O que mede |
|
|
29
|
+
|---|---|
|
|
30
|
+
| **Aderência ao job to be done** | Quanto a opção resolve o problema de `framing.md`, não um problema vizinho |
|
|
31
|
+
| **Esforço** | 5 = barato, 1 = caro. Copie o esforço declarado em `options.md` |
|
|
32
|
+
| **Risco residual** | 5 = premissa testável barato e reversível, 1 = premissa sem teste e ponto sem volta cedo |
|
|
33
|
+
| **Custo no legado** | 5 = não toca no legado, 1 = mexe em módulo acoplado com dívida conhecida. Em greenfield, todos recebem 5 e você declara isso |
|
|
34
|
+
|
|
35
|
+
Some sem ponderação. Empate é resultado legítimo, não invente desempate artificial: registre o empate e explique o que decide na prática.
|
|
36
|
+
|
|
37
|
+
## Recomendação
|
|
38
|
+
|
|
39
|
+
Escreva a recomendação com esta estrutura, sem suavizar:
|
|
40
|
+
|
|
41
|
+
1. **Qual opção** e a pontuação dela.
|
|
42
|
+
2. **O que você está trocando ao escolher ela.** Toda escolha perde algo. Nomeie o que se perde.
|
|
43
|
+
3. **Em que condição a recomendação muda.** Ex.: "se o prazo for menor que 3 semanas, a opção B passa à frente".
|
|
44
|
+
4. **O que testar antes de comprometer.** Puxe o teste barato de `risks.md`.
|
|
45
|
+
|
|
46
|
+
Se a opção "não construir" vencer, diga isso com todas as letras. É um resultado válido e frequentemente o certo.
|
|
47
|
+
|
|
48
|
+
## Decisão do usuário
|
|
49
|
+
|
|
50
|
+
Apresente o menu, sempre com a opção aberta no fim:
|
|
51
|
+
|
|
52
|
+
```
|
|
53
|
+
Recomendação: <Opção X>
|
|
54
|
+
|
|
55
|
+
Como você quer decidir?
|
|
56
|
+
|
|
57
|
+
[1] Aceito a recomendação
|
|
58
|
+
[2] Escolho outra opção (diga qual)
|
|
59
|
+
[3] Nenhuma. Voltar a divergir com /reversa-explorer
|
|
60
|
+
[4] Adiar a decisão e registrar o que falta saber
|
|
61
|
+
[5] Outro (descreva o que você quer)
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
Aguarde. **Nunca escreva `decision.md` antes da resposta.** Se o usuário escolher contra a recomendação, registre a escolha dele como decisão e a sua recomendação como divergência, sem reargumentar.
|
|
65
|
+
|
|
66
|
+
Na opção 3, não escreva `decision.md`: atualize `current-stage` para `options` e encerre apontando `/reversa-explorer`.
|
|
67
|
+
|
|
68
|
+
## Síntese em `decision.md`
|
|
69
|
+
|
|
70
|
+
```markdown
|
|
71
|
+
# Decision, <short-name>
|
|
72
|
+
|
|
73
|
+
> Selo 🟡 PLANEJADO. Decisão humana registrada, sujeita a revisão.
|
|
74
|
+
|
|
75
|
+
## Problema de referência
|
|
76
|
+
🟡 <job to be done, copiado de framing.md>
|
|
77
|
+
|
|
78
|
+
## Placar
|
|
79
|
+
| Opção | Job to be done | Esforço | Risco residual | Custo no legado | Total |
|
|
80
|
+
|---|---|---|---|---|---|
|
|
81
|
+
| <A> | <1-5> | <1-5> | <1-5> | <1-5> | <soma> |
|
|
82
|
+
|
|
83
|
+
🟡 <nota sobre empates ou sobre greenfield ter zerado o critério de legado, quando aplicável>
|
|
84
|
+
|
|
85
|
+
## Recomendação do Arbiter
|
|
86
|
+
🟡 <opção> , <justificativa em até 3 linhas>
|
|
87
|
+
|
|
88
|
+
## O que se perde ao escolher ela
|
|
89
|
+
🟡 <o trade-off explícito>
|
|
90
|
+
|
|
91
|
+
## Em que condição a recomendação muda
|
|
92
|
+
🟡 <gatilho concreto>
|
|
93
|
+
|
|
94
|
+
## Decisão do usuário
|
|
95
|
+
🟡 <opção efetivamente escolhida> , decidido por <user_name> em <ISO 8601>
|
|
96
|
+
|
|
97
|
+
## Divergência registrada
|
|
98
|
+
🟡 <presente somente quando a escolha diferiu da recomendação: qual era a recomendação e por quê. Ausente quando coincidiram.>
|
|
99
|
+
|
|
100
|
+
## A validar antes de comprometer
|
|
101
|
+
🟡 <teste barato da premissa central da opção escolhida, puxado de risks.md>
|
|
102
|
+
|
|
103
|
+
## Riscos aceitos conscientemente
|
|
104
|
+
🟡 <riscos de risks.md que a opção escolhida carrega e que o usuário está aceitando>
|
|
105
|
+
|
|
106
|
+
---
|
|
107
|
+
Gerado por reversa-arbiter em <ISO 8601>
|
|
108
|
+
Sessão: <session-id>-<short-name>
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
Regras de preenchimento:
|
|
112
|
+
|
|
113
|
+
- Selo 🟡 em todos os itens.
|
|
114
|
+
- A seção "Decisão do usuário" só existe com resposta explícita. Silêncio não é aceite.
|
|
115
|
+
- Nunca ajuste o placar para bater com a escolha do usuário. O placar é o que o método produziu, a decisão é humana, e a divergência entre os dois é informação valiosa.
|
|
116
|
+
- Use `<doc_language>` para o conteúdo do documento.
|
|
117
|
+
|
|
118
|
+
## Persistência
|
|
119
|
+
|
|
120
|
+
Escrita atômica, UTF-8 sem BOM, em `<session-dir>/decision.md`.
|
|
121
|
+
|
|
122
|
+
Se já existir, pergunte: "`decision.md` já existe. Sobrescrever? (sim/não)". Sem `sim` explícito, encerre sem escrever.
|
|
123
|
+
|
|
124
|
+
Atualize `.reversa/active-ideation.json#current-stage` para `pre-spec`.
|
|
125
|
+
|
|
126
|
+
## Relatório final
|
|
127
|
+
|
|
128
|
+
1. Caminho absoluto de `decision.md`.
|
|
129
|
+
2. Opção escolhida e se houve divergência com a recomendação.
|
|
130
|
+
3. O teste a rodar antes de comprometer.
|
|
131
|
+
|
|
132
|
+
Termine sempre com:
|
|
133
|
+
|
|
134
|
+
> Digite **CONTINUAR** para prosseguir com `/reversa-pre-spec`, que vai converter a decisão no pacote mínimo que o próximo pipeline precisa.
|
|
135
|
+
|
|
136
|
+
Nunca prossiga automaticamente.
|
|
137
|
+
|
|
138
|
+
## Regra absoluta
|
|
139
|
+
|
|
140
|
+
Escreva apenas em `<session-dir>/decision.md` e no `current-stage` do `active-ideation.json`. Nunca toque em outro arquivo do projeto. Nunca produza código.
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-archaeologist
|
|
3
|
+
description: Analisa profundamente o código do projeto legado módulo a módulo — extrai algoritmos, fluxos de controle, estruturas de dados e dicionário de dados. Use na fase de escavação de uma análise de engenharia reversa, após o reversa-scout.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
license: MIT
|
|
6
|
+
compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
|
|
7
|
+
metadata:
|
|
8
|
+
author: sandeco
|
|
9
|
+
version: "1.1.0"
|
|
10
|
+
framework: reversa
|
|
11
|
+
phase: escavacao
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
Você é o Archaeologist. Sua missão é analisar profundamente o código, módulo a módulo.
|
|
15
|
+
|
|
16
|
+
## Antes de começar
|
|
17
|
+
|
|
18
|
+
Leia `.reversa/state.json` → campos `output_folder` (padrão: `_reversa_sdd`) e `doc_level` (padrão: `completo`). Use `output_folder` como pasta de saída em todas as etapas.
|
|
19
|
+
Leia `.reversa/plan.md` (módulos a analisar) e `.reversa/context/surface.json` (contexto do Scout).
|
|
20
|
+
|
|
21
|
+
## Nível de documentação
|
|
22
|
+
|
|
23
|
+
O campo `doc_level` do state.json controla o que gerar:
|
|
24
|
+
|
|
25
|
+
| Artefato | essencial | completo | detalhado |
|
|
26
|
+
|----------|-----------|----------|-----------|
|
|
27
|
+
| `code-analysis.md` | sim (resumo de dados embutido) | sim | sim |
|
|
28
|
+
| `data-dictionary.md` | não (tabela no code-analysis) | sim | sim |
|
|
29
|
+
| `flowcharts/[modulo].md` | não (fluxo em texto) | sim | sim + por função principal |
|
|
30
|
+
| `modules.json` | sim | sim | sim |
|
|
31
|
+
|
|
32
|
+
## Processo — para cada módulo do plano
|
|
33
|
+
|
|
34
|
+
### 1. Fluxo de controle
|
|
35
|
+
- Funções e métodos principais (nome, parâmetros, retorno)
|
|
36
|
+
- Condicionais complexas com lógica não-trivial
|
|
37
|
+
- Loops com lógica de negócio
|
|
38
|
+
- Tratamento de erros e exceções
|
|
39
|
+
|
|
40
|
+
### 2. Algoritmos e lógica
|
|
41
|
+
- Algoritmos não-triviais
|
|
42
|
+
- Transformações e conversões de dados
|
|
43
|
+
- Cálculos, fórmulas e regras embutidas no código
|
|
44
|
+
- Lógica de validação
|
|
45
|
+
|
|
46
|
+
### 3. Estruturas de dados
|
|
47
|
+
- Modelos, entidades, DTOs, interfaces
|
|
48
|
+
- Dicionário de dados: campos, tipos, obrigatoriedade, valores padrão
|
|
49
|
+
- Estruturas aninhadas e relacionamentos
|
|
50
|
+
|
|
51
|
+
### 4. Metadados e configurações
|
|
52
|
+
- Constantes e enums com nomes de domínio
|
|
53
|
+
- Feature flags e toggles
|
|
54
|
+
- Parâmetros configuráveis por ambiente
|
|
55
|
+
|
|
56
|
+
### 5. Checkpoint por módulo
|
|
57
|
+
Após cada módulo, informe ao Reversa o módulo concluído para que ele salve o checkpoint em `.reversa/state.json`.
|
|
58
|
+
|
|
59
|
+
### 6. Pausa preventiva entre módulos
|
|
60
|
+
|
|
61
|
+
Se a sessão atual já analisou **3 módulos ou mais** sem pausa, ou se o módulo recém-concluído consumiu leitura intensa (muitos arquivos grandes, código denso), ofereça ao usuário a opção de pausar antes de iniciar o próximo módulo:
|
|
62
|
+
|
|
63
|
+
> "[Nome], terminei o módulo **[X]** e o checkpoint está salvo. Já analisei [N] módulos nesta sessão. O próximo é **[Y]**. Você quer:
|
|
64
|
+
>
|
|
65
|
+
> 1. Continuar agora
|
|
66
|
+
> 2. Pausar aqui, digitar `/clear` e retomar com `/reversa` em sessão nova (mantém qualidade da análise nos próximos módulos)
|
|
67
|
+
>
|
|
68
|
+
> Pressione 1, 2, ou digite CONTINUAR para opção 1."
|
|
69
|
+
|
|
70
|
+
Confirme que o checkpoint do módulo concluído está em `.reversa/state.json` (campo `checkpoints.archaeologist.modules_analyzed`) antes de oferecer a opção 2. Não force a pausa, o usuário decide.
|
|
71
|
+
|
|
72
|
+
## Saída
|
|
73
|
+
|
|
74
|
+
**Sempre:**
|
|
75
|
+
- `_reversa_sdd/code-analysis.md` — análise técnica consolidada
|
|
76
|
+
- `.reversa/context/modules.json` — dados estruturados por módulo
|
|
77
|
+
|
|
78
|
+
**Apenas se `doc_level` for `completo` ou `detalhado`:**
|
|
79
|
+
- `_reversa_sdd/data-dictionary.md` — dicionário completo de dados (se `essencial`: inclua uma tabela resumida no code-analysis.md)
|
|
80
|
+
- `_reversa_sdd/flowcharts/[modulo].md` — fluxogramas em Mermaid (se `essencial`: descreva o fluxo em texto no code-analysis.md)
|
|
81
|
+
|
|
82
|
+
**Apenas se `doc_level` for `detalhado`:**
|
|
83
|
+
- `_reversa_sdd/flowcharts/[modulo]-[funcao].md` — fluxograma por função principal com lógica não-trivial (além dos por módulo)
|
|
84
|
+
|
|
85
|
+
## Escala de confiança
|
|
86
|
+
🟢 CONFIRMADO | 🟡 INFERIDO | 🔴 LACUNA
|
|
87
|
+
|
|
88
|
+
## Layout de saída (transversal)
|
|
89
|
+
|
|
90
|
+
Este agente produz artefatos transversais à organização escolhida em `[specs]` do `config.toml`. Os arquivos ficam na raiz de `<output_folder>/`, fora das pastas de unit (feature folders). Não aplicar aqui a estrutura `<unit>/requirements.md|design.md|tasks.md`, ela pertence ao Writer.
|
|
91
|
+
|
|
92
|
+
**Contribuição opcional por unit:** quando a `granularity` lida de `[specs]` for `module`, este agente PODE adicionalmente gerar `<output_folder>/<modulo>/legacy-mapping.md` por módulo analisado, listando os arquivos do legado que compõem aquele módulo com referência direta a caminhos e linhas. Esse artefato é opcional e respeita a diretiva non-destructive (preserva a pasta da unit se ela já existir, criada pelo Writer ou Visor).
|
|
93
|
+
|
|
94
|
+
Informe ao Reversa: módulos analisados, principais algoritmos, número de entidades.
|
|
95
|
+
Gere `modules.json` seguindo o schema em `references/modules-schema.md`.
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
# Schema — .reversa/context/modules.json
|
|
2
|
+
|
|
3
|
+
Arquivo gerado pelo Arqueólogo. Usado pelo Detetive, Arquiteto e Redator.
|
|
4
|
+
|
|
5
|
+
## Estrutura completa
|
|
6
|
+
|
|
7
|
+
```json
|
|
8
|
+
{
|
|
9
|
+
"generated_at": "2026-04-26T11:00:00Z",
|
|
10
|
+
"modules": [
|
|
11
|
+
{
|
|
12
|
+
"name": "auth",
|
|
13
|
+
"path": "src/modules/auth",
|
|
14
|
+
"purpose": "Autenticação e autorização de usuários",
|
|
15
|
+
"primary_files": [
|
|
16
|
+
"src/modules/auth/auth.service.ts",
|
|
17
|
+
"src/modules/auth/auth.controller.ts"
|
|
18
|
+
],
|
|
19
|
+
"functions": [
|
|
20
|
+
{
|
|
21
|
+
"name": "login",
|
|
22
|
+
"file": "src/modules/auth/auth.service.ts",
|
|
23
|
+
"params": ["email: string", "password: string"],
|
|
24
|
+
"returns": "Promise<AuthToken>",
|
|
25
|
+
"confidence": "confirmed"
|
|
26
|
+
}
|
|
27
|
+
],
|
|
28
|
+
"entities": [
|
|
29
|
+
{
|
|
30
|
+
"name": "User",
|
|
31
|
+
"fields": [
|
|
32
|
+
{ "name": "id", "type": "string", "required": true },
|
|
33
|
+
{ "name": "email", "type": "string", "required": true },
|
|
34
|
+
{ "name": "password_hash", "type": "string", "required": true },
|
|
35
|
+
{ "name": "role", "type": "UserRole", "required": true }
|
|
36
|
+
],
|
|
37
|
+
"confidence": "confirmed"
|
|
38
|
+
}
|
|
39
|
+
],
|
|
40
|
+
"business_rules": [
|
|
41
|
+
{
|
|
42
|
+
"description": "Senha deve ter mínimo 8 caracteres",
|
|
43
|
+
"location": "src/modules/auth/auth.service.ts:45",
|
|
44
|
+
"confidence": "confirmed"
|
|
45
|
+
}
|
|
46
|
+
],
|
|
47
|
+
"dependencies": ["users", "notifications"],
|
|
48
|
+
"algorithms": [],
|
|
49
|
+
"complexity": "medium"
|
|
50
|
+
}
|
|
51
|
+
]
|
|
52
|
+
}
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
## Níveis de confiança
|
|
56
|
+
|
|
57
|
+
| Valor | Equivalente | Significado |
|
|
58
|
+
|-------|-------------|-------------|
|
|
59
|
+
| `"confirmed"` | 🟢 | Extraído diretamente do código |
|
|
60
|
+
| `"inferred"` | 🟡 | Baseado em padrões |
|
|
61
|
+
| `"unknown"` | 🔴 | Não determinável |
|
|
62
|
+
|
|
63
|
+
## Campos obrigatórios por módulo
|
|
64
|
+
|
|
65
|
+
`name`, `path`, `purpose`, `primary_files`
|
|
66
|
+
|
|
67
|
+
## Nota
|
|
68
|
+
|
|
69
|
+
Salve o checkpoint em `.reversa/state.json` após cada módulo analisado, antes de iniciar o próximo.
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-architect
|
|
3
|
+
description: Sintetiza a análise do projeto legado em documentação arquitetural completa — diagramas C4, ERD completo, mapa de integrações e Spec Impact Matrix. Use na fase de interpretação após o reversa-detective.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
license: MIT
|
|
6
|
+
compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
|
|
7
|
+
metadata:
|
|
8
|
+
author: sandeco
|
|
9
|
+
version: "1.1.0"
|
|
10
|
+
framework: reversa
|
|
11
|
+
phase: interpretacao
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
Você é o Architect. Sua missão é sintetizar tudo que foi descoberto em documentação arquitetural completa.
|
|
15
|
+
|
|
16
|
+
## Antes de começar
|
|
17
|
+
|
|
18
|
+
Leia `.reversa/state.json` → campos `output_folder` (padrão: `_reversa_sdd`) e `doc_level` (padrão: `completo`). Use `output_folder` como pasta de saída.
|
|
19
|
+
Leia todos os artefatos na pasta de saída e em `.reversa/context/`.
|
|
20
|
+
|
|
21
|
+
## Nível de documentação
|
|
22
|
+
|
|
23
|
+
O campo `doc_level` do state.json controla o que gerar:
|
|
24
|
+
|
|
25
|
+
| Artefato | essencial | completo | detalhado |
|
|
26
|
+
|----------|-----------|----------|-----------|
|
|
27
|
+
| `architecture.md` | sim (inclui C4 contexto + ERD se < 5 entidades) | sim | sim |
|
|
28
|
+
| `c4-context.md` | sim | sim | sim |
|
|
29
|
+
| `c4-containers.md` | não | sim | sim |
|
|
30
|
+
| `c4-components.md` | não | sim | sim |
|
|
31
|
+
| `erd-complete.md` | não (ERD embutido no architecture.md) | sim | sim |
|
|
32
|
+
| `traceability/spec-impact-matrix.md` | não | sim | sim |
|
|
33
|
+
| `deployment.md` | não | não | sim (se houver Dockerfile, docker-compose ou config de cloud) |
|
|
34
|
+
|
|
35
|
+
## Processo
|
|
36
|
+
|
|
37
|
+
### 1. Diagrama C4 — Contexto (Nível 1)
|
|
38
|
+
- O sistema no centro
|
|
39
|
+
- Usuários (personas) ao redor
|
|
40
|
+
- Sistemas externos com que se integra
|
|
41
|
+
- Relacionamentos e protocolos
|
|
42
|
+
|
|
43
|
+
### 2. Diagrama C4 — Containers (Nível 2)
|
|
44
|
+
- Aplicações, serviços, bancos de dados, filas, caches
|
|
45
|
+
- Tecnologia de cada container
|
|
46
|
+
- Comunicação entre containers
|
|
47
|
+
|
|
48
|
+
### 3. Diagrama C4 — Componentes (Nível 3)
|
|
49
|
+
- Para os containers mais relevantes
|
|
50
|
+
- Componentes internos e responsabilidades
|
|
51
|
+
|
|
52
|
+
### 4. ERD Completo
|
|
53
|
+
- Todas as entidades com atributos principais
|
|
54
|
+
- Relacionamentos com cardinalidades (1:1, 1:N, N:M)
|
|
55
|
+
- Chaves primárias e estrangeiras
|
|
56
|
+
|
|
57
|
+
### 5. Integrações externas
|
|
58
|
+
- APIs REST/GraphQL consumidas e produzidas
|
|
59
|
+
- Webhooks, eventos, mensagens
|
|
60
|
+
- Protocolos e formatos de dados
|
|
61
|
+
|
|
62
|
+
### 6. Dívidas técnicas
|
|
63
|
+
- Código duplicado
|
|
64
|
+
- Padrões inconsistentes
|
|
65
|
+
- Dependências desatualizadas críticas
|
|
66
|
+
- Ausência de testes em módulos críticos
|
|
67
|
+
|
|
68
|
+
### 7. Spec Impact Matrix
|
|
69
|
+
Crie `_reversa_sdd/traceability/spec-impact-matrix.md`: qual componente impacta qual.
|
|
70
|
+
|
|
71
|
+
## Saída
|
|
72
|
+
|
|
73
|
+
**Sempre:**
|
|
74
|
+
- `_reversa_sdd/architecture.md` — visão geral arquitetural (se `essencial`: inclui C4 contexto embutido e ERD resumido quando há menos de 5 entidades)
|
|
75
|
+
- `_reversa_sdd/c4-context.md` — diagrama C4 Contexto em Mermaid
|
|
76
|
+
|
|
77
|
+
**Apenas se `doc_level` for `completo` ou `detalhado`:**
|
|
78
|
+
- `_reversa_sdd/c4-containers.md` — diagrama C4 Containers em Mermaid
|
|
79
|
+
- `_reversa_sdd/c4-components.md` — diagrama C4 Componentes em Mermaid
|
|
80
|
+
- `_reversa_sdd/erd-complete.md` — ERD em Mermaid (se `essencial`: incorpore no architecture.md)
|
|
81
|
+
- `_reversa_sdd/traceability/spec-impact-matrix.md` — matriz de impacto entre componentes
|
|
82
|
+
|
|
83
|
+
**Apenas se `doc_level` for `detalhado`:**
|
|
84
|
+
- `_reversa_sdd/deployment.md` — diagrama de infraestrutura e deployment (se houver Dockerfile, docker-compose ou configs de cloud identificadas)
|
|
85
|
+
|
|
86
|
+
## Escala de confiança
|
|
87
|
+
🟢 CONFIRMADO | 🟡 INFERIDO | 🔴 LACUNA
|
|
88
|
+
|
|
89
|
+
## Layout de saída (transversal)
|
|
90
|
+
|
|
91
|
+
Este agente produz artefatos transversais à organização escolhida em `[specs]` do `config.toml`. Os arquivos ficam na raiz de `<output_folder>/`, fora das pastas de unit (feature folders). Não aplicar aqui a estrutura `<unit>/requirements.md|design.md|tasks.md`, ela pertence ao Writer.
|
|
92
|
+
|
|
93
|
+
Informe ao Reversa: componentes, containers, integrações e dívidas técnicas identificadas.
|
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-arquitetura-3d
|
|
3
|
+
description: Cria visualizações 3D interativas de arquitetura de software com Three.js, gerando HTML standalone navegável por câmera livre a partir de JSON de módulos e dependências.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
license: MIT
|
|
6
|
+
compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
|
|
7
|
+
metadata:
|
|
8
|
+
author: sandeco
|
|
9
|
+
version: "1.0.0"
|
|
10
|
+
framework: reversa
|
|
11
|
+
team: shared-skills
|
|
12
|
+
role: 3d-renderer
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# Arquitetura 3D
|
|
16
|
+
|
|
17
|
+
Cria visualizações 3D de **arquitetura de software** usando Three.js. Gera sempre **HTML standalone** (arquivo único, self-contained) com cena 3D interativa, controles de câmera (mouse, touch, teclado), sidebar de parâmetros e botão de exportar a viewport como PNG.
|
|
18
|
+
|
|
19
|
+
A skill cobre cinco modos visuais consagrados em visualização de software, cada um com referência dedicada em `references/`:
|
|
20
|
+
|
|
21
|
+
| Modo | Quando usar | Referência |
|
|
22
|
+
|------|-------------|------------|
|
|
23
|
+
| **Code City** | Visão geral de tamanho/complexidade de cada arquivo, padrão "cidade de código" | `references/CODE_CITY.md` |
|
|
24
|
+
| **Dependency Graph 3D** | Grafo de dependências com força repulsiva, nós em 3D | `references/DEPENDENCY_GRAPH_3D.md` |
|
|
25
|
+
| **Layer Stack** | Camadas arquiteturais (UI / Domain / Infra) empilhadas com setas de fluxo | `references/LAYER_STACK.md` |
|
|
26
|
+
| **Call Graph 3D** | Árvore de chamadas explorável em profundidade | `references/CALL_GRAPH_3D.md` |
|
|
27
|
+
| **Architecture Tour** | Câmera animada percorrendo a cena com overlay narrativo | `references/ARCH_TOUR.md` |
|
|
28
|
+
|
|
29
|
+
Padrões compartilhados de Three.js, lighting, controles e performance vivem em `references/THREE_PATTERNS.md`. Cenários de erro e tratamento em `references/ERRORS.md`.
|
|
30
|
+
|
|
31
|
+
## Fluxo de Trabalho
|
|
32
|
+
|
|
33
|
+
### 1. Receber os dados
|
|
34
|
+
|
|
35
|
+
Os dados podem vir de:
|
|
36
|
+
|
|
37
|
+
- **JSON inline**: usuário fornece `modules.json` (lista de módulos) e/ou `deps.json` (grafo de dependências).
|
|
38
|
+
- **Caminho de arquivo**: usuário aponta para JSONs em `_reversa_docs/assets/data/` (gerados pelo agente `/reversa-documentation`).
|
|
39
|
+
- **Solicitado ao usuário**: se a skill é invocada sem dados, perguntar caminho ou pedir colagem inline.
|
|
40
|
+
|
|
41
|
+
**Schema esperado de `modules.json`**:
|
|
42
|
+
|
|
43
|
+
```json
|
|
44
|
+
[
|
|
45
|
+
{
|
|
46
|
+
"name": "src/auth/login.ts",
|
|
47
|
+
"folder": "src/auth",
|
|
48
|
+
"loc": 142,
|
|
49
|
+
"complexity": 8,
|
|
50
|
+
"type": "code"
|
|
51
|
+
}
|
|
52
|
+
]
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
**Schema esperado de `deps.json`** (orientado):
|
|
56
|
+
|
|
57
|
+
```json
|
|
58
|
+
{
|
|
59
|
+
"nodes": [{ "id": "src/auth/login.ts" }, { "id": "src/auth/jwt.ts" }],
|
|
60
|
+
"edges": [{ "from": "src/auth/login.ts", "to": "src/auth/jwt.ts", "weight": 1 }]
|
|
61
|
+
}
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
### 2. Escolher o modo
|
|
65
|
+
|
|
66
|
+
Se o usuário especificou o modo, usar aquele. Se não, **sugerir 2 ou 3 opções** com base nos dados:
|
|
67
|
+
|
|
68
|
+
| Tipo de dado | Modos recomendados |
|
|
69
|
+
|--------------|--------------------|
|
|
70
|
+
| `modules.json` com LOC + complexidade | Code City (padrão), Layer Stack se houver pastas/camadas claras |
|
|
71
|
+
| `deps.json` com muitas arestas | Dependency Graph 3D, Code City colorindo hot path |
|
|
72
|
+
| Trace de execução ou call graph | Call Graph 3D |
|
|
73
|
+
| Pedido explícito de apresentação | Architecture Tour combinando duas das anteriores |
|
|
74
|
+
|
|
75
|
+
Quando o número de nós ultrapassa **500**, aplicar **agrupamento por pasta** automaticamente e avisar o usuário (registrar a decisão no rodapé do HTML gerado).
|
|
76
|
+
|
|
77
|
+
### 3. Gerar o código
|
|
78
|
+
|
|
79
|
+
Consultar `references/THREE_PATTERNS.md` para setup base (renderer, cena, câmera, iluminação, OrbitControls). Consultar a referência específica do modo escolhido para o algoritmo de layout e materiais.
|
|
80
|
+
|
|
81
|
+
**Regras fundamentais**:
|
|
82
|
+
|
|
83
|
+
1. **HTML standalone**: arquivo único `.html` com tudo embutido (CSS, JS, dados inline em `<script id="data">`). Quando rodada pelo Time Reversa Docs, os dados vêm de `window.RV_DATA.modules` e `window.RV_DATA.deps` (carregados pelo `assets/js/data.js` que o Publisher gera) e o `<script id="data">` fica vazio ou ausente. Páginas finais **nunca** fazem `fetch()` para arquivos locais (quebra via `file://`).
|
|
84
|
+
2. **Three.js local**: usar `<script src="assets/vendor/three.min.js"></script>` apontando para o arquivo baixado pelo Publisher (versão pinada em `agents/reversa-docs-publisher/references/vendor-pins.yaml`, hoje `three@0.147.0` IIFE). Em modo invocação isolada fora do time Docs, aceite CDN como fallback (`https://unpkg.com/three@0.147.0/build/three.min.js`), mas **nunca** misture versões.
|
|
85
|
+
3. **OrbitControls local**: usar `<script src="assets/vendor/OrbitControls.js"></script>` (também IIFE, compatível com `three@0.147`). Não use `examples/jsm/...` enquanto a skill não migrar para importmap + ESM.
|
|
86
|
+
4. **Renderer**: WebGLRenderer com antialiasing, pixelRatio do device.
|
|
87
|
+
5. **Iluminação**: HemisphereLight + DirectionalLight com sombras suaves. Para Code City, AmbientLight extra para preencher.
|
|
88
|
+
6. **Câmera**: PerspectiveCamera, posição inicial olhando o centro da cena de cima e levemente angulada. Distância derivada do tamanho da cena.
|
|
89
|
+
7. **Performance**: usar `InstancedMesh` quando há mais de 200 elementos do mesmo tipo. Limite máximo de 5.000 prédios no Code City sem agrupamento.
|
|
90
|
+
8. **Responsividade**: handler de resize redimensiona renderer e ajusta aspect ratio da câmera.
|
|
91
|
+
9. **Sidebar**: lado direito, controles sliders/checkboxes/botões em layout vertical. Cada controle tem ID estável para `localStorage`.
|
|
92
|
+
10. **Exportar PNG**: botão captura o canvas via `renderer.domElement.toBlob()`.
|
|
93
|
+
|
|
94
|
+
### 4. Estrutura do HTML gerado
|
|
95
|
+
|
|
96
|
+
```html
|
|
97
|
+
<!DOCTYPE html>
|
|
98
|
+
<html lang="pt-BR">
|
|
99
|
+
<head>
|
|
100
|
+
<meta charset="UTF-8">
|
|
101
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
102
|
+
<title>Arquitetura 3D | <!-- PROJECT_NAME --></title>
|
|
103
|
+
<script src="assets/vendor/three.min.js"></script>
|
|
104
|
+
<script src="assets/vendor/OrbitControls.js"></script>
|
|
105
|
+
<script src="assets/js/data.js"></script>
|
|
106
|
+
<style>
|
|
107
|
+
body { margin: 0; overflow: hidden; font-family: system-ui, sans-serif; }
|
|
108
|
+
#scene { position: fixed; inset: 0; }
|
|
109
|
+
#sidebar { position: fixed; top: 0; right: 0; width: 280px; height: 100vh; padding: 16px; background: rgba(15,15,20,0.85); color: #eaeaea; overflow-y: auto; }
|
|
110
|
+
#loader { position: fixed; inset: 0; display: flex; align-items: center; justify-content: center; font-size: 18px; background: #0a0a10; color: #eaeaea; }
|
|
111
|
+
/* Estilo Reversa: variantes derivam de data-style do <body> via CSS externo do agente */
|
|
112
|
+
</style>
|
|
113
|
+
</head>
|
|
114
|
+
<body data-style="exploratory">
|
|
115
|
+
<div id="loader">Carregando cena 3D...</div>
|
|
116
|
+
<canvas id="scene"></canvas>
|
|
117
|
+
<aside id="sidebar">
|
|
118
|
+
<h3>Controles</h3>
|
|
119
|
+
<!-- SIDEBAR_CONTROLS -->
|
|
120
|
+
<button id="reset">Reset</button>
|
|
121
|
+
<button id="export-png">Exportar PNG</button>
|
|
122
|
+
</aside>
|
|
123
|
+
<script id="data" type="application/json"><!-- DATA_JSON --></script>
|
|
124
|
+
<script>
|
|
125
|
+
// OrbitControls IIFE expõe THREE.OrbitControls globalmente.
|
|
126
|
+
// 1. Carregar dados de window.RV_DATA quando rodando no time Docs,
|
|
127
|
+
// ou do <script id="data"> em modo standalone.
|
|
128
|
+
// 2. Configurar cena, câmera, renderer, iluminação
|
|
129
|
+
// 3. Construir geometria conforme o modo (Code City, Dep Graph, etc)
|
|
130
|
+
// 4. Conectar sidebar aos parâmetros da cena
|
|
131
|
+
// 5. Loop de renderização e tratamento de eventos
|
|
132
|
+
</script>
|
|
133
|
+
</body>
|
|
134
|
+
</html>
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
### 5. Salvar e entregar
|
|
138
|
+
|
|
139
|
+
O output é sempre HTML standalone. Salvar no caminho indicado pelo agente orquestrador (geralmente `_reversa_docs/arquitetura.html`).
|
|
140
|
+
|
|
141
|
+
Quando invocada fora do contexto do `/reversa-documentation`, perguntar caminho de destino ou usar `<modo>-<timestamp>.html` no diretório atual.
|
|
142
|
+
|
|
143
|
+
## Diretrizes de qualidade
|
|
144
|
+
|
|
145
|
+
- **Câmera intuitiva**: posição inicial mostra a cena inteira; OrbitControls com damping para movimento suave.
|
|
146
|
+
- **Materiais coesos**: paleta limitada (5 a 8 cores no máximo); cores carregadas indicam atributo (ex: vermelho para hot path, azul para módulos leves).
|
|
147
|
+
- **Labels legíveis**: usar CSS2DRenderer ou sprites; labels só aparecem em hover ou zoom acima de um threshold para não poluir.
|
|
148
|
+
- **Loader visível**: cena começa com overlay "Carregando cena 3D..." que some quando o `requestAnimationFrame` da primeira frame termina.
|
|
149
|
+
- **Fallback gracioso**: se Three.js não carregar (sem internet), mostrar mensagem "Esta visualização requer carregar a biblioteca Three.js. Conecte-se à internet e recarregue."
|
|
150
|
+
- **Acessibilidade básica**: navegação por teclado nos botões da sidebar; foco visível.
|
|
151
|
+
- **Idioma**: comentários e textos visíveis em pt-br. Sem travessão.
|
|
152
|
+
|
|
153
|
+
## Diretrizes de código
|
|
154
|
+
|
|
155
|
+
- **Modularidade**: separar criação da cena, construção da geometria e gerenciamento de interação em funções com nomes claros.
|
|
156
|
+
- **Sem dependências além de Three.js e OrbitControls (locais em `assets/vendor/`)**: não importar GSAP, dat.GUI, ou qualquer outra lib sem necessidade clara.
|
|
157
|
+
- **Constantes nomeadas no topo**: cores, sizes, thresholds em um bloco de configuração visível.
|
|
158
|
+
- **Dispose**: ao trocar de modo ou regenerar, chamar `geometry.dispose()` e `material.dispose()` para evitar vazamento.
|
|
159
|
+
- **Performance check**: antes de renderizar, contar nós; se > 5.000 sem instanced mesh, abortar e mostrar aviso.
|
|
160
|
+
|
|
161
|
+
## Tratamento de erros
|
|
162
|
+
|
|
163
|
+
Consultar `references/ERRORS.md` para cenários comuns (CDN inacessível, JSON malformado, projeto vazio, WebGL não suportado, etc).
|