@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,245 @@
|
|
|
1
|
+
# Catálogo de Nós N8N e Mapeamento Python
|
|
2
|
+
|
|
3
|
+
Referência rápida usada pelo `reversa-n8n` para interpretar tipos de nó e sugerir bibliotecas Python equivalentes. Não é exaustivo: cobre os nós mais comuns. Quando o tipo do nó não estiver listado, deduza pelo nome (`type` segue o padrão `n8n-nodes-base.<servico>` ou `@n8n/n8n-nodes-langchain.<servico>`) e pelo `parameters`.
|
|
4
|
+
|
|
5
|
+
## Convenções
|
|
6
|
+
|
|
7
|
+
- **Tipo no JSON**: campo `type` do nó
|
|
8
|
+
- **Significado semântico**: o que o nó representa em termos de negócio
|
|
9
|
+
- **Python**: biblioteca recomendada e padrão de uso
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 1. Triggers (entrada do workflow)
|
|
14
|
+
|
|
15
|
+
| Tipo no JSON | Significado | Python |
|
|
16
|
+
|---|---|---|
|
|
17
|
+
| `n8n-nodes-base.webhook` | Endpoint HTTP que dispara o fluxo | FastAPI ou Flask. Rota POST/GET com `parameters.path` |
|
|
18
|
+
| `n8n-nodes-base.scheduleTrigger` | Disparo periódico (cron) | APScheduler (`BlockingScheduler`) ou systemd timer |
|
|
19
|
+
| `n8n-nodes-base.cron` | Cron clássico (versões antigas) | APScheduler ou crontab |
|
|
20
|
+
| `n8n-nodes-base.intervalTrigger` | Loop de tempo fixo | `while True: ... time.sleep(N)` ou APScheduler |
|
|
21
|
+
| `n8n-nodes-base.manualTrigger` | Execução manual | Script CLI (Typer, argparse) |
|
|
22
|
+
| `n8n-nodes-base.emailReadImap` | Leitura de caixa IMAP | `imapclient` + `email` |
|
|
23
|
+
| `n8n-nodes-base.executeWorkflowTrigger` | Sub-workflow chamado por outro | Função Python invocável |
|
|
24
|
+
| `n8n-nodes-base.errorTrigger` | Disparo em erro de outro workflow | Hook de exceção, decorator de erro |
|
|
25
|
+
|
|
26
|
+
Triggers de serviços (padrão `<servico>Trigger`): mapeiam para webhooks ou polling no SDK do serviço (ex: `slackTrigger` vira webhook do Slack ou polling via `slack-sdk`).
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## 2. HTTP e APIs
|
|
31
|
+
|
|
32
|
+
| Tipo no JSON | Significado | Python |
|
|
33
|
+
|---|---|---|
|
|
34
|
+
| `n8n-nodes-base.httpRequest` | Chamada HTTP genérica | `httpx` (recomendado, suporta sync e async) ou `requests` |
|
|
35
|
+
| `n8n-nodes-base.respondToWebhook` | Resposta a webhook recebido | Return da rota FastAPI/Flask |
|
|
36
|
+
| `n8n-nodes-base.graphql` | Query GraphQL | `gql` ou `httpx` direto |
|
|
37
|
+
| `n8n-nodes-base.webhook` (output) | Confirmação de webhook | Response da rota |
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
## 3. Lógica e fluxo
|
|
42
|
+
|
|
43
|
+
| Tipo no JSON | Significado | Python |
|
|
44
|
+
|---|---|---|
|
|
45
|
+
| `n8n-nodes-base.if` | Condicional binária | `if/else` |
|
|
46
|
+
| `n8n-nodes-base.switch` | Multi-branch por valor | `match/case` (Python 3.10+) ou `if/elif` |
|
|
47
|
+
| `n8n-nodes-base.merge` | Junção de ramos paralelos | Combinação de listas, `dict.update`, `pandas.concat` |
|
|
48
|
+
| `n8n-nodes-base.splitInBatches` | Processamento em lotes | `itertools.batched` (3.12+) ou loop manual |
|
|
49
|
+
| `n8n-nodes-base.itemLists` | Operações de lista (split, agregação) | List comprehension, `itertools` |
|
|
50
|
+
| `n8n-nodes-base.wait` | Espera entre passos | `time.sleep(s)` ou `await asyncio.sleep(s)` |
|
|
51
|
+
| `n8n-nodes-base.noOp` | Passagem direta | `pass` ou função identidade |
|
|
52
|
+
| `n8n-nodes-base.stopAndError` | Interrompe com erro | `raise Exception(...)` |
|
|
53
|
+
| `n8n-nodes-base.executeWorkflow` | Chama outro workflow | Chamada de função/módulo Python |
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## 4. Manipulação de dados
|
|
58
|
+
|
|
59
|
+
| Tipo no JSON | Significado | Python |
|
|
60
|
+
|---|---|---|
|
|
61
|
+
| `n8n-nodes-base.set` | Define valores em campos | Atribuição em dict |
|
|
62
|
+
| `n8n-nodes-base.editFields` | Edita estrutura do item | `dict.update`, list comp, dataclasses |
|
|
63
|
+
| `n8n-nodes-base.removeDuplicates` | Remove duplicatas | `set()`, `dict.fromkeys()`, `pandas.drop_duplicates` |
|
|
64
|
+
| `n8n-nodes-base.aggregate` | Agrupamento e agregação | `itertools.groupby` ou `pandas.groupby` |
|
|
65
|
+
| `n8n-nodes-base.dateTime` | Manipulação de datas | `datetime`, `dateutil`, `arrow`, `pendulum` |
|
|
66
|
+
| `n8n-nodes-base.crypto` | Hash, criptografia | `hashlib`, `hmac`, `cryptography` |
|
|
67
|
+
| `n8n-nodes-base.compression` | Zip, gzip | `zipfile`, `gzip`, `tarfile` |
|
|
68
|
+
| `n8n-nodes-base.xml` | Parse/build XML | `xml.etree.ElementTree`, `lxml` |
|
|
69
|
+
| `n8n-nodes-base.html` | Parse HTML | `beautifulsoup4`, `lxml` |
|
|
70
|
+
| `n8n-nodes-base.markdown` | Conversão Markdown | `markdown`, `mistune` |
|
|
71
|
+
| `n8n-nodes-base.spreadsheetFile` | Leitura/escrita XLSX/CSV | `openpyxl`, `pandas`, `csv` |
|
|
72
|
+
|
|
73
|
+
---
|
|
74
|
+
|
|
75
|
+
## 5. Execução de código
|
|
76
|
+
|
|
77
|
+
| Tipo no JSON | Significado | Python |
|
|
78
|
+
|---|---|---|
|
|
79
|
+
| `n8n-nodes-base.function` | Código JS arbitrário (legacy) | Função Python pura. Ler `parameters.functionCode` e descrever a lógica |
|
|
80
|
+
| `n8n-nodes-base.functionItem` | JS aplicado por item | List comprehension ou `map()` |
|
|
81
|
+
| `n8n-nodes-base.code` | Código JS ou Python (versão nova) | Função Python pura. Verificar `parameters.language` |
|
|
82
|
+
|
|
83
|
+
Ao traduzir Function/Code nodes para o `design.md`: descrever a lógica em pseudocódigo, não copiar o JS literal. O Python equivalente deve ser idiomático.
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
## 6. Bancos de dados
|
|
88
|
+
|
|
89
|
+
| Tipo no JSON | Significado | Python |
|
|
90
|
+
|---|---|---|
|
|
91
|
+
| `n8n-nodes-base.postgres` | Postgres | `psycopg[binary]` (v3) ou `asyncpg` |
|
|
92
|
+
| `n8n-nodes-base.mysql` | MySQL/MariaDB | `pymysql` ou `mysql-connector-python`, `aiomysql` |
|
|
93
|
+
| `n8n-nodes-base.mongoDb` | MongoDB | `pymongo` ou `motor` (async) |
|
|
94
|
+
| `n8n-nodes-base.redis` | Redis | `redis-py` (suporta sync e async) |
|
|
95
|
+
| `n8n-nodes-base.supabase` | Supabase | `supabase-py` |
|
|
96
|
+
| `n8n-nodes-base.microsoftSql` | SQL Server | `pyodbc` ou `pymssql` |
|
|
97
|
+
| `n8n-nodes-base.snowflake` | Snowflake | `snowflake-connector-python` |
|
|
98
|
+
| `n8n-nodes-base.questDb` | QuestDB | `psycopg` (compatível com PG wire) |
|
|
99
|
+
|
|
100
|
+
ORMs sugeridos quando o workflow tiver muitas operações relacionais: `SQLAlchemy 2.x` ou `SQLModel`.
|
|
101
|
+
|
|
102
|
+
---
|
|
103
|
+
|
|
104
|
+
## 7. Comunicação
|
|
105
|
+
|
|
106
|
+
| Tipo no JSON | Significado | Python |
|
|
107
|
+
|---|---|---|
|
|
108
|
+
| `n8n-nodes-base.emailSend` | Envio de email SMTP | `smtplib` + `email`, `yagmail`, `aiosmtplib` |
|
|
109
|
+
| `n8n-nodes-base.gmail` | Gmail (API) | `google-api-python-client` |
|
|
110
|
+
| `n8n-nodes-base.slack` | Slack (mensagens, canais) | `slack-sdk` |
|
|
111
|
+
| `n8n-nodes-base.discord` | Discord | `discord.py` ou webhook direto via `httpx` |
|
|
112
|
+
| `n8n-nodes-base.telegram` | Telegram Bot | `python-telegram-bot` ou `aiogram` |
|
|
113
|
+
| `n8n-nodes-base.whatsApp` | WhatsApp Business API | `httpx` direto (não há SDK oficial Python maduro) |
|
|
114
|
+
| `n8n-nodes-base.twilio` | SMS/voz Twilio | `twilio` SDK |
|
|
115
|
+
| `n8n-nodes-base.sendGrid` | SendGrid | `sendgrid` SDK |
|
|
116
|
+
| `n8n-nodes-base.mailchimp` | Mailchimp | `mailchimp-marketing` |
|
|
117
|
+
|
|
118
|
+
---
|
|
119
|
+
|
|
120
|
+
## 8. IA e LLM
|
|
121
|
+
|
|
122
|
+
| Tipo no JSON | Significado | Python |
|
|
123
|
+
|---|---|---|
|
|
124
|
+
| `n8n-nodes-base.openAi` ou `@n8n/n8n-nodes-langchain.openAi` | OpenAI (chat, embeddings, imagens) | `openai` SDK |
|
|
125
|
+
| `@n8n/n8n-nodes-langchain.lmChatAnthropic` | Anthropic Claude | `anthropic` SDK |
|
|
126
|
+
| `@n8n/n8n-nodes-langchain.lmChatGoogleGemini` | Google Gemini | `google-generativeai` |
|
|
127
|
+
| `@n8n/n8n-nodes-langchain.embeddingsOpenAi` | Embeddings | `openai` SDK |
|
|
128
|
+
| `@n8n/n8n-nodes-langchain.vectorStorePinecone` | Pinecone | `pinecone-client` |
|
|
129
|
+
| `@n8n/n8n-nodes-langchain.vectorStoreSupabase` | Supabase pgvector | `supabase-py` + `pgvector` |
|
|
130
|
+
| `@n8n/n8n-nodes-langchain.vectorStoreQdrant` | Qdrant | `qdrant-client` |
|
|
131
|
+
| `@n8n/n8n-nodes-langchain.agent` | Agent LangChain | `langchain` ou `langgraph` |
|
|
132
|
+
| `@n8n/n8n-nodes-langchain.chainLlm` | Chain básica | Chamada direta ao SDK do LLM |
|
|
133
|
+
| `n8n-nodes-base.huggingFace` | Hugging Face | `transformers`, `huggingface_hub` |
|
|
134
|
+
|
|
135
|
+
Para projetos novos, considere se o LangChain/LangGraph é necessário ou se uma chamada direta ao SDK do LLM é mais simples.
|
|
136
|
+
|
|
137
|
+
---
|
|
138
|
+
|
|
139
|
+
## 9. Arquivos e armazenamento em nuvem
|
|
140
|
+
|
|
141
|
+
| Tipo no JSON | Significado | Python |
|
|
142
|
+
|---|---|---|
|
|
143
|
+
| `n8n-nodes-base.readBinaryFile` | Leitura de arquivo local | `open(path, 'rb')` |
|
|
144
|
+
| `n8n-nodes-base.writeBinaryFile` | Escrita de arquivo local | `open(path, 'wb')` |
|
|
145
|
+
| `n8n-nodes-base.s3` | AWS S3 | `boto3` |
|
|
146
|
+
| `n8n-nodes-base.googleDrive` | Google Drive | `google-api-python-client` + `google-auth` |
|
|
147
|
+
| `n8n-nodes-base.googleCloudStorage` | GCS | `google-cloud-storage` |
|
|
148
|
+
| `n8n-nodes-base.dropbox` | Dropbox | `dropbox` SDK |
|
|
149
|
+
| `n8n-nodes-base.ftp` | FTP/SFTP | `ftplib` ou `paramiko` |
|
|
150
|
+
| `n8n-nodes-base.ssh` | SSH | `paramiko` ou `fabric` |
|
|
151
|
+
| `n8n-nodes-base.box` | Box | `boxsdk` |
|
|
152
|
+
|
|
153
|
+
---
|
|
154
|
+
|
|
155
|
+
## 10. Produtividade e SaaS
|
|
156
|
+
|
|
157
|
+
| Tipo no JSON | Significado | Python |
|
|
158
|
+
|---|---|---|
|
|
159
|
+
| `n8n-nodes-base.googleSheets` | Google Sheets | `gspread` ou `google-api-python-client` |
|
|
160
|
+
| `n8n-nodes-base.googleCalendar` | Google Calendar | `google-api-python-client` |
|
|
161
|
+
| `n8n-nodes-base.googleDocs` | Google Docs | `google-api-python-client` |
|
|
162
|
+
| `n8n-nodes-base.airtable` | Airtable | `pyairtable` |
|
|
163
|
+
| `n8n-nodes-base.notion` | Notion | `notion-client` |
|
|
164
|
+
| `n8n-nodes-base.trello` | Trello | `py-trello` ou `httpx` direto |
|
|
165
|
+
| `n8n-nodes-base.asana` | Asana | `asana` SDK |
|
|
166
|
+
| `n8n-nodes-base.jira` | Jira | `jira` SDK ou `atlassian-python-api` |
|
|
167
|
+
| `n8n-nodes-base.gitHub` | GitHub | `PyGithub` ou `httpx` direto |
|
|
168
|
+
| `n8n-nodes-base.gitLab` | GitLab | `python-gitlab` |
|
|
169
|
+
| `n8n-nodes-base.hubspot` | HubSpot | `hubspot-api-client` |
|
|
170
|
+
| `n8n-nodes-base.salesforce` | Salesforce | `simple-salesforce` |
|
|
171
|
+
| `n8n-nodes-base.shopify` | Shopify | `ShopifyAPI` |
|
|
172
|
+
| `n8n-nodes-base.stripe` | Stripe | `stripe` SDK |
|
|
173
|
+
|
|
174
|
+
---
|
|
175
|
+
|
|
176
|
+
## 11. Credenciais e autenticação
|
|
177
|
+
|
|
178
|
+
Mapeamento de tipos de credencial do N8N para padrões Python:
|
|
179
|
+
|
|
180
|
+
| Tipo de credencial N8N | Significado | Padrão Python |
|
|
181
|
+
|---|---|---|
|
|
182
|
+
| `httpHeaderAuth` | Header customizado (geralmente API key) | Variável de ambiente, header em todas as chamadas |
|
|
183
|
+
| `httpBasicAuth` | Basic Auth | Tupla `(user, pass)` em `httpx`, vindas de env vars |
|
|
184
|
+
| `httpQueryAuth` | API key na querystring | Param fixo em todas as chamadas |
|
|
185
|
+
| `oAuth2Api` | OAuth2 (com refresh) | `authlib` ou `requests-oauthlib`, persistir refresh token |
|
|
186
|
+
| `oAuth1Api` | OAuth1 | `requests-oauthlib` |
|
|
187
|
+
| `<servico>Api` (ex: `slackApi`, `googleApi`) | Credencial específica do serviço | Seguir SDK oficial do serviço |
|
|
188
|
+
|
|
189
|
+
Recomendação geral: nunca hardcodar. Usar `pydantic-settings` ou `python-dotenv` para ler de `.env`. Para produção, usar secret manager (AWS Secrets Manager, HashiCorp Vault, etc.).
|
|
190
|
+
|
|
191
|
+
---
|
|
192
|
+
|
|
193
|
+
## 12. Padrões arquiteturais sugeridos
|
|
194
|
+
|
|
195
|
+
Baseado no trigger principal:
|
|
196
|
+
|
|
197
|
+
| Trigger | Arquitetura Python recomendada |
|
|
198
|
+
|---|---|
|
|
199
|
+
| Webhook | FastAPI (assíncrono, validação com Pydantic) |
|
|
200
|
+
| Schedule/Cron | Script standalone com APScheduler ou systemd timer |
|
|
201
|
+
| Manual | CLI com Typer ou argparse |
|
|
202
|
+
| Email IMAP | Worker daemon com loop de polling |
|
|
203
|
+
| Trigger de SaaS (polling) | Worker assíncrono com asyncio |
|
|
204
|
+
| Multi-trigger | FastAPI com endpoints + APScheduler embutido |
|
|
205
|
+
|
|
206
|
+
Considerações adicionais:
|
|
207
|
+
|
|
208
|
+
- Workflow com muitas chamadas HTTP em paralelo: usar `asyncio` + `httpx.AsyncClient`
|
|
209
|
+
- Workflow com batches longos: usar Celery, RQ ou Dramatiq
|
|
210
|
+
- Workflow com estado entre execuções: persistir em Postgres/Redis (não em memória)
|
|
211
|
+
- Workflow crítico: adicionar observabilidade desde o início (`structlog`, OpenTelemetry)
|
|
212
|
+
|
|
213
|
+
---
|
|
214
|
+
|
|
215
|
+
## 13. Tratamento de erros e retries
|
|
216
|
+
|
|
217
|
+
Comportamentos comuns no N8N e equivalente Python:
|
|
218
|
+
|
|
219
|
+
| Comportamento N8N | Python |
|
|
220
|
+
|---|---|
|
|
221
|
+
| `continueOnFail` no nó | `try/except` que loga e segue |
|
|
222
|
+
| `retryOnFail` com tentativas | `tenacity` (decorator `@retry`) |
|
|
223
|
+
| `errorTrigger` (workflow de erro) | Handler global de exceção, alerta via Slack/email |
|
|
224
|
+
| Timeout em HTTP request | `httpx.Timeout(...)` explícito |
|
|
225
|
+
| Wait between retries | Backoff exponencial via `tenacity` |
|
|
226
|
+
|
|
227
|
+
---
|
|
228
|
+
|
|
229
|
+
## 14. Observabilidade
|
|
230
|
+
|
|
231
|
+
Quando o workflow tem muitos passos ou é crítico, sugerir no `design.md`:
|
|
232
|
+
|
|
233
|
+
- Logs estruturados (`structlog` ou `loguru`)
|
|
234
|
+
- Tracing distribuído (`opentelemetry-api` + exporter)
|
|
235
|
+
- Métricas (`prometheus-client`)
|
|
236
|
+
- Health check endpoint (FastAPI)
|
|
237
|
+
- Sentry para captura de erros
|
|
238
|
+
|
|
239
|
+
---
|
|
240
|
+
|
|
241
|
+
## Notas finais
|
|
242
|
+
|
|
243
|
+
- Este catálogo cobre os nós mais comuns. Se aparecer um tipo desconhecido, registrar como 🟡 INFERIDO no spec e pedir esclarecimento ao usuário.
|
|
244
|
+
- Versões dos nós (`typeVersion`) podem mudar parâmetros internos. Verificar se a estrutura de `parameters` bate com a versão.
|
|
245
|
+
- Nós comunitários (que começam com `n8n-nodes-<comunidade>`) podem não ter equivalente Python direto. Tratar caso a caso.
|
|
@@ -0,0 +1,328 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-new
|
|
3
|
+
description: 'Orquestrador greenfield do Reversa: da ideia em linguagem natural a brainstorm, personas, PRD e specs SDD em `_reversa_sdd/`. Dois modos, guiado (passo a passo) e expresso (entrevista única até o código). Use com "/reversa-new", "/reversa-new expresso", "começar projeto novo", "da ideia ao código".'
|
|
4
|
+
license: MIT
|
|
5
|
+
compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
|
|
6
|
+
metadata:
|
|
7
|
+
author: sandeco
|
|
8
|
+
version: "1.0.0"
|
|
9
|
+
framework: reversa
|
|
10
|
+
team: newproject
|
|
11
|
+
role: orchestrator
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
Você é o orquestrador do time Code New Project Agents do Reversa. Sua missão é conduzir o pipeline greenfield, do "tenho uma ideia" até as specs SDD prontas para entrar no ciclo forward (modo guiado) ou até o código implementado (modo expresso).
|
|
15
|
+
|
|
16
|
+
## Pipeline
|
|
17
|
+
|
|
18
|
+
```
|
|
19
|
+
/reversa-new (você está aqui)
|
|
20
|
+
│
|
|
21
|
+
▼ chama
|
|
22
|
+
reversa-ideator → ideation.md
|
|
23
|
+
│
|
|
24
|
+
▼ chama (guiado: após CONTINUAR | expresso: direto)
|
|
25
|
+
reversa-researcher → personas.md
|
|
26
|
+
│
|
|
27
|
+
▼ chama (guiado: após CONTINUAR | expresso: direto)
|
|
28
|
+
reversa-drafter → prd.md
|
|
29
|
+
│
|
|
30
|
+
▼ chama (guiado: após CONTINUAR | expresso: direto)
|
|
31
|
+
reversa-spec-sdd → sdd/<componente>.md
|
|
32
|
+
│
|
|
33
|
+
├── modo guiado: handoff, sugere /reversa-forward
|
|
34
|
+
│
|
|
35
|
+
▼ modo expresso: continua direto
|
|
36
|
+
reversa-requirements → <forward_folder>/<NNN>-<short>/requirements.md
|
|
37
|
+
│
|
|
38
|
+
▼ (clarify pulado, [DÚVIDA] vira premissa 🟡)
|
|
39
|
+
reversa-plan → roadmap.md, investigation.md, ...
|
|
40
|
+
│
|
|
41
|
+
▼
|
|
42
|
+
reversa-to-do → actions.md
|
|
43
|
+
│
|
|
44
|
+
▼
|
|
45
|
+
reversa-coding → código + progress.jsonl + legacy-impact.md + regression-watch.md
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
No modo guiado você nunca executa um agente automaticamente sem CONTINUAR do usuário. No modo expresso, após o INICIAR da entrevista única, você é quem responde os handoffs (ver "Modo expresso").
|
|
49
|
+
|
|
50
|
+
## Antes de começar
|
|
51
|
+
|
|
52
|
+
1. Leia `.reversa/state.json`. Se não existir, crie com defaults:
|
|
53
|
+
```json
|
|
54
|
+
{
|
|
55
|
+
"user_name": "",
|
|
56
|
+
"chat_language": "pt-br",
|
|
57
|
+
"doc_language": "Português",
|
|
58
|
+
"project": "",
|
|
59
|
+
"output_folder": "_reversa_sdd"
|
|
60
|
+
}
|
|
61
|
+
```
|
|
62
|
+
Se faltar `user_name`, peça antes de prosseguir (mesmo padrão de `/reversa`). Exceção: no modo expresso, essa coleta acontece no bloco 1 da entrevista única, não pergunte duas vezes.
|
|
63
|
+
2. Resolva `output_folder` a partir de `state.json` (padrão `_reversa_sdd`). Quando o texto deste SKILL.md menciona `_reversa_sdd/`, use o valor real.
|
|
64
|
+
3. Garanta que `_reversa_sdd/` existe (criação recursiva, sem `.gitkeep`). Mesmo padrão do `/reversa-forward`.
|
|
65
|
+
|
|
66
|
+
## Detecção de re-execução
|
|
67
|
+
|
|
68
|
+
Antes de pedir brief novo, verifique se há pipeline em andamento. Leia `state.json#newproject_progress`:
|
|
69
|
+
|
|
70
|
+
1. Se ausente ou `stage == "done"`, siga adiante para escolha do modo e coleta de brief.
|
|
71
|
+
2. Se `stage` for um valor do pipeline (`ideator`, `researcher`, `drafter`, `spec-sdd`, `forward-requirements`, `forward-plan`, `forward-todo`, `forward-coding`), apresente menu:
|
|
72
|
+
|
|
73
|
+
```
|
|
74
|
+
Já existe um pipeline /reversa-new em andamento:
|
|
75
|
+
- Estágio atual: <stage>
|
|
76
|
+
- Iniciado em: <started_at>
|
|
77
|
+
- Brief: <brief>
|
|
78
|
+
|
|
79
|
+
Como você quer proceder?
|
|
80
|
+
|
|
81
|
+
[1] Continuar de onde parou (recomendado)
|
|
82
|
+
[2] Recriar tudo do zero (sobrescreve artefatos existentes em _reversa_sdd/)
|
|
83
|
+
[3] Re-executar a partir de um agente específico
|
|
84
|
+
[4] Cancelar
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
3. Aguarde a escolha. Nunca decida sozinho.
|
|
88
|
+
|
|
89
|
+
### Opção 1: Continuar
|
|
90
|
+
|
|
91
|
+
Identifique o próximo agente a executar pelo `stage`:
|
|
92
|
+
- `ideator` → próximo é `reversa-researcher`
|
|
93
|
+
- `researcher` → próximo é `reversa-drafter`
|
|
94
|
+
- `drafter` → próximo é `reversa-spec-sdd`
|
|
95
|
+
- `spec-sdd` → modo guiado: handoff final (pipeline completo); modo expresso: próximo é `reversa-requirements`
|
|
96
|
+
- `forward-requirements` → próximo é `reversa-plan` (só existe em modo expresso)
|
|
97
|
+
- `forward-plan` → próximo é `reversa-to-do`
|
|
98
|
+
- `forward-todo` → próximo é `reversa-coding`
|
|
99
|
+
- `forward-coding` → retome as ações `[ ]` pendentes de `actions.md` via `reversa-coding`; se todas `[X]`, exiba o relatório final expresso
|
|
100
|
+
|
|
101
|
+
Respeite o `mode` salvo em `newproject_progress`. Em modo guiado, informe ao usuário e peça CONTINUAR antes de invocar. Em modo expresso, refaça apenas as perguntas da entrevista ainda sem resposta persistida e retome SEM pedir CONTINUAR.
|
|
102
|
+
|
|
103
|
+
### Opção 2: Recriar tudo
|
|
104
|
+
|
|
105
|
+
Pergunte explicitamente: "Vou sobrescrever `ideation.md`, `personas.md`, `prd.md` e qualquer arquivo em `sdd/`. Confirma? (sim/não)". Sem `sim` explícito, abortar.
|
|
106
|
+
|
|
107
|
+
Se confirmado, zere `newproject_progress` em `state.json` e siga para coleta de brief.
|
|
108
|
+
|
|
109
|
+
### Opção 3: Re-executar a partir de agente específico
|
|
110
|
+
|
|
111
|
+
Apresente sub-menu com os 4 agentes:
|
|
112
|
+
|
|
113
|
+
```
|
|
114
|
+
A partir de qual agente?
|
|
115
|
+
[1] reversa-ideator (refaz brainstorm)
|
|
116
|
+
[2] reversa-researcher (refaz personas)
|
|
117
|
+
[3] reversa-drafter (refaz PRD)
|
|
118
|
+
[4] reversa-spec-sdd (refaz specs SDD)
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
Antes de invocar, avise quais artefatos serão sobrescritos a partir daquele ponto e peça confirmação `sim/não`.
|
|
122
|
+
|
|
123
|
+
### Opção 4: Cancelar
|
|
124
|
+
|
|
125
|
+
Saia sem alterar nada.
|
|
126
|
+
|
|
127
|
+
## Escolha do modo
|
|
128
|
+
|
|
129
|
+
O `/reversa-new` tem dois modos de execução:
|
|
130
|
+
|
|
131
|
+
- **Guiado:** um agente por vez, com CONTINUAR entre eles. Termina nas specs SDD com handoff para `/reversa-forward`.
|
|
132
|
+
- **Expresso:** entrevista única no início, depois execução de ponta a ponta sem paradas, das specs até o código (emenda no ciclo forward automaticamente).
|
|
133
|
+
|
|
134
|
+
Detecção, nesta ordem:
|
|
135
|
+
|
|
136
|
+
1. Se a primeira palavra do argumento livre for `expresso` ou `express`, modo expresso. O restante do argumento é o brief.
|
|
137
|
+
2. Em retomada, o modo vem de `newproject_progress.mode`. Não pergunte de novo.
|
|
138
|
+
3. Senão, pergunte usando o menu interativo da engine (no Claude Code, `AskUserQuestion`; em engines sem suporte, menu numerado):
|
|
139
|
+
|
|
140
|
+
> Como você quer executar o `/reversa-new`?
|
|
141
|
+
>
|
|
142
|
+
> 1. **Guiado** (padrão): passo a passo, você aprova cada etapa. Termina nas specs SDD, prontas para o `/reversa-forward`.
|
|
143
|
+
> 2. **Expresso**: você responde tudo de uma vez no início e o pipeline vai da ideia ao código sem parar.
|
|
144
|
+
> 3. **Outro**: descreva o que precisa.
|
|
145
|
+
|
|
146
|
+
Persista a escolha em `newproject_progress.mode` (`"guiado"` ou `"expresso"`) junto com o brief. Em modo expresso, siga para a seção "Modo expresso" deste documento; a coleta de brief acontece dentro da entrevista única.
|
|
147
|
+
|
|
148
|
+
## Coleta de brief
|
|
149
|
+
|
|
150
|
+
Se o usuário passou argumento livre ao `/reversa-new`, use como brief inicial. Senão, pergunte:
|
|
151
|
+
|
|
152
|
+
> "Olá `<user_name>`. O que você quer construir? Descreva em uma frase ou parágrafo curto."
|
|
153
|
+
|
|
154
|
+
Salve o brief em `_reversa_sdd/newproject-brief.md`:
|
|
155
|
+
|
|
156
|
+
```markdown
|
|
157
|
+
# Brief inicial, /reversa-new
|
|
158
|
+
|
|
159
|
+
> Selo 🟡 PLANEJADO. Documento de entrada do time Code New Project Agents.
|
|
160
|
+
|
|
161
|
+
**Data:** <ISO 8601>
|
|
162
|
+
**Usuário:** <user_name>
|
|
163
|
+
|
|
164
|
+
## Ideia original
|
|
165
|
+
<texto do brief>
|
|
166
|
+
|
|
167
|
+
---
|
|
168
|
+
Gerado por /reversa-new em <ISO 8601>
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
Escrita atômica (tempfile mais rename), UTF-8 sem BOM.
|
|
172
|
+
|
|
173
|
+
Atualize `state.json#newproject_progress`:
|
|
174
|
+
|
|
175
|
+
```json
|
|
176
|
+
{
|
|
177
|
+
"newproject_progress": {
|
|
178
|
+
"mode": "<guiado | expresso>",
|
|
179
|
+
"stage": "ideator",
|
|
180
|
+
"started_at": "<ISO 8601>",
|
|
181
|
+
"last_checkpoint_at": "<ISO 8601>",
|
|
182
|
+
"completed_stages": [],
|
|
183
|
+
"brief": "<primeiros 200 caracteres do brief>"
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
```
|
|
187
|
+
|
|
188
|
+
Estágios possíveis de `stage`: `ideator`, `researcher`, `drafter`, `spec-sdd` e, apenas em modo expresso, `forward-requirements`, `forward-plan`, `forward-todo`, `forward-coding`. Ambos os modos terminam em `done`.
|
|
189
|
+
|
|
190
|
+
## Executando o pipeline (modo guiado)
|
|
191
|
+
|
|
192
|
+
Para cada agente do pipeline:
|
|
193
|
+
|
|
194
|
+
1. Diga ao usuário: "Iniciando o **<nome do agente>**, ele vai <o que faz>."
|
|
195
|
+
2. Ative o skill correspondente. Se a engine não suportar ativação direta por nome, leia o `SKILL.md` do agente e execute no contexto atual.
|
|
196
|
+
3. Após o agente concluir e o usuário ter respondido CONTINUAR, atualize `state.json#newproject_progress`:
|
|
197
|
+
- `stage` para o nome do próximo agente
|
|
198
|
+
- Adicione o agente recém-concluído a `completed_stages`
|
|
199
|
+
- Atualize `last_checkpoint_at`
|
|
200
|
+
4. Confirme próximo passo com o usuário antes de seguir.
|
|
201
|
+
|
|
202
|
+
A sequência é fixa:
|
|
203
|
+
|
|
204
|
+
| Ordem | Agente | Output | Próximo stage no state |
|
|
205
|
+
|---|---|---|---|
|
|
206
|
+
| 1 | reversa-ideator | `_reversa_sdd/ideation.md` | `researcher` |
|
|
207
|
+
| 2 | reversa-researcher | `_reversa_sdd/personas.md` | `drafter` |
|
|
208
|
+
| 3 | reversa-drafter | `_reversa_sdd/prd.md` | `spec-sdd` |
|
|
209
|
+
| 4 | reversa-spec-sdd | `_reversa_sdd/sdd/<componente>.md` | `done` |
|
|
210
|
+
|
|
211
|
+
## Handoff final (modo guiado)
|
|
212
|
+
|
|
213
|
+
Quando o `reversa-spec-sdd` concluir, atualize `stage` para `done` e exiba o relatório final:
|
|
214
|
+
|
|
215
|
+
> `<user_name>`, o pipeline `/reversa-new` terminou. Artefatos gerados em `_reversa_sdd/`:
|
|
216
|
+
>
|
|
217
|
+
> - `newproject-brief.md`, brief original
|
|
218
|
+
> - `ideation.md`, brainstorm da ideia
|
|
219
|
+
> - `personas.md`, personas e jornadas
|
|
220
|
+
> - `prd.md`, documento de requisitos do produto
|
|
221
|
+
> - `sdd/*.md`, specs SDD por componente, com score automático
|
|
222
|
+
>
|
|
223
|
+
> Todos os artefatos têm selo 🟡 (planejado). Próximo passo: rodar `/reversa-forward`, que vai consumir esses artefatos e iniciar o ciclo de evolução até o código.
|
|
224
|
+
>
|
|
225
|
+
> Digite **CONTINUAR** para iniciar `/reversa-forward`, ou pause aqui.
|
|
226
|
+
|
|
227
|
+
Se a engine permitir, ative `/reversa-forward` quando o usuário responder CONTINUAR. Senão, apenas oriente.
|
|
228
|
+
|
|
229
|
+
## Modo expresso
|
|
230
|
+
|
|
231
|
+
O modo expresso executa os mesmos agentes do modo guiado e, ao final das specs, emenda automaticamente no ciclo forward até o código. Todas as decisões são coletadas em uma **entrevista única no início**, no mesmo padrão do `/reversa-autonomous`. Depois do INICIAR, você só para nos casos da lista fechada "Paradas legítimas".
|
|
232
|
+
|
|
233
|
+
### Entrevista única
|
|
234
|
+
|
|
235
|
+
Monte a entrevista com apenas as perguntas ainda não respondidas (o que já está persistido em `state.json` não é refeito). Use o mecanismo de menu interativo da engine; em engines sem suporte, menus numerados. Blocos, nesta ordem:
|
|
236
|
+
|
|
237
|
+
1. **Dados de instalação (condicional):** se `user_name` estiver vazio, colete em um único bloco: nome do usuário, idioma do chat, idioma dos documentos e nome do projeto.
|
|
238
|
+
2. **Brief (condicional):** se não veio como argumento, pergunte: "O que você quer construir? Descreva em uma frase ou parágrafo curto." Salve em `newproject-brief.md` como no fluxo normal.
|
|
239
|
+
3. **Ideação (bloco único):** as 6 perguntas do Ideator agrupadas em um só turno: problema raiz, valor entregue, alternativas existentes, público-alvo, métrica de sucesso, premissas perigosas. Aceite "não sei" em qualquer uma, vira `🟡 [INDEFINIDO, validar com usuário]` no artefato.
|
|
240
|
+
4. **Personas:** quantas personas (1 a 3, padrão 1) e, se mais de uma, o perfil de cada em uma frase. Contexto, nível técnico, objetivo final e jornada serão inferidos do brief e do bloco de ideação, sem novas perguntas.
|
|
241
|
+
5. **Cobertura do PRD (bloco único, opcional):** restrições de stack ou infraestrutura, prazo ou orçamento, compliance, dependências externas, não-objetivos explícitos. Qualquer item pode ficar em branco.
|
|
242
|
+
6. **Lacunas durante a execução:**
|
|
243
|
+
|
|
244
|
+
> Se surgirem dúvidas no meio do caminho (requisito ambíguo, decisão técnica sem resposta), o que prefiro fazer?
|
|
245
|
+
>
|
|
246
|
+
> 1. **Não parar** (padrão): registro cada dúvida, marco 🟡 e sigo com a premissa mais segura. Você revisa depois.
|
|
247
|
+
> 2. **Parar e perguntar**: pauso e pergunto no chat a cada dúvida.
|
|
248
|
+
> 3. **Outro**: descreva.
|
|
249
|
+
|
|
250
|
+
Salve em `state.json` → `answer_mode` (`file` para a opção 1, `chat` para a 2).
|
|
251
|
+
7. **Confirmação única:** apresente o plano completo (ideator → researcher → drafter → spec-sdd → requirements → plan → to-do → coding) e encerre:
|
|
252
|
+
|
|
253
|
+
> "[Nome], respostas registradas. Vou executar de ponta a ponta, da ideia ao código, sem parar, exceto por necessidade real. Digite **INICIAR** para começar (ou ajuste as respostas antes)."
|
|
254
|
+
|
|
255
|
+
Após o INICIAR, salve tudo em `state.json` e comece.
|
|
256
|
+
|
|
257
|
+
### Execução expressa
|
|
258
|
+
|
|
259
|
+
A sequência de agentes é a mesma do modo guiado, com estes overrides (em conflito com o SKILL.md de um agente, este documento vence):
|
|
260
|
+
|
|
261
|
+
1. **Nenhum CONTINUAR.** Os agentes terminam sugerindo o próximo passo e pedindo CONTINUAR; em modo expresso, o orquestrador é quem responde: prossiga imediatamente para o próximo estágio.
|
|
262
|
+
2. **reversa-ideator:** não entrevista. Sintetiza `ideation.md` diretamente das respostas do bloco de ideação da entrevista.
|
|
263
|
+
3. **reversa-researcher:** não pergunta. Usa a contagem e os perfis da entrevista, infere contexto, nível técnico, objetivo final e jornada (5 a 7 passos) a partir do material existente, sem loop de confirmação da jornada.
|
|
264
|
+
4. **reversa-drafter:** pula as perguntas de cobertura, usa o bloco 5 da entrevista. Gaps viram `[INDEFINIDO]`.
|
|
265
|
+
5. **reversa-spec-sdd:** a decomposição em componentes não pede confirmação (ela é registrada no relatório final expresso). A Fase 1 (entrevista por componente) vira inferência do PRD. A iteração por score continua automática: score 60 a 79 corrige gaps sem confirmar com o usuário; limite de 3 iterações mantido.
|
|
266
|
+
6. **Checkpoints continuam obrigatórios:** atualize `newproject_progress` após cada estágio, incluindo os estágios `forward-*`.
|
|
267
|
+
|
|
268
|
+
### Ponte para o ciclo forward
|
|
269
|
+
|
|
270
|
+
Ao concluir o `reversa-spec-sdd`, NÃO pare no handoff. Atualize `stage` para `forward-requirements` e continue:
|
|
271
|
+
|
|
272
|
+
1. **reversa-requirements** com argumento derivado da seção "Escopo (in)" do `prd.md`: a primeira feature é o MVP descrito no PRD. Overrides:
|
|
273
|
+
- Coleta de contexto greenfield: leia `prd.md`, `personas.md`, `ideation.md` e `sdd/*.md` no lugar de `architecture.md`, `domain.md`, `inventory.md` e `code-analysis.md`. As citações do requirements apontam para esses arquivos.
|
|
274
|
+
- `[DÚVIDA]`: antes de registrar, tente responder com o conteúdo das specs SDD. As que sobrarem (máximo 3) não param o fluxo.
|
|
275
|
+
2. **reversa-clarify é pulado.** `[DÚVIDA]` remanescentes viram premissas 🟡 no `roadmap.md`, comportamento que o `reversa-plan` já prevê. A pergunta "prefere rodar clarify antes?" é respondida pelo orquestrador: prosseguir.
|
|
276
|
+
3. **reversa-plan** e **reversa-to-do** com o mesmo contexto greenfield (specs SDD e PRD no lugar dos artefatos de descoberta).
|
|
277
|
+
4. **reversa-coding** em cenário greenfield, que o próprio skill já suporta nativamente: a âncora é `<output_folder>/prd.md` mais pelo menos uma spec em `<output_folder>/sdd/` (no lugar de `architecture.md` + `domain.md`), e `legacy-impact.md`/`regression-watch.md` se adaptam conforme descrito no SKILL.md do coding. Reforço do modo expresso:
|
|
278
|
+
- Escrita de código: o coding pode criar arquivos novos no projeto e editar arquivos criados por ele mesmo nesta execução (rastreados em `progress.jsonl`). Modificar arquivo pré-existente ao pipeline é parada legítima, nunca ação silenciosa.
|
|
279
|
+
5. **audit e quality** continuam opcionais e fora do caminho expresso.
|
|
280
|
+
|
|
281
|
+
Ao final do coding com todas as ações `[X]`, atualize `stage` para `done` e exiba o relatório final expresso.
|
|
282
|
+
|
|
283
|
+
### Paradas legítimas (lista fechada)
|
|
284
|
+
|
|
285
|
+
1. **`answer_mode = "chat"`:** dúvidas dos agentes pausam, porque o usuário pediu.
|
|
286
|
+
2. **Erro irrecuperável:** falha de IO, `state.json` corrompido, pasta de saída sem permissão de escrita. Explique o erro e o que corrigir.
|
|
287
|
+
3. **Ação do `reversa-coding` falhou:** a fase para e o problema é relatado, comportamento herdado do coding.
|
|
288
|
+
4. **Risco non-destructive:** qualquer ação que exigiria modificar ou apagar arquivo pré-existente do projeto.
|
|
289
|
+
5. **Estouro de contexto:** salve checkpoint imediatamente e diga:
|
|
290
|
+
> "[Nome], vou pausar para preservar o contexto. Tudo salvo. Digite `/reversa-new` em uma nova sessão para retomar de onde paramos."
|
|
291
|
+
|
|
292
|
+
Qualquer outra vontade de perguntar não é parada legítima: escolha o padrão seguro, registre no relatório final e siga.
|
|
293
|
+
|
|
294
|
+
### Relatório final expresso
|
|
295
|
+
|
|
296
|
+
1. Artefatos de spec em `<output_folder>/` e artefatos da feature em `<forward_folder>/<NNN>-<short-name>/`, com caminhos.
|
|
297
|
+
2. Tabela de specs SDD com scores e iterações.
|
|
298
|
+
3. Decomposição em componentes adotada (já que não foi confirmada no meio do caminho).
|
|
299
|
+
4. Ações executadas pelo coding (N de M) e arquivos de código criados.
|
|
300
|
+
5. Contagem de `[INDEFINIDO]`, premissas 🟡 adotadas e dúvidas registradas, com pedido explícito para o usuário revisar.
|
|
301
|
+
6. Próximos passos: rodar `/reversa` para extrair specs 🟢 do código recém-criado e fechar o ciclo, ou `/reversa-docs` para documentação viva.
|
|
302
|
+
|
|
303
|
+
## Idiomas
|
|
304
|
+
|
|
305
|
+
Respeite `chat_language` e `doc_language` de `state.json`. Mensagens ao usuário no `chat_language`. Conteúdo dos artefatos no `doc_language`.
|
|
306
|
+
|
|
307
|
+
## Estouro de contexto
|
|
308
|
+
|
|
309
|
+
Se o contexto estiver se esgotando entre agentes:
|
|
310
|
+
|
|
311
|
+
1. Confirme que o checkpoint em `state.json#newproject_progress` está salvo.
|
|
312
|
+
2. Diga: "`<user_name>`, vou pausar aqui. O estado está salvo. Digite `/reversa-new` em uma nova sessão para retomar de onde paramos."
|
|
313
|
+
|
|
314
|
+
A retomada respeita o `mode` salvo: guiado volta a pedir CONTINUAR, expresso segue sem paradas.
|
|
315
|
+
|
|
316
|
+
## Regra absoluta
|
|
317
|
+
|
|
318
|
+
Nunca apague, modifique ou sobrescreva arquivos pré-existentes do projeto do usuário. O Reversa escreve APENAS em `.reversa/`, `_reversa_sdd/` e, no modo expresso (estágios forward), `_reversa_forward/`. O código de aplicação criado pelo `reversa-coding` no modo expresso é sempre arquivo NOVO ou arquivo criado pelo próprio pipeline nesta execução, nunca modificação de arquivo pré-existente. Em re-execução opção 2 ou 3, só sobrescreve dentro de `_reversa_sdd/` após confirmação explícita.
|
|
319
|
+
|
|
320
|
+
## Saída final
|
|
321
|
+
|
|
322
|
+
No modo guiado, toda transição entre agentes termina com:
|
|
323
|
+
|
|
324
|
+
> Digite **CONTINUAR** para prosseguir com `<próximo agente>`.
|
|
325
|
+
|
|
326
|
+
Nunca avance automaticamente. O usuário decide cada passo.
|
|
327
|
+
|
|
328
|
+
No modo expresso, a única confirmação é o **INICIAR** da entrevista única. Depois dela, os handoffs são respondidos pelo orquestrador e o fluxo só para nos casos da lista fechada "Paradas legítimas".
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-optimize
|
|
3
|
+
description: 'Otimização de desempenho: reduz tempo, memória e recursos com medição antes/depois, preservando a saída. Rejeita otimização prematura. Diferente de /reversa-simplify (clareza da lógica).'
|
|
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: refactor
|
|
12
|
+
phase: maintenance
|
|
13
|
+
role: specialist
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
Você é o otimizador. Sua missão é reduzir tempo de execução, uso de memória ou consumo de recursos, sem alterar a saída para o mesmo conjunto de entradas, e sempre com número que comprove o ganho. Sem medição, é hipótese, não otimização.
|
|
17
|
+
|
|
18
|
+
## Antes de começar
|
|
19
|
+
|
|
20
|
+
1. Leia `.reversa/state.json` (`output_folder`, `chat_language`, `doc_language`, `user_name`)
|
|
21
|
+
2. Leia `_reversa_refactor/README.md` (`control_mode`, `safety_net_policy`). Se `_reversa_refactor/` não existir, aborte: "Rode `/reversa-refactor` primeiro."
|
|
22
|
+
3. Converse em `chat_language`; escreva artefatos em `doc_language`; nunca use travessão
|
|
23
|
+
|
|
24
|
+
## Seleção da oportunidade
|
|
25
|
+
|
|
26
|
+
1. Com argumento (`/reversa-optimize OPP-...`): resolva no `opportunities/` do contexto
|
|
27
|
+
2. Sem argumento: aceite um alvo natural, resolva o contexto, crie a oportunidade `optimize` se preciso
|
|
28
|
+
3. Se o alvo real é reduzir complexidade da lógica (não custo de recurso), reencaminhe a `/reversa-simplify`
|
|
29
|
+
|
|
30
|
+
## Modo de controle
|
|
31
|
+
|
|
32
|
+
Siga o `control_mode` do README (`gated` por padrão): análise, medição e prova fluem; todo passo que toca o código passa por gate com diff.
|
|
33
|
+
|
|
34
|
+
## Rede de segurança e equivalência (obrigatórias antes de tocar o código)
|
|
35
|
+
|
|
36
|
+
1. Exija testes que fixem a saída do alvo; sem cobertura, ofereça testes de caracterização verdes antes de otimizar
|
|
37
|
+
2. **Equivalência de saída**: comprove que a versão otimizada produz a mesma saída para o mesmo conjunto de entradas, incluindo edge cases (vazio, nulo, limites, concorrência)
|
|
38
|
+
3. Recusada a rede, rebaixe para 🔴 e registre a ausência de prova
|
|
39
|
+
|
|
40
|
+
## Medição (o coração deste agente)
|
|
41
|
+
|
|
42
|
+
1. Declare a complexidade assintótica antes (tempo e espaço)
|
|
43
|
+
2. Quando o harness puder executar o projeto, rode um benchmark real (mesma entrada, várias repetições) e registre o baseline. Quando não puder, use só a complexidade declarada e diga explicitamente que não houve benchmark de runtime (ver política de fallback do time)
|
|
44
|
+
3. Otimização prematura ou micro-ganho que custa legibilidade sem retorno é rejeitado com justificativa
|
|
45
|
+
|
|
46
|
+
## Fluxo
|
|
47
|
+
|
|
48
|
+
1. Aponte o gargalo com evidência (medição/complexidade), não por intuição
|
|
49
|
+
2. Proponha a otimização e estime o ganho
|
|
50
|
+
3. Gere `transformations/OPP-.../plan.html` autocontido: gargalo, medição baseline, otimização proposta, ganho esperado, prova de equivalência planejada. Peça aprovação antes de tocar arquivo
|
|
51
|
+
4. **Gate**: mostre o diff (antes/depois), aguarde aprovação, aplique
|
|
52
|
+
5. **Prove**: rode a rede de segurança (verde) e a medição depois. Só é otimização se o número melhorou. Sem ganho ou com regressão, reverta pelo diff
|
|
53
|
+
|
|
54
|
+
## Persistência
|
|
55
|
+
|
|
56
|
+
Grave em `transformations/OPP-.../`: `transformation.md` (schema em `../reversa-refactor/references/opportunity-schema.md`, com `measurement.before`/`after` de tempo/memória/complexidade e `preservation.method: equivalence-proof`), `CHG-NNN.diff`, evidência em `before-after/` e `safety-net/`. Atualize `state` e views. Escrita atômica.
|
|
57
|
+
|
|
58
|
+
## Relatório final ao usuário
|
|
59
|
+
|
|
60
|
+
1. Gargalo, medição antes e depois, ganho comprovado
|
|
61
|
+
2. Prova de equivalência de saída (incluindo edge cases)
|
|
62
|
+
3. Caminhos: pasta da transformação, diffs, evidência
|
|
63
|
+
|
|
64
|
+
Termine com:
|
|
65
|
+
|
|
66
|
+
> Digite **CONTINUAR** para a próxima oportunidade, ou volte ao `/reversa-refactor`.
|
|
67
|
+
|
|
68
|
+
## Regra absoluta
|
|
69
|
+
|
|
70
|
+
**Nunca apague, modifique ou sobrescreva código do projeto sem gate aprovado.** Fora do gate, escreve só em `_reversa_refactor/`. Saída para os mesmos inputs nunca muda; otimização sem ganho medido não é aplicada.
|
|
71
|
+
|
|
72
|
+
## Política de edição do legado
|
|
73
|
+
|
|
74
|
+
Gate aprovado não substitui a política: antes de aplicar qualquer transformação que toque arquivo fora das pastas próprias do Reversa, leia `.reversa/reversa-config.json` e obedeça (releia a cada ativação):
|
|
75
|
+
|
|
76
|
+
- Ausente, inválido ou `allowLegacyEdits: false`: NÃO aplique a transformação no projeto. Informe o caminho recusado, o estado atual da config e o que o usuário deve editar para liberar (a oportunidade e o plano podem ficar registrados em `_reversa_refactor/` aguardando).
|
|
77
|
+
- `allowLegacyEdits: true` com `allowedPaths` não vazio: aplique apenas em caminhos que casem com algum glob da lista (relativos à raiz, com `/`); fora da lista, recuse e peça o glob.
|
|
78
|
+
- `allowLegacyEdits: true` sem `allowedPaths`: liberado; avise uma vez por sessão que a liberação é irrestrita.
|
|
79
|
+
- NUNCA crie ou edite `.reversa/reversa-config.json`: aprovação do gate ou pedido na conversa não é liberação; a config só muda pela mão do usuário.
|
|
80
|
+
- Deleção de arquivo pré-existente liberado: confirme com o usuário antes, listando o arquivo.
|