⚡ AGÊNCIA OS — Sistema Operacional para Agências

Um comando. Toda a estrutura operacional da sua agência.
Baseado em 12 metodologias premium de marketing, branding e gestão.

🧠 O que é isso?

O Agência OS é uma CLI (ferramenta de linha de comando) que cria, em segundos, toda a base de organização de uma agência de marketing digital — pastas, personas de IA, templates, briefings, metodologias, financeiro e muito mais.

É uma base universal: serve para qualquer tipo de agência — social media, tráfego pago, branding, infoprodutos, e-commerce, agências internacionais.

Você roda um único comando e recebe um workspace completo, pronto para trabalhar com IA.

⚙️ Como instalar e rodar

Você precisa ter o Node.js instalado (versão 18 ou superior).

# Navegar para a pasta do Google Drive (ou OneDrive / Dropbox)
cd "G:\Meu Drive"

# Rodar o CLI
npx agencia-os

💡 Recomendação: Rode sempre de dentro do seu Google Drive ou OneDrive para que toda a equipe tenha acesso em tempo real aos arquivos.

🚀 Fluxo de uso — do zero ao produtivo

Passo 1 — Iniciar o CLI

npx agencia-os

O terminal vai exibir o menu principal com 3 opções:

| Opção | O que faz | |---|---| | 🏗️ Criar estrutura da agência | Gera todo o workspace (use na primeira vez) | | 🔍 Buscar referências para conteúdo | Abre Google, Dribbble, Meta Ads Library automaticamente | | ❓ Ajuda & Onboarding | Guia interativo completo do sistema |

Passo 2 — Criar a estrutura

Escolha "Criar estrutura" e responda apenas 2 perguntas:

1. Nome da agência — Ex: Fehari Studio
2. Nicho principal — Ex: Social Media, Tráfego Pago, Branding

O sistema instala automaticamente todos os 9 módulos. Sem seleção, sem configuração.

Passo 3 — Abrir no Cursor (IA)

code nome-da-agencia/

Ative o .cursorrules no Cursor:
Settings → Rules for AI → marque "Include .cursorrules file"

A partir daí, o agente de IA vai operar como um Diretor de Operações Sênior, seguindo os protocolos automaticamente.

Passo 4 — Adicionar um novo cliente

1. Duplique a pasta 04_Banco_de_Clientes/_TEMPLATE_CLIENTE/
2. Renomeie para o nome do cliente: 04_Banco_de_Clientes/Estalo/
3. Comece SEMPRE pela pasta 00_Identidade_Visual/
4. Adicione o PDF do manual de identidade visual
5. Preencha identidade_visual_extraida.txt com as informações extraídas

⚠️ Regra inviolável: Nenhum criativo é produzido sem a identidade visual documentada.

📁 Estrutura gerada

nome-da-agencia/
│
├── .cursorrules                      ← Roteador operacional da IA (leia primeiro)
│
├── 00_Sistema_e_Governanca/          ← Manifesto, SOPs, Checklists
│   ├── regras_globais/manifesto_operacional.txt
│   ├── checklists/checklist_entregavel.txt
│   └── sops/sop_novo_cliente.txt
│
├── 01_Cerebro_e_Personas/            ← 7 especialistas com metodologias completas
│   └── personas/
│       ├── copywriter.txt            ← Alex (Schwartz, Ca$hvertising, Brain Audit)
│       ├── designer_ux.txt           ← Maya (22 Laws, Sprint, Typographic Style)
│       ├── estrategista_marca.txt    ← Rafael (Obviously Awesome, Godin, Ries)
│       ├── gestor_trafego.txt        ← Diego (Hooked, Scientific Advertising)
│       ├── analista_performance.txt  ← Luana (North Star Metric, Cohort Analysis)
│       ├── especialista_crm.txt      ← Carolina (Email Persuasion, Predictable Revenue)
│       └── analista_inteligencia.txt ← Bruno (SWOT Competitivo, Mapa de Empatia)
│
├── 02_Biblioteca_Metodologias/       ← 12 frameworks premium documentados
│   ├── copywriting/frameworks_copy.txt    ← PAS, AIDA, StoryBrand, PASTOR, Brain Audit...
│   ├── branding/identidade_e_posicionamento.txt
│   ├── psicologia_vendas/gatilhos_mentais.txt
│   └── gestao_projetos/sprint_e_entregas.txt
│
├── 03_Onboarding_e_Briefings/        ← Briefings completos prontos para usar
│   └── templates/
│       ├── briefing_estrategico_completo.txt
│       ├── briefing_identidade_visual.txt
│       └── briefing_reels_e_conteudo.txt
│
├── 04_Banco_de_Clientes/             ← Um cliente = uma pasta completa
│   └── _TEMPLATE_CLIENTE/            ← Duplique para cada novo cliente
│       ├── 00_Identidade_Visual/     ← SEMPRE começa aqui
│       ├── 01_Estrategia_e_Posicionamento/
│       ├── 02_Pesquisa_e_Inteligencia/
│       ├── 03_Producao_Conteudo/
│       ├── 04_Design_e_Ativos/
│       ├── 05_Trafego_e_Performance/
│       ├── 06_Gestao_do_Relacionamento/
│       └── 07_Entregaveis_Aprovados/
│
├── 05_Pesquisa_e_Referencias/        ← Inteligência de mercado
│   ├── metodo_pesquisa_inteligencia.txt
│   └── tendencias_2025/tendencias_marketing_2025.txt
│
├── 06_Templates_Producao/            ← Templates prontos para usar
│   ├── copywriting/
│   │   ├── template_landing_page_completa.txt
│   │   └── templates_reels_e_ads.txt
│   └── relatorios/template_relatorio_mensal.txt
│
└── 07_Financeiro_e_Processos/        ← Precificação, propostas, contratos
    ├── precificacao/modelo_precificacao.txt
    └── propostas/template_proposta_comercial.txt

🤖 O .cursorrules — o cérebro do sistema

O arquivo .cursorrules é a peça central. Ele transforma qualquer IA (Cursor, Claude, ChatGPT, Gemini) em um Diretor de Operações Sênior que executa 7 protocolos automaticamente:

| Protocolo | Nome | O que faz | |---|---|---| | 0 | Leitura Obrigatória | Verifica identidade visual, pacote e histórico antes de qualquer entrega | | 1 | Visual Copywriting | Texto pensado como elemento gráfico — headlines máx. 7 palavras | | 2 | Roteamento de Departamentos | Detecta o tipo de demanda e ativa a persona correta automaticamente | | 3 | Navegação Proativa | Busca no Dribbble, Meta Ads Library e Google antes de sugerir | | 4 | Identidade Visual Inviolável | Usa APENAS cores e fontes documentadas do cliente | | 5 | Anti-Repetição | Verifica entregáveis aprovados para nunca repetir conceitos | | 6 | Formato de Saída | Texto puro, nomenclatura YYYY-MM-DD, sem Markdown | | 7 | Cliente Internacional | Detecta cliente gringo e ativa copy 100% nativo americano |

Como ativar o agente corretamente no Cursor

"Estou trabalhando no cliente [NOME].
 Leia o tom_de_voz.txt e o identidade_visual_extraida.txt
 e crie um roteiro de Reel para o Instagram."

"@identidade_visual_extraida.txt @posicionamento.txt
 Crie 3 opções de headline para um ad no Meta.
 O público está no nível de consciência 2 (sabe do problema)."

🔍 Busca de referências automatizada

O segundo modo do CLI abre automaticamente os melhores sites de referência do mercado no seu navegador:

npx agencia-os
# → Escolha "Buscar referências para conteúdo"

Fontes abertas por tipo de conteúdo:

| Tipo | Fontes abertas | |---|---| | Copy / Email | Swipe Worthy, Swiped.co, Google Trends | | Anúncio / Ad | Meta Ads Library, TikTok Creative Center, Swipe Worthy | | Reels / Vídeo | TikTok Creative Center, Instagram hashtag, YouTube | | Design / LP | Dribbble, Behance, Awwwards | | Logo / Branding | Dribbble, Behance, Logopond, Brand New |

💡 Dica: Execute ANTES de começar qualquer entregável. O Protocolo 3 do agente exige pesquisa validada.

📚 Metodologias incluídas

O sistema é baseado nestas 12 obras:

| # | Livro | Autor | Aplicação | |---|---|---|---| | 1 | Ogilvy on Advertising | David Ogilvy | Fundamentos de advertising | | 2 | Building a StoryBrand | Donald Miller | Framework de narrativa de marca | | 3 | Influence | Robert Cialdini | 7 princípios de persuasão | | 4 | This Is Marketing | Seth Godin | Posicionamento mínimo viável | | 5 | The Brain Audit | Sean D'Souza | 7 sacos de preocupação do comprador | | 6 | Breakthrough Advertising | Eugene Schwartz | Níveis de consciência do público | | 7 | Ca$hvertising | Drew Eric Whitman | 8 desejos biológicos humanos | | 8 | Sprint | Knapp & Zeratsky | Design sprint para agências | | 9 | The 22 Immutable Laws of Branding | Al Ries | Leis imutáveis de marca | | 10 | Obviously Awesome | April Dunford | Framework de posicionamento | | 11 | Hooked | Nir Eyal | Produtos que criam hábito | | 12 | The Elements of Typographic Style | Bringhurst | Hierarquia tipográfica |

🔄 Atualizando — seus dados estão 100% seguros

Se você rodar o CLI novamente na mesma pasta, o sistema detecta o workspace existente e oferece 3 opções:

• 🛑 Cancelar — nenhum arquivo tocado
• 🔄 Atualizar sistema — atualiza personas e templates, clientes intactos
• ⚠️ Recriar — sobrescreve sistema, clientes continuam intactos

Arquivos que NUNCA são tocados pelo CLI:

04_Banco_de_Clientes/[NOME-DO-CLIENTE]/   ← 100% seu
07_Entregaveis_Aprovados/                  ← 100% seu
Qualquer arquivo que você criou manualmente

🌐 Módulo Internacional (EN-US)

Para clientes americanos ou de mercado anglófono, o sistema inclui arquivos especiais em _TEMPLATE_CLIENTE/01_Estrategia_e_Posicionamento/:

• tom_de_voz_en.txt — Guia de voz e personalidade em inglês nativo
• guia_copy_mercado_us.txt — Templates de ad, LP e email para o mercado americano

O Protocolo 7 é ativado automaticamente quando o arquivo tom_de_voz_en.txt existe na pasta do cliente.

Regras de ouro:

✅ "You're gonna love this"
❌ "You are going to love this" (soa como bot)

✅ "we messed up"
❌ "we apologize for the inconvenience"

Banidas: seamless, innovative, cutting-edge, utilize, kindly

🏗️ Para equipes — trabalho colaborativo

O sistema é projetado para rodar de dentro do Google Drive, OneDrive ou Dropbox.

Isso significa:

• Toda a equipe vê os arquivos de clientes em tempo real
• Sem repositório Git para gerenciar
• Sem servidor para configurar
• Funciona em Mac, Windows e Linux

# Mac/Linux
cd ~/Google\ Drive/Minha\ Agência
npx agencia-os

# Windows
cd "G:\Meu Drive\Minha Agência"
npx agencia-os

O Cloud Guard detecta automaticamente se você está fora de uma pasta de nuvem e avisa antes de criar o workspace em local não sincronizado.

📄 Licença

MIT — use, modifique e distribua livremente.

Criado por Fehari Studio | Iron Framework v5.0