@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,230 @@
|
|
|
1
|
+
# Layer Stack 3D
|
|
2
|
+
|
|
3
|
+
Visualização de **camadas arquiteturais** empilhadas verticalmente, cada camada como um plano com seus módulos, conectadas por setas verticais que mostram o fluxo de dependências entre camadas.
|
|
4
|
+
|
|
5
|
+
## Mapeamento
|
|
6
|
+
|
|
7
|
+
| Conceito arquitetural | Visual |
|
|
8
|
+
|---|---|
|
|
9
|
+
| Camada (UI, Domain, Infra, etc) | Plano horizontal em altura distinta |
|
|
10
|
+
| Módulo dentro da camada | Caixa/disco posicionado no plano da camada |
|
|
11
|
+
| Dependência inter-camada | Linha vertical orientada conectando módulos |
|
|
12
|
+
| Direção do fluxo | Seta na ponta da linha |
|
|
13
|
+
| Violação de camada (camada de baixo importando de cima) | Linha vermelha pulsante |
|
|
14
|
+
|
|
15
|
+
## Quando usar
|
|
16
|
+
|
|
17
|
+
- Validar que a arquitetura segue Clean Architecture, Hexagonal, ou Onion.
|
|
18
|
+
- Detectar **violações de camada** (UI importando direto de Infra, por exemplo).
|
|
19
|
+
- Apresentar o sistema para stakeholders que pensam em camadas.
|
|
20
|
+
- Comparar com o diagrama arquitetural esperado lado a lado.
|
|
21
|
+
|
|
22
|
+
**Quando evitar**: sistemas sem separação clara de camadas (monolitos planos). Use Code City.
|
|
23
|
+
|
|
24
|
+
## Detecção de camadas
|
|
25
|
+
|
|
26
|
+
A skill aceita o mapeamento de camadas vindo do usuário (via JSON) ou tenta inferir de padrões de pasta.
|
|
27
|
+
|
|
28
|
+
**Mapeamento explícito**:
|
|
29
|
+
|
|
30
|
+
```json
|
|
31
|
+
{
|
|
32
|
+
"layers": [
|
|
33
|
+
{ "name": "UI", "order": 0, "folders": ["src/components", "src/pages"] },
|
|
34
|
+
{ "name": "Application", "order": 1, "folders": ["src/services", "src/use-cases"] },
|
|
35
|
+
{ "name": "Domain", "order": 2, "folders": ["src/domain", "src/entities"] },
|
|
36
|
+
{ "name": "Infrastructure", "order": 3, "folders": ["src/db", "src/external"] }
|
|
37
|
+
]
|
|
38
|
+
}
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
**Inferência heurística** (quando não fornecido): regex sobre nomes de pasta.
|
|
42
|
+
|
|
43
|
+
```javascript
|
|
44
|
+
const LAYER_PATTERNS = [
|
|
45
|
+
{ name: "UI", regex: /(components|pages|views|screens|ui)/i, order: 0 },
|
|
46
|
+
{ name: "Application", regex: /(services|use-cases|application|handlers)/i, order: 1 },
|
|
47
|
+
{ name: "Domain", regex: /(domain|entities|models|business)/i, order: 2 },
|
|
48
|
+
{ name: "Infrastructure", regex: /(db|database|repositories|external|infra|adapters)/i, order: 3 }
|
|
49
|
+
];
|
|
50
|
+
|
|
51
|
+
function inferLayer(folder) {
|
|
52
|
+
for (const p of LAYER_PATTERNS) {
|
|
53
|
+
if (p.regex.test(folder)) return p;
|
|
54
|
+
}
|
|
55
|
+
return { name: "Outros", order: 999 };
|
|
56
|
+
}
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
## Algoritmo de layout
|
|
60
|
+
|
|
61
|
+
### 1. Empilhar camadas verticalmente
|
|
62
|
+
|
|
63
|
+
```javascript
|
|
64
|
+
const LAYER_GAP = 80;
|
|
65
|
+
const LAYER_SIZE = 400; // plano 400x400
|
|
66
|
+
|
|
67
|
+
const layerPlanes = layers.map((layer, i) => ({
|
|
68
|
+
name: layer.name,
|
|
69
|
+
y: i * LAYER_GAP,
|
|
70
|
+
modules: modules.filter((m) => belongsToLayer(m, layer))
|
|
71
|
+
}));
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
### 2. Posicionar módulos dentro da camada
|
|
75
|
+
|
|
76
|
+
Empacotamento simples em grid 2D no plano da camada.
|
|
77
|
+
|
|
78
|
+
```javascript
|
|
79
|
+
layerPlanes.forEach((layer) => {
|
|
80
|
+
const cols = Math.ceil(Math.sqrt(layer.modules.length));
|
|
81
|
+
const cellSize = LAYER_SIZE / cols;
|
|
82
|
+
layer.modules.forEach((m, idx) => {
|
|
83
|
+
const col = idx % cols;
|
|
84
|
+
const row = Math.floor(idx / cols);
|
|
85
|
+
m.x = (col - cols / 2) * cellSize;
|
|
86
|
+
m.y = layer.y;
|
|
87
|
+
m.z = (row - cols / 2) * cellSize;
|
|
88
|
+
});
|
|
89
|
+
});
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### 3. Renderizar planos de camada
|
|
93
|
+
|
|
94
|
+
```javascript
|
|
95
|
+
layerPlanes.forEach((layer, i) => {
|
|
96
|
+
const planeGeo = new THREE.PlaneGeometry(LAYER_SIZE, LAYER_SIZE);
|
|
97
|
+
const planeMat = new THREE.MeshStandardMaterial({
|
|
98
|
+
color: LAYER_COLORS[i % LAYER_COLORS.length],
|
|
99
|
+
transparent: true,
|
|
100
|
+
opacity: 0.15,
|
|
101
|
+
side: THREE.DoubleSide
|
|
102
|
+
});
|
|
103
|
+
const plane = new THREE.Mesh(planeGeo, planeMat);
|
|
104
|
+
plane.rotation.x = Math.PI / 2;
|
|
105
|
+
plane.position.y = layer.y;
|
|
106
|
+
scene.add(plane);
|
|
107
|
+
|
|
108
|
+
// Label da camada lateral
|
|
109
|
+
const label = addLabel(layer.name, new THREE.Vector3(LAYER_SIZE / 2 + 20, layer.y, 0));
|
|
110
|
+
scene.add(label);
|
|
111
|
+
});
|
|
112
|
+
|
|
113
|
+
const LAYER_COLORS = [0x4a9eff, 0x6cc46c, 0xffc857, 0xb39ddb, 0xff9aa2];
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
### 4. Renderizar módulos como discos
|
|
117
|
+
|
|
118
|
+
```javascript
|
|
119
|
+
const moduleGeo = new THREE.CylinderGeometry(1, 1, 0.5, 16);
|
|
120
|
+
const moduleMat = new THREE.MeshStandardMaterial({ roughness: 0.5 });
|
|
121
|
+
const modulesMesh = new THREE.InstancedMesh(moduleGeo, moduleMat, modules.length);
|
|
122
|
+
|
|
123
|
+
modules.forEach((m, i) => {
|
|
124
|
+
const dummy = new THREE.Object3D();
|
|
125
|
+
const size = 1 + Math.sqrt(m.loc / 100);
|
|
126
|
+
dummy.position.set(m.x, m.y, m.z);
|
|
127
|
+
dummy.scale.set(size, 1, size);
|
|
128
|
+
dummy.updateMatrix();
|
|
129
|
+
modulesMesh.setMatrixAt(i, dummy.matrix);
|
|
130
|
+
});
|
|
131
|
+
modulesMesh.instanceMatrix.needsUpdate = true;
|
|
132
|
+
scene.add(modulesMesh);
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
### 5. Renderizar dependências como linhas verticais
|
|
136
|
+
|
|
137
|
+
```javascript
|
|
138
|
+
edges.forEach((e) => {
|
|
139
|
+
const src = modules.find((m) => m.name === e.from);
|
|
140
|
+
const dst = modules.find((m) => m.name === e.to);
|
|
141
|
+
if (!src || !dst) return;
|
|
142
|
+
|
|
143
|
+
const isViolation = isLayerViolation(src, dst);
|
|
144
|
+
const color = isViolation ? 0xff5a4f : 0x6c8eb0;
|
|
145
|
+
|
|
146
|
+
const points = [
|
|
147
|
+
new THREE.Vector3(src.x, src.y, src.z),
|
|
148
|
+
new THREE.Vector3(dst.x, dst.y, dst.z)
|
|
149
|
+
];
|
|
150
|
+
const geo = new THREE.BufferGeometry().setFromPoints(points);
|
|
151
|
+
const mat = new THREE.LineBasicMaterial({
|
|
152
|
+
color,
|
|
153
|
+
transparent: true,
|
|
154
|
+
opacity: isViolation ? 1.0 : 0.4
|
|
155
|
+
});
|
|
156
|
+
const line = new THREE.Line(geo, mat);
|
|
157
|
+
if (isViolation) line.userData.pulse = true; // anima opacidade
|
|
158
|
+
scene.add(line);
|
|
159
|
+
});
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
### 6. Detecção de violação de camada
|
|
163
|
+
|
|
164
|
+
A regra padrão (Clean Architecture): camadas só dependem de camadas com `order` maior (mais para "dentro").
|
|
165
|
+
|
|
166
|
+
```javascript
|
|
167
|
+
function isLayerViolation(src, dst) {
|
|
168
|
+
return src.layerOrder > dst.layerOrder;
|
|
169
|
+
}
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
Pode haver exceções configuráveis (ex: ports/adapters em hexagonal).
|
|
173
|
+
|
|
174
|
+
## Animação de violações
|
|
175
|
+
|
|
176
|
+
Linhas vermelhas pulsam (opacity oscilando) para chamar atenção.
|
|
177
|
+
|
|
178
|
+
```javascript
|
|
179
|
+
function pulseViolations(time) {
|
|
180
|
+
scene.traverse((obj) => {
|
|
181
|
+
if (obj.userData?.pulse) {
|
|
182
|
+
obj.material.opacity = 0.5 + 0.5 * Math.sin(time * 0.003);
|
|
183
|
+
}
|
|
184
|
+
});
|
|
185
|
+
}
|
|
186
|
+
```
|
|
187
|
+
|
|
188
|
+
## Sidebar de controles
|
|
189
|
+
|
|
190
|
+
```html
|
|
191
|
+
<aside id="sidebar">
|
|
192
|
+
<h3>Layer Stack</h3>
|
|
193
|
+
|
|
194
|
+
<label>Espaçamento entre camadas
|
|
195
|
+
<input type="range" min="40" max="200" value="80" data-param="layerGap">
|
|
196
|
+
</label>
|
|
197
|
+
|
|
198
|
+
<label>
|
|
199
|
+
<input type="checkbox" data-param="showViolations" checked> Destacar violações
|
|
200
|
+
</label>
|
|
201
|
+
|
|
202
|
+
<label>
|
|
203
|
+
<input type="checkbox" data-param="showLabels" checked> Labels de módulo
|
|
204
|
+
</label>
|
|
205
|
+
|
|
206
|
+
<label>Mostrar apenas
|
|
207
|
+
<select data-param="layerFilter">
|
|
208
|
+
<option value="all">Todas as camadas</option>
|
|
209
|
+
<!-- POPULATED -->
|
|
210
|
+
</select>
|
|
211
|
+
</label>
|
|
212
|
+
|
|
213
|
+
<div id="violations-count"></div>
|
|
214
|
+
|
|
215
|
+
<button id="reset">Reset</button>
|
|
216
|
+
<button id="export-png">Exportar PNG</button>
|
|
217
|
+
</aside>
|
|
218
|
+
```
|
|
219
|
+
|
|
220
|
+
O contador `#violations-count` mostra em tempo real "X violações detectadas".
|
|
221
|
+
|
|
222
|
+
## Interação
|
|
223
|
+
|
|
224
|
+
- **Hover em módulo**: tooltip com nome, camada, dependências.
|
|
225
|
+
- **Clique em violação**: foca câmera nos dois módulos envolvidos e mostra detalhes da relação no painel.
|
|
226
|
+
- **Filtro de camada**: oculta camadas não selecionadas.
|
|
227
|
+
|
|
228
|
+
## Performance
|
|
229
|
+
|
|
230
|
+
Camadas tipicamente têm dezenas a poucas centenas de módulos cada. Limite total de ~2.000 módulos. Acima disso, agrupar por pasta dentro de cada camada.
|
|
@@ -0,0 +1,221 @@
|
|
|
1
|
+
# Padrões Three.js para Visualização de Arquitetura
|
|
2
|
+
|
|
3
|
+
Referência rápida de setup, materiais e técnicas comuns a todos os modos da skill. Three.js v0.158+, ESM via CDN.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Setup base da cena
|
|
8
|
+
|
|
9
|
+
```javascript
|
|
10
|
+
import * as THREE from "https://cdn.jsdelivr.net/npm/three@0.158.0/build/three.module.js";
|
|
11
|
+
import { OrbitControls } from "https://cdn.jsdelivr.net/npm/three@0.158.0/examples/jsm/controls/OrbitControls.js";
|
|
12
|
+
|
|
13
|
+
const container = document.getElementById("scene-container");
|
|
14
|
+
const width = container.clientWidth;
|
|
15
|
+
const height = container.clientHeight;
|
|
16
|
+
|
|
17
|
+
// Cena
|
|
18
|
+
const scene = new THREE.Scene();
|
|
19
|
+
scene.background = new THREE.Color(0x0a0a14);
|
|
20
|
+
scene.fog = new THREE.Fog(0x0a0a14, 100, 800);
|
|
21
|
+
|
|
22
|
+
// Câmera
|
|
23
|
+
const camera = new THREE.PerspectiveCamera(50, width / height, 0.1, 2000);
|
|
24
|
+
camera.position.set(150, 200, 300);
|
|
25
|
+
camera.lookAt(0, 0, 0);
|
|
26
|
+
|
|
27
|
+
// Renderer
|
|
28
|
+
const renderer = new THREE.WebGLRenderer({ antialias: true, alpha: true });
|
|
29
|
+
renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
|
|
30
|
+
renderer.setSize(width, height);
|
|
31
|
+
renderer.shadowMap.enabled = true;
|
|
32
|
+
renderer.shadowMap.type = THREE.PCFSoftShadowMap;
|
|
33
|
+
container.appendChild(renderer.domElement);
|
|
34
|
+
|
|
35
|
+
// Controles
|
|
36
|
+
const controls = new OrbitControls(camera, renderer.domElement);
|
|
37
|
+
controls.enableDamping = true;
|
|
38
|
+
controls.dampingFactor = 0.08;
|
|
39
|
+
controls.minDistance = 20;
|
|
40
|
+
controls.maxDistance = 1500;
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
## Iluminação padrão
|
|
44
|
+
|
|
45
|
+
```javascript
|
|
46
|
+
// Luz ambiente leve para não ter sombras totalmente pretas
|
|
47
|
+
const ambient = new THREE.AmbientLight(0xffffff, 0.35);
|
|
48
|
+
scene.add(ambient);
|
|
49
|
+
|
|
50
|
+
// Hemisfério: céu vs chão, dá profundidade natural
|
|
51
|
+
const hemi = new THREE.HemisphereLight(0xddeeff, 0x202028, 0.5);
|
|
52
|
+
hemi.position.set(0, 200, 0);
|
|
53
|
+
scene.add(hemi);
|
|
54
|
+
|
|
55
|
+
// Direcional: simula sol, projeta sombras
|
|
56
|
+
const dir = new THREE.DirectionalLight(0xffffff, 0.85);
|
|
57
|
+
dir.position.set(80, 200, 100);
|
|
58
|
+
dir.castShadow = true;
|
|
59
|
+
dir.shadow.mapSize.set(2048, 2048);
|
|
60
|
+
dir.shadow.camera.left = -400;
|
|
61
|
+
dir.shadow.camera.right = 400;
|
|
62
|
+
dir.shadow.camera.top = 400;
|
|
63
|
+
dir.shadow.camera.bottom = -400;
|
|
64
|
+
scene.add(dir);
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
## Loop de renderização
|
|
68
|
+
|
|
69
|
+
```javascript
|
|
70
|
+
function tick() {
|
|
71
|
+
controls.update();
|
|
72
|
+
renderer.render(scene, camera);
|
|
73
|
+
requestAnimationFrame(tick);
|
|
74
|
+
}
|
|
75
|
+
tick();
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
## Handler de resize
|
|
79
|
+
|
|
80
|
+
```javascript
|
|
81
|
+
window.addEventListener("resize", () => {
|
|
82
|
+
const w = container.clientWidth;
|
|
83
|
+
const h = container.clientHeight;
|
|
84
|
+
camera.aspect = w / h;
|
|
85
|
+
camera.updateProjectionMatrix();
|
|
86
|
+
renderer.setSize(w, h);
|
|
87
|
+
});
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## InstancedMesh para grandes volumes
|
|
91
|
+
|
|
92
|
+
Quando há mais de 200 elementos do mesmo tipo (prédios do Code City, nós do dep graph), usar `InstancedMesh` em vez de loop com `add()`.
|
|
93
|
+
|
|
94
|
+
```javascript
|
|
95
|
+
const boxGeo = new THREE.BoxGeometry(1, 1, 1);
|
|
96
|
+
const mat = new THREE.MeshStandardMaterial({ color: 0xffffff });
|
|
97
|
+
const instanced = new THREE.InstancedMesh(boxGeo, mat, modules.length);
|
|
98
|
+
|
|
99
|
+
const dummy = new THREE.Object3D();
|
|
100
|
+
const colorObj = new THREE.Color();
|
|
101
|
+
|
|
102
|
+
modules.forEach((m, i) => {
|
|
103
|
+
dummy.position.set(m.x, m.height / 2, m.z);
|
|
104
|
+
dummy.scale.set(m.w, m.height, m.d);
|
|
105
|
+
dummy.updateMatrix();
|
|
106
|
+
instanced.setMatrixAt(i, dummy.matrix);
|
|
107
|
+
colorObj.set(m.color);
|
|
108
|
+
instanced.setColorAt(i, colorObj);
|
|
109
|
+
});
|
|
110
|
+
instanced.instanceMatrix.needsUpdate = true;
|
|
111
|
+
if (instanced.instanceColor) instanced.instanceColor.needsUpdate = true;
|
|
112
|
+
scene.add(instanced);
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
## Labels em CSS2D (legíveis sempre)
|
|
116
|
+
|
|
117
|
+
```javascript
|
|
118
|
+
import { CSS2DRenderer, CSS2DObject } from "https://cdn.jsdelivr.net/npm/three@0.158.0/examples/jsm/renderers/CSS2DRenderer.js";
|
|
119
|
+
|
|
120
|
+
const labelRenderer = new CSS2DRenderer();
|
|
121
|
+
labelRenderer.setSize(width, height);
|
|
122
|
+
labelRenderer.domElement.style.position = "absolute";
|
|
123
|
+
labelRenderer.domElement.style.top = "0";
|
|
124
|
+
labelRenderer.domElement.style.pointerEvents = "none";
|
|
125
|
+
container.appendChild(labelRenderer.domElement);
|
|
126
|
+
|
|
127
|
+
function addLabel(text, position) {
|
|
128
|
+
const div = document.createElement("div");
|
|
129
|
+
div.className = "label-3d";
|
|
130
|
+
div.textContent = text;
|
|
131
|
+
const label = new CSS2DObject(div);
|
|
132
|
+
label.position.copy(position);
|
|
133
|
+
return label;
|
|
134
|
+
}
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
No `tick()`, chamar `labelRenderer.render(scene, camera)` junto com o renderer principal.
|
|
138
|
+
|
|
139
|
+
**Regra**: mostrar labels apenas quando o nó está próximo da câmera (distância < threshold) ou em hover, para evitar poluição.
|
|
140
|
+
|
|
141
|
+
## Raycaster para hover e clique
|
|
142
|
+
|
|
143
|
+
```javascript
|
|
144
|
+
const raycaster = new THREE.Raycaster();
|
|
145
|
+
const pointer = new THREE.Vector2();
|
|
146
|
+
|
|
147
|
+
renderer.domElement.addEventListener("pointermove", (e) => {
|
|
148
|
+
const rect = renderer.domElement.getBoundingClientRect();
|
|
149
|
+
pointer.x = ((e.clientX - rect.left) / rect.width) * 2 - 1;
|
|
150
|
+
pointer.y = -((e.clientY - rect.top) / rect.height) * 2 + 1;
|
|
151
|
+
raycaster.setFromCamera(pointer, camera);
|
|
152
|
+
const hits = raycaster.intersectObject(instanced);
|
|
153
|
+
if (hits.length > 0) {
|
|
154
|
+
const i = hits[0].instanceId;
|
|
155
|
+
showTooltip(modules[i]);
|
|
156
|
+
} else {
|
|
157
|
+
hideTooltip();
|
|
158
|
+
}
|
|
159
|
+
});
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
## Sidebar reativa
|
|
163
|
+
|
|
164
|
+
```javascript
|
|
165
|
+
const sliders = document.querySelectorAll("aside input[type=range]");
|
|
166
|
+
sliders.forEach((slider) => {
|
|
167
|
+
slider.addEventListener("input", (e) => {
|
|
168
|
+
const param = e.target.dataset.param;
|
|
169
|
+
const value = parseFloat(e.target.value);
|
|
170
|
+
applyParam(param, value); // função específica do modo
|
|
171
|
+
localStorage.setItem(`arq3d.${param}`, value);
|
|
172
|
+
});
|
|
173
|
+
// restore
|
|
174
|
+
const saved = localStorage.getItem(`arq3d.${slider.dataset.param}`);
|
|
175
|
+
if (saved !== null) {
|
|
176
|
+
slider.value = saved;
|
|
177
|
+
slider.dispatchEvent(new Event("input"));
|
|
178
|
+
}
|
|
179
|
+
});
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
## Exportar PNG
|
|
183
|
+
|
|
184
|
+
```javascript
|
|
185
|
+
document.getElementById("export-png").addEventListener("click", () => {
|
|
186
|
+
renderer.render(scene, camera); // garantir frame atual
|
|
187
|
+
renderer.domElement.toBlob((blob) => {
|
|
188
|
+
const url = URL.createObjectURL(blob);
|
|
189
|
+
const a = document.createElement("a");
|
|
190
|
+
a.href = url;
|
|
191
|
+
a.download = "arquitetura-3d.png";
|
|
192
|
+
a.click();
|
|
193
|
+
URL.revokeObjectURL(url);
|
|
194
|
+
});
|
|
195
|
+
});
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
## Dispose ao trocar de modo
|
|
199
|
+
|
|
200
|
+
```javascript
|
|
201
|
+
function clearScene() {
|
|
202
|
+
scene.traverse((obj) => {
|
|
203
|
+
if (obj.geometry) obj.geometry.dispose();
|
|
204
|
+
if (obj.material) {
|
|
205
|
+
if (Array.isArray(obj.material)) obj.material.forEach((m) => m.dispose());
|
|
206
|
+
else obj.material.dispose();
|
|
207
|
+
}
|
|
208
|
+
});
|
|
209
|
+
while (scene.children.length > 0) scene.remove(scene.children[0]);
|
|
210
|
+
}
|
|
211
|
+
```
|
|
212
|
+
|
|
213
|
+
## Performance: limites práticos
|
|
214
|
+
|
|
215
|
+
| Cenário | Limite seguro | Acima disso |
|
|
216
|
+
|---|---|---|
|
|
217
|
+
| BoxGeometry independentes | 200 | Migrar para InstancedMesh |
|
|
218
|
+
| InstancedMesh de cubos | 5.000 | Aplicar agrupamento por pasta |
|
|
219
|
+
| Linhas (LineSegments) | 10.000 segmentos | Usar Line2 (fat lines) ou agrupar |
|
|
220
|
+
| Sprites/labels CSS2D | 100 visíveis | Mostrar só sob hover ou proximidade |
|
|
221
|
+
| Polígonos texturizados | 50.000 tris | Reduzir LOD ou desativar sombras |
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-audit
|
|
3
|
+
description: Auditoria leitora estrita. Compara requirements, roadmap e actions, reporta inconsistências com severidade CRITICAL, HIGH, MEDIUM, LOW. JAMAIS altera os artefatos analisados. Etapa opcional do ciclo forward.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
license: MIT
|
|
6
|
+
compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
|
|
7
|
+
metadata:
|
|
8
|
+
author: sandeco
|
|
9
|
+
version: "1.0.0"
|
|
10
|
+
framework: reversa
|
|
11
|
+
phase: forward
|
|
12
|
+
stage: audit
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
Você é o auditor. Esse skill é estritamente leitor. Sua missão é encontrar contradições e lacunas entre `requirements.md`, `roadmap.md` e `actions.md`, e produzir um relatório para o humano resolver.
|
|
16
|
+
|
|
17
|
+
## Regra inegociável
|
|
18
|
+
|
|
19
|
+
Esse skill NUNCA altera `requirements.md`, `roadmap.md`, `actions.md`, `data-delta.md`, `interfaces/`, `investigation.md` ou `onboarding.md`. Em hipótese alguma, mesmo que o usuário peça. Se o usuário pedir correção, oriente-o a usar `/reversa-clarify` ou edição manual.
|
|
20
|
+
|
|
21
|
+
A única escrita permitida é `feature-dir/audit/cross-check.md`.
|
|
22
|
+
|
|
23
|
+
## Antes de começar
|
|
24
|
+
|
|
25
|
+
1. Leia `.reversa/state.json` para resolver `output_folder` e `forward_folder`
|
|
26
|
+
2. Use os valores reais nos lugares onde o texto mencionar `_reversa_sdd/` ou `_reversa_forward/`
|
|
27
|
+
|
|
28
|
+
## Verificações Iniciais
|
|
29
|
+
|
|
30
|
+
1. Leia `.reversa/active-requirements.json`
|
|
31
|
+
1.1. Se ausente, aborte
|
|
32
|
+
2. Verifique existência dos três artefatos: `requirements.md`, `roadmap.md`, `actions.md`
|
|
33
|
+
2.1. Se algum estiver ausente, aborte com mensagem listando o que falta e qual skill gera
|
|
34
|
+
3. Aplique `before-audit` da forma padrão
|
|
35
|
+
|
|
36
|
+
## Eixos de comparação
|
|
37
|
+
|
|
38
|
+
Verifique cada par de artefatos quanto a:
|
|
39
|
+
|
|
40
|
+
1. Cobertura
|
|
41
|
+
1.1. Todo requisito funcional virou pelo menos uma decisão no roadmap
|
|
42
|
+
1.2. Toda decisão no roadmap virou pelo menos uma ação no actions
|
|
43
|
+
1.3. Todo cenário Gherkin do requirements está coberto por alguma ação ou decisão
|
|
44
|
+
2. Consistência
|
|
45
|
+
2.1. Termos usam o mesmo nome ao longo dos três documentos (não apareça "fatura" em um e "boleto" em outro)
|
|
46
|
+
2.2. Identificadores citados existem (RF-12 referenciado no roadmap precisa existir no requirements)
|
|
47
|
+
2.3. Contratos descritos em `interfaces/` aparecem no roadmap
|
|
48
|
+
3. Coerência com o legado
|
|
49
|
+
3.1. Decisões do roadmap não contradizem regras 🟢 do `_reversa_sdd/domain.md`
|
|
50
|
+
3.2. Componentes do `_reversa_sdd/architecture.md` citados existem mesmo
|
|
51
|
+
4. Sanidade do actions
|
|
52
|
+
4.1. Dependências apontam para IDs existentes
|
|
53
|
+
4.2. Tarefas marcadas `[//]` não compartilham arquivo alvo
|
|
54
|
+
4.3. Não há ciclo de dependência
|
|
55
|
+
|
|
56
|
+
## Severidade
|
|
57
|
+
|
|
58
|
+
| Severidade | Quando aplicar |
|
|
59
|
+
|------------|----------------|
|
|
60
|
+
| CRITICAL | Conflito direto com regra 🟢 do legado, contrato externo quebrado, ciclo de dependência |
|
|
61
|
+
| HIGH | Requisito sem cobertura no roadmap, decisão sem ação correspondente, identificador fantasma |
|
|
62
|
+
| MEDIUM | Inconsistência terminológica entre dois documentos, dependência apontando para fora da lista |
|
|
63
|
+
| LOW | Cosmético, ortografia em ID, paralelismo subutilizado |
|
|
64
|
+
|
|
65
|
+
## Construção do relatório
|
|
66
|
+
|
|
67
|
+
Grave em `feature-dir/audit/cross-check.md`:
|
|
68
|
+
|
|
69
|
+
1. Cabeçalho com data, identificador da feature e link para os três artefatos analisados
|
|
70
|
+
2. Resumo: contagem de findings por severidade
|
|
71
|
+
3. Tabela `ID | Severidade | Eixo | Descrição | Onde está`
|
|
72
|
+
4. Para cada finding CRITICAL ou HIGH, parágrafo explicando o impacto e sugestão de skill para o humano corrigir (NUNCA prometa que esse skill faz a correção, apenas indique a direção)
|
|
73
|
+
5. Lista de itens verificados que passaram, agrupados por eixo (para o humano enxergar o que está OK)
|
|
74
|
+
|
|
75
|
+
Use IDs no formato `A001`, `A002`, ... estáveis dentro do relatório, mas NÃO compartilhados com IDs de outros documentos.
|
|
76
|
+
|
|
77
|
+
## Persistência
|
|
78
|
+
|
|
79
|
+
- Crie `feature-dir/audit/` se não existir
|
|
80
|
+
- Grave `cross-check.md` com escrita atômica
|
|
81
|
+
- Sempre rewrite completo, jamais append
|
|
82
|
+
|
|
83
|
+
## Ganchos Pós-execução
|
|
84
|
+
|
|
85
|
+
Aplique `after-audit` da forma padrão.
|
|
86
|
+
|
|
87
|
+
## Relatório final ao usuário
|
|
88
|
+
|
|
89
|
+
1. Caminho absoluto do `cross-check.md`
|
|
90
|
+
2. Contagem de findings por severidade (CRITICAL, HIGH, MEDIUM, LOW)
|
|
91
|
+
3. Aviso explícito: nenhum dos três artefatos foi alterado
|
|
92
|
+
4. Sugestão de próximo passo:
|
|
93
|
+
4.1. Se houver CRITICAL ou HIGH, sugerir revisão manual antes de seguir
|
|
94
|
+
4.2. Caso contrário, sugerir `/reversa-coding`
|
|
95
|
+
|
|
96
|
+
Termine com:
|
|
97
|
+
|
|
98
|
+
> Digite **CONTINUAR** para prosseguir conforme a sugestão acima.
|