@caoscompanybr/merlin 3.5.0
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/.claude/CLAUDE.md +216 -0
- package/.claude/hooks/README-license-gate.md +45 -0
- package/.claude/hooks/auto-summarize.js +47 -0
- package/.claude/hooks/context-monitor.js +60 -0
- package/.claude/hooks/doc-sync.js +111 -0
- package/.claude/hooks/license-gate.cjs +59 -0
- package/.claude/hooks/session-reset.js +27 -0
- package/.claude/hooks/thoughts-indexer.js +80 -0
- package/.claude/rules/merlin-constitution.md +27 -0
- package/.merlin-core/commands/README.md +19 -0
- package/.merlin-core/commands/founder-mode.md +51 -0
- package/.merlin-core/commands/git/commit.md +35 -0
- package/.merlin-core/commands/git/describe-pr.md +43 -0
- package/.merlin-core/commands/git/safe-commit.md +182 -0
- package/.merlin-core/commands/implementation/implement-plan.md +129 -0
- package/.merlin-core/commands/implementation/oneshot.md +63 -0
- package/.merlin-core/commands/implementation/tdd.md +152 -0
- package/.merlin-core/commands/planning/create-plan.md +184 -0
- package/.merlin-core/commands/planning/iterate-plan.md +45 -0
- package/.merlin-core/commands/planning/validate-plan.md +48 -0
- package/.merlin-core/commands/research/analyze-issue.md +155 -0
- package/.merlin-core/commands/research/research-codebase.md +157 -0
- package/.merlin-core/commands/review/adversarial-review.md +112 -0
- package/.merlin-core/commands/review/check.md +91 -0
- package/.merlin-core/commands/review/debug.md +135 -0
- package/.merlin-core/commands/review/doubts.md +178 -0
- package/.merlin-core/commands/review/engineering-audit.md +87 -0
- package/.merlin-core/commands/review/local-review.md +48 -0
- package/.merlin-core/commands/review/verify-goals.md +83 -0
- package/.merlin-core/commands/session/capture-feedback.md +74 -0
- package/.merlin-core/commands/session/capture-learning.md +155 -0
- package/.merlin-core/commands/session/check-objectives.md +85 -0
- package/.merlin-core/commands/session/conclude.md +125 -0
- package/.merlin-core/commands/session/create-handoff.md +88 -0
- package/.merlin-core/commands/session/create-objective.md +111 -0
- package/.merlin-core/commands/session/create-process.md +105 -0
- package/.merlin-core/commands/session/create-reminder.md +86 -0
- package/.merlin-core/commands/session/fast-start.md +261 -0
- package/.merlin-core/commands/session/recall-learnings.md +79 -0
- package/.merlin-core/commands/session/recall-processes.md +74 -0
- package/.merlin-core/commands/session/resume-handoff.md +51 -0
- package/.merlin-core/commands/session/run-process.md +53 -0
- package/.merlin-core/commands/special/beauty.md +89 -0
- package/.merlin-core/commands/special/common-ground.md +114 -0
- package/.merlin-core/commands/special/elicit.md +98 -0
- package/.merlin-core/commands/special/party.md +66 -0
- package/.merlin-core/commands/special/scrape.md +78 -0
- package/.merlin-core/commands/special/skill-audit.md +128 -0
- package/.merlin-core/commands/special/start-here.md +132 -0
- package/.merlin-core/constitution.md +442 -0
- package/.merlin-core/core/README.md +19 -0
- package/.merlin-core/core/alkimia/README.md +20 -0
- package/.merlin-core/core/alkimia/context/context-tracker.js +209 -0
- package/.merlin-core/core/alkimia/domain/domain-loader.js +215 -0
- package/.merlin-core/core/alkimia/engine.js +284 -0
- package/.merlin-core/core/alkimia/layers/l0-constitution.js +47 -0
- package/.merlin-core/core/alkimia/layers/l1-global.js +58 -0
- package/.merlin-core/core/alkimia/layers/l2-agent.js +58 -0
- package/.merlin-core/core/alkimia/layers/l3-workflow.js +54 -0
- package/.merlin-core/core/alkimia/layers/l4-task.js +45 -0
- package/.merlin-core/core/alkimia/layers/l5-squad.js +161 -0
- package/.merlin-core/core/alkimia/layers/l6-skill.js +520 -0
- package/.merlin-core/core/alkimia/layers/l7-star-command.js +87 -0
- package/.merlin-core/core/alkimia/layers/layer-processor.js +78 -0
- package/.merlin-core/core/alkimia/mandate.js +46 -0
- package/.merlin-core/core/alkimia/memory/doc-sync.js +201 -0
- package/.merlin-core/core/alkimia/memory/document-sharder.js +272 -0
- package/.merlin-core/core/alkimia/memory/git-history-retriever.js +225 -0
- package/.merlin-core/core/alkimia/memory/memory-bridge.js +97 -0
- package/.merlin-core/core/alkimia/memory/session-analyzer.js +400 -0
- package/.merlin-core/core/alkimia/memory/thoughts-indexer.js +477 -0
- package/.merlin-core/core/alkimia/memory/thoughts-provider.js +603 -0
- package/.merlin-core/core/alkimia/output/formatter.js +464 -0
- package/.merlin-core/core/alkimia/security/content-sanitizer.js +140 -0
- package/.merlin-core/core/alkimia/skill-importer.js +440 -0
- package/.merlin-core/core/alkimia/squads/default/.synapse/manifest +17 -0
- package/.merlin-core/core/alkimia/utils/frontmatter.js +321 -0
- package/.merlin-core/core/alkimia/utils/tokens.js +24 -0
- package/.merlin-core/core/approval/README.md +16 -0
- package/.merlin-core/core/approval/approval-engine.js +380 -0
- package/.merlin-core/core/approval/channels/cli-channel.js +50 -0
- package/.merlin-core/core/config/README.md +17 -0
- package/.merlin-core/core/config/config-cache.js +182 -0
- package/.merlin-core/core/config/config-loader.js +279 -0
- package/.merlin-core/core/config/config-resolver.js +411 -0
- package/.merlin-core/core/config/env-interpolator.js +123 -0
- package/.merlin-core/core/config/merge-utils.js +102 -0
- package/.merlin-core/core/config/schemas/core-config.schema.json +41 -0
- package/.merlin-core/core/config/schemas/framework-config.schema.json +24 -0
- package/.merlin-core/core/config/schemas/local-config.schema.json +23 -0
- package/.merlin-core/core/config/schemas/project-config.schema.json +189 -0
- package/.merlin-core/core/docs-consistency.js +140 -0
- package/.merlin-core/core/events/event-bus.js +344 -0
- package/.merlin-core/core/events/hook-handler.js +419 -0
- package/.merlin-core/core/execution/README.md +17 -0
- package/.merlin-core/core/execution/attempt-journal.js +380 -0
- package/.merlin-core/core/execution/autonomous-build-loop.js +637 -0
- package/.merlin-core/core/execution/build-orchestrator.js +296 -0
- package/.merlin-core/core/execution/build-state-manager.js +196 -0
- package/.merlin-core/core/execution/context-injector.js +204 -0
- package/.merlin-core/core/execution/cron-engine.js +247 -0
- package/.merlin-core/core/execution/cron-expression.js +148 -0
- package/.merlin-core/core/execution/env-preflight.js +423 -0
- package/.merlin-core/core/execution/guardrail-engine.js +745 -0
- package/.merlin-core/core/execution/heartbeat-engine.js +198 -0
- package/.merlin-core/core/execution/model-router.js +282 -0
- package/.merlin-core/core/execution/parallel-executor.js +378 -0
- package/.merlin-core/core/execution/parallel-monitor.js +201 -0
- package/.merlin-core/core/execution/party-session.js +311 -0
- package/.merlin-core/core/execution/rate-limit-manager.js +152 -0
- package/.merlin-core/core/execution/result-aggregator.js +215 -0
- package/.merlin-core/core/execution/semantic-merge-engine.js +320 -0
- package/.merlin-core/core/execution/subagent-dispatcher.js +721 -0
- package/.merlin-core/core/execution/success-verifier.js +227 -0
- package/.merlin-core/core/execution/task-metadata.js +105 -0
- package/.merlin-core/core/execution/team-executor.js +195 -0
- package/.merlin-core/core/execution/two-tier-editor.js +290 -0
- package/.merlin-core/core/execution/version-snapshot.js +294 -0
- package/.merlin-core/core/execution/wave-executor.js +224 -0
- package/.merlin-core/core/health-check/health-engine.js +415 -0
- package/.merlin-core/core/licensing/activation.js +281 -0
- package/.merlin-core/core/licensing/crc.js +103 -0
- package/.merlin-core/core/licensing/entitlement.js +99 -0
- package/.merlin-core/core/licensing/fingerprint.js +104 -0
- package/.merlin-core/core/licensing/gate.js +133 -0
- package/.merlin-core/core/licensing/hmac.js +42 -0
- package/.merlin-core/core/licensing/key.js +144 -0
- package/.merlin-core/core/licensing/license.js +212 -0
- package/.merlin-core/core/mcp/README.md +16 -0
- package/.merlin-core/core/mcp/browser-capability.js +191 -0
- package/.merlin-core/core/mcp/capability-mapper.js +92 -0
- package/.merlin-core/core/mcp/mcp-connector.js +278 -0
- package/.merlin-core/core/mcp/mcp-registry.js +101 -0
- package/.merlin-core/core/orchestration/README.md +17 -0
- package/.merlin-core/core/orchestration/agent-invoker.js +456 -0
- package/.merlin-core/core/orchestration/condition-evaluator.js +250 -0
- package/.merlin-core/core/orchestration/decision-tree.js +192 -0
- package/.merlin-core/core/orchestration/executor-assignment.js +372 -0
- package/.merlin-core/core/orchestration/gate-evaluator.js +653 -0
- package/.merlin-core/core/orchestration/intent-classifier.js +579 -0
- package/.merlin-core/core/orchestration/lock-manager.js +308 -0
- package/.merlin-core/core/orchestration/master-orchestrator.js +363 -0
- package/.merlin-core/core/orchestration/phase-tool-masks.js +194 -0
- package/.merlin-core/core/orchestration/recovery-handler.js +402 -0
- package/.merlin-core/core/orchestration/reflect-checkpoint.js +431 -0
- package/.merlin-core/core/orchestration/session-state.js +430 -0
- package/.merlin-core/core/orchestration/skill-dispatcher.js +255 -0
- package/.merlin-core/core/orchestration/step-loader.js +226 -0
- package/.merlin-core/core/orchestration/workflow-executor.js +864 -0
- package/.merlin-core/core/process/executor.js +231 -0
- package/.merlin-core/core/process/process-file.js +50 -0
- package/.merlin-core/core/process/secret-scan.js +86 -0
- package/.merlin-core/core/process/signature.js +77 -0
- package/.merlin-core/core/quality-gates/README.md +17 -0
- package/.merlin-core/core/quality-gates/layer1-precommit.js +110 -0
- package/.merlin-core/core/quality-gates/layer2-pr-automation.js +116 -0
- package/.merlin-core/core/quality-gates/layer3-human-review.js +133 -0
- package/.merlin-core/core/registry/service-registry.js +140 -0
- package/.merlin-core/core-config.yaml +159 -0
- package/.merlin-core/development/README.md +17 -0
- package/.merlin-core/development/agents/README.md +16 -0
- package/.merlin-core/development/agents/analyst.md +214 -0
- package/.merlin-core/development/agents/architect.md +166 -0
- package/.merlin-core/development/agents/data-engineer.md +154 -0
- package/.merlin-core/development/agents/dev.md +203 -0
- package/.merlin-core/development/agents/devops.md +236 -0
- package/.merlin-core/development/agents/grimorio.md +125 -0
- package/.merlin-core/development/agents/merlin-master.md +173 -0
- package/.merlin-core/development/agents/meta.md +190 -0
- package/.merlin-core/development/agents/pm.md +145 -0
- package/.merlin-core/development/agents/po.md +172 -0
- package/.merlin-core/development/agents/qa.md +275 -0
- package/.merlin-core/development/agents/researcher.md +218 -0
- package/.merlin-core/development/agents/scout.md +179 -0
- package/.merlin-core/development/agents/sm.md +148 -0
- package/.merlin-core/development/agents/ux.md +169 -0
- package/.merlin-core/development/agents/web-researcher.md +203 -0
- package/.merlin-core/development/checklists/adversarial-review-checklist.md +70 -0
- package/.merlin-core/development/checklists/operations-ci-checklist.md +40 -0
- package/.merlin-core/development/checklists/operations-deploy-checklist.md +54 -0
- package/.merlin-core/development/checklists/operations-publish-checklist.md +47 -0
- package/.merlin-core/development/checklists/source-verification-checklist.md +38 -0
- package/.merlin-core/development/templates/HEARTBEAT-template.md +46 -0
- package/.merlin-core/development/templates/ears-requirements-template.md +93 -0
- package/.merlin-core/development/templates/handoff-template.md +50 -0
- package/.merlin-core/development/templates/prd-template.md +62 -0
- package/.merlin-core/development/templates/research-template.md +53 -0
- package/.merlin-core/development/templates/spec-template.md +84 -0
- package/.merlin-core/development/workflows/brownfield-discovery.yaml +166 -0
- package/.merlin-core/development/workflows/brownfield-service.yaml +52 -0
- package/.merlin-core/development/workflows/development-cycle.yaml +57 -0
- package/.merlin-core/development/workflows/epic-orchestration.yaml +47 -0
- package/.merlin-core/development/workflows/folloni-funnel.yaml +177 -0
- package/.merlin-core/development/workflows/greenfield-fullstack.yaml +167 -0
- package/.merlin-core/development/workflows/greenfield-service.yaml +56 -0
- package/.merlin-core/development/workflows/qa-loop.yaml +115 -0
- package/.merlin-core/development/workflows/spec-pipeline.yaml +185 -0
- package/.merlin-core/development/workflows/steps/folloni-01-research.yaml +35 -0
- package/.merlin-core/development/workflows/steps/folloni-02-architecture.yaml +41 -0
- package/.merlin-core/development/workflows/steps/folloni-03-implementation.yaml +52 -0
- package/.merlin-core/development/workflows/story-development-cycle.yaml +67 -0
- package/.merlin-core/docs/GUIDE.md +413 -0
- package/.merlin-core/docs/merlin-commands-guide-pt.md +183 -0
- package/.merlin-core/framework-config.yaml +148 -0
- package/.merlin-core/hooks/README.md +16 -0
- package/.merlin-core/hooks/precompact-memory-flush.js +69 -0
- package/.merlin-core/hooks/pretooluse-remote-approve.js +113 -0
- package/.merlin-core/hooks/spikes/spike-b-hook.js +70 -0
- package/.merlin-core/hooks/spikes/spike-b-stub.js +70 -0
- package/.merlin-core/index.js +91 -0
- package/.merlin-core/local-config.yaml.template +31 -0
- package/.merlin-core/mcp-servers/lsp-bridge/index.js +397 -0
- package/.merlin-core/modules/scraping/module.json +23 -0
- package/.merlin-core/project-config.yaml +89 -0
- package/.merlin-core/schemas/README.md +18 -0
- package/.merlin-core/schemas/agent-hook-schema.json +152 -0
- package/.merlin-core/schemas/agent-schema.json +31 -0
- package/.merlin-core/schemas/command-schema.json +18 -0
- package/.merlin-core/schemas/feedback-schema.json +36 -0
- package/.merlin-core/schemas/handoff-schema.json +19 -0
- package/.merlin-core/schemas/learning-schema.json +51 -0
- package/.merlin-core/schemas/module.schema.json +124 -0
- package/.merlin-core/schemas/must-haves-schema.json +95 -0
- package/.merlin-core/schemas/objective-schema.json +23 -0
- package/.merlin-core/schemas/plan-schema.json +20 -0
- package/.merlin-core/schemas/process-schema.json +82 -0
- package/.merlin-core/schemas/reminder-schema.json +20 -0
- package/.merlin-core/schemas/skill-eval-schema.json +92 -0
- package/.merlin-core/schemas/skill-schema.json +77 -0
- package/.merlin-core/schemas/workflow-schema.json +38 -0
- package/.merlin-core/skills/README.md +16 -0
- package/.merlin-core/skills/domain/azure-cloud/SKILL.md +211 -0
- package/.merlin-core/skills/domain/azure-cloud/references/appinsights-instrumentation.md +63 -0
- package/.merlin-core/skills/domain/azure-cloud/references/azure-compliance.md +99 -0
- package/.merlin-core/skills/domain/azure-cloud/references/azure-cost-optimization.md +419 -0
- package/.merlin-core/skills/domain/azure-cloud/references/azure-deploy.md +82 -0
- package/.merlin-core/skills/domain/azure-cloud/references/azure-diagnostics.md +130 -0
- package/.merlin-core/skills/domain/azure-cloud/references/azure-prepare.md +134 -0
- package/.merlin-core/skills/domain/azure-cloud/references/azure-quotas.md +290 -0
- package/.merlin-core/skills/domain/azure-cloud/references/azure-rbac.md +11 -0
- package/.merlin-core/skills/domain/azure-cloud/references/azure-resource-lookup.md +97 -0
- package/.merlin-core/skills/domain/azure-cloud/references/azure-resource-visualizer.md +178 -0
- package/.merlin-core/skills/domain/azure-cloud/references/azure-storage.md +91 -0
- package/.merlin-core/skills/domain/azure-cloud/references/azure-validate.md +58 -0
- package/.merlin-core/skills/domain/azure-cloud/references/entra-app-registration.md +192 -0
- package/.merlin-core/skills/domain/browser-automation/SKILL.md +311 -0
- package/.merlin-core/skills/domain/browser-automation/references/agent-browser-skill.md +632 -0
- package/.merlin-core/skills/domain/browser-automation/references/authentication.md +308 -0
- package/.merlin-core/skills/domain/browser-automation/references/commands.md +266 -0
- package/.merlin-core/skills/domain/browser-automation/references/profiling.md +120 -0
- package/.merlin-core/skills/domain/browser-automation/references/proxy-support.md +194 -0
- package/.merlin-core/skills/domain/browser-automation/references/session-management.md +194 -0
- package/.merlin-core/skills/domain/browser-automation/references/snapshot-refs.md +196 -0
- package/.merlin-core/skills/domain/browser-automation/references/video-recording.md +173 -0
- package/.merlin-core/skills/domain/browser-automation/templates/authenticated-session.sh +105 -0
- package/.merlin-core/skills/domain/browser-automation/templates/capture-workflow.sh +69 -0
- package/.merlin-core/skills/domain/browser-automation/templates/form-automation.sh +62 -0
- package/.merlin-core/skills/domain/digital-marketing/SKILL.md +292 -0
- package/.merlin-core/skills/domain/digital-marketing/references/content-strategy.md +320 -0
- package/.merlin-core/skills/domain/digital-marketing/references/copy-formats.md +298 -0
- package/.merlin-core/skills/domain/digital-marketing/references/copy-methodology.md +180 -0
- package/.merlin-core/skills/domain/digital-marketing/references/email-sequences.md +135 -0
- package/.merlin-core/skills/domain/digital-marketing/references/launch-strategy.md +213 -0
- package/.merlin-core/skills/domain/digital-marketing/references/pricing-strategy.md +160 -0
- package/.merlin-core/skills/domain/digital-marketing/references/programmatic-seo.md +237 -0
- package/.merlin-core/skills/domain/digital-marketing/references/revops-lifecycle.md +170 -0
- package/.merlin-core/skills/domain/digital-marketing/references/revops-operations.md +167 -0
- package/.merlin-core/skills/domain/digital-marketing/references/schema-markup.md +190 -0
- package/.merlin-core/skills/domain/digital-marketing/references/strategy-frameworks.md +324 -0
- package/.merlin-core/skills/domain/digital-marketing/references/traffic-management.md +350 -0
- package/.merlin-core/skills/domain/expo-native-ui/SKILL.md +348 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/animations.md +220 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/api-routes.md +361 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/cicd-workflows.md +84 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/controls.md +266 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/data-fetching.md +553 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/deployment-stores.md +1353 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/deployment.md +183 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/dev-client.md +166 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/dom-components.md +410 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/form-sheet.md +253 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/gradients.md +117 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/icons.md +218 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/media.md +245 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/platform-native.md +75 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/route-structure.md +229 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/search.md +249 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/storage.md +121 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/tabs.md +433 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/tailwind-native.md +473 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/toolbar-and-headers.md +284 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/upgrading-guides.md +674 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/upgrading.md +127 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/visual-effects.md +199 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/webgpu-three.md +605 -0
- package/.merlin-core/skills/domain/expo-native-ui/references/zoom-transitions.md +161 -0
- package/.merlin-core/skills/domain/marketing-ops/SKILL.md +117 -0
- package/.merlin-core/skills/domain/marketing-ops/references/_index.md +78 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/ad-creative/references/generative-tools.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/ad-creative/references/platform-specs.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/ad-creative.md +251 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/ads/references/ad-copy-templates.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/ads/references/audience-targeting.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/ads/references/conversion-tracking.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/ads/references/platform-setup-checklists.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/ads.md +322 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/ai-seo/references/content-patterns.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/ai-seo/references/content-types.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/ai-seo/references/platform-ranking-factors.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/ai-seo.md +388 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/aso/references/apple-specs.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/aso/references/benchmarks.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/aso/references/google-play-specs.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/aso/references/report-template.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/aso/references/scoring-criteria.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/aso.md +316 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/co-marketing.md +305 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/community-marketing.md +169 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/competitor-profiling/references/templates.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/competitor-profiling/references/tool-reference.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/competitor-profiling.md +442 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/competitors/references/content-architecture.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/competitors/references/templates.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/competitors.md +281 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/content-strategy.md +16 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/directory-submissions/references/directory-list.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/directory-submissions/references/positioning-variations.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/directory-submissions/references/submission-tracker-template.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/directory-submissions.md +396 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/free-tools/references/tool-types.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/free-tools.md +196 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/image/references/ai-image-prompting.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/image.md +352 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/launch.md +18 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/lead-magnets/references/benchmarks.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/lead-magnets/references/format-guide.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/lead-magnets.md +333 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/programmatic-seo.md +16 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/schema.md +16 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/seo-audit/references/ai-writing-detection.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/seo-audit/references/international-seo.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/seo-audit.md +546 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/site-architecture/references/mermaid-templates.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/site-architecture/references/navigation-patterns.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/site-architecture/references/site-type-templates.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/site-architecture.md +371 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/social/references/platform-limits.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/social/references/platforms.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/social/references/post-templates.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/social/references/reverse-engineering.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/social/references/short-form-video.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/social.md +431 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/video/references/ai-video-prompting.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/acquire/video.md +353 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/ab-testing/references/sample-size-guide.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/ab-testing/references/test-templates.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/ab-testing.md +379 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/analytics/references/event-library.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/analytics/references/ga4-implementation.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/analytics/references/gtm-implementation.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/analytics.md +323 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/copy-editing.md +18 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/copywriting.md +18 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/cro/references/experiments.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/cro/references/form.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/cro.md +211 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/emails.md +18 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/paywalls/references/experiments.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/paywalls.md +255 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/popups.md +518 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/pricing.md +18 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/sales-enablement/references/deck-frameworks.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/sales-enablement/references/demo-scripts.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/sales-enablement/references/objection-library.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/sales-enablement/references/one-pager-templates.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/sales-enablement.md +371 -0
- package/.merlin-core/skills/domain/marketing-ops/references/activate/signup.md +406 -0
- package/.merlin-core/skills/domain/marketing-ops/references/expand/co-marketing.md +18 -0
- package/.merlin-core/skills/domain/marketing-ops/references/expand/community-marketing.md +18 -0
- package/.merlin-core/skills/domain/marketing-ops/references/expand/referrals/references/affiliate-programs.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/expand/referrals/references/program-examples.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/expand/referrals.md +278 -0
- package/.merlin-core/skills/domain/marketing-ops/references/foundation/customer-research/references/source-guides.md +425 -0
- package/.merlin-core/skills/domain/marketing-ops/references/foundation/customer-research.md +284 -0
- package/.merlin-core/skills/domain/marketing-ops/references/foundation/marketing-ideas/references/ideas-by-category.md +216 -0
- package/.merlin-core/skills/domain/marketing-ops/references/foundation/marketing-ideas.md +188 -0
- package/.merlin-core/skills/domain/marketing-ops/references/foundation/marketing-psychology.md +532 -0
- package/.merlin-core/skills/domain/marketing-ops/references/foundation/product-marketing.md +276 -0
- package/.merlin-core/skills/domain/marketing-ops/references/retain/churn-prevention/references/cancel-flow-patterns.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/retain/churn-prevention/references/dunning-playbook.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/retain/churn-prevention.md +442 -0
- package/.merlin-core/skills/domain/marketing-ops/references/retain/onboarding/references/experiments.md +19 -0
- package/.merlin-core/skills/domain/marketing-ops/references/retain/onboarding.md +243 -0
- package/.merlin-core/skills/domain/marketing-ops/references/retain/revops-lifecycle.md +18 -0
- package/.merlin-core/skills/domain/marketing-ops/references/retain/revops-operations.md +18 -0
- package/.merlin-core/skills/domain/n8n-automation/SKILL.md +149 -0
- package/.merlin-core/skills/domain/n8n-automation/references/code-javascript.md +3744 -0
- package/.merlin-core/skills/domain/n8n-automation/references/code-python.md +3293 -0
- package/.merlin-core/skills/domain/n8n-automation/references/expression-syntax.md +1662 -0
- package/.merlin-core/skills/domain/n8n-automation/references/mcp-tools-expert.md +2111 -0
- package/.merlin-core/skills/domain/n8n-automation/references/node-configuration.md +2523 -0
- package/.merlin-core/skills/domain/n8n-automation/references/validation-expert.md +2491 -0
- package/.merlin-core/skills/domain/n8n-automation/references/workflow-patterns.md +4624 -0
- package/.merlin-core/skills/domain/ops-manual/SKILL.md +225 -0
- package/.merlin-core/skills/domain/ops-manual/references/elicitation-questions.md +141 -0
- package/.merlin-core/skills/domain/ops-manual/references/external-skills-registry.md +63 -0
- package/.merlin-core/skills/domain/ops-manual/references/operations-template.yaml +132 -0
- package/.merlin-core/skills/domain/remotion-best-practices/SKILL.md +99 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/3d.md +86 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/animations.md +27 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/assets/charts-bar-chart.tsx +173 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/assets/text-animations-typewriter.tsx +100 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/assets/text-animations-word-highlight.tsx +108 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/assets.md +78 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/audio.md +172 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/calculate-metadata.md +131 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/can-decode.md +75 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/charts.md +68 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/compositions.md +154 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/display-captions.md +126 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/extract-frames.md +229 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/fonts.md +152 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/get-audio-duration.md +58 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/get-video-dimensions.md +68 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/get-video-duration.md +58 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/gifs.md +144 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/images.md +134 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/import-srt-captions.md +67 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/lottie.md +70 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/maps.md +414 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/measuring-dom-nodes.md +34 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/measuring-text.md +143 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/parameters.md +109 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/sequencing.md +118 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/tailwind.md +11 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/text-animations.md +20 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/timing.md +179 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/transcribe-captions.md +19 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/transitions.md +137 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/transparent-videos.md +106 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/trimming.md +51 -0
- package/.merlin-core/skills/domain/remotion-best-practices/rules/videos.md +171 -0
- package/.merlin-core/skills/domain/resend-email/SKILL.md +377 -0
- package/.merlin-core/skills/general/adversarial-review/SKILL.md +144 -0
- package/.merlin-core/skills/general/api-design/SKILL.md +513 -0
- package/.merlin-core/skills/general/apify-scrape/SKILL.md +137 -0
- package/.merlin-core/skills/general/apify-scrape/scripts/apify-scrape.sh +68 -0
- package/.merlin-core/skills/general/backup/SKILL.md +87 -0
- package/.merlin-core/skills/general/blkskrn/SKILL.md +392 -0
- package/.merlin-core/skills/general/blkskrn/references/animation-patterns.md +521 -0
- package/.merlin-core/skills/general/blkskrn/references/design-system.md +637 -0
- package/.merlin-core/skills/general/blkskrn/references/html-templates.md +440 -0
- package/.merlin-core/skills/general/blkskrn/references/presenter-template.md +45 -0
- package/.merlin-core/skills/general/blkskrn/references/slide-types.md +424 -0
- package/.merlin-core/skills/general/blkskrn/scripts/canvas-manager.js +502 -0
- package/.merlin-core/skills/general/blkskrn/scripts/presenter.js +90 -0
- package/.merlin-core/skills/general/blkskrn/templates/presenter.html +273 -0
- package/.merlin-core/skills/general/blkskrn/templates/slide-base.html +277 -0
- package/.merlin-core/skills/general/blkskrn/templates/viewer.html +165 -0
- package/.merlin-core/skills/general/browser-takeover/SKILL.md +53 -0
- package/.merlin-core/skills/general/claude-api/SKILL.md +90 -0
- package/.merlin-core/skills/general/code-javascript/SKILL.md +268 -0
- package/.merlin-core/skills/general/code-python/SKILL.md +424 -0
- package/.merlin-core/skills/general/code-style/SKILL.md +97 -0
- package/.merlin-core/skills/general/code-typescript/SKILL.md +361 -0
- package/.merlin-core/skills/general/cold-email/SKILL.md +164 -0
- package/.merlin-core/skills/general/cold-email/references/benchmarks.md +18 -0
- package/.merlin-core/skills/general/cold-email/references/follow-up-sequences.md +18 -0
- package/.merlin-core/skills/general/cold-email/references/frameworks.md +18 -0
- package/.merlin-core/skills/general/cold-email/references/personalization.md +18 -0
- package/.merlin-core/skills/general/cold-email/references/subject-lines.md +18 -0
- package/.merlin-core/skills/general/container-security/SKILL.md +462 -0
- package/.merlin-core/skills/general/context-management/SKILL.md +79 -0
- package/.merlin-core/skills/general/copy-editing/SKILL.md +501 -0
- package/.merlin-core/skills/general/copy-editing/references/checklist.md +18 -0
- package/.merlin-core/skills/general/copy-editing/references/content-refresh.md +18 -0
- package/.merlin-core/skills/general/copy-editing/references/plain-english-alternatives.md +18 -0
- package/.merlin-core/skills/general/copywriting/SKILL.md +294 -0
- package/.merlin-core/skills/general/copywriting/references/copy-frameworks.md +392 -0
- package/.merlin-core/skills/general/copywriting/references/natural-transitions.md +276 -0
- package/.merlin-core/skills/general/database/SKILL.md +561 -0
- package/.merlin-core/skills/general/database/references/postgres-concurrency.md +182 -0
- package/.merlin-core/skills/general/database/references/postgres-connections.md +97 -0
- package/.merlin-core/skills/general/database/references/postgres-data-patterns.md +159 -0
- package/.merlin-core/skills/general/database/references/postgres-monitoring.md +136 -0
- package/.merlin-core/skills/general/database/references/postgres-rls.md +140 -0
- package/.merlin-core/skills/general/database-provision/SKILL.md +56 -0
- package/.merlin-core/skills/general/deploy/SKILL.md +65 -0
- package/.merlin-core/skills/general/design-inspiration/SKILL.md +146 -0
- package/.merlin-core/skills/general/design-palette/SKILL.md +99 -0
- package/.merlin-core/skills/general/design-palette/references/full-palettes.md +144 -0
- package/.merlin-core/skills/general/design-system/SKILL.md +94 -0
- package/.merlin-core/skills/general/design-typography/SKILL.md +115 -0
- package/.merlin-core/skills/general/design-typography/references/full-pairings.md +144 -0
- package/.merlin-core/skills/general/design-ux-patterns/SKILL.md +155 -0
- package/.merlin-core/skills/general/design-ux-patterns/references/charts-data-guidelines.md +197 -0
- package/.merlin-core/skills/general/design-ux-patterns/references/landing-patterns.md +199 -0
- package/.merlin-core/skills/general/design-ux-patterns/references/professional-ui-checklist.md +56 -0
- package/.merlin-core/skills/general/design-ux-patterns/references/style-catalog.md +89 -0
- package/.merlin-core/skills/general/design-ux-patterns/references/ux-guidelines.md +837 -0
- package/.merlin-core/skills/general/discover-cloud/SKILL.md +108 -0
- package/.merlin-core/skills/general/doc-sync/SKILL.md +52 -0
- package/.merlin-core/skills/general/document-sharding/SKILL.md +53 -0
- package/.merlin-core/skills/general/docx/SKILL.md +418 -0
- package/.merlin-core/skills/general/docx/references/windows-setup.md +27 -0
- package/.merlin-core/skills/general/docx/scripts/__init__.py +1 -0
- package/.merlin-core/skills/general/docx/scripts/accept_changes.py +135 -0
- package/.merlin-core/skills/general/docx/scripts/comment.py +318 -0
- package/.merlin-core/skills/general/docx/scripts/office/__init__.py +0 -0
- package/.merlin-core/skills/general/docx/scripts/office/helpers/__init__.py +0 -0
- package/.merlin-core/skills/general/docx/scripts/office/helpers/merge_runs.py +199 -0
- package/.merlin-core/skills/general/docx/scripts/office/helpers/simplify_redlines.py +197 -0
- package/.merlin-core/skills/general/docx/scripts/office/pack.py +159 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/mce/mc.xsd +75 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/microsoft/wml-2010.xsd +560 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/microsoft/wml-2012.xsd +67 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/microsoft/wml-2018.xsd +14 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/microsoft/wml-cex-2018.xsd +20 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/microsoft/wml-cid-2016.xsd +13 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
- package/.merlin-core/skills/general/docx/scripts/office/schemas/microsoft/wml-symex-2015.xsd +8 -0
- package/.merlin-core/skills/general/docx/scripts/office/soffice.py +183 -0
- package/.merlin-core/skills/general/docx/scripts/office/unpack.py +132 -0
- package/.merlin-core/skills/general/docx/scripts/office/validate.py +111 -0
- package/.merlin-core/skills/general/docx/scripts/office/validators/__init__.py +15 -0
- package/.merlin-core/skills/general/docx/scripts/office/validators/base.py +847 -0
- package/.merlin-core/skills/general/docx/scripts/office/validators/docx.py +446 -0
- package/.merlin-core/skills/general/docx/scripts/office/validators/pptx.py +275 -0
- package/.merlin-core/skills/general/docx/scripts/office/validators/redlining.py +247 -0
- package/.merlin-core/skills/general/docx/scripts/templates/comments.xml +3 -0
- package/.merlin-core/skills/general/docx/scripts/templates/commentsExtended.xml +3 -0
- package/.merlin-core/skills/general/docx/scripts/templates/commentsExtensible.xml +3 -0
- package/.merlin-core/skills/general/docx/scripts/templates/commentsIds.xml +3 -0
- package/.merlin-core/skills/general/docx/scripts/templates/people.xml +3 -0
- package/.merlin-core/skills/general/elicitation/SKILL.md +188 -0
- package/.merlin-core/skills/general/engineering-audit/SKILL.md +122 -0
- package/.merlin-core/skills/general/find-and-edit/SKILL.md +102 -0
- package/.merlin-core/skills/general/first-party-docs/SKILL.md +51 -0
- package/.merlin-core/skills/general/frontend-design/SKILL.md +204 -0
- package/.merlin-core/skills/general/guardrails/SKILL.md +144 -0
- package/.merlin-core/skills/general/image-gen/SKILL.md +49 -0
- package/.merlin-core/skills/general/learning-capture/SKILL.md +192 -0
- package/.merlin-core/skills/general/lgpd-compliance-audit/SKILL.md +448 -0
- package/.merlin-core/skills/general/load-testing/SKILL.md +114 -0
- package/.merlin-core/skills/general/load-testing/docker/Dockerfile.dashboard +21 -0
- package/.merlin-core/skills/general/load-testing/docker/docker-compose.locust.yml +39 -0
- package/.merlin-core/skills/general/load-testing/requirements.txt +1 -0
- package/.merlin-core/skills/general/load-testing/scripts/compare_baseline.py +172 -0
- package/.merlin-core/skills/general/load-testing/scripts/run_local.py +245 -0
- package/.merlin-core/skills/general/load-testing/templates/load_shape_stepped.py +35 -0
- package/.merlin-core/skills/general/load-testing/templates/locustfile_dashboard.py +47 -0
- package/.merlin-core/skills/general/load-testing/templates/threshold_hook.py +36 -0
- package/.merlin-core/skills/general/mage-beauty/SKILL.md +89 -0
- package/.merlin-core/skills/general/mage-beauty/references/anti-patterns.md +148 -0
- package/.merlin-core/skills/general/mage-beauty/references/color-and-contrast.md +87 -0
- package/.merlin-core/skills/general/mage-beauty/references/interaction-design.md +99 -0
- package/.merlin-core/skills/general/mage-beauty/references/motion-design.md +90 -0
- package/.merlin-core/skills/general/mage-beauty/references/remotion-bridge.md +187 -0
- package/.merlin-core/skills/general/mage-beauty/references/responsive-and-multi-format.md +98 -0
- package/.merlin-core/skills/general/mage-beauty/references/spatial-design.md +88 -0
- package/.merlin-core/skills/general/mage-beauty/references/typography.md +60 -0
- package/.merlin-core/skills/general/mage-beauty/references/verb-adapt.md +102 -0
- package/.merlin-core/skills/general/mage-beauty/references/verb-animate.md +97 -0
- package/.merlin-core/skills/general/mage-beauty/references/verb-audit.md +99 -0
- package/.merlin-core/skills/general/mage-beauty/references/verb-bolder.md +94 -0
- package/.merlin-core/skills/general/mage-beauty/references/verb-cinematic.md +128 -0
- package/.merlin-core/skills/general/mage-beauty/references/verb-clarify.md +107 -0
- package/.merlin-core/skills/general/mage-beauty/references/verb-colorize.md +106 -0
- package/.merlin-core/skills/general/mage-beauty/references/verb-critique.md +88 -0
- package/.merlin-core/skills/general/mage-beauty/references/verb-delight.md +98 -0
- package/.merlin-core/skills/general/mage-beauty/references/verb-distill.md +97 -0
- package/.merlin-core/skills/general/mage-beauty/references/verb-harden.md +79 -0
- package/.merlin-core/skills/general/mage-beauty/references/verb-layout.md +104 -0
- package/.merlin-core/skills/general/mage-beauty/references/verb-onboard.md +98 -0
- package/.merlin-core/skills/general/mage-beauty/references/verb-optimize.md +124 -0
- package/.merlin-core/skills/general/mage-beauty/references/verb-overdrive.md +105 -0
- package/.merlin-core/skills/general/mage-beauty/references/verb-polish.md +91 -0
- package/.merlin-core/skills/general/mage-beauty/references/verb-quieter.md +95 -0
- package/.merlin-core/skills/general/mage-beauty/references/verb-rebrand.md +127 -0
- package/.merlin-core/skills/general/mage-beauty/references/verb-shape.md +160 -0
- package/.merlin-core/skills/general/mage-beauty/references/verb-typeset.md +109 -0
- package/.merlin-core/skills/general/mage-beauty/references/voice-and-microcopy.md +137 -0
- package/.merlin-core/skills/general/mcp-builder/SKILL.md +92 -0
- package/.merlin-core/skills/general/network-debug/SKILL.md +51 -0
- package/.merlin-core/skills/general/next-best-practices/SKILL.md +177 -0
- package/.merlin-core/skills/general/next-best-practices/references/async-patterns.md +87 -0
- package/.merlin-core/skills/general/next-best-practices/references/bundling.md +182 -0
- package/.merlin-core/skills/general/next-best-practices/references/data-patterns.md +306 -0
- package/.merlin-core/skills/general/next-best-practices/references/debug-tricks.md +125 -0
- package/.merlin-core/skills/general/next-best-practices/references/directives.md +74 -0
- package/.merlin-core/skills/general/next-best-practices/references/error-handling.md +232 -0
- package/.merlin-core/skills/general/next-best-practices/references/file-conventions.md +141 -0
- package/.merlin-core/skills/general/next-best-practices/references/font.md +257 -0
- package/.merlin-core/skills/general/next-best-practices/references/functions.md +108 -0
- package/.merlin-core/skills/general/next-best-practices/references/hydration-error.md +88 -0
- package/.merlin-core/skills/general/next-best-practices/references/image.md +179 -0
- package/.merlin-core/skills/general/next-best-practices/references/metadata.md +296 -0
- package/.merlin-core/skills/general/next-best-practices/references/parallel-routes.md +298 -0
- package/.merlin-core/skills/general/next-best-practices/references/route-handlers.md +146 -0
- package/.merlin-core/skills/general/next-best-practices/references/rsc-boundaries.md +164 -0
- package/.merlin-core/skills/general/next-best-practices/references/runtime-selection.md +40 -0
- package/.merlin-core/skills/general/next-best-practices/references/scripts.md +141 -0
- package/.merlin-core/skills/general/next-best-practices/references/self-hosting.md +384 -0
- package/.merlin-core/skills/general/next-best-practices/references/suspense-boundaries.md +67 -0
- package/.merlin-core/skills/general/next-steps/SKILL.md +43 -0
- package/.merlin-core/skills/general/party-mode/SKILL.md +57 -0
- package/.merlin-core/skills/general/pdf/SKILL.md +298 -0
- package/.merlin-core/skills/general/pdf/references/forms.md +312 -0
- package/.merlin-core/skills/general/pdf/references/reference.md +640 -0
- package/.merlin-core/skills/general/pdf/references/windows-setup.md +40 -0
- package/.merlin-core/skills/general/pdf/scripts/check_bounding_boxes.py +65 -0
- package/.merlin-core/skills/general/pdf/scripts/check_fillable_fields.py +11 -0
- package/.merlin-core/skills/general/pdf/scripts/convert_pdf_to_images.py +33 -0
- package/.merlin-core/skills/general/pdf/scripts/create_validation_image.py +37 -0
- package/.merlin-core/skills/general/pdf/scripts/extract_form_field_info.py +122 -0
- package/.merlin-core/skills/general/pdf/scripts/extract_form_structure.py +115 -0
- package/.merlin-core/skills/general/pdf/scripts/fill_fillable_fields.py +98 -0
- package/.merlin-core/skills/general/pdf/scripts/fill_pdf_form_with_annotations.py +107 -0
- package/.merlin-core/skills/general/pptx/SKILL.md +133 -0
- package/.merlin-core/skills/general/pptx/references/editing.md +213 -0
- package/.merlin-core/skills/general/pptx/references/pptxgenjs.md +581 -0
- package/.merlin-core/skills/general/pptx/references/windows-setup.md +27 -0
- package/.merlin-core/skills/general/pptx/scripts/__init__.py +0 -0
- package/.merlin-core/skills/general/pptx/scripts/add_slide.py +195 -0
- package/.merlin-core/skills/general/pptx/scripts/clean.py +286 -0
- package/.merlin-core/skills/general/pptx/scripts/thumbnail.py +289 -0
- package/.merlin-core/skills/general/property-testing/SKILL.md +214 -0
- package/.merlin-core/skills/general/purge-leaked-secret/SKILL.md +383 -0
- package/.merlin-core/skills/general/reflection/SKILL.md +100 -0
- package/.merlin-core/skills/general/secret-safe-commit/SKILL.md +246 -0
- package/.merlin-core/skills/general/secret-safe-commit/templates/.gitleaks.toml +91 -0
- package/.merlin-core/skills/general/secret-safe-commit/templates/.pre-commit-config.yaml +57 -0
- package/.merlin-core/skills/general/secret-safe-commit/templates/secret-scan.yml +48 -0
- package/.merlin-core/skills/general/semantic-search/SKILL.md +79 -0
- package/.merlin-core/skills/general/skill-creator/SKILL.md +342 -0
- package/.merlin-core/skills/general/skill-creator/agents/analyzer.md +283 -0
- package/.merlin-core/skills/general/skill-creator/agents/comparator.md +211 -0
- package/.merlin-core/skills/general/skill-creator/agents/grader.md +227 -0
- package/.merlin-core/skills/general/skill-creator/assets/eval_review.html +146 -0
- package/.merlin-core/skills/general/skill-creator/eval-viewer/generate_review.py +471 -0
- package/.merlin-core/skills/general/skill-creator/eval-viewer/viewer.html +1325 -0
- package/.merlin-core/skills/general/skill-creator/references/schemas.md +439 -0
- package/.merlin-core/skills/general/skill-creator/scripts/__init__.py +0 -0
- package/.merlin-core/skills/general/skill-creator/scripts/aggregate_benchmark.py +401 -0
- package/.merlin-core/skills/general/skill-creator/scripts/generate_report.py +326 -0
- package/.merlin-core/skills/general/skill-creator/scripts/improve_description.py +247 -0
- package/.merlin-core/skills/general/skill-creator/scripts/package_skill.py +136 -0
- package/.merlin-core/skills/general/skill-creator/scripts/quick_validate.py +103 -0
- package/.merlin-core/skills/general/skill-creator/scripts/run_eval.py +310 -0
- package/.merlin-core/skills/general/skill-creator/scripts/run_loop.py +328 -0
- package/.merlin-core/skills/general/skill-creator/scripts/utils.py +47 -0
- package/.merlin-core/skills/general/start-here/SKILL.md +63 -0
- package/.merlin-core/skills/general/start-here/recipes.json +758 -0
- package/.merlin-core/skills/general/start-here/recipes.schema.json +57 -0
- package/.merlin-core/skills/general/static-analysis/SKILL.md +151 -0
- package/.merlin-core/skills/general/tailwind-design-system/SKILL.md +201 -0
- package/.merlin-core/skills/general/tailwind-design-system/references/advanced-v4.md +152 -0
- package/.merlin-core/skills/general/tailwind-design-system/references/component-patterns.md +353 -0
- package/.merlin-core/skills/general/teach-method/SKILL.md +86 -0
- package/.merlin-core/skills/general/team-execution/SKILL.md +67 -0
- package/.merlin-core/skills/general/testing/SKILL.md +412 -0
- package/.merlin-core/skills/general/token-economy/SKILL.md +55 -0
- package/.merlin-core/skills/general/vps-security-hardening/SKILL.md +406 -0
- package/.merlin-core/skills/general/web-quality/SKILL.md +180 -0
- package/.merlin-core/skills/general/webapp-testing/SKILL.md +153 -0
- package/.merlin-core/skills/general/webapp-testing/scripts/screenshot_compare.py +72 -0
- package/.merlin-core/skills/general/webapp-testing/scripts/with_server.py +103 -0
- package/.merlin-core/skills/general/xlsx/SKILL.md +167 -0
- package/.merlin-core/skills/general/xlsx/references/nodejs-sheetjs-styled-reports.md +141 -0
- package/.merlin-core/skills/general/xlsx/references/windows-setup.md +17 -0
- package/.merlin-core/skills/general/xlsx/scripts/recalc.py +184 -0
- package/.merlin-core/skills/general/xlsx/scripts/styled-report.js +130 -0
- package/.merlin-core/skills/general/yolo-mode/SKILL.md +60 -0
- package/.merlin-core/skills/general/youtube-transcript/SKILL.md +177 -0
- package/.merlin-core/skills/general/youtube-transcript/scripts/fetch_transcript.py +188 -0
- package/.merlin-core/skills/general/youtube-transcript/scripts/gladia_transcribe.mjs +230 -0
- package/.merlin-core/tools/commands/activate.js +72 -0
- package/.merlin-core/tools/commands/archive-thoughts.js +181 -0
- package/.merlin-core/tools/commands/backup.js +156 -0
- package/.merlin-core/tools/commands/certify-process.js +196 -0
- package/.merlin-core/tools/commands/convert.js +87 -0
- package/.merlin-core/tools/commands/cron.js +147 -0
- package/.merlin-core/tools/commands/disable.js +73 -0
- package/.merlin-core/tools/commands/doc-sync.js +127 -0
- package/.merlin-core/tools/commands/eval-skill.js +193 -0
- package/.merlin-core/tools/commands/frontmatter.js +49 -0
- package/.merlin-core/tools/commands/heartbeat.js +43 -0
- package/.merlin-core/tools/commands/index-thoughts.js +35 -0
- package/.merlin-core/tools/commands/install-remote-approve.js +184 -0
- package/.merlin-core/tools/commands/install.js +81 -0
- package/.merlin-core/tools/commands/lib/__verify__/diff-reports.js +170 -0
- package/.merlin-core/tools/commands/lib/fs-safe.js +186 -0
- package/.merlin-core/tools/commands/lib/preflight.js +607 -0
- package/.merlin-core/tools/commands/lib/preserve.js +232 -0
- package/.merlin-core/tools/commands/lib/project-config.template.yaml +69 -0
- package/.merlin-core/tools/commands/lib/report.js +231 -0
- package/.merlin-core/tools/commands/lib/settings-merge.js +134 -0
- package/.merlin-core/tools/commands/license.js +52 -0
- package/.merlin-core/tools/commands/list.js +125 -0
- package/.merlin-core/tools/commands/migrate-alkimia.js +271 -0
- package/.merlin-core/tools/commands/modules.js +68 -0
- package/.merlin-core/tools/commands/provision.js +83 -0
- package/.merlin-core/tools/commands/prune-feedback.js +114 -0
- package/.merlin-core/tools/commands/run-process.js +28 -0
- package/.merlin-core/tools/commands/state.js +79 -0
- package/.merlin-core/tools/commands/sync-bridges.js +197 -0
- package/.merlin-core/tools/commands/upgrade.js +1135 -0
- package/.merlin-core/tools/commands/validate-recipes.js +218 -0
- package/.merlin-core/tools/commands/validate.js +159 -0
- package/.merlin-core/tools/commands/yolo.js +82 -0
- package/.merlin-core/tools/compose-rules.mjs +179 -0
- package/.merlin-core/tools/disable-module.mjs +150 -0
- package/.merlin-core/tools/lib/deployer.mjs +131 -0
- package/.merlin-core/tools/lib/modules-activation.mjs +225 -0
- package/.merlin-core/tools/merlin-tools.js +153 -0
- package/.merlin-core/tools/migrate-frontmatter-v3.js +192 -0
- package/.merlin-core/tools/modules-catalog.mjs +174 -0
- package/.merlin-core/tools/provision-module.mjs +191 -0
- package/.merlin-core/tools/verify-module.mjs +99 -0
- package/.merlin-core/tools/vps-security-audit.sh +234 -0
- package/INSTALL.md +312 -0
- package/LICENSE +118 -0
- package/PRIVACY-LICENSING.md +65 -0
- package/README.md +391 -0
- package/bin/README.md +15 -0
- package/bin/convert-to-merlin.sh +109 -0
- package/bin/fleet-patch-hooks.sh +144 -0
- package/bin/fleet-patch-v3-fixes.sh +127 -0
- package/bin/merlin-init.js +232 -0
- package/bin/merlin.js +321 -0
- package/package.json +127 -0
|
@@ -0,0 +1,324 @@
|
|
|
1
|
+
# Marketing Strategy Frameworks & Research Templates
|
|
2
|
+
|
|
3
|
+
> Reference for the digital-marketing skill. Strategy, research, and analysis frameworks.
|
|
4
|
+
> Adapted marketing-strategy frameworks for the Merlin ecosystem.
|
|
5
|
+
|
|
6
|
+
## Strategy Frameworks
|
|
7
|
+
|
|
8
|
+
### SWOT Analysis (Applied with Evidence)
|
|
9
|
+
|
|
10
|
+
Unlike generic SWOT, every item must have evidence:
|
|
11
|
+
|
|
12
|
+
```
|
|
13
|
+
STRENGTHS (with proof)
|
|
14
|
+
- [Strength]: [Evidence — metric, testimonial, or fact]
|
|
15
|
+
|
|
16
|
+
WEAKNESSES (with impact)
|
|
17
|
+
- [Weakness]: [Impact on business — revenue lost, opportunities missed]
|
|
18
|
+
|
|
19
|
+
OPPORTUNITIES (with viability)
|
|
20
|
+
- [Opportunity]: [Viability score 1-5, timeline, required investment]
|
|
21
|
+
|
|
22
|
+
THREATS (with probability)
|
|
23
|
+
- [Threat]: [Probability: high/medium/low, impact if realized]
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
### Porter's 5 Forces (Digital Marketing Applied)
|
|
27
|
+
|
|
28
|
+
| Force | Analysis Questions |
|
|
29
|
+
| ------------------ | -------------------------------------------------------------------------- |
|
|
30
|
+
| **Rivalry** | How many competitors? How aggressive is their ad spend? Price wars? |
|
|
31
|
+
| **New Entrants** | How easy to start a competing business? Low barriers = more threat |
|
|
32
|
+
| **Substitutes** | What else solves the same problem? (Free content, DIY, different approach) |
|
|
33
|
+
| **Buyer Power** | How many alternatives does the buyer have? How price-sensitive? |
|
|
34
|
+
| **Supplier Power** | Platform dependency (Meta/Google can change rules overnight) |
|
|
35
|
+
|
|
36
|
+
### Blue Ocean Strategy
|
|
37
|
+
|
|
38
|
+
Instead of competing harder in a crowded market, find uncontested space:
|
|
39
|
+
|
|
40
|
+
1. **What can you ELIMINATE** that the industry takes for granted?
|
|
41
|
+
2. **What can you REDUCE** well below the industry standard?
|
|
42
|
+
3. **What can you RAISE** well above the industry standard?
|
|
43
|
+
4. **What can you CREATE** that the industry has never offered?
|
|
44
|
+
|
|
45
|
+
### Value Proposition Canvas
|
|
46
|
+
|
|
47
|
+
```
|
|
48
|
+
CUSTOMER PROFILE → VALUE MAP
|
|
49
|
+
├── Jobs to be Done ├── Products/Services
|
|
50
|
+
│ (what they're trying to do) │ (what you offer)
|
|
51
|
+
├── Pains ├── Pain Relievers
|
|
52
|
+
│ (frustrations, obstacles) │ (how you eliminate pains)
|
|
53
|
+
└── Gains └── Gain Creators
|
|
54
|
+
(desired outcomes) (how you create gains)
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
**Fit test:** Every pain reliever maps to a real pain. Every gain creator maps to a desired gain. No orphan features.
|
|
58
|
+
|
|
59
|
+
### Jobs To Be Done (JTBD)
|
|
60
|
+
|
|
61
|
+
The customer doesn't buy a product — they "hire" it to do a job:
|
|
62
|
+
|
|
63
|
+
```
|
|
64
|
+
When I [situation/context],
|
|
65
|
+
I want to [motivation/job],
|
|
66
|
+
So that [expected outcome].
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
Example: "When I'm launching a new product (situation), I want to reach the right audience quickly (job), so that I can validate demand before investing more (outcome)."
|
|
70
|
+
|
|
71
|
+
### Hormozi Offer Creation
|
|
72
|
+
|
|
73
|
+
Make the offer so good people feel stupid saying no:
|
|
74
|
+
|
|
75
|
+
1. **Dream Outcome** — What's the ideal result they want?
|
|
76
|
+
2. **Perceived Likelihood** — How likely do they think it'll work?
|
|
77
|
+
3. **Time Delay** — How fast will they see results?
|
|
78
|
+
4. **Effort & Sacrifice** — How much work do they have to put in?
|
|
79
|
+
|
|
80
|
+
**Value = (Dream Outcome × Perceived Likelihood) / (Time Delay × Effort)**
|
|
81
|
+
|
|
82
|
+
To increase value: increase dream outcome + likelihood, decrease time + effort.
|
|
83
|
+
|
|
84
|
+
**Offer Stack:**
|
|
85
|
+
|
|
86
|
+
- Core product
|
|
87
|
+
- Bonus 1: Solves secondary pain
|
|
88
|
+
- Bonus 2: Reduces time to result
|
|
89
|
+
- Bonus 3: Reduces effort needed
|
|
90
|
+
- Guarantee: Removes risk entirely
|
|
91
|
+
- Urgency: Real deadline or scarcity
|
|
92
|
+
|
|
93
|
+
## Funnel Frameworks
|
|
94
|
+
|
|
95
|
+
### AIDA
|
|
96
|
+
|
|
97
|
+
- **Attention** → **Interest** → **Desire** → **Action**
|
|
98
|
+
- Map each stage to specific content/copy pieces
|
|
99
|
+
|
|
100
|
+
### PAS (Problem-Agitate-Solve)
|
|
101
|
+
|
|
102
|
+
- **Problem** — Identify the specific pain
|
|
103
|
+
- **Agitate** — Make it worse (emotional + financial cost)
|
|
104
|
+
- **Solve** — Present your solution as the bridge
|
|
105
|
+
|
|
106
|
+
### Hook-Story-Offer (Russell Brunson)
|
|
107
|
+
|
|
108
|
+
- **Hook** — Stop them scrolling (question, bold statement, curiosity)
|
|
109
|
+
- **Story** — Connect through narrative (origin, transformation, proof)
|
|
110
|
+
- **Offer** — Present what they get and how to get it
|
|
111
|
+
|
|
112
|
+
### Value Ladder
|
|
113
|
+
|
|
114
|
+
```
|
|
115
|
+
FREE → Low Ticket → Mid Ticket → High Ticket → Continuity
|
|
116
|
+
Content → Lead Magnet → Core Product → Premium → Subscription
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
Each level should naturally lead to the next. The free content proves you can help; the paid product delivers the transformation.
|
|
120
|
+
|
|
121
|
+
### AARRR Pirate Metrics
|
|
122
|
+
|
|
123
|
+
| Stage | Metric | Question |
|
|
124
|
+
| --------------- | -------------------- | ------------------------------------ |
|
|
125
|
+
| **Acquisition** | Traffic, signups | How do users find you? |
|
|
126
|
+
| **Activation** | First value moment | Do they experience the "aha" moment? |
|
|
127
|
+
| **Retention** | Return rate, DAU/MAU | Do they come back? |
|
|
128
|
+
| **Revenue** | Conversion, ARPU | Do they pay? |
|
|
129
|
+
| **Referral** | NPS, sharing rate | Do they tell others? |
|
|
130
|
+
|
|
131
|
+
## Research Templates
|
|
132
|
+
|
|
133
|
+
### Market Research
|
|
134
|
+
|
|
135
|
+
```
|
|
136
|
+
PESQUISA DE MERCADO — [NICHO/PRODUTO]
|
|
137
|
+
|
|
138
|
+
TAM/SAM/SOM
|
|
139
|
+
- TAM (Total Addressable Market): [size + source]
|
|
140
|
+
- SAM (Serviceable Available Market): [size + source]
|
|
141
|
+
- SOM (Serviceable Obtainable Market): [realistic target + justification]
|
|
142
|
+
|
|
143
|
+
COMPETITOR ANALYSIS (per competitor)
|
|
144
|
+
┌──────────────────┬──────────────────┬──────────────────┐
|
|
145
|
+
│ Competitor │ [Name 1] │ [Name 2] │
|
|
146
|
+
├──────────────────┼──────────────────┼──────────────────┤
|
|
147
|
+
│ Main Product │ │ │
|
|
148
|
+
│ Pricing │ │ │
|
|
149
|
+
│ Positioning │ │ │
|
|
150
|
+
│ Main Channel │ │ │
|
|
151
|
+
│ Estimated Traffic │ │ │
|
|
152
|
+
│ Strengths │ │ │
|
|
153
|
+
│ Weaknesses │ │ │
|
|
154
|
+
└──────────────────┴──────────────────┴──────────────────┘
|
|
155
|
+
|
|
156
|
+
BENCHMARKS
|
|
157
|
+
- Average CPL in niche: [value + source]
|
|
158
|
+
- Average conversion rate: [value + source]
|
|
159
|
+
- Average ticket: [value + source]
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
**Research rules:**
|
|
163
|
+
|
|
164
|
+
- Every claim needs a source
|
|
165
|
+
- Cross-reference 2-3 sources for important data
|
|
166
|
+
- Prioritize data from last 12 months
|
|
167
|
+
- NEVER fabricate statistics — if data isn't available, say so
|
|
168
|
+
|
|
169
|
+
### Voice-of-Customer Mining
|
|
170
|
+
|
|
171
|
+
Extract real customer language from these sources:
|
|
172
|
+
|
|
173
|
+
| Source | What to Capture | Where to Find |
|
|
174
|
+
| ------------------ | -------------------------------------- | ---------------------------------- |
|
|
175
|
+
| Product reviews | Pain phrases, outcome phrases | Amazon, Google Reviews, app stores |
|
|
176
|
+
| Social comments | Objections, questions, praise language | Instagram, Facebook, YouTube |
|
|
177
|
+
| Support tickets | Confusion points, recurring issues | Intercom, Zendesk, email |
|
|
178
|
+
| Forum posts | How they describe the problem to peers | Reddit, Quora, Facebook groups |
|
|
179
|
+
| Competitor reviews | What they love/hate about alternatives | Same sources, competitor products |
|
|
180
|
+
|
|
181
|
+
**Template for extracted phrases:**
|
|
182
|
+
|
|
183
|
+
```
|
|
184
|
+
PAIN PHRASES
|
|
185
|
+
- "[exact quote]" — source: [platform, date]
|
|
186
|
+
- "[exact quote]" — source: [platform, date]
|
|
187
|
+
|
|
188
|
+
DESIRE PHRASES
|
|
189
|
+
- "[exact quote]" — source: [platform, date]
|
|
190
|
+
|
|
191
|
+
OBJECTION PHRASES
|
|
192
|
+
- "[exact quote]" — source: [platform, date]
|
|
193
|
+
|
|
194
|
+
OUTCOME PHRASES (what success looks like in their words)
|
|
195
|
+
- "[exact quote]" — source: [platform, date]
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
### Trend Analysis Template
|
|
199
|
+
|
|
200
|
+
```
|
|
201
|
+
ANÁLISE DE TENDÊNCIAS — [NICHO/PERÍODO]
|
|
202
|
+
|
|
203
|
+
MACRO-TENDÊNCIAS (12-24 meses)
|
|
204
|
+
- [Trend]: [Evidence + source] → [Impact on our strategy]
|
|
205
|
+
|
|
206
|
+
MICRO-TENDÊNCIAS (3-6 meses)
|
|
207
|
+
- [Trend]: [Evidence + source] → [Opportunity or threat?]
|
|
208
|
+
|
|
209
|
+
MOVIMENTOS DE LÍDERES
|
|
210
|
+
- [Leader/Company]: [What they're doing] → [What it signals]
|
|
211
|
+
|
|
212
|
+
OPORTUNIDADES IDENTIFICADAS
|
|
213
|
+
| Opportunity | Viability (1-5) | Timeline | Investment | Priority |
|
|
214
|
+
|-------------|----------------|----------|------------|----------|
|
|
215
|
+
| [...] | [...] | [...] | [...] | [...] |
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
### 3-Scenario Planning
|
|
219
|
+
|
|
220
|
+
For any campaign or strategy, always plan for three scenarios:
|
|
221
|
+
|
|
222
|
+
| Scenario | Definition | Action |
|
|
223
|
+
| ---------------- | ----------------------------------------- | ------------------------------ |
|
|
224
|
+
| **Optimistic** | Everything works above expectations | Scale plan ready |
|
|
225
|
+
| **Realistic** | Average performance based on benchmarks | This is the plan you commit to |
|
|
226
|
+
| **Conservative** | Below-average performance, problems arise | Contingency and pivot plan |
|
|
227
|
+
|
|
228
|
+
**Rule:** The plan MUST work in the realistic scenario. If it only works in the optimistic scenario, it's not a plan — it's a wish.
|
|
229
|
+
|
|
230
|
+
## Brand Identity Quick Reference
|
|
231
|
+
|
|
232
|
+
### Brand Personality Extraction
|
|
233
|
+
|
|
234
|
+
Before any brand work, gather:
|
|
235
|
+
|
|
236
|
+
```
|
|
237
|
+
PERSONALIDADE DA MARCA
|
|
238
|
+
|
|
239
|
+
3 adjetivos que DEFINEM a marca:
|
|
240
|
+
1. [adjective] — por quê: [justification]
|
|
241
|
+
2. [adjective] — por quê: [justification]
|
|
242
|
+
3. [adjective] — por quê: [justification]
|
|
243
|
+
|
|
244
|
+
3 adjetivos que NÃO DEFINEM a marca:
|
|
245
|
+
1. [adjective] — por quê: [what to avoid]
|
|
246
|
+
2. [adjective] — por quê: [what to avoid]
|
|
247
|
+
3. [adjective] — por quê: [what to avoid]
|
|
248
|
+
|
|
249
|
+
Se a marca fosse uma pessoa: [description of behavior, clothing, speech]
|
|
250
|
+
|
|
251
|
+
Marcas que admira visualmente: [list, even from other sectors]
|
|
252
|
+
Marcas que NÃO quer parecer: [list with reasons]
|
|
253
|
+
```
|
|
254
|
+
|
|
255
|
+
### Anti-AI Visual Protocol Checklist
|
|
256
|
+
|
|
257
|
+
Before delivering ANY visual (logo, template, layout, branding book):
|
|
258
|
+
|
|
259
|
+
- [ ] Works in pure black and white?
|
|
260
|
+
- [ ] Recognizable at 16x16px (favicon size)?
|
|
261
|
+
- [ ] Every element justified from the briefing?
|
|
262
|
+
- [ ] Free of generic purple-blue-pink gradients?
|
|
263
|
+
- [ ] Free of overly symmetric, mathematically perfect compositions?
|
|
264
|
+
- [ ] Free of template-like layouts that could be any brand?
|
|
265
|
+
- [ ] Typography has personality (not just Poppins + Inter)?
|
|
266
|
+
- [ ] Color palette relates to the business, not just "looks nice"?
|
|
267
|
+
- [ ] Applications are realistic and contextualized (not generic mockups)?
|
|
268
|
+
- [ ] Would an experienced designer approve this?
|
|
269
|
+
|
|
270
|
+
**If any item fails:** Fix before delivering. Add intentional imperfection, reduce elements, contextualize in real applications, justify every decision from the briefing.
|
|
271
|
+
|
|
272
|
+
---
|
|
273
|
+
|
|
274
|
+
## Four Forces Switching Dynamics (JTBD)
|
|
275
|
+
|
|
276
|
+
When analyzing why customers switch (or don't), map all four forces:
|
|
277
|
+
|
|
278
|
+
| Force | Direction | Question to Answer |
|
|
279
|
+
| ----------- | ----------------- | ---------------------------------------------------------------- |
|
|
280
|
+
| **Push** | Away from current | What frustrations drive them away from their current solution? |
|
|
281
|
+
| **Pull** | Toward you | What about your solution attracts them? |
|
|
282
|
+
| **Habit** | Keeps them stuck | What keeps them using the current approach despite frustrations? |
|
|
283
|
+
| **Anxiety** | Blocks switching | What worries them about switching to something new? |
|
|
284
|
+
|
|
285
|
+
**Application in messaging:**
|
|
286
|
+
|
|
287
|
+
- Push + Pull = your **acquisition messaging** (agitate the push, amplify the pull)
|
|
288
|
+
- Habit + Anxiety = your **objection handling** (break habits with urgency, reduce anxiety with guarantees/proof)
|
|
289
|
+
|
|
290
|
+
Complements the existing JTBD framework (Situation → Motivation → Outcome) by adding the friction and resistance side of the decision.
|
|
291
|
+
|
|
292
|
+
---
|
|
293
|
+
|
|
294
|
+
## Anti-Personas
|
|
295
|
+
|
|
296
|
+
Define who is **NOT** a good fit for your product. Anti-personas improve targeting and reduce wasted spend.
|
|
297
|
+
|
|
298
|
+
**Why it matters:**
|
|
299
|
+
|
|
300
|
+
- Prevents wasted ad spend on wrong audiences
|
|
301
|
+
- Reduces churn (wrong-fit customers leave quickly)
|
|
302
|
+
- Sharpens messaging (knowing who you're NOT talking to clarifies who you ARE talking to)
|
|
303
|
+
|
|
304
|
+
**Capture for each anti-persona:**
|
|
305
|
+
|
|
306
|
+
- Who they are (role, company size, situation)
|
|
307
|
+
- Why they're a bad fit (missing prerequisites, wrong expectations, wrong budget)
|
|
308
|
+
- Red flags in sales conversations that signal bad fit
|
|
309
|
+
|
|
310
|
+
---
|
|
311
|
+
|
|
312
|
+
## B2B Buying Committee
|
|
313
|
+
|
|
314
|
+
In B2B sales, multiple stakeholders influence the purchase decision. Map messaging for each role:
|
|
315
|
+
|
|
316
|
+
| Role | What They Care About | Their Challenge | Value You Promise |
|
|
317
|
+
| ------------------------ | ---------------------------------- | -------------------------------------- | ----------------------------------------- |
|
|
318
|
+
| **User** | Daily workflow improvement | "This takes too long / is frustrating" | "Saves you X hours/week" |
|
|
319
|
+
| **Champion** | Internal credibility, team success | "I need to prove this will work" | "Here's the business case + proof" |
|
|
320
|
+
| **Decision Maker** | Strategic alignment, ROI | "Does this move the needle?" | "Measurable impact on [KPI]" |
|
|
321
|
+
| **Financial Buyer** | Budget justification, cost | "Can we afford this?" | "ROI of X:1 within Y months" |
|
|
322
|
+
| **Technical Influencer** | Integration, security, compliance | "Will this break our stack?" | "Integrates with [tools], SOC2 compliant" |
|
|
323
|
+
|
|
324
|
+
**Application:** Create content and copy tailored to each role. The Champion needs internal sell material (deck, one-pager). The Financial Buyer needs ROI calculator. The Technical Influencer needs API docs and security whitepaper.
|
|
@@ -0,0 +1,350 @@
|
|
|
1
|
+
# Paid Traffic Management Reference
|
|
2
|
+
|
|
3
|
+
> Reference for the digital-marketing skill. Campaign planning, analysis, and optimization.
|
|
4
|
+
> Adapted paid-traffic methodology for the Merlin ecosystem.
|
|
5
|
+
|
|
6
|
+
## Campaign Briefing Template
|
|
7
|
+
|
|
8
|
+
```
|
|
9
|
+
BRIEFING DE CAMPANHA
|
|
10
|
+
|
|
11
|
+
1. OBJETIVO
|
|
12
|
+
- Objetivo da campanha (captação de leads, venda direta, agendamento, evento)
|
|
13
|
+
- O que acontece depois que o lead entra (funil de email, WhatsApp, comercial, página de vendas)
|
|
14
|
+
- Conversão final desejada
|
|
15
|
+
|
|
16
|
+
2. NÚMEROS DO NEGÓCIO
|
|
17
|
+
- Orçamento total (R$)
|
|
18
|
+
- Orçamento diário (fixo ou flexível?)
|
|
19
|
+
- Meta de leads / vendas / agendamentos (número absoluto)
|
|
20
|
+
- Ticket médio do produto/serviço (R$)
|
|
21
|
+
- Taxa de conversão do funil pós-lead (se souber)
|
|
22
|
+
- Margem de lucro por venda (% ou R$) — para calcular ROAS sustentável
|
|
23
|
+
|
|
24
|
+
3. HISTÓRICO
|
|
25
|
+
- Já rodou campanhas antes?
|
|
26
|
+
- CPL histórico, CTR médio, CPM médio, plataforma usada
|
|
27
|
+
- Melhor resultado (período, investimento, resultado)
|
|
28
|
+
- Pior resultado e o que aconteceu
|
|
29
|
+
- Pixel/tag instalado e com dados? Desde quando?
|
|
30
|
+
- Públicos personalizados ou lookalike existentes?
|
|
31
|
+
|
|
32
|
+
4. TEMPO E PRAZO
|
|
33
|
+
- Data de início, deadline, período total de captação
|
|
34
|
+
- Sazonalidade ou data comemorativa envolvida?
|
|
35
|
+
|
|
36
|
+
5. ATIVOS DISPONÍVEIS
|
|
37
|
+
- Landing page (URL)
|
|
38
|
+
- Criativos prontos (quantos, formatos)
|
|
39
|
+
- Copy dos anúncios pronta?
|
|
40
|
+
- Base de emails/contatos para público personalizado?
|
|
41
|
+
- Conteúdo orgânico com bom engajamento para dark post?
|
|
42
|
+
|
|
43
|
+
6. PLATAFORMA
|
|
44
|
+
- Meta Ads, Google Ads ou ambos?
|
|
45
|
+
- Se Google: Search, Display, YouTube ou Performance Max?
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
## ROAS Viability Calculation
|
|
49
|
+
|
|
50
|
+
Run this BEFORE creating any campaign plan:
|
|
51
|
+
|
|
52
|
+
```
|
|
53
|
+
PROJEÇÃO DE CAMPANHA
|
|
54
|
+
|
|
55
|
+
Orçamento total: R$ ______
|
|
56
|
+
Período: ___ dias
|
|
57
|
+
Orçamento diário: R$ ______ (orçamento / dias)
|
|
58
|
+
|
|
59
|
+
CPL estimado: R$ ______
|
|
60
|
+
→ Com histórico: usar histórico + margem de 15-20%
|
|
61
|
+
→ Sem histórico: benchmark do nicho + margem de segurança
|
|
62
|
+
|
|
63
|
+
Leads projetados: ______ (orçamento total / CPL estimado)
|
|
64
|
+
Meta de leads: ______
|
|
65
|
+
Gap: ______ leads
|
|
66
|
+
|
|
67
|
+
Taxa de conversão do funil: ______%
|
|
68
|
+
Vendas projetadas: ______ (leads × taxa conversão)
|
|
69
|
+
Faturamento projetado: R$ ______ (vendas × ticket médio)
|
|
70
|
+
ROAS projetado: ______x (faturamento / investimento)
|
|
71
|
+
|
|
72
|
+
CPL máximo sustentável: R$ ______
|
|
73
|
+
→ (ticket médio × taxa conversão × margem)
|
|
74
|
+
→ Acima disso = prejuízo
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
**If numbers don't work:** Say clearly. Present 3 paths: increase budget, improve funnel conversion rate, or reduce target. Never pretend a bad projection will "work out."
|
|
78
|
+
|
|
79
|
+
## Campaign Structure Template
|
|
80
|
+
|
|
81
|
+
```
|
|
82
|
+
PLANO DE CAMPANHA — [NOME]
|
|
83
|
+
|
|
84
|
+
RESUMO EXECUTIVO
|
|
85
|
+
Objetivo | Meta | Orçamento | Período | CPL alvo | ROAS esperado
|
|
86
|
+
|
|
87
|
+
ESTRUTURA
|
|
88
|
+
|
|
89
|
+
CAMPANHA 1: [Nome — ex: "Captação Fria - Interesse em Marketing"]
|
|
90
|
+
├── Objetivo: [Conversão / Tráfego / Cadastro]
|
|
91
|
+
├── Orçamento diário: R$ ______
|
|
92
|
+
├── Otimização: [Leads / Compra / Landing Page Views]
|
|
93
|
+
├── Público:
|
|
94
|
+
│ ├── Segmentação: [detalhamento]
|
|
95
|
+
│ ├── Idade / Localização
|
|
96
|
+
│ └── Tamanho estimado
|
|
97
|
+
├── Conjuntos de anúncio:
|
|
98
|
+
│ ├── Adset 1: [Público X] — R$ ___/dia
|
|
99
|
+
│ ├── Adset 2: [Público Y] — R$ ___/dia
|
|
100
|
+
│ └── Adset 3: [Lookalike Z] — R$ ___/dia
|
|
101
|
+
└── Criativos:
|
|
102
|
+
├── Criativo 1: [formato + ângulo — ex: "Vídeo 30s - Dor"]
|
|
103
|
+
├── Criativo 2: [formato + ângulo — ex: "Imagem - Prova social"]
|
|
104
|
+
└── Criativo 3: [formato + ângulo — ex: "Carrossel - Benefícios"]
|
|
105
|
+
|
|
106
|
+
CAMPANHA 2: [Remarketing]
|
|
107
|
+
├── (mesma estrutura)
|
|
108
|
+
└── ...
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
## Execution Timeline
|
|
112
|
+
|
|
113
|
+
| Phase | Days | Actions |
|
|
114
|
+
| ------------------ | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
115
|
+
| **Pre-launch** | D-3 to D-1 | Pixel verified, audiences created, LP tested (mobile+desktop), UTMs configured, creatives approved, conversion events configured, form/flow tested |
|
|
116
|
+
| **Launch** | D1-3 | Start campaigns with test budget. DO NOT TOUCH anything. Let algorithm learn. Monitor: delivery, CPM, frequency. Verify pixel is recording correctly. |
|
|
117
|
+
| **First Analysis** | D4-7 | Analyze CPL, CTR, CPM, hook rate, LP conversion. Pause creatives with CTR below threshold and CPL above target. If ALL are off-target: review audience OR landing page before creatives. |
|
|
118
|
+
| **Optimization** | D8-14 | New creatives based on winning angles. Test new audiences if needed. Reallocate budget from worst to best ad sets. Check: is post-lead funnel converting? |
|
|
119
|
+
| **Scale** | D15+ | Apply scale methodology (see below). Weekly reports with analysis. |
|
|
120
|
+
|
|
121
|
+
## Scale Methodology
|
|
122
|
+
|
|
123
|
+
### Prerequisites
|
|
124
|
+
|
|
125
|
+
- CPL consistently below target for 3-5 days minimum
|
|
126
|
+
- Minimum volume of leads/day in the ad set
|
|
127
|
+
- CTR above threshold
|
|
128
|
+
- No erratic metric fluctuations in last 3 days
|
|
129
|
+
|
|
130
|
+
### Method 1: Vertical Scale (Increase Budget)
|
|
131
|
+
|
|
132
|
+
- Maximum +20-30% budget increase per adjustment
|
|
133
|
+
- Wait 48-72h between each increase
|
|
134
|
+
- If CPL rises >40% after increase: revert to previous budget and stabilize
|
|
135
|
+
- Best for: CBO, broad audiences, mature campaigns
|
|
136
|
+
|
|
137
|
+
### Method 2: Horizontal Scale (Duplicate Structure)
|
|
138
|
+
|
|
139
|
+
- Duplicate winning ad set with SAME audience
|
|
140
|
+
- OR duplicate with new audience (different lookalike, different interest)
|
|
141
|
+
- Keep original ad set intact (it's your insurance)
|
|
142
|
+
- Max 2-3 duplications at a time
|
|
143
|
+
- Best for: ABO, segmented audiences, strong creatives
|
|
144
|
+
|
|
145
|
+
### Method 3: Creative Scale
|
|
146
|
+
|
|
147
|
+
- Create new creatives using the SAME angles that performed
|
|
148
|
+
- Vary format: if image worked, test video with same angle (and vice-versa)
|
|
149
|
+
- Vary hook: keep creative structure but change the first 3 seconds
|
|
150
|
+
- Refresh creative library every 7-14 days to prevent fatigue
|
|
151
|
+
|
|
152
|
+
### Alert Signals
|
|
153
|
+
|
|
154
|
+
- CPL +40% in 48h → Pause increase, diagnose
|
|
155
|
+
- Frequency >2.5 → Audience saturating, expand or switch
|
|
156
|
+
- CTR dropped + CPM rising → Creative fatigue, replace assets
|
|
157
|
+
- Leads entering but not converting in funnel → Post-traffic problem, not traffic
|
|
158
|
+
|
|
159
|
+
## 5-Layer Analysis Framework (Detailed)
|
|
160
|
+
|
|
161
|
+
### Layer 1: Macro Overview
|
|
162
|
+
|
|
163
|
+
- Total investment in period
|
|
164
|
+
- Total results (leads, sales, registrations)
|
|
165
|
+
- Cost per result (CPL, CPA)
|
|
166
|
+
- ROAS (if applicable)
|
|
167
|
+
- Comparison vs target: above, below, or on target?
|
|
168
|
+
- Trend: improving, declining, or stable over last 7 days?
|
|
169
|
+
|
|
170
|
+
### Layer 2: Delivery Efficiency
|
|
171
|
+
|
|
172
|
+
- CPM — is it expensive for this niche?
|
|
173
|
+
- Reach vs Impressions — what's the average frequency?
|
|
174
|
+
- If frequency >2.5: audience may be saturated
|
|
175
|
+
- Distribution by placement: Feed, Stories, Reels, Audience Network
|
|
176
|
+
- Distribution by device: mobile vs desktop
|
|
177
|
+
|
|
178
|
+
### Layer 3: Creative Efficiency
|
|
179
|
+
|
|
180
|
+
- CTR per ad — which creatives perform, which don't
|
|
181
|
+
- Hook rate (video): % who watched 3s — below 25% = weak hook
|
|
182
|
+
- ThruPlay rate (video): % who watched 15s+ — indicates content quality
|
|
183
|
+
- CPL per creative — sometimes CTR is high but CPL too (curious clicks, not qualified)
|
|
184
|
+
- Frequency per creative — high frequency = creative fatigue
|
|
185
|
+
- Quality, engagement, and conversion rankings (Meta)
|
|
186
|
+
|
|
187
|
+
### Layer 4: Audience Efficiency
|
|
188
|
+
|
|
189
|
+
- CPL per ad set (audience)
|
|
190
|
+
- Lead volume per audience
|
|
191
|
+
- Cost per audience: which gives cheapest leads? Which gives leads that convert most?
|
|
192
|
+
- Audience size vs delivery: reaching a small fraction? May be too restricted
|
|
193
|
+
- Audience overlap: two ad sets competing for same audience cannibalizes both
|
|
194
|
+
|
|
195
|
+
### Layer 5: Post-Click Funnel
|
|
196
|
+
|
|
197
|
+
- Landing page conversion rate (link clicks → leads)
|
|
198
|
+
- Below 20%: LP needs revision
|
|
199
|
+
- 20-40%: acceptable, can improve
|
|
200
|
+
- Above 40%: LP is good, focus on volume
|
|
201
|
+
- CPC vs CPL — if CPC is low but CPL is high, problem is the LP
|
|
202
|
+
- Time on page (if available via GA4)
|
|
203
|
+
- Bounce rate (if available)
|
|
204
|
+
|
|
205
|
+
## Brazilian Market Benchmarks
|
|
206
|
+
|
|
207
|
+
| Niche | CPL | CTR | CPM | LP Conv |
|
|
208
|
+
| ------------------------- | ------- | -------- | ------- | ----------- |
|
|
209
|
+
| Info-produto (lançamento) | R$3-8 | 1.5-3% | R$15-35 | 25-45% |
|
|
210
|
+
| Info-produto (perpétuo) | R$5-15 | 1-2.5% | R$20-45 | 20-35% |
|
|
211
|
+
| SaaS / Software | R$8-25 | 0.8-2% | R$25-60 | 15-30% |
|
|
212
|
+
| E-commerce | R$2-6 | 1-3% | R$10-30 | 2-5% (sale) |
|
|
213
|
+
| Negócio local | R$3-12 | 1-2.5% | R$12-30 | 20-40% |
|
|
214
|
+
| Imobiliário | R$15-50 | 0.5-1.5% | R$20-50 | 10-25% |
|
|
215
|
+
| Educação / Curso | R$4-12 | 1.2-3% | R$15-40 | 25-40% |
|
|
216
|
+
| Saúde / Bem-estar | R$5-15 | 1-2.5% | R$18-40 | 20-35% |
|
|
217
|
+
| Serviços profissionais | R$10-30 | 0.8-2% | R$20-50 | 15-30% |
|
|
218
|
+
| Eventos (gratuitos) | R$1-5 | 2-4% | R$10-25 | 30-50% |
|
|
219
|
+
| Eventos (pagos) | R$8-25 | 1-2.5% | R$15-40 | 3-8% (sale) |
|
|
220
|
+
|
|
221
|
+
These are approximate references based on Brazilian market averages. They vary significantly by targeting, creative quality, seasonality, and account maturity. NEVER use as promises — use as starting points for projections.
|
|
222
|
+
|
|
223
|
+
## Technical Configuration Checklist
|
|
224
|
+
|
|
225
|
+
### UTM Standards
|
|
226
|
+
|
|
227
|
+
```
|
|
228
|
+
utm_source: [meta / google]
|
|
229
|
+
utm_medium: [cpc / cpm / paid_social]
|
|
230
|
+
utm_campaign: [campaign-name]
|
|
231
|
+
utm_content: [creative-name]
|
|
232
|
+
utm_term: [audience-target] (Google Search)
|
|
233
|
+
```
|
|
234
|
+
|
|
235
|
+
### Naming Convention
|
|
236
|
+
|
|
237
|
+
```
|
|
238
|
+
Campaign: [OBJECTIVE] - [PRODUCT] - [MONTH/YEAR]
|
|
239
|
+
Ad Set: [AUDIENCE] - [TARGETING] - [GEO]
|
|
240
|
+
Ad: [FORMAT] - [ANGLE] - [VERSION]
|
|
241
|
+
```
|
|
242
|
+
|
|
243
|
+
### Meta Ads Export Columns Reference
|
|
244
|
+
|
|
245
|
+
- `Campaign name`, `Ad set name`, `Ad name` → Structure
|
|
246
|
+
- `Amount spent` → Investment
|
|
247
|
+
- `Results` → Leads/conversions
|
|
248
|
+
- `Cost per result` → CPL/CPA
|
|
249
|
+
- `Reach`, `Impressions`, `Frequency` → Delivery
|
|
250
|
+
- `CPM` → Delivery cost
|
|
251
|
+
- `Link clicks`, `CTR (link)` → Click efficiency
|
|
252
|
+
- `Landing page views` → Real LP views (excludes immediate bounces)
|
|
253
|
+
- `Video plays at 25%/50%/75%/100%` → Video retention
|
|
254
|
+
- `ThruPlay` → Watched 15s or full (whichever shorter)
|
|
255
|
+
- `Quality ranking`, `Engagement rate ranking`, `Conversion rate ranking` → Meta quality
|
|
256
|
+
|
|
257
|
+
---
|
|
258
|
+
|
|
259
|
+
## Reporting Cadence & Templates
|
|
260
|
+
|
|
261
|
+
### Daily Quick-Check (2 min)
|
|
262
|
+
|
|
263
|
+
| Check | What to Look For |
|
|
264
|
+
| -------------------- | ------------------------------------------------------ |
|
|
265
|
+
| Spend vs budget pace | Are you on track to spend the monthly budget evenly? |
|
|
266
|
+
| CPL vs target | Any campaign above target CPL? |
|
|
267
|
+
| Anomalies | Sudden spend spikes, zero impressions, disapproved ads |
|
|
268
|
+
|
|
269
|
+
### Weekly Optimization Report
|
|
270
|
+
|
|
271
|
+
| Campaign | Spend | Leads | CPL | ROAS | CTR | Freq | CPA | Action |
|
|
272
|
+
| -------- | ----- | ----- | --- | ---- | ---- | ---- | --- | ----------------------- |
|
|
273
|
+
| [name] | R$X | N | R$X | X.Xx | X.X% | X.X | R$X | [keep/scale/pause/test] |
|
|
274
|
+
|
|
275
|
+
Include: top 3 performing ads with screenshots, audiences to expand/cut, creative fatigue signals, budget reallocation recommendations.
|
|
276
|
+
|
|
277
|
+
### Monthly Strategic Review
|
|
278
|
+
|
|
279
|
+
- Trend: CPL and ROAS over 4 weeks (improving/stable/declining)
|
|
280
|
+
- Channel comparison: Meta vs Google vs other (if multi-channel)
|
|
281
|
+
- Audience insights: best-performing segments, new opportunities
|
|
282
|
+
- Creative performance: winning angles, format winners (video vs image vs carousel)
|
|
283
|
+
- Budget recommendation for next month with justification
|
|
284
|
+
|
|
285
|
+
---
|
|
286
|
+
|
|
287
|
+
## Google Ads Fundamentals
|
|
288
|
+
|
|
289
|
+
Google Ads is intent-based (people are searching) vs Meta which is interruption-based (people are scrolling). This fundamentally changes strategy.
|
|
290
|
+
|
|
291
|
+
### Campaign Types
|
|
292
|
+
|
|
293
|
+
| Type | Intent Level | Use When |
|
|
294
|
+
| --------------- | ------------------------- | --------------------------------------------------------- |
|
|
295
|
+
| Search | High (active search) | Bottom-funnel — people looking for solutions |
|
|
296
|
+
| Display | Low (passive browsing) | Top-funnel awareness, remarketing |
|
|
297
|
+
| YouTube | Medium (watching content) | Consideration — product demos, testimonials |
|
|
298
|
+
| Performance Max | Mixed (automated) | When you have conversion data and want Google to optimize |
|
|
299
|
+
|
|
300
|
+
### Search Campaign Structure
|
|
301
|
+
|
|
302
|
+
- Themed ad groups with tight keyword clusters (5-15 keywords per group)
|
|
303
|
+
- 3-5 responsive search ads per ad group
|
|
304
|
+
- Match types: Exact `[keyword]` (highest intent), Phrase `"keyword"` (moderate), Broad `keyword` (only with smart bidding)
|
|
305
|
+
- Add negative keywords weekly from Search Terms report to block irrelevant queries
|
|
306
|
+
|
|
307
|
+
### Quality Score
|
|
308
|
+
|
|
309
|
+
Google ranks ads on 3 factors (each rated Below Average / Average / Above Average):
|
|
310
|
+
|
|
311
|
+
| Factor | How to Improve |
|
|
312
|
+
| ----------------------- | ----------------------------------------------------------- |
|
|
313
|
+
| Ad Relevance | Include target keyword in headline and description |
|
|
314
|
+
| Expected CTR | Write compelling CTAs, use ad extensions, test multiple ads |
|
|
315
|
+
| Landing Page Experience | Fast load, mobile-friendly, content matches ad promise |
|
|
316
|
+
|
|
317
|
+
**Key difference from Meta:** Google rewards relevance with lower CPCs. A Quality Score of 8+ can halve your cost per click vs a score of 5.
|
|
318
|
+
|
|
319
|
+
**Note:** This covers Google Ads fundamentals. For advanced strategies (SKAGs, bid strategies, audience layering, PMax asset groups), consult dedicated Google Ads resources.
|
|
320
|
+
|
|
321
|
+
---
|
|
322
|
+
|
|
323
|
+
## LTV:CAC & Audience Funnel Strategy
|
|
324
|
+
|
|
325
|
+
### LTV:CAC Ratio
|
|
326
|
+
|
|
327
|
+
```
|
|
328
|
+
LTV = Average Revenue per Customer × Retention (months) × Gross Margin
|
|
329
|
+
CAC = Total Marketing + Sales Cost / New Customers Acquired
|
|
330
|
+
LTV:CAC Ratio = LTV / CAC
|
|
331
|
+
|
|
332
|
+
Target: > 3:1 (healthy) | < 1:1 (losing money) | > 5:1 (under-investing in growth)
|
|
333
|
+
```
|
|
334
|
+
|
|
335
|
+
A campaign can look unprofitable on first-purchase ROAS but be highly profitable when LTV:CAC > 3. This is especially true for SaaS, subscriptions, and services with high retention.
|
|
336
|
+
|
|
337
|
+
### Audience Funnel Strategy
|
|
338
|
+
|
|
339
|
+
| Funnel Stage | Audience Types | Budget % | Goal |
|
|
340
|
+
| ---------------- | ------------------------------------------- | -------- | ------------------ |
|
|
341
|
+
| **TOF** (Top) | Interests, lookalikes, broad | 60-70% | Reach new people |
|
|
342
|
+
| **MOF** (Middle) | Engagers, video viewers, page visitors | 15-20% | Nurture warm leads |
|
|
343
|
+
| **BOF** (Bottom) | Add-to-cart, initiate checkout, past buyers | 15-20% | Convert hot leads |
|
|
344
|
+
|
|
345
|
+
### Exclusion Rules (prevent wasted spend)
|
|
346
|
+
|
|
347
|
+
- Exclude converters/purchasers from TOF prospecting campaigns
|
|
348
|
+
- Exclude recent purchasers from BOF remarketing (they already bought)
|
|
349
|
+
- Exclude existing customers from acquisition campaigns (unless upsell)
|
|
350
|
+
- Cross-exclude audiences between overlapping ad sets to prevent self-competition
|