@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,132 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"$id": "https://reversa.dev/schemas/screens/inventory.json",
|
|
4
|
+
"title": "Screen Translator Internal Inventory",
|
|
5
|
+
"description": "Inventário interno do Screen Translator. Lista cada unidade visual detectada no legado, com identidade estável e rastreabilidade ao código fonte. Salvo em _reversa_sdd/screens/inventory.json. Sobrescrito a cada execução.",
|
|
6
|
+
"type": "object",
|
|
7
|
+
"required": ["schemaVersion", "generatedAt", "sourcePlatform", "screens"],
|
|
8
|
+
"properties": {
|
|
9
|
+
"schemaVersion": {
|
|
10
|
+
"type": "integer",
|
|
11
|
+
"const": 1
|
|
12
|
+
},
|
|
13
|
+
"generatedAt": {
|
|
14
|
+
"type": "string",
|
|
15
|
+
"format": "date-time"
|
|
16
|
+
},
|
|
17
|
+
"producedBy": {
|
|
18
|
+
"type": "string",
|
|
19
|
+
"const": "screen-translator"
|
|
20
|
+
},
|
|
21
|
+
"sourcePlatform": {
|
|
22
|
+
"type": "string",
|
|
23
|
+
"description": "Slug da plataforma origem detectada (ex: cobol-ansi-tui, delphi-vcl, asp-classic, android-xml, ios-xib)."
|
|
24
|
+
},
|
|
25
|
+
"detectionConfidence": {
|
|
26
|
+
"type": "string",
|
|
27
|
+
"enum": ["confirmed", "inferred", "gap", "ambiguous"]
|
|
28
|
+
},
|
|
29
|
+
"screens": {
|
|
30
|
+
"type": "array",
|
|
31
|
+
"description": "Lista de telas detectadas no legado.",
|
|
32
|
+
"items": {
|
|
33
|
+
"type": "object",
|
|
34
|
+
"required": ["id", "canonicalName", "legacyOrigin"],
|
|
35
|
+
"properties": {
|
|
36
|
+
"id": {
|
|
37
|
+
"type": "string",
|
|
38
|
+
"description": "Identificador único e estável dentro deste inventário (ex: SCR-0001)."
|
|
39
|
+
},
|
|
40
|
+
"canonicalName": {
|
|
41
|
+
"type": "string",
|
|
42
|
+
"description": "Nome canônico da tela usado em target_screens.md."
|
|
43
|
+
},
|
|
44
|
+
"legacyOrigin": {
|
|
45
|
+
"type": "object",
|
|
46
|
+
"required": ["file"],
|
|
47
|
+
"properties": {
|
|
48
|
+
"file": { "type": "string", "description": "Caminho relativo do arquivo legado." },
|
|
49
|
+
"line": { "type": ["integer", "null"], "description": "Linha do arquivo, quando aplicável." },
|
|
50
|
+
"paragraph": { "type": ["string", "null"], "description": "Nome do paragrafo COBOL, do form Delphi/VB6, da Activity Android, etc." }
|
|
51
|
+
}
|
|
52
|
+
},
|
|
53
|
+
"kind": {
|
|
54
|
+
"type": "string",
|
|
55
|
+
"enum": [
|
|
56
|
+
"tui-screen",
|
|
57
|
+
"form",
|
|
58
|
+
"page",
|
|
59
|
+
"activity",
|
|
60
|
+
"fragment",
|
|
61
|
+
"view-controller",
|
|
62
|
+
"modal",
|
|
63
|
+
"dialog",
|
|
64
|
+
"wizard-step",
|
|
65
|
+
"menu",
|
|
66
|
+
"list",
|
|
67
|
+
"detail",
|
|
68
|
+
"report",
|
|
69
|
+
"raw"
|
|
70
|
+
],
|
|
71
|
+
"description": "Tipo estrutural da tela. Use 'raw' quando o adapter não cobre o tipo."
|
|
72
|
+
},
|
|
73
|
+
"isCritical": {
|
|
74
|
+
"type": "boolean",
|
|
75
|
+
"description": "Marca telas críticas vs auxiliares (alimentado por reversa-detective quando disponível). Em modo híbrido, telas críticas tendem a ir para literal."
|
|
76
|
+
},
|
|
77
|
+
"matchesUiInventory": {
|
|
78
|
+
"type": "boolean",
|
|
79
|
+
"description": "true se a tela aparece em _reversa_sdd/ui/inventory.md."
|
|
80
|
+
},
|
|
81
|
+
"uiInventoryRef": {
|
|
82
|
+
"type": ["string", "null"],
|
|
83
|
+
"description": "Linha ou âncora correspondente em _reversa_sdd/ui/inventory.md."
|
|
84
|
+
},
|
|
85
|
+
"interpolations": {
|
|
86
|
+
"type": "array",
|
|
87
|
+
"items": { "type": "string" },
|
|
88
|
+
"description": "Variáveis dinâmicas detectadas (ex: '{{titular}}', '{{saldo}}')."
|
|
89
|
+
},
|
|
90
|
+
"transitions": {
|
|
91
|
+
"type": "array",
|
|
92
|
+
"items": { "type": "string" },
|
|
93
|
+
"description": "Próximas telas ou eventos disparados a partir desta."
|
|
94
|
+
},
|
|
95
|
+
"tokens": {
|
|
96
|
+
"type": "array",
|
|
97
|
+
"items": { "type": "string" },
|
|
98
|
+
"description": "Tokens do design-system referenciados (ex: 'color.cyan', 'typography.h1')."
|
|
99
|
+
},
|
|
100
|
+
"i18n": {
|
|
101
|
+
"type": "object",
|
|
102
|
+
"description": "Quando a tela tem catálogo de strings externo.",
|
|
103
|
+
"properties": {
|
|
104
|
+
"catalog": { "type": "string", "description": "Caminho do catálogo (ex: 'res/values/strings.xml', 'locale/pt_BR.po')." },
|
|
105
|
+
"keysReferenced": { "type": "array", "items": { "type": "string" } }
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
},
|
|
111
|
+
"skipped": {
|
|
112
|
+
"type": "object",
|
|
113
|
+
"description": "Quando o legado não tem UI, este campo é preenchido e screens[] fica vazio.",
|
|
114
|
+
"properties": {
|
|
115
|
+
"reason": { "type": "string" },
|
|
116
|
+
"emittedAt": { "type": "string", "format": "date-time" }
|
|
117
|
+
}
|
|
118
|
+
},
|
|
119
|
+
"divergenceFromUiInventory": {
|
|
120
|
+
"type": "object",
|
|
121
|
+
"description": "Comparação contra _reversa_sdd/ui/inventory.md. Se divergencePercent > 10, o agente para e pede revisão (RF-05).",
|
|
122
|
+
"properties": {
|
|
123
|
+
"totalInUiInventory": { "type": "integer" },
|
|
124
|
+
"totalInThisInventory": { "type": "integer" },
|
|
125
|
+
"matched": { "type": "integer" },
|
|
126
|
+
"missingInUiInventory": { "type": "array", "items": { "type": "string" } },
|
|
127
|
+
"extraInUiInventory": { "type": "array", "items": { "type": "string" } },
|
|
128
|
+
"divergencePercent": { "type": "number" }
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
}
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: screen_deviation_log
|
|
7
|
+
producedBy: screen-translator
|
|
8
|
+
mode: append-only
|
|
9
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Screen Deviation Log
|
|
13
|
+
|
|
14
|
+
> Registro de toda divergência entre o legado e a spec gerada em `target_screens.md`. Append-only. Deviations pendentes bloqueiam o handoff ao Inspector.
|
|
15
|
+
> Deviations aprovadas são propagadas para `parity_specs.md § Exceções` quando o Inspector rodar.
|
|
16
|
+
|
|
17
|
+
## Convenções
|
|
18
|
+
|
|
19
|
+
- **ID**: `DEV-NNN` (sequencial, três dígitos).
|
|
20
|
+
- **Tipo**:
|
|
21
|
+
- `tecnica`: limitação técnica do alvo (ex: terminal Windows sem UTF-8 sem `chcp 65201`).
|
|
22
|
+
- `modernizacao`: divergência intencional decorrente do modo modernizado.
|
|
23
|
+
- `plataforma`: divergência forçada por incompatibilidade de plataforma (ex: Win16 → web).
|
|
24
|
+
- `correcao`: bug visual do legado que o alvo corrige (ex: typo em label).
|
|
25
|
+
- **Aprovação**: `pendente` | `aprovado` | `rejeitado`.
|
|
26
|
+
- Deviation `aprovado` → também listada em `parity_specs.md § Exceções`.
|
|
27
|
+
- Deviation `pendente` → bloqueia handoff ao Inspector.
|
|
28
|
+
- Deviation `rejeitado` → arquivada com nota explícita; agente regenera a tela em modo conformante.
|
|
29
|
+
|
|
30
|
+
## Resumo
|
|
31
|
+
|
|
32
|
+
- **Total**: <N>
|
|
33
|
+
- **Pendentes**: <N>
|
|
34
|
+
- **Aprovadas**: <N>
|
|
35
|
+
- **Rejeitadas**: <N>
|
|
36
|
+
|
|
37
|
+
## Entradas
|
|
38
|
+
|
|
39
|
+
### DEV-001
|
|
40
|
+
|
|
41
|
+
| Campo | Valor |
|
|
42
|
+
|---|---|
|
|
43
|
+
| Tela afetada | <nome-canonical> |
|
|
44
|
+
| Tipo | `tecnica` \| `modernizacao` \| `plataforma` \| `correcao` |
|
|
45
|
+
| Descrição | <o que diverge entre legado e novo> |
|
|
46
|
+
| Motivo | <por que a divergência é necessária ou aceitável> |
|
|
47
|
+
| Origem no legado | <arquivo:linha> |
|
|
48
|
+
| Implicação para parity tests | <ex: comparação byte-a-byte falsa, usar comparação semântica> |
|
|
49
|
+
| Aprovação | `pendente` \| `aprovado` \| `rejeitado` |
|
|
50
|
+
| Aprovado por | <nome ou identificador, quando aprovado> |
|
|
51
|
+
| Aprovado em | <ISO-8601, quando aprovado> |
|
|
52
|
+
| Propaga para `parity_specs.md § Exceções` | sim \| não |
|
|
53
|
+
|
|
54
|
+
### DEV-002
|
|
55
|
+
|
|
56
|
+
(repetir o bloco acima para cada deviation)
|
|
57
|
+
|
|
58
|
+
## Telas com mais de uma deviation
|
|
59
|
+
|
|
60
|
+
| Tela | IDs |
|
|
61
|
+
|---|---|
|
|
62
|
+
| <tela X> | DEV-001, DEV-007 |
|
|
63
|
+
|
|
64
|
+
## Notas
|
|
65
|
+
|
|
66
|
+
<Observações gerais sobre o conjunto de deviations: padrões, aprendizados que valem para futuras migrações no mesmo par origem→alvo, sugestões de adapter melhorado para v2.>
|
package/agents/reversa-screen-translator/references/templates/screen_modernization_decision.md
ADDED
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: screen_modernization_decision
|
|
7
|
+
producedBy: screen-translator
|
|
8
|
+
decidedBy: <human-id ou null quando mode=skipped>
|
|
9
|
+
decidedAt: <ISO-8601 ou null quando mode=skipped>
|
|
10
|
+
mode: literal | modernized | hybrid | skipped
|
|
11
|
+
sourcePlatform: <slug ou null quando mode=skipped>
|
|
12
|
+
targetPlatform: <slug ou null quando mode=skipped>
|
|
13
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
> Quando `mode: skipped`, esta decisão **não passou por humano**: foi emitida automaticamente pelo Screen Translator porque o legado não tem UI. Apenas as seções "Contexto" e "Decisão" são preenchidas, com a razão da omissão; as demais ficam como N/A. O Inspector lê `mode: skipped` no front-matter e pula a paridade visual sem perguntar.
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
# Decisão de Modernização de Telas
|
|
20
|
+
|
|
21
|
+
> Decisão consciente sobre como traduzir as telas do sistema legado: paridade observável byte-a-byte, redesign idiomático para a plataforma alvo, ou combinação tela-a-tela.
|
|
22
|
+
> Este artefato é leitura obrigatória do próprio Screen Translator (para gerar `target_screens.md`), do Inspector (para construir parity tests adequados ao modo) e do agente de codificação.
|
|
23
|
+
|
|
24
|
+
## Contexto
|
|
25
|
+
|
|
26
|
+
- **Plataforma origem detectada**: <slug> (ex: `cobol-ansi-tui`, `delphi-vcl`, `asp-classic`, `android-xml`)
|
|
27
|
+
- **Confiança**: 🟢 CONFIRMADO | 🟡 INFERIDO | 🔴 LACUNA | ⚠️ AMBÍGUO
|
|
28
|
+
- **Plataforma alvo**: <slug> (ex: `go-cli`, `web-spa`, `flutter`, `tauri`)
|
|
29
|
+
- **Telas inventariadas**: <N>
|
|
30
|
+
- **Origem do inventário**: `_reversa_sdd/screens/inventory.json` + `_reversa_sdd/ui/inventory.md`
|
|
31
|
+
- **Adapter aplicado**: `<adapters/origem__alvo>` (ver `references/adapter-pairs.md`)
|
|
32
|
+
|
|
33
|
+
## Modos avaliados
|
|
34
|
+
|
|
35
|
+
### Modo: literal
|
|
36
|
+
- **Definição**: paridade observável byte-a-byte ou pixel-equivalente entre legado e novo.
|
|
37
|
+
- **Trade-offs**:
|
|
38
|
+
- Custo de implementação: <alto | médio | baixo>
|
|
39
|
+
- Fidelidade visual: <alta | média | baixa>
|
|
40
|
+
- Viabilidade de parity tests construtivos: <sim | parcial | não>
|
|
41
|
+
- Aceitação esperada do usuário final: <alta | média | baixa>
|
|
42
|
+
- Débito técnico futuro: <alto | médio | baixo>
|
|
43
|
+
- **Recomendado**: <sim | não>
|
|
44
|
+
- **Justificativa**: <texto curto>
|
|
45
|
+
|
|
46
|
+
### Modo: modernizado
|
|
47
|
+
- **Definição**: redesign idiomático para a plataforma alvo, preservando informação e fluxo, mas re-expressando hierarquia e interação.
|
|
48
|
+
- **Trade-offs**:
|
|
49
|
+
- Custo de implementação: <alto | médio | baixo>
|
|
50
|
+
- Fidelidade visual: <alta | média | baixa>
|
|
51
|
+
- Viabilidade de parity tests construtivos: <sim | parcial | não>
|
|
52
|
+
- Aceitação esperada do usuário final: <alta | média | baixa>
|
|
53
|
+
- Débito técnico futuro: <alto | médio | baixo>
|
|
54
|
+
- **Recomendado**: <sim | não>
|
|
55
|
+
- **Justificativa**: <texto curto>
|
|
56
|
+
|
|
57
|
+
### Modo: híbrido
|
|
58
|
+
- **Definição**: parte das telas em literal, parte em modernizado, com listas explícitas.
|
|
59
|
+
- **Trade-offs**:
|
|
60
|
+
- Custo de implementação: <alto | médio | baixo>
|
|
61
|
+
- Fidelidade visual mista: <descrição>
|
|
62
|
+
- Viabilidade de parity tests: <descrição por subset>
|
|
63
|
+
- Custo de manutenção da separação: <alto | médio | baixo>
|
|
64
|
+
- **Recomendado**: <sim | não>
|
|
65
|
+
- **Justificativa**: <texto curto>
|
|
66
|
+
|
|
67
|
+
## Decisão
|
|
68
|
+
|
|
69
|
+
- **Modo escolhido**: <literal | modernizado | híbrido>
|
|
70
|
+
- **Justificativa do humano**: <texto>
|
|
71
|
+
- **Alternativas descartadas**: <lista breve com razão>
|
|
72
|
+
- **Decidido em**: <ISO-8601>
|
|
73
|
+
- **Decidido por**: <nome ou identificador>
|
|
74
|
+
|
|
75
|
+
### Em modo híbrido, listas explícitas (obrigatórias)
|
|
76
|
+
|
|
77
|
+
**Telas em modo literal**:
|
|
78
|
+
- <tela 1>
|
|
79
|
+
- <tela 2>
|
|
80
|
+
|
|
81
|
+
**Telas em modo modernizado**:
|
|
82
|
+
- <tela 3>
|
|
83
|
+
- <tela 4>
|
|
84
|
+
|
|
85
|
+
> Listas vazias bloqueiam a Fase 2. O agente recusa prosseguir.
|
|
86
|
+
|
|
87
|
+
## Implicações pendentes para a Fase 2
|
|
88
|
+
|
|
89
|
+
| Etapa | Implicação | Como honrar |
|
|
90
|
+
|---|---|---|
|
|
91
|
+
| Geração de `target_screens.md` | <implicação> | <ação esperada> |
|
|
92
|
+
| Captura de golden files | <implicação> | <ação esperada> |
|
|
93
|
+
| Tokens do design-system | <implicação> | <ação esperada> |
|
|
94
|
+
| Conteúdo textual | Preservar literal salvo aprovação explícita de revisão linguística | <ação esperada> |
|
|
95
|
+
|
|
96
|
+
## Implicações para o Inspector
|
|
97
|
+
|
|
98
|
+
- **Estratégia de paridade**:
|
|
99
|
+
- Modo literal → paridade observável byte-a-byte / pixel-equivalente, validada por golden files quando o oráculo executa.
|
|
100
|
+
- Modo modernizado → contrato semântico (eventos, transições, conteúdo textual, estados), sem comparação visual byte-a-byte.
|
|
101
|
+
- Modo híbrido → estratégia mista, declarada por tela em `parity_specs.md`.
|
|
102
|
+
- **Deviations conhecidas a propagar**: ver `screen_deviation_log.md`.
|
|
103
|
+
|
|
104
|
+
## Notas
|
|
105
|
+
|
|
106
|
+
<Pontos adicionais que o codificador, o Inspector e o agente precisam saber para honrar a decisão. Inclui, por exemplo, aprovação explícita de revisão linguística, tolerância a renderização aproximada, ou marcação de telas que não admitem modernização por exigência regulatória.>
|
|
@@ -0,0 +1,206 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: target_screens
|
|
7
|
+
producedBy: screen-translator
|
|
8
|
+
mode: literal | modernized | hybrid
|
|
9
|
+
sourcePlatform: <slug>
|
|
10
|
+
targetPlatform: <slug>
|
|
11
|
+
adapter: <adapters/origem__alvo>
|
|
12
|
+
screenCount: <int>
|
|
13
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
# Target Screens
|
|
17
|
+
|
|
18
|
+
> Especificação executável de cada tela do sistema novo, derivada do legado segundo o modo aprovado em `screen_modernization_decision.md`. Conteúdo textual preservado literalmente, salvo aprovação explícita de revisão linguística.
|
|
19
|
+
> Leitura primária para o codificador. Cada seção é um contrato.
|
|
20
|
+
|
|
21
|
+
## Resumo
|
|
22
|
+
|
|
23
|
+
- **Modo aplicado**: <literal | modernizado | híbrido>
|
|
24
|
+
- **Telas geradas**: <N>
|
|
25
|
+
- **Adapter**: <slug>
|
|
26
|
+
- **Tokens consumidos**: ver `_reversa_sdd/design-system/tokens.md` e `tokens-derived.md` quando aplicável
|
|
27
|
+
- **Golden files**: <N> em `_reversa_sdd/screens/golden/` (manifest em `golden/manifest.yaml`)
|
|
28
|
+
- **Deviations registradas**: <N> em `screen_deviation_log.md`
|
|
29
|
+
|
|
30
|
+
> Caso o legado não possua UI (sistema batch / API / daemon), substituir esta seção por:
|
|
31
|
+
> "Nenhuma tela detectada. Agente pulado em modo `skipped`. Próximo agente: Inspector."
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## Tela: <nome-canonical>
|
|
36
|
+
|
|
37
|
+
**Origem**: `<arquivo-legado>:<linha-ou-paragrafo>`
|
|
38
|
+
**Modo aplicado**: literal | modernizado
|
|
39
|
+
**Componentes do design-system**: [<token1>, <token2>, ...]
|
|
40
|
+
**Pontos de interpolação**: `{{var1}}`, `{{var2}}`
|
|
41
|
+
**Transições de saída**: [<próxima tela ou evento>]
|
|
42
|
+
**Tela crítica?**: sim | não (consulta `reversa-detective` quando disponível)
|
|
43
|
+
|
|
44
|
+
### Especificação
|
|
45
|
+
|
|
46
|
+
> O bloco abaixo varia conforme o par origem→alvo e o modo. Veja `references/adapter-pairs.md` para o formato canônico de cada par. Exemplos abaixo.
|
|
47
|
+
|
|
48
|
+
#### Exemplo: COBOL TUI → Go CLI/TUI (literal)
|
|
49
|
+
|
|
50
|
+
```yaml
|
|
51
|
+
spec.kind: ansi-byte-stream
|
|
52
|
+
spec.normalize:
|
|
53
|
+
- trim_trailing_spaces: false
|
|
54
|
+
- line_endings: "\n"
|
|
55
|
+
spec.lines:
|
|
56
|
+
- bytes: "\x1b[96m╔══════════════════════════════════════════════════╗\x1b[0m\n"
|
|
57
|
+
- bytes: "\x1b[96m║ \x1b[93m▓▓▓ BANCO ATM ▓▓▓\x1b[96m ║\x1b[0m\n"
|
|
58
|
+
- bytes: "\x1b[96m║ \x1b[97m{{header_subtitle}}\x1b[96m ║\x1b[0m\n"
|
|
59
|
+
interpolations:
|
|
60
|
+
header_subtitle:
|
|
61
|
+
type: string
|
|
62
|
+
max_width: 16
|
|
63
|
+
source: literal "Caixa Eletronico" | literal "Acesso ao Sistema"
|
|
64
|
+
- bytes: "\x1b[96m╚══════════════════════════════════════════════════╝\x1b[0m\n"
|
|
65
|
+
spec.input_prompts:
|
|
66
|
+
- kind: accept-line
|
|
67
|
+
prompt_bytes: " \x1b[96m>>\x1b[97m Selecione uma opcao: \x1b[0m"
|
|
68
|
+
captures: opcao
|
|
69
|
+
valid: ["0", "1", "2", "3", "4", "5"]
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
#### Exemplo: Win32/Delphi VCL → Web SPA (modernizado)
|
|
73
|
+
|
|
74
|
+
```yaml
|
|
75
|
+
spec.kind: component-tree
|
|
76
|
+
spec.states: [idle, loading, error, success]
|
|
77
|
+
spec.root:
|
|
78
|
+
component: PageLayout
|
|
79
|
+
variant: form
|
|
80
|
+
children:
|
|
81
|
+
- component: Header
|
|
82
|
+
tokens: [color.brand-primary, typography.h1]
|
|
83
|
+
content:
|
|
84
|
+
text: "Cadastro de Cliente"
|
|
85
|
+
- component: Form
|
|
86
|
+
submit_event: cliente.create
|
|
87
|
+
children:
|
|
88
|
+
- component: FormField
|
|
89
|
+
name: nome
|
|
90
|
+
label: "Nome completo"
|
|
91
|
+
legacy_origin: "TForm1.edtNome"
|
|
92
|
+
validation:
|
|
93
|
+
required: true
|
|
94
|
+
max_length: 80
|
|
95
|
+
- component: FormField
|
|
96
|
+
name: cpf
|
|
97
|
+
label: "CPF"
|
|
98
|
+
legacy_origin: "TForm1.mskCPF"
|
|
99
|
+
mask: "999.999.999-99"
|
|
100
|
+
validation:
|
|
101
|
+
required: true
|
|
102
|
+
cpf: true
|
|
103
|
+
- component: ButtonRow
|
|
104
|
+
children:
|
|
105
|
+
- component: Button
|
|
106
|
+
variant: primary
|
|
107
|
+
label: "Salvar"
|
|
108
|
+
legacy_origin: "TForm1.btnSalvar"
|
|
109
|
+
action: form.submit
|
|
110
|
+
- component: Button
|
|
111
|
+
variant: ghost
|
|
112
|
+
label: "Cancelar"
|
|
113
|
+
legacy_origin: "TForm1.btnCancelar"
|
|
114
|
+
action: navigate.back
|
|
115
|
+
spec.state_messages:
|
|
116
|
+
loading: "Salvando..."
|
|
117
|
+
error: "{{error_message}}"
|
|
118
|
+
success: "Cliente cadastrado com sucesso."
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
#### Exemplo: HTML legado server-rendered → SPA componentizada (modernizado)
|
|
122
|
+
|
|
123
|
+
```yaml
|
|
124
|
+
spec.kind: route-component
|
|
125
|
+
spec.route: /clientes/novo
|
|
126
|
+
spec.layout: AppLayout
|
|
127
|
+
spec.states: [idle, loading, error, success]
|
|
128
|
+
spec.component:
|
|
129
|
+
component: ClientesNovoPage
|
|
130
|
+
legacy_origin: "/admin/cliente_novo.asp"
|
|
131
|
+
state:
|
|
132
|
+
cliente:
|
|
133
|
+
type: Cliente
|
|
134
|
+
initial: empty
|
|
135
|
+
children:
|
|
136
|
+
- component: PageTitle
|
|
137
|
+
content: "Novo Cliente"
|
|
138
|
+
- component: ClienteForm
|
|
139
|
+
props:
|
|
140
|
+
onSubmit: clienteService.create
|
|
141
|
+
initial: $state.cliente
|
|
142
|
+
spec.api_changes:
|
|
143
|
+
- legacy: POST /admin/cliente_novo.asp (form-urlencoded)
|
|
144
|
+
target: POST /api/clientes (application/json)
|
|
145
|
+
deviation: DEV-014
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
#### Exemplo: Android XML → Flutter (modernizado)
|
|
149
|
+
|
|
150
|
+
```yaml
|
|
151
|
+
spec.kind: composable
|
|
152
|
+
spec.name: ClienteListScreen
|
|
153
|
+
spec.legacy_origin: "app/src/main/res/layout/activity_cliente_list.xml + ClienteListActivity.java"
|
|
154
|
+
spec.states: [idle, loading, error, success]
|
|
155
|
+
spec.composable: |
|
|
156
|
+
Scaffold(
|
|
157
|
+
appBar: AppBar(title: Text("Clientes")),
|
|
158
|
+
body: Consumer<ClienteListVM>(
|
|
159
|
+
builder: (ctx, vm, _) => vm.loading
|
|
160
|
+
? CircularProgressIndicator()
|
|
161
|
+
: ListView.builder(
|
|
162
|
+
itemCount: vm.clientes.length,
|
|
163
|
+
itemBuilder: (_, i) => ClienteListTile(cliente: vm.clientes[i]),
|
|
164
|
+
),
|
|
165
|
+
),
|
|
166
|
+
floatingActionButton: FloatingActionButton(
|
|
167
|
+
onPressed: () => Navigator.pushNamed(ctx, '/clientes/novo'),
|
|
168
|
+
child: Icon(Icons.add),
|
|
169
|
+
),
|
|
170
|
+
)
|
|
171
|
+
spec.viewmodel:
|
|
172
|
+
name: ClienteListVM
|
|
173
|
+
legacy_origin: "ClienteListActivity.onResume"
|
|
174
|
+
methods:
|
|
175
|
+
- load(): chama clienteService.listar
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
### Pontos de divergência aceitos
|
|
179
|
+
|
|
180
|
+
- DEV-XXX: <descrição curta> (ver `screen_deviation_log.md#DEV-XXX`)
|
|
181
|
+
|
|
182
|
+
### Estados (apenas modo modernizado)
|
|
183
|
+
|
|
184
|
+
| Estado | Descrição | Conteúdo / mensagem |
|
|
185
|
+
|---|---|---|
|
|
186
|
+
| Idle | Estado padrão antes de qualquer ação | <conteúdo> |
|
|
187
|
+
| Loading | Operação assíncrona em curso | <spinner / skeleton> |
|
|
188
|
+
| Error | Falha na operação ou dado inválido | `{{error_message}}` |
|
|
189
|
+
| Success | Operação concluída com sucesso | <mensagem confirmação> |
|
|
190
|
+
|
|
191
|
+
> Em modo literal, esta seção pode ser omitida ou substituída por "preserva os estados do legado" se o legado não tiver disposição explícita de estados.
|
|
192
|
+
|
|
193
|
+
---
|
|
194
|
+
|
|
195
|
+
## Tela: <segunda-tela>
|
|
196
|
+
|
|
197
|
+
(repetir o bloco acima para cada tela)
|
|
198
|
+
|
|
199
|
+
---
|
|
200
|
+
|
|
201
|
+
## Apêndice: rastreabilidade ao inventário
|
|
202
|
+
|
|
203
|
+
| Tela do `target_screens.md` | Origem em `_reversa_sdd/ui/inventory.md` | Origem em `_reversa_sdd/screens/inventory.json` |
|
|
204
|
+
|---|---|---|
|
|
205
|
+
| <tela 1> | <linha do inventário> | <id do inventário interno> |
|
|
206
|
+
| <tela 2> | <linha do inventário> | <id do inventário interno> |
|
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-selo-generativo
|
|
3
|
+
description: Cria selos visuais generativos seeded com p5.js, gerando HTML standalone com arte algorítmica reprodutível derivada de um hash ou string.
|
|
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: generative-seal
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# Selo Generativo
|
|
16
|
+
|
|
17
|
+
Cria **selos visuais únicos e reprodutíveis** para projetos do Reversa usando p5.js. Cada projeto recebe seu próprio artwork generativo derivado de um seed determinístico: o mesmo seed gera o mesmo selo, sempre.
|
|
18
|
+
|
|
19
|
+
Inspirado no padrão Art Blocks (seeded randomness) e na skill `algorithmic-art` da Anthropic, mas com escopo deliberadamente menor: produz **apenas o selo**, não um manifesto filosófico, não uma plataforma de exploração. É um elemento decorativo de identidade.
|
|
20
|
+
|
|
21
|
+
## Quando usar
|
|
22
|
+
|
|
23
|
+
- **Hero da `index.html`** do mini-site gerado pelo `/reversa-documentation`.
|
|
24
|
+
- **Mini-selo no header** de cada página do mini-site (versão reduzida).
|
|
25
|
+
- **Capa de slides** no `deck.html`.
|
|
26
|
+
- **Identidade visual** de qualquer artefato gerado pelo Reversa que precise de uma marca distintiva.
|
|
27
|
+
|
|
28
|
+
A skill é **leve por design**: usa só p5.js, gera canvas único, exporta como SVG ou PNG. Não tem sidebar de exploração, não tem múltiplos modos, não tem animação obrigatória (animação é opcional).
|
|
29
|
+
|
|
30
|
+
## Princípios
|
|
31
|
+
|
|
32
|
+
1. **Reprodutibilidade absoluta**: mesmo seed sempre gera o mesmo selo.
|
|
33
|
+
2. **Paleta limitada**: 3 a 5 cores por selo, derivadas do estilo visual escolhido.
|
|
34
|
+
3. **Composição equilibrada**: forma central reconhecível com elementos auxiliares orbitando ou compondo.
|
|
35
|
+
4. **Sem texto no canvas**: o selo é puramente visual; nome do projeto e título ficam fora do canvas, em HTML.
|
|
36
|
+
5. **Adaptável de tamanho**: o mesmo canvas funciona em 64x64 (mini-selo header) e 800x800 (hero grande).
|
|
37
|
+
6. **Sem dependências além de p5.js**: nada de GSAP, dat.GUI, lodash. Só p5.
|
|
38
|
+
|
|
39
|
+
## Fluxo de Trabalho
|
|
40
|
+
|
|
41
|
+
### 1. Receber o seed
|
|
42
|
+
|
|
43
|
+
O seed pode vir de:
|
|
44
|
+
|
|
45
|
+
- **String direta**: usuário ou agente passa um hash sha256, nome do projeto, ou qualquer string.
|
|
46
|
+
- **Caminho de arquivo**: usuário aponta para `.reversa/soul.md`, a skill computa `sha256` do conteúdo.
|
|
47
|
+
- **Fallback**: se nada for fornecido, usar `sha256` do timestamp atual (selo "do momento", não reprodutível).
|
|
48
|
+
|
|
49
|
+
```javascript
|
|
50
|
+
async function computeSeed(input) {
|
|
51
|
+
const enc = new TextEncoder();
|
|
52
|
+
const data = enc.encode(input);
|
|
53
|
+
const hashBuffer = await crypto.subtle.digest("SHA-256", data);
|
|
54
|
+
const hashArray = Array.from(new Uint8Array(hashBuffer));
|
|
55
|
+
const hashHex = hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
|
|
56
|
+
return hashHex;
|
|
57
|
+
}
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
O seed é uma string hexadecimal de 64 caracteres. A skill extrai múltiplos números dele para alimentar parâmetros distintos.
|
|
61
|
+
|
|
62
|
+
### 2. Escolher paleta
|
|
63
|
+
|
|
64
|
+
A paleta deriva do estilo visual escolhido pelo usuário do `/reversa-documentation`, ou pode ser fornecida diretamente.
|
|
65
|
+
|
|
66
|
+
Consultar `references/PALETTE_BY_STYLE.md` para a tabela completa de paletas por estilo. As 4 paletas base são:
|
|
67
|
+
|
|
68
|
+
| Estilo | Paleta |
|
|
69
|
+
|--------|--------|
|
|
70
|
+
| `sober` | Tons neutros: cinzas, azul-petróleo, terracota leve, branco quebrado |
|
|
71
|
+
| `premium` | Dark mode: preto profundo, dourado, vermelho-vinho, prata, azul-meia-noite |
|
|
72
|
+
| `dense` | Saturados: laranja, ciano, magenta, lima, índigo |
|
|
73
|
+
| `exploratory` | Pastéis luminosos: rosa-aurora, ciano-glaciar, lilás-névoa, branco luz |
|
|
74
|
+
|
|
75
|
+
A escolha de qual cor é "central" e quais são "auxiliares" sai do seed.
|
|
76
|
+
|
|
77
|
+
### 3. Escolher padrão generativo
|
|
78
|
+
|
|
79
|
+
A skill tem **5 padrões consagrados**, cada um com aparência distinta. O seed determina qual padrão usar (primeiros 2 dígitos hex modulo 5):
|
|
80
|
+
|
|
81
|
+
| Padrão | Aparência | Quando combina |
|
|
82
|
+
|--------|-----------|----------------|
|
|
83
|
+
| `flow-field` | Campos de fluxo Perlin, traços orgânicos curvos | Estilo `sober`, `exploratory` |
|
|
84
|
+
| `particle-orbit` | Partículas orbitando um centro com trilhas | Estilo `premium`, `exploratory` |
|
|
85
|
+
| `crystal-lattice` | Forma cristalina simétrica, geometria limpa | Estilo `dense`, `sober` |
|
|
86
|
+
| `wave-interference` | Padrões de interferência tipo moiré, ondas circulares | Estilo `premium`, `dense` |
|
|
87
|
+
| `noise-strata` | Estratos de ruído horizontal, paisagem abstrata | Estilo `sober`, `exploratory` |
|
|
88
|
+
|
|
89
|
+
Detalhes em `references/GENERATIVE_PATTERNS.md`.
|
|
90
|
+
|
|
91
|
+
A skill pode aceitar override do padrão via parâmetro, ignorando a derivação por seed.
|
|
92
|
+
|
|
93
|
+
### 4. Gerar o código
|
|
94
|
+
|
|
95
|
+
Estrutura do HTML resultante:
|
|
96
|
+
|
|
97
|
+
```html
|
|
98
|
+
<!DOCTYPE html>
|
|
99
|
+
<html lang="pt-BR">
|
|
100
|
+
<head>
|
|
101
|
+
<meta charset="UTF-8">
|
|
102
|
+
<title>Selo: <!-- PROJECT_NAME --></title>
|
|
103
|
+
<script src="https://cdnjs.cloudflare.com/ajax/libs/p5.js/1.9.0/p5.min.js"></script>
|
|
104
|
+
<style>
|
|
105
|
+
body { margin: 0; display: flex; align-items: center; justify-content: center; min-height: 100vh; background: var(--seal-bg, #0a0a14); }
|
|
106
|
+
#seal-container { display: block; }
|
|
107
|
+
.label { color: var(--seal-fg, #eaeaea); text-align: center; margin-top: 16px; font-family: system-ui, sans-serif; }
|
|
108
|
+
</style>
|
|
109
|
+
</head>
|
|
110
|
+
<body>
|
|
111
|
+
<div>
|
|
112
|
+
<div id="seal-container"></div>
|
|
113
|
+
<div class="label"><!-- PROJECT_NAME --></div>
|
|
114
|
+
</div>
|
|
115
|
+
<script id="seal-config" type="application/json">
|
|
116
|
+
<!-- CONFIG_JSON -->
|
|
117
|
+
</script>
|
|
118
|
+
<script>
|
|
119
|
+
// 1. Ler config (seed, paleta, padrão, tamanho)
|
|
120
|
+
// 2. Seedar p5.js: randomSeed(seedInt); noiseSeed(seedInt);
|
|
121
|
+
// 3. Executar padrão escolhido
|
|
122
|
+
// 4. Salvar canvas como referência
|
|
123
|
+
</script>
|
|
124
|
+
</body>
|
|
125
|
+
</html>
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
**Regras fundamentais**:
|
|
129
|
+
|
|
130
|
+
1. **HTML standalone**: arquivo único, p5.js via CDN, nada externo.
|
|
131
|
+
2. **p5.js 1.9.0+**: usar `https://cdnjs.cloudflare.com/ajax/libs/p5.js/1.9.0/p5.min.js`.
|
|
132
|
+
3. **Seeded sempre**: `randomSeed(seedInt)` e `noiseSeed(seedInt)` no primeiro setup, antes de qualquer chamada a `random()` ou `noise()`.
|
|
133
|
+
4. **Conversão de hash hex para int**: pegar primeiros 16 chars hex, converter via `parseInt(hex.slice(0, 16), 16)`.
|
|
134
|
+
5. **Canvas quadrado**: tamanho default 800x800, mas parametrizável.
|
|
135
|
+
6. **noLoop()**: por default o selo é estático. Se animação for solicitada, usar `frameRate(30)` e algoritmo de baixo custo.
|
|
136
|
+
7. **Sem texto no canvas**: nome do projeto fica em `<div class="label">` fora do canvas.
|
|
137
|
+
|
|
138
|
+
### 5. Variantes de tamanho
|
|
139
|
+
|
|
140
|
+
A skill aceita parâmetro `size` para gerar selo grande (hero, 800x800), médio (capa de slide, 400x400) ou mini (header, 64x64 ou 128x128).
|
|
141
|
+
|
|
142
|
+
Em selos menores (<200px), aplicar simplificações automáticas:
|
|
143
|
+
- Reduzir contagem de partículas em 80%.
|
|
144
|
+
- Aumentar espessura de traços proporcionalmente.
|
|
145
|
+
- Desativar animação.
|
|
146
|
+
|
|
147
|
+
### 6. Salvar e entregar
|
|
148
|
+
|
|
149
|
+
Output é HTML standalone. O canvas pode ser exportado como PNG via botão (opcional) ou como SVG para uso em headers (recomendado para mini-selos: SVG escala perfeitamente).
|
|
150
|
+
|
|
151
|
+
```javascript
|
|
152
|
+
function exportSVG() {
|
|
153
|
+
// Padrões compatíveis com SVG (crystal-lattice, wave-interference) podem ser regenerados como SVG real.
|
|
154
|
+
// Padrões raster (flow-field denso) exportam como PNG embutido em <img>.
|
|
155
|
+
}
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
Para uso em outras páginas do mini-site (mini-selo no header), gerar uma vez em SVG, embutir inline no HTML do viewer template.
|
|
159
|
+
|
|
160
|
+
## Diretrizes de qualidade
|
|
161
|
+
|
|
162
|
+
- **Reconhecibilidade**: o selo deve ter uma forma central forte; quem viu uma vez deve reconhecer o projeto pelo selo.
|
|
163
|
+
- **Equilíbrio cromático**: nunca usar todas as cores da paleta no mesmo selo; tipicamente 1 cor dominante (60%), 1 secundária (30%), 1 acento (10%).
|
|
164
|
+
- **Não chamar mais atenção que o conteúdo**: o selo é identidade, não foco. Em hero grande, ok ser protagonista; em mini-selo no header, deve ceder espaço ao nome do projeto.
|
|
165
|
+
- **Acessibilidade**: contraste mínimo entre fundo e elementos primários. Selos com fundo escuro têm elementos claros e vice-versa.
|
|
166
|
+
- **Idioma**: comentários em pt-br, sem travessão.
|
|
167
|
+
|
|
168
|
+
## Diretrizes de código
|
|
169
|
+
|
|
170
|
+
- **Constantes nomeadas no topo**: tamanho, paleta, parâmetros do padrão visíveis no início.
|
|
171
|
+
- **Função única de geração**: cada padrão é uma função `drawFlowField()`, `drawCrystalLattice()`, etc, isolada e testável.
|
|
172
|
+
- **Sem efeitos colaterais globais**: tudo escopado dentro de `setup()` e `draw()` do p5.
|
|
173
|
+
|
|
174
|
+
## Tratamento de erros
|
|
175
|
+
|
|
176
|
+
Consultar `references/ERRORS.md` para cenários (p5.js indisponível, canvas não suportado, seed inválido, tamanho extremo).
|