Skill: moskoweb/traffic-ops-governance (version 1.0.0)

--- name: traffic-ops-governance description: Governa como agentes de trafego operam Meta Ads com seguranca, padrao de aprovacao, auditoria de mudancas e limites claros para o MCP brijr/meta-mcp. metadata: {"portable":"openclaw-ready","primary_mcp":"brijr/meta-mcp","scope":"governance"} user-invocable: true --- # Purpose Esta e a skill-mae de operacao. Ela define como o agente deve pensar e agir antes de usar qualquer tool do `brijr/meta-mcp`. # Use this skill when - a tarefa envolver qualquer leitura ou execucao em Meta Ads - for necessario definir se algo pode ser executado sem aprovacao - houver risco de mudar budget, estrutura, objetivo, tracking ou status - for preciso registrar racional, risco e prazo de revisao # Do not use this skill when - a tarefa nao envolver Meta Ads - o foco for apenas explicar conceitos de marketing sem tocar operacao # Operating principles - Siga sempre a ordem `ler -> diagnosticar -> propor -> validar -> executar -> auditar`. - Nunca confunda observacao com conclusao. Fato, hipotese e recomendacao devem aparecer separados. - Nunca execute mudanca estrutural sem aprovacao explicita. - Toda nova campanha deve nascer em `PAUSED`. - Nunca exclua definitivamente ativos. - Nunca mexa em billing, permissoes ou business settings. - Nunca troque objetivo de campanha sem justificativa escrita e aprovacao. - Se tracking estiver suspeito, reduza a confianca do diagnostico e prefira experimento controlado. - Se a tool ou a capacidade nao estiver explicitamente confirmada no `brijr/meta-mcp`, trate como fora de escopo. # Decision policy ## Mudancas que podem ser executadas sem aprovacao - criar ativos novos em `PAUSED` - pausar ou retomar ativos por protecao operacional - reduzir budget - aumentar budget em ate `10%` por janela de 24 horas em ativos estaveis - corrigir nomenclatura, UTMs e metadata sem mudar a estrategia ## Mudancas que exigem aprovacao - ativar campanha nova - trocar objetivo - subir budget acima de `10%` - editar multiplas variaveis criticas de uma vez - alterar tracking, pixel ou eventos de conversao - reconstruir arquitetura de campanha ou audiencia - qualquer acao fora do escopo confirmado do `brijr/meta-mcp` # Workflow 1. Confirmar conta, objetivo, janela de analise e escopo da solicitacao. 2. Ler saude da conta e ativos com tools de leitura apropriadas. 3. Formular diagnostico e impacto esperado da mudanca. 4. Classificar a mudanca como `read-only`, `safe-within-limits`, `approval-required` ou `forbidden`. 5. Se houver aprovacao necessaria, pedir confirmacao com o plano resumido antes de executar. 6. Executar de forma minima, sem editar variaveis desnecessarias. 7. Registrar hipotese, mudanca, motivo, risco, resultado esperado e prazo de revisao. # Required response structure - `Contexto` - `Fatos observados` - `Hipoteses` - `Acao recomendada` - `Status de aprovacao` - `Auditoria pos-mudanca` quando houver execucao # References - {baseDir}/references/operating-principles.md - {baseDir}/references/approval-matrix.md - {baseDir}/references/change-policy.md - {baseDir}/references/naming-conventions.md - {baseDir}/references/safety-checklists.md - {baseDir}/references/brijr-meta-mcp-tool-policy.md

path: references/operating-principles.md
content: # Operating Principles

## Mandate
- O agente opera Meta Ads com criterio de lucro, risco e auditabilidade.
- O objetivo nao e "mexer na conta"; e melhorar resultado sem introduzir custo desnecessario.
- O unico MCP operacional suportado nesta v1 e `brijr/meta-mcp`.

## Core sequence
1. Ler
2. Diagnosticar
3. Propor
4. Validar
5. Executar
6. Auditar

## Non-negotiables
- Nunca excluir ativos.
- Nunca criar campanha ativa por padrao.
- Nunca alterar billing, permissoes, acessos ou configuracoes sensiveis.
- Nunca trocar objetivo de campanha sem racional escrito e aprovacao.
- Nunca editar varias alavancas criticas ao mesmo tempo sem justificar o experimento.
- Nunca assumir que queda de performance veio so de midia sem checar pagina, tracking, oferta e CRM.

## Confidence policy
- `Alta`: tracking confiavel, amostra suficiente, mudanca isolada e coerencia entre sinais.
- `Media`: ha alguns sinais bons, mas faltam controles ou ha pouco volume.
- `Baixa`: tracking suspeito, volume baixo, mudancas recentes demais ou sinais conflitantes.

## Escalation triggers
- queda abrupta de eficiencia sem causa clara
- gasto acelerando sem conversao proporcional
- discrepancia forte entre plataforma e CRM
- necessidade de troca de objetivo, evento de conversao ou estrutura
- necessidade de usar algo nao coberto pelo `brijr/meta-mcp`

## Meta guidance to honor
- Simplifique estrutura e minimize mudancas na fase de aprendizado.
- Diversifique criativos para dar mais sinais ao sistema.
- Use placements amplos quando nao houver restricao operacional clara.
- Preserve qualidade do anuncio e da experiencia de pagina.

## Source notes
- Reviewed on `2026-03-13`.
- Validated against `brijr/meta-mcp` README and Meta official guidance.


path: references/change-policy.md
content: # Change Policy

## Small changes
Podem ser executadas quando:
- ha contexto suficiente
- o risco e baixo
- a reversao e simples
- existe plano de revisao

Exemplos:
- pausar campanha com custo descontrolado
- reduzir budget
- corrigir nomenclatura
- corrigir UTM
- criar rascunho em `PAUSED`

## Structural changes
Exigem aprovacao quando alteram:
- objetivo
- estrategia de budget
- arquitetura campanha -> conjunto -> anuncio
- proposta de audiencia
- evento de conversao
- destino, tracking ou fluxo de pagina

## Experiment policy
- Teste uma tese por vez sempre que possivel.
- Se precisar testar duas variaveis, escreva por que o teste composto e inevitavel.
- Nao declare vencedor cedo demais.
- Defina prazo de revisao antes de executar.

## Audit log format
- `Hipotese:`
- `Mudanca aplicada:`
- `Motivo:`
- `Risco principal:`
- `Resultado esperado:`
- `Prazo de revisao:`
- `Ferramenta usada:`

## Rollback policy
- Prefira rollback rapido a insistir em mudanca ruim.
- Se a conta entrar em comportamento anomalo, priorize conter gasto e documentar o contexto.
- Nao faca rollback cego se houver dependencia de criativo, landing page ou CRM ainda em transicao.


path: references/approval-matrix.md
content: # Approval Matrix

## Classification

### read-only
- `health_check`
- `get_ad_accounts`
- `get_campaigns`
- `get_insights`
- `compare_performance`
- `export_insights`
- `list_ad_sets`
- `list_ads`
- `list_audiences`
- `get_audience_info`
- `list_ad_creatives`
- `get_token_info`
- `diagnose_campaign_readiness`
- `check_account_setup`

### safe-within-limits
- `pause_campaign`
- `resume_campaign` when used to restore a previously approved campaign or protect delivery
- `update_campaign` for metadata-only changes or budget reduction
- `create_campaign` only if the output is `PAUSED`
- `create_ad_set` only under an already approved structure and with a review plan
- `create_ad` and `create_ad_creative` only for approved tests or paused builds

### approval-required
- `create_campaign` intended to go live
- `update_campaign` changing objective, budget above `10%`, key scheduling logic or multiple critical variables
- `create_ad_set` introducing a new targeting thesis, remarketing window or tracking dependency
- `create_ad` or `create_ad_creative` with a new offer, promise or compliance-sensitive angle
- `create_custom_audience`
- `create_lookalike_audience`

### forbidden
- qualquer acao de exclusao, billing, permissions ou business settings
- qualquer mudanca apoiada em tool nao confirmada no `brijr/meta-mcp`

## Budget limits
- Aumento autonomo maximo: `10%`
- Frequencia maxima do aumento autonomo: `1x a cada 24h por ativo`
- Requisito minimo: ativo estavel, sem tracking suspeito e sem queda recente de qualidade

## Change thresholds that force approval
- mais de uma variavel critica mudando ao mesmo tempo
- troca de objetivo
- alteracao do evento de conversao
- mudanca de audiencia com impacto estrutural
- tentativa de sair do escopo de `PAUSED` para `ACTIVE`


path: references/brijr-meta-mcp-tool-policy.md
content: # brijr/meta-mcp Tool Policy

## Scope lock
- Esta skill considera somente o MCP `brijr/meta-mcp`.
- Nenhum outro MCP de Ads e considerado parte da capacidade ativa.

## Confirmed tools from README
- `get_insights`
- `compare_performance`
- `export_insights`
- `create_campaign`
- `update_campaign`
- `pause_campaign`
- `resume_campaign`
- `create_ad_set`
- `list_ad_sets`
- `create_ad`
- `list_ads`
- `list_audiences`
- `create_custom_audience`
- `create_lookalike_audience`
- `get_audience_info`
- `list_ad_creatives`
- `create_ad_creative`
- `health_check`
- `get_ad_accounts`
- `get_campaigns`
- `get_token_info`
- `diagnose_campaign_readiness`
- `check_account_setup`

## Validation note
- O README do repositorio diz "25 comprehensive tools", mas a lista nomeada revisada em `2026-03-13` enumera 23 tools explicitas.
- Esta skill usa apenas as tools explicitamente nomeadas acima.
- A funcionalidade mencionando "delete campaigns" aparece na secao de features, mas nao existe tool nomeada de exclusao na lista oficial de tools. Portanto exclusao segue fora de escopo.

## Recommended use by intent
- Diagnostico: `health_check`, `get_ad_accounts`, `get_campaigns`, `get_insights`, `compare_performance`, `export_insights`, `list_ad_sets`, `list_ads`
- Estrutura: `create_campaign`, `create_ad_set`, `create_ad_creative`, `create_ad`
- Audiencia: `list_audiences`, `create_custom_audience`, `create_lookalike_audience`, `get_audience_info`
- Seguranca operacional: `diagnose_campaign_readiness`, `check_account_setup`, `get_token_info`


path: references/naming-conventions.md
content: # Naming Conventions

## Principles
- Use blocos em colchetes separados por espaco.
- O nome precisa ser legivel por humano e filtravel por metadata.
- Omitir campos nao aplicaveis; nunca usar placeholders vazios.
- Todo build novo nasce com `PAUSED` quando o status fizer sentido no nome.

## Campaign
Formato:
`[Platform] [Objective] [Offer] [Funnel] [Geo] [Audience] [Status] [YYYY-MM-DD]`

Exemplo:
`[Meta] [Sales] [Consultoria] [BOFU] [BR] [Broad] [PAUSED] [2026-03-13]`

## Ad Set
Formato:
`[Index] [Audience] [Placement] [Optimization] [Window] [Budget]`

Exemplo:
`[01] [Lookalike 1% Compradores] [Advantage+ Placements] [Purchase] [30D] [R$300]`

## Ad
Formato:
`[Angle] [Format] [Hook] [CTA] [vN]`

Exemplo:
`[Dor Operacional] [Video] [Gancho 01] [Fale no WhatsApp] [v1]`

## Creative
Formato:
`[Offer] [Angle] [Format] [Asset] [rN]`

Exemplo:
`[Consultoria] [Case de Escala] [UGC] [Cliente A] [r2]`

## Tracking template
Use este padrao canonico:

```text
utm_source=MetaAds&utm_medium={{adset.name}}|{{adset.id}}&utm_campaign={{campaign.name}}|{{campaign.id}}&utm_term={{placement}}&utm_content={{ad.name}}|{{ad.id}}
```

## Naming guardrails
- `Platform` deve ser `Meta`.
- `Status` padrao para ativos novos: `PAUSED`.
- `Index` deve seguir `01`, `02`, `03`...
- O mesmo conceito deve manter o mesmo vocabulario ao longo da conta.


path: references/safety-checklists.md
content: # Safety Checklists

## Before any execution
- Confirme o `ad_account_id`.
- Confirme o objetivo de negocio.
- Confirme se o tracking esta confiavel.
- Confirme se a acao esta dentro do escopo do `brijr/meta-mcp`.
- Classifique a acao: `read-only`, `safe-within-limits`, `approval-required` ou `forbidden`.
- Defina prazo de revisao.

## Before creating anything
- Validou naming?
- Validou UTM?
- Validou pixel ou evento necessario?
- Validou destino da campanha?
- Validou se deve nascer em `PAUSED`?

## Before editing budget
- A mudanca e reducao ou aumento?
- Se aumento, esta abaixo de `10%`?
- O ativo esta estavel?
- Nao ha tracking suspeito?
- Nao houve mudanca estrutural recente?

## Before changing structure
- Existe aprovacao explicita?
- Ha racional escrito?
- A estrutura atual ja foi diagnosticada corretamente?
- Ha plano de rollback?

## After execution
- Registre o que foi mudado.
- Registre a ferramenta usada.
- Registre o resultado esperado.
- Registre a janela de revisao.
- Liste riscos residuais.


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)