@flaviogarrido/reversa 0.0.0-stage → 1.3.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +487 -2
- package/agents/fg-backlog/SKILL.md +129 -0
- package/agents/fg-backlog/agents/openai.yaml +5 -0
- package/agents/fg-backlog/references/backlog-template.md +60 -0
- package/agents/fg-backlog/references/priorizacao.md +41 -0
- package/agents/impeccable/LICENSE +191 -0
- package/agents/impeccable/NOTICE.md +11 -0
- package/agents/impeccable/SKILL.md +88 -0
- package/agents/impeccable/agents/impeccable_asset_producer.toml +47 -0
- package/agents/impeccable/agents/impeccable_documenter.toml +27 -0
- package/agents/impeccable/agents/impeccable_finish_reviewer.toml +41 -0
- package/agents/impeccable/agents/impeccable_manual_edit_applier.toml +95 -0
- package/agents/impeccable/agents/openai.yaml +4 -0
- package/agents/impeccable/reference/adapt.md +318 -0
- package/agents/impeccable/reference/adapt.native.md +58 -0
- package/agents/impeccable/reference/android.md +46 -0
- package/agents/impeccable/reference/animate.md +89 -0
- package/agents/impeccable/reference/audit.md +139 -0
- package/agents/impeccable/reference/audit.native.md +139 -0
- package/agents/impeccable/reference/bolder.md +33 -0
- package/agents/impeccable/reference/clarify.md +94 -0
- package/agents/impeccable/reference/colorize.md +86 -0
- package/agents/impeccable/reference/component-review.md +63 -0
- package/agents/impeccable/reference/craft-floor.md +44 -0
- package/agents/impeccable/reference/craft.md +5 -0
- package/agents/impeccable/reference/critique.md +819 -0
- package/agents/impeccable/reference/degraded/asset-producer.md +42 -0
- package/agents/impeccable/reference/degraded/documenter.md +24 -0
- package/agents/impeccable/reference/degraded/finish-reviewer.md +38 -0
- package/agents/impeccable/reference/degraded/manual-edit-applier.md +92 -0
- package/agents/impeccable/reference/delight.md +70 -0
- package/agents/impeccable/reference/distill.md +111 -0
- package/agents/impeccable/reference/doctor.md +54 -0
- package/agents/impeccable/reference/document.md +416 -0
- package/agents/impeccable/reference/extract.md +69 -0
- package/agents/impeccable/reference/generate.md +101 -0
- package/agents/impeccable/reference/harden.md +343 -0
- package/agents/impeccable/reference/hooks.md +113 -0
- package/agents/impeccable/reference/init.md +131 -0
- package/agents/impeccable/reference/ios.md +51 -0
- package/agents/impeccable/reference/layout.md +84 -0
- package/agents/impeccable/reference/live-setup.md +104 -0
- package/agents/impeccable/reference/live.md +325 -0
- package/agents/impeccable/reference/mode-operate.md +21 -0
- package/agents/impeccable/reference/mode-persuade.md +19 -0
- package/agents/impeccable/reference/mode-read.md +21 -0
- package/agents/impeccable/reference/new-work.md +154 -0
- package/agents/impeccable/reference/onboard.md +234 -0
- package/agents/impeccable/reference/operate.md +61 -0
- package/agents/impeccable/reference/optimize.md +258 -0
- package/agents/impeccable/reference/overdrive.md +127 -0
- package/agents/impeccable/reference/polish.md +105 -0
- package/agents/impeccable/reference/quieter.md +99 -0
- package/agents/impeccable/reference/region-map.md +26 -0
- package/agents/impeccable/reference/routing.md +24 -0
- package/agents/impeccable/reference/shape.md +59 -0
- package/agents/impeccable/reference/typeset.md +90 -0
- package/agents/impeccable/reference/visualize.md +47 -0
- package/agents/impeccable/reversa-bundle.json +16 -0
- package/agents/impeccable/scripts/VERSION +1 -0
- package/agents/impeccable/scripts/command-metadata.json +98 -0
- package/agents/impeccable/scripts/data/font-index-failures.json +121 -0
- package/agents/impeccable/scripts/data/font-index.json +1 -0
- package/agents/impeccable/scripts/impeccable +212 -0
- package/agents/impeccable/scripts/impeccable.cmd +239 -0
- package/agents/impeccable/scripts/live-browser-dom.js +320 -0
- package/agents/impeccable/scripts/live-browser-ignores.js +242 -0
- package/agents/impeccable/scripts/live-browser-session.js +180 -0
- package/agents/impeccable/scripts/live-browser.js +13557 -0
- package/agents/impeccable/scripts/modern-screenshot.umd.js +14 -0
- package/agents/reversa/SKILL.md +135 -0
- package/agents/reversa/agents/openai.yaml +3 -0
- package/agents/reversa/references/checkpoint-guide.md +106 -0
- package/agents/reversa/references/state-schema.md +80 -0
- package/agents/reversa/references/step-01-first-run.md +63 -0
- package/agents/reversa/references/step-02-resume.md +88 -0
- package/agents/reversa/references/step-03-specs-organization.md +145 -0
- package/agents/reversa/references/step-04-regression-check.md +94 -0
- package/agents/reversa-add/SKILL.md +131 -0
- package/agents/reversa-add/agents/openai.yaml +5 -0
- package/agents/reversa-agents-help/SKILL.md +211 -0
- package/agents/reversa-agents-help/agents/openai.yaml +3 -0
- package/agents/reversa-arbiter/SKILL.md +140 -0
- package/agents/reversa-arbiter/agents/openai.yaml +5 -0
- package/agents/reversa-archaeologist/SKILL.md +95 -0
- package/agents/reversa-archaeologist/agents/openai.yaml +5 -0
- package/agents/reversa-archaeologist/references/modules-schema.md +69 -0
- package/agents/reversa-architect/SKILL.md +93 -0
- package/agents/reversa-architect/agents/openai.yaml +5 -0
- package/agents/reversa-arquitetura-3d/SKILL.md +163 -0
- package/agents/reversa-arquitetura-3d/agents/openai.yaml +5 -0
- package/agents/reversa-arquitetura-3d/references/ARCH_TOUR.md +242 -0
- package/agents/reversa-arquitetura-3d/references/CALL_GRAPH_3D.md +217 -0
- package/agents/reversa-arquitetura-3d/references/CODE_CITY.md +228 -0
- package/agents/reversa-arquitetura-3d/references/DEPENDENCY_GRAPH_3D.md +240 -0
- package/agents/reversa-arquitetura-3d/references/ERRORS.md +286 -0
- package/agents/reversa-arquitetura-3d/references/LAYER_STACK.md +230 -0
- package/agents/reversa-arquitetura-3d/references/THREE_PATTERNS.md +221 -0
- package/agents/reversa-audit/SKILL.md +98 -0
- package/agents/reversa-audit/agents/openai.yaml +5 -0
- package/agents/reversa-autonomous/SKILL.md +139 -0
- package/agents/reversa-autonomous/agents/openai.yaml +3 -0
- package/agents/reversa-brainstorm/SKILL.md +131 -0
- package/agents/reversa-brainstorm/agents/openai.yaml +3 -0
- package/agents/reversa-challenger/SKILL.md +122 -0
- package/agents/reversa-challenger/agents/openai.yaml +5 -0
- package/agents/reversa-clarify/SKILL.md +103 -0
- package/agents/reversa-clarify/agents/openai.yaml +5 -0
- package/agents/reversa-code-express/SKILL.md +252 -0
- package/agents/reversa-code-express/agents/openai.yaml +5 -0
- package/agents/reversa-coding/SKILL.md +172 -0
- package/agents/reversa-coding/agents/openai.yaml +5 -0
- package/agents/reversa-curator/SKILL.md +133 -0
- package/agents/reversa-curator/agents/openai.yaml +5 -0
- package/agents/reversa-curator/references/decision-rubric.md +52 -0
- package/agents/reversa-curator/references/templates/discard_log.md +37 -0
- package/agents/reversa-curator/references/templates/target_business_rules.md +54 -0
- package/agents/reversa-data-master/SKILL.md +67 -0
- package/agents/reversa-data-master/agents/openai.yaml +5 -0
- package/agents/reversa-debugger/SKILL.md +178 -0
- package/agents/reversa-debugger/agents/openai.yaml +3 -0
- package/agents/reversa-debugger/references/bug-schema.md +123 -0
- package/agents/reversa-debugger/references/bugs-readme-template.md +76 -0
- package/agents/reversa-debugger-debate/SKILL.md +75 -0
- package/agents/reversa-debugger-debate/agents/openai.yaml +5 -0
- package/agents/reversa-debugger-debate/references/debate-protocol.md +102 -0
- package/agents/reversa-debugger-fix/SKILL.md +170 -0
- package/agents/reversa-debugger-fix/agents/openai.yaml +5 -0
- package/agents/reversa-debugger-graph/SKILL.md +94 -0
- package/agents/reversa-debugger-graph/agents/openai.yaml +5 -0
- package/agents/reversa-decouple/SKILL.md +78 -0
- package/agents/reversa-decouple/agents/openai.yaml +5 -0
- package/agents/reversa-depth-inspection/SKILL.md +99 -0
- package/agents/reversa-depth-inspection/agents/openai.yaml +5 -0
- package/agents/reversa-design-system/SKILL.md +77 -0
- package/agents/reversa-design-system/agents/openai.yaml +5 -0
- package/agents/reversa-designer/SKILL.md +217 -0
- package/agents/reversa-designer/agents/openai.yaml +5 -0
- package/agents/reversa-designer/references/paradigm-checklist.md +50 -0
- package/agents/reversa-designer/references/templates/data_migration_plan.md +80 -0
- package/agents/reversa-designer/references/templates/target_architecture.md +68 -0
- package/agents/reversa-designer/references/templates/target_data_model.md +64 -0
- package/agents/reversa-designer/references/templates/target_domain_model.md +62 -0
- package/agents/reversa-designer/references/templates/topology_decision.md +82 -0
- package/agents/reversa-detective/SKILL.md +82 -0
- package/agents/reversa-detective/agents/openai.yaml +5 -0
- package/agents/reversa-docs/SKILL.md +241 -0
- package/agents/reversa-docs/agents/openai.yaml +3 -0
- package/agents/reversa-docs/references/config-schema.json +108 -0
- package/agents/reversa-docs/references/expected_sources.yaml +60 -0
- package/agents/reversa-docs-analyst/SKILL.md +163 -0
- package/agents/reversa-docs-analyst/agents/openai.yaml +5 -0
- package/agents/reversa-docs-mapper/SKILL.md +167 -0
- package/agents/reversa-docs-mapper/agents/openai.yaml +5 -0
- package/agents/reversa-docs-mapper/references/extraction-policy.md +44 -0
- package/agents/reversa-docs-publisher/SKILL.md +323 -0
- package/agents/reversa-docs-publisher/agents/openai.yaml +5 -0
- package/agents/reversa-docs-publisher/references/auxiliary_sources.yaml +27 -0
- package/agents/reversa-docs-publisher/references/vendor-pins.yaml +149 -0
- package/agents/reversa-docs-storyteller/SKILL.md +189 -0
- package/agents/reversa-docs-storyteller/agents/openai.yaml +5 -0
- package/agents/reversa-drafter/SKILL.md +189 -0
- package/agents/reversa-drafter/agents/openai.yaml +5 -0
- package/agents/reversa-especialista-d3/SKILL.md +37 -0
- package/agents/reversa-especialista-d3/agents/openai.yaml +5 -0
- package/agents/reversa-especialista-d3/references/api-core.md +13 -0
- package/agents/reversa-especialista-d3/references/interatividade.md +5 -0
- package/agents/reversa-especialista-d3/references/layouts-complexos.md +8 -0
- package/agents/reversa-explorer/SKILL.md +110 -0
- package/agents/reversa-explorer/agents/openai.yaml +5 -0
- package/agents/reversa-extract-soul/SKILL.md +221 -0
- package/agents/reversa-extract-soul/agents/openai.yaml +5 -0
- package/agents/reversa-forward/SKILL.md +235 -0
- package/agents/reversa-forward/agents/openai.yaml +3 -0
- package/agents/reversa-forward-autonomous/SKILL.md +184 -0
- package/agents/reversa-forward-autonomous/agents/openai.yaml +3 -0
- package/agents/reversa-framer/SKILL.md +124 -0
- package/agents/reversa-framer/agents/openai.yaml +5 -0
- package/agents/reversa-highcharts-visualizer/SKILL.md +123 -0
- package/agents/reversa-highcharts-visualizer/agents/openai.yaml +5 -0
- package/agents/reversa-highcharts-visualizer/references/CHART_CATALOG.md +450 -0
- package/agents/reversa-highcharts-visualizer/references/ERRORS.md +99 -0
- package/agents/reversa-highcharts-visualizer/references/HIGHCHARTS_PATTERNS.md +347 -0
- package/agents/reversa-highcharts-visualizer/scripts/analyze_data.py +219 -0
- package/agents/reversa-highcharts-visualizer/scripts/parse_data.py +246 -0
- package/agents/reversa-highcharts-visualizer/scripts/sample_data.py +208 -0
- package/agents/reversa-ideator/SKILL.md +139 -0
- package/agents/reversa-ideator/agents/openai.yaml +5 -0
- package/agents/reversa-image-prompt-json/SKILL.md +210 -0
- package/agents/reversa-image-prompt-json/agents/openai.yaml +5 -0
- package/agents/reversa-image-prompt-json/references/Examples.md +123 -0
- package/agents/reversa-inspector/SKILL.md +147 -0
- package/agents/reversa-inspector/agents/openai.yaml +5 -0
- package/agents/reversa-inspector/references/parity-coverage-matrix.md +54 -0
- package/agents/reversa-inspector/references/templates/parity_specs.md +64 -0
- package/agents/reversa-inspector/references/templates/parity_test.feature +40 -0
- package/agents/reversa-migrate/SKILL.md +282 -0
- package/agents/reversa-migrate/agents/openai.yaml +3 -0
- package/agents/reversa-migrate/references/auto-defaults.md +52 -0
- package/agents/reversa-migrate/references/expected_legacy_artifacts.yaml +69 -0
- package/agents/reversa-migrate/references/handoff-checklist.md +34 -0
- package/agents/reversa-migrate/references/state.json +28 -0
- package/agents/reversa-migrate/references/templates/ambiguity_log.md +43 -0
- package/agents/reversa-migrate/references/templates/handoff.md +91 -0
- package/agents/reversa-migrate/references/templates/migration_brief.md +52 -0
- package/agents/reversa-migrate/references/templates/pending_decisions.md +36 -0
- package/agents/reversa-modularize/SKILL.md +77 -0
- package/agents/reversa-modularize/agents/openai.yaml +5 -0
- package/agents/reversa-n8n/SKILL.md +256 -0
- package/agents/reversa-n8n/agents/openai.yaml +5 -0
- package/agents/reversa-n8n/references/node-catalog.md +245 -0
- package/agents/reversa-new/SKILL.md +328 -0
- package/agents/reversa-new/agents/openai.yaml +3 -0
- package/agents/reversa-optimize/SKILL.md +80 -0
- package/agents/reversa-optimize/agents/openai.yaml +5 -0
- package/agents/reversa-paradigm-advisor/SKILL.md +168 -0
- package/agents/reversa-paradigm-advisor/agents/openai.yaml +5 -0
- package/agents/reversa-paradigm-advisor/references/paradigm-catalog.md +73 -0
- package/agents/reversa-paradigm-advisor/references/templates/paradigm_decision.md +69 -0
- package/agents/reversa-plan/SKILL.md +92 -0
- package/agents/reversa-plan/agents/openai.yaml +5 -0
- package/agents/reversa-pre-spec/SKILL.md +133 -0
- package/agents/reversa-pre-spec/agents/openai.yaml +5 -0
- package/agents/reversa-pricing/SKILL.md +181 -0
- package/agents/reversa-pricing/agents/openai.yaml +3 -0
- package/agents/reversa-pricing-advisor/SKILL.md +322 -0
- package/agents/reversa-pricing-advisor/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-advisor/references/advisor-schema.json +196 -0
- package/agents/reversa-pricing-advisor/references/advisor-template.md +106 -0
- package/agents/reversa-pricing-advisor/references/sale-models.md +237 -0
- package/agents/reversa-pricing-estimate/SKILL.md +287 -0
- package/agents/reversa-pricing-estimate/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-estimate/references/effort-formula.md +146 -0
- package/agents/reversa-pricing-estimate/references/estimate-schema.json +141 -0
- package/agents/reversa-pricing-estimate/references/estimate-template.md +153 -0
- package/agents/reversa-pricing-estimate/references/example-estimate.json +74 -0
- package/agents/reversa-pricing-estimate/references/example-estimate.md +88 -0
- package/agents/reversa-pricing-estimate/references/market-benchmarks.md +102 -0
- package/agents/reversa-pricing-estimate/references/value-formula.md +123 -0
- package/agents/reversa-pricing-product/SKILL.md +299 -0
- package/agents/reversa-pricing-product/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-product/references/breakeven-formula.md +237 -0
- package/agents/reversa-pricing-product/references/product-schema.json +288 -0
- package/agents/reversa-pricing-product/references/product-template.md +113 -0
- package/agents/reversa-pricing-product/references/store-commissions.md +57 -0
- package/agents/reversa-pricing-profile/SKILL.md +390 -0
- package/agents/reversa-pricing-profile/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-profile/references/example-profile.json +23 -0
- package/agents/reversa-pricing-profile/references/example-profile.md +46 -0
- package/agents/reversa-pricing-profile/references/profile-schema.json +227 -0
- package/agents/reversa-pricing-profile/references/tax-regimes.md +106 -0
- package/agents/reversa-pricing-research/SKILL.md +352 -0
- package/agents/reversa-pricing-research/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-research/references/research-policy.md +213 -0
- package/agents/reversa-pricing-research/references/research-schema.json +330 -0
- package/agents/reversa-pricing-size/SKILL.md +205 -0
- package/agents/reversa-pricing-size/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-size/references/example-size.json +41 -0
- package/agents/reversa-pricing-size/references/size-schema.json +120 -0
- package/agents/reversa-pricing-size/references/sizing-formula.md +183 -0
- package/agents/reversa-principles/SKILL.md +82 -0
- package/agents/reversa-principles/agents/openai.yaml +5 -0
- package/agents/reversa-prune/SKILL.md +85 -0
- package/agents/reversa-prune/agents/openai.yaml +5 -0
- package/agents/reversa-quality/SKILL.md +87 -0
- package/agents/reversa-quality/agents/openai.yaml +5 -0
- package/agents/reversa-reconstructor/SKILL.md +243 -0
- package/agents/reversa-reconstructor/agents/openai.yaml +5 -0
- package/agents/reversa-reconstructor/references/reconstruction-plan-migration-template.md +89 -0
- package/agents/reversa-reconstructor/references/reconstruction-plan-template.md +77 -0
- package/agents/reversa-refactor/SKILL.md +112 -0
- package/agents/reversa-refactor/agents/openai.yaml +3 -0
- package/agents/reversa-refactor/references/opportunity-schema.md +68 -0
- package/agents/reversa-refactor/references/refactor-readme-template.md +35 -0
- package/agents/reversa-requirements/SKILL.md +217 -0
- package/agents/reversa-requirements/agents/openai.yaml +5 -0
- package/agents/reversa-researcher/SKILL.md +136 -0
- package/agents/reversa-researcher/agents/openai.yaml +5 -0
- package/agents/reversa-restructure/SKILL.md +78 -0
- package/agents/reversa-restructure/agents/openai.yaml +5 -0
- package/agents/reversa-resume/SKILL.md +141 -0
- package/agents/reversa-resume/agents/openai.yaml +5 -0
- package/agents/reversa-reviewer/SKILL.md +163 -0
- package/agents/reversa-reviewer/agents/openai.yaml +5 -0
- package/agents/reversa-reviewer/references/confidence-report-template.md +73 -0
- package/agents/reversa-reviewer/references/confidence-rules.md +65 -0
- package/agents/reversa-reviewer/references/questions-template.md +74 -0
- package/agents/reversa-scout/SKILL.md +82 -0
- package/agents/reversa-scout/agents/openai.yaml +5 -0
- package/agents/reversa-scout/references/surface-schema.md +93 -0
- package/agents/reversa-screen-translator/SKILL.md +279 -0
- package/agents/reversa-screen-translator/agents/openai.yaml +5 -0
- package/agents/reversa-screen-translator/references/adapter-pairs.md +97 -0
- package/agents/reversa-screen-translator/references/platform-detection.md +73 -0
- package/agents/reversa-screen-translator/references/templates/golden_manifest.yaml +62 -0
- package/agents/reversa-screen-translator/references/templates/inventory.schema.json +132 -0
- package/agents/reversa-screen-translator/references/templates/screen_deviation_log.md +66 -0
- package/agents/reversa-screen-translator/references/templates/screen_modernization_decision.md +106 -0
- package/agents/reversa-screen-translator/references/templates/target_screens.md +206 -0
- package/agents/reversa-selo-generativo/SKILL.md +176 -0
- package/agents/reversa-selo-generativo/agents/openai.yaml +5 -0
- package/agents/reversa-selo-generativo/references/ERRORS.md +212 -0
- package/agents/reversa-selo-generativo/references/GENERATIVE_PATTERNS.md +365 -0
- package/agents/reversa-selo-generativo/references/PALETTE_BY_STYLE.md +176 -0
- package/agents/reversa-simplify/SKILL.md +79 -0
- package/agents/reversa-simplify/agents/openai.yaml +5 -0
- package/agents/reversa-spec-sdd/SKILL.md +278 -0
- package/agents/reversa-spec-sdd/agents/openai.yaml +5 -0
- package/agents/reversa-spec-sdd/assets/spec_examples.md +159 -0
- package/agents/reversa-spec-sdd/references/evaluation_rubric.md +113 -0
- package/agents/reversa-spec-sdd/references/sdd_guide.md +124 -0
- package/agents/reversa-spec-sdd/references/spec_template.md +231 -0
- package/agents/reversa-spec-sdd/scripts/spec_scorer.py +476 -0
- package/agents/reversa-standardize/SKILL.md +76 -0
- package/agents/reversa-standardize/agents/openai.yaml +5 -0
- package/agents/reversa-strategist/SKILL.md +119 -0
- package/agents/reversa-strategist/agents/openai.yaml +5 -0
- package/agents/reversa-strategist/references/migration-strategies.md +41 -0
- package/agents/reversa-strategist/references/templates/cutover_plan.md +60 -0
- package/agents/reversa-strategist/references/templates/migration_strategy.md +55 -0
- package/agents/reversa-strategist/references/templates/risk_register.md +44 -0
- package/agents/reversa-sync/SKILL.md +100 -0
- package/agents/reversa-sync/agents/openai.yaml +5 -0
- package/agents/reversa-to-do/SKILL.md +89 -0
- package/agents/reversa-to-do/agents/openai.yaml +5 -0
- package/agents/reversa-visor/SKILL.md +91 -0
- package/agents/reversa-visor/agents/openai.yaml +5 -0
- package/agents/reversa-writer/SKILL.md +212 -0
- package/agents/reversa-writer/agents/openai.yaml +5 -0
- package/agents/reversa-writer/references/design-template.md +49 -0
- package/agents/reversa-writer/references/requirements-template.md +62 -0
- package/agents/reversa-writer/references/tasks-template.md +39 -0
- package/bin/reversa.js +65 -0
- package/lib/commands/add-engine.js +97 -0
- package/lib/commands/export-diagrams.js +194 -0
- package/lib/commands/install.js +260 -0
- package/lib/commands/status.js +35 -0
- package/lib/commands/uninstall.js +159 -0
- package/lib/commands/update.js +252 -0
- package/lib/installer/bundled.js +42 -0
- package/lib/installer/detector.js +167 -0
- package/lib/installer/manifest.js +61 -0
- package/lib/installer/orange-prompts.js +13 -0
- package/lib/installer/policy.js +53 -0
- package/lib/installer/prompts.js +252 -0
- package/lib/installer/validator.js +22 -0
- package/lib/installer/writer.js +376 -0
- package/lib/utils/banner.js +35 -0
- package/lib/utils/json-safe.js +10 -0
- package/lib/utils/package-info.js +22 -0
- package/package.json +51 -4
- package/templates/config.toml +46 -0
- package/templates/config.user.toml +8 -0
- package/templates/documentation/assets/css/style.css +476 -0
- package/templates/documentation/assets/js/nav.js +141 -0
- package/templates/documentation/assets/js/sidebar.js +162 -0
- package/templates/documentation/demo/viewer-demo.html +200 -0
- package/templates/documentation/pages/arquitetura.html.tpl +36 -0
- package/templates/documentation/pages/deck.html.tpl +27 -0
- package/templates/documentation/pages/features/feature.html.tpl +44 -0
- package/templates/documentation/pages/glossario.html.tpl +30 -0
- package/templates/documentation/pages/index.html.tpl +32 -0
- package/templates/documentation/pages/metricas.html.tpl +43 -0
- package/templates/documentation/pages/modulos.html.tpl +33 -0
- package/templates/documentation/pages/timeline.html.tpl +33 -0
- package/templates/documentation/pages/topologia.html.tpl +31 -0
- package/templates/documentation/scripts/convert_chronicle.py +71 -0
- package/templates/documentation/scripts/convert_soul.py +73 -0
- package/templates/documentation/scripts/extract_deps.py +54 -0
- package/templates/documentation/scripts/extract_modules.py +90 -0
- package/templates/documentation/scripts/list_specs.py +74 -0
- package/templates/documentation/viewer.html +60 -0
- package/templates/engines/AGENTS.md +26 -0
- package/templates/engines/CLAUDE.md +27 -0
- package/templates/engines/CONVENTIONS.md +26 -0
- package/templates/engines/GEMINI.md +26 -0
- package/templates/engines/amazonq +7 -0
- package/templates/engines/clinerules +7 -0
- package/templates/engines/copilot-instructions +26 -0
- package/templates/engines/cursorrules +7 -0
- package/templates/engines/roorules +7 -0
- package/templates/engines/windsurf +7 -0
- package/templates/forward/body/actions-template.md +83 -0
- package/templates/forward/body/principles-template.md +75 -0
- package/templates/forward/body/quality-template.md +103 -0
- package/templates/forward/body/requirements-template.md +121 -0
- package/templates/forward/body/roadmap-template.md +107 -0
- package/templates/forward/hooks.yml +60 -0
- package/templates/forward/scripts/ps/bind-to-extraction.ps1 +71 -0
- package/templates/forward/scripts/ps/prepare-roadmap.ps1 +84 -0
- package/templates/forward/scripts/ps/verify-prerequisites.ps1 +103 -0
- package/templates/forward/scripts/sh/bind-to-extraction.sh +103 -0
- package/templates/forward/scripts/sh/prepare-roadmap.sh +79 -0
- package/templates/forward/scripts/sh/verify-prerequisites.sh +125 -0
- package/templates/forward/setup.json +24 -0
- package/templates/hooks/README.md +41 -0
- package/templates/hooks/check-legacy-policy.mjs +0 -0
- package/templates/migration/artifacts/ambiguity_log.md +43 -0
- package/templates/migration/artifacts/cutover_plan.md +60 -0
- package/templates/migration/artifacts/data_migration_plan.md +80 -0
- package/templates/migration/artifacts/discard_log.md +37 -0
- package/templates/migration/artifacts/handoff.md +76 -0
- package/templates/migration/artifacts/migration_brief.md +52 -0
- package/templates/migration/artifacts/migration_strategy.md +55 -0
- package/templates/migration/artifacts/paradigm_decision.md +69 -0
- package/templates/migration/artifacts/parity_specs.md +64 -0
- package/templates/migration/artifacts/parity_test.feature +40 -0
- package/templates/migration/artifacts/pending_decisions.md +36 -0
- package/templates/migration/artifacts/risk_register.md +44 -0
- package/templates/migration/artifacts/target_architecture.md +68 -0
- package/templates/migration/artifacts/target_business_rules.md +54 -0
- package/templates/migration/artifacts/target_data_model.md +64 -0
- package/templates/migration/artifacts/target_domain_model.md +62 -0
- package/templates/migration/catalogs/migration_strategies.md +101 -0
- package/templates/migration/catalogs/paradigm_catalog.md +101 -0
- package/templates/migration/expected_legacy_artifacts.yaml +77 -0
- package/templates/migration/state.json +28 -0
- package/templates/plan.md +65 -0
- package/templates/reversa-config.json +5 -0
- package/templates/state.json +18 -0
|
@@ -0,0 +1,210 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-image-prompt-json
|
|
3
|
+
description: Cria prompts JSON estruturados para geração de imagens com estética luxuosa e cinematográfica (foto de produto, comida, cosmético, joia, moda).
|
|
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: image-prompt-builder
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# Image Prompt Builder
|
|
16
|
+
|
|
17
|
+
Skill para construir prompts JSON estruturados para geração de imagens de produtos com
|
|
18
|
+
estética cinematográfica e luxuosa — otimizada para **Nano Banana 2 (Gemini 3.1 Flash Image)**
|
|
19
|
+
via **Google Antigravity**, com suporte a todos os parâmetros nativos do modelo.
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Fluxo obrigatório
|
|
24
|
+
|
|
25
|
+
Ao ser ativada, esta skill deve **SEMPRE** seguir estas etapas em ordem:
|
|
26
|
+
|
|
27
|
+
1. **Entrevista guiada** — Coletar informações do usuário por blocos
|
|
28
|
+
2. **Confirmação** — Mostrar resumo e pedir aprovação
|
|
29
|
+
3. **Geração do JSON** — Montar o prompt estruturado final
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## ETAPA 1 — Entrevista guiada por blocos
|
|
34
|
+
|
|
35
|
+
Colete as informações em **3 rodadas de perguntas**, nunca tudo de uma vez.
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
### Rodada 1 — Produto e Cena
|
|
40
|
+
|
|
41
|
+
Pergunte ao usuário:
|
|
42
|
+
|
|
43
|
+
> "Vamos montar seu prompt de imagem! Preciso entender o produto primeiro. Me conta:"
|
|
44
|
+
|
|
45
|
+
1. **Tipo de produto**: O que é o produto? (ex: bolo de chocolate, frasco de perfume, tênis, shake, joia...)
|
|
46
|
+
2. **Nome da marca**: Tem marca visível? Se sim, qual é o nome?
|
|
47
|
+
3. **Aparência do produto**: Descreva a cor, textura, acabamento, forma. Quanto mais detalhe, melhor.
|
|
48
|
+
4. **Elementos extras**: Tem acompanhamentos? (frutas, gelo, flores, folhas, reflexos...)
|
|
49
|
+
5. **Tipo de cena**: Qual é o clima geral da imagem?
|
|
50
|
+
- Opções sugeridas: luxuoso e cinematográfico / clean e minimalista / dramático e contrastado / quente e aconchegante / futurista e tecnológico
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
### Rodada 2 — Composição e Ação
|
|
55
|
+
|
|
56
|
+
> "Ótimo! Agora me conta sobre o visual dinâmico da imagem:"
|
|
57
|
+
|
|
58
|
+
6. **Ação principal**: O produto está estático ou tem movimento? (ex: líquido explodindo, partículas suspensas, fumaça, splash, corte revelando interior...)
|
|
59
|
+
7. **Elementos suspensos no ar**: Quais elementos voam ao redor do produto? (ex: gotas, pó, fragmentos, folhas, cristais, bolhas...)
|
|
60
|
+
8. **Superfície de apoio**: Onde o produto está? (ex: mármore branco polido, pedra preta fosca, madeira rústica, vidro transparente, superfície abstrata...)
|
|
61
|
+
9. **Ângulo da câmera**: Como a câmera filma o produto?
|
|
62
|
+
- Opções: ângulo baixo (dominância) / nível dos olhos / levemente acima / macro extremo / ângulo 3/4
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
### Rodada 3 — Iluminação, Cores e Especificações Técnicas
|
|
67
|
+
|
|
68
|
+
> "Quase lá! Agora a parte visual e técnica:"
|
|
69
|
+
|
|
70
|
+
10. **Estilo de iluminação**: Como você quer a luz?
|
|
71
|
+
- Opções: estúdio clean e brilhante / dramático com sombras / luz natural suave / luz de produto de luxo com rim light / luz néon colorida
|
|
72
|
+
|
|
73
|
+
11. **Paleta de cores do fundo**: Qual cor/gradiente domina o fundo? (ex: preto carvão com bokeh âmbar, gradiente rosa para champanhe, azul escuro para branco...)
|
|
74
|
+
|
|
75
|
+
12. **Cores de destaque (accents)**: Quais cores surgem nos elementos ao redor? (ex: dourado, prata, vermelho vivo, tons pastéis...)
|
|
76
|
+
|
|
77
|
+
13. **Resolução**: Qual nível de qualidade você precisa?
|
|
78
|
+
- `512px` — iteração rápida / testes
|
|
79
|
+
- `1K` — redes sociais e uso digital
|
|
80
|
+
- `2K` — conteúdo profissional
|
|
81
|
+
- `4K` — produção máxima / impressão
|
|
82
|
+
|
|
83
|
+
14. **Aspect Ratio**: Qual proporção da imagem? (padrão: `16:9`)
|
|
84
|
+
- `16:9` — widescreen (padrão) ✅
|
|
85
|
+
- `1:1` — quadrado (Instagram feed)
|
|
86
|
+
- `9:16` — vertical (Stories, Reels, TikTok)
|
|
87
|
+
- `4:3` — clássico
|
|
88
|
+
- `3:4` — retrato
|
|
89
|
+
- `4:1` / `1:4` — banner horizontal / vertical
|
|
90
|
+
- `8:1` / `1:8` — super banner
|
|
91
|
+
|
|
92
|
+
15. **Estilo de renderização**: Fotorrealista ultra-detalhado / ilustração / 3D render / foto analógica / outro?
|
|
93
|
+
|
|
94
|
+
16. **Algo mais?**: Algum detalhe especial que você quer garantir na imagem?
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
## ETAPA 2 — Confirmação
|
|
99
|
+
|
|
100
|
+
Após coletar todas as respostas, mostre um **resumo em tópicos** para o usuário confirmar:
|
|
101
|
+
|
|
102
|
+
```
|
|
103
|
+
📋 RESUMO DO PROMPT:
|
|
104
|
+
- Produto: [tipo] — [marca]
|
|
105
|
+
- Aparência: [descrição]
|
|
106
|
+
- Cena: [tipo]
|
|
107
|
+
- Ação: [descrição]
|
|
108
|
+
- Elementos suspensos: [lista]
|
|
109
|
+
- Superfície: [descrição]
|
|
110
|
+
- Ângulo: [ângulo]
|
|
111
|
+
- Iluminação: [estilo]
|
|
112
|
+
- Fundo: [cores]
|
|
113
|
+
- Accents: [cores]
|
|
114
|
+
- Resolução: [ex: 2K]
|
|
115
|
+
- Aspect Ratio: [ex: 1:1]
|
|
116
|
+
- Renderização: [ex: ultra-photorealistic]
|
|
117
|
+
|
|
118
|
+
Está correto? Posso montar o prompt JSON agora?
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
Só avance para a Etapa 3 após confirmação do usuário.
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
## ETAPA 3 — Geração do JSON
|
|
126
|
+
|
|
127
|
+
Com as respostas confirmadas, monte o prompt seguindo **exatamente** este schema:
|
|
128
|
+
|
|
129
|
+
```json
|
|
130
|
+
{
|
|
131
|
+
"master_prompt": {
|
|
132
|
+
"scene_type": "[velocidade/estilo] [nicho] photography",
|
|
133
|
+
"product": {
|
|
134
|
+
"type": "[descrição rica e adjetivada do produto]",
|
|
135
|
+
"brand_name": "[nome da marca ou 'no visible branding']",
|
|
136
|
+
"appearance": "[cor, textura, forma, acabamento detalhados]",
|
|
137
|
+
"accompaniments": [
|
|
138
|
+
"[elemento 1 com descrição sensorial]",
|
|
139
|
+
"[elemento 2 com descrição sensorial]"
|
|
140
|
+
]
|
|
141
|
+
},
|
|
142
|
+
"composition": {
|
|
143
|
+
"action": "[ação dramática central capturada em movimento]",
|
|
144
|
+
"surrounding_elements": [
|
|
145
|
+
"[elemento suspenso 1 com detalhe de movimento]",
|
|
146
|
+
"[elemento suspenso 2 com detalhe de movimento]",
|
|
147
|
+
"[elemento suspenso 3 com detalhe de movimento]"
|
|
148
|
+
],
|
|
149
|
+
"placement": "[posicionamento hero centralizado na superfície especificada]"
|
|
150
|
+
},
|
|
151
|
+
"lighting": {
|
|
152
|
+
"style": "[estilo de iluminação completo]",
|
|
153
|
+
"effects": [
|
|
154
|
+
"[efeito de rim light]",
|
|
155
|
+
"[efeito de key light]",
|
|
156
|
+
"[efeito de backlight ou top light]",
|
|
157
|
+
"[efeito extra se necessário]"
|
|
158
|
+
]
|
|
159
|
+
},
|
|
160
|
+
"color_palette": {
|
|
161
|
+
"background": "[gradiente/bokeh do fundo com descrição de transição]",
|
|
162
|
+
"accents": "[lista de cores de destaque separadas por vírgula]"
|
|
163
|
+
},
|
|
164
|
+
"technical_specs": {
|
|
165
|
+
"camera": "[tipo de lente], [ângulo escolhido]",
|
|
166
|
+
"shutter": "[tipo de captura — freeze-motion, long exposure, etc.]",
|
|
167
|
+
"depth_of_field": "[foco principal], [descrição do blur]",
|
|
168
|
+
"rendering_style": "[fotorrealista / ilustração / 3D render / foto analógica / etc.]"
|
|
169
|
+
},
|
|
170
|
+
"output_specs": {
|
|
171
|
+
"resolution": "[512px | 1K | 2K | 4K]",
|
|
172
|
+
"aspect_ratio": "16:9",
|
|
173
|
+
"model": "nano-banana-2",
|
|
174
|
+
"synthid_watermark": true
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
---
|
|
181
|
+
|
|
182
|
+
## Regras de qualidade do JSON
|
|
183
|
+
|
|
184
|
+
- **Adjetivos de luxo e premium** são obrigatórios em todo campo descritivo
|
|
185
|
+
- **Movimento congelado** deve sempre estar presente em `action` e `surrounding_elements`
|
|
186
|
+
- **Superfícies reflexivas** devem ser mencionadas em `placement`
|
|
187
|
+
- O produto é sempre o **herói centralizado** da cena
|
|
188
|
+
- `surrounding_elements` deve ter **mínimo 3, máximo 6 itens**
|
|
189
|
+
- `lighting.effects` deve ter **sempre 3 ou 4 efeitos** (rim, key, back/top + extra opcional)
|
|
190
|
+
- `scene_type` deve seguir o padrão: `"[adjetivo de velocidade/estilo] [nicho] photography"`
|
|
191
|
+
- `output_specs.resolution` deve usar os valores nativos do Nano Banana 2: `512px`, `1K`, `2K` ou `4K`
|
|
192
|
+
- `output_specs.aspect_ratio` deve usar os valores nativos suportados pelo modelo
|
|
193
|
+
- `output_specs.model` deve sempre ser `"nano-banana-2"`
|
|
194
|
+
- `output_specs.synthid_watermark` deve sempre ser `true` (padrão obrigatório do Google)
|
|
195
|
+
|
|
196
|
+
---
|
|
197
|
+
|
|
198
|
+
## Após gerar o JSON
|
|
199
|
+
|
|
200
|
+
Apresente o JSON formatado em bloco de código e adicione:
|
|
201
|
+
|
|
202
|
+
> 💡 **Dica de uso no Antigravity:** Cole este JSON diretamente no campo de prompt do Nano Banana 2 no Google Antigravity. Os campos `output_specs` são interpretados nativamente pelo modelo — não é necessário nenhum prefixo adicional.
|
|
203
|
+
|
|
204
|
+
Pergunte se o usuário quer ajustar algum campo, trocar o aspect ratio ou gerar variações.
|
|
205
|
+
|
|
206
|
+
---
|
|
207
|
+
|
|
208
|
+
## Exemplos de referência
|
|
209
|
+
|
|
210
|
+
Para inspiração dos padrões de linguagem, consulte `/mnt/skills/user/image-prompt-builder/references/examples.md` se disponível.
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
# Exemplos de Referência — Image Prompt Builder
|
|
2
|
+
|
|
3
|
+
Estes exemplos demonstram o padrão de linguagem e estrutura esperados nos prompts gerados.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Exemplo 1 — Sobremesa (Lava Cake)
|
|
8
|
+
|
|
9
|
+
```json
|
|
10
|
+
{
|
|
11
|
+
"master_prompt": {
|
|
12
|
+
"scene_type": "high-speed cinematic luxury dessert photography",
|
|
13
|
+
"product": {
|
|
14
|
+
"type": "ultra-premium molten chocolate lava cake",
|
|
15
|
+
"brand_name": "no visible branding",
|
|
16
|
+
"appearance": "perfectly baked dark chocolate fondant with slightly cracked top and rich molten dark chocolate core flowing smoothly",
|
|
17
|
+
"accompaniments": [
|
|
18
|
+
"quenelle of vanilla bean ice cream",
|
|
19
|
+
"fresh raspberries with natural gloss",
|
|
20
|
+
"mint micro-leaves for elegance"
|
|
21
|
+
]
|
|
22
|
+
},
|
|
23
|
+
"composition": {
|
|
24
|
+
"action": "dramatic molten chocolate burst captured mid-flow as cake is gently sliced",
|
|
25
|
+
"surrounding_elements": [
|
|
26
|
+
"cocoa powder dust explosion frozen mid-air",
|
|
27
|
+
"dark chocolate shards suspended dynamically",
|
|
28
|
+
"gold flakes subtly dispersing",
|
|
29
|
+
"raspberry juice droplets captured in motion"
|
|
30
|
+
],
|
|
31
|
+
"placement": "centered hero dessert on matte black stone plate with subtle reflection on polished marble surface"
|
|
32
|
+
},
|
|
33
|
+
"lighting": {
|
|
34
|
+
"style": "luxury studio dessert lighting",
|
|
35
|
+
"effects": [
|
|
36
|
+
"soft rim lighting outlining cake texture",
|
|
37
|
+
"warm directional key light enhancing molten gloss",
|
|
38
|
+
"gentle top light defining ice cream texture",
|
|
39
|
+
"subtle backlight for cinematic depth and separation"
|
|
40
|
+
]
|
|
41
|
+
},
|
|
42
|
+
"color_palette": {
|
|
43
|
+
"background": "deep charcoal fading into warm amber bokeh",
|
|
44
|
+
"accents": "rich dark chocolate brown, creamy ivory, vibrant raspberry red, matte black, subtle gold highlights"
|
|
45
|
+
},
|
|
46
|
+
"technical_specs": {
|
|
47
|
+
"camera": "macro lens, slight low angle for premium dominance",
|
|
48
|
+
"shutter": "ultra-fast freeze-motion capture",
|
|
49
|
+
"depth_of_field": "shallow focus on molten center, soft blur on suspended particles",
|
|
50
|
+
"rendering_style": "ultra-photorealistic texture detailing"
|
|
51
|
+
},
|
|
52
|
+
"output_specs": {
|
|
53
|
+
"resolution": "4K",
|
|
54
|
+
"aspect_ratio": "16:9", — Bebida (Shake)
|
|
55
|
+
|
|
56
|
+
```json
|
|
57
|
+
{
|
|
58
|
+
"master_prompt": {
|
|
59
|
+
"scene_type": "high-speed commercial luxury shake photography",
|
|
60
|
+
"product": {
|
|
61
|
+
"type": "elegant frosted glass bottle filled with velvety strawberry shake",
|
|
62
|
+
"brand_name": "ROSÉ VELVET",
|
|
63
|
+
"appearance": "minimalist vertical blush label with embossed rose-gold serif typography, creamy pastel pink liquid with natural strawberry swirls",
|
|
64
|
+
"accompaniments": [
|
|
65
|
+
"fresh strawberry halves with visible seeds and juicy texture",
|
|
66
|
+
"soft dusting of powdered sugar diffusing delicately"
|
|
67
|
+
]
|
|
68
|
+
},
|
|
69
|
+
"composition": {
|
|
70
|
+
"action": "dynamic high-velocity creamy splash explosion",
|
|
71
|
+
"surrounding_elements": [
|
|
72
|
+
"sculptural waves of thick strawberry shake splashing outward",
|
|
73
|
+
"silky ribbons of strawberry puree suspended mid-air",
|
|
74
|
+
"floating fresh strawberry halves with visible seeds",
|
|
75
|
+
"fine droplets of creamy pink mist catching the light"
|
|
76
|
+
],
|
|
77
|
+
"placement": "centered hero bottle with a crisp reflection on a polished white marble surface"
|
|
78
|
+
},
|
|
79
|
+
"lighting": {
|
|
80
|
+
"style": "luxury glossy studio product lighting",
|
|
81
|
+
"effects": [
|
|
82
|
+
"sharp rim lighting to define bottle silhouette",
|
|
83
|
+
"brilliant highlights on creamy splashes and glossy strawberry surfaces",
|
|
84
|
+
"soft rosy glow in the background for warmth and elegance"
|
|
85
|
+
]
|
|
86
|
+
},
|
|
87
|
+
"color_palette": {
|
|
88
|
+
"background": "smooth gradient of blush pink fading into soft champagne ivory",
|
|
89
|
+
"accents": "fresh strawberry red, rose gold, and creamy vanilla tones"
|
|
90
|
+
},
|
|
91
|
+
"technical_specs": {
|
|
92
|
+
"camera": "macro lens, eye-level angle",
|
|
93
|
+
"shutter": "ultra-fast freeze-motion capture",
|
|
94
|
+
"depth_of_field": "shallow focus on the label, gentle blur on dynamic splash elements",
|
|
95
|
+
"rendering_style": "ultra-photorealistic texture"
|
|
96
|
+
},
|
|
97
|
+
"output_specs": {
|
|
98
|
+
"resolution": "4K",
|
|
99
|
+
"aspect_ratio": "1:1",
|
|
100
|
+
"model": "nano-banana-2",
|
|
101
|
+
"synthid_watermark": true
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
---
|
|
108
|
+
|
|
109
|
+
## Padrões linguísticos obrigatórios
|
|
110
|
+
|
|
111
|
+
| Campo | Padrão esperado |
|
|
112
|
+
|---|---|
|
|
113
|
+
| `type` | adjetivo premium + material + nome do produto |
|
|
114
|
+
| `action` | verbo de impacto + movimento congelado + contexto |
|
|
115
|
+
| `surrounding_elements` | substantivo visual + detalhe de movimento/textura |
|
|
116
|
+
| `placement` | "centered hero [produto] on [superfície] with [reflexo]" |
|
|
117
|
+
| `lighting.effects` | rim / key / top ou back / extra opcional |
|
|
118
|
+
| `background` | cor principal + transição + efeito (bokeh, gradiente...) |
|
|
119
|
+
| `rendering_style` | descritor de realismo ou estilo visual |
|
|
120
|
+
| `resolution` | `512px` / `1K` / `2K` / `4K` |
|
|
121
|
+
| `aspect_ratio` | `1:1` / `16:9` / `9:16` / `4:3` / `3:4` / `4:1` / `1:4` / `8:1` / `1:8` |
|
|
122
|
+
| `model` | sempre `"nano-banana-2"` |
|
|
123
|
+
| `synthid_watermark` | sempre `true` |
|
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-inspector
|
|
3
|
+
description: "Quinto agente do Time de Migração. Define como provar que o sistema novo é comportamentalmente equivalente ao legado, com critérios adaptados ao paradigma escolhido. Produz parity_specs.md e parity_tests/*.feature em Gherkin. Ativação: /reversa-inspector (geralmente invocado por /reversa-migrate)."
|
|
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
|
+
role: inspector
|
|
12
|
+
team: migration
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
Você é o **Inspector**, quinto e último agente do Time de Migração.
|
|
16
|
+
|
|
17
|
+
## Missão
|
|
18
|
+
|
|
19
|
+
Definir como provar, durante e após a migração, que o sistema novo é comportamentalmente equivalente ao legado nos pontos onde isso importa. Adaptar critérios de paridade ao paradigma escolhido, porque equivalência funcional ingênua não é suficiente quando há mudança de paradigma.
|
|
20
|
+
|
|
21
|
+
Os artefatos produzidos são **specs de paridade**, não testes executáveis. O agente de codificação do usuário traduz para o framework de teste apropriado.
|
|
22
|
+
|
|
23
|
+
## Pré-requisitos
|
|
24
|
+
|
|
25
|
+
- `_reversa_sdd/migration/paradigm_decision.md`
|
|
26
|
+
- `_reversa_sdd/migration/migration_strategy.md` (com estratégia confirmada)
|
|
27
|
+
- `_reversa_sdd/migration/target_architecture.md` (Designer concluído e arquitetura aprovada)
|
|
28
|
+
- `_reversa_sdd/migration/screen_modernization_decision.md` (Screen Translator concluído ou em modo `skipped`)
|
|
29
|
+
- `_reversa_sdd/migration/screen_deviation_log.md` sem deviations pendentes (deviations bloqueiam o handoff ao Inspector)
|
|
30
|
+
|
|
31
|
+
## Inputs
|
|
32
|
+
|
|
33
|
+
- Os pré-requisitos acima.
|
|
34
|
+
- `_reversa_sdd/code-analysis.md` (fluxos legados)
|
|
35
|
+
- `_reversa_sdd/sequences/` ou `_reversa_sdd/flowcharts/` (se existirem)
|
|
36
|
+
- `_reversa_sdd/characterization_specs/` (se existir; reusar como base)
|
|
37
|
+
- `_reversa_sdd/migration/target_business_rules.md` (regras MIGRAR)
|
|
38
|
+
- `_reversa_sdd/migration/target_domain_model.md`
|
|
39
|
+
- `_reversa_sdd/migration/target_screens.md` (Screen Translator) quando há UI
|
|
40
|
+
- `_reversa_sdd/screens/golden/manifest.yaml` (Screen Translator) quando o oráculo executa
|
|
41
|
+
|
|
42
|
+
## Outputs
|
|
43
|
+
|
|
44
|
+
- `_reversa_sdd/migration/parity_specs.md`
|
|
45
|
+
- `_reversa_sdd/migration/parity_tests/*.feature` (um arquivo por fluxo crítico)
|
|
46
|
+
|
|
47
|
+
## Procedimento
|
|
48
|
+
|
|
49
|
+
### 1. Ler `paradigm_decision.md`
|
|
50
|
+
|
|
51
|
+
Identifique a transição de paradigma (se houver). A transição define quais dimensões adicionais de paridade são necessárias.
|
|
52
|
+
|
|
53
|
+
### 2. Definir estratégia geral em `parity_specs.md`
|
|
54
|
+
|
|
55
|
+
Selecione e marque os modos de validação aplicáveis:
|
|
56
|
+
|
|
57
|
+
- Shadow mode (espelhamento de tráfego com comparação assíncrona).
|
|
58
|
+
- Characterization tests (suíte derivada do comportamento atual do legado).
|
|
59
|
+
- Contract tests (interfaces externas).
|
|
60
|
+
- Data parity (snapshots e checksums).
|
|
61
|
+
|
|
62
|
+
Critérios de "paridade aceita" obrigatórios:
|
|
63
|
+
|
|
64
|
+
- Métrica primária (ex: índice de divergência funcional < 0,01% em 30 dias).
|
|
65
|
+
- Janela de observação.
|
|
66
|
+
- Critério de bloqueio do cutover.
|
|
67
|
+
|
|
68
|
+
### 2b. Incorporar paridade de telas
|
|
69
|
+
|
|
70
|
+
Se `_reversa_sdd/migration/screen_modernization_decision.md` existe e não está em `skipped`:
|
|
71
|
+
|
|
72
|
+
- Em modo **literal**: adicione modo de validação **golden file comparison** à `parity_specs.md`. Para cada tela com entrada em `_reversa_sdd/screens/golden/manifest.yaml`, exija comparação byte-a-byte (ou pixel-equivalente) entre o output da implementação alvo e o golden file, dentro das `normalizationRules` declaradas no manifest. Crie um cenário Gherkin por tela em `parity_tests/screens/<NN>-<tela>.feature` com tag `@paridade-visual`.
|
|
73
|
+
- Em modo **modernizado**: adicione modo de validação **contract test de tela**. Para cada tela em `target_screens.md`, exija que a implementação respeite a hierarquia de componentes, eventos declarados, conteúdo textual e os 4 estados (idle, loading, error, success). Não há comparação byte-a-byte.
|
|
74
|
+
- Em modo **híbrido**: aplique cada estratégia conforme o modo declarado da tela em `screen_modernization_decision.md`.
|
|
75
|
+
- Em status `skipped` (legado sem UI): pule esta seção; nenhum cenário de paridade visual é gerado.
|
|
76
|
+
|
|
77
|
+
Toda deviation aprovada em `_reversa_sdd/migration/screen_deviation_log.md` deve ser propagada para `parity_specs.md § Exceções`, com referência ao `DEV-XXX` original. Deviations pendentes bloquearam o handoff e não chegam aqui.
|
|
78
|
+
|
|
79
|
+
### 3. Adaptar cobertura ao paradigma alvo
|
|
80
|
+
|
|
81
|
+
Use a tabela abaixo para definir cobertura mínima:
|
|
82
|
+
|
|
83
|
+
| Transição | Dimensões adicionais obrigatórias |
|
|
84
|
+
|---|---|
|
|
85
|
+
| sem mudança | equivalência funcional padrão (mesma entrada → mesma saída) |
|
|
86
|
+
| síncrono → event-driven | ordem de mensagens, idempotência, consistência eventual, comportamento sob falha de fila |
|
|
87
|
+
| procedural → OO | invariantes em aggregates, validação em factories / construtores |
|
|
88
|
+
| OO → funcional | imutabilidade, ausência de side effects esperados, equivalência sob composição |
|
|
89
|
+
| OO clássico → OO com DI | comportamento equivalente sem dependência de Active Record, mocks de repositório |
|
|
90
|
+
| qualquer → actor model | isolamento de estado, supervisão e recuperação após falha |
|
|
91
|
+
|
|
92
|
+
Documente a cobertura adaptada na seção "Cobertura adaptada ao paradigma" de `parity_specs.md`.
|
|
93
|
+
|
|
94
|
+
### 4. Identificar fluxos críticos
|
|
95
|
+
|
|
96
|
+
Liste fluxos que precisam de cobertura Gherkin:
|
|
97
|
+
|
|
98
|
+
- Fluxos cobertos por `characterization_specs/` (se existir): adaptar.
|
|
99
|
+
- Fluxos críticos identificados em `code-analysis.md` ou `sequences/`.
|
|
100
|
+
- Fluxos derivados de regras `BR-MIGRAR-XXX` marcadas como críticas.
|
|
101
|
+
|
|
102
|
+
Para cada fluxo, gere um arquivo `parity_tests/<NN>-<nome-curto>.feature` usando o template em `references/templates/parity_test.feature`.
|
|
103
|
+
|
|
104
|
+
Cada `.feature` deve:
|
|
105
|
+
|
|
106
|
+
- Conter front-matter de comentário com `spec-id`, rastreabilidade ao `process_flows`, ao `target_architecture` e ao paradigma alvo.
|
|
107
|
+
- Cobrir cenário positivo, edge case relevante, e (quando paradigma exigir) cenários de idempotência e ordem.
|
|
108
|
+
- Usar tags consistentes (`@paridade`, `@critico`, `@idempotencia`, `@ordem`, `@regulatorio` quando aplicável).
|
|
109
|
+
- Estar em **Gherkin válido** (Funcionalidade / Cenário / Dado / Quando / Então).
|
|
110
|
+
|
|
111
|
+
### 5. Reusar characterization_specs
|
|
112
|
+
|
|
113
|
+
Se `_reversa_sdd/characterization_specs/` existir, leia e reuse como base. Adapte:
|
|
114
|
+
|
|
115
|
+
- Entradas / saídas para o sistema novo.
|
|
116
|
+
- Critérios de aceitação ao paradigma alvo.
|
|
117
|
+
- Mantenha rastreabilidade explícita ao spec original.
|
|
118
|
+
|
|
119
|
+
### 6. Resumir e devolver controle
|
|
120
|
+
|
|
121
|
+
> "Inspector concluiu.
|
|
122
|
+
> - Estratégia de paridade: <modos selecionados>
|
|
123
|
+
> - Critério de paridade aceita: <métrica primária>
|
|
124
|
+
> - Fluxos cobertos: <N> arquivos `.feature`
|
|
125
|
+
> - Cobertura adaptada ao paradigma: <transição detectada>
|
|
126
|
+
>
|
|
127
|
+
> Pipeline de migração concluído. Próximo passo: orquestrador gera `handoff.md`."
|
|
128
|
+
|
|
129
|
+
## Casos de borda
|
|
130
|
+
|
|
131
|
+
- **Sem `characterization_specs/`**: derivar cenários a partir de `code-analysis.md` e `sequences/`. Sinalizar lacuna em `parity_specs.md`.
|
|
132
|
+
- **Paradigma alvo é o mesmo do legado**: `parity_specs.md` usa equivalência funcional padrão sem dimensões adicionais.
|
|
133
|
+
- **Paradigma alvo event-driven com fluxos do legado puramente síncronos**: cada fluxo gera ao menos 3 cenários (`@paridade`, `@idempotencia`, `@ordem`).
|
|
134
|
+
- **Estratégia Parallel Run**: detalhar em `parity_specs.md` que comparação é online; especificar campos de divergência aceitável.
|
|
135
|
+
- **Screen Translator em modo skipped**: ignorar paridade visual; não criar cenários `@paridade-visual`; mencionar em `parity_specs.md` que o sistema não tem UI.
|
|
136
|
+
- **Modo literal sem golden files capturados** (`manifest.yaml` lista todas as entradas com `present: false`): emitir cenários `@paridade-visual` mesmo assim, mas declarar em `parity_specs.md` que a validação será manual até a captura ser executada.
|
|
137
|
+
|
|
138
|
+
## Layout de saída (transversal)
|
|
139
|
+
|
|
140
|
+
Este agente faz parte do Time de Migração e escreve exclusivamente em `_reversa_sdd/migration/`. Essa pasta é transversal à organização escolhida em `[specs]` do `config.toml`, fora das pastas de unit (feature folders) do Time de Descoberta. Não aplicar aqui a estrutura `<unit>/requirements.md|design.md|tasks.md`, ela pertence ao Writer.
|
|
141
|
+
|
|
142
|
+
## Regras absolutas
|
|
143
|
+
|
|
144
|
+
- Não escrever fora de `_reversa_sdd/migration/`.
|
|
145
|
+
- Arquivos `.feature` são **specs**, não testes executáveis. Não introduza chamadas a frameworks.
|
|
146
|
+
- Cada cenário tem rastreabilidade explícita à origem (process_flows, target_architecture).
|
|
147
|
+
- Cobertura adaptada ao paradigma é **obrigatória** quando há mudança de paradigma; não pode ser equivalência funcional ingênua.
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
# Matriz de cobertura de paridade
|
|
2
|
+
|
|
3
|
+
Tabela de referência para definir o conjunto mínimo de cenários `.feature` por fluxo, conforme transição de paradigma.
|
|
4
|
+
|
|
5
|
+
## Cobertura por transição
|
|
6
|
+
|
|
7
|
+
| Transição | Cenários mínimos por fluxo |
|
|
8
|
+
|---|---|
|
|
9
|
+
| sem mudança | `@paridade` (entrada → saída esperada) |
|
|
10
|
+
| procedural → OO | `@paridade` + `@invariante` (invariante de aggregate validado) |
|
|
11
|
+
| procedural → event-driven | `@paridade` + `@idempotencia` + `@ordem` + `@dlq` (comportamento sob falha de fila) |
|
|
12
|
+
| OO clássico → OO com DI | `@paridade` + `@composicao` (sem dependência de Active Record) |
|
|
13
|
+
| OO clássico → event-driven | `@paridade` + `@idempotencia` + `@ordem` + `@saga` (compensação ao falhar) |
|
|
14
|
+
| OO clássico → funcional | `@paridade` + `@imutabilidade` + `@composicao` |
|
|
15
|
+
| OO com DI → event-driven | `@paridade` + `@idempotencia` + `@ordem` |
|
|
16
|
+
| funcional → event-driven | `@paridade` + `@idempotencia` + `@ordem` |
|
|
17
|
+
| qualquer → actor model | `@paridade` + `@supervisao` (recuperação após falha) |
|
|
18
|
+
|
|
19
|
+
## Tags convencionadas
|
|
20
|
+
|
|
21
|
+
- `@paridade`: sempre presente; equivalência principal.
|
|
22
|
+
- `@critico`: fluxo crítico (regulatório, financeiro, dados sensíveis).
|
|
23
|
+
- `@regulatorio`: quando há requisito formal externo.
|
|
24
|
+
- `@idempotencia`: reprocessamento não duplica efeito.
|
|
25
|
+
- `@ordem`: ordem por chave respeitada.
|
|
26
|
+
- `@dlq`: comportamento ao chegar em dead letter queue.
|
|
27
|
+
- `@saga`: compensação em transação distribuída.
|
|
28
|
+
- `@invariante`: invariante de aggregate validado.
|
|
29
|
+
- `@composicao`: comportamento equivalente sob composição funcional.
|
|
30
|
+
- `@imutabilidade`: não há mutação compartilhada.
|
|
31
|
+
- `@supervisao`: supervisor recupera ator falhado.
|
|
32
|
+
|
|
33
|
+
## Critérios de "paridade aceita" típicos
|
|
34
|
+
|
|
35
|
+
| Tipo de sistema | Métrica primária |
|
|
36
|
+
|---|---|
|
|
37
|
+
| Web app sem regulação forte | divergência funcional < 1% por 7 dias |
|
|
38
|
+
| API pública | divergência funcional < 0,1% por 30 dias + zero divergência em contratos públicos |
|
|
39
|
+
| Sistema fiscal / regulatório | divergência funcional < 0,01% por 60 dias + zero divergência em campos regulados |
|
|
40
|
+
| Sistema financeiro | divergência financeira por valor monetário < 0,001% + zero divergência em totalizadores |
|
|
41
|
+
| Sistema interno baixa criticidade | divergência funcional < 5% por 7 dias |
|
|
42
|
+
|
|
43
|
+
## Reuso de characterization_specs
|
|
44
|
+
|
|
45
|
+
Quando `_reversa_sdd/characterization_specs/` existe:
|
|
46
|
+
|
|
47
|
+
1. Para cada spec → derivar `.feature` correspondente, adaptando entradas/saídas ao sistema novo.
|
|
48
|
+
2. Manter o `spec-id` original na rastreabilidade.
|
|
49
|
+
3. Adicionar cenários extras conforme a tabela "Cenários mínimos por fluxo".
|
|
50
|
+
|
|
51
|
+
Quando não existe:
|
|
52
|
+
|
|
53
|
+
1. Inferir fluxos críticos a partir de `code-analysis.md` + `sequences/` + regras `BR-MIGRAR` marcadas como críticas.
|
|
54
|
+
2. Documentar lacuna em `parity_specs.md § Reuso de characterization_specs`.
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: parity_specs
|
|
7
|
+
producedBy: inspector
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Parity Specs
|
|
12
|
+
|
|
13
|
+
> Estratégia de validação de equivalência comportamental entre legado e sistema novo, adaptada ao paradigma escolhido em `paradigm_decision.md`.
|
|
14
|
+
|
|
15
|
+
## Estratégia geral
|
|
16
|
+
- **Modos de validação aplicáveis** (marcar os usados):
|
|
17
|
+
- [ ] Shadow mode (espelhamento de tráfego com comparação assíncrona)
|
|
18
|
+
- [ ] Characterization tests (suíte derivada do comportamento atual do legado)
|
|
19
|
+
- [ ] Contract tests (interfaces externas)
|
|
20
|
+
- [ ] Data parity (snapshots e checksums)
|
|
21
|
+
- [ ] Outro: <especificar>
|
|
22
|
+
|
|
23
|
+
## Critérios de "paridade aceita"
|
|
24
|
+
- **Métrica primária**: <ex: índice de divergência funcional < 0,01% em N dias consecutivos>
|
|
25
|
+
- **Janela de observação**: <período de avaliação>
|
|
26
|
+
- **Critério de bloqueio**: <quando paridade insuficiente bloqueia o cutover>
|
|
27
|
+
|
|
28
|
+
## Cobertura adaptada ao paradigma
|
|
29
|
+
|
|
30
|
+
> Esta seção muda conforme o paradigma alvo confirmado em `paradigm_decision.md`.
|
|
31
|
+
|
|
32
|
+
### Sem mudança de paradigma
|
|
33
|
+
- Equivalência funcional padrão: mesma entrada → mesma saída → mesmo efeito colateral observável.
|
|
34
|
+
|
|
35
|
+
### Mudança síncrono → event-driven
|
|
36
|
+
- **Ordem de mensagens**: <critério de aceitação por canal / partição>
|
|
37
|
+
- **Idempotência**: <prova de que reprocessamento não duplica efeito>
|
|
38
|
+
- **Consistência eventual**: <janela máxima de propagação aceita>
|
|
39
|
+
- **Comportamento sob falha de fila**: <retry, DLQ, replay>
|
|
40
|
+
|
|
41
|
+
### Mudança procedural → OO
|
|
42
|
+
- **Invariantes em aggregates**: <conjunto a validar>
|
|
43
|
+
- **Validação em factories / construtores**: <casos críticos>
|
|
44
|
+
|
|
45
|
+
### Mudança OO → funcional
|
|
46
|
+
- **Imutabilidade**: <pontos críticos a observar>
|
|
47
|
+
- **Ausência de side effects esperados**: <onde o legado tinha efeito colateral implícito>
|
|
48
|
+
- **Equivalência sob composição**: <funções compostas equivalem ao fluxo legado>
|
|
49
|
+
|
|
50
|
+
## Tipos de teste a aplicar
|
|
51
|
+
- **Funcionais**: <descrição, ferramenta>
|
|
52
|
+
- **Contrato**: <descrição, ferramenta>
|
|
53
|
+
- **Carga / performance**: <descrição, alvos>
|
|
54
|
+
- **Resiliência** (se aplicável): <falha de fila, dependência externa indisponível>
|
|
55
|
+
|
|
56
|
+
## Reuso de characterization_specs do time de descoberta
|
|
57
|
+
- **Origem**: `_reversa_sdd/characterization_specs/` ou equivalente disponível.
|
|
58
|
+
- **Adaptações necessárias para o sistema novo**: <texto>
|
|
59
|
+
|
|
60
|
+
## Saídas
|
|
61
|
+
- `parity_tests/*.feature`: cenários em Gherkin para os fluxos críticos.
|
|
62
|
+
|
|
63
|
+
## Notas
|
|
64
|
+
<Observações adicionais.>
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# Template de cenário Gherkin para parity_tests/.
|
|
2
|
+
# Cada arquivo deve cobrir um fluxo crítico identificado em process_flows do legado.
|
|
3
|
+
# Adaptar critérios ao paradigma alvo conforme `parity_specs.md`.
|
|
4
|
+
|
|
5
|
+
# language: pt
|
|
6
|
+
# spec-id: PT-001
|
|
7
|
+
# rastreabilidade:
|
|
8
|
+
# process_flows: <ref ao fluxo no _reversa_sdd>
|
|
9
|
+
# target_architecture: <ref a componente no target_architecture.md>
|
|
10
|
+
# paradigma_alvo: <do paradigm_decision.md>
|
|
11
|
+
|
|
12
|
+
Funcionalidade: <Nome do fluxo>
|
|
13
|
+
Como <ator>
|
|
14
|
+
Quero <ação>
|
|
15
|
+
Para <objetivo>
|
|
16
|
+
|
|
17
|
+
# Critério geral de paridade aplicado a este cenário.
|
|
18
|
+
# Quando o paradigma alvo é event-driven, expressar tolerância de consistência eventual aqui.
|
|
19
|
+
@paridade @critico
|
|
20
|
+
Cenário: <descrição>
|
|
21
|
+
Dado <pré-condição observável>
|
|
22
|
+
E <pré-condição secundária>
|
|
23
|
+
Quando <ação executada via API / comando / evento de entrada>
|
|
24
|
+
Então <efeito observável no sistema novo>
|
|
25
|
+
E <efeito observável persiste após <janela de propagação>>
|
|
26
|
+
|
|
27
|
+
# Cenário específico para validar idempotência (event-driven, retry seguro).
|
|
28
|
+
@paridade @idempotencia
|
|
29
|
+
Cenário: Reprocessamento não duplica efeito
|
|
30
|
+
Dado <pré-condição>
|
|
31
|
+
Quando <ação> é processada uma vez
|
|
32
|
+
E <ação> é reentregue por retry
|
|
33
|
+
Então o efeito observável é idêntico ao da primeira entrega
|
|
34
|
+
|
|
35
|
+
# Cenário específico para validar ordem em paradigma event-driven.
|
|
36
|
+
@paridade @ordem
|
|
37
|
+
Cenário: Ordem de eventos é respeitada por chave
|
|
38
|
+
Dado <chave de particionamento>
|
|
39
|
+
Quando <evento A> é publicado antes de <evento B> com a mesma chave
|
|
40
|
+
Então <efeito observável> reflete a ordem A → B
|