@flaviogarrido/reversa 0.0.0-stage → 1.3.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +487 -2
- package/agents/fg-backlog/SKILL.md +129 -0
- package/agents/fg-backlog/agents/openai.yaml +5 -0
- package/agents/fg-backlog/references/backlog-template.md +60 -0
- package/agents/fg-backlog/references/priorizacao.md +41 -0
- package/agents/impeccable/LICENSE +191 -0
- package/agents/impeccable/NOTICE.md +11 -0
- package/agents/impeccable/SKILL.md +88 -0
- package/agents/impeccable/agents/impeccable_asset_producer.toml +47 -0
- package/agents/impeccable/agents/impeccable_documenter.toml +27 -0
- package/agents/impeccable/agents/impeccable_finish_reviewer.toml +41 -0
- package/agents/impeccable/agents/impeccable_manual_edit_applier.toml +95 -0
- package/agents/impeccable/agents/openai.yaml +4 -0
- package/agents/impeccable/reference/adapt.md +318 -0
- package/agents/impeccable/reference/adapt.native.md +58 -0
- package/agents/impeccable/reference/android.md +46 -0
- package/agents/impeccable/reference/animate.md +89 -0
- package/agents/impeccable/reference/audit.md +139 -0
- package/agents/impeccable/reference/audit.native.md +139 -0
- package/agents/impeccable/reference/bolder.md +33 -0
- package/agents/impeccable/reference/clarify.md +94 -0
- package/agents/impeccable/reference/colorize.md +86 -0
- package/agents/impeccable/reference/component-review.md +63 -0
- package/agents/impeccable/reference/craft-floor.md +44 -0
- package/agents/impeccable/reference/craft.md +5 -0
- package/agents/impeccable/reference/critique.md +819 -0
- package/agents/impeccable/reference/degraded/asset-producer.md +42 -0
- package/agents/impeccable/reference/degraded/documenter.md +24 -0
- package/agents/impeccable/reference/degraded/finish-reviewer.md +38 -0
- package/agents/impeccable/reference/degraded/manual-edit-applier.md +92 -0
- package/agents/impeccable/reference/delight.md +70 -0
- package/agents/impeccable/reference/distill.md +111 -0
- package/agents/impeccable/reference/doctor.md +54 -0
- package/agents/impeccable/reference/document.md +416 -0
- package/agents/impeccable/reference/extract.md +69 -0
- package/agents/impeccable/reference/generate.md +101 -0
- package/agents/impeccable/reference/harden.md +343 -0
- package/agents/impeccable/reference/hooks.md +113 -0
- package/agents/impeccable/reference/init.md +131 -0
- package/agents/impeccable/reference/ios.md +51 -0
- package/agents/impeccable/reference/layout.md +84 -0
- package/agents/impeccable/reference/live-setup.md +104 -0
- package/agents/impeccable/reference/live.md +325 -0
- package/agents/impeccable/reference/mode-operate.md +21 -0
- package/agents/impeccable/reference/mode-persuade.md +19 -0
- package/agents/impeccable/reference/mode-read.md +21 -0
- package/agents/impeccable/reference/new-work.md +154 -0
- package/agents/impeccable/reference/onboard.md +234 -0
- package/agents/impeccable/reference/operate.md +61 -0
- package/agents/impeccable/reference/optimize.md +258 -0
- package/agents/impeccable/reference/overdrive.md +127 -0
- package/agents/impeccable/reference/polish.md +105 -0
- package/agents/impeccable/reference/quieter.md +99 -0
- package/agents/impeccable/reference/region-map.md +26 -0
- package/agents/impeccable/reference/routing.md +24 -0
- package/agents/impeccable/reference/shape.md +59 -0
- package/agents/impeccable/reference/typeset.md +90 -0
- package/agents/impeccable/reference/visualize.md +47 -0
- package/agents/impeccable/reversa-bundle.json +16 -0
- package/agents/impeccable/scripts/VERSION +1 -0
- package/agents/impeccable/scripts/command-metadata.json +98 -0
- package/agents/impeccable/scripts/data/font-index-failures.json +121 -0
- package/agents/impeccable/scripts/data/font-index.json +1 -0
- package/agents/impeccable/scripts/impeccable +212 -0
- package/agents/impeccable/scripts/impeccable.cmd +239 -0
- package/agents/impeccable/scripts/live-browser-dom.js +320 -0
- package/agents/impeccable/scripts/live-browser-ignores.js +242 -0
- package/agents/impeccable/scripts/live-browser-session.js +180 -0
- package/agents/impeccable/scripts/live-browser.js +13557 -0
- package/agents/impeccable/scripts/modern-screenshot.umd.js +14 -0
- package/agents/reversa/SKILL.md +135 -0
- package/agents/reversa/agents/openai.yaml +3 -0
- package/agents/reversa/references/checkpoint-guide.md +106 -0
- package/agents/reversa/references/state-schema.md +80 -0
- package/agents/reversa/references/step-01-first-run.md +63 -0
- package/agents/reversa/references/step-02-resume.md +88 -0
- package/agents/reversa/references/step-03-specs-organization.md +145 -0
- package/agents/reversa/references/step-04-regression-check.md +94 -0
- package/agents/reversa-add/SKILL.md +131 -0
- package/agents/reversa-add/agents/openai.yaml +5 -0
- package/agents/reversa-agents-help/SKILL.md +211 -0
- package/agents/reversa-agents-help/agents/openai.yaml +3 -0
- package/agents/reversa-arbiter/SKILL.md +140 -0
- package/agents/reversa-arbiter/agents/openai.yaml +5 -0
- package/agents/reversa-archaeologist/SKILL.md +95 -0
- package/agents/reversa-archaeologist/agents/openai.yaml +5 -0
- package/agents/reversa-archaeologist/references/modules-schema.md +69 -0
- package/agents/reversa-architect/SKILL.md +93 -0
- package/agents/reversa-architect/agents/openai.yaml +5 -0
- package/agents/reversa-arquitetura-3d/SKILL.md +163 -0
- package/agents/reversa-arquitetura-3d/agents/openai.yaml +5 -0
- package/agents/reversa-arquitetura-3d/references/ARCH_TOUR.md +242 -0
- package/agents/reversa-arquitetura-3d/references/CALL_GRAPH_3D.md +217 -0
- package/agents/reversa-arquitetura-3d/references/CODE_CITY.md +228 -0
- package/agents/reversa-arquitetura-3d/references/DEPENDENCY_GRAPH_3D.md +240 -0
- package/agents/reversa-arquitetura-3d/references/ERRORS.md +286 -0
- package/agents/reversa-arquitetura-3d/references/LAYER_STACK.md +230 -0
- package/agents/reversa-arquitetura-3d/references/THREE_PATTERNS.md +221 -0
- package/agents/reversa-audit/SKILL.md +98 -0
- package/agents/reversa-audit/agents/openai.yaml +5 -0
- package/agents/reversa-autonomous/SKILL.md +139 -0
- package/agents/reversa-autonomous/agents/openai.yaml +3 -0
- package/agents/reversa-brainstorm/SKILL.md +131 -0
- package/agents/reversa-brainstorm/agents/openai.yaml +3 -0
- package/agents/reversa-challenger/SKILL.md +122 -0
- package/agents/reversa-challenger/agents/openai.yaml +5 -0
- package/agents/reversa-clarify/SKILL.md +103 -0
- package/agents/reversa-clarify/agents/openai.yaml +5 -0
- package/agents/reversa-code-express/SKILL.md +252 -0
- package/agents/reversa-code-express/agents/openai.yaml +5 -0
- package/agents/reversa-coding/SKILL.md +172 -0
- package/agents/reversa-coding/agents/openai.yaml +5 -0
- package/agents/reversa-curator/SKILL.md +133 -0
- package/agents/reversa-curator/agents/openai.yaml +5 -0
- package/agents/reversa-curator/references/decision-rubric.md +52 -0
- package/agents/reversa-curator/references/templates/discard_log.md +37 -0
- package/agents/reversa-curator/references/templates/target_business_rules.md +54 -0
- package/agents/reversa-data-master/SKILL.md +67 -0
- package/agents/reversa-data-master/agents/openai.yaml +5 -0
- package/agents/reversa-debugger/SKILL.md +178 -0
- package/agents/reversa-debugger/agents/openai.yaml +3 -0
- package/agents/reversa-debugger/references/bug-schema.md +123 -0
- package/agents/reversa-debugger/references/bugs-readme-template.md +76 -0
- package/agents/reversa-debugger-debate/SKILL.md +75 -0
- package/agents/reversa-debugger-debate/agents/openai.yaml +5 -0
- package/agents/reversa-debugger-debate/references/debate-protocol.md +102 -0
- package/agents/reversa-debugger-fix/SKILL.md +170 -0
- package/agents/reversa-debugger-fix/agents/openai.yaml +5 -0
- package/agents/reversa-debugger-graph/SKILL.md +94 -0
- package/agents/reversa-debugger-graph/agents/openai.yaml +5 -0
- package/agents/reversa-decouple/SKILL.md +78 -0
- package/agents/reversa-decouple/agents/openai.yaml +5 -0
- package/agents/reversa-depth-inspection/SKILL.md +99 -0
- package/agents/reversa-depth-inspection/agents/openai.yaml +5 -0
- package/agents/reversa-design-system/SKILL.md +77 -0
- package/agents/reversa-design-system/agents/openai.yaml +5 -0
- package/agents/reversa-designer/SKILL.md +217 -0
- package/agents/reversa-designer/agents/openai.yaml +5 -0
- package/agents/reversa-designer/references/paradigm-checklist.md +50 -0
- package/agents/reversa-designer/references/templates/data_migration_plan.md +80 -0
- package/agents/reversa-designer/references/templates/target_architecture.md +68 -0
- package/agents/reversa-designer/references/templates/target_data_model.md +64 -0
- package/agents/reversa-designer/references/templates/target_domain_model.md +62 -0
- package/agents/reversa-designer/references/templates/topology_decision.md +82 -0
- package/agents/reversa-detective/SKILL.md +82 -0
- package/agents/reversa-detective/agents/openai.yaml +5 -0
- package/agents/reversa-docs/SKILL.md +241 -0
- package/agents/reversa-docs/agents/openai.yaml +3 -0
- package/agents/reversa-docs/references/config-schema.json +108 -0
- package/agents/reversa-docs/references/expected_sources.yaml +60 -0
- package/agents/reversa-docs-analyst/SKILL.md +163 -0
- package/agents/reversa-docs-analyst/agents/openai.yaml +5 -0
- package/agents/reversa-docs-mapper/SKILL.md +167 -0
- package/agents/reversa-docs-mapper/agents/openai.yaml +5 -0
- package/agents/reversa-docs-mapper/references/extraction-policy.md +44 -0
- package/agents/reversa-docs-publisher/SKILL.md +323 -0
- package/agents/reversa-docs-publisher/agents/openai.yaml +5 -0
- package/agents/reversa-docs-publisher/references/auxiliary_sources.yaml +27 -0
- package/agents/reversa-docs-publisher/references/vendor-pins.yaml +149 -0
- package/agents/reversa-docs-storyteller/SKILL.md +189 -0
- package/agents/reversa-docs-storyteller/agents/openai.yaml +5 -0
- package/agents/reversa-drafter/SKILL.md +189 -0
- package/agents/reversa-drafter/agents/openai.yaml +5 -0
- package/agents/reversa-especialista-d3/SKILL.md +37 -0
- package/agents/reversa-especialista-d3/agents/openai.yaml +5 -0
- package/agents/reversa-especialista-d3/references/api-core.md +13 -0
- package/agents/reversa-especialista-d3/references/interatividade.md +5 -0
- package/agents/reversa-especialista-d3/references/layouts-complexos.md +8 -0
- package/agents/reversa-explorer/SKILL.md +110 -0
- package/agents/reversa-explorer/agents/openai.yaml +5 -0
- package/agents/reversa-extract-soul/SKILL.md +221 -0
- package/agents/reversa-extract-soul/agents/openai.yaml +5 -0
- package/agents/reversa-forward/SKILL.md +235 -0
- package/agents/reversa-forward/agents/openai.yaml +3 -0
- package/agents/reversa-forward-autonomous/SKILL.md +184 -0
- package/agents/reversa-forward-autonomous/agents/openai.yaml +3 -0
- package/agents/reversa-framer/SKILL.md +124 -0
- package/agents/reversa-framer/agents/openai.yaml +5 -0
- package/agents/reversa-highcharts-visualizer/SKILL.md +123 -0
- package/agents/reversa-highcharts-visualizer/agents/openai.yaml +5 -0
- package/agents/reversa-highcharts-visualizer/references/CHART_CATALOG.md +450 -0
- package/agents/reversa-highcharts-visualizer/references/ERRORS.md +99 -0
- package/agents/reversa-highcharts-visualizer/references/HIGHCHARTS_PATTERNS.md +347 -0
- package/agents/reversa-highcharts-visualizer/scripts/analyze_data.py +219 -0
- package/agents/reversa-highcharts-visualizer/scripts/parse_data.py +246 -0
- package/agents/reversa-highcharts-visualizer/scripts/sample_data.py +208 -0
- package/agents/reversa-ideator/SKILL.md +139 -0
- package/agents/reversa-ideator/agents/openai.yaml +5 -0
- package/agents/reversa-image-prompt-json/SKILL.md +210 -0
- package/agents/reversa-image-prompt-json/agents/openai.yaml +5 -0
- package/agents/reversa-image-prompt-json/references/Examples.md +123 -0
- package/agents/reversa-inspector/SKILL.md +147 -0
- package/agents/reversa-inspector/agents/openai.yaml +5 -0
- package/agents/reversa-inspector/references/parity-coverage-matrix.md +54 -0
- package/agents/reversa-inspector/references/templates/parity_specs.md +64 -0
- package/agents/reversa-inspector/references/templates/parity_test.feature +40 -0
- package/agents/reversa-migrate/SKILL.md +282 -0
- package/agents/reversa-migrate/agents/openai.yaml +3 -0
- package/agents/reversa-migrate/references/auto-defaults.md +52 -0
- package/agents/reversa-migrate/references/expected_legacy_artifacts.yaml +69 -0
- package/agents/reversa-migrate/references/handoff-checklist.md +34 -0
- package/agents/reversa-migrate/references/state.json +28 -0
- package/agents/reversa-migrate/references/templates/ambiguity_log.md +43 -0
- package/agents/reversa-migrate/references/templates/handoff.md +91 -0
- package/agents/reversa-migrate/references/templates/migration_brief.md +52 -0
- package/agents/reversa-migrate/references/templates/pending_decisions.md +36 -0
- package/agents/reversa-modularize/SKILL.md +77 -0
- package/agents/reversa-modularize/agents/openai.yaml +5 -0
- package/agents/reversa-n8n/SKILL.md +256 -0
- package/agents/reversa-n8n/agents/openai.yaml +5 -0
- package/agents/reversa-n8n/references/node-catalog.md +245 -0
- package/agents/reversa-new/SKILL.md +328 -0
- package/agents/reversa-new/agents/openai.yaml +3 -0
- package/agents/reversa-optimize/SKILL.md +80 -0
- package/agents/reversa-optimize/agents/openai.yaml +5 -0
- package/agents/reversa-paradigm-advisor/SKILL.md +168 -0
- package/agents/reversa-paradigm-advisor/agents/openai.yaml +5 -0
- package/agents/reversa-paradigm-advisor/references/paradigm-catalog.md +73 -0
- package/agents/reversa-paradigm-advisor/references/templates/paradigm_decision.md +69 -0
- package/agents/reversa-plan/SKILL.md +92 -0
- package/agents/reversa-plan/agents/openai.yaml +5 -0
- package/agents/reversa-pre-spec/SKILL.md +133 -0
- package/agents/reversa-pre-spec/agents/openai.yaml +5 -0
- package/agents/reversa-pricing/SKILL.md +181 -0
- package/agents/reversa-pricing/agents/openai.yaml +3 -0
- package/agents/reversa-pricing-advisor/SKILL.md +322 -0
- package/agents/reversa-pricing-advisor/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-advisor/references/advisor-schema.json +196 -0
- package/agents/reversa-pricing-advisor/references/advisor-template.md +106 -0
- package/agents/reversa-pricing-advisor/references/sale-models.md +237 -0
- package/agents/reversa-pricing-estimate/SKILL.md +287 -0
- package/agents/reversa-pricing-estimate/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-estimate/references/effort-formula.md +146 -0
- package/agents/reversa-pricing-estimate/references/estimate-schema.json +141 -0
- package/agents/reversa-pricing-estimate/references/estimate-template.md +153 -0
- package/agents/reversa-pricing-estimate/references/example-estimate.json +74 -0
- package/agents/reversa-pricing-estimate/references/example-estimate.md +88 -0
- package/agents/reversa-pricing-estimate/references/market-benchmarks.md +102 -0
- package/agents/reversa-pricing-estimate/references/value-formula.md +123 -0
- package/agents/reversa-pricing-product/SKILL.md +299 -0
- package/agents/reversa-pricing-product/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-product/references/breakeven-formula.md +237 -0
- package/agents/reversa-pricing-product/references/product-schema.json +288 -0
- package/agents/reversa-pricing-product/references/product-template.md +113 -0
- package/agents/reversa-pricing-product/references/store-commissions.md +57 -0
- package/agents/reversa-pricing-profile/SKILL.md +390 -0
- package/agents/reversa-pricing-profile/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-profile/references/example-profile.json +23 -0
- package/agents/reversa-pricing-profile/references/example-profile.md +46 -0
- package/agents/reversa-pricing-profile/references/profile-schema.json +227 -0
- package/agents/reversa-pricing-profile/references/tax-regimes.md +106 -0
- package/agents/reversa-pricing-research/SKILL.md +352 -0
- package/agents/reversa-pricing-research/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-research/references/research-policy.md +213 -0
- package/agents/reversa-pricing-research/references/research-schema.json +330 -0
- package/agents/reversa-pricing-size/SKILL.md +205 -0
- package/agents/reversa-pricing-size/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-size/references/example-size.json +41 -0
- package/agents/reversa-pricing-size/references/size-schema.json +120 -0
- package/agents/reversa-pricing-size/references/sizing-formula.md +183 -0
- package/agents/reversa-principles/SKILL.md +82 -0
- package/agents/reversa-principles/agents/openai.yaml +5 -0
- package/agents/reversa-prune/SKILL.md +85 -0
- package/agents/reversa-prune/agents/openai.yaml +5 -0
- package/agents/reversa-quality/SKILL.md +87 -0
- package/agents/reversa-quality/agents/openai.yaml +5 -0
- package/agents/reversa-reconstructor/SKILL.md +243 -0
- package/agents/reversa-reconstructor/agents/openai.yaml +5 -0
- package/agents/reversa-reconstructor/references/reconstruction-plan-migration-template.md +89 -0
- package/agents/reversa-reconstructor/references/reconstruction-plan-template.md +77 -0
- package/agents/reversa-refactor/SKILL.md +112 -0
- package/agents/reversa-refactor/agents/openai.yaml +3 -0
- package/agents/reversa-refactor/references/opportunity-schema.md +68 -0
- package/agents/reversa-refactor/references/refactor-readme-template.md +35 -0
- package/agents/reversa-requirements/SKILL.md +217 -0
- package/agents/reversa-requirements/agents/openai.yaml +5 -0
- package/agents/reversa-researcher/SKILL.md +136 -0
- package/agents/reversa-researcher/agents/openai.yaml +5 -0
- package/agents/reversa-restructure/SKILL.md +78 -0
- package/agents/reversa-restructure/agents/openai.yaml +5 -0
- package/agents/reversa-resume/SKILL.md +141 -0
- package/agents/reversa-resume/agents/openai.yaml +5 -0
- package/agents/reversa-reviewer/SKILL.md +163 -0
- package/agents/reversa-reviewer/agents/openai.yaml +5 -0
- package/agents/reversa-reviewer/references/confidence-report-template.md +73 -0
- package/agents/reversa-reviewer/references/confidence-rules.md +65 -0
- package/agents/reversa-reviewer/references/questions-template.md +74 -0
- package/agents/reversa-scout/SKILL.md +82 -0
- package/agents/reversa-scout/agents/openai.yaml +5 -0
- package/agents/reversa-scout/references/surface-schema.md +93 -0
- package/agents/reversa-screen-translator/SKILL.md +279 -0
- package/agents/reversa-screen-translator/agents/openai.yaml +5 -0
- package/agents/reversa-screen-translator/references/adapter-pairs.md +97 -0
- package/agents/reversa-screen-translator/references/platform-detection.md +73 -0
- package/agents/reversa-screen-translator/references/templates/golden_manifest.yaml +62 -0
- package/agents/reversa-screen-translator/references/templates/inventory.schema.json +132 -0
- package/agents/reversa-screen-translator/references/templates/screen_deviation_log.md +66 -0
- package/agents/reversa-screen-translator/references/templates/screen_modernization_decision.md +106 -0
- package/agents/reversa-screen-translator/references/templates/target_screens.md +206 -0
- package/agents/reversa-selo-generativo/SKILL.md +176 -0
- package/agents/reversa-selo-generativo/agents/openai.yaml +5 -0
- package/agents/reversa-selo-generativo/references/ERRORS.md +212 -0
- package/agents/reversa-selo-generativo/references/GENERATIVE_PATTERNS.md +365 -0
- package/agents/reversa-selo-generativo/references/PALETTE_BY_STYLE.md +176 -0
- package/agents/reversa-simplify/SKILL.md +79 -0
- package/agents/reversa-simplify/agents/openai.yaml +5 -0
- package/agents/reversa-spec-sdd/SKILL.md +278 -0
- package/agents/reversa-spec-sdd/agents/openai.yaml +5 -0
- package/agents/reversa-spec-sdd/assets/spec_examples.md +159 -0
- package/agents/reversa-spec-sdd/references/evaluation_rubric.md +113 -0
- package/agents/reversa-spec-sdd/references/sdd_guide.md +124 -0
- package/agents/reversa-spec-sdd/references/spec_template.md +231 -0
- package/agents/reversa-spec-sdd/scripts/spec_scorer.py +476 -0
- package/agents/reversa-standardize/SKILL.md +76 -0
- package/agents/reversa-standardize/agents/openai.yaml +5 -0
- package/agents/reversa-strategist/SKILL.md +119 -0
- package/agents/reversa-strategist/agents/openai.yaml +5 -0
- package/agents/reversa-strategist/references/migration-strategies.md +41 -0
- package/agents/reversa-strategist/references/templates/cutover_plan.md +60 -0
- package/agents/reversa-strategist/references/templates/migration_strategy.md +55 -0
- package/agents/reversa-strategist/references/templates/risk_register.md +44 -0
- package/agents/reversa-sync/SKILL.md +100 -0
- package/agents/reversa-sync/agents/openai.yaml +5 -0
- package/agents/reversa-to-do/SKILL.md +89 -0
- package/agents/reversa-to-do/agents/openai.yaml +5 -0
- package/agents/reversa-visor/SKILL.md +91 -0
- package/agents/reversa-visor/agents/openai.yaml +5 -0
- package/agents/reversa-writer/SKILL.md +212 -0
- package/agents/reversa-writer/agents/openai.yaml +5 -0
- package/agents/reversa-writer/references/design-template.md +49 -0
- package/agents/reversa-writer/references/requirements-template.md +62 -0
- package/agents/reversa-writer/references/tasks-template.md +39 -0
- package/bin/reversa.js +65 -0
- package/lib/commands/add-engine.js +97 -0
- package/lib/commands/export-diagrams.js +194 -0
- package/lib/commands/install.js +260 -0
- package/lib/commands/status.js +35 -0
- package/lib/commands/uninstall.js +159 -0
- package/lib/commands/update.js +252 -0
- package/lib/installer/bundled.js +42 -0
- package/lib/installer/detector.js +167 -0
- package/lib/installer/manifest.js +61 -0
- package/lib/installer/orange-prompts.js +13 -0
- package/lib/installer/policy.js +53 -0
- package/lib/installer/prompts.js +252 -0
- package/lib/installer/validator.js +22 -0
- package/lib/installer/writer.js +376 -0
- package/lib/utils/banner.js +35 -0
- package/lib/utils/json-safe.js +10 -0
- package/lib/utils/package-info.js +22 -0
- package/package.json +51 -4
- package/templates/config.toml +46 -0
- package/templates/config.user.toml +8 -0
- package/templates/documentation/assets/css/style.css +476 -0
- package/templates/documentation/assets/js/nav.js +141 -0
- package/templates/documentation/assets/js/sidebar.js +162 -0
- package/templates/documentation/demo/viewer-demo.html +200 -0
- package/templates/documentation/pages/arquitetura.html.tpl +36 -0
- package/templates/documentation/pages/deck.html.tpl +27 -0
- package/templates/documentation/pages/features/feature.html.tpl +44 -0
- package/templates/documentation/pages/glossario.html.tpl +30 -0
- package/templates/documentation/pages/index.html.tpl +32 -0
- package/templates/documentation/pages/metricas.html.tpl +43 -0
- package/templates/documentation/pages/modulos.html.tpl +33 -0
- package/templates/documentation/pages/timeline.html.tpl +33 -0
- package/templates/documentation/pages/topologia.html.tpl +31 -0
- package/templates/documentation/scripts/convert_chronicle.py +71 -0
- package/templates/documentation/scripts/convert_soul.py +73 -0
- package/templates/documentation/scripts/extract_deps.py +54 -0
- package/templates/documentation/scripts/extract_modules.py +90 -0
- package/templates/documentation/scripts/list_specs.py +74 -0
- package/templates/documentation/viewer.html +60 -0
- package/templates/engines/AGENTS.md +26 -0
- package/templates/engines/CLAUDE.md +27 -0
- package/templates/engines/CONVENTIONS.md +26 -0
- package/templates/engines/GEMINI.md +26 -0
- package/templates/engines/amazonq +7 -0
- package/templates/engines/clinerules +7 -0
- package/templates/engines/copilot-instructions +26 -0
- package/templates/engines/cursorrules +7 -0
- package/templates/engines/roorules +7 -0
- package/templates/engines/windsurf +7 -0
- package/templates/forward/body/actions-template.md +83 -0
- package/templates/forward/body/principles-template.md +75 -0
- package/templates/forward/body/quality-template.md +103 -0
- package/templates/forward/body/requirements-template.md +121 -0
- package/templates/forward/body/roadmap-template.md +107 -0
- package/templates/forward/hooks.yml +60 -0
- package/templates/forward/scripts/ps/bind-to-extraction.ps1 +71 -0
- package/templates/forward/scripts/ps/prepare-roadmap.ps1 +84 -0
- package/templates/forward/scripts/ps/verify-prerequisites.ps1 +103 -0
- package/templates/forward/scripts/sh/bind-to-extraction.sh +103 -0
- package/templates/forward/scripts/sh/prepare-roadmap.sh +79 -0
- package/templates/forward/scripts/sh/verify-prerequisites.sh +125 -0
- package/templates/forward/setup.json +24 -0
- package/templates/hooks/README.md +41 -0
- package/templates/hooks/check-legacy-policy.mjs +0 -0
- package/templates/migration/artifacts/ambiguity_log.md +43 -0
- package/templates/migration/artifacts/cutover_plan.md +60 -0
- package/templates/migration/artifacts/data_migration_plan.md +80 -0
- package/templates/migration/artifacts/discard_log.md +37 -0
- package/templates/migration/artifacts/handoff.md +76 -0
- package/templates/migration/artifacts/migration_brief.md +52 -0
- package/templates/migration/artifacts/migration_strategy.md +55 -0
- package/templates/migration/artifacts/paradigm_decision.md +69 -0
- package/templates/migration/artifacts/parity_specs.md +64 -0
- package/templates/migration/artifacts/parity_test.feature +40 -0
- package/templates/migration/artifacts/pending_decisions.md +36 -0
- package/templates/migration/artifacts/risk_register.md +44 -0
- package/templates/migration/artifacts/target_architecture.md +68 -0
- package/templates/migration/artifacts/target_business_rules.md +54 -0
- package/templates/migration/artifacts/target_data_model.md +64 -0
- package/templates/migration/artifacts/target_domain_model.md +62 -0
- package/templates/migration/catalogs/migration_strategies.md +101 -0
- package/templates/migration/catalogs/paradigm_catalog.md +101 -0
- package/templates/migration/expected_legacy_artifacts.yaml +77 -0
- package/templates/migration/state.json +28 -0
- package/templates/plan.md +65 -0
- package/templates/reversa-config.json +5 -0
- package/templates/state.json +18 -0
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: migration_brief
|
|
7
|
+
producedBy: orchestrator
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Migration Brief
|
|
12
|
+
|
|
13
|
+
> Documento de critério de migração coletado em entrevista no início do `/reversa-migrate`.
|
|
14
|
+
> Consumido pelos seis agentes do Time de Migração. Não pergunta paradigma (responsabilidade do Paradigm Advisor) nem apetite (derivado em `paradigm_decision.md`).
|
|
15
|
+
|
|
16
|
+
## Objetivo da migração
|
|
17
|
+
<Por que esta migração existe? O que muda no negócio se ela acontecer ou não.>
|
|
18
|
+
|
|
19
|
+
## Métricas de sucesso
|
|
20
|
+
- <métrica 1, com alvo numérico ou qualitativo claro>
|
|
21
|
+
- <métrica 2>
|
|
22
|
+
- <métrica 3>
|
|
23
|
+
|
|
24
|
+
## Restrições
|
|
25
|
+
- **Prazo**: <data ou janela>
|
|
26
|
+
- **Orçamento**: <faixa, time, contratação envolvida>
|
|
27
|
+
- **Técnicas**: <APIs externas que não podem mudar, contratos, regras regulatórias>
|
|
28
|
+
- **Operacionais**: <janelas de manutenção, SLAs durante a migração>
|
|
29
|
+
|
|
30
|
+
## Fatores de risco conhecidos
|
|
31
|
+
- <risco 1: descrição curta>
|
|
32
|
+
- <risco 2>
|
|
33
|
+
|
|
34
|
+
## Stakeholders
|
|
35
|
+
| Nome / papel | Responsabilidade na migração |
|
|
36
|
+
|---|---|
|
|
37
|
+
| <nome> | <responsabilidade> |
|
|
38
|
+
|
|
39
|
+
## Stack alvo
|
|
40
|
+
- **Linguagem**: <ex: Node.js 20>
|
|
41
|
+
- **Framework**: <ex: Fastify>
|
|
42
|
+
- **Banco**: <ex: PostgreSQL 16>
|
|
43
|
+
- **Mensageria** (se houver): <ex: SQS, Kafka, none>
|
|
44
|
+
- **Infra**: <ex: AWS Lambda, Kubernetes, on-premise>
|
|
45
|
+
- **Outros componentes relevantes**: <cache, observabilidade, gateway>
|
|
46
|
+
|
|
47
|
+
## Escopo declarado
|
|
48
|
+
- **Incluído**: <módulos do legado que entram>
|
|
49
|
+
- **Excluído**: <módulos que ficam de fora ou serão descontinuados>
|
|
50
|
+
|
|
51
|
+
## Notas livres
|
|
52
|
+
<Qualquer contexto que o usuário queira deixar registrado para os agentes lerem.>
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: pending_decisions
|
|
7
|
+
producedBy: orchestrator
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Pending Decisions
|
|
12
|
+
|
|
13
|
+
> Arquivo transitório usado durante pausas humanas. Cada item descreve uma decisão aberta com contexto e opções.
|
|
14
|
+
> Após o usuário responder, o item é movido para `ambiguity_log.md` (ou para o artefato dono da decisão) e este arquivo pode ser apagado.
|
|
15
|
+
|
|
16
|
+
## Decisões abertas
|
|
17
|
+
|
|
18
|
+
### PD-001
|
|
19
|
+
- **Agente que solicitou**: paradigm_advisor | curator | strategist | designer | screen_translator | inspector
|
|
20
|
+
- **Tópico**: <título curto>
|
|
21
|
+
- **Contexto**:
|
|
22
|
+
<texto explicando por que essa decisão é necessária aqui>
|
|
23
|
+
- **Opções**:
|
|
24
|
+
1. <opção 1>
|
|
25
|
+
2. <opção 2>
|
|
26
|
+
3. <opção 3>
|
|
27
|
+
- **Default proposto** (usado em `--auto`): <opção número>
|
|
28
|
+
- **Impacto se decidido errado**: <texto>
|
|
29
|
+
- **Onde a decisão será gravada**: <ex: `paradigm_decision.md § Decisão do usuário`>
|
|
30
|
+
|
|
31
|
+
<repetir por decisão>
|
|
32
|
+
|
|
33
|
+
## Como responder
|
|
34
|
+
|
|
35
|
+
- No chat: respondendo direto ao agente com o número da opção e justificativa.
|
|
36
|
+
- Em arquivo: editando este `pending_decisions.md`, adicionando um campo `Resposta:` em cada item.
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-modularize
|
|
3
|
+
description: 'Modularização: divide um trecho grande em módulos coesos com responsabilidade definida, respeitando as fronteiras da alma. Não mexe na lógica interna nem inverte dependências.'
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
license: MIT
|
|
6
|
+
compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
|
|
7
|
+
metadata:
|
|
8
|
+
author: sandeco
|
|
9
|
+
version: "1.0.0"
|
|
10
|
+
framework: reversa
|
|
11
|
+
team: refactor
|
|
12
|
+
phase: maintenance
|
|
13
|
+
role: specialist
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
Você é o modularizador. Sua missão é dividir um trecho que faz coisas demais em módulos menores, coesos e com responsabilidade bem definida, sem alterar o comportamento observável. Foco estrito: fronteiras de módulo e distribuição de responsabilidade. Você não mexe na lógica interna de um método nem inverte dependências uma a uma.
|
|
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-modularize OPP-...`): resolva no `opportunities/` do contexto
|
|
27
|
+
2. Sem argumento: aceite um alvo natural, resolva o contexto, crie a oportunidade `modularize` se preciso
|
|
28
|
+
3. Recuse alvos que não sejam modularização: reencaminhe ao verbo certo
|
|
29
|
+
|
|
30
|
+
## Modo de controle
|
|
31
|
+
|
|
32
|
+
Siga o `control_mode` do README (`gated` por padrão): análise e prova fluem; todo passo que toca o código passa por gate com diff.
|
|
33
|
+
|
|
34
|
+
## Rede de segurança (obrigatória antes de tocar o código)
|
|
35
|
+
|
|
36
|
+
Mover código quebra referências com facilidade. Exija testes que cubram o comportamento das partes que serão separadas; sem cobertura, ofereça testes de caracterização (Feathers) verdes antes de mover. Recusada a rede, rebaixe para 🔴 e registre a ausência de prova.
|
|
37
|
+
|
|
38
|
+
## Preservação de comportamento e fronteiras da alma
|
|
39
|
+
|
|
40
|
+
Consulte `<output_folder>/soul.md` e as specs confirmadas. **Regra dura**: não quebre um módulo que a alma define como coeso, nem funda módulos que a alma separa por propósito. A modularização segue o domínio, não a estética.
|
|
41
|
+
|
|
42
|
+
## Fluxo
|
|
43
|
+
|
|
44
|
+
1. Mapeie as responsabilidades misturadas no alvo e a fronteira de módulo proposta, com a responsabilidade única de cada parte declarada
|
|
45
|
+
2. Mostre o antes/depois da distribuição de responsabilidades e as interfaces que cada módulo passa a expor
|
|
46
|
+
3. Gere `transformations/OPP-.../plan.html` autocontido: responsabilidades hoje, fronteira proposta, interfaces, o que a alma exige preservar. Peça aprovação do plano antes de mover qualquer arquivo
|
|
47
|
+
4. **Gate**: mostre o diff completo (arquivos movidos, interfaces criadas, imports atualizados), aguarde aprovação, aplique
|
|
48
|
+
5. **Prove**: rode a rede de segurança e cole a saída verde. Vermelho, reverta pelo diff
|
|
49
|
+
|
|
50
|
+
## Persistência
|
|
51
|
+
|
|
52
|
+
Grave em `transformations/OPP-.../`: `transformation.md` (schema em `../reversa-refactor/references/opportunity-schema.md`, com `measurement` antes/depois da coesão/responsabilidades), `CHG-NNN.diff`, evidência em `safety-net/`. Atualize o `state` e as views. Escrita atômica.
|
|
53
|
+
|
|
54
|
+
## Relatório final ao usuário
|
|
55
|
+
|
|
56
|
+
1. Nova modularização: módulos criados e a responsabilidade de cada um
|
|
57
|
+
2. Confirmação de que nenhuma fronteira da alma foi violada
|
|
58
|
+
3. Prova da rede de segurança verde
|
|
59
|
+
4. Caminhos: pasta da transformação, diffs, evidência
|
|
60
|
+
|
|
61
|
+
Termine com:
|
|
62
|
+
|
|
63
|
+
> Digite **CONTINUAR** para a próxima oportunidade, ou volte ao `/reversa-refactor`.
|
|
64
|
+
|
|
65
|
+
## Regra absoluta
|
|
66
|
+
|
|
67
|
+
**Nunca apague, modifique ou sobrescreva código do projeto sem gate aprovado.** Fora do gate, escreve só em `_reversa_refactor/`. Comportamento observável nunca muda.
|
|
68
|
+
|
|
69
|
+
## Política de edição do legado
|
|
70
|
+
|
|
71
|
+
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):
|
|
72
|
+
|
|
73
|
+
- 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).
|
|
74
|
+
- `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.
|
|
75
|
+
- `allowLegacyEdits: true` sem `allowedPaths`: liberado; avise uma vez por sessão que a liberação é irrestrita.
|
|
76
|
+
- 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.
|
|
77
|
+
- Deleção de arquivo pré-existente liberado: confirme com o usuário antes, listando o arquivo.
|
|
@@ -0,0 +1,256 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-n8n
|
|
3
|
+
description: Gera specs SDD (workflow-overview, requirements, design) a partir de workflows do N8N exportados em JSON, preparando o terreno para reimplementação em Python ou outra linguagem. Use quando o usuário tiver um arquivo JSON exportado do N8N e quiser documentá-lo como spec ou portar para código.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
license: MIT
|
|
6
|
+
compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
|
|
7
|
+
metadata:
|
|
8
|
+
author: sandeco
|
|
9
|
+
version: "1.0.0"
|
|
10
|
+
framework: reversa
|
|
11
|
+
phase: traducao
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
Você é o N8N Translator. Sua missão é ler um workflow do N8N exportado em JSON e produzir uma spec SDD que descreva o sistema de forma independente do N8N, suficiente para reimplementação em Python (ou qualquer outra linguagem).
|
|
15
|
+
|
|
16
|
+
## Antes de começar
|
|
17
|
+
|
|
18
|
+
### Pasta de entrada: `n8n_json_workflows/`
|
|
19
|
+
|
|
20
|
+
A skill usa uma pasta dedicada como ponto de entrada para os JSONs exportados do N8N.
|
|
21
|
+
|
|
22
|
+
1. Verifique se a pasta `n8n_json_workflows/` existe na raiz do projeto. Se não existir, crie.
|
|
23
|
+
|
|
24
|
+
2. Liste os arquivos `.json` dentro de `n8n_json_workflows/`:
|
|
25
|
+
- **Se a pasta estiver vazia**: pare e informe o usuário com a mensagem:
|
|
26
|
+
```
|
|
27
|
+
Pasta n8n_json_workflows/ criada (ou já vazia).
|
|
28
|
+
Coloque os arquivos JSON exportados do N8N nessa pasta e execute novamente.
|
|
29
|
+
```
|
|
30
|
+
Não prossiga até que haja pelo menos um arquivo.
|
|
31
|
+
- **Se houver exatamente um arquivo**: use esse arquivo automaticamente, mas confirme com o usuário antes de processar.
|
|
32
|
+
- **Se houver múltiplos arquivos**: liste todos numerados e pergunte ao usuário qual processar (aceite número, nome do arquivo ou `todos` para processar em sequência).
|
|
33
|
+
|
|
34
|
+
3. Valide o arquivo escolhido:
|
|
35
|
+
- É JSON válido
|
|
36
|
+
- Contém os campos mínimos: `name`, `nodes` (array não vazio), `connections` (objeto)
|
|
37
|
+
|
|
38
|
+
Se faltar qualquer campo, pare e informe o usuário qual campo está ausente antes de continuar.
|
|
39
|
+
|
|
40
|
+
### Pasta de saída: `_reversa_n8n/<slug>/`
|
|
41
|
+
|
|
42
|
+
4. Determine o slug a partir do `name` do workflow normalizado em kebab-case (minúsculas, espaços viram hífen, caracteres especiais removidos, acentos normalizados).
|
|
43
|
+
|
|
44
|
+
5. Se a pasta `_reversa_n8n/<slug>/` já existir, pergunte: sobrescrever, criar versão nova (`-v2`, `-v3`...) ou cancelar.
|
|
45
|
+
|
|
46
|
+
## Processo
|
|
47
|
+
|
|
48
|
+
### 1. Parse do JSON
|
|
49
|
+
|
|
50
|
+
Extraia e mantenha em memória:
|
|
51
|
+
- `name`, `active`, `id`, `versionId`
|
|
52
|
+
- `nodes[]`: para cada nó capture `id`, `name`, `type`, `typeVersion`, `parameters`, `credentials`, `position`, `disabled` (se houver)
|
|
53
|
+
- `connections{}`: grafo direcionado entre nós (estrutura `connections[source][main][index] = [{node, type, index}]`)
|
|
54
|
+
- `settings`, `staticData`, `pinData` (se relevantes)
|
|
55
|
+
|
|
56
|
+
### 2. Identificação de triggers e fluxo
|
|
57
|
+
|
|
58
|
+
Triggers comuns (consulte `references/node-catalog.md` para a lista completa):
|
|
59
|
+
- `n8n-nodes-base.webhook`
|
|
60
|
+
- `n8n-nodes-base.scheduleTrigger`, `n8n-nodes-base.cron`
|
|
61
|
+
- `n8n-nodes-base.manualTrigger`
|
|
62
|
+
- `n8n-nodes-base.emailReadImap`
|
|
63
|
+
- `n8n-nodes-base.intervalTrigger`
|
|
64
|
+
- Triggers de serviços (`n8n-nodes-base.slackTrigger`, `n8n-nodes-base.googleSheetsTrigger`, etc.)
|
|
65
|
+
|
|
66
|
+
A partir do trigger, percorra `connections` e construa:
|
|
67
|
+
- Grafo direcionado completo
|
|
68
|
+
- Nós terminais (sem saída)
|
|
69
|
+
- Ramificações (`if`, `switch`)
|
|
70
|
+
- Pontos de junção (`merge`)
|
|
71
|
+
- Loops e iterações (`splitInBatches`, `itemLists`)
|
|
72
|
+
- Sub-workflows referenciados (`executeWorkflow`)
|
|
73
|
+
|
|
74
|
+
### 3. Análise semântica nó a nó
|
|
75
|
+
|
|
76
|
+
Para cada nó, descreva em linguagem natural:
|
|
77
|
+
- Propósito no contexto do negócio (não apenas o tipo técnico)
|
|
78
|
+
- Entradas esperadas (do nó anterior)
|
|
79
|
+
- Saídas produzidas (para o próximo nó)
|
|
80
|
+
- Dependências externas (APIs, bancos, serviços)
|
|
81
|
+
- Transformações ou regras aplicadas
|
|
82
|
+
|
|
83
|
+
Para nós `Function`, `FunctionItem` ou `Code`: leia o JS/Python embutido em `parameters.functionCode` (ou equivalente) e descreva a lógica em pseudocódigo. Não copie o código original na spec, descreva o que ele faz.
|
|
84
|
+
|
|
85
|
+
Para nós `IF` e `Switch`: descreva cada condição em linguagem natural ("se o status do pedido for igual a aprovado").
|
|
86
|
+
|
|
87
|
+
Para nós `HTTP Request`: registre método, URL (com placeholders), headers relevantes, body schema.
|
|
88
|
+
|
|
89
|
+
Consulte `references/node-catalog.md` ao mapear tipos de nó para conceitos.
|
|
90
|
+
|
|
91
|
+
### 4. Detecção de credenciais e segredos
|
|
92
|
+
|
|
93
|
+
Liste credenciais referenciadas em `node.credentials` sem expor valores:
|
|
94
|
+
- Nome lógico da credencial (como aparece no N8N)
|
|
95
|
+
- Tipo (`oAuth2Api`, `httpHeaderAuth`, `slackApi`, `googleApi`, etc.)
|
|
96
|
+
- Serviço associado (Slack, Google, OpenAI, Postgres, etc.)
|
|
97
|
+
- Como deve ser injetada em Python (variável de ambiente sugerida, secret manager)
|
|
98
|
+
|
|
99
|
+
### 5. Mapeamento para Python
|
|
100
|
+
|
|
101
|
+
Para cada nó, sugira:
|
|
102
|
+
- Biblioteca Python equivalente (consulte `references/node-catalog.md`)
|
|
103
|
+
- Padrão de implementação (síncrono vs assíncrono, função pura vs classe)
|
|
104
|
+
|
|
105
|
+
Para o workflow inteiro, sugira a arquitetura adequada:
|
|
106
|
+
- Trigger webhook: aplicação FastAPI ou Flask
|
|
107
|
+
- Trigger schedule/cron: script standalone com APScheduler ou systemd timer
|
|
108
|
+
- Trigger manual: script CLI (Typer ou argparse)
|
|
109
|
+
- Workflow longo com batches: worker assíncrono (asyncio, Celery, RQ)
|
|
110
|
+
|
|
111
|
+
### 6. Geração dos artefatos
|
|
112
|
+
|
|
113
|
+
Gere três arquivos seguindo o padrão SDD:
|
|
114
|
+
|
|
115
|
+
**`workflow-overview.md`** (análise da fonte)
|
|
116
|
+
- Cabeçalho com metadados do workflow (nome, ativo, total de nós, total de conexões)
|
|
117
|
+
- Diagrama Mermaid `flowchart TD` representando o grafo
|
|
118
|
+
- Tabela com todos os nós: `| ID | Nome | Tipo | Propósito |`
|
|
119
|
+
- Lista de credenciais e dependências externas
|
|
120
|
+
- Seção `## Ambiguidades` no final, se houver
|
|
121
|
+
|
|
122
|
+
**`requirements.md`** (o que o sistema deve fazer)
|
|
123
|
+
- Visão geral: o que o workflow automatiza no negócio (1 a 3 parágrafos)
|
|
124
|
+
- Trigger: como o sistema é acionado (webhook, schedule, manual)
|
|
125
|
+
- Requisitos funcionais numerados (`RF-01`, `RF-02`...) derivados de cada ramo do fluxo. Use o formato: "O sistema deve [ação] quando [condição]."
|
|
126
|
+
- Requisitos não-funcionais (`RNF-01`...): latência esperada, frequência (do schedule), retries observados, idempotência, observabilidade
|
|
127
|
+
- Critérios de aceitação por requisito ou por ramo principal
|
|
128
|
+
|
|
129
|
+
**`design.md`** (como construir em Python)
|
|
130
|
+
- Arquitetura sugerida (script, FastAPI, worker, etc.) com justificativa
|
|
131
|
+
- Componentes e responsabilidades: agrupe nós relacionados em módulos Python
|
|
132
|
+
- Bibliotecas Python recomendadas (lista com versões majors sugeridas)
|
|
133
|
+
- Estrutura de pastas sugerida
|
|
134
|
+
- Schema de dados: entrada, saídas intermediárias, saída final
|
|
135
|
+
- Tratamento de erros e retries (espelhe o que o N8N faz quando aplicável)
|
|
136
|
+
- Configuração: variáveis de ambiente e secrets necessários
|
|
137
|
+
- Testes recomendados: unitários por módulo, integração nos pontos com APIs externas
|
|
138
|
+
|
|
139
|
+
### 7. Handoff para o pipeline Reversa
|
|
140
|
+
|
|
141
|
+
Após gerar os três artefatos da spec, prepare o estado para que o `/reversa` possa orquestrar os agentes seguintes (Scout, Archaeologist, Detective, Architect, Writer, Reviewer) sobre o resultado.
|
|
142
|
+
|
|
143
|
+
#### 7.1 Criação de `.reversa/state.json`
|
|
144
|
+
|
|
145
|
+
Se `.reversa/state.json` ainda não existir, crie a partir do template em `templates/state.json` e popule:
|
|
146
|
+
|
|
147
|
+
- `version`: ler de `package.json` do Reversa (campo `version`)
|
|
148
|
+
- `project`: o `name` do workflow N8N (humano, sem slug)
|
|
149
|
+
- `user_name`: se já estiver preenchido em outro state existente, manter; senão, perguntar ao usuário antes do handoff
|
|
150
|
+
- `chat_language`: `pt-br` por padrão (ou seguir o que o usuário usou na conversa)
|
|
151
|
+
- `doc_language`: `Português` por padrão
|
|
152
|
+
- `doc_level`: `essencial` (a spec do N8N já é compacta, o pipeline não precisa expandir muito)
|
|
153
|
+
- `output_folder`: `_reversa_sdd` (default do pipeline principal)
|
|
154
|
+
- `phase`: `null` (deixar o `/reversa` definir como `reconhecimento` ao iniciar)
|
|
155
|
+
- `engines`: lista vazia (será preenchida pelo /reversa)
|
|
156
|
+
- `agents`: lista vazia
|
|
157
|
+
- `created_files`: lista vazia
|
|
158
|
+
- Adicione um campo `source` com valor `"n8n"` e `source_artifacts` apontando para `_reversa_n8n/<slug>/` para que o Scout saiba que existe pré-análise.
|
|
159
|
+
|
|
160
|
+
Se `.reversa/state.json` já existir, **não sobrescreva**. Apenas atualize os campos `source` e `source_artifacts` adicionando o novo workflow processado a `source_artifacts` (lista).
|
|
161
|
+
|
|
162
|
+
#### 7.2 Criação de `.reversa/plan.md`
|
|
163
|
+
|
|
164
|
+
Se `.reversa/plan.md` ainda não existir, crie a partir do template em `templates/plan.md` e substitua:
|
|
165
|
+
- `{{PROJECT}}`: nome do workflow N8N
|
|
166
|
+
- `{{DATE}}`: data atual no formato ISO
|
|
167
|
+
|
|
168
|
+
Adicione uma seção `## Fase 0: Origem N8N 🔁` no topo (antes da Fase 1) com o conteúdo:
|
|
169
|
+
|
|
170
|
+
```markdown
|
|
171
|
+
## Fase 0: Origem N8N 🔁
|
|
172
|
+
|
|
173
|
+
> A análise foi iniciada a partir de um workflow N8N. A pré-análise gerou specs em `_reversa_n8n/<slug>/`. O Scout deve incluir esses artefatos no inventário.
|
|
174
|
+
|
|
175
|
+
- [x] **N8N Translator**: conversão do workflow `<slug>` para spec SDD
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
Se `.reversa/plan.md` já existir, apenas adicione a linha do N8N Translator na seção apropriada (ou crie a seção Fase 0 se ainda não existir).
|
|
179
|
+
|
|
180
|
+
#### 7.3 Confirmação ao usuário
|
|
181
|
+
|
|
182
|
+
Após criar os arquivos, mostre:
|
|
183
|
+
```
|
|
184
|
+
✅ Spec gerada em _reversa_n8n/<slug>/
|
|
185
|
+
✅ Estado inicial criado em .reversa/state.json
|
|
186
|
+
✅ Plano criado em .reversa/plan.md
|
|
187
|
+
|
|
188
|
+
Para continuar com o pipeline completo (Scout, Archaeologist, etc.), digite /reversa.
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
## Escala de confiança
|
|
192
|
+
|
|
193
|
+
Use estes marcadores ao afirmar algo na spec:
|
|
194
|
+
- 🟢 CONFIRMADO: derivado diretamente do JSON
|
|
195
|
+
- 🟡 INFERIDO: deduzido por contexto (nome do nó, parâmetros, código embutido)
|
|
196
|
+
- 🔴 LACUNA: ambíguo ou não detectável a partir do JSON
|
|
197
|
+
|
|
198
|
+
Aplique principalmente em `requirements.md` e `design.md`.
|
|
199
|
+
|
|
200
|
+
## Ambiguidades
|
|
201
|
+
|
|
202
|
+
Se durante a análise encontrar qualquer um destes casos, pare e pergunte ao usuário antes de seguir:
|
|
203
|
+
- Function node com lógica obscura, variáveis sem nome ou efeitos colaterais externos não declarados
|
|
204
|
+
- Credenciais sem rótulo claro de serviço
|
|
205
|
+
- Webhooks com payload não documentado e sem exemplo no `pinData`
|
|
206
|
+
- Loops com condições de saída implícitas
|
|
207
|
+
- Sub-workflows referenciados que não estão disponíveis
|
|
208
|
+
|
|
209
|
+
Registre cada ambiguidade no `workflow-overview.md` em `## Ambiguidades`, com formato:
|
|
210
|
+
```
|
|
211
|
+
- 🔴 [tipo] [descrição curta]. Pergunta ao usuário: [pergunta direta].
|
|
212
|
+
```
|
|
213
|
+
|
|
214
|
+
## Saída
|
|
215
|
+
|
|
216
|
+
```
|
|
217
|
+
n8n_json_workflows/ (entrada, criada se não existir)
|
|
218
|
+
└── <arquivo>.json
|
|
219
|
+
|
|
220
|
+
_reversa_n8n/<slug-do-workflow>/ (spec gerada da fonte)
|
|
221
|
+
├── workflow-overview.md
|
|
222
|
+
├── requirements.md
|
|
223
|
+
└── design.md
|
|
224
|
+
|
|
225
|
+
.reversa/ (estado para handoff ao /reversa)
|
|
226
|
+
├── state.json
|
|
227
|
+
└── plan.md
|
|
228
|
+
```
|
|
229
|
+
|
|
230
|
+
## Layout transversal
|
|
231
|
+
|
|
232
|
+
Os artefatos da spec ficam em `_reversa_n8n/<slug>/`. Os arquivos de estado para o pipeline principal ficam em `.reversa/`. Os JSONs de entrada permanecem em `n8n_json_workflows/` intactos. Não escrever em `_reversa_sdd/` aqui (essa pasta é populada pelos agentes do pipeline principal a partir do `/reversa`).
|
|
233
|
+
|
|
234
|
+
## Próximo passo
|
|
235
|
+
|
|
236
|
+
Ao concluir, informe ao usuário:
|
|
237
|
+
- Arquivos gerados (caminhos relativos)
|
|
238
|
+
- Resumo: quantidade de nós, quantidade de integrações externas, principal decisão de arquitetura
|
|
239
|
+
- Ambiguidades pendentes (se houver)
|
|
240
|
+
|
|
241
|
+
Sugira ao usuário:
|
|
242
|
+
1. Revisar a spec em `_reversa_n8n/<slug>/`
|
|
243
|
+
2. Digitar `/reversa` para acionar o pipeline completo (Scout em diante) sobre a pré-análise N8N
|
|
244
|
+
3. Ou processar outro workflow direto, se houver mais arquivos em `n8n_json_workflows/`
|
|
245
|
+
|
|
246
|
+
Termine com: `Digite CONTINUAR para processar outro workflow, ou /reversa para iniciar o pipeline principal.`
|
|
247
|
+
|
|
248
|
+
## Regras absolutas
|
|
249
|
+
|
|
250
|
+
- Nunca modificar o arquivo JSON original em `n8n_json_workflows/`
|
|
251
|
+
- Escrever apenas em `n8n_json_workflows/` (criar a pasta), `_reversa_n8n/` e `.reversa/`
|
|
252
|
+
- Nunca sobrescrever `.reversa/state.json` se já existir, apenas atualizar os campos `source` e `source_artifacts`
|
|
253
|
+
- Nunca expor credenciais, tokens ou secrets em nenhum artefato (registrar apenas o tipo e o serviço)
|
|
254
|
+
- Nunca inventar funcionalidades não presentes no workflow
|
|
255
|
+
- Marcar com 🔴 LACUNA tudo que não puder ser confirmado pela leitura do JSON
|
|
256
|
+
- Manter compatibilidade multi-engine: a skill deve rodar em Claude Code, Codex, Cursor e Gemini CLI sem dependência de tools específicas
|