Primeira configuração de um membro da equipe
Alguém acabou de instalar um pacote de skills e não sabe o que é necessário. Esta skill o guia passo a passo até que ele possa trabalhar. Fala-se em português, sem jargão, e cada etapa é verificada de verdade antes de passar para a próxima — nada de «já deve funcionar».
Regra que vale acima de todas
Não se avança para o próximo passo sem verificar o anterior com um comando. Se um passo falhar, para-se ali e resolve-se. Quem instala isso não precisa saber o que é um terminal: se algo for pedido, dá-se o comando inteiro, pronto para copiar, e diz-se o que deve aparecer.
Passo 0 — O que foi instalado
python3 instalar.py --revisar
Se não encontrar o arquivo, é que o repositório não foi clonado: dá-se a ordem de clonar novamente. A saída mostra o que está faltando. Resolve-se de cima para baixo, nessa ordem.
Passo 1 — As ferramentas
| Falta | O que se diz |
|---|---|
| Python 3 | Já vem no Mac. Se realmente falhar: brew install python |
| rclone | brew install rclone — é o que conecta ao Drive |
| openpyxl | pip3 install openpyxl — só se for mexer em planilhas de relatórios |
| ffmpeg | brew install ffmpeg — apenas se for editar vídeo (e então, tudo de editar-vsl-cliente/INSTALACAO.md). Caso contrário, pula |
Se não tiver Homebrew: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Passo 2 — Conectar o Drive da agência
É o passo que mais falha e o mais importante: sem Drive não há brief, nem branding, nem onde deixar nada.
rclone config
E vai-se dizendo, uma a uma, o que digitar:
n(novo remoto)- Nome:
gdrive← exato, em minúsculas. As skills o buscam com esse nome. - Tipo: digitar
drive client_ideclient_secret: Enter (em branco)- Escopo:
1(acesso completo) root_folder_id: Enter- Service account: Enter
- Configuração avançada:
n - Usar navegador:
y→ abre o Chrome → entrar com a conta da Flowboost que foi fornecida pela Direção, e aceitar - Shared drive:
n· Confirmar:y· Sair:q
Verificar de verdade (não basta que ele diga que terminou):
rclone lsd gdrive: | head -5
Deve aparecer uma lista de pastas de clientes (i_…, c_…). Se sair vazio ou der erro, não está conectado: repete-se o passo 2.
Passo 3 — Sua pasta de trabalho
mkdir -p ~/Desktop/CLIENTES && echo OK
Tudo que é baixado ou criado de um cliente fica em ~/Desktop/CLIENTES/<cliente>/. Nunca solto em Downloads.
Passo 4 — O que é necessário APENAS em algumas áreas
Perguntar do que ele vai cuidar e montar só o que é dele. Não se pede nada que ele não vá usar.
| Se cuidar de… | Precisa | Quem fornece |
|---|---|---|
| Campanhas ou relatórios | acesso de leitura ao Meta Ads | Direção adiciona ao Business Manager |
| Relatórios | nada mais: as planilhas já estão no Drive | — |
| Estáticos | a conta da ChatGPT da agência | Direção. ⚠️ Nunca a conta <email-direcao> |
| Vídeo | bem mais que ffmpeg: bibliotecas Python, modelo de transcrição, ferramentas de QC, MoneyPrinterTurbo com sua chave do Pexels e ~8 GB de disco. Segue-se editar-vsl-cliente/INSTALACAO.md passo a passo e verifica-se com python3 ~/.claude/skills/editar-vsl-cliente/scripts/verificar_ambiente_edicao.py | ele mesmo (a chave do Pexels ele coloca, nunca por chat) |
| Landings | acesso ao hospedagem do cliente | Direção, quando for publicar |
⚠️ Nunca se pedem senhas ou chaves por chat, nem o agente as digita. Se algo precisar de uma chave, ele a coloca em seu computador e explica-se onde.
Passo 5 — O teste real
Não se dá por encerrado até que isso funcione:
rclone lsd gdrive: | wc -l
Se sair um número maior que zero, está pronto. Então se diz o que ele já pode pedir, com exemplos de sua área:
- Relatórios: «me dê o relatório de », «cadastre nos relatórios»
- Campanhas: «monte a campanha de » (cria-se em pausa; ativar é sempre da Direção)
- Estáticos: «monte os estáticos de »
- Landings: «escreva o copy da landing de »
E o que ele precisa saber desde o minuto um
- Todo texto para clientes vai em português de Portugal. Nunca usar tu/você de forma informal.
- Não inventar nada: números, depoimentos, datas nem garantias. O que faltar marca-se
[FALTA]. - O Drive do cliente é somente leitura, exceto os entregáveis em sua pasta.
- Ativar uma campanha é sempre da Direção. O agente as deixa em pausa.
- Se faltar um acesso, avisa-se e para-se. Não se segue pela metade.
Se algo quebrar
| Sintoma | Quase sempre é |
|---|---|
| «não encontro a pasta do cliente» | o Drive não está conectado → passo 2 |
| «o arquivo … não existe» | falta o pacote fundamentos → instalá-lo também |
| o copy sai sem critério | mesma coisa: falta fundamentos, e não avisa sozinho |
| «command not found: rclone» | passo 1 |