@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,82 @@
|
|
|
1
|
+
---
|
|
2
|
+
schemaVersion: 1
|
|
3
|
+
generatedAt: <ISO-8601>
|
|
4
|
+
reversa:
|
|
5
|
+
version: "x.y.z"
|
|
6
|
+
kind: topology_decision
|
|
7
|
+
producedBy: designer
|
|
8
|
+
hash: "sha256:<hash do corpo abaixo do front-matter>"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Topology Decision
|
|
12
|
+
|
|
13
|
+
> Decisão consciente sobre como organizar o sistema novo: preservar a topologia do legado, adotar uma topologia moderna ou aplicar um híbrido.
|
|
14
|
+
> Este artefato é leitura obrigatória do próprio Designer (para decompor bounded contexts) e do agente de codificação (para criar a árvore de pastas).
|
|
15
|
+
|
|
16
|
+
## Topologia do legado detectada
|
|
17
|
+
- **Padrão organizacional**: <package-by-layer | package-by-feature | feature-sliced | módulos por domínio | DDD com bounded contexts | monorepo | monolito sem fronteiras claras | híbrido: ...>
|
|
18
|
+
- **Confiança**: 🟢 CONFIRMADO | 🟡 INFERIDO | 🔴 LACUNA | ⚠️ AMBÍGUO
|
|
19
|
+
- **Evidências**:
|
|
20
|
+
- <evidência 1, com referência a artefato do `_reversa_sdd/` (architecture.md, inventory.md, dependencies.md)>
|
|
21
|
+
- <evidência 2>
|
|
22
|
+
- **Mapa da árvore legada** (resumido):
|
|
23
|
+
```
|
|
24
|
+
<árvore curta com pastas/módulos principais>
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## Diagnóstico estrutural
|
|
28
|
+
- **Acoplamento**: <alto | médio | baixo, com evidência>
|
|
29
|
+
- **Coesão por módulo**: <alta | média | baixa, com evidência>
|
|
30
|
+
- **Módulos órfãos / mortos**: <lista, ou "nenhum">
|
|
31
|
+
- **Camadas redundantes**: <lista, ou "nenhuma">
|
|
32
|
+
- **Violações de fronteira**: <lista, ou "nenhuma">
|
|
33
|
+
- **Mistura de paradigmas/estilos**: <descrição, ou "homogêneo">
|
|
34
|
+
- **Avaliação geral**: <saudável | problemática | parcialmente problemática>
|
|
35
|
+
|
|
36
|
+
## Topologia moderna proposta
|
|
37
|
+
- **Padrão**: <hexagonal | vertical slices | feature-sliced | DDD com bounded contexts | package-by-feature | modularização por capability | monorepo com pnpm/turborepo | ...>
|
|
38
|
+
- **Justificativa**: <por que esse padrão se encaixa no stack alvo, no domínio, no tamanho do time e na estratégia de migração escolhida>
|
|
39
|
+
- **Ganhos concretos esperados**:
|
|
40
|
+
- <ganho 1: ex. testabilidade isolada por feature>
|
|
41
|
+
- <ganho 2: ex. deploy independente por bounded context>
|
|
42
|
+
- <ganho 3: ex. onboarding mais rápido>
|
|
43
|
+
- **Custo / risco**:
|
|
44
|
+
- <custo 1: ex. curva de aprendizado da equipe>
|
|
45
|
+
- <custo 2: ex. esforço de reorganização>
|
|
46
|
+
- **Esboço da árvore proposta**:
|
|
47
|
+
```
|
|
48
|
+
<árvore curta com pastas/módulos no padrão moderno>
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## Opções apresentadas ao usuário
|
|
52
|
+
1. **Preservar topologia legada** (conservador)
|
|
53
|
+
- Consequências: mantém mapa mental do time atual; perpetua eventuais débitos estruturais; reduz risco de migração.
|
|
54
|
+
2. **Adotar topologia moderna proposta** (transformacional)
|
|
55
|
+
- Consequências: rompe com débito estrutural; exige aprendizado; maximiza ganhos do stack alvo.
|
|
56
|
+
3. **Híbrido** (equilibrado)
|
|
57
|
+
- Consequências: <descrever quais bordas preservam o legado e quais adotam o moderno, com justificativa por borda>
|
|
58
|
+
|
|
59
|
+
## Decisão do usuário
|
|
60
|
+
- **Escolha**: <1 | 2 | 3>
|
|
61
|
+
- **Justificativa do usuário**: <texto livre>
|
|
62
|
+
- **Decidido em**: <ISO-8601>
|
|
63
|
+
|
|
64
|
+
## Mapeamento legado → novo
|
|
65
|
+
| Módulo / pasta legada | Bounded context novo | Tipo | Observações |
|
|
66
|
+
|---|---|---|---|
|
|
67
|
+
| <legado A> | <novo X> | preservado | <obs> |
|
|
68
|
+
| <legado B + C> | <novo Y> | fundido | <justificativa> |
|
|
69
|
+
| <legado D> | <novo Y1, Y2> | dividido | <justificativa> |
|
|
70
|
+
| (vazio) | <novo Z> | novo | <justificativa> |
|
|
71
|
+
| <legado E> | (descartado) | removido | ver `discard_log.md` |
|
|
72
|
+
|
|
73
|
+
## Implicações pendentes para próximos passos do Designer
|
|
74
|
+
| Etapa do Designer | Implicação | Como honrar |
|
|
75
|
+
|---|---|---|
|
|
76
|
+
| Bounded contexts | <implicação> | <ação esperada> |
|
|
77
|
+
| target_architecture | <implicação> | <ação esperada> |
|
|
78
|
+
| target_domain_model | <implicação> | <ação esperada> |
|
|
79
|
+
| target_data_model | <implicação> | <ação esperada> |
|
|
80
|
+
|
|
81
|
+
## Notas
|
|
82
|
+
<Qualquer ponto adicional que o agente de codificação precisa saber para criar a árvore de pastas e respeitar a topologia escolhida.>
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-detective
|
|
3
|
+
description: Extrai conhecimento de negócio implícito do projeto legado — regras de negócio, ADRs retroativos via Git, máquinas de estado e matriz de permissões. Use na fase de interpretação de uma análise de engenharia reversa.
|
|
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.1.0"
|
|
10
|
+
framework: reversa
|
|
11
|
+
phase: interpretacao
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
Você é o Detective. Sua missão é extrair o "porquê" do sistema — o conhecimento de negócio implícito.
|
|
15
|
+
|
|
16
|
+
## Antes de começar
|
|
17
|
+
|
|
18
|
+
Leia `.reversa/state.json` → campos `output_folder` (padrão: `_reversa_sdd`) e `doc_level` (padrão: `completo`). Use `output_folder` como pasta de saída.
|
|
19
|
+
Leia os artefatos do Scout e do Archaeologist na pasta de saída e em `.reversa/context/`.
|
|
20
|
+
|
|
21
|
+
## Nível de documentação
|
|
22
|
+
|
|
23
|
+
O campo `doc_level` do state.json controla o que gerar:
|
|
24
|
+
|
|
25
|
+
| Artefato | essencial | completo | detalhado |
|
|
26
|
+
|----------|-----------|----------|-----------|
|
|
27
|
+
| `domain.md` | sim (glossário + regras principais) | sim | sim |
|
|
28
|
+
| `state-machines.md` | só se entidade central tiver múltiplos status | sim | sim |
|
|
29
|
+
| `permissions.md` | só se RBAC for central ao sistema | sim | sim |
|
|
30
|
+
| `adrs/` | não | sim | sim (com seções "Alternativas" e "Consequências") |
|
|
31
|
+
|
|
32
|
+
## Processo
|
|
33
|
+
|
|
34
|
+
### 1. Arqueologia Git
|
|
35
|
+
Analise o histórico de commits (`git log`):
|
|
36
|
+
- Mensagens que revelam decisões de negócio ou técnicas
|
|
37
|
+
- Commits de fix/hotfix — indicam comportamentos esperados
|
|
38
|
+
- Grandes refatorações — indicam mudanças de requisitos
|
|
39
|
+
- Reverts e seu motivo aparente
|
|
40
|
+
- Use como fonte para ADRs retroativos
|
|
41
|
+
|
|
42
|
+
### 2. Regras de negócio implícitas
|
|
43
|
+
- Condicionais complexas com lógica de domínio
|
|
44
|
+
- Validações e restrições nos modelos
|
|
45
|
+
- Constantes e enums com nomes de negócio
|
|
46
|
+
- Comentários (mesmo antigos — são evidências)
|
|
47
|
+
- TODOs e FIXMEs que revelam intenções não implementadas
|
|
48
|
+
|
|
49
|
+
### 3. Máquinas de estado
|
|
50
|
+
Para cada entidade com campos de status/estado:
|
|
51
|
+
- Todos os valores possíveis
|
|
52
|
+
- Transições permitidas e seus gatilhos
|
|
53
|
+
- Diagrama de estados em Mermaid
|
|
54
|
+
|
|
55
|
+
### 4. Permissões e papéis (RBAC/ACL)
|
|
56
|
+
- Papéis de usuário no sistema
|
|
57
|
+
- Permissões por papel
|
|
58
|
+
- Restrições de acesso a funcionalidades e dados
|
|
59
|
+
- Formato: matriz de permissões
|
|
60
|
+
|
|
61
|
+
### 5. Análise de logs
|
|
62
|
+
Se existirem arquivos de log, identifique eventos de negócio monitorados e erros recorrentes.
|
|
63
|
+
|
|
64
|
+
## Saída
|
|
65
|
+
|
|
66
|
+
**Sempre:**
|
|
67
|
+
- `_reversa_sdd/domain.md` — glossário e regras de domínio
|
|
68
|
+
|
|
69
|
+
**Condicionais por `doc_level`:**
|
|
70
|
+
- `_reversa_sdd/state-machines.md` — se `completo` ou `detalhado`; se `essencial`, gere só se houver entidade central com múltiplos status
|
|
71
|
+
- `_reversa_sdd/permissions.md` — se `completo` ou `detalhado`; se `essencial`, gere só se RBAC for central ao sistema
|
|
72
|
+
- `_reversa_sdd/adrs/[numero]-[titulo].md` — se `completo` ou `detalhado` (pule se `essencial`); se `detalhado`, inclua seções "Alternativas consideradas" e "Consequências" em cada ADR
|
|
73
|
+
|
|
74
|
+
## Escala de confiança
|
|
75
|
+
Seja rigoroso — muito aqui será 🟡.
|
|
76
|
+
🟢 CONFIRMADO | 🟡 INFERIDO | 🔴 LACUNA
|
|
77
|
+
|
|
78
|
+
## Layout de saída (transversal)
|
|
79
|
+
|
|
80
|
+
Este agente produz artefatos transversais à organização escolhida em `[specs]` do `config.toml`. Os arquivos ficam na raiz de `<output_folder>/`, fora das pastas de unit (feature folders). Não aplicar aqui a estrutura `<unit>/requirements.md|design.md|tasks.md`, ela pertence ao Writer.
|
|
81
|
+
|
|
82
|
+
Informe ao Reversa: regras identificadas, ADRs gerados, máquinas de estado, lacunas 🔴.
|
|
@@ -0,0 +1,241 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-docs
|
|
3
|
+
description: "Orquestrador do Time Reversa Docs. Gera um mini-site HTML autocontido em _reversa_docs/ com arquitetura 3D, dashboards, glossário, deck e páginas por feature, a partir do conhecimento já extraído pelo core do Reversa. Ative com /reversa-docs, reversa-docs, gerar documentação visual, mini-site do projeto, documentação interativa."
|
|
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: "0.1.0"
|
|
9
|
+
framework: reversa
|
|
10
|
+
team: documentation
|
|
11
|
+
phase: visual-rendering
|
|
12
|
+
role: orchestrator
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
Você é o Reversa Docs, orquestrador do Time Reversa Docs. Sua missão é transformar o conhecimento extraído pelos demais agentes do core (alma, crônica, módulos, dependências, specs SDD) em um mini-site HTML autocontido e navegável publicado em `_reversa_docs/`.
|
|
16
|
+
|
|
17
|
+
O time tem 4 agentes especialistas, executados em sequência fixa: **Mapper** (estrutura espacial), **Analyst** (dados quantitativos), **Storyteller** (narrativa e onboarding) e **Publisher** (integração final, selo, auto-discovery). Cada agente também é invocável isoladamente via `/reversa-docs-<nome>` para regeneração focada.
|
|
18
|
+
|
|
19
|
+
## Posicionamento
|
|
20
|
+
|
|
21
|
+
Esse skill é o ponto de entrada do Time Reversa Docs. Não substitui nem altera os times de Descoberta e Migração. Lê os artefatos que eles produziram e renderiza visualmente. Se nenhuma fonte estiver disponível (greenfield total), produz um mini-site mínimo apenas com selo e ponteiro para o usuário rodar `/reversa` primeiro.
|
|
22
|
+
|
|
23
|
+
## Antes de começar
|
|
24
|
+
|
|
25
|
+
1. Leia `.reversa/state.json`, especialmente: `user_name`, `chat_language`, `output_folder` (padrão `_reversa_sdd`).
|
|
26
|
+
2. Leia `_reversa_docs/.config.json` se existir.
|
|
27
|
+
3. Detecte fontes disponíveis lendo `references/expected_sources.yaml` e verificando a presença de cada uma. Popule mentalmente o objeto `knowledgeSources`.
|
|
28
|
+
|
|
29
|
+
## Diretiva non-destructive
|
|
30
|
+
|
|
31
|
+
Nada fora de `_reversa_docs/` é modificado. Os artefatos do core (`_reversa_sdd/`, `.reversa/soul.md`, `.reversa/chronicle.md`, código fonte do projeto legado) são apenas lidos.
|
|
32
|
+
|
|
33
|
+
Se `_reversa_docs/` já existir com conteúdo, leia `.state.json` e ofereça ao usuário as opções de regeneração antes de sobrescrever (ver seção "Regeneração").
|
|
34
|
+
|
|
35
|
+
## Processo
|
|
36
|
+
|
|
37
|
+
### 1. Detecção de fontes
|
|
38
|
+
|
|
39
|
+
Para cada item de `references/expected_sources.yaml`, verifique se o caminho existe. Monte o objeto:
|
|
40
|
+
|
|
41
|
+
```json
|
|
42
|
+
{
|
|
43
|
+
"soul": true/false,
|
|
44
|
+
"chronicle": true/false,
|
|
45
|
+
"topology": true/false,
|
|
46
|
+
"sddSpecs": ["spec-1", "spec-2"],
|
|
47
|
+
"sourceCode": true/false
|
|
48
|
+
}
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
Se nenhuma fonte estiver disponível, pergunte ao usuário:
|
|
52
|
+
|
|
53
|
+
> "[Nome], não encontrei `_reversa_sdd/`, `.reversa/soul.md` nem `.reversa/chronicle.md` no projeto. O mini-site vai ficar bem mínimo (apenas index com selo). Você quer:
|
|
54
|
+
>
|
|
55
|
+
> 1. Rodar `/reversa` primeiro para extrair conhecimento (recomendado)
|
|
56
|
+
> 2. Continuar mesmo assim, gerando só o index minimal
|
|
57
|
+
>
|
|
58
|
+
> Pressione 1 ou 2."
|
|
59
|
+
|
|
60
|
+
### 2. Entrevista única (3 perguntas)
|
|
61
|
+
|
|
62
|
+
Se `.config.json` não existe, conduza a entrevista. Padrão de menu Reversa: opção com label e descrição, sempre uma opção "Outro" no fim para casos não previstos.
|
|
63
|
+
|
|
64
|
+
**Pergunta 1, perfil de leitor:**
|
|
65
|
+
|
|
66
|
+
> "[Nome], pra quem é esse mini-site?
|
|
67
|
+
>
|
|
68
|
+
> 1. **Novo dev entrando** — Quer entender a arquitetura e os módulos rápido pra começar a contribuir.
|
|
69
|
+
> 2. **Stakeholder não-técnico** — Quer ver escopo, histórico e estado do sistema sem ler código.
|
|
70
|
+
> 3. **Time externo auditando** — Consultoria, segurança ou conformidade. Quer densidade, métricas e evidências.
|
|
71
|
+
> 4. **Outro** — Descreva em uma frase.
|
|
72
|
+
>
|
|
73
|
+
> Digite 1, 2, 3 ou 4."
|
|
74
|
+
|
|
75
|
+
**Pergunta 2, profundidade:**
|
|
76
|
+
|
|
77
|
+
> "Qual profundidade você quer?
|
|
78
|
+
>
|
|
79
|
+
> 1. **Visão geral rápida** — Menos páginas, foco em arquitetura e glossário.
|
|
80
|
+
> 2. **Sistema completo** — Todas as páginas, padrão recomendado.
|
|
81
|
+
> 3. **Só features X, Y, Z** — Você escolhe quais specs viram página detalhada. Lista atual: [listar `_reversa_sdd/*/` encontrados].
|
|
82
|
+
> 4. **Outro** — Descreva.
|
|
83
|
+
>
|
|
84
|
+
> Digite 1, 2, 3 ou 4."
|
|
85
|
+
|
|
86
|
+
**Pergunta 3, estilo visual:**
|
|
87
|
+
|
|
88
|
+
> "Qual estilo visual?
|
|
89
|
+
>
|
|
90
|
+
> 1. **Sóbrio técnico** — Cinza, alto contraste, foco no conteúdo. Padrão.
|
|
91
|
+
> 2. **Premium cinematográfico** — Tons escuros, tipografia ampla, hero animado.
|
|
92
|
+
> 3. **Denso com dados** — Layout compacto, prioriza tabelas e gráficos.
|
|
93
|
+
> 4. **Exploratório com 3D destacado** — Code City em destaque, paleta vibrante.
|
|
94
|
+
> 5. **Outro** — Descreva.
|
|
95
|
+
>
|
|
96
|
+
> Digite 1, 2, 3, 4 ou 5."
|
|
97
|
+
|
|
98
|
+
Persista as respostas em `_reversa_docs/.config.json` seguindo o schema definido em `references/config-schema.json`.
|
|
99
|
+
|
|
100
|
+
### 3. Seed determinístico
|
|
101
|
+
|
|
102
|
+
Calcule sha256 de `.reversa/soul.md` se existir, senão do nome do projeto. Registre em `.config.json` no campo `seed.hash`. Esse seed é usado pelos agentes para reprodutibilidade visual (selo, força do D3, distribuição do Code City).
|
|
103
|
+
|
|
104
|
+
Override aceito via flag `--seed=<valor>` no comando.
|
|
105
|
+
|
|
106
|
+
### 4. Plano resumido
|
|
107
|
+
|
|
108
|
+
Antes de invocar os agentes, apresente ao usuário o plano:
|
|
109
|
+
|
|
110
|
+
> "[Nome], com base no que detectei, o plano é:
|
|
111
|
+
>
|
|
112
|
+
> **Mapper**: arquitetura.html, modulos.html[, topologia.html se topologia detectada]
|
|
113
|
+
> **Analyst**: metricas.html[, timeline.html se chronicle existe]
|
|
114
|
+
> **Storyteller**: glossario.html[, deck.html, features/* se specs existem]
|
|
115
|
+
> **Publisher**: index.html + selo + auto-discovery
|
|
116
|
+
>
|
|
117
|
+
> Omissões esperadas: [lista das páginas que serão omitidas e por quê]
|
|
118
|
+
>
|
|
119
|
+
> Tempo estimado: ~60 a 90 segundos.
|
|
120
|
+
>
|
|
121
|
+
> Digite **CONTINUAR** para iniciar o Mapper, ou **cancelar** para abortar."
|
|
122
|
+
|
|
123
|
+
### 5. Execução sequencial dos 4 agentes
|
|
124
|
+
|
|
125
|
+
**Fase 0 (vendor bundle), antes do Mapper**: garanta que `assets/vendor/` está populado executando o procedimento de bundle vendor descrito no Passo 0 do Publisher (`agents/reversa-docs-publisher/SKILL.md`). Isso baixa Three.js, OrbitControls, D3, Highcharts e módulos via `agents/reversa-docs-publisher/references/vendor-pins.yaml` com retry de CDN. As páginas que o Mapper, Analyst e Storyteller geram referenciam essas libs locais via `<script src="assets/vendor/...">`; se as libs não estiverem no disco quando o usuário abrir, as páginas quebram.
|
|
126
|
+
|
|
127
|
+
Em modo isolado (usuário chamou `/reversa-docs-mapper` sem orquestrador), o agente isolado deve executar o mesmo Passo 0 do Publisher como preâmbulo do próprio processo, se `assets/vendor/` estiver vazio.
|
|
128
|
+
|
|
129
|
+
Depois do vendor bundle, execute em sequência **Mapper → Analyst → Storyteller → Publisher**.
|
|
130
|
+
|
|
131
|
+
Para cada agente na sequência:
|
|
132
|
+
|
|
133
|
+
1. Informe: "Iniciando o **[Agente]**, [o que ele vai fazer]."
|
|
134
|
+
2. Leia o `SKILL.md` do agente `reversa-docs-<nome>` correspondente (pasta irmã, no mesmo diretório de skills) na íntegra e execute no contexto atual, passando o `.config.json` como entrada.
|
|
135
|
+
3. Após conclusão, atualize `_reversa_docs/.state.json`: adicione o agente ao array `completedAgents`, registre as páginas geradas em `pages`, calcule hash sha256 de cada página.
|
|
136
|
+
4. Apresente resumo:
|
|
137
|
+
|
|
138
|
+
> "**[Agente]** concluído.
|
|
139
|
+
>
|
|
140
|
+
> Páginas geradas: [lista]
|
|
141
|
+
> Omissões: [lista com razão]
|
|
142
|
+
>
|
|
143
|
+
> Próximo: **[Agente]** vai [o que vai fazer].
|
|
144
|
+
>
|
|
145
|
+
> Digite **CONTINUAR** para prosseguir, ou **cancelar** para parar aqui."
|
|
146
|
+
|
|
147
|
+
Se o usuário digitar `cancelar`, salve o estado atual em `.state.json` (com `pendingAgents` populado) e termine. As páginas já geradas ficam preservadas.
|
|
148
|
+
|
|
149
|
+
### 6. Resumo final (após Publisher)
|
|
150
|
+
|
|
151
|
+
> "[Nome], o mini-site está pronto.
|
|
152
|
+
>
|
|
153
|
+
> Caminho: `_reversa_docs/index.html`
|
|
154
|
+
> Total de páginas: [N]
|
|
155
|
+
> Páginas omitidas: [N]
|
|
156
|
+
> HTMLs auxiliares descobertos pelo Publisher: [N]
|
|
157
|
+
> Tempo total do pipeline: [X]s
|
|
158
|
+
> Smoke test: [verde / FALHOU: lista de páginas com problema]
|
|
159
|
+
>
|
|
160
|
+
> Como abrir:
|
|
161
|
+
> - **Duplo clique funciona**: o Publisher embedou dados em `assets/js/data.js` e baixou Three.js, D3 e Highcharts em `assets/vendor/`. Não precisa de servidor para abrir.
|
|
162
|
+
> - Windows: `start _reversa_docs/index.html`
|
|
163
|
+
> - macOS: `open _reversa_docs/index.html`
|
|
164
|
+
> - Linux: `xdg-open _reversa_docs/index.html`
|
|
165
|
+
> - **Para hot-reload durante edição**: `python -m http.server 8080` na pasta `_reversa_docs/` e acesse `http://localhost:8080/`.
|
|
166
|
+
>
|
|
167
|
+
> Próximo agente sugerido: [contextual: `/reversa-forward` se há specs, `/reversa-chronicler` se não há crônica recente, etc.]
|
|
168
|
+
>
|
|
169
|
+
> Digite **CONTINUAR** para prosseguir, ou apenas feche para sair."
|
|
170
|
+
|
|
171
|
+
## Flag `--auto`
|
|
172
|
+
|
|
173
|
+
Quando o usuário invocar `/reversa-docs --auto`:
|
|
174
|
+
- Pula a entrevista, aplica defaults: `readerProfile=novo_dev`, `depth=full`, `visualStyle=sober`.
|
|
175
|
+
- Pula todos os handoffs `CONTINUAR`, executa os 4 agentes em sequência sem pausas.
|
|
176
|
+
- Mostra apenas o resumo final.
|
|
177
|
+
|
|
178
|
+
## Regeneração
|
|
179
|
+
|
|
180
|
+
Se `_reversa_docs/.state.json` já existe (segunda execução), apresente:
|
|
181
|
+
|
|
182
|
+
> "[Nome], já existe um mini-site em `_reversa_docs/` gerado em [data do `lastCheckpoint`]. O que você quer fazer?
|
|
183
|
+
>
|
|
184
|
+
> 1. **Manter tudo** — Sair sem regenerar.
|
|
185
|
+
> 2. **Regenerar tudo** — Backup do atual em `.backup-<timestamp>/` e refazer do zero.
|
|
186
|
+
> 3. **Regenerar apenas <agente>** — Backup e refazer só as páginas de um agente. [listar agentes: Mapper, Analyst, Storyteller, Publisher]
|
|
187
|
+
> 4. **Regenerar apenas <página>** — Backup e refazer uma página específica. [listar páginas existentes]
|
|
188
|
+
> 5. **Refazer a entrevista** — Mantém páginas atuais, mas recoleta respostas para próxima regeneração.
|
|
189
|
+
> 6. **Outro** — Descreva.
|
|
190
|
+
>
|
|
191
|
+
> Digite 1, 2, 3, 4, 5 ou 6."
|
|
192
|
+
|
|
193
|
+
Backup automático em `_reversa_docs/.backup-<YYYYMMDD-HHMMSS>/` antes de qualquer escrita destrutiva.
|
|
194
|
+
|
|
195
|
+
## Telemetria local
|
|
196
|
+
|
|
197
|
+
Ao final do pipeline (sucesso ou falha parcial), grave em `_reversa_docs/.state.json`:
|
|
198
|
+
- `pipelineDurationMs` (int)
|
|
199
|
+
- `pagesGenerated` (array)
|
|
200
|
+
- `pagesOmitted` (array de `{page, reason}`)
|
|
201
|
+
- `auxiliaryHtmlsDiscovered` (int)
|
|
202
|
+
- `cdnFallbackUsed` (boolean)
|
|
203
|
+
|
|
204
|
+
Nenhuma coleta remota. Tudo fica no projeto do usuário.
|
|
205
|
+
|
|
206
|
+
## Estouro de contexto
|
|
207
|
+
|
|
208
|
+
Se o contexto estiver se esgotando entre agentes:
|
|
209
|
+
1. Salve `.state.json` com `pendingAgents` populado.
|
|
210
|
+
2. Diga: "[Nome], vou pausar entre agentes. Tudo salvo. Digite `/reversa-docs` em uma nova sessão para continuar."
|
|
211
|
+
|
|
212
|
+
## Regras absolutas
|
|
213
|
+
|
|
214
|
+
- Nunca escreva fora de `_reversa_docs/`.
|
|
215
|
+
- Nunca modifique artefatos do core (`_reversa_sdd/`, `.reversa/soul.md`, `.reversa/chronicle.md`).
|
|
216
|
+
- Nunca apague ou sobrescreva sem backup automático em `.backup-<timestamp>/`.
|
|
217
|
+
- Nunca rode varredura de credenciais no código do projeto. Se identificar pista de credencial, ignore e não cite.
|
|
218
|
+
- Nunca avance entre agentes sem `CONTINUAR` do usuário (exceto em `--auto`).
|
|
219
|
+
- Todo texto exibido ao usuário em pt-br, sem travessão.
|
|
220
|
+
|
|
221
|
+
## Invariantes técnicas do mini-site (para todos os 4 agentes do time)
|
|
222
|
+
|
|
223
|
+
Essas invariantes valem para Mapper, Analyst, Storyteller e Publisher. O Publisher é o guardião final, mas qualquer agente que violar quebra a invariante:
|
|
224
|
+
|
|
225
|
+
1. **Funciona via `file://`**: usuário abre `index.html` com duplo clique e tudo funciona. Nenhuma página faz `fetch()` para arquivos locais (CORS bloqueia origin `null`). Dados vêm de `window.RV_DATA.<chave>`, injetado pelo `assets/js/data.js` que o Publisher gera no passo 3.
|
|
226
|
+
2. **Funciona offline**: nenhuma página tem `<script src="https://...">` para CDN. Libs externas (Three.js, D3, Highcharts, OrbitControls e módulos) ficam em `assets/vendor/`, baixadas pelo Publisher via `agents/reversa-docs-publisher/references/vendor-pins.yaml`.
|
|
227
|
+
3. **Nav reflete `pagesGenerated`**: o `<!-- NAV_LINKS -->` do `viewer.html` é preenchido pelo Publisher no passo 4, lendo `.state.json.pagesGenerated`. Páginas omitidas não aparecem no nav. Mapper, Analyst e Storyteller **deixam o marcador como está**, sem preencher hardcoded.
|
|
228
|
+
4. **Smoke test no Publisher**: o Publisher faz teste real de carregamento (http.server + GET + grep de padrões de erro) antes de declarar sucesso. Falha aparece em destaque no resumo final.
|
|
229
|
+
5. **Scripts Python emitidos sempre começam com preâmbulo de encoding** para evitar `UnicodeEncodeError` em Windows com Python 3.12+ default cp1252:
|
|
230
|
+
|
|
231
|
+
```python
|
|
232
|
+
import sys
|
|
233
|
+
if sys.platform == "win32":
|
|
234
|
+
try:
|
|
235
|
+
sys.stdout.reconfigure(encoding="utf-8", errors="replace")
|
|
236
|
+
sys.stderr.reconfigure(encoding="utf-8", errors="replace")
|
|
237
|
+
except AttributeError:
|
|
238
|
+
pass
|
|
239
|
+
```
|
|
240
|
+
|
|
241
|
+
Alternativa: usar apenas ASCII em prints. Ambos aceitos.
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3
|
+
"title": "Reversa Docs Config",
|
|
4
|
+
"description": "Configuração persistida em _reversa_docs/.config.json após a entrevista do /reversa-docs. Reusada por execuções subsequentes e por agentes isolados.",
|
|
5
|
+
"type": "object",
|
|
6
|
+
"required": ["schemaVersion", "generatedAt", "projectName", "interview", "seed", "knowledgeSources"],
|
|
7
|
+
"properties": {
|
|
8
|
+
"schemaVersion": {
|
|
9
|
+
"type": "integer",
|
|
10
|
+
"const": 1,
|
|
11
|
+
"description": "Versão do schema. Incrementar quando houver breaking change."
|
|
12
|
+
},
|
|
13
|
+
"generatedAt": {
|
|
14
|
+
"type": "string",
|
|
15
|
+
"format": "date-time",
|
|
16
|
+
"description": "ISO-8601 do momento em que a entrevista foi conduzida."
|
|
17
|
+
},
|
|
18
|
+
"reversa": {
|
|
19
|
+
"type": "object",
|
|
20
|
+
"properties": {
|
|
21
|
+
"version": { "type": "string" }
|
|
22
|
+
}
|
|
23
|
+
},
|
|
24
|
+
"projectName": {
|
|
25
|
+
"type": "string",
|
|
26
|
+
"description": "Nome do projeto. Vem do soul.md se houver, senão do nome da pasta raiz."
|
|
27
|
+
},
|
|
28
|
+
"interview": {
|
|
29
|
+
"type": "object",
|
|
30
|
+
"required": ["readerProfile", "depth", "visualStyle"],
|
|
31
|
+
"properties": {
|
|
32
|
+
"readerProfile": {
|
|
33
|
+
"type": "string",
|
|
34
|
+
"enum": ["novo_dev", "stakeholder", "auditor", "other"]
|
|
35
|
+
},
|
|
36
|
+
"readerProfileFreeform": {
|
|
37
|
+
"type": "string",
|
|
38
|
+
"description": "Texto livre quando readerProfile = other."
|
|
39
|
+
},
|
|
40
|
+
"depth": {
|
|
41
|
+
"type": "string",
|
|
42
|
+
"enum": ["overview", "full", "features_selection", "other"]
|
|
43
|
+
},
|
|
44
|
+
"depthFreeform": {
|
|
45
|
+
"type": "string"
|
|
46
|
+
},
|
|
47
|
+
"selectedFeatures": {
|
|
48
|
+
"type": "array",
|
|
49
|
+
"items": { "type": "string" },
|
|
50
|
+
"description": "IDs das specs escolhidas quando depth = features_selection."
|
|
51
|
+
},
|
|
52
|
+
"visualStyle": {
|
|
53
|
+
"type": "string",
|
|
54
|
+
"enum": ["sober", "premium", "dense", "exploratory", "other"]
|
|
55
|
+
},
|
|
56
|
+
"visualStyleFreeform": {
|
|
57
|
+
"type": "string"
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
},
|
|
61
|
+
"seed": {
|
|
62
|
+
"type": "object",
|
|
63
|
+
"required": ["hash", "source"],
|
|
64
|
+
"properties": {
|
|
65
|
+
"hash": {
|
|
66
|
+
"type": "string",
|
|
67
|
+
"pattern": "^sha256:[a-f0-9]{64}$"
|
|
68
|
+
},
|
|
69
|
+
"source": {
|
|
70
|
+
"type": "string",
|
|
71
|
+
"enum": ["soul.md", "project_name"]
|
|
72
|
+
},
|
|
73
|
+
"explicitOverride": {
|
|
74
|
+
"type": ["string", "null"],
|
|
75
|
+
"description": "Valor passado via --seed=<valor>, sobrescreve hash calculado."
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
},
|
|
79
|
+
"knowledgeSources": {
|
|
80
|
+
"type": "object",
|
|
81
|
+
"properties": {
|
|
82
|
+
"soul": { "type": "boolean" },
|
|
83
|
+
"chronicle": { "type": "boolean" },
|
|
84
|
+
"topology": { "type": "boolean" },
|
|
85
|
+
"sddSpecs": {
|
|
86
|
+
"type": "array",
|
|
87
|
+
"items": { "type": "string" }
|
|
88
|
+
},
|
|
89
|
+
"sourceCode": { "type": "boolean" }
|
|
90
|
+
}
|
|
91
|
+
},
|
|
92
|
+
"pagesPlanned": {
|
|
93
|
+
"type": "array",
|
|
94
|
+
"items": { "type": "string" },
|
|
95
|
+
"description": "Paths relativos das páginas que serão geradas, decidido após a entrevista."
|
|
96
|
+
},
|
|
97
|
+
"pagesOmitted": {
|
|
98
|
+
"type": "array",
|
|
99
|
+
"items": {
|
|
100
|
+
"type": "object",
|
|
101
|
+
"properties": {
|
|
102
|
+
"page": { "type": "string" },
|
|
103
|
+
"reason": { "type": "string" }
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# Fontes esperadas pelo Time Reversa Docs
|
|
2
|
+
# Cada item declara um artefato do core do Reversa que, se presente, alimenta uma ou mais páginas do mini-site.
|
|
3
|
+
# Ausência nunca bloqueia: páginas dependentes da fonte são omitidas graciosamente.
|
|
4
|
+
|
|
5
|
+
sources:
|
|
6
|
+
- id: soul
|
|
7
|
+
path: ".reversa/soul.md"
|
|
8
|
+
producer: "reversa-extract-soul"
|
|
9
|
+
consumed_by:
|
|
10
|
+
- "Storyteller (glossario.html, deck.html)"
|
|
11
|
+
- "Publisher (seed sha256, hero)"
|
|
12
|
+
required_for:
|
|
13
|
+
- "glossario.html"
|
|
14
|
+
- "deck.html (parcialmente)"
|
|
15
|
+
description: "Síntese executiva do projeto. Origem do glossário e do título do hero."
|
|
16
|
+
|
|
17
|
+
- id: chronicle
|
|
18
|
+
path: ".reversa/chronicle.md"
|
|
19
|
+
producer: "reversa-chronicler"
|
|
20
|
+
consumed_by:
|
|
21
|
+
- "Analyst (timeline.html)"
|
|
22
|
+
required_for:
|
|
23
|
+
- "timeline.html"
|
|
24
|
+
description: "Histórico de eventos, releases e incidentes. Origem da timeline interativa."
|
|
25
|
+
|
|
26
|
+
- id: topology
|
|
27
|
+
path: "_reversa_sdd/architecture.md"
|
|
28
|
+
producer: "reversa-architect"
|
|
29
|
+
consumed_by:
|
|
30
|
+
- "Mapper (topologia.html)"
|
|
31
|
+
required_for:
|
|
32
|
+
- "topologia.html"
|
|
33
|
+
description: "Topologia detectada (legado vs moderno vs híbrido). Origem da página side-by-side."
|
|
34
|
+
optional: true
|
|
35
|
+
|
|
36
|
+
- id: sdd_specs
|
|
37
|
+
path: "_reversa_sdd/"
|
|
38
|
+
pattern: "*/requirements.md"
|
|
39
|
+
producer: "reversa-writer"
|
|
40
|
+
consumed_by:
|
|
41
|
+
- "Storyteller (features/*.html)"
|
|
42
|
+
required_for:
|
|
43
|
+
- "features/<spec>.html (uma página por spec)"
|
|
44
|
+
description: "Specs SDD por feature. Cada subpasta com requirements.md vira uma página detalhada."
|
|
45
|
+
|
|
46
|
+
- id: source_code
|
|
47
|
+
path: "."
|
|
48
|
+
pattern: "(arquivos do projeto legado)"
|
|
49
|
+
producer: "(humano + git)"
|
|
50
|
+
consumed_by:
|
|
51
|
+
- "Mapper (arquitetura.html, modulos.html, modules.json, deps.json)"
|
|
52
|
+
- "Analyst (metricas.html via modules.json)"
|
|
53
|
+
required_for:
|
|
54
|
+
- "arquitetura.html"
|
|
55
|
+
- "modulos.html"
|
|
56
|
+
- "metricas.html"
|
|
57
|
+
description: "Código fonte do projeto legado. Origem das métricas de LOC, complexidade e dependências."
|
|
58
|
+
extraction_scripts:
|
|
59
|
+
- "extract_modules.py"
|
|
60
|
+
- "extract_deps.py"
|