Skip to content
triunfoquantico-cellPublic
forked from vdloureiro/RoasOS

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RoasOS

Framework de 9 Agentes IA para Criação Completa de Funis de Venda para Infoprodutos Brasileiros

O RoasOS é um sistema multi-agente que roda dentro do Claude Code e automatiza todo o processo de criação de funil de vendas — da pesquisa de mercado até as páginas prontas para publicação.

Você fornece as informações do seu produto e público-alvo. Os 9 agentes fazem o resto.


O Que o RoasOS Entrega

Ao final da execução, você recebe uma pasta completa na sua área de trabalho com:

# Entregável Formato
1 Relatório completo de espionagem de mercado (5+ concorrentes, 20+ anúncios analisados) .doc
2 Perfil detalhado da persona/público-alvo .doc
3 Estratégia de marketing (tese, mecanismo único, inimigo comum) .doc
4 Roteiro VSL do produto principal (~20 minutos, 3.000+ palavras) .doc
5 Roteiro VSL do upsell (~8-12 minutos, 1.500-2.500 palavras) .doc
6 Página de vendas do produto principal .html + .json (Elementor)
7 Página de upsell .html + .json (Elementor)
8 Página de obrigado .html + .json (Elementor)
9 30 scripts de anúncios em vídeo com instruções de gravação .doc
10 Headlines para página e anúncios .doc
11 FAQ estratégico (8+ perguntas) .doc
12 Sequência de 5+ emails de follow-up .doc
13 Arquitetura do funil de upsell (13 passos) .doc
14 Relatório de revisão final com scoring de qualidade .doc

Formatos de Entrega

  • Textos (VSLs, copy, pesquisa, emails, scripts de vídeo): .doc
  • Páginas web: .html auto-contidas com Tailwind CSS (abrem direto no navegador)
  • Páginas WordPress: .json para importação direta no Elementor
  • Metadados do projeto: projeto.yaml

Pré-requisitos

  • Claude Code CLI instalado e configurado
  • Conta Anthropic com acesso ao Claude

Instalação

1. Clone o repositório

git clone https://github.com/vdloureiro/RoasOS.git
cd RoasOS

2. Execute o instalador

chmod +x bin/install.sh
bash bin/install.sh

O instalador vai validar:

  • Presença do Claude Code CLI
  • Estrutura completa de diretórios (.roasos/ e .claude/)
  • Todos os 9 agentes configurados
  • Arquivos críticos (constituição, framework, scoring matrix)
  • Diretório de output

3. Pronto para usar

Após a instalação, basta abrir o Claude Code dentro da pasta do projeto:

claude

Como Usar — Passo a Passo

Passo 1: Inicie o projeto

Dentro do Claude Code, digite:

@orquestrador iniciar-projeto

Passo 2: Forneça as informações do seu produto

O orquestrador vai pedir:

  1. Nome do projeto — Ex: "Método Corpo Seco"
  2. Nicho — Ex: "Emagrecimento feminino"
  3. Público-alvo — Descrição detalhada do seu avatar (idade, gênero, dores, desejos, situação atual)
  4. Produto principal — Nome, descrição, preço, o que inclui
  5. Oferta do produto principal — Bônus, garantia, condições especiais
  6. Produto upsell — Nome, descrição, preço, o que inclui
  7. Oferta do upsell — Bônus, garantia, condições especiais
  8. Plataforma de pagamento — Hotmart, Kiwify, Eduzz, etc.

Passo 3: Escolha o modo de execução

  • Modo Autônomo — O sistema executa todas as 8 etapas automaticamente sem parar. Você recebe o projeto completo no final. Quality gates são aplicados internamente.
  • Modo Supervisionado — O sistema para ao final de cada etapa para você revisar e aprovar antes de avançar para a próxima.

Passo 4: Aguarde a execução

O sistema vai executar o fluxo completo:

Pesquisa → Estratégia → 2 VSLs → Copy + 30 Vídeo Ads → Upsell → Design → Revisão UX → Revisão Final

Cada etapa passa por um Quality Gate (scoring de 100 pontos, mínimo 80 para aprovação).

Passo 5: Receba os entregáveis

Todos os arquivos são salvos automaticamente na sua área de trabalho:

~/Desktop/2026-03-27_metodo-corpo-seco/
├── 01-pesquisas/          # Relatórios de espionagem e persona
├── 02-estrategia/         # Tese de marketing e mecanismo único
├── 03-vsls/               # 2 roteiros de VSL (.doc)
├── 04-paginas/
│   ├── html/              # 3 páginas HTML com Tailwind CSS
│   └── elementor/         # 3 JSONs para importar no Elementor
├── 05-criativos/          # 30 scripts de anúncios em vídeo (.doc)
├── 06-emails/             # Sequência de emails de follow-up (.doc)
├── 07-copy/               # Headlines, FAQ, copy complementar (.doc)
├── 08-revisao/            # Relatório de qualidade e scoring (.doc)
└── projeto.yaml           # Metadados e estado do projeto

Outros Comandos Úteis

# Ver o status atual do projeto
@orquestrador status

# Exportar e verificar projeto finalizado
@orquestrador exportar

Os 9 Agentes

Agente Persona Fase O Que Faz
@orquestrador Maestro Todas Coordena todo o fluxo, coleta dados, gerencia transições entre fases
@espiao Agente Secreto 1 — Pesquisa Espionagem de mercado: 5+ concorrentes, 20+ anúncios, 4 métodos (Meta Ads, Reclame Aqui, Google Ads, Taboola)
@estrategista Maquiavel 2 — Estratégia Cria tese de marketing, mecanismo único proprietário, define inimigo comum, mapeia crenças
@roteirista Spielberg da Copy 3 — VSLs Escreve 2 roteiros de vídeo: VSL principal (~20min, LHTO) + VSL upsell (~8-12min)
@copywriter Ogilvy BR 4 — Copy Headlines, FAQ, emails de follow-up + 30 scripts de anúncios em vídeo com instruções de gravação
@upsell-architect Funil Master 5 — Funil Arquiteta o fluxo de upsell em 13 passos para maximizar o ticket médio
@designer Arquiteto Digital 6 — Design Cria 3 páginas HTML profissionais (Tailwind CSS) + 3 exports Elementor JSON
@ux-designer Pixel Perfect 6.5 — UX/UI Revisa e otimiza responsividade, conversão visual e acessibilidade de todas as páginas
@revisor Crítico Implacável Gates Avalia cada entregável com scoring de 100 pontos. Gate mínimo: 80 pontos

Fluxo de Trabalho Detalhado

@orquestrador iniciar-projeto
  │
  ▼
@espiao pesquisar
  │  (5+ concorrentes, 20+ anúncios, persona, padrões de mercado)
  ▼
@revisor score-pesquisa (gate >= 80)
  │
  ▼
@estrategista criar-estrategia
  │  (tese de marketing, mecanismo único, inimigo comum)
  ▼
@revisor score-estrategia (gate >= 80)
  │
  ▼
@roteirista escrever-vsl
  │  (VSL principal 3.000+ palavras + VSL upsell 1.500-2.500 palavras)
  ▼
@revisor score-vsl (gate >= 80)
  │
  ▼
@copywriter criar-copy
  │  (headlines, FAQ, emails, 30 scripts de vídeo)
  ▼
@upsell-architect criar-funil
  │  (upsell em 13 passos)
  ▼
@designer criar-paginas
  │  (3 páginas HTML + 3 Elementor JSON)
  ▼
@ux-designer revisar-paginas
  │  (otimização UX/UI, responsividade, conversão)
  ▼
@revisor revisar-tudo (gate >= 80)
  │
  ▼
@orquestrador finalizar
  (relatório final, verificação de entregáveis)

Fluxo do Funil Gerado

Anúncio (Vídeo) → Página de Vendas → Checkout → Página de Upsell → Página de Obrigado
                                                        │
                                                        └─ (Recusou) → Página de Obrigado

O RoasOS não utiliza downsell. O funil é composto por 3 páginas: vendas, upsell e obrigado.


Quality Gates

Cada entregável é avaliado pelo @revisor usando uma matriz de scoring de 100 pontos distribuída em 5 categorias:

Categoria Pontos O Que Avalia
Estrutura 25 pts Lead, história, tese, oferta (14 seções)
Persuasão 25 pts Gatilhos mentais, objeções, ancoragem, garantia, CTAs
Emoção 20 pts Arco emocional, future pacing, linguagem, conexão
Técnico 15 pts Contagem de palavras, responsividade, Elementor JSON, dark mode
Funil e Anúncios 15 pts Upsell 13 passos, 30 scripts de vídeo, instruções de gravação

Resultados do Quality Gate

  • >= 80 pontos: APROVADO — avança para próxima fase
  • 60-79 pontos: REVISÃO — agente responsável recebe feedback e refaz
  • < 60 pontos: REESCREVER — output descartado, agente recomeça

Sobre os 30 Scripts de Vídeo

Todos os 30 anúncios são scripts de vídeo com instruções detalhadas de gravação. Cada script inclui:

  • Hook visual (primeiros 3 segundos)
  • Roteiro de narração completo
  • Descrição das cenas e B-roll sugerido
  • Text overlays recomendados
  • Duração alvo e formato
  • Mood da música/trilha
  • Ângulo de copy (dor, curiosidade, resultado, autoridade, etc.)

Os scripts são baseados nos padrões identificados na espionagem de anúncios dos concorrentes pelo @espiao.


Sobre as Páginas Elementor

Cada página é entregue em dois formatos:

  1. HTML auto-contido — Abre direto no navegador. Usa Tailwind CSS via CDN. Sem dependências externas.
  2. JSON para Elementor — Importação direta no WordPress/Elementor via o recurso de importar template. Inclui todas as seções, widgets e configurações.

Base de Conhecimento

O RoasOS vem com uma base de conhecimento completa que os agentes consultam:

Arquivo Conteúdo
framework-copy-completo.md Framework LHTO completo, 14 seções de oferta, métodos de espionagem, personalização por nicho
gatilhos-mentais.md 15 gatilhos mentais com exemplos e matriz de uso por agente
formulas-headlines.md 10+ fórmulas de headlines para páginas, vídeo ads e emails
objecoes-comuns.md Objeções universais e por nicho com contra-argumentos

Estrutura do Projeto

RoasOS/
├── .claude/
│   ├── CLAUDE.md                # Documentação do sistema para o Claude
│   ├── settings.json            # Configuração de idioma
│   ├── agents/                  # 9 agentes no formato Claude Code
│   └── commands/roasos/         # Comandos: iniciar, status, exportar
│
├── .roasos/
│   ├── constitution.md          # 10 artigos invioláveis
│   ├── agents/                  # 9 definições canônicas dos agentes
│   ├── tasks/                   # 47 instruções de tarefas (9 subpastas)
│   ├── templates/
│   │   ├── copy/                # Templates de VSL, lead, oferta, headlines, ads
│   │   ├── briefing/            # Templates de briefing (concorrente, persona, produto)
│   │   ├── html/                # Páginas HTML base com Tailwind CSS
│   │   └── elementor/           # Templates JSON para Elementor WordPress
│   ├── data/                    # Base de conhecimento (framework, gatilhos, fórmulas)
│   └── checklists/              # Scoring matrix + checklist pré-lançamento
│
├── bin/install.sh               # Script de instalação e validação
├── output/                      # Output local (gitignored)
├── README.md
├── LICENSE
└── .gitignore

Modos de Operação

Modo Autônomo (Recomendado)

O sistema executa todas as 8 etapas de forma contínua, aplicando quality gates internamente. Você recebe o projeto completo no final. Ideal para quem quer velocidade e confia no processo.

Modo Supervisionado

O sistema para ao final de cada etapa e apresenta os entregáveis para sua aprovação. Você pode solicitar ajustes antes de avançar. Ideal para quem quer mais controle sobre cada fase.


Perguntas Frequentes

Preciso saber programar?

Não. O RoasOS funciona inteiramente dentro do Claude Code. Você só precisa fornecer as informações do seu produto e acompanhar o processo.

Posso usar as páginas HTML direto?

Sim. As páginas HTML são auto-contidas e abrem em qualquer navegador. Você pode hospedar em qualquer servidor estático.

Como importo no WordPress/Elementor?

No painel do WordPress, vá em Templates > Importar e selecione o arquivo .json correspondente. O template será importado com todas as seções e widgets configurados.

Posso rodar mais de um projeto?

Sim. Cada projeto gera uma pasta separada na área de trabalho com a data do dia. Não há conflito entre projetos.

O que acontece se um entregável não passar no Quality Gate?

O agente responsável recebe feedback detalhado e refaz o trabalho. Isso acontece automaticamente. Há no máximo 3 tentativas por fase.

Por que não tem downsell?

O RoasOS foi projetado para funis simplificados de alta conversão: Vendas → Upsell → Obrigado. Se precisar de downsell, considere o ClawOS Funnel.


Licença

MIT License — veja LICENSE para detalhes.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages