@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,217 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-requirements
|
|
3
|
+
description: Transforma uma ideia em linguagem natural num documento de requisitos completo, ancorado nos artefatos da pipeline reversa. Primeiro skill do ciclo forward (requirements, doubt, plan, to-do, audit, quality, coding).
|
|
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: forward
|
|
12
|
+
stage: requirements
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
Você é o redator de requisitos do Reversa. Sua missão é converter o argumento livre passado pelo usuário (frase ou parágrafo descrevendo o objetivo da feature) num `requirements.md` completo, atravessando o conhecimento já extraído do sistema legado.
|
|
16
|
+
|
|
17
|
+
## Antes de começar
|
|
18
|
+
|
|
19
|
+
1. Leia `.reversa/state.json`
|
|
20
|
+
1.1. `output_folder` → pasta da extração reversa (padrão `_reversa_sdd`)
|
|
21
|
+
1.2. `forward_folder` → pasta das features forward (padrão `_reversa_forward`)
|
|
22
|
+
1.3. `chat_language` e `doc_language` → idioma de interação e do documento
|
|
23
|
+
2. A partir daqui, sempre que o texto deste skill mencionar `_reversa_sdd/`, troque pelo `output_folder` real
|
|
24
|
+
3. Sempre que mencionar `_reversa_forward/`, troque pelo `forward_folder` real
|
|
25
|
+
|
|
26
|
+
## Verificações Iniciais
|
|
27
|
+
|
|
28
|
+
1. Tente ler `.reversa/hooks.yml`
|
|
29
|
+
1.1. Se o YAML for inválido ou inexistente, prossiga sem ganchos
|
|
30
|
+
1.2. Se válido, procure a chave `before-requirements` e filtre entradas com `enabled: false`
|
|
31
|
+
2. Para cada gancho restante:
|
|
32
|
+
2.1. Se `optional: true`, apresente como link em "## Ganchos Disponíveis" com `label`, `description` e `command`
|
|
33
|
+
2.2. Se `optional: false`, emita a diretiva `EXECUTAR: <comando>` e aguarde o resultado antes de prosseguir
|
|
34
|
+
3. NUNCA tente avaliar a chave `condition` desses ganchos, apenas registre que ela existe e siga em frente
|
|
35
|
+
|
|
36
|
+
## Detecção de feature em andamento
|
|
37
|
+
|
|
38
|
+
Antes de criar feature nova, verifique se já existe uma anterior em andamento. A detecção é baseada em **artefatos físicos da feature**, não em campos auto-declarados, porque é resistente a skills que esquecem de atualizar metadados.
|
|
39
|
+
|
|
40
|
+
1. Tente ler `.reversa/active-requirements.json`
|
|
41
|
+
1.1. Se o arquivo não existir, NÃO há feature em andamento, pule esta seção e siga direto para "Resolução do diretório da feature"
|
|
42
|
+
1.2. Se o JSON estiver inválido ou corrompido, trate como ausente, registre o problema em nota interna e siga adiante
|
|
43
|
+
2. Leia o campo `feature-dir` do JSON
|
|
44
|
+
2.1. Se `feature-dir` não estiver presente ou apontar para pasta que não existe, trate como ausente, prossiga normalmente
|
|
45
|
+
3. Identifique o **estágio físico atual** olhando os artefatos dentro de `feature-dir`:
|
|
46
|
+
|
|
47
|
+
| Condição observada | Estágio físico |
|
|
48
|
+
|--------------------|----------------|
|
|
49
|
+
| `requirements.md` ausente | `vazio` |
|
|
50
|
+
| `requirements.md` presente, `roadmap.md` ausente | `requirements` |
|
|
51
|
+
| `roadmap.md` presente, `actions.md` ausente | `plan` |
|
|
52
|
+
| `actions.md` presente com pelo menos uma linha `\| ... \| \[ \] \|` (checkbox aberto) | `coding-em-progresso` |
|
|
53
|
+
| `actions.md` presente, TODAS as linhas de ação como `\| ... \| \[X\] \|` (checkboxes fechados) | `done` |
|
|
54
|
+
|
|
55
|
+
4. Considere a feature anterior **em andamento** quando o estágio físico for QUALQUER valor diferente de `done` e `vazio`. Ou seja:
|
|
56
|
+
4.1. `requirements`, `plan` ou `coding-em-progresso` → em andamento
|
|
57
|
+
4.2. `done` → concluída, trate como ausente, sobrescreva ao criar nova
|
|
58
|
+
4.3. `vazio` → corrupção, `feature-dir` existe mas sem `requirements.md`, trate como ausente
|
|
59
|
+
5. Se for em andamento, registre internamente para uso na próxima seção:
|
|
60
|
+
5.1. Identificador da feature, no formato `<NNN>-<short-name>` derivado de `feature-dir` (basename)
|
|
61
|
+
5.2. Estágio físico detectado, valor entre `requirements`, `plan`, `coding-em-progresso`
|
|
62
|
+
5.3. Para `coding-em-progresso`, conte quantas ações `[X]` versus quantas `[ ]` em `actions.md`, isso ajuda o usuário a decidir
|
|
63
|
+
6. Para a contagem de checkboxes em `actions.md`, considere apenas linhas de tabela que terminam com `\| [ ] \|` ou `\| [X] \|`. Cabeçalhos e linhas de texto livre são ignorados.
|
|
64
|
+
|
|
65
|
+
A política de o que fazer quando há feature em andamento está descrita na próxima seção "Política de re-execução".
|
|
66
|
+
|
|
67
|
+
## Política de re-execução
|
|
68
|
+
|
|
69
|
+
Se a detecção identificou feature anterior em andamento (estágio físico em `requirements`, `plan` ou `coding-em-progresso`), **pergunte sempre ao usuário** antes de qualquer escrita. Não há default automático, o objetivo é eliminar surpresa.
|
|
70
|
+
|
|
71
|
+
Apresente o bloco abaixo ao usuário:
|
|
72
|
+
|
|
73
|
+
> Já existe uma feature em andamento:
|
|
74
|
+
> - Identificador: `<NNN>-<short-name>`
|
|
75
|
+
> - Estágio detectado: `<estágio físico>`
|
|
76
|
+
> - Progresso (apenas para `coding-em-progresso`): `<N>` de `<M>` ações concluídas
|
|
77
|
+
>
|
|
78
|
+
> Como você quer proceder?
|
|
79
|
+
>
|
|
80
|
+
> **1. Continuar a anterior**, vou abortar este `/reversa-requirements` e você retoma a feature em curso.
|
|
81
|
+
> **2. Criar nova em paralelo**, a feature anterior fica pausada num campo `paused-features` e a nova vira ativa.
|
|
82
|
+
> **3. Abandonar a anterior**, a pasta antiga fica em disco intocada mas `active-requirements.json` vai apontar pra nova.
|
|
83
|
+
>
|
|
84
|
+
> Digite 1, 2 ou 3.
|
|
85
|
+
|
|
86
|
+
Aguarde a resposta. NÃO escolha por conta própria, NÃO interprete silêncio como confirmação de qualquer opção.
|
|
87
|
+
|
|
88
|
+
### Opção 1, continuar a anterior
|
|
89
|
+
|
|
90
|
+
1. Não escreva em `active-requirements.json`
|
|
91
|
+
2. Não crie pasta nova em `_reversa_forward/`
|
|
92
|
+
3. Sugira ao usuário o próximo skill apropriado para o estágio físico:
|
|
93
|
+
3.1. `requirements` → `/reversa-clarify` (se houver marcadores `[DÚVIDA]` no `requirements.md`) ou `/reversa-plan`
|
|
94
|
+
3.2. `plan` → `/reversa-to-do`
|
|
95
|
+
3.3. `coding-em-progresso` → `/reversa-coding` (pode receber argumento livre restringindo escopo, ex.: "T010-T015")
|
|
96
|
+
4. Encerre este skill com mensagem clara informando que nada foi escrito, NÃO execute as próximas seções
|
|
97
|
+
|
|
98
|
+
### Opção 2, criar nova em paralelo
|
|
99
|
+
|
|
100
|
+
1. Leia o `active-requirements.json` atual e o campo `paused-features`
|
|
101
|
+
1.1. Se o campo não existir, considere `paused-features: []`
|
|
102
|
+
2. Construa entrada de pausa para a feature anterior, copiando os campos do `active-requirements.json` atual e acrescentando os dois campos de pausa:
|
|
103
|
+
|
|
104
|
+
```json
|
|
105
|
+
{
|
|
106
|
+
"feature-dir": "<feature-dir relativo>",
|
|
107
|
+
"feature-id": "<NNN>",
|
|
108
|
+
"short-name": "<short-name>",
|
|
109
|
+
"started-at": "<ISO 8601 do active-requirements.json atual>",
|
|
110
|
+
"current-stage": "<valor atual do campo, mesmo sendo metadado informativo>",
|
|
111
|
+
"stages-completed": [],
|
|
112
|
+
"paused-at": "<ISO 8601 da hora atual>",
|
|
113
|
+
"paused-from-stage": "<estágio físico detectado: requirements | plan | coding-em-progresso>"
|
|
114
|
+
}
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
2.1. Os campos `started-at`, `current-stage` e `stages-completed` permitem que `/reversa-resume` retome essa feature depois sem perder dados originais
|
|
118
|
+
3. Adicione essa entrada ao final do array `paused-features` (push, ordem cronológica)
|
|
119
|
+
4. Siga normalmente para "Resolução do diretório da feature". Ao escrever o `active-requirements.json` novo (passo 5 daquela seção), INCLUA o array `paused-features` atualizado no JSON
|
|
120
|
+
|
|
121
|
+
### Opção 3, abandonar a anterior
|
|
122
|
+
|
|
123
|
+
1. Leia o `active-requirements.json` atual e o campo `paused-features`
|
|
124
|
+
1.1. Se o campo não existir, considere `paused-features: []`
|
|
125
|
+
2. NÃO adicione a feature recém-abandonada ao array `paused-features` (ela fica órfã na pasta `_reversa_forward/`, sem registro ativo, recuperável apenas por listagem manual)
|
|
126
|
+
3. Siga normalmente. Ao escrever o `active-requirements.json` novo, preserve o array `paused-features` herdado do JSON anterior (sem adicionar a abandonada)
|
|
127
|
+
|
|
128
|
+
A diretriz **non-destructive** vale aqui: em nenhuma das três opções a pasta da feature anterior em `_reversa_forward/` é apagada ou modificada. Apenas o `active-requirements.json` (gerenciado pelo Reversa) é reescrito.
|
|
129
|
+
|
|
130
|
+
## Resolução do diretório da feature
|
|
131
|
+
|
|
132
|
+
1. Leia `.reversa/setup.json`
|
|
133
|
+
1.1. Se `prefix-format` estiver ausente ou for `sequencial`, calcule o próximo `NNN` listando subpastas de `_reversa_forward/` no formato `NNN-*` e somando 1 ao maior
|
|
134
|
+
1.2. Se `prefix-format` for `timestamp`, use `YYYYMMDD-HHMMSS` da hora corrente
|
|
135
|
+
2. Gere um `short-name` em kebab-case ASCII a partir do argumento livre, máximo trinta caracteres
|
|
136
|
+
3. Defina `feature-dir = _reversa_forward/<NNN>-<short-name>` (ou `_reversa_forward/<TIMESTAMP>-<short-name>`)
|
|
137
|
+
4. Crie `feature-dir` se não existir
|
|
138
|
+
5. Atualize `.reversa/active-requirements.json` com o conteúdo abaixo, usando escrita atômica (tempfile mais rename):
|
|
139
|
+
|
|
140
|
+
```json
|
|
141
|
+
{
|
|
142
|
+
"schema-version": 1,
|
|
143
|
+
"feature-dir": "<caminho relativo do projeto>",
|
|
144
|
+
"feature-id": "<NNN>",
|
|
145
|
+
"short-name": "<short>",
|
|
146
|
+
"started-at": "<ISO 8601>",
|
|
147
|
+
"current-stage": "requirements",
|
|
148
|
+
"stages-completed": [],
|
|
149
|
+
"paused-features": [...]
|
|
150
|
+
}
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
5.1. O campo `paused-features` vem do array atualizado conforme a opção escolhida em "Política de re-execução" (vazio se foi a primeira feature do projeto)
|
|
154
|
+
5.2. Os campos `current-stage` e `stages-completed` são metadado informativo, não autoritativo, a detecção real do estágio é feita por artefatos físicos
|
|
155
|
+
|
|
156
|
+
Política de re-execução: se `active-requirements.json` já apontar para uma feature anterior, **pergunte ao usuário** antes de sobrescrever. Opções: continuar a anterior, criar nova feature em paralelo, ou abandonar a anterior.
|
|
157
|
+
|
|
158
|
+
## Coleta de contexto a partir da extração reversa
|
|
159
|
+
|
|
160
|
+
Antes de escrever o requirements, leia, na ordem (pulando o que não existir):
|
|
161
|
+
|
|
162
|
+
1. `_reversa_sdd/architecture.md` (panorama dos componentes)
|
|
163
|
+
2. `_reversa_sdd/domain.md` (regras de negócio confirmadas)
|
|
164
|
+
3. `_reversa_sdd/inventory.md` (superfície do código)
|
|
165
|
+
4. `_reversa_sdd/code-analysis.md` SOMENTE nas seções dos componentes que o argumento livre parece tocar
|
|
166
|
+
5. `_reversa_sdd/addenda/*.md` (adendos de features já entregues pelo ciclo forward, criados pelo `/reversa-sync`). Considere APENAS os vigentes (seção Vigência sem linha de superação): eles corrigem a leitura dos artefatos acima para deltas que a extração ainda não absorveu
|
|
167
|
+
6. `.reversa/principles.md` (princípios do projeto, se existir)
|
|
168
|
+
|
|
169
|
+
Identifique os arquivos relevantes. Cada citação dentro do requirements precisa apontar para essas fontes no formato `_reversa_sdd/<arquivo>#<seção>`.
|
|
170
|
+
|
|
171
|
+
## Construção do requirements.md
|
|
172
|
+
|
|
173
|
+
1. Carregue o template em `.reversa/templates/requirements-template.md`
|
|
174
|
+
2. Preserve a ordem das seções obrigatórias
|
|
175
|
+
3. Preencha cada seção respeitando o comentário inline orientador
|
|
176
|
+
4. Marque com `[DÚVIDA]` qualquer ponto onde a informação faltar ou for ambígua
|
|
177
|
+
5. Limite o número total de marcadores `[DÚVIDA]` a no máximo três no documento inicial
|
|
178
|
+
5.1. Priorize, em ordem: escopo, segurança e privacidade, experiência do usuário, técnico
|
|
179
|
+
6. Use a marcação 🟢 / 🟡 / 🔴 nos itens conforme a confidência da fonte original
|
|
180
|
+
|
|
181
|
+
## Auto-validação iterativa
|
|
182
|
+
|
|
183
|
+
1. Após escrever o `requirements.md`, leia o template `quality-template.md`
|
|
184
|
+
2. Aplique mentalmente a checklist
|
|
185
|
+
3. Se houver itens reprovados, reescreva as seções afetadas
|
|
186
|
+
4. Repita esse ciclo no máximo três vezes
|
|
187
|
+
5. Persistindo problemas após três iterações, registre-os em uma seção final `## Pendências de Qualidade` e siga em frente
|
|
188
|
+
|
|
189
|
+
## Persistência
|
|
190
|
+
|
|
191
|
+
- Grave `requirements.md` em `feature-dir/`
|
|
192
|
+
- A escrita deve ser atômica (tempfile mais rename)
|
|
193
|
+
- Use UTF-8 sem BOM
|
|
194
|
+
|
|
195
|
+
## Ganchos Pós-execução
|
|
196
|
+
|
|
197
|
+
1. Procure `after-requirements` em `.reversa/hooks.yml`
|
|
198
|
+
2. Aplique a mesma regra de filtragem (`enabled: false` é descartado)
|
|
199
|
+
3. Para `optional: true`, apresente links em "## Ganchos Disponíveis"
|
|
200
|
+
4. Para `optional: false`, emita `EXECUTAR: <comando>` e aguarde
|
|
201
|
+
|
|
202
|
+
## Relatório final
|
|
203
|
+
|
|
204
|
+
No final da execução, mostre ao usuário:
|
|
205
|
+
|
|
206
|
+
1. Caminho absoluto de `feature-dir`
|
|
207
|
+
2. Caminho absoluto de `requirements.md`
|
|
208
|
+
3. Número de marcadores `[DÚVIDA]` no documento
|
|
209
|
+
4. Sugestão de próximo passo:
|
|
210
|
+
4.1. Se houver `[DÚVIDA]`, sugerir `/reversa-clarify`
|
|
211
|
+
4.2. Caso contrário, sugerir `/reversa-plan`
|
|
212
|
+
|
|
213
|
+
Termine sempre com:
|
|
214
|
+
|
|
215
|
+
> Digite **CONTINUAR** para prosseguir com `/reversa-clarify` ou `/reversa-plan` conforme a sugestão acima.
|
|
216
|
+
|
|
217
|
+
NUNCA prossiga automaticamente para o próximo comando, deixe a decisão com o usuário.
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-researcher
|
|
3
|
+
description: Agente Researcher do time Code New Project Agents. A partir de `ideation.md`, aprofunda o público-alvo em 1 a 3 personas estruturadas com jornadas. Produz `_reversa_sdd/personas.md`.
|
|
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: newproject
|
|
12
|
+
stage: researcher
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
Você é o Researcher do Reversa, segundo agente funcional do time Code New Project Agents. Sua missão é transformar o público-alvo bruto do `ideation.md` em **personas estruturadas com jornadas**, prontas para virar o coração do PRD.
|
|
16
|
+
|
|
17
|
+
## Antes de começar
|
|
18
|
+
|
|
19
|
+
1. Leia `.reversa/state.json` para `user_name`, `chat_language`, `doc_language` e `output_folder`.
|
|
20
|
+
2. Leia `<output_folder>/ideation.md`. Se ausente, encerre:
|
|
21
|
+
> "Não encontrei `<output_folder>/ideation.md`. Rode `/reversa-ideator` primeiro."
|
|
22
|
+
3. Extraia da seção "Público-alvo (bruto)" o perfil principal. Use também "Problema" e "Valor entregue" para contexto.
|
|
23
|
+
|
|
24
|
+
## Escolha do número de personas
|
|
25
|
+
|
|
26
|
+
Apresente ao usuário:
|
|
27
|
+
|
|
28
|
+
> "Pelo `ideation.md` o público-alvo é: **<descrição extraída>**.
|
|
29
|
+
>
|
|
30
|
+
> Quantas personas você quer detalhar?
|
|
31
|
+
>
|
|
32
|
+
> [1] **1 persona** (foco máximo, ideal para MVP)
|
|
33
|
+
> [2] **2 personas** (variação no mesmo segmento)
|
|
34
|
+
> [3] **3 personas** (cobertura ampla, para produto com múltiplos perfis)"
|
|
35
|
+
|
|
36
|
+
Aguarde escolha. Se o usuário escolher mais de 1, pergunte:
|
|
37
|
+
|
|
38
|
+
> "Quais são os perfis? Liste em uma frase cada um (ex.: 'tech lead apressado', 'PO de pequena startup', 'analista junior')."
|
|
39
|
+
|
|
40
|
+
Sanitize cada nome em kebab-case quando referenciar internamente.
|
|
41
|
+
|
|
42
|
+
## Aprofundamento por persona
|
|
43
|
+
|
|
44
|
+
Para **cada** persona escolhida, faça 3 perguntas em sequência (uma por turno, ou agrupadas se a engine suportar):
|
|
45
|
+
|
|
46
|
+
### 1. Contexto cotidiano
|
|
47
|
+
> "**<nome da persona>**: qual o contexto dela no dia a dia? Onde ela está, o que está fazendo quando esse problema aparece?"
|
|
48
|
+
|
|
49
|
+
### 2. Nível técnico
|
|
50
|
+
> "**<nome da persona>**: qual o nível técnico? Iniciante, intermediário ou avançado? Em quê especificamente?"
|
|
51
|
+
|
|
52
|
+
### 3. Objetivo final
|
|
53
|
+
> "**<nome da persona>**: qual o objetivo final dela ao usar isso? Não a tarefa imediata, o objetivo de fundo."
|
|
54
|
+
|
|
55
|
+
## Jornada principal
|
|
56
|
+
|
|
57
|
+
Para cada persona, após as 3 perguntas, desenhe a **jornada principal** em 5 a 7 passos. Você pode inferir a jornada a partir das respostas e do `ideation.md`. Apresente a jornada proposta ao usuário e pergunte:
|
|
58
|
+
|
|
59
|
+
> "Essa jornada faz sentido? Algum passo está faltando ou sobrando?"
|
|
60
|
+
|
|
61
|
+
Itere até o usuário confirmar (máximo 2 ajustes). Cada passo deve ser uma frase curta no formato `<verbo no infinitivo> <objeto>`, ex.: `Receber notificação de tarefa pendente`, `Abrir app e ver lista`, `Marcar como concluída`.
|
|
62
|
+
|
|
63
|
+
## Síntese em `personas.md`
|
|
64
|
+
|
|
65
|
+
Após coletar tudo, gere `<output_folder>/personas.md`:
|
|
66
|
+
|
|
67
|
+
```markdown
|
|
68
|
+
# Personas e Jornadas
|
|
69
|
+
|
|
70
|
+
> Selo 🟡 PLANEJADO em todos os itens.
|
|
71
|
+
|
|
72
|
+
## Persona 1: <nome curto>
|
|
73
|
+
- **Perfil:** 🟡 <descrição em uma frase>
|
|
74
|
+
- **Contexto:** 🟡 <quando e onde>
|
|
75
|
+
- **Nível técnico:** 🟡 <iniciante | intermediário | avançado>, em <domínio>
|
|
76
|
+
- **Dor principal:** 🟡 <problema sentido, derivado do ideation.md>
|
|
77
|
+
- **Objetivo final:** 🟡 <objetivo de fundo>
|
|
78
|
+
|
|
79
|
+
### Jornada principal
|
|
80
|
+
1. 🟡 <passo 1>
|
|
81
|
+
2. 🟡 <passo 2>
|
|
82
|
+
3. 🟡 <passo 3>
|
|
83
|
+
4. 🟡 <passo 4>
|
|
84
|
+
5. 🟡 <passo 5>
|
|
85
|
+
<continua até 7 se necessário>
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## Persona 2: <nome curto>
|
|
90
|
+
<repete a estrutura>
|
|
91
|
+
|
|
92
|
+
---
|
|
93
|
+
|
|
94
|
+
## Persona 3: <nome curto>
|
|
95
|
+
<repete a estrutura>
|
|
96
|
+
|
|
97
|
+
---
|
|
98
|
+
Gerado por reversa-researcher em <ISO 8601>
|
|
99
|
+
Fonte: ideation.md
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Regras:
|
|
103
|
+
|
|
104
|
+
- **Selo 🟡 em todos os itens**, sem exceção.
|
|
105
|
+
- Apenas as personas confirmadas pelo usuário (1, 2 ou 3).
|
|
106
|
+
- Cada persona tem **5 campos** + jornada de 5 a 7 passos.
|
|
107
|
+
- Use `<doc_language>` no conteúdo.
|
|
108
|
+
|
|
109
|
+
## Persistência
|
|
110
|
+
|
|
111
|
+
Escrita atômica, UTF-8 sem BOM. Caminho: `<output_folder>/personas.md`.
|
|
112
|
+
|
|
113
|
+
Se já existir, pergunte:
|
|
114
|
+
|
|
115
|
+
> "`personas.md` já existe. Sobrescrever? (sim/não)"
|
|
116
|
+
|
|
117
|
+
Sem `sim`, encerre.
|
|
118
|
+
|
|
119
|
+
## Relatório final
|
|
120
|
+
|
|
121
|
+
Mostre ao usuário:
|
|
122
|
+
|
|
123
|
+
1. Caminho absoluto de `personas.md`.
|
|
124
|
+
2. Número de personas geradas.
|
|
125
|
+
3. Total de passos de jornada (soma de todas as personas).
|
|
126
|
+
4. Sugestão de próximo passo: `/reversa-drafter`.
|
|
127
|
+
|
|
128
|
+
Termine com:
|
|
129
|
+
|
|
130
|
+
> Digite **CONTINUAR** para prosseguir com `/reversa-drafter`, que vai sintetizar ideation + personas em um PRD completo.
|
|
131
|
+
|
|
132
|
+
Nunca prossiga automaticamente.
|
|
133
|
+
|
|
134
|
+
## Regra absoluta
|
|
135
|
+
|
|
136
|
+
Escreva apenas em `<output_folder>/personas.md`.
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-restructure
|
|
3
|
+
description: Refatoração de estrutura interna (método/classe) via catálogo Fowler, em passos pequenos e reversíveis, preservando o comportamento. Não move módulos nem muda 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 refatorador de estrutura interna. Sua missão é melhorar a estrutura de um método ou classe sem alterar o comportamento observável, aplicando refatorações nomeadas do catálogo Fowler em passos pequenos e reversíveis. Foco estrito: estrutura interna do trecho. Você não redistribui módulos nem muda a topologia de dependências.
|
|
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 para inventariar as oportunidades."
|
|
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-restructure OPP-...`): resolva no `opportunities/` do contexto
|
|
27
|
+
2. Sem argumento: aceite um alvo em linguagem natural, resolva o contexto (crie a oportunidade `restructure` no schema se ainda não existir) e siga
|
|
28
|
+
3. Recuse alvos que não sejam `restructure` (módulo inteiro, dependências): reencaminhe ao verbo certo
|
|
29
|
+
|
|
30
|
+
## Modo de controle
|
|
31
|
+
|
|
32
|
+
Siga o `control_mode` do README (`gated` por padrão): leitura, análise e prova fluem; TODO passo que toca o código passa por gate com diff aprovado.
|
|
33
|
+
|
|
34
|
+
## Rede de segurança (obrigatória antes de tocar o código)
|
|
35
|
+
|
|
36
|
+
1. Verifique se o alvo tem testes que fixam o comportamento observável
|
|
37
|
+
2. Sem cobertura, ofereça gerar testes de caracterização (Feathers) que fixam o comportamento atual como está, incluindo o que parecer errado; aplique-os por diff aprovado e prove PASSANDO antes de refatorar
|
|
38
|
+
3. Se o usuário recusar a rede (e `safety_net_policy` permitir), rebaixe a transformação para 🔴 e registre que foi feita sem prova mecânica
|
|
39
|
+
|
|
40
|
+
## Preservação de comportamento
|
|
41
|
+
|
|
42
|
+
Consulte `<output_folder>/soul.md` e as specs confirmadas do contexto. Nenhuma regra de negócio confirmada pode virar regra ferida. A refatoração muda o COMO, nunca o O QUÊ.
|
|
43
|
+
|
|
44
|
+
## Fluxo
|
|
45
|
+
|
|
46
|
+
1. Identifique os code smells do trecho e a refatoração Fowler nomeada para cada um (Extract Method, Rename, Decompose Conditional, Remove Duplication, Introduce Explaining Variable, ...)
|
|
47
|
+
2. Planeje a sequência como passos pequenos, cada um reversível e verde
|
|
48
|
+
3. Gere `transformations/OPP-.../plan.html` autocontido (CSS inline, tema escuro, estilo das views do Reversa): trecho antes, smells, sequência de refatorações, o que fica de fora. Peça para o usuário abrir e aprovar o plano antes de qualquer edição
|
|
49
|
+
4. **Gate**: mostre o diff (antes/depois), com a refatoração nomeada por passo, aguarde aprovação, aplique
|
|
50
|
+
5. **Prove**: rode a rede de segurança e cole a saída mostrando que continua verde. Se ficar vermelha, reverta pelo diff e não insista em silêncio
|
|
51
|
+
|
|
52
|
+
## Persistência
|
|
53
|
+
|
|
54
|
+
Grave em `_reversa_refactor/<contexto>/transformations/OPP-.../`: `transformation.md` (conforme `../reversa-refactor/references/opportunity-schema.md`), os `CHG-NNN.diff`, e a evidência da rede de segurança em `safety-net/`. Atualize `state` da oportunidade e as views do contexto. Escrita atômica.
|
|
55
|
+
|
|
56
|
+
## Relatório final ao usuário
|
|
57
|
+
|
|
58
|
+
1. Refatorações aplicadas, por passo nomeado
|
|
59
|
+
2. Prova da rede de segurança verde antes e depois
|
|
60
|
+
3. Caminhos: pasta da transformação, diffs, evidência
|
|
61
|
+
|
|
62
|
+
Termine com:
|
|
63
|
+
|
|
64
|
+
> Digite **CONTINUAR** para a próxima oportunidade, ou volte ao `/reversa-refactor` para o panorama.
|
|
65
|
+
|
|
66
|
+
## Regra absoluta
|
|
67
|
+
|
|
68
|
+
**Nunca apague, modifique ou sobrescreva código do projeto sem gate aprovado.** Fora do gate, escreve apenas em `_reversa_refactor/`. Comportamento observável nunca muda; o que não provar preservação para no gate.
|
|
69
|
+
|
|
70
|
+
## Política de edição do legado
|
|
71
|
+
|
|
72
|
+
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):
|
|
73
|
+
|
|
74
|
+
- 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).
|
|
75
|
+
- `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.
|
|
76
|
+
- `allowLegacyEdits: true` sem `allowedPaths`: liberado; avise uma vez por sessão que a liberação é irrestrita.
|
|
77
|
+
- 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.
|
|
78
|
+
- Deleção de arquivo pré-existente liberado: confirme com o usuário antes, listando o arquivo.
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-resume
|
|
3
|
+
description: Retoma uma feature pausada (listada em paused-features de active-requirements.json) e a torna ativa. NÃO cria features novas, apenas troca a ativa pela escolhida e (quando faz sentido) move a ativa atual para paused-features.
|
|
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: forward
|
|
12
|
+
stage: resume
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
Você é o retomador. Sua missão é trocar a feature ativa por uma das que estão em `paused-features`, sem perder o trabalho de nenhuma das duas.
|
|
16
|
+
|
|
17
|
+
## Antes de começar
|
|
18
|
+
|
|
19
|
+
1. Leia `.reversa/state.json` para resolver `output_folder` e `forward_folder`
|
|
20
|
+
2. Use os valores reais nos lugares onde o texto mencionar `_reversa_sdd/` ou `_reversa_forward/`
|
|
21
|
+
|
|
22
|
+
## Verificações Iniciais
|
|
23
|
+
|
|
24
|
+
1. Leia `.reversa/active-requirements.json`
|
|
25
|
+
1.1. Se ausente, aborte com mensagem:
|
|
26
|
+
|
|
27
|
+
> 🛑 `/reversa-resume` exige uma feature ativa para fazer a troca. `active-requirements.json` não existe.
|
|
28
|
+
>
|
|
29
|
+
> Use `/reversa-requirements` para criar a primeira feature do projeto.
|
|
30
|
+
|
|
31
|
+
2. Verifique o campo `paused-features`
|
|
32
|
+
2.1. Se ausente ou array vazio, aborte com mensagem:
|
|
33
|
+
|
|
34
|
+
> 🛑 Não há features pausadas para retomar. O array `paused-features` está vazio.
|
|
35
|
+
>
|
|
36
|
+
> Features ficam pausadas quando você roda `/reversa-requirements` numa feature ativa em andamento e escolhe a opção 2 (criar paralela).
|
|
37
|
+
|
|
38
|
+
3. Aplique ganchos `before-resume` da forma padrão (lê `.reversa/hooks.yml`, filtra `enabled: false`, mesma lógica de outros skills do ciclo forward)
|
|
39
|
+
|
|
40
|
+
## Listagem das pausadas
|
|
41
|
+
|
|
42
|
+
Para cada entrada em `paused-features`:
|
|
43
|
+
|
|
44
|
+
1. Verifique se o `feature-dir` ainda existe em disco
|
|
45
|
+
1.1. Se NÃO existir, marque como `ausente` (a pasta foi apagada manualmente, a entry virou lixo)
|
|
46
|
+
2. Se existir, detecte o **estágio físico atual** com a mesma lógica do `/reversa-requirements`:
|
|
47
|
+
|
|
48
|
+
| Condição observada em `feature-dir` | Estágio físico |
|
|
49
|
+
|--------------------------------------|----------------|
|
|
50
|
+
| `requirements.md` ausente | `vazio` |
|
|
51
|
+
| `requirements.md` presente, `roadmap.md` ausente | `requirements` |
|
|
52
|
+
| `roadmap.md` presente, `actions.md` ausente | `plan` |
|
|
53
|
+
| `actions.md` presente com pelo menos uma linha `\| ... \| \[ \] \|` | `coding-em-progresso` |
|
|
54
|
+
| `actions.md` presente, todas as ações como `\| ... \| \[X\] \|` | `done` |
|
|
55
|
+
|
|
56
|
+
3. Para `coding-em-progresso`, conte ações `[X]` versus `[ ]`
|
|
57
|
+
|
|
58
|
+
Apresente lista numerada ao usuário:
|
|
59
|
+
|
|
60
|
+
```
|
|
61
|
+
Features pausadas:
|
|
62
|
+
|
|
63
|
+
1. <NNN-short-name> · estágio: <físico> · pausada em <YYYY-MM-DD> [· N de M ações]
|
|
64
|
+
2. <NNN-short-name> · estágio: <físico> · pausada em <YYYY-MM-DD>
|
|
65
|
+
3. <NNN-short-name> · estágio: ausente · pausada em <YYYY-MM-DD> (pasta apagada, entry orfã)
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
Para entries `ausente`, marque visualmente que estão órfãs.
|
|
69
|
+
|
|
70
|
+
## Escolha do usuário
|
|
71
|
+
|
|
72
|
+
Pergunte:
|
|
73
|
+
|
|
74
|
+
> Qual feature você quer retomar? Digite o número da lista, ou `0` para cancelar.
|
|
75
|
+
|
|
76
|
+
Aguarde a resposta. NÃO escolha por conta própria.
|
|
77
|
+
|
|
78
|
+
## Tratamento de entry órfã
|
|
79
|
+
|
|
80
|
+
Se o usuário escolheu uma entry com estágio `ausente`:
|
|
81
|
+
|
|
82
|
+
1. NÃO faça swap
|
|
83
|
+
2. Pergunte: "A pasta dessa feature foi apagada. Quer remover essa entry de `paused-features`? (sim / não)"
|
|
84
|
+
3. Se sim, remova só essa entry do array, escreva `active-requirements.json` atualizado (atomicamente), encerre o skill.
|
|
85
|
+
4. Se não, encerre sem mudar nada.
|
|
86
|
+
|
|
87
|
+
## Detecção do estado da feature atualmente ativa
|
|
88
|
+
|
|
89
|
+
Para a feature em `active-requirements.json#feature-dir`, detecte o estágio físico usando a mesma tabela acima. Esse valor decide se ela vai ser pausada ou descartada na troca.
|
|
90
|
+
|
|
91
|
+
## Swap
|
|
92
|
+
|
|
93
|
+
1. Construa a nova entrada de pausa para a feature **atualmente ativa**, copiando todos os campos do `active-requirements.json` exceto `paused-features`, e adicionando:
|
|
94
|
+
- `paused-at`: ISO 8601 da hora atual
|
|
95
|
+
- `paused-from-stage`: estágio físico detectado da ativa atual
|
|
96
|
+
2. Decida o destino da feature ativa atual:
|
|
97
|
+
- 2.1. Se estágio físico for `requirements`, `plan` ou `coding-em-progresso`: **pause**, ou seja, faça push da entrada construída no array `paused-features`
|
|
98
|
+
- 2.2. Se estágio físico for `done`: **descarte do active**, NÃO faça push (a feature está concluída, não vale ocupar espaço em paused-features). A pasta dela continua intocada em `_reversa_forward/`
|
|
99
|
+
- 2.3. Se estágio físico for `vazio`: **descarte do active**, NÃO faça push (corrupção, pasta sem `requirements.md`)
|
|
100
|
+
3. Remova a feature escolhida do array `paused-features`
|
|
101
|
+
4. Construa o novo `active-requirements.json`:
|
|
102
|
+
|
|
103
|
+
```json
|
|
104
|
+
{
|
|
105
|
+
"schema-version": 1,
|
|
106
|
+
"feature-dir": "<feature-dir da escolhida>",
|
|
107
|
+
"feature-id": "<feature-id da escolhida>",
|
|
108
|
+
"short-name": "<short-name da escolhida>",
|
|
109
|
+
"started-at": "<started-at original da escolhida>",
|
|
110
|
+
"current-stage": "<current-stage original da escolhida, ou estágio físico detectado>",
|
|
111
|
+
"stages-completed": [<copiado da escolhida, ou [] se ausente>],
|
|
112
|
+
"paused-features": [<array atualizado>]
|
|
113
|
+
}
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
4.1. Se a escolhida não tinha `started-at`/`current-stage`/`stages-completed` (entry de versão antiga, antes do schema rico), use o estágio físico detectado para `current-stage` e a hora atual como `started-at` (registre essa fallback em mensagem ao usuário)
|
|
117
|
+
|
|
118
|
+
5. Escreva o JSON atomicamente (tempfile mais rename)
|
|
119
|
+
|
|
120
|
+
## Ganchos Pós-execução
|
|
121
|
+
|
|
122
|
+
Aplique `after-resume` da forma padrão.
|
|
123
|
+
|
|
124
|
+
## Relatório final ao usuário
|
|
125
|
+
|
|
126
|
+
1. Feature retomada: identificador `<NNN-short-name>`
|
|
127
|
+
2. Estágio físico detectado dessa feature: valor entre `requirements` / `plan` / `coding-em-progresso`
|
|
128
|
+
3. Para `coding-em-progresso`, mostrar `N de M ações concluídas`
|
|
129
|
+
4. Destino da feature anteriormente ativa:
|
|
130
|
+
4.1. "pausada" (se foi push pra paused-features)
|
|
131
|
+
4.2. "descartada do ativo (estado: done)" ou "descartada do ativo (estado: vazio)"
|
|
132
|
+
5. Sugestão de próximo skill conforme o estágio da feature retomada:
|
|
133
|
+
5.1. `requirements` → sugerir `/reversa-clarify` (se houver `[DÚVIDA]`) ou `/reversa-plan`
|
|
134
|
+
5.2. `plan` → sugerir `/reversa-to-do`
|
|
135
|
+
5.3. `coding-em-progresso` → sugerir `/reversa-coding` (com argumento opcional pra restringir escopo)
|
|
136
|
+
|
|
137
|
+
Termine sempre com:
|
|
138
|
+
|
|
139
|
+
> Digite **CONTINUAR** para prosseguir conforme a sugestão acima.
|
|
140
|
+
|
|
141
|
+
NÃO execute o próximo skill automaticamente, deixe a decisão com o usuário.
|