@zaip-ai/cli 1.4.3 → 2.2.0

package/templates/.agents/runtime/checksums.sha256

@@ -1,11 +1,11 @@
 b146bd0c7c60b1ab43c4f71e0b1d2262c6df6da6f7053a0425f834ccb77a6b48  LICENSE
 bc02cba77e8d51e5c580f43668863dc868eda66f1ff663bfaa49fcf3ca16320e  THIRD_PARTY_NOTICES.md
-64d23f858ef51b0f996e4966d4e27c0371b437e2d2787890b1f7ad22d4ec5663  VERSION
-aea71cecd64324e88e90f6001d6f82f57cb616b24306cba12c04d40e733234fe  bin/zaip.mjs
-bed6ab1fda844209edc628c2a675021ad6acb9a2f7ecb7ae017b5a916712da24  manifest.json
+c4a2383a03bdb6739d16a0e24058e4b9c7da4e63d203e0be2f448868cc03c530  VERSION
+69de029dc9c40ea63988c9dc862833928c80d65b211818ec757be36f19f1e334  bin/zaip.mjs
+a110baef708470429aaf722e962c5698903380404b86113d3d5cd2bf04592f38  manifest.json
 7f89219d7c567c82a51679ad136d84364bded7ac659492537e125d33b1d58a7a  migrations/001-layout-v1.json
 5f8c48b286d0b44d8fbb57a9a5d009a8a500439aa3148d750b8f193f72995c9f  migrations/002-layout-v2.json
-182a587dca8080f732cb387dbdeff4c12034a4a116efe35b4cd3c1c0a21ad10b  pnpm-lock.sha256
-c7c5c21465e5aaba66fe01c43bedfe930e024d0cc1e514002eff43553621afa1  provenance.json
-4669f375688be830958d45269bb0f8dfe65daf8db677f72728c15dc89d42d820  sbom.cdx.json
+ddc100b4d4ce1b96d27a50d1e66c1514636aceb36e72157dee07e2b12a5df2bd  pnpm-lock.sha256
+49097573922f2c330f5b1211b03a87a86db87243223ed9a38bd248f4f72f70f7  provenance.json
+fbfcc610258c437829e75846957255cc96202e585b4447dd3df14f2217ea734d  sbom.cdx.json
 b3ffedf9e146be802a15b4009f33e031dec3071ca1525e12c67606fd964a3067  schemas/contracts.schema.json

package/templates/.agents/runtime/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 2,
   "name": "zaip-aios",
-  "version": "1.3.0",
+  "version": "2.2.0",
   "node": ">=22",
   "files": [
     "LICENSE",

package/templates/.agents/runtime/pnpm-lock.sha256

@@ -1 +1 @@
-382ebb27a2a951eb61280171c27116233762370d9093ab516caef216475ba4fc  pnpm-lock.yaml
+55e20a2b6d9239d9b31eace160d0e4ba08bc9b4641806639cab429d8a1e4076f  pnpm-lock.yaml

package/templates/.agents/runtime/provenance.json

@@ -2,10 +2,10 @@
   "schema_version": 1,
   "statement_type": "self_reported_build_integrity",
   "authenticity": "unverified",
-  "version": "1.3.0",
+  "version": "2.2.0",
   "source_origin": "zaip-aios:local-build",
-  "lockfile_sha256": "382ebb27a2a951eb61280171c27116233762370d9093ab516caef216475ba4fc",
-  "sbom_sha256": "4669f375688be830958d45269bb0f8dfe65daf8db677f72728c15dc89d42d820",
-  "runtime_sha256": "fee26f86f7ca62d01e3b2dd590259a47029baa99f2241cab1fa4f27190abb7a0",
-  "statement_sha256": "15d18d3544bf682fd9df31b61d2d2cdeec84f86ee7adfa6c9fc126770fb4fbcf"
+  "lockfile_sha256": "55e20a2b6d9239d9b31eace160d0e4ba08bc9b4641806639cab429d8a1e4076f",
+  "sbom_sha256": "fbfcc610258c437829e75846957255cc96202e585b4447dd3df14f2217ea734d",
+  "runtime_sha256": "2f75214582b6e6a333cadd62a2d20236c59dd44a771f912e7ab22a8b090b3bb1",
+  "statement_sha256": "7977cc341adf229d5189b03d73c4b27b5f3c3f52d87f24b6092495c1fe2eb2b5"
 }

package/templates/.agents/runtime/sbom.cdx.json

@@ -6,7 +6,7 @@
     "component": {
       "type": "application",
       "name": "zaip-aios",
-      "version": "1.3.0"
+      "version": "2.2.0"
     }
   },
   "components": [

package/templates/.agents/skills/zaip-aios/SKILL.md

@@ -1,9 +1,11 @@
 ---
-# zaip-managed generated-do-not-edit source=discovery-skill version=1.3.0 sha256=72e09e90f33f9ed2543daf8dfc09ee5b10fca74d7fa077db030b8b048301d806
+# zaip-managed generated-do-not-edit source=discovery-skill version=2.2.0 sha256=d530dbf54b4fc554a533e0ac300d6c148b598a82f1dcc0680b9d9bdaf4103696
 name: zaip-aios
 description: Discover and apply the repository-local ZAIP-AIOS framework.
 ---
 
 # ZAIP-AIOS adapter
 
-Read `.agents/config/project.yaml` first. Apply ZAIP only for literal boolean `zaip.enabled: true`; otherwise ignore it except maintenance or `zaip enable`. Read `.agents/rules/core.md`, then only matching `.agents/requirements/`, `.agents/rules/`, and `.agents/skills/`; discover via lifecycle manifests and explicit records only—never normal history. Root uses `zaip-agent-orchestrator`, which selects a capability-eligible executor captured with observed host metadata; after descendants and gates, `zaip-agent-finalizer` is last. Terminal outcome requires lifecycle/evidence/tests/manifest refresh; publication is Git-only.
+Keep this native client bootstrap. After reading project configuration, load the applicable `.agents/requirements/`, `.agents/rules/`, and `.agents/skills/` from their canonical locations.
+
+Read `.agents/config/project.yaml` first. Apply ZAIP only for literal boolean `zaip.enabled: true`; otherwise ignore it except maintenance or `zaip enable`. When enabled, capture once: analysis is `conversation`, continuation reuses focus, and independent edits use semantic `new-work`. Thinking about PRD/SPEC is conversation; explicit creation persists complete draft artifacts and PreparedPlan blueprints under interaction telemetry, with Tasks materialized only at ready/execute. Ask at most five critical questions per turn and stop after three turns, then record delegable AI decisions. Resolve finalize/implement/develop using target plus persisted status, and create a linked rework successor instead of reopening cancelled PRDs. Read `.agents/rules/core.md`, then only applicable context from runtime projections and explicit records—never normal history. Publication is Git-only.

package/templates/.agents/skills/zaip-skill-execution/SKILL.md

@@ -5,6 +5,8 @@ description: Execute prepared ZAIP work explicitly, materialize its DAG, and clo
 
 # Executar trabalho preparado
 
+Carregue [a governança de execução e delegação](references/runtime-governance.md) antes da entrega ou dispatch. Perguntas read-only sem descendentes usam somente o kernel de RULE-CORE e a skill de domínio pertinente.
+
 Use esta skill somente quando o usuário pedir execução. `prepare` não autoriza mutação nem promoção para `ready`; quando a execução foi pedida explicitamente, prepare o PRD/SPEC ainda em `draft`, se necessário, e então execute sem exigir outra confirmação intermediária.
 
 1. Carregue o PreparedPlan e valide hash, origem, Requirements/AC, DAG, write scopes e estado atual. Antes de selecionar executor, carregue as Rules aplicáveis; para decisão comercial, use `$RULE-SPECIALIST-ROUTING` como fonte única da matriz de roteamento. Ao construir ou diagnosticar o plano externo, leia [o contrato compacto](references/prepared-plan.md).

package/templates/.agents/skills/zaip-skill-execution/references/runtime-governance.md

@@ -0,0 +1,17 @@
+# Governança de execução e delegação
+
+Carregue antes de executar uma entrega ou delegar. Este contrato detalha o kernel de RULE-CORE; perguntas diretas read-only não precisam desta expansão.
+
+- Leia `.agents/config/project.yaml`, esta Rule e Rules aplicáveis. Preserve domínio independente de framework, infraestrutura e fornecedor; respeite escopo/autoridade e peça direção antes de ação destrutiva, irreversível ou externa.
+- Pensar/explorar PRD/SPEC é `conversation`; criar persiste o pacote `draft` e PreparedPlan com telemetria, e `ready|execute` materializa a DAG. PRD/SPEC são opcionais; a entrada pode ser Task, SPEC ou PRD. PRD cancelado é imutável: crie sucessor `rework`.
+- Classifique/capture o turno: pergunta, análise pontual ou baixa confiança cria só Run `conversation`; continuação/refinamento/rework reutiliza foco; edição persistente, resultado independente ou pedido explícito cria Task de título semântico (nunca copiado/truncado do prompt). Pedido explícito no turno de `deploy|push|publicar|publicação GitHub` seleciona `$zaip-skill-github-deploy`, é Git-only e não materializa lifecycle; autoriza reconciliação limitada e commits funcionais apenas do diff pretendido/evidenciado, com pathspecs explícitos e sem inventar IDs ausentes. A seleção não autoriza outro provider, `git add -A`, force, segredos ou worktrees alheios.
+- Criar/refinar PRD/SPEC `draft` persiste macro/PreparedPlan em Execution `interaction`, sem Task, Change ou delivery, vinculada à Run/`creation_run_id`; agregue telemetria apenas observada/reconciliada. Fora disso, antes de mutação persistente no repositório/PC materialize Task, Execution, Change e Run raiz; pedido avulso entra em Execução. Só Git/deploy sem produto, manifests/telemetria gerados, `.git`, cache, build, teste e temporário são isentos; código, documentação e configuração nunca são.
+- Limite: cinco perguntas/turno, três turnos; registre decisões delegáveis. Autoridade, lei e segurança não delegáveis bloqueiam. Antes de bloquear ação já autorizada por credencial, aplique `$zaip-skill-local-credentials`: busque dotenv somente no projeto, trate-o como dados, selecione uma chave pertinente e injete-a apenas no subprocesso mínimo sem expor valores. Credencial ausente, ambígua ou comprovadamente inutilizável bloqueia; razão sanitizada. Resolva verbos por alvo/status em `RULE-WORKFLOW`: `execute` usa o menor grão, `implemente` sem alvo conversa, `desenvolva|melhore|aprimore` planeja/rework. Nunca invente tokens, custo, decisão, Evidence, teste ou resultado.
+- Em modo manual carregue `RULE-MODEL-ORCHESTRATION` antes da primeira resposta visível; aviso não bloqueia nem altera seleção. Com Codex/delegação use apenas `codex_name` do catálogo, formato `zaip-agent-NOME`, recursivamente; proíba `default`, `worker`, `explorer` e tipos ad-hoc.
+- Para delegação Codex, Sub-Run ZAIP é somente subagente nativo de colaboração (`spawn_agent`). `create_thread` e `fork_thread` criam chats independentes e exigem pedido explícito do usuário; nunca são Sub-Run, fallback, retry ou prova de delegação. Se delegação nativa estiver indisponível, relate a limitação em vez de criar chat independente. Nome de catálogo, `task_name`, título ou prompt não prova ancestralidade nativa. Antes de repetir a mesma delegação limitada, aguarde ou reutilize seu filho pendente e capture somente ancestralidade/metadados observados em resultados nativos de spawn/terminal do host ou eventos SubagentStart/SubagentStop.
+- Cada `client_turn_id` observável tem uma Execution idempotente/claim atômico; sem ele use identidade local sem prometer idempotência. `interaction` read-only sem descendentes é conversa sem Task artificial e termina após a resposta entregue, sem executor ou finalizador; interaction com trabalho delegado e `delivery` exigem executor/finalizador. `delivery` é trabalho materializado e reuso exige kind/origem compatíveis. A raiz é `zaip-agent-orchestrator`; quando a barreira é exigida escolha executor por capacidade, permita reviewer/auditor/integrator e termine com `zaip-agent-finalizer` em `finalization`, após descendentes, bloqueando novas chamadas.
+- Hooks são best-effort: após cada spawn/terminal o orquestrador também executa `zaip subagent capture` idempotente com metadados reais. Use session/turn filhos, `agent-id=agent_path`, `parent-agent-id=client_thread_id` da raiz e turn distinto por chamada. Quando um evento terminal observado expõe somente agent_path, status, identidade catalogada e pai exato, `capture-terminal` aceita apenas `zaip-agent-finalizer` ou executor elegível para delivery com capacidade `task-delivery`; exige também `parent-run-id` igual ao `run_id` da raiz ativa exata, pois um client thread pode conter raízes concorrentes. O último segmento do agent_path deve ser seu `codex_task_name` canônico. O propósito deriva da identidade validada e session/turn/model/provider/usage permanecem indisponíveis; o fallback nunca substitui captura rica nem inventa modelo, effort, tokens ou custo.
+- Em `model_orchestration.mode:auto`, selecione automaticamente apenas origens em `automatic_sources` (`spec`,`prd`); fixe modelo/effort no início de cada Run/Sub-Run distinta, herde nas calls internas e exija nova chamada para mudar. Task avulsa preserva seleção manual, sem inferir `default_model`.
+- Somente ao avaliar escalada diagnóstica difícil para Astra, carregue `RULE-ASTRA-DIAGNOSTIC`: evidência obrigatória, `high`, quota persistente de três diagnósticos por Task e devolução para executor Luna/Terra/Sol. Não carregue essa expansão em consultas comuns.
+- Todo PreparedPlan PRD/SPEC traz `model_signals` por Task; o framework persiste `model_profile`, `task-risk-v1` e motivos, usando `runtime_defaults`, `runtime`, política/defaults sem `standard` silencioso. Não infira fase/complexidade/transversalidade/ambiguidade/rework/custo/capacidade por contagem de arquivos; use sinais, fase/agente e capacidades. Cabeçalho e `model.selection.recorded` repetem a seleção enviada.
+- Plano visível: `DEFINE:`, `PLAN:`, `EXECUTE:` ou `VERIFY:`, 3–4 passos (máximo 5); omita fase sem ação e combine trivialidades.

package/templates/.agents/skills/zaip-skill-general-operations/SKILL.md

@@ -1,12 +1,11 @@
 ---
 name: zaip-skill-general-operations
-description: Deliver bounded operational artifacts when no mandatory specialist scope applies. Use for documents, presentations, spreadsheets, process artifacts, and comparative research; do not use for regulated governance work or external acts.
+description: Answer operational questions and deliver bounded documents, presentations, spreadsheets or processes; exclude specialist governance and external acts.
 ---
 
-# Executar operações gerais
+# Operações proporcionais
 
-1. Delimite o resultado, público, fontes, formato, write scope e critério de aceitação; trate fatos ausentes como pendências, nunca como dados inferidos.
-2. Se houver capability ou escopo obrigatório de produto, design, marketing, dados, segurança, cloud, frontend, backend, website ou governança, devolva ao orquestrador para a rota especialista.
-3. Produza o artefato delimitado e uma verificação proporcional. Para identidade visual existente, siga o contrato da Manu; para conteúdo de marketing, devolva a rota para Lúcia.
-4. Pesquisa comparativa usa apenas fontes autorizadas e registra critérios, evidência e incertezas. Não contrate, envie dados, assine, publique ou execute ato externo.
-5. Quando faltar autoridade humana, entregue a minuta, checklist, lacunas e a ação humana exata; a entrega não fica sem resultado por falta dessa autoridade.
+- Responda consultas, explicações e resumos no formato pedido, usando fontes e incertezas explícitas, sem arquivo ou questionário obrigatório.
+- Para entrega persistente, carregue [o fluxo de entrega](references/extended-workflow.md): resultado, público, fontes, formato, escopo e verificação proporcional.
+- Domínios obrigatórios seguem o especialista; referência citada não muda o dono da entrega. Não invente dados ou aprovação.
+- Ato externo exige autoridade vigente; prepare a minuta e indique pendências quando faltar autorização. Interaction read-only não cria Task/Change; entrega segue lifecycle e ACs. Engenharia só se aplica ao trabalho técnico.

package/templates/.agents/skills/zaip-skill-general-operations/references/extended-workflow.md

@@ -0,0 +1,7 @@
+# Executar operações gerais
+
+1. Delimite o resultado, público, fontes, formato, write scope e critério de aceitação; trate fatos ausentes como pendências, nunca como dados inferidos.
+2. Se houver capability ou escopo obrigatório de produto, design, marketing, dados, segurança, cloud, frontend, backend, website ou governança, devolva ao orquestrador para a rota especialista.
+3. Produza o artefato delimitado e uma verificação proporcional. Para identidade visual existente, siga o contrato da Manu; para conteúdo de marketing, devolva a rota para Lúcia.
+4. Pesquisa comparativa usa apenas fontes autorizadas e registra critérios, evidência e incertezas. Não contrate, envie dados, assine, publique ou execute ato externo.
+5. Quando faltar autoridade humana, entregue a minuta, checklist, lacunas e a ação humana exata; a entrega não fica sem resultado por falta dessa autoridade.

package/templates/.agents/skills/zaip-skill-github-setup/SKILL.md

@@ -18,6 +18,11 @@ Support these independent modes:
 5. Create the first local commit.
 6. Publish only when the user also explicitly requests deploy/push.
 
+When one selected absolute parent folder must govern several child repositories,
+route to `$zaip-skill-github-setup-ssh-folder`. It owns the conditional-include,
+selected-parent dotenv, child-repository and GitHub-creation safeguards; do not
+apply the single-repository procedure below across an inferred folder tree.
+
 Before creating remote state, require the repository owner/name and visibility. Before generating a key, require the intended identity, key path, and passphrase policy. These choices materially affect security and cannot be guessed.
 
 ## Inspect before mutation

package/templates/.agents/skills/zaip-skill-github-setup-ssh-folder/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: zaip-skill-github-setup-ssh-folder
+description: Configure SSH and Git identity for child repositories under one selected parent folder; use for multi-repository setup, never to publish.
+---
+
+# Configurar SSH e Git por pasta
+
+Use quando uma pessoa selecionar uma pasta pai absoluta que contém vários
+repositórios filhos e precisar de uma identidade Git e SSH limitada a ela. A
+pasta pai cobre seus descendentes; não descubra outras pastas, repositórios,
+dotenvs ou identidades.
+
+Um pedido explícito de **configurar** autoriza a configuração local, limitada à
+pasta pai escolhida: Git, SSH e o `.env` explicitamente indicado nela. Não peça
+novamente essa autorização. Pergunte somente os fatos ainda ausentes: pasta pai
+absoluta, conta GitHub, chave selecionada ou pedido de criação de chave, e
+política de passphrase. Criação remota de repositório e push exigem pedido
+explícito, que pode já constar na mesma mensagem do usuário.
+
+Conduza uma etapa por vez: dados da pasta e conta, chave local, cadastro público
+no GitHub, `.env`, configuração e verificação. Explique o próximo passo e aguarde
+somente a intervenção humana necessária; não peça segredos no chat.
+Use o [modelo de dotenv](assets/.env.example) para preparar o arquivo escolhido,
+preservando seu conteúdo existente. O modelo não contém credenciais utilizáveis.
+
+1. Inspecione somente a pasta pai selecionada e cada repositório filho que a
+   pessoa indicar. Não faça busca recursiva de `.env`; leia ou altere somente o
+   `.env` explicitamente nomeado na pasta pai, como limite autorizado deste fluxo.
+2. Para configurar ou diagnosticar `includeIf`, chave, alias SSH, clone, acesso
+   GitHub ou criação de repositório, leia o [procedimento operacional](references/operational-procedure.md).
+3. Aplique uma única estratégia: `includeIf` com `core.sshCommand` ou alias SSH
+   existente. Confirme o comando efetivo com Git no repositório real; um teste
+   SSH isolado não prova o transporte Git.
+4. Cada repositório filho independente recebe seu próprio `.gitignore` ou
+   `info/exclude` revisado antes de qualquer stage. Pare e relate override,
+   política organizacional, autorização ou escopo ambíguo.
+
+## Proteção contra deleção de repositório
+
+Nunca exclua repositórios locais ou remotos, diretórios `.git`, a pasta pai, nem
+o diretório de um clone parcial como rollback. Preserve o clone parcial e
+reporte a falha. Esta restrição cobre somente esses alvos de repositório; ela não
+proíbe alterações de arquivos locais que a pessoa autorizou expressamente dentro
+do escopo selecionado. A proibição cobre CLI, REST, GraphQL, SDK, navegador,
+scripts e delegação; não contorne a trava por outra ferramenta. Na criação via
+API, aceite somente a credencial verificada sem permissão de excluir conforme
+o procedimento. Não teste a proteção tentando uma exclusão real.
+
+Esta skill oferece orientação e não concede permissões no sistema operacional,
+nem substitui controles do GitHub. A seleção por `includeIf` escolhe identidade
+por caminho; a permissão real continua confinada à conta, chave e permissões do
+repositório no GitHub. Para setup Git/GitHub de um único repositório, use
+`$zaip-skill-github-setup`; para publicação explicitamente solicitada, use
+`$zaip-skill-github-deploy`.

package/templates/.agents/skills/zaip-skill-github-setup-ssh-folder/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "ZAIP SSH por Pasta"
+  short_description: "Configura SSH e Git por pasta com seguranca"
+  default_prompt: "Use $zaip-skill-github-setup-ssh-folder para configurar SSH e Git sob uma pasta pai absoluta selecionada."

package/templates/.agents/skills/zaip-skill-github-setup-ssh-folder/assets/.env.example

@@ -0,0 +1,9 @@
+# Copie para a pasta pai escolhida como .env; nunca publique esse arquivo.
+ZAIP_SSH_PARENT_PATH=C:/Repos/Cliente A/
+GITHUB_ACCOUNT=conta-selecionada
+GIT_USER_NAME=Nome da Pessoa
+GIT_USER_EMAIL=nome@exemplo.com
+# Somente caminho local; nunca coloque o conteúdo privado da chave aqui.
+SSH_PRIVATE_KEY_PATH=C:/Chaves SSH/cliente-a_ed25519
+# Deixe vazio enquanto a criação remota autorizada não precisar de token.
+GITHUB_TOKEN=

package/templates/.agents/skills/zaip-skill-github-setup-ssh-folder/references/operational-procedure.md

@@ -0,0 +1,137 @@
+# Procedimento operacional
+
+Leia esta referência depois de a pessoa selecionar uma pasta pai absoluta e um objetivo. Um pedido explícito de configurar autoriza a configuração local de Git, SSH e do `.env` pai indicado. A skill orienta a ação, mas não altera permissões do Windows ou do GitHub por si só. Push e criação remota exigem pedido explícito, inclusive na mesma mensagem; não repita autorização concedida.
+
+## Limite e dotenv
+
+1. Resolva o caminho físico da pasta pai absoluta, incluindo junctions/symlinks, e use barras `/` e barra final. Valide containment físico de cada destino; para um novo clone, valide o ancestral existente mais próximo antes de criar o filho. Não pesquise credenciais em pais, irmãos ou `.env` de filhos. A leitura pontual dos arquivos Git/SSH do usuário que participam dessa configuração é necessária; não faça varredura global.
+2. Inspecione só repositórios filhos explicitamente selecionados. Para clone bootstrap, a pessoa informa o diretório filho alvo absoluto. Preserve diretório parcial quando o clone falhar e reporte a falha.
+3. Trate **todo** valor de dotenv como dado: nunca o interpole em shell, nem use `source` ou `eval`. Leia apenas o `.env` pai explicitamente indicado; não faça varredura global ou recursiva. Antes de um valor compor `core.sshCommand`, valide e canonicalize o `SSH_PRIVATE_KEY_PATH` selecionado: rejeite NUL, quebra de linha e metacaracteres de controle do shell, inclusive `&`, `|`, `;`, `<`, `>`, `(`, `)`, `$`, crase, aspas simples e aspas duplas; exija caminho absoluto local permitido e confira que ele aponta à chave selecionada. Só então construa o argumento SSH com o caminho entre aspas duplas, para suportar espaços com segurança. O dotenv guarda caminho de chave, nunca a chave privada.
+
+```dotenv
+# Pasta pai selecionada; use barras / e barra final.
+ZAIP_SSH_PARENT_PATH=C:/Repos/Cliente A/
+GITHUB_ACCOUNT=conta-selecionada
+GIT_USER_NAME=Nome da Pessoa
+GIT_USER_EMAIL=nome@exemplo.com
+# Caminho local: nunca cole o conteúdo da chave privada aqui.
+SSH_PRIVATE_KEY_PATH=C:/Chaves SSH/cliente-a_ed25519
+# Opcional e em branco. Use apenas para criação remota explicitamente autorizada.
+GITHUB_TOKEN=
+```
+
+Adapte os valores com os dados já fornecidos e preserve variáveis existentes. O `.env` é uma entrada lida pela IA: Git e SSH não o carregam automaticamente. Guarde-o fora dos repositórios filhos, quando possível. Se a pasta pai também for um repositório, proteja-o no ignore desse repositório; cada filho independente precisa de seu próprio `.gitignore` ou `info/exclude` antes de stage. Ignore não retira segredos já rastreados: se houver algum, pare a publicação e trate a exposição. Proteja o `.env` com ACL apropriada ao usuário no Windows, não o faça commit e não procure dotenvs fora do caminho selecionado. O GitHub não pode fornecer uma chave privada: ela é criada e fica localmente sob controle da pessoa.
+
+## Chave SSH: fluxo iniciante no Windows
+
+Depois de confirmar conta, destino da chave e política de passphrase, uma pessoa que pediu explicitamente a criação pode seguir estes passos. Nunca exponha o arquivo privado criado.
+
+1. Confira `git --version`, `ssh -V` e a disponibilidade de `ssh-keygen`. Confirme um diretório de chaves existente ou crie o diretório escolhido dentro do setup autorizado; ele deve ficar fora de repositórios versionados. Abra PowerShell e crie a chave em um caminho novo:
+
+   ```powershell
+   ssh-keygen -t ed25519 -C 'nome@exemplo.com' -f 'C:\Chaves SSH\cliente-a_ed25519'
+   ```
+
+   Defina a passphrase conforme a política confirmada. Não sobrescreva chave existente nem presuma passphrase vazia.
+2. Copie **somente** o conteúdo do arquivo público terminado em `.pub`:
+
+   ```powershell
+   Get-Content -Raw 'C:\Chaves SSH\cliente-a_ed25519.pub' | Set-Clipboard
+   ```
+
+3. No GitHub, abra o perfil da conta: **Settings > SSH and GPG keys > New SSH key**. Em **Key type**, selecione **Authentication Key**, dê um título reconhecível, cole a chave pública e clique em **Add SSH key**.
+4. Volte com confirmação não secreta: conta usada, título da chave e caminho público, ou apenas que o cadastro foi concluído. Nunca envie chave privada ou passphrase.
+
+Mantenha ACL restritiva no arquivo privado e use passphrase quando a política ou o risco exigir. Não eleve privilégios nem inicie/configure `ssh-agent` sem autorização específica. Antes do primeiro uso, verifique a impressão digital do host com a fonte oficial do GitHub e confira a chave apresentada antes de aceitá-la; não aceite impressão nova apenas por um prompt.
+
+Use a chave selecionada para conferir a conta: `ssh -T -i 'C:/Chaves SSH/cliente-a_ed25519' -o IdentitiesOnly=yes git@github.com`. A saudação deve conter a conta esperada; o GitHub normalmente retorna código 1 mesmo após autenticação bem-sucedida. Não confunda nome/e-mail de commit com autenticação. A pessoa digita a passphrase localmente; nunca a salve no `.env` nem em argumentos. Se o agente SSH já estiver disponível, `ssh-add` pode carregar a chave no contexto do usuário; se indisponível, a digitação interativa continua possível. Git for Windows e Windows OpenSSH podem usar agentes distintos: verifique o executável usado por Git antes de diagnosticar falha.
+
+## Identidade dedicada e includeIf
+
+Escolha uma estratégia e mantenha-a consistente:
+
+- **Configuração condicional:** uma entrada `includeIf` global referencia arquivo dedicado com `user.name`, `user.email` e `core.sshCommand`.
+- **Alias SSH existente:** a URL remota usa `git@github-identidade:` e a configuração SSH existente escolhe a chave. Não misture alias e `core.sshCommand` sem motivo comprovado.
+
+`includeIf` seleciona identidade pelo diretório Git; não impede que a chave seja usada fora dessa pasta por outro comando e não concede acesso a repositórios sem permissão na conta. A chave de conta atende múltiplos repositórios; uma deploy key é ligada a um repositório e não é o padrão deste fluxo. Use `gitdir/i` no Windows e `gitdir` em sistemas com caminhos sensíveis a maiúsculas. Inspecione a condição exata e reutilize-a se corresponder à pasta normalizada. Adicione somente a entrada ausente. Faça backups com nomes únicos, somente dos arquivos editados que já existam, preservando entradas sem relação. Um Git global novo não exige copiar um arquivo inexistente. Consulte a origem efetiva, incluindo configuração XDG, antes de escolher o arquivo global a editar.
+
+Depois da validação descrita acima, use o caminho canonicalizado como dado no argumento. Em PowerShell, aspas simples preservam caminhos com espaços e aspas duplas dentro de `$sshCommand` protegem o caminho para o SSH; o valor não é executado por PowerShell:
+
+```powershell
+$parent = 'C:/Repos/Cliente A/'
+$identityConfig = 'C:/Git Config/cliente-a.gitconfig'
+$keyPath = 'C:/Chaves SSH/cliente-a_ed25519' # caminho já validado e canonicalizado
+$condition = "includeIf.gitdir/i:${parent}.path"
+$sshCommand = 'ssh -i "' + $keyPath + '" -o IdentitiesOnly=yes'
+
+git config --global --get-regexp '^includeIf\..*\.path$'
+git config --file $identityConfig user.name 'Nome da Pessoa'
+git config --file $identityConfig user.email 'nome@exemplo.com'
+git config --file $identityConfig core.sshCommand $sshCommand
+# Após os backups e a verificação: somente se $condition ainda não existir:
+git config --global $condition $identityConfig
+```
+
+Crie o diretório do arquivo de identidade quando necessário; faça os backups antes de executar o bloco. A condição deve ser aplicada depois de preparar o arquivo dedicado com sucesso. Em seguida, verifique origem e valor efetivo em repositório filho real:
+
+```powershell
+git -C 'C:/Repos/Cliente A/repo' config --show-origin --get user.name
+git -C 'C:/Repos/Cliente A/repo' config --show-origin --get user.email
+git -C 'C:/Repos/Cliente A/repo' config --show-origin --get core.sshCommand
+git -C 'C:/Repos/Cliente A/repo' ls-remote origin HEAD
+```
+
+`includeIf` corresponde ao diretório Git. Em worktrees, confirme `git rev-parse --git-dir`; se ele estiver fora da árvore, explique a exceção e adapte somente dentro do escopo autorizado. Diagnostique overrides locais, `GIT_SSH_COMMAND`, `GIT_SSH` e URLs HTTPS (que não usam SSH). Preserve remotos existentes; migre para SSH somente quando isso fizer parte do pedido. Um teste `ssh -T` não lê `core.sshCommand`; `git ls-remote` no filho prova o transporte efetivo. Um repositório remoto vazio pode responder sem referências com sucesso. Verifique pelo menos dois filhos, se existirem, e um repositório fora da pasta para demonstrar alcance; não crie nem clone repositórios reais apenas para testar.
+
+## Clone bootstrap por SSH
+
+Um clone exigido explicitamente pode usar o comando SSH selecionado apenas nessa operação; não grave override local persistente. O alvo deve ser filho absoluto da pasta pai e não pode ser removido se o clone falhar.
+
+```powershell
+# Reutilize somente o $sshCommand construído anteriormente com $keyPath validado.
+$target = 'C:\Repos\Cliente A\novo-repo'
+git -c "core.sshCommand=$sshCommand" clone git@github.com:OWNER/REPO.git $target
+```
+
+Se falhar, preserve `$target`, inspecione e reporte seu estado. Após sucesso, prove que `includeIf` foi selecionado no clone e que nenhum override local persistiu:
+
+```powershell
+git -C $target config --show-origin --get core.sshCommand
+git -C $target config --local --get core.sshCommand
+```
+
+O segundo comando não deve retornar valor. Não use clone para criar, publicar ou alterar repositório remoto.
+
+## GitHub e criação de repositório
+
+SSH autentica transporte Git, não a API do GitHub. Não troque autenticação global de `gh`. Sem token autorizado, clone SSH pode prosseguir quando solicitado; criação remota espera autorização manual ou token selecionado.
+
+Para criação automática explicitamente solicitada, escolha token somente do `.env` pai indicado. Um PAT clássico é o caminho prático: no GitHub, abra **Settings > Developer settings > Personal access tokens > Tokens (classic) > Generate**, escolha expiração e conceda `public_repo` para criação pública ou `repo` para criação privada. Rejeite `delete_repo` e escopos desconhecidos. Se a organização proibir PAT clássico, entregue a etapa manual; não use token fine-grained com **Administration (write)** para criação automatizada sem deleção, porque essa permissão pode permitir exclusão.
+
+Depois de gerar o PAT, a pessoa o salva localmente em `GITHUB_TOKEN` no `.env` escolhido e informa apenas que terminou. Reutilize o procedimento de [credenciais locais](../../zaip-skill-local-credentials/SKILL.md) com a pasta pai explicitamente escolhida como limite; não imprima, registre ou passe o token em argumentos. Parseie dotenv como dados, sem executar seu conteúdo. A chave privada permanece em seu arquivo, não nesse campo.
+
+Crie um ambiente somente para cada subprocesso mínimo de verificação/criação. Remova credenciais GitHub e overrides herdados (`GH_TOKEN`, `GITHUB_TOKEN`, variantes Enterprise, `GH_HOST`, `GH_REPO`, `GH_DEBUG` e tracing); injete apenas o token escolhido como `GH_TOKEN` e o host esperado. Não altere o ambiente global, não use `gh auth switch`, não salve o token com `gh auth login` e não use `gh auth token` em diagnóstico. Descarte as referências em `finally`.
+
+Antes da criação, consulte `GET /user` nesse contexto e confira a conta esperada. Leia somente o cabeçalho de escopos `x-oauth-scopes` de forma sanitizada: aceite apenas `public_repo`/`repo` suficientes para o alvo e sem `delete_repo`; não confunda `x-accepted-oauth-scopes` (o que o endpoint aceita) com escopos concedidos. Tipo ou escopos não verificáveis bloqueiam apenas criação automática; não recorra à credencial global. Nunca confirme proteção enviando DELETE. Esta restrição do PAT vale para ele, não para outras sessões da conta ou para o navegador.
+
+Antes de criar, resolva owner, nome e visibilidade a partir do pedido; pergunte apenas o que falta. Consulte a existência: repositório existente é reutilizado conforme autorização, não apagado/recriado. Um 404 também pode ser falta de acesso; confirme conta/owner e não repita criação após erro ambíguo sem consultar o estado. No subprocesso autenticado, execute `gh repo create OWNER/REPO --private` ou `--public` conforme a visibilidade escolhida, sem `--push`. Depois clone a URL SSH no filho escolhido pelo procedimento anterior. Se já houver repositório local, adicione `origin` somente quando ausente e valide qualquer remoto existente.
+
+Quando o token estiver ausente ou a organização proibir o fluxo, oriente criação manual: GitHub **+ > New repository**, selecione owner, nome e visibilidade, clique **Create repository** e volte com a URL SSH. Isso não exige PAT da IA; o clone pode continuar após a criação humana. Políticas de SSO e organização devem ser atendidas, nunca contornadas. Não use outras credenciais para driblar a trava.
+
+## Proteção contra deleção
+
+Nunca exclua repositórios locais ou remotos, diretórios `.git`, a pasta pai ou clones parciais. Aplique a proibição a CLI, REST, GraphQL, SDK, navegador, scripts, delegação e rollback; não ofereça comandos executáveis de exclusão. Não tente substituir a exclusão por esvaziamento destrutivo, force-push ou remoção de todas as referências. A trava não bloqueia edições normais de arquivos já autorizadas. Em falha de configuração, restaure somente os trechos próprios a partir do backup e preserve mudanças concorrentes; em falha de clone ou criação, preserve o repositório e relate o estado.
+
+Ao concluir, informe pasta abrangida, caminhos de configuração alterados, conta SSH verificada, origem da identidade Git e estado separado de clone/criação/publicação. Diferencie validação local, teste Git/SSH e criação remota efetivamente observada. Nunca afirme que configurar SSH publicou algo.
+
+## Fontes oficiais
+
+- [Git conditional includes](https://git-scm.com/docs/git-config#_conditional_includes)
+- [GitHub: testar conexão SSH](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/testing-your-ssh-connection)
+- [GitHub: fingerprints SSH](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/githubs-ssh-key-fingerprints)
+- [GitHub: adicionar nova chave SSH](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)
+- [GitHub: escopos de PAT clássico](https://docs.github.com/en/developers/apps/scopes-for-oauth-apps#available-scopes)
+- [GitHub: permissões de fine-grained PAT](https://docs.github.com/en/rest/authentication/permissions-required-for-fine-grained-personal-access-tokens)
+- [GitHub CLI: ambiente](https://cli.github.com/manual/gh_help_environment)
+- [GitHub: criar e excluir repositórios e escopos exigidos](https://docs.github.com/en/rest/repos/repos)
+- [GitHub: gerenciamento de tokens](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)

package/templates/.agents/skills/zaip-skill-growth-strategy-revops/SKILL.md

@@ -3,24 +3,12 @@ name: zaip-skill-growth-strategy-revops
 description: Guide data-driven growth strategy, RevOps decisions, experiments, and financial-impact recommendations. Use for cross-funnel growth or operating decisions; not for raw data analysis, campaign production, or external commercial action.
 ---
 
-# Orientar Growth e RevOps
+# Growth e RevOps proporcionais ao pedido
 
-## Localização canônica
+- Responda uma pergunta delimitada diretamente, usando apenas métricas, período e contexto necessários; não imponha diagnóstico completo ou plano integral.
+- Separe fato observado, cálculo, hipótese e recomendação. Para números, declare fórmula, unidade, premissas e lacunas. Não prometa receita/economia nem atribua causalidade sem evidência adequada.
+- Pergunte somente pela informação que muda a decisão; silêncio não é resposta. Preserve estratégias e fontes aprovadas sem duplicá-las.
+- Para diagnóstico, decisão estratégica, recomendação financeira, desenho de experimento ou entrega persistente, carregue [o fluxo progressivo](references/extended-workflow.md). Artefatos vivem em `.agents/growth/`; `strategy.md` centraliza decisões.
+- Dados e significância exigem método reproduzível; marca, campanha e playbook comercial vão aos respectivos especialistas. Esta skill não autoriza campanha, alteração comercial ou experimento externo.
 
-Salve diagnósticos, estratégias, decisões de RevOps, hipóteses de experimento e recomendações de Growth em `.agents/growth/`. Não salve esses artefatos em `docs/`, na raiz do repositório ou em diretórios de brand, marketing ou sales.
-
-O arquivo central da área é `.agents/growth/strategy.md`; atualize-o quando uma decisão mudar a estratégia de Growth ou RevOps. Diagnósticos e experimentos específicos podem ser arquivos adicionais na mesma pasta.
-
-## Descoberta e entrega progressivas
-
-1. Comece pelas referências acessíveis fornecidas — texto, site, PDF, PPT, planilha, arquivo ou imagem. Registre cada fonte com locator e classifique seu conteúdo como fato, decisão aprovada, hipótese, dado ou lacuna. Reutilize os artefatos aprovados; não recrie sua fonte central nem duplique seu conteúdo em outro arquivo.
-2. Se o trabalho começar do zero ou o contexto for insuficiente, faça no máximo cinco perguntas críticas por turno, por até três turnos. Pergunte somente por lacunas que mudam a decisão: objetivo, período, segmentos, funil, métricas, restrições ou impacto financeiro. Espere as respostas antes de avançar nas partes que delas dependem; silêncio não é resposta nem aprovação. Após três turnos, prossiga somente com hipóteses delegáveis rotuladas e lacunas explícitas, sem inventar decisões, autoridade, métricas ou datasets.
-3. Um pedido pontual com contexto suficiente deve ser respondido diretamente, sem questionário obrigatório nem plano integral.
-4. Aplique somente as partes necessárias ao escopo solicitado: `diagnóstico do funil e handoffs` → `prioridades` → `experimento` → `estratégia consolidada`. Identifique a parte em construção e só consolide em `.agents/growth/strategy.md` quando o contexto sustentar uma decisão estratégica. Mantenha diagnósticos e experimentos específicos como arquivos complementares, sem duplicar a estratégia central; não exija todos os módulos ou formatos.
-5. No diagnóstico, examine aquisição, qualificação, conversão, receita, retenção, expansão, custos e capacidade. Separe fatos observados, cálculo determinístico, hipótese e recomendação; não declare causalidade sem desenho ou evidência adequados.
-6. Priorize oportunidades por impacto potencial, confiança, esforço, dependências e reversibilidade. Para recomendações financeiras, explicite fórmula, premissas, sensibilidade e lacunas; não prometa receita nem economia.
-7. Para cada experimento, registre hipótese, população, métrica primária, guardrails, duração, critério de decisão, risco e responsável. Não execute campanhas, alterações comerciais externas ou experimentos sem a autorização e o escopo correspondentes.
-8. Em conselho ou planejamento de negócio, priorize portfólio, modelo de negócio, opções e handoffs de execução. Solicite análise reprodutível de Gabi quando houver dataset, cálculo, qualidade de dados ou significância. Encaminhe plataforma de marca à Sarah, campanha/copy a Lúcia e playbook/processo sales-facing a Aaron.
-9. Produza uma recomendação consultiva: decisão, evidência, incerteza, opções, impacto esperado, próximo experimento e dono da próxima ação. Não produza campanha, Brandbook ou playbook comercial como substituto da recomendação.
-
-Consulte o [framework de decisão](references/growth-revops-framework.md) para planejar diagnóstico ou experimento.
+Uma interaction read-only não materializa Task/Change. Entrega persistente segue lifecycle, Requirements/AC e assurance proporcionais; só trabalho técnico carrega engenharia.

package/templates/.agents/skills/zaip-skill-growth-strategy-revops/references/extended-workflow.md

@@ -0,0 +1,21 @@
+# Orientar Growth e RevOps
+
+## Localização canônica
+
+Salve diagnósticos, estratégias, decisões de RevOps, hipóteses de experimento e recomendações de Growth em `.agents/growth/`. Não salve esses artefatos em `docs/`, na raiz do repositório ou em diretórios de brand, marketing ou sales.
+
+O arquivo central da área é `.agents/growth/strategy.md`; atualize-o quando uma decisão mudar a estratégia de Growth ou RevOps. Diagnósticos e experimentos específicos podem ser arquivos adicionais na mesma pasta.
+
+## Descoberta e entrega progressivas
+
+1. Comece pelas referências acessíveis fornecidas — texto, site, PDF, PPT, planilha, arquivo ou imagem. Registre cada fonte com locator e classifique seu conteúdo como fato, decisão aprovada, hipótese, dado ou lacuna. Reutilize os artefatos aprovados; não recrie sua fonte central nem duplique seu conteúdo em outro arquivo.
+2. Se o trabalho começar do zero ou o contexto for insuficiente, faça no máximo cinco perguntas críticas por turno, por até três turnos. Pergunte somente por lacunas que mudam a decisão: objetivo, período, segmentos, funil, métricas, restrições ou impacto financeiro. Espere as respostas antes de avançar nas partes que delas dependem; silêncio não é resposta nem aprovação. Após três turnos, prossiga somente com hipóteses delegáveis rotuladas e lacunas explícitas, sem inventar decisões, autoridade, métricas ou datasets.
+3. Um pedido pontual com contexto suficiente deve ser respondido diretamente, sem questionário obrigatório nem plano integral.
+4. Aplique somente as partes necessárias ao escopo solicitado: `diagnóstico do funil e handoffs` → `prioridades` → `experimento` → `estratégia consolidada`. Identifique a parte em construção e só consolide em `.agents/growth/strategy.md` quando o contexto sustentar uma decisão estratégica. Mantenha diagnósticos e experimentos específicos como arquivos complementares, sem duplicar a estratégia central; não exija todos os módulos ou formatos.
+5. No diagnóstico, examine aquisição, qualificação, conversão, receita, retenção, expansão, custos e capacidade. Separe fatos observados, cálculo determinístico, hipótese e recomendação; não declare causalidade sem desenho ou evidência adequados.
+6. Priorize oportunidades por impacto potencial, confiança, esforço, dependências e reversibilidade. Para recomendações financeiras, explicite fórmula, premissas, sensibilidade e lacunas; não prometa receita nem economia.
+7. Para cada experimento, registre hipótese, população, métrica primária, guardrails, duração, critério de decisão, risco e responsável. Não execute campanhas, alterações comerciais externas ou experimentos sem a autorização e o escopo correspondentes.
+8. Em conselho ou planejamento de negócio, priorize portfólio, modelo de negócio, opções e handoffs de execução. Solicite análise reprodutível de Gabi quando houver dataset, cálculo, qualidade de dados ou significância. Encaminhe plataforma de marca à Sarah, campanha/copy a Lúcia e playbook/processo sales-facing a Aaron.
+9. Produza uma recomendação consultiva: decisão, evidência, incerteza, opções, impacto esperado, próximo experimento e dono da próxima ação. Não produza campanha, Brandbook ou playbook comercial como substituto da recomendação.
+
+Consulte o [framework de decisão](growth-revops-framework.md) para planejar diagnóstico ou experimento.

package/templates/.agents/skills/zaip-skill-marketing/SKILL.md

@@ -3,19 +3,12 @@ name: zaip-skill-marketing
 description: Plan evidence-grounded marketing strategy, copy, campaigns, assets, and image briefs. Use for a declared marketing objective; do not use for generic website, product frontend, or central design-system implementation.
 ---
 
-# Planejar marketing
+# Marketing proporcional ao pedido
 
-## Localização canônica
+- Em pergunta, explicação ou copy curta com contexto suficiente, responda diretamente. Não crie campanha completa, arquivo ou questionário por padrão.
+- Use objetivo, público, oferta e canal fornecidos; pergunte somente pelo dado que muda materialmente a resposta. Preserve fatos, mensagem aprovada e fontes. Rotule hipóteses; não invente público, métricas ou decisões de marca.
+- Brandbook aprovado é referência read-only. Escale Branding somente para decisão de marca ausente ou contraditória; sales-facing vai a Sales, estratégia empresarial/RevOps a Growth, implementação de website/frontend ao especialista técnico.
+- Imagens, briefs visuais e mockups somente quando pedidos no escopo. Meta Ads carrega sua skill e ferramentas somente para trabalho Meta.
+- Para estratégia, planejamento de campanha ou entrega persistente, carregue [o fluxo progressivo](references/extended-workflow.md). Artefatos aprovados vivem em `.agents/marketing/`; `strategy.md` centraliza decisões estratégicas sem duplicação.
 
-Salve estratégias, campanhas, calendários, briefings, copy aprovada e ativos de marketing em `.agents/marketing/`. Não salve entregáveis de marketing em `docs/`, na raiz do repositório ou em diretórios de brand, sales ou growth.
-
-O arquivo central da área é `.agents/marketing/strategy.md`; atualize-o quando uma decisão mudar a estratégia de marketing. Campanhas e planos específicos podem ser arquivos adicionais na mesma pasta.
-
-## Descoberta e entrega progressivas
-
-1. Comece pelas referências acessíveis fornecidas — texto, site, PDF, PPT, planilha, arquivo ou imagem. Para cada uma, registre fonte, locator e classificação: fato, decisão aprovada, hipótese, dado ou lacuna. Trate Brandbook aprovado como input somente-leitura e preserve todos os artefatos aprovados; não recrie nem duplique a fonte central da área.
-2. Se o trabalho começar do zero ou o contexto for insuficiente, faça no máximo cinco perguntas críticas por turno, por até três turnos. Pergunte somente por lacunas materiais: objetivo, ICP, oferta, canal, recursos disponíveis ou métrica. Espere as respostas antes de avançar nas partes que delas dependem; silêncio não é resposta nem aprovação. Após três turnos, mantenha lacunas explícitas e use somente hipóteses delegáveis rotuladas; não invente decisões de marca, autoridade, evidência, métricas ou público.
-3. Pedido pontual com contexto suficiente deve ser executado diretamente, sem questionário obrigatório ou plano completo.
-4. Aplique somente as partes necessárias ao escopo solicitado: `objetivo, ICP, oferta, canal, recursos e métrica` → `estratégia e mensagem` → `campanha e copy` → `ativos no escopo`. Identifique o material em construção e consolide somente decisões estratégicas sustentadas em `.agents/marketing/strategy.md`; campanhas, planos e copies específicos ficam em arquivos complementares sem repetir a estratégia central, sem exigir todos os módulos ou formatos.
-5. Produza estratégia, copy, campanha, conteúdo ou aplicação de marca proporcionais ao objetivo e ao escopo aprovado. Copy de marketing ambígua permanece com Lúcia. Não gere imagens, briefs visuais, mockups ou outros ativos por iniciativa própria; produza-os somente quando forem solicitados e estiverem no escopo.
-6. Escalar Sarah somente se uma decisão de marca estiver ausente, contraditória ou precisar ser criada; um Brandbook aprovado não redireciona a entrega para Branding. Encaminhar script voltado a vendas para Aaron, estratégia empresarial/RevOps para Robert, website para Jonny, frontend de produto para Doug e regra visual central para Manu.
+Uma interaction read-only não materializa Task/Change. Entrega persistente segue lifecycle, Requirements/AC e assurance proporcionais; só trabalho técnico carrega engenharia.

package/templates/.agents/skills/zaip-skill-marketing/references/extended-workflow.md

@@ -0,0 +1,16 @@
+# Planejar marketing
+
+## Localização canônica
+
+Salve estratégias, campanhas, calendários, briefings, copy aprovada e ativos de marketing em `.agents/marketing/`. Não salve entregáveis de marketing em `docs/`, na raiz do repositório ou em diretórios de brand, sales ou growth.
+
+O arquivo central da área é `.agents/marketing/strategy.md`; atualize-o quando uma decisão mudar a estratégia de marketing. Campanhas e planos específicos podem ser arquivos adicionais na mesma pasta.
+
+## Descoberta e entrega progressivas
+
+1. Comece pelas referências acessíveis fornecidas — texto, site, PDF, PPT, planilha, arquivo ou imagem. Para cada uma, registre fonte, locator e classificação: fato, decisão aprovada, hipótese, dado ou lacuna. Trate Brandbook aprovado como input somente-leitura e preserve todos os artefatos aprovados; não recrie nem duplique a fonte central da área.
+2. Se o trabalho começar do zero ou o contexto for insuficiente, faça no máximo cinco perguntas críticas por turno, por até três turnos. Pergunte somente por lacunas materiais: objetivo, ICP, oferta, canal, recursos disponíveis ou métrica. Espere as respostas antes de avançar nas partes que delas dependem; silêncio não é resposta nem aprovação. Após três turnos, mantenha lacunas explícitas e use somente hipóteses delegáveis rotuladas; não invente decisões de marca, autoridade, evidência, métricas ou público.
+3. Pedido pontual com contexto suficiente deve ser executado diretamente, sem questionário obrigatório ou plano completo.
+4. Aplique somente as partes necessárias ao escopo solicitado: `objetivo, ICP, oferta, canal, recursos e métrica` → `estratégia e mensagem` → `campanha e copy` → `ativos no escopo`. Identifique o material em construção e consolide somente decisões estratégicas sustentadas em `.agents/marketing/strategy.md`; campanhas, planos e copies específicos ficam em arquivos complementares sem repetir a estratégia central, sem exigir todos os módulos ou formatos.
+5. Produza estratégia, copy, campanha, conteúdo ou aplicação de marca proporcionais ao objetivo e ao escopo aprovado. Copy de marketing ambígua permanece com Lúcia. Não gere imagens, briefs visuais, mockups ou outros ativos por iniciativa própria; produza-os somente quando forem solicitados e estiverem no escopo.
+6. Escalar Sarah somente se uma decisão de marca estiver ausente, contraditória ou precisar ser criada; um Brandbook aprovado não redireciona a entrega para Branding. Encaminhar script voltado a vendas para Aaron, estratégia empresarial/RevOps para Robert, website para Jonny, frontend de produto para Doug e regra visual central para Manu.

package/templates/.agents/skills/zaip-skill-meta-ads-setup/SKILL.md

@@ -7,6 +7,8 @@ description: Configure and connect the official remote Meta Ads MCP for Codex wi
 
 Use esta skill quando o pedido for configurar, conectar ou instalar o Meta Ads MCP. Ela não consulta campanhas; após as tools serem anunciadas, use `$zaip-skill-meta-ads`.
 
+Quando a pessoa pedir teste manual com token Graph ou bearer MCP, encaminhe para `$zaip-skill-meta-token-onboarding`; este fluxo OAuth permanece separado.
+
 1. Execute o precheck no cwd do projeto: `codex --version`, `codex mcp login --help` e `node .agents/skills/zaip-skill-tool-setup/scripts/inspect-tool.mjs meta-ads mcp`. Confirme endpoint e OAuth nas [fontes oficiais verificadas em 2026-09-05](references/official-sources.md). O manifest distribuído permanece `enabled: false`; isso é diferente da configuração local solicitada.
 2. Antes de escrever, confirme que o projeto é trusted no Codex, pois `.codex/config.toml` pode ser ignorado fora de um projeto confiável. Se for ignorado, diagnostique trust e não o altere automaticamente. Preserve o conteúdo de `.codex/config.toml`. Se uma tabela existente usar `url = "https://mcp.facebook.com/ads"`, reutilize seu alias e não duplique a conexão. Se existir `[mcp_servers.meta-ads]` com URL diferente ou configuração incompatível, trate como conflito e não o reescreva. Sem conflito, acrescente uma vez:
 

package/templates/.agents/skills/zaip-skill-meta-token-onboarding/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: zaip-skill-meta-token-onboarding
+description: Orienta teste manual e local da Graph API e do MCP Meta com token temporário, incluindo a validação separada de cada caminho.
+---
+
+# Onboarding de token Meta para iniciantes
+
+Use quando uma pessoa quer testar, com os próprios ativos Meta, a Graph API e uma configuração MCP explicitamente solicitada. Não use para operar campanhas, contornar revisão ou receber segredos no chat.
+
+Explique primeiro o limite: uma conta de desenvolvedor Meta e um app próprio permitem testar ativos aos quais a pessoa já tem acesso e que estão autorizados para o app. Em geral, app review não é necessário apenas para pessoas com papel no app e ativos próprios; a Meta pode exigir verificações, acesso adicional ou impor limites conforme o produto, a conta e a política vigente. Leia o [guia detalhado](references/onboarding-manual.md) antes de orientar execução.
+
+1. Guie a pessoa no Graph API Explorer: escolha o app próprio, `Token do usuário`, as permissões de API `ads_read` e `business_management`, e clique em **Gerar token**. Se o painel atual mostrar dependências, inclua `pages_read_engagement` e `pages_show_list` somente quando exigidas. Ela nunca cola token, App Secret ou URL de autorização no chat.
+2. Somente se a pessoa autorizar explicitamente configurar, trocar ou testar, use `$zaip-skill-local-credentials` para acessar o `.env` ignorado da raiz. Essa autorização cobre os passos locais necessários daquele fluxo. Valide o token temporário com `GET /me` antes de o substituir e faça a troca server-side pelo token de longa duração retornado pela Meta. Não exponha credenciais em argumentos, URLs, logs, records ou evidências.
+3. Faça a prova da API em leituras `GET` paginadas: `/me`, `/me/businesses`, `owned_ad_accounts` e `client_ad_accounts` da BM escolhida, depois `/act_ID/campaigns`. Deduplicate contas pelo ID, peça que a pessoa escolha uma conta `act_...` e declare resultados vazios, limites e escopos insuficientes como tais.
+4. Para afirmar que o MCP foi validado, faça uma prova separada no endpoint `https://mcp.facebook.com/ads`. No ramo bearer explicitamente solicitado, confira o contrato atual, inclua `ads_mcp_management` se exigido e use o mapeamento seguro da variável local no host ou um agente HTTP direto que a mantenha em memória. Inicialize, envie `notifications/initialized`, obtenha `tools/list` e execute uma leitura de campanhas na mesma `act_ID`, preservando os headers de sessão e versão de protocolo solicitados pelo servidor. POST é permitido só para esses métodos MCP e uma ferramenta de leitura. Para o ramo OAuth, use `$zaip-skill-meta-ads-setup`. Esses escopos não autorizam escrita; só declare falha MCP quando uma falha for observada.
+
+Não execute chamadas, grave `.env` ou renove token só porque esta skill foi lida. Um pedido explícito de configurar, trocar ou testar autoriza os passos necessários daquele fluxo, sem ampliar para escrita. Use os prompts sem segredo e as referências de política no guia.

package/templates/.agents/skills/zaip-skill-meta-token-onboarding/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Onboarding de Token Meta"
+  short_description: "Guia local de token para Graph API e MCP Meta"
+  default_prompt: "Use $zaip-skill-meta-token-onboarding para testar Graph API e MCP Meta com token local, sem receber segredos no chat."