@flaviogarrido/reversa 0.0.0-stage → 1.3.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +487 -2
- package/agents/fg-backlog/SKILL.md +129 -0
- package/agents/fg-backlog/agents/openai.yaml +5 -0
- package/agents/fg-backlog/references/backlog-template.md +60 -0
- package/agents/fg-backlog/references/priorizacao.md +41 -0
- package/agents/impeccable/LICENSE +191 -0
- package/agents/impeccable/NOTICE.md +11 -0
- package/agents/impeccable/SKILL.md +88 -0
- package/agents/impeccable/agents/impeccable_asset_producer.toml +47 -0
- package/agents/impeccable/agents/impeccable_documenter.toml +27 -0
- package/agents/impeccable/agents/impeccable_finish_reviewer.toml +41 -0
- package/agents/impeccable/agents/impeccable_manual_edit_applier.toml +95 -0
- package/agents/impeccable/agents/openai.yaml +4 -0
- package/agents/impeccable/reference/adapt.md +318 -0
- package/agents/impeccable/reference/adapt.native.md +58 -0
- package/agents/impeccable/reference/android.md +46 -0
- package/agents/impeccable/reference/animate.md +89 -0
- package/agents/impeccable/reference/audit.md +139 -0
- package/agents/impeccable/reference/audit.native.md +139 -0
- package/agents/impeccable/reference/bolder.md +33 -0
- package/agents/impeccable/reference/clarify.md +94 -0
- package/agents/impeccable/reference/colorize.md +86 -0
- package/agents/impeccable/reference/component-review.md +63 -0
- package/agents/impeccable/reference/craft-floor.md +44 -0
- package/agents/impeccable/reference/craft.md +5 -0
- package/agents/impeccable/reference/critique.md +819 -0
- package/agents/impeccable/reference/degraded/asset-producer.md +42 -0
- package/agents/impeccable/reference/degraded/documenter.md +24 -0
- package/agents/impeccable/reference/degraded/finish-reviewer.md +38 -0
- package/agents/impeccable/reference/degraded/manual-edit-applier.md +92 -0
- package/agents/impeccable/reference/delight.md +70 -0
- package/agents/impeccable/reference/distill.md +111 -0
- package/agents/impeccable/reference/doctor.md +54 -0
- package/agents/impeccable/reference/document.md +416 -0
- package/agents/impeccable/reference/extract.md +69 -0
- package/agents/impeccable/reference/generate.md +101 -0
- package/agents/impeccable/reference/harden.md +343 -0
- package/agents/impeccable/reference/hooks.md +113 -0
- package/agents/impeccable/reference/init.md +131 -0
- package/agents/impeccable/reference/ios.md +51 -0
- package/agents/impeccable/reference/layout.md +84 -0
- package/agents/impeccable/reference/live-setup.md +104 -0
- package/agents/impeccable/reference/live.md +325 -0
- package/agents/impeccable/reference/mode-operate.md +21 -0
- package/agents/impeccable/reference/mode-persuade.md +19 -0
- package/agents/impeccable/reference/mode-read.md +21 -0
- package/agents/impeccable/reference/new-work.md +154 -0
- package/agents/impeccable/reference/onboard.md +234 -0
- package/agents/impeccable/reference/operate.md +61 -0
- package/agents/impeccable/reference/optimize.md +258 -0
- package/agents/impeccable/reference/overdrive.md +127 -0
- package/agents/impeccable/reference/polish.md +105 -0
- package/agents/impeccable/reference/quieter.md +99 -0
- package/agents/impeccable/reference/region-map.md +26 -0
- package/agents/impeccable/reference/routing.md +24 -0
- package/agents/impeccable/reference/shape.md +59 -0
- package/agents/impeccable/reference/typeset.md +90 -0
- package/agents/impeccable/reference/visualize.md +47 -0
- package/agents/impeccable/reversa-bundle.json +16 -0
- package/agents/impeccable/scripts/VERSION +1 -0
- package/agents/impeccable/scripts/command-metadata.json +98 -0
- package/agents/impeccable/scripts/data/font-index-failures.json +121 -0
- package/agents/impeccable/scripts/data/font-index.json +1 -0
- package/agents/impeccable/scripts/impeccable +212 -0
- package/agents/impeccable/scripts/impeccable.cmd +239 -0
- package/agents/impeccable/scripts/live-browser-dom.js +320 -0
- package/agents/impeccable/scripts/live-browser-ignores.js +242 -0
- package/agents/impeccable/scripts/live-browser-session.js +180 -0
- package/agents/impeccable/scripts/live-browser.js +13557 -0
- package/agents/impeccable/scripts/modern-screenshot.umd.js +14 -0
- package/agents/reversa/SKILL.md +135 -0
- package/agents/reversa/agents/openai.yaml +3 -0
- package/agents/reversa/references/checkpoint-guide.md +106 -0
- package/agents/reversa/references/state-schema.md +80 -0
- package/agents/reversa/references/step-01-first-run.md +63 -0
- package/agents/reversa/references/step-02-resume.md +88 -0
- package/agents/reversa/references/step-03-specs-organization.md +145 -0
- package/agents/reversa/references/step-04-regression-check.md +94 -0
- package/agents/reversa-add/SKILL.md +131 -0
- package/agents/reversa-add/agents/openai.yaml +5 -0
- package/agents/reversa-agents-help/SKILL.md +211 -0
- package/agents/reversa-agents-help/agents/openai.yaml +3 -0
- package/agents/reversa-arbiter/SKILL.md +140 -0
- package/agents/reversa-arbiter/agents/openai.yaml +5 -0
- package/agents/reversa-archaeologist/SKILL.md +95 -0
- package/agents/reversa-archaeologist/agents/openai.yaml +5 -0
- package/agents/reversa-archaeologist/references/modules-schema.md +69 -0
- package/agents/reversa-architect/SKILL.md +93 -0
- package/agents/reversa-architect/agents/openai.yaml +5 -0
- package/agents/reversa-arquitetura-3d/SKILL.md +163 -0
- package/agents/reversa-arquitetura-3d/agents/openai.yaml +5 -0
- package/agents/reversa-arquitetura-3d/references/ARCH_TOUR.md +242 -0
- package/agents/reversa-arquitetura-3d/references/CALL_GRAPH_3D.md +217 -0
- package/agents/reversa-arquitetura-3d/references/CODE_CITY.md +228 -0
- package/agents/reversa-arquitetura-3d/references/DEPENDENCY_GRAPH_3D.md +240 -0
- package/agents/reversa-arquitetura-3d/references/ERRORS.md +286 -0
- package/agents/reversa-arquitetura-3d/references/LAYER_STACK.md +230 -0
- package/agents/reversa-arquitetura-3d/references/THREE_PATTERNS.md +221 -0
- package/agents/reversa-audit/SKILL.md +98 -0
- package/agents/reversa-audit/agents/openai.yaml +5 -0
- package/agents/reversa-autonomous/SKILL.md +139 -0
- package/agents/reversa-autonomous/agents/openai.yaml +3 -0
- package/agents/reversa-brainstorm/SKILL.md +131 -0
- package/agents/reversa-brainstorm/agents/openai.yaml +3 -0
- package/agents/reversa-challenger/SKILL.md +122 -0
- package/agents/reversa-challenger/agents/openai.yaml +5 -0
- package/agents/reversa-clarify/SKILL.md +103 -0
- package/agents/reversa-clarify/agents/openai.yaml +5 -0
- package/agents/reversa-code-express/SKILL.md +252 -0
- package/agents/reversa-code-express/agents/openai.yaml +5 -0
- package/agents/reversa-coding/SKILL.md +172 -0
- package/agents/reversa-coding/agents/openai.yaml +5 -0
- package/agents/reversa-curator/SKILL.md +133 -0
- package/agents/reversa-curator/agents/openai.yaml +5 -0
- package/agents/reversa-curator/references/decision-rubric.md +52 -0
- package/agents/reversa-curator/references/templates/discard_log.md +37 -0
- package/agents/reversa-curator/references/templates/target_business_rules.md +54 -0
- package/agents/reversa-data-master/SKILL.md +67 -0
- package/agents/reversa-data-master/agents/openai.yaml +5 -0
- package/agents/reversa-debugger/SKILL.md +178 -0
- package/agents/reversa-debugger/agents/openai.yaml +3 -0
- package/agents/reversa-debugger/references/bug-schema.md +123 -0
- package/agents/reversa-debugger/references/bugs-readme-template.md +76 -0
- package/agents/reversa-debugger-debate/SKILL.md +75 -0
- package/agents/reversa-debugger-debate/agents/openai.yaml +5 -0
- package/agents/reversa-debugger-debate/references/debate-protocol.md +102 -0
- package/agents/reversa-debugger-fix/SKILL.md +170 -0
- package/agents/reversa-debugger-fix/agents/openai.yaml +5 -0
- package/agents/reversa-debugger-graph/SKILL.md +94 -0
- package/agents/reversa-debugger-graph/agents/openai.yaml +5 -0
- package/agents/reversa-decouple/SKILL.md +78 -0
- package/agents/reversa-decouple/agents/openai.yaml +5 -0
- package/agents/reversa-depth-inspection/SKILL.md +99 -0
- package/agents/reversa-depth-inspection/agents/openai.yaml +5 -0
- package/agents/reversa-design-system/SKILL.md +77 -0
- package/agents/reversa-design-system/agents/openai.yaml +5 -0
- package/agents/reversa-designer/SKILL.md +217 -0
- package/agents/reversa-designer/agents/openai.yaml +5 -0
- package/agents/reversa-designer/references/paradigm-checklist.md +50 -0
- package/agents/reversa-designer/references/templates/data_migration_plan.md +80 -0
- package/agents/reversa-designer/references/templates/target_architecture.md +68 -0
- package/agents/reversa-designer/references/templates/target_data_model.md +64 -0
- package/agents/reversa-designer/references/templates/target_domain_model.md +62 -0
- package/agents/reversa-designer/references/templates/topology_decision.md +82 -0
- package/agents/reversa-detective/SKILL.md +82 -0
- package/agents/reversa-detective/agents/openai.yaml +5 -0
- package/agents/reversa-docs/SKILL.md +241 -0
- package/agents/reversa-docs/agents/openai.yaml +3 -0
- package/agents/reversa-docs/references/config-schema.json +108 -0
- package/agents/reversa-docs/references/expected_sources.yaml +60 -0
- package/agents/reversa-docs-analyst/SKILL.md +163 -0
- package/agents/reversa-docs-analyst/agents/openai.yaml +5 -0
- package/agents/reversa-docs-mapper/SKILL.md +167 -0
- package/agents/reversa-docs-mapper/agents/openai.yaml +5 -0
- package/agents/reversa-docs-mapper/references/extraction-policy.md +44 -0
- package/agents/reversa-docs-publisher/SKILL.md +323 -0
- package/agents/reversa-docs-publisher/agents/openai.yaml +5 -0
- package/agents/reversa-docs-publisher/references/auxiliary_sources.yaml +27 -0
- package/agents/reversa-docs-publisher/references/vendor-pins.yaml +149 -0
- package/agents/reversa-docs-storyteller/SKILL.md +189 -0
- package/agents/reversa-docs-storyteller/agents/openai.yaml +5 -0
- package/agents/reversa-drafter/SKILL.md +189 -0
- package/agents/reversa-drafter/agents/openai.yaml +5 -0
- package/agents/reversa-especialista-d3/SKILL.md +37 -0
- package/agents/reversa-especialista-d3/agents/openai.yaml +5 -0
- package/agents/reversa-especialista-d3/references/api-core.md +13 -0
- package/agents/reversa-especialista-d3/references/interatividade.md +5 -0
- package/agents/reversa-especialista-d3/references/layouts-complexos.md +8 -0
- package/agents/reversa-explorer/SKILL.md +110 -0
- package/agents/reversa-explorer/agents/openai.yaml +5 -0
- package/agents/reversa-extract-soul/SKILL.md +221 -0
- package/agents/reversa-extract-soul/agents/openai.yaml +5 -0
- package/agents/reversa-forward/SKILL.md +235 -0
- package/agents/reversa-forward/agents/openai.yaml +3 -0
- package/agents/reversa-forward-autonomous/SKILL.md +184 -0
- package/agents/reversa-forward-autonomous/agents/openai.yaml +3 -0
- package/agents/reversa-framer/SKILL.md +124 -0
- package/agents/reversa-framer/agents/openai.yaml +5 -0
- package/agents/reversa-highcharts-visualizer/SKILL.md +123 -0
- package/agents/reversa-highcharts-visualizer/agents/openai.yaml +5 -0
- package/agents/reversa-highcharts-visualizer/references/CHART_CATALOG.md +450 -0
- package/agents/reversa-highcharts-visualizer/references/ERRORS.md +99 -0
- package/agents/reversa-highcharts-visualizer/references/HIGHCHARTS_PATTERNS.md +347 -0
- package/agents/reversa-highcharts-visualizer/scripts/analyze_data.py +219 -0
- package/agents/reversa-highcharts-visualizer/scripts/parse_data.py +246 -0
- package/agents/reversa-highcharts-visualizer/scripts/sample_data.py +208 -0
- package/agents/reversa-ideator/SKILL.md +139 -0
- package/agents/reversa-ideator/agents/openai.yaml +5 -0
- package/agents/reversa-image-prompt-json/SKILL.md +210 -0
- package/agents/reversa-image-prompt-json/agents/openai.yaml +5 -0
- package/agents/reversa-image-prompt-json/references/Examples.md +123 -0
- package/agents/reversa-inspector/SKILL.md +147 -0
- package/agents/reversa-inspector/agents/openai.yaml +5 -0
- package/agents/reversa-inspector/references/parity-coverage-matrix.md +54 -0
- package/agents/reversa-inspector/references/templates/parity_specs.md +64 -0
- package/agents/reversa-inspector/references/templates/parity_test.feature +40 -0
- package/agents/reversa-migrate/SKILL.md +282 -0
- package/agents/reversa-migrate/agents/openai.yaml +3 -0
- package/agents/reversa-migrate/references/auto-defaults.md +52 -0
- package/agents/reversa-migrate/references/expected_legacy_artifacts.yaml +69 -0
- package/agents/reversa-migrate/references/handoff-checklist.md +34 -0
- package/agents/reversa-migrate/references/state.json +28 -0
- package/agents/reversa-migrate/references/templates/ambiguity_log.md +43 -0
- package/agents/reversa-migrate/references/templates/handoff.md +91 -0
- package/agents/reversa-migrate/references/templates/migration_brief.md +52 -0
- package/agents/reversa-migrate/references/templates/pending_decisions.md +36 -0
- package/agents/reversa-modularize/SKILL.md +77 -0
- package/agents/reversa-modularize/agents/openai.yaml +5 -0
- package/agents/reversa-n8n/SKILL.md +256 -0
- package/agents/reversa-n8n/agents/openai.yaml +5 -0
- package/agents/reversa-n8n/references/node-catalog.md +245 -0
- package/agents/reversa-new/SKILL.md +328 -0
- package/agents/reversa-new/agents/openai.yaml +3 -0
- package/agents/reversa-optimize/SKILL.md +80 -0
- package/agents/reversa-optimize/agents/openai.yaml +5 -0
- package/agents/reversa-paradigm-advisor/SKILL.md +168 -0
- package/agents/reversa-paradigm-advisor/agents/openai.yaml +5 -0
- package/agents/reversa-paradigm-advisor/references/paradigm-catalog.md +73 -0
- package/agents/reversa-paradigm-advisor/references/templates/paradigm_decision.md +69 -0
- package/agents/reversa-plan/SKILL.md +92 -0
- package/agents/reversa-plan/agents/openai.yaml +5 -0
- package/agents/reversa-pre-spec/SKILL.md +133 -0
- package/agents/reversa-pre-spec/agents/openai.yaml +5 -0
- package/agents/reversa-pricing/SKILL.md +181 -0
- package/agents/reversa-pricing/agents/openai.yaml +3 -0
- package/agents/reversa-pricing-advisor/SKILL.md +322 -0
- package/agents/reversa-pricing-advisor/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-advisor/references/advisor-schema.json +196 -0
- package/agents/reversa-pricing-advisor/references/advisor-template.md +106 -0
- package/agents/reversa-pricing-advisor/references/sale-models.md +237 -0
- package/agents/reversa-pricing-estimate/SKILL.md +287 -0
- package/agents/reversa-pricing-estimate/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-estimate/references/effort-formula.md +146 -0
- package/agents/reversa-pricing-estimate/references/estimate-schema.json +141 -0
- package/agents/reversa-pricing-estimate/references/estimate-template.md +153 -0
- package/agents/reversa-pricing-estimate/references/example-estimate.json +74 -0
- package/agents/reversa-pricing-estimate/references/example-estimate.md +88 -0
- package/agents/reversa-pricing-estimate/references/market-benchmarks.md +102 -0
- package/agents/reversa-pricing-estimate/references/value-formula.md +123 -0
- package/agents/reversa-pricing-product/SKILL.md +299 -0
- package/agents/reversa-pricing-product/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-product/references/breakeven-formula.md +237 -0
- package/agents/reversa-pricing-product/references/product-schema.json +288 -0
- package/agents/reversa-pricing-product/references/product-template.md +113 -0
- package/agents/reversa-pricing-product/references/store-commissions.md +57 -0
- package/agents/reversa-pricing-profile/SKILL.md +390 -0
- package/agents/reversa-pricing-profile/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-profile/references/example-profile.json +23 -0
- package/agents/reversa-pricing-profile/references/example-profile.md +46 -0
- package/agents/reversa-pricing-profile/references/profile-schema.json +227 -0
- package/agents/reversa-pricing-profile/references/tax-regimes.md +106 -0
- package/agents/reversa-pricing-research/SKILL.md +352 -0
- package/agents/reversa-pricing-research/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-research/references/research-policy.md +213 -0
- package/agents/reversa-pricing-research/references/research-schema.json +330 -0
- package/agents/reversa-pricing-size/SKILL.md +205 -0
- package/agents/reversa-pricing-size/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-size/references/example-size.json +41 -0
- package/agents/reversa-pricing-size/references/size-schema.json +120 -0
- package/agents/reversa-pricing-size/references/sizing-formula.md +183 -0
- package/agents/reversa-principles/SKILL.md +82 -0
- package/agents/reversa-principles/agents/openai.yaml +5 -0
- package/agents/reversa-prune/SKILL.md +85 -0
- package/agents/reversa-prune/agents/openai.yaml +5 -0
- package/agents/reversa-quality/SKILL.md +87 -0
- package/agents/reversa-quality/agents/openai.yaml +5 -0
- package/agents/reversa-reconstructor/SKILL.md +243 -0
- package/agents/reversa-reconstructor/agents/openai.yaml +5 -0
- package/agents/reversa-reconstructor/references/reconstruction-plan-migration-template.md +89 -0
- package/agents/reversa-reconstructor/references/reconstruction-plan-template.md +77 -0
- package/agents/reversa-refactor/SKILL.md +112 -0
- package/agents/reversa-refactor/agents/openai.yaml +3 -0
- package/agents/reversa-refactor/references/opportunity-schema.md +68 -0
- package/agents/reversa-refactor/references/refactor-readme-template.md +35 -0
- package/agents/reversa-requirements/SKILL.md +217 -0
- package/agents/reversa-requirements/agents/openai.yaml +5 -0
- package/agents/reversa-researcher/SKILL.md +136 -0
- package/agents/reversa-researcher/agents/openai.yaml +5 -0
- package/agents/reversa-restructure/SKILL.md +78 -0
- package/agents/reversa-restructure/agents/openai.yaml +5 -0
- package/agents/reversa-resume/SKILL.md +141 -0
- package/agents/reversa-resume/agents/openai.yaml +5 -0
- package/agents/reversa-reviewer/SKILL.md +163 -0
- package/agents/reversa-reviewer/agents/openai.yaml +5 -0
- package/agents/reversa-reviewer/references/confidence-report-template.md +73 -0
- package/agents/reversa-reviewer/references/confidence-rules.md +65 -0
- package/agents/reversa-reviewer/references/questions-template.md +74 -0
- package/agents/reversa-scout/SKILL.md +82 -0
- package/agents/reversa-scout/agents/openai.yaml +5 -0
- package/agents/reversa-scout/references/surface-schema.md +93 -0
- package/agents/reversa-screen-translator/SKILL.md +279 -0
- package/agents/reversa-screen-translator/agents/openai.yaml +5 -0
- package/agents/reversa-screen-translator/references/adapter-pairs.md +97 -0
- package/agents/reversa-screen-translator/references/platform-detection.md +73 -0
- package/agents/reversa-screen-translator/references/templates/golden_manifest.yaml +62 -0
- package/agents/reversa-screen-translator/references/templates/inventory.schema.json +132 -0
- package/agents/reversa-screen-translator/references/templates/screen_deviation_log.md +66 -0
- package/agents/reversa-screen-translator/references/templates/screen_modernization_decision.md +106 -0
- package/agents/reversa-screen-translator/references/templates/target_screens.md +206 -0
- package/agents/reversa-selo-generativo/SKILL.md +176 -0
- package/agents/reversa-selo-generativo/agents/openai.yaml +5 -0
- package/agents/reversa-selo-generativo/references/ERRORS.md +212 -0
- package/agents/reversa-selo-generativo/references/GENERATIVE_PATTERNS.md +365 -0
- package/agents/reversa-selo-generativo/references/PALETTE_BY_STYLE.md +176 -0
- package/agents/reversa-simplify/SKILL.md +79 -0
- package/agents/reversa-simplify/agents/openai.yaml +5 -0
- package/agents/reversa-spec-sdd/SKILL.md +278 -0
- package/agents/reversa-spec-sdd/agents/openai.yaml +5 -0
- package/agents/reversa-spec-sdd/assets/spec_examples.md +159 -0
- package/agents/reversa-spec-sdd/references/evaluation_rubric.md +113 -0
- package/agents/reversa-spec-sdd/references/sdd_guide.md +124 -0
- package/agents/reversa-spec-sdd/references/spec_template.md +231 -0
- package/agents/reversa-spec-sdd/scripts/spec_scorer.py +476 -0
- package/agents/reversa-standardize/SKILL.md +76 -0
- package/agents/reversa-standardize/agents/openai.yaml +5 -0
- package/agents/reversa-strategist/SKILL.md +119 -0
- package/agents/reversa-strategist/agents/openai.yaml +5 -0
- package/agents/reversa-strategist/references/migration-strategies.md +41 -0
- package/agents/reversa-strategist/references/templates/cutover_plan.md +60 -0
- package/agents/reversa-strategist/references/templates/migration_strategy.md +55 -0
- package/agents/reversa-strategist/references/templates/risk_register.md +44 -0
- package/agents/reversa-sync/SKILL.md +100 -0
- package/agents/reversa-sync/agents/openai.yaml +5 -0
- package/agents/reversa-to-do/SKILL.md +89 -0
- package/agents/reversa-to-do/agents/openai.yaml +5 -0
- package/agents/reversa-visor/SKILL.md +91 -0
- package/agents/reversa-visor/agents/openai.yaml +5 -0
- package/agents/reversa-writer/SKILL.md +212 -0
- package/agents/reversa-writer/agents/openai.yaml +5 -0
- package/agents/reversa-writer/references/design-template.md +49 -0
- package/agents/reversa-writer/references/requirements-template.md +62 -0
- package/agents/reversa-writer/references/tasks-template.md +39 -0
- package/bin/reversa.js +65 -0
- package/lib/commands/add-engine.js +97 -0
- package/lib/commands/export-diagrams.js +194 -0
- package/lib/commands/install.js +260 -0
- package/lib/commands/status.js +35 -0
- package/lib/commands/uninstall.js +159 -0
- package/lib/commands/update.js +252 -0
- package/lib/installer/bundled.js +42 -0
- package/lib/installer/detector.js +167 -0
- package/lib/installer/manifest.js +61 -0
- package/lib/installer/orange-prompts.js +13 -0
- package/lib/installer/policy.js +53 -0
- package/lib/installer/prompts.js +252 -0
- package/lib/installer/validator.js +22 -0
- package/lib/installer/writer.js +376 -0
- package/lib/utils/banner.js +35 -0
- package/lib/utils/json-safe.js +10 -0
- package/lib/utils/package-info.js +22 -0
- package/package.json +51 -4
- package/templates/config.toml +46 -0
- package/templates/config.user.toml +8 -0
- package/templates/documentation/assets/css/style.css +476 -0
- package/templates/documentation/assets/js/nav.js +141 -0
- package/templates/documentation/assets/js/sidebar.js +162 -0
- package/templates/documentation/demo/viewer-demo.html +200 -0
- package/templates/documentation/pages/arquitetura.html.tpl +36 -0
- package/templates/documentation/pages/deck.html.tpl +27 -0
- package/templates/documentation/pages/features/feature.html.tpl +44 -0
- package/templates/documentation/pages/glossario.html.tpl +30 -0
- package/templates/documentation/pages/index.html.tpl +32 -0
- package/templates/documentation/pages/metricas.html.tpl +43 -0
- package/templates/documentation/pages/modulos.html.tpl +33 -0
- package/templates/documentation/pages/timeline.html.tpl +33 -0
- package/templates/documentation/pages/topologia.html.tpl +31 -0
- package/templates/documentation/scripts/convert_chronicle.py +71 -0
- package/templates/documentation/scripts/convert_soul.py +73 -0
- package/templates/documentation/scripts/extract_deps.py +54 -0
- package/templates/documentation/scripts/extract_modules.py +90 -0
- package/templates/documentation/scripts/list_specs.py +74 -0
- package/templates/documentation/viewer.html +60 -0
- package/templates/engines/AGENTS.md +26 -0
- package/templates/engines/CLAUDE.md +27 -0
- package/templates/engines/CONVENTIONS.md +26 -0
- package/templates/engines/GEMINI.md +26 -0
- package/templates/engines/amazonq +7 -0
- package/templates/engines/clinerules +7 -0
- package/templates/engines/copilot-instructions +26 -0
- package/templates/engines/cursorrules +7 -0
- package/templates/engines/roorules +7 -0
- package/templates/engines/windsurf +7 -0
- package/templates/forward/body/actions-template.md +83 -0
- package/templates/forward/body/principles-template.md +75 -0
- package/templates/forward/body/quality-template.md +103 -0
- package/templates/forward/body/requirements-template.md +121 -0
- package/templates/forward/body/roadmap-template.md +107 -0
- package/templates/forward/hooks.yml +60 -0
- package/templates/forward/scripts/ps/bind-to-extraction.ps1 +71 -0
- package/templates/forward/scripts/ps/prepare-roadmap.ps1 +84 -0
- package/templates/forward/scripts/ps/verify-prerequisites.ps1 +103 -0
- package/templates/forward/scripts/sh/bind-to-extraction.sh +103 -0
- package/templates/forward/scripts/sh/prepare-roadmap.sh +79 -0
- package/templates/forward/scripts/sh/verify-prerequisites.sh +125 -0
- package/templates/forward/setup.json +24 -0
- package/templates/hooks/README.md +41 -0
- package/templates/hooks/check-legacy-policy.mjs +0 -0
- package/templates/migration/artifacts/ambiguity_log.md +43 -0
- package/templates/migration/artifacts/cutover_plan.md +60 -0
- package/templates/migration/artifacts/data_migration_plan.md +80 -0
- package/templates/migration/artifacts/discard_log.md +37 -0
- package/templates/migration/artifacts/handoff.md +76 -0
- package/templates/migration/artifacts/migration_brief.md +52 -0
- package/templates/migration/artifacts/migration_strategy.md +55 -0
- package/templates/migration/artifacts/paradigm_decision.md +69 -0
- package/templates/migration/artifacts/parity_specs.md +64 -0
- package/templates/migration/artifacts/parity_test.feature +40 -0
- package/templates/migration/artifacts/pending_decisions.md +36 -0
- package/templates/migration/artifacts/risk_register.md +44 -0
- package/templates/migration/artifacts/target_architecture.md +68 -0
- package/templates/migration/artifacts/target_business_rules.md +54 -0
- package/templates/migration/artifacts/target_data_model.md +64 -0
- package/templates/migration/artifacts/target_domain_model.md +62 -0
- package/templates/migration/catalogs/migration_strategies.md +101 -0
- package/templates/migration/catalogs/paradigm_catalog.md +101 -0
- package/templates/migration/expected_legacy_artifacts.yaml +77 -0
- package/templates/migration/state.json +28 -0
- package/templates/plan.md +65 -0
- package/templates/reversa-config.json +5 -0
- package/templates/state.json +18 -0
|
@@ -0,0 +1,352 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: reversa-pricing-research
|
|
3
|
+
description: 'Pesquisa na web referencias de preco para o time de precificacao: taxa hora por senioridade e regiao, precos de produtos comparaveis e comissoes de lojas de apps. Tenta cidade, depois estado, depois pais, mostra o nivel usado, grava faixa com fontes e data em _pricing/research/ e nunca preenche profile ou product sozinho. Chamado pelo profile em modo pesquisar e pelo product; tambem roda direto com o tipo de pesquisa como argumento.'
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
license: MIT
|
|
6
|
+
compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compativeis com Agent Skills.
|
|
7
|
+
metadata:
|
|
8
|
+
author: sandeco
|
|
9
|
+
version: "1.0.0"
|
|
10
|
+
framework: reversa
|
|
11
|
+
phase: pricing
|
|
12
|
+
stage: research
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
Voce e o pesquisador de mercado do REVERSA. Sua missao e buscar na web referencias de preco com fonte e data, gravar em `_reversa_sdd/_pricing/research/<kind>.json` e `.md`, e devolver uma faixa ao agente que chamou. Voce NUNCA escreve em profile.json ou product.json: quem confirma e grava e o usuario pelo agente chamador.
|
|
16
|
+
|
|
17
|
+
## Principios
|
|
18
|
+
|
|
19
|
+
1. Voce e o unico agente do time de precificacao que usa internet. Use somente a ferramenta de busca do engine atual, nunca invente fonte, URL, numero ou data
|
|
20
|
+
2. No maximo 6 buscas por execucao. Registre cada consulta executada em `queries_run`
|
|
21
|
+
3. Toda fonte aceita tem nome, URL, numero, unidade e data de acesso. Fonte sem numero ou sem data identificavel vai para `skipped_sources`
|
|
22
|
+
4. Nunca entregue numero unico: entregue faixa (minimo, mediana, maximo) com nivel geografico e confianca
|
|
23
|
+
5. Nunca some markup, imposto ou comissao sobre o que a fonte diz. Normalize apenas unidade (mes ou ano para hora) e marque `derived = true`
|
|
24
|
+
6. Nunca converta moeda. Fonte em moeda diferente de `currency` e rejeitada com motivo
|
|
25
|
+
7. Perguntas ao usuario uma por vez, em linguagem leiga em pt-br
|
|
26
|
+
8. Nao use travessao em nenhum texto. Use virgula, dois-pontos ou reescreva
|
|
27
|
+
9. Toda escrita em disco e atomica, com tempfile mais rename, UTF-8 sem BOM. Tolere BOM ao ler JSON
|
|
28
|
+
10. Voce so escreve dentro de `_reversa_sdd/_pricing/research/`. Nunca escreva em `profile.json`, `product.json`, `advisor.json`, codigo legado, Discovery, Forward ou `.reversa/`
|
|
29
|
+
11. O que voce entrega e referencia de mercado, nao recomendacao de preco nem aconselhamento financeiro
|
|
30
|
+
12. Em qualquer encerramento sem mudancas (resposta N no recalculo ou cancelamento), imprima o Relatorio final com os caminhos existentes e termine com CONTINUAR, so quando executado direto. Quando chamado por outro agente, devolva o que existe conforme "Retorno ao agente chamador"
|
|
31
|
+
|
|
32
|
+
## Antes de comecar
|
|
33
|
+
|
|
34
|
+
1. Leia `.reversa/state.json` para resolver `output_folder`. Se ausente, assuma `_reversa_sdd/`. Quando este texto disser `_reversa_sdd/`, use o valor real
|
|
35
|
+
2. Garanta que `_reversa_sdd/_pricing/research/` exista. Crie se necessario, sem tocar nada alem
|
|
36
|
+
3. Carregue `agents/reversa-pricing-research/references/research-policy.md` (politica de fontes, limites, normalizacao e exemplos de consulta)
|
|
37
|
+
4. Carregue `agents/reversa-pricing-research/references/research-schema.json`
|
|
38
|
+
5. Se `_reversa_sdd/_pricing/profile.json` existir, leia somente para oferecer `country`, `currency`, `seniority` e `region` como valores padrao. Se `_reversa_sdd/_pricing/advisor.json` existir, leia somente para oferecer `store_choice.store` como padrao. Leitura apenas, nunca escrita
|
|
39
|
+
|
|
40
|
+
## Deteccao da ferramenta de busca
|
|
41
|
+
|
|
42
|
+
Antes de qualquer pergunta, descubra qual ferramenta de busca existe na sessao atual. A tabela completa esta em `research-policy.md`, secao 1. Resumo:
|
|
43
|
+
|
|
44
|
+
| Engine | Ferramenta de busca | Ferramenta de leitura de pagina |
|
|
45
|
+
|---|---|---|
|
|
46
|
+
| Claude Code | `WebSearch` | `WebFetch` |
|
|
47
|
+
| Codex | busca web nativa do Codex | leitura de URL do Codex |
|
|
48
|
+
| Gemini CLI | `google_web_search` | `web_fetch` |
|
|
49
|
+
| Cursor | `@web` | abrir URL pelo `@web` |
|
|
50
|
+
|
|
51
|
+
Como detectar: verifique a lista de ferramentas disponiveis no contexto atual. Se uma delas e a ferramenta de busca do engine (ou um nome equivalente que faca busca na web), ela esta disponivel. Se a ferramenta aparecer como adiada (deferred), carregue-a antes de usar, pelo mecanismo do engine. Ferramenta de leitura de pagina sem busca nao conta como busca: ela serve para abrir a URL encontrada e confirmar o numero.
|
|
52
|
+
|
|
53
|
+
Se nenhuma ferramenta de busca estiver disponivel na sessao:
|
|
54
|
+
|
|
55
|
+
1. Nao pergunte nada ao usuario sobre a pesquisa em si. Colete apenas o `kind` e os inputs que ja vieram do agente chamador ou do argumento
|
|
56
|
+
2. Se `_reversa_sdd/_pricing/research/<kind>.json` ja existir com `available = true`, nao regrave: avise "Este engine nao tem busca na web. Vou usar a pesquisa ja gravada em `<kind>.json`." e devolva a faixa ja gravada ao agente chamador (ou mostre ao usuario, quando executado direto), com a apresentacao normal
|
|
57
|
+
3. Se nao existir, ou existir com `available = false`: grave `<kind>.json` com `available = false`, `reason = "engine_sem_busca"`, `sources = []`, `skipped_sources = []`, `queries_run = []`, `levels_tried = []`, `level_used = null`, `faixa_min = null`, `faixa_max = null`, `faixa_mediana = null`, `confidence = null`, `weak = true`, e o `.md` correspondente (ver Persistencia, estrutura quando `available = false`). Se existir um arquivo anterior, renomeie para `.bak.<YYYYMMDD-HHMMSS>` antes, nas mesmas regras das Verificacoes iniciais, sem perguntar
|
|
58
|
+
4. Avise literalmente: "Este engine nao tem busca na web. Informe o valor manualmente no agente chamador."
|
|
59
|
+
5. Nunca invente fonte, nunca use numero de memoria no lugar de uma busca. Se chamado por outro agente, devolva `available = false` e `reason` ao chamador conforme "Retorno ao agente chamador", sem Relatorio final nem CONTINUAR; so encerre com Relatorio final e CONTINUAR quando executado direto
|
|
60
|
+
|
|
61
|
+
Se a ferramenta existe mas todas as buscas falharem por erro de rede ou bloqueio: grave `available = false`, `reason = "busca_falhou"`, registre as consultas tentadas em `queries_run`, avise "A busca na web falhou nesta sessao. Informe o valor manualmente no agente chamador." Se chamado por outro agente, devolva `available = false` e `reason` ao chamador conforme "Retorno ao agente chamador", sem Relatorio final nem CONTINUAR; so encerre com Relatorio final e CONTINUAR quando executado direto.
|
|
62
|
+
|
|
63
|
+
## Entrada: tipo de pesquisa e inputs
|
|
64
|
+
|
|
65
|
+
O `kind` chega de uma destas formas:
|
|
66
|
+
|
|
67
|
+
- como argumento direto (`/reversa-pricing-research hourly_rate`, `comparables` ou `store_commission`)
|
|
68
|
+
- do agente chamador, quando o `reversa-pricing-profile` (modo pesquisar) ou o `reversa-pricing-product` leu este SKILL.md e esta executando as instrucoes no contexto atual. Nesse caso o kind e os inputs ja estao no contexto: nao repita perguntas ja respondidas
|
|
69
|
+
|
|
70
|
+
Se nao houver `kind` valido, pergunte literalmente: "Que tipo de pesquisa voce quer? 1) hourly_rate: taxa hora por senioridade e regiao 2) comparables: preco de produtos parecidos 3) store_commission: comissao de loja de apps". Aceite o numero ou a chave.
|
|
71
|
+
|
|
72
|
+
| kind | entradas | saida principal |
|
|
73
|
+
|---|---|---|
|
|
74
|
+
| `hourly_rate` | country, currency, seniority (canonica), region {city, state} opcional | faixa de taxa hora na moeda local |
|
|
75
|
+
| `comparables` | descricao de uma linha do software, model (assinatura, aluguel, licenca_perpetua, loja_de_apps), country, currency; quando model = loja_de_apps, tambem store e store_billing (unica ou assinatura) | faixa de preco de produtos parecidos, por periodo (mes) ou por licenca |
|
|
76
|
+
| `store_commission` | store (google_play, app_store, microsoft_store, steam, outra) | percentual de comissao com fonte oficial |
|
|
77
|
+
|
|
78
|
+
Colete os inputs que faltarem, uma pergunta por vez, oferecendo o padrao do profile ou do advisor quando existir ("Enter mantem"):
|
|
79
|
+
|
|
80
|
+
### Inputs de `hourly_rate`
|
|
81
|
+
|
|
82
|
+
1. `country`: "Em qual pais voce atua? Digite o codigo ISO de 2 letras, como BR, US, PT, MX, ou o nome em portugues." Valide ISO 3166-1 alpha-2
|
|
83
|
+
2. `currency`: "Qual sua moeda local? Use codigo ISO 4217, como BRL, USD, EUR ou MXN." Sugira a moeda padrao do pais quando souber (BR -> BRL, US -> USD, PT -> EUR, MX -> MXN, AR -> ARS, CL -> CLP, CO -> COP, ES -> EUR, GB -> GBP)
|
|
84
|
+
3. `seniority`: "Qual a senioridade? junior (ate 2 anos), mid (2 a 5 anos), senior (mais de 5 anos e autonomia total), staff_lead (lidera time ou arquitetura), principal (referencia tecnica da empresa)." Aliases: pleno -> mid, especialista -> staff_lead, staff -> staff_lead, lead -> staff_lead. Grave sempre o valor canonico
|
|
85
|
+
4. `region`: "Em qual cidade e estado voce atua? Isso ajuda a pesquisa regional. Pode responder 'pular'." Grave `{city, state}`; "pular" grava `region = null`. Cidade sem estado ou estado sem cidade sao aceitos, o campo ausente fica `null`
|
|
86
|
+
|
|
87
|
+
### Inputs de `comparables`
|
|
88
|
+
|
|
89
|
+
1. `description`: "Descreva o software em uma linha, do jeito que um cliente procuraria por ele."
|
|
90
|
+
2. `model`: "Qual modelo de venda voce quer comparar? 1) assinatura 2) aluguel 3) licenca_perpetua 4) loja_de_apps"
|
|
91
|
+
3. `country` e `currency`: mesmas perguntas de `hourly_rate`, com padrao do profile quando existir
|
|
92
|
+
4. So quando `model = loja_de_apps`: `store`: "Em qual loja? 1) google_play 2) app_store 3) microsoft_store 4) steam 5) outra" (padrao `advisor.store_choice.store` quando existir) e `store_billing`: "Dentro da loja, venda unica ou assinatura? 1) unica 2) assinatura" (padrao `advisor.store_choice.store_billing` quando existir). Nos demais modelos, `store` e `store_billing` ficam `null`
|
|
93
|
+
|
|
94
|
+
### Inputs de `store_commission`
|
|
95
|
+
|
|
96
|
+
1. `store`: "Em qual loja? 1) google_play 2) app_store 3) microsoft_store 4) steam 5) outra". Padrao: `advisor.store_choice.store` quando existir. Se `outra`, pergunte "Qual o nome da loja?" e guarde o nome em `inputs.description`
|
|
97
|
+
2. `country` e `currency` ficam `null` quando nao vierem do profile ou do chamador: comissao e percentual, nao depende de moeda
|
|
98
|
+
|
|
99
|
+
## Verificacoes iniciais
|
|
100
|
+
|
|
101
|
+
1. Se `_reversa_sdd/_pricing/research/<kind>.json` ja existir, leia e mostre um resumo: kind, `created_at`, `accessed_at` da primeira fonte, inputs, faixa, nivel e confianca
|
|
102
|
+
2. Pergunte literalmente: "Ja existe research/<kind>.json. Deseja recalcular? S/N"
|
|
103
|
+
3. Se a resposta for "N", encerre sem mudancas e devolva a faixa ja gravada ao agente chamador, se houver
|
|
104
|
+
4. Se a resposta for "S", renomeie `<kind>.json` para `<kind>.json.bak.<YYYYMMDD-HHMMSS>` e `<kind>.md` para `<kind>.md.bak.<YYYYMMDD-HHMMSS>` antes de prosseguir
|
|
105
|
+
|
|
106
|
+
## Data de acesso
|
|
107
|
+
|
|
108
|
+
`accessed_at` e a data de hoje conhecida pela sessao, no formato `AAAA-MM-DD`. Se a sessao nao souber a data de hoje, pergunte literalmente: "Qual a data de hoje? Formato AAAA-MM-DD." Use a mesma data em todas as fontes da execucao. Nunca copie a data de publicacao da fonte para `accessed_at`: a data de publicacao, quando houver, vai em `note`.
|
|
109
|
+
|
|
110
|
+
## Execucao da pesquisa
|
|
111
|
+
|
|
112
|
+
Antes de pesquisar, diga ao usuario em uma frase o que vai buscar e que fara no maximo 6 buscas. Monte as consultas com base nos exemplos de `research-policy.md`, secao 10, em pt-br para paises de lingua portuguesa e em ingles quando o pais ou a fonte pedir. Registre cada consulta executada, com ou sem resultado util, em `queries_run`.
|
|
113
|
+
|
|
114
|
+
Para cada resultado promissor, abra a pagina com a ferramenta de leitura quando o resumo da busca nao trouxer o numero. Aceite ou rejeite conforme a secao "Fontes aceitas e rejeitadas".
|
|
115
|
+
|
|
116
|
+
### `hourly_rate`: cadeia geografica cidade, estado, pais
|
|
117
|
+
|
|
118
|
+
1. Niveis, nesta ordem: `cidade` (so se `region.city` existe), `estado` (so se `region.state` existe), `pais` (sempre). Registre em `levels_tried` cada nivel efetivamente pesquisado
|
|
119
|
+
2. Em cada nivel, faca ate 2 buscas. Aceite o nivel quando houver pelo menos 2 fontes aceitas com numero. Ao aceitar, pare: nao desca para o proximo nivel
|
|
120
|
+
3. Se o nivel nao atingir 2 fontes, guarde as fontes aceitas que encontrou, registre o nivel em `levels_tried` e passe ao proximo nivel
|
|
121
|
+
4. `level_used` e o nivel aceito. Se nenhum nivel atingiu 2 fontes, `level_used` e o nivel mais especifico que produziu pelo menos 1 fonte aceita, e a faixa fica `weak = true`. Se nenhum nivel produziu fonte aceita, ver "Sem fontes aceitas"
|
|
122
|
+
5. Fontes aceitas em niveis anteriores ao nivel usado entram em `sources` com `note` dizendo o nivel de origem ("nivel cidade"), pois sao mais especificas, nao menos
|
|
123
|
+
6. Antes de comecar a cadeia, avise em uma frase: "Dado por cidade costuma ser escasso; o pais e o nivel que normalmente funciona. Vou tentar cidade, depois estado, depois pais, e mostrar qual nivel usei."
|
|
124
|
+
7. Busque taxa hora freelance diretamente quando houver. Quando a fonte so tiver salario, aceite e normalize (ver Normalizacao)
|
|
125
|
+
|
|
126
|
+
### `comparables`
|
|
127
|
+
|
|
128
|
+
1. Ate 6 buscas, sem cadeia geografica (`level_used = null`, `levels_tried = []`). Priorize paginas de preco de produtos que atendem ao mesmo problema da `description`, no `country` e na `currency` informados
|
|
129
|
+
2. Unidade por modelo, fixada antes da busca: `assinatura` e `aluguel` usam `mes`; `licenca_perpetua` usa `licenca`; `loja_de_apps` segue `store_billing`: `assinatura` usa `mes` e `unica` usa `licenca`. Nao misture unidades em `sources`: fonte em unidade diferente da fixada vai para `skipped_sources` com motivo `unidade_diferente`, nunca decida a unidade pela maioria das fontes
|
|
130
|
+
3. Plano anual vira mensal dividindo por 12, com `derived = true` e `note` explicando. Plano por usuario fica como esta, com `note` "preco por usuario"
|
|
131
|
+
4. Produtos com varios planos: `value_min` e o plano mais barato pago e `value_max` o mais caro listado publicamente. Plano gratuito nao entra. Plano "fale conosco" sem numero nao entra
|
|
132
|
+
5. Registre em `note` o nome do plano e, se houver, a data da pagina
|
|
133
|
+
|
|
134
|
+
### `store_commission`
|
|
135
|
+
|
|
136
|
+
1. Ate 6 buscas, sem cadeia geografica. So documentacao oficial da loja e aceita: pagina de ajuda do console de desenvolvedor, contrato de distribuicao, pagina de programa para pequenos desenvolvedores
|
|
137
|
+
2. Unidade `percentual`. `value_min` e o menor percentual que a loja cobra (por exemplo, 15 no programa para pequenos desenvolvedores) e `value_max` o padrao ou maior (por exemplo, 30). Loja com percentual unico grava `value_min = value_max`
|
|
138
|
+
3. Procure pelo menos 2 paginas oficiais da mesma loja (ajuda mais contrato, ou ajuda mais programa). Noticia, blog e forum nao contam como fonte de comissao, mesmo com numero
|
|
139
|
+
4. Para `outra`, busque pelo nome informado; se nao houver pagina oficial com percentual, encerre com "Sem fontes aceitas"
|
|
140
|
+
5. `country` e `currency` nao filtram a comissao; registre em `note` quando a loja tiver percentual diferente por regiao
|
|
141
|
+
|
|
142
|
+
## Fontes aceitas e rejeitadas
|
|
143
|
+
|
|
144
|
+
Lista completa em `research-policy.md`, secao 4. Resumo:
|
|
145
|
+
|
|
146
|
+
Aceitas:
|
|
147
|
+
|
|
148
|
+
- portais de salario: Glassdoor, salario.com.br, Indeed, Payscale
|
|
149
|
+
- plataformas freelance: Upwork, Workana, 99freelas
|
|
150
|
+
- estatistica oficial: CAGED, BLS, INE e equivalentes do pais
|
|
151
|
+
- documentacao oficial da loja (para `store_commission`)
|
|
152
|
+
- paginas de preco de produtos (para `comparables`)
|
|
153
|
+
|
|
154
|
+
Rejeitadas, registradas em `skipped_sources` com `reason` canonico:
|
|
155
|
+
|
|
156
|
+
- forum ou comentario sem numero: `sem_numero`
|
|
157
|
+
- texto gerado por IA sem fonte identificavel: `texto_gerado_sem_fonte`
|
|
158
|
+
- pagina sem data identificavel (sem data de publicacao, atualizacao nem referencia de ano): `sem_data`
|
|
159
|
+
- fonte em moeda diferente de `currency`: `moeda_diferente`, nunca converter
|
|
160
|
+
- unidade incompativel com o modelo (ver comparables): `unidade_diferente`
|
|
161
|
+
- fonte fora do escopo pedido (outra senioridade, outro pais, outra categoria de produto): `fora_do_escopo`
|
|
162
|
+
|
|
163
|
+
Toda fonte aceita precisa de: `name`, `url`, `value_min`, `value_max`, `unit`, `derived`, `accessed_at` e `note` (pode ser `null`). Fonte com um unico numero grava `value_min = value_max`.
|
|
164
|
+
|
|
165
|
+
## Normalizacao
|
|
166
|
+
|
|
167
|
+
So em `hourly_rate`, e so quando a fonte nao traz taxa hora:
|
|
168
|
+
|
|
169
|
+
```
|
|
170
|
+
salario mensal -> taxa hora = salario_mensal / 160 (160 h/mes) derived = true
|
|
171
|
+
salario anual -> taxa hora = salario_anual / 1920 (1920 h/ano) derived = true
|
|
172
|
+
taxa hora direta -> sem conta derived = false
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
Arredonde para 2 casas. Escreva em `note` a conta feita ("salario mensal 8000 / 160"). Nunca some markup, imposto, encargos ou comissao aqui: isso e papel do profile e do estimate.
|
|
176
|
+
|
|
177
|
+
Em `comparables`, a unica normalizacao permitida e plano anual dividido por 12 (`derived = true`). Em `store_commission` nao ha normalizacao.
|
|
178
|
+
|
|
179
|
+
## Faixa e confianca
|
|
180
|
+
|
|
181
|
+
Com as fontes aceitas:
|
|
182
|
+
|
|
183
|
+
```
|
|
184
|
+
ponto_medio(fonte) = (value_min + value_max) / 2
|
|
185
|
+
faixa_min = menor value_min entre as fontes
|
|
186
|
+
faixa_max = maior value_max entre as fontes
|
|
187
|
+
faixa_mediana = mediana dos pontos medios
|
|
188
|
+
ratio = maior ponto_medio / menor ponto_medio
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
Confianca pelo `ratio`:
|
|
192
|
+
|
|
193
|
+
| ratio | confidence |
|
|
194
|
+
|---|---|
|
|
195
|
+
| menor que 2 | `high` |
|
|
196
|
+
| de 2 a 3 | `medium` |
|
|
197
|
+
| maior que 3 | `low` |
|
|
198
|
+
|
|
199
|
+
Menos de 2 fontes aceitas: `weak = true` e `confidence = "low"`, independentemente do ratio. Com 1 fonte, `faixa_min`, `faixa_max` e `faixa_mediana` vem dela mesma. Com 2 ou mais fontes, `weak = false`. Arredonde a faixa para 2 casas.
|
|
200
|
+
|
|
201
|
+
### Sem fontes aceitas
|
|
202
|
+
|
|
203
|
+
Se depois das buscas nenhuma fonte foi aceita: grave `available = false`, `reason = "sem_fontes_aceitas"`, mantenha `queries_run`, `levels_tried` e `skipped_sources` preenchidos, faixa e confianca `null`, `weak = true`. Avise: "Nao encontrei fonte aceitavel para essa pesquisa. Informe o valor manualmente no agente chamador." Se chamado por outro agente, devolva `available = false` e `reason` ao chamador conforme "Retorno ao agente chamador", sem Relatorio final nem CONTINUAR; so encerre com Relatorio final e CONTINUAR quando executado direto.
|
|
204
|
+
|
|
205
|
+
## Apresentacao
|
|
206
|
+
|
|
207
|
+
Mostre a tabela das fontes aceitas:
|
|
208
|
+
|
|
209
|
+
```
|
|
210
|
+
| Fonte | Valor | Unidade | Derivado | URL |
|
|
211
|
+
|---|---|---|---|---|
|
|
212
|
+
| <name> | <value_min> a <value_max> <currency ou %> | <unit> | sim ou nao | <url> |
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
Depois a linha literal:
|
|
216
|
+
|
|
217
|
+
```
|
|
218
|
+
Faixa: <faixa_min> a <faixa_max> <currency>, mediana <faixa_mediana>, nivel <level_used>, confianca <confidence>
|
|
219
|
+
```
|
|
220
|
+
|
|
221
|
+
Regras da linha: em `store_commission`, troque `<currency>` por `%`. Quando `level_used` for `null`, escreva `nivel nao se aplica`. Quando `weak = true`, acrescente ao fim: `(fraca: menos de 2 fontes)`.
|
|
222
|
+
|
|
223
|
+
Se houver fontes rejeitadas, mostre em seguida uma tabela curta `Fonte | Motivo | URL`. Mostre o numero de buscas feitas ("4 de 6 buscas").
|
|
224
|
+
|
|
225
|
+
Feche a apresentacao com a frase: "Isto e referencia de mercado, nao recomendacao de preco. O valor so entra no profile ou no product quando voce confirmar no agente chamador."
|
|
226
|
+
|
|
227
|
+
## Persistencia
|
|
228
|
+
|
|
229
|
+
Construa o JSON conforme `research-schema.json`:
|
|
230
|
+
|
|
231
|
+
```
|
|
232
|
+
schema_version = "1.0"
|
|
233
|
+
kind
|
|
234
|
+
created_at = <timestamp ISO 8601 UTC>
|
|
235
|
+
available
|
|
236
|
+
reason
|
|
237
|
+
inputs = { country, currency, seniority, region, description, model, store, store_billing }
|
|
238
|
+
level_used
|
|
239
|
+
levels_tried
|
|
240
|
+
queries_run
|
|
241
|
+
sources = [ { name, url, value_min, value_max, unit, derived, accessed_at, note } ]
|
|
242
|
+
skipped_sources = [ { name, url, reason } ]
|
|
243
|
+
faixa_min
|
|
244
|
+
faixa_max
|
|
245
|
+
faixa_mediana
|
|
246
|
+
confidence
|
|
247
|
+
weak
|
|
248
|
+
disclaimer_pt_br
|
|
249
|
+
```
|
|
250
|
+
|
|
251
|
+
Campos de input que nao se aplicam ao kind ficam `null` (por exemplo, `seniority` e `region` em `comparables`; `description` e `model` em `hourly_rate`; `store` e `store_billing` em `comparables` quando `model != loja_de_apps`; `store_billing` em `store_commission`). `disclaimer_pt_br` recebe o texto da secao "Disclaimer".
|
|
252
|
+
|
|
253
|
+
Valide mentalmente contra o schema. Grave `_reversa_sdd/_pricing/research/<kind>.json` e `_reversa_sdd/_pricing/research/<kind>.md` atomicamente.
|
|
254
|
+
|
|
255
|
+
Estrutura do `<kind>.md`:
|
|
256
|
+
|
|
257
|
+
```
|
|
258
|
+
# Pesquisa de mercado: <kind>
|
|
259
|
+
|
|
260
|
+
Gerado por reversa-pricing-research em <created_at>. Acesso as fontes em <accessed_at>.
|
|
261
|
+
|
|
262
|
+
## Entradas
|
|
263
|
+
| Campo | Valor | (um por input nao nulo)
|
|
264
|
+
|
|
265
|
+
## Resultado
|
|
266
|
+
Disponivel: sim ou nao (motivo quando nao)
|
|
267
|
+
Faixa: <linha literal da apresentacao>
|
|
268
|
+
Nivel tentado: <levels_tried>
|
|
269
|
+
|
|
270
|
+
## Fontes aceitas
|
|
271
|
+
<tabela Fonte | Valor | Unidade | Derivado | URL, com a coluna Nota quando houver>
|
|
272
|
+
|
|
273
|
+
## Fontes rejeitadas
|
|
274
|
+
<tabela Fonte | Motivo | URL, ou "nenhuma">
|
|
275
|
+
|
|
276
|
+
## Consultas executadas
|
|
277
|
+
<lista numerada de queries_run>
|
|
278
|
+
|
|
279
|
+
## Disclaimer
|
|
280
|
+
<texto da secao Disclaimer>
|
|
281
|
+
```
|
|
282
|
+
|
|
283
|
+
Estrutura do `<kind>.md` quando `available = false` (engine sem busca, busca falhou ou sem fontes aceitas):
|
|
284
|
+
|
|
285
|
+
```
|
|
286
|
+
# Pesquisa de mercado: <kind>
|
|
287
|
+
|
|
288
|
+
Gerado por reversa-pricing-research em <created_at>. Data da sessao: <data de hoje, AAAA-MM-DD>.
|
|
289
|
+
|
|
290
|
+
## Entradas
|
|
291
|
+
| Campo | Valor | (um por input nao nulo)
|
|
292
|
+
|
|
293
|
+
## Resultado
|
|
294
|
+
Disponivel: nao (<reason>)
|
|
295
|
+
Sem fontes: pesquisa nao realizada
|
|
296
|
+
Nivel tentado: <levels_tried, ou "nenhum">
|
|
297
|
+
|
|
298
|
+
## Fontes rejeitadas
|
|
299
|
+
<tabela Fonte | Motivo | URL, ou "nenhuma">
|
|
300
|
+
|
|
301
|
+
## Consultas executadas
|
|
302
|
+
<lista numerada de queries_run, ou "nenhuma">
|
|
303
|
+
|
|
304
|
+
## Disclaimer
|
|
305
|
+
<texto da secao Disclaimer, com "<accessed_at>" trocado pela data da sessao>
|
|
306
|
+
```
|
|
307
|
+
|
|
308
|
+
## Disclaimer
|
|
309
|
+
|
|
310
|
+
Texto de `disclaimer_pt_br` e da secao final do `.md`:
|
|
311
|
+
|
|
312
|
+
```
|
|
313
|
+
Referencia de mercado coletada na web em <accessed_at>, nao recomendacao de preco nem aconselhamento financeiro, juridico ou tributario. As fontes mudam e podem estar desatualizadas; confira a URL antes de decidir. Nenhum markup, imposto ou comissao foi somado aqui. O valor so entra no profile ou no product quando voce confirmar no agente chamador. Este arquivo pode conter dados de precificacao sensiveis; recomenda-se adicionar `_reversa_sdd/_pricing/research/` ao `.gitignore`.
|
|
314
|
+
```
|
|
315
|
+
|
|
316
|
+
## Regra de nao escrita em profile e product
|
|
317
|
+
|
|
318
|
+
Voce nunca grava, altera ou complementa `profile.json`, `profile.md`, `product.json`, `product.md`, `advisor.json` ou `advisor.md`. Mesmo quando o agente chamador esta executando estas instrucoes no contexto atual, o que voce devolve e a faixa; a pergunta de confirmacao e a gravacao no artefato final pertencem ao chamador. Se o usuario pedir para "ja colocar no profile", responda: "Quem grava no profile e o `/reversa-pricing-profile`, depois que voce confirmar o valor. Aqui eu so pesquiso."
|
|
319
|
+
|
|
320
|
+
## Retorno ao agente chamador
|
|
321
|
+
|
|
322
|
+
Quando estas instrucoes estao sendo executadas dentro do `reversa-pricing-profile` ou do `reversa-pricing-product`:
|
|
323
|
+
|
|
324
|
+
1. Apresente a tabela e a linha de faixa normalmente
|
|
325
|
+
2. Grave `<kind>.json` e `<kind>.md`
|
|
326
|
+
3. Devolva ao fluxo chamador: `available`, `reason`, `faixa_min`, `faixa_mediana`, `faixa_max`, `confidence`, `weak`, `level_used`, nomes das fontes aceitas, `sources[0].accessed_at` (ou `null` quando `sources` esta vazio) e o caminho absoluto do `<kind>.json`
|
|
327
|
+
4. Nao imprima o Relatorio final nem o CONTINUAR: o agente chamador continua com a pergunta de confirmacao dele
|
|
328
|
+
|
|
329
|
+
## Encerramento sem mudancas
|
|
330
|
+
|
|
331
|
+
Se o usuario cancelar durante a coleta de inputs ou antes da gravacao:
|
|
332
|
+
|
|
333
|
+
1. Nao grave nada
|
|
334
|
+
2. Se um backup foi criado, restaure `<kind>.json.bak.<timestamp>` e `<kind>.md.bak.<timestamp>` de volta para `<kind>.json` e `<kind>.md`
|
|
335
|
+
3. Confirme: "Pesquisa mantida sem alteracoes."
|
|
336
|
+
4. Quando executado direto, imprima o Relatorio final com os caminhos que existem e termine com CONTINUAR. Quando chamado por outro agente, devolva o que existe conforme "Retorno ao agente chamador"
|
|
337
|
+
|
|
338
|
+
## Relatorio final
|
|
339
|
+
|
|
340
|
+
Quando executado direto (nao dentro de outro agente), imprima:
|
|
341
|
+
|
|
342
|
+
1. Caminho absoluto de `<kind>.json`, se gravado
|
|
343
|
+
2. Caminho absoluto de `<kind>.md`, se gravado
|
|
344
|
+
3. Caminho do backup, se houve recalculo
|
|
345
|
+
4. A frase literal: "O valor so entra no profile ou no product quando voce confirmar no agente chamador."
|
|
346
|
+
5. Proximo passo:
|
|
347
|
+
- se a pesquisa foi pedida por um agente, voltar a ele: `/reversa-pricing-profile` para `hourly_rate`, `/reversa-pricing-product` para `comparables` e `store_commission`
|
|
348
|
+
- caso contrario, `/reversa-pricing` para ver o estado do time
|
|
349
|
+
|
|
350
|
+
Termine com:
|
|
351
|
+
|
|
352
|
+
> Digite **CONTINUAR** para prosseguir conforme a sugestao acima.
|
|
@@ -0,0 +1,213 @@
|
|
|
1
|
+
# Politica de pesquisa (research-policy.md)
|
|
2
|
+
|
|
3
|
+
**Versao da politica:** 1.0
|
|
4
|
+
**Data de referencia:** 2026-05
|
|
5
|
+
|
|
6
|
+
Documenta as regras que o agente `reversa-pricing-research` segue para buscar referencias de preco na web. E o unico agente do time de precificacao com acesso a internet; todos os outros leem o resultado gravado em `_pricing/research/<kind>.json`.
|
|
7
|
+
|
|
8
|
+
## Disclaimer obrigatorio
|
|
9
|
+
|
|
10
|
+
O resultado da pesquisa e referencia de mercado, nao recomendacao de preco. Fontes publicas trazem com frequencia salario mensal ou anual, nao taxa freelance direta; quando a linha deriva uma taxa hora a partir de salario, o campo `derived` deve ser `true` e a `note` deve mostrar a conta. Nenhum markup, imposto ou comissao e somado aqui. O valor so entra no profile ou no product depois que o usuario confirma no agente chamador.
|
|
11
|
+
|
|
12
|
+
## 1. Ferramenta de busca por engine
|
|
13
|
+
|
|
14
|
+
| Engine | Ferramenta de busca | Ferramenta de leitura de pagina | Como detectar |
|
|
15
|
+
|---|---|---|---|
|
|
16
|
+
| Claude Code | `WebSearch` | `WebFetch` | aparece na lista de ferramentas da sessao; pode estar adiada (deferred) e precisar ser carregada antes do uso |
|
|
17
|
+
| Codex | busca web nativa do Codex | leitura de URL do Codex | a sessao expoe uma ferramenta de busca na web; se o ambiente estiver sem rede, ela nao aparece ou falha |
|
|
18
|
+
| Gemini CLI | `google_web_search` | `web_fetch` | aparece na lista de ferramentas da sessao |
|
|
19
|
+
| Cursor | `@web` | abrir URL pelo proprio `@web` | o contexto aceita a mencao `@web` |
|
|
20
|
+
| Outro engine | qualquer ferramenta cuja funcao seja buscar na web | qualquer ferramenta que abra URL | verificar a lista de ferramentas; nome diferente nao importa, a funcao importa |
|
|
21
|
+
|
|
22
|
+
Regras:
|
|
23
|
+
|
|
24
|
+
1. Leitura de pagina sem busca nao conta como busca. Serve apenas para abrir a URL encontrada e confirmar o numero
|
|
25
|
+
2. Sem ferramenta de busca na sessao: gravar `available = false`, `reason = "engine_sem_busca"`, avisar "Este engine nao tem busca na web. Informe o valor manualmente no agente chamador." e encerrar
|
|
26
|
+
3. Ferramenta presente mas todas as buscas com erro: gravar `available = false`, `reason = "busca_falhou"`, manter `queries_run` com as consultas tentadas
|
|
27
|
+
4. Nunca inventar fonte, URL, numero ou data. Numero de memoria nao substitui busca
|
|
28
|
+
|
|
29
|
+
## 2. Limite de buscas
|
|
30
|
+
|
|
31
|
+
| Regra | Valor |
|
|
32
|
+
|---|---|
|
|
33
|
+
| Buscas por execucao | ate 6 |
|
|
34
|
+
| Buscas por nivel geografico (`hourly_rate`) | ate 2 |
|
|
35
|
+
| Registro | toda consulta executada vai em `queries_run`, com ou sem resultado util |
|
|
36
|
+
|
|
37
|
+
Leitura de pagina (abrir URL encontrada) nao conta no limite de 6, mas abra apenas paginas que apareceram em uma busca registrada.
|
|
38
|
+
|
|
39
|
+
## 3. Cadeia geografica (so `hourly_rate`)
|
|
40
|
+
|
|
41
|
+
| Ordem | Nivel | Quando tentar | Aceitar quando |
|
|
42
|
+
|---|---|---|---|
|
|
43
|
+
| 1 | `cidade` | `region.city` informado | pelo menos 2 fontes aceitas com numero |
|
|
44
|
+
| 2 | `estado` | `region.state` informado | pelo menos 2 fontes aceitas com numero |
|
|
45
|
+
| 3 | `pais` | sempre | pelo menos 2 fontes aceitas com numero |
|
|
46
|
+
|
|
47
|
+
Regras:
|
|
48
|
+
|
|
49
|
+
1. Em cada nivel, ate 2 buscas. Ao atingir 2 fontes aceitas, parar e gravar `level_used` com esse nivel
|
|
50
|
+
2. Nivel que nao atingiu 2 fontes entra em `levels_tried` e as fontes aceitas que ele produziu ficam guardadas, com `note` indicando o nivel ("nivel cidade")
|
|
51
|
+
3. Se nenhum nivel atingiu 2 fontes, `level_used` e o nivel mais especifico que produziu pelo menos 1 fonte aceita, e `weak = true`
|
|
52
|
+
4. Se nenhum nivel produziu fonte aceita, `available = false`, `reason = "sem_fontes_aceitas"`
|
|
53
|
+
5. Avisar o usuario antes de comecar que dado por cidade e escasso e que o pais costuma ser o nivel que funciona
|
|
54
|
+
6. `comparables` e `store_commission` nao usam a cadeia: `level_used = null`, `levels_tried = []`
|
|
55
|
+
|
|
56
|
+
## 4. Fontes aceitas e rejeitadas
|
|
57
|
+
|
|
58
|
+
### Aceitas
|
|
59
|
+
|
|
60
|
+
| Categoria | Exemplos | Serve para | Unidade tipica |
|
|
61
|
+
|---|---|---|---|
|
|
62
|
+
| Portal de salario | Glassdoor, salario.com.br, Indeed, Payscale | `hourly_rate` | `mes` ou ano, normalizar para `hora` |
|
|
63
|
+
| Plataforma freelance | Upwork, Workana, 99freelas | `hourly_rate` | `hora` |
|
|
64
|
+
| Estatistica oficial | CAGED (BR), BLS (US), INE (PT, ES) e equivalentes do pais | `hourly_rate` | `mes`, ano ou `hora` |
|
|
65
|
+
| Documentacao oficial da loja | Google Play Console Help, Apple Developer, Microsoft Learn, Steamworks Documentation | `store_commission` | `percentual` |
|
|
66
|
+
| Pagina de preco de produto | pagina "precos" ou "planos" do proprio produto, loja do produto | `comparables` | `mes` ou `licenca` |
|
|
67
|
+
|
|
68
|
+
Toda fonte aceita precisa de nome, URL, numero, unidade, data de acesso e, quando houver, data de publicacao ou atualizacao em `note`.
|
|
69
|
+
|
|
70
|
+
### Rejeitadas
|
|
71
|
+
|
|
72
|
+
| Situacao | `reason` em `skipped_sources` | Regra |
|
|
73
|
+
|---|---|---|
|
|
74
|
+
| Forum, comentario ou pergunta sem numero | `sem_numero` | registrar e seguir |
|
|
75
|
+
| Texto gerado por IA sem fonte identificavel | `texto_gerado_sem_fonte` | registrar e seguir |
|
|
76
|
+
| Pagina sem data identificavel (sem data de publicacao, atualizacao nem referencia de ano) | `sem_data` | registrar e seguir |
|
|
77
|
+
| Fonte em moeda diferente de `currency` | `moeda_diferente` | registrar, nunca converter |
|
|
78
|
+
| Unidade incompativel com o modelo pedido em `comparables` | `unidade_diferente` | manter a unidade da maioria das fontes |
|
|
79
|
+
| Fora do escopo (outra senioridade, outro pais, outra categoria de produto, outra loja) | `fora_do_escopo` | registrar e seguir |
|
|
80
|
+
| Noticia, blog ou forum com percentual de comissao | `fora_do_escopo` | em `store_commission` so pagina oficial conta |
|
|
81
|
+
|
|
82
|
+
## 5. Normalizacao
|
|
83
|
+
|
|
84
|
+
| Entrada da fonte | Conta | `derived` | Onde vale |
|
|
85
|
+
|---|---|---|---|
|
|
86
|
+
| taxa hora direta | nenhuma | `false` | `hourly_rate` |
|
|
87
|
+
| salario mensal | dividir por 160 (160 h/mes) | `true` | `hourly_rate` |
|
|
88
|
+
| salario anual | dividir por 1920 (1920 h/ano) | `true` | `hourly_rate` |
|
|
89
|
+
| plano anual | dividir por 12 | `true` | `comparables` |
|
|
90
|
+
| preco mensal, por licenca ou percentual | nenhuma | `false` | `comparables`, `store_commission` |
|
|
91
|
+
|
|
92
|
+
Regras:
|
|
93
|
+
|
|
94
|
+
1. Arredondar para 2 casas
|
|
95
|
+
2. Escrever a conta em `note` ("salario mensal 8000 / 160")
|
|
96
|
+
3. Nunca somar markup, imposto, encargos ou comissao. Isso e papel do profile, do estimate e do product
|
|
97
|
+
4. Nunca converter moeda. Fonte em outra moeda e rejeitada
|
|
98
|
+
5. Fonte com um unico numero grava `value_min = value_max`
|
|
99
|
+
6. Fonte cujo valor seja 0 (plano gratuito, "a combinar") nao e aceita: vai para `skipped_sources` com `reason = "sem_numero"`. Assim o ratio da confianca nunca divide por zero
|
|
100
|
+
|
|
101
|
+
## 6. Confianca
|
|
102
|
+
|
|
103
|
+
```
|
|
104
|
+
ponto_medio(fonte) = (value_min + value_max) / 2
|
|
105
|
+
ratio = maior ponto_medio / menor ponto_medio (entre as fontes aceitas)
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
| Condicao | `confidence` | `weak` |
|
|
109
|
+
|---|---|---|
|
|
110
|
+
| 2 ou mais fontes e ratio menor que 2 | `high` | `false` |
|
|
111
|
+
| 2 ou mais fontes e ratio de 2 a 3 | `medium` | `false` |
|
|
112
|
+
| 2 ou mais fontes e ratio maior que 3 | `low` | `false` |
|
|
113
|
+
| 1 fonte aceita | `low` | `true` |
|
|
114
|
+
| 0 fontes aceitas | `null` (com `available = false`) | `true` |
|
|
115
|
+
|
|
116
|
+
Faixa:
|
|
117
|
+
|
|
118
|
+
```
|
|
119
|
+
faixa_min = menor value_min entre as fontes aceitas
|
|
120
|
+
faixa_max = maior value_max entre as fontes aceitas
|
|
121
|
+
faixa_mediana = mediana dos pontos medios
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
## 7. Data de acesso
|
|
125
|
+
|
|
126
|
+
`accessed_at` e a data de hoje conhecida pela sessao, no formato `AAAA-MM-DD`, igual em todas as fontes da execucao. Se a sessao nao souber a data, perguntar ao usuario: "Qual a data de hoje? Formato AAAA-MM-DD." A data de publicacao da fonte, quando houver, vai em `note`, nunca em `accessed_at`.
|
|
127
|
+
|
|
128
|
+
## 8. Apresentacao
|
|
129
|
+
|
|
130
|
+
Tabela das fontes aceitas:
|
|
131
|
+
|
|
132
|
+
```
|
|
133
|
+
| Fonte | Valor | Unidade | Derivado | URL |
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
Depois a linha:
|
|
137
|
+
|
|
138
|
+
```
|
|
139
|
+
Faixa: <faixa_min> a <faixa_max> <currency>, mediana <faixa_mediana>, nivel <level_used>, confianca <confidence>
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
Em `store_commission`, `<currency>` vira `%`. `level_used` nulo vira `nao se aplica`. Com `weak = true`, acrescentar `(fraca: menos de 2 fontes)`. Fechar lembrando que e referencia, nao recomendacao.
|
|
143
|
+
|
|
144
|
+
## 9. Gravacao
|
|
145
|
+
|
|
146
|
+
| Regra | Valor |
|
|
147
|
+
|---|---|
|
|
148
|
+
| Pasta unica de escrita | `<output_folder>/_pricing/research/` |
|
|
149
|
+
| Arquivos | `<kind>.json` e `<kind>.md` |
|
|
150
|
+
| Recalculo | perguntar "Ja existe research/<kind>.json. Deseja recalcular? S/N"; "N" encerra sem mudancas; "S" renomeia para `<arquivo>.bak.<YYYYMMDD-HHMMSS>` antes de gravar |
|
|
151
|
+
| Escrita | atomica (tempfile mais rename), UTF-8 sem BOM |
|
|
152
|
+
| Proibido | escrever em `profile.json`, `product.json`, `advisor.json`, codigo legado, Discovery, Forward ou `.reversa/` |
|
|
153
|
+
|
|
154
|
+
## 10. Exemplos de consultas por kind
|
|
155
|
+
|
|
156
|
+
Substituir os campos entre `<>` pelos inputs. Usar pt-br para paises de lingua portuguesa e ingles para os demais ou quando a fonte for internacional (Upwork, Payscale, BLS, documentacao de loja). Rotulo leigo de senioridade em pt-br: junior -> "junior", mid -> "pleno", senior -> "senior", staff_lead -> "lider tecnico", principal -> "principal". Em ingles: junior -> "junior", mid -> "mid-level", senior -> "senior", staff_lead -> "staff" ou "lead", principal -> "principal".
|
|
157
|
+
|
|
158
|
+
### `hourly_rate`
|
|
159
|
+
|
|
160
|
+
pt-br:
|
|
161
|
+
|
|
162
|
+
1. `valor hora desenvolvedor <senioridade leiga> <cidade> <estado> <ano>`
|
|
163
|
+
2. `salario desenvolvedor <senioridade leiga> <estado> glassdoor OR salario.com.br`
|
|
164
|
+
3. `freelancer desenvolvedor <senioridade leiga> valor hora <pais> workana OR 99freelas`
|
|
165
|
+
|
|
166
|
+
ingles:
|
|
167
|
+
|
|
168
|
+
1. `software developer hourly rate <city> <country> <seniority> <ano>`
|
|
169
|
+
2. `<seniority> software developer salary <state> glassdoor OR payscale OR indeed`
|
|
170
|
+
3. `upwork software developer hourly rate <country> <seniority>`
|
|
171
|
+
|
|
172
|
+
Ordem sugerida na cadeia: consulta 1 no nivel cidade, consulta 2 no nivel estado, consulta 3 no nivel pais, completando cada nivel com a segunda busca quando a primeira trouxer menos de 2 fontes.
|
|
173
|
+
|
|
174
|
+
### `comparables`
|
|
175
|
+
|
|
176
|
+
pt-br:
|
|
177
|
+
|
|
178
|
+
1. `<descricao> precos planos assinatura mensal`
|
|
179
|
+
2. `software <descricao> quanto custa licenca`
|
|
180
|
+
3. `alternativas a <descricao> preco <pais>`
|
|
181
|
+
|
|
182
|
+
ingles:
|
|
183
|
+
|
|
184
|
+
1. `<description> pricing plans per month`
|
|
185
|
+
2. `<description> software one-time license price`
|
|
186
|
+
3. `<description> alternatives pricing <country>`
|
|
187
|
+
|
|
188
|
+
Para `loja_de_apps`, acrescentar o nome da loja a consulta (`google play`, `app store`, `microsoft store`, `steam`) e preferir a pagina do produto dentro da loja.
|
|
189
|
+
|
|
190
|
+
### `store_commission`
|
|
191
|
+
|
|
192
|
+
pt-br:
|
|
193
|
+
|
|
194
|
+
1. `comissao google play desenvolvedor percentual taxa de servico`
|
|
195
|
+
2. `taxa app store small business program percentual`
|
|
196
|
+
3. `comissao microsoft store apps percentual`
|
|
197
|
+
|
|
198
|
+
ingles:
|
|
199
|
+
|
|
200
|
+
1. `google play service fee percentage developer`
|
|
201
|
+
2. `app store commission small business program`
|
|
202
|
+
3. `steam revenue share distribution agreement`
|
|
203
|
+
|
|
204
|
+
Para `outra`, usar `<nome da loja> developer commission percentage` e `<nome da loja> comissao desenvolvedor`. So a pagina oficial da loja conta.
|
|
205
|
+
|
|
206
|
+
## 11. Como estender
|
|
207
|
+
|
|
208
|
+
Para adicionar engine, fonte ou kind:
|
|
209
|
+
|
|
210
|
+
1. Engine novo: acrescentar linha na tabela da secao 1 com ferramenta de busca, ferramenta de leitura e como detectar
|
|
211
|
+
2. Fonte nova: acrescentar na tabela de aceitas com categoria, kind que atende e unidade tipica; fonte sem numero ou sem data continua rejeitada
|
|
212
|
+
3. Kind novo: definir inputs, unidade de saida, se usa cadeia geografica, exemplos de consulta (3 em pt-br e 3 em ingles) e acrescentar o valor ao enum `kind` em `research-schema.json`
|
|
213
|
+
4. Mudanca de regra de confianca, normalizacao ou limite de buscas: bump na versao da politica e no `schema_version` quando o JSON mudar
|