O framework de IA
que opera a Lead Land
Este documento mostra como usamos inteligência artificial não só para criar conteúdo — mas para operar a empresa inteira: times, clientes, produto e crescimento.
O que é o leadland-core?
O leadland-core é o repositório central de toda a operação tecnológica da holding.
Dentro dele vivem o agente Jarvis (assistente de IA no WhatsApp), a
plataforma web, os projetos de clientes e o sistema de agentes que
executa tudo.
├── Jarvis ← agente WhatsApp, tasks, agenda, automações
├── Platform ← produto SaaS (Next.js + Supabase)
├── Clientes ← landing pages, bots, campanhas
├── AIOX ← framework de agentes de desenvolvimento
└── Skills ← 37 capacidades especializadas
O que é o AIOX
Um sistema de orquestração que organiza como os agentes de IA trabalham dentro do repositório.
Em vez de pedir tudo para um único "Claude genérico", o AIOX define agentes especializados, cada um com sua área de atuação, suas responsabilidades e seu fluxo de trabalho. É como contratar um time — cada um sabe o que é dele.
O AIOX tem uma Constituição formal com princípios que os agentes não podem violar: nada é inventado, tudo parte de histórias documentadas, qualidade vem antes de velocidade.
Agentes do Time
Cada agente é ativado com @nome e tem autoridade exclusiva no seu domínio.
Ciclo de Trabalho
Tudo começa com uma história documentada. Nada é construído sem passar pelo ciclo completo.
Story Development Cycle
Cada "história" é um documento estruturado com o que precisa ser feito, os critérios de aceite e o progresso em tempo real. Nada avança sem estar documentado — o que elimina retrabalho e garante que qualquer pessoa do time (ou agente) saiba exatamente o estado de cada entrega.
Como instalar uma skill
npx skills add owner/repo@skill-name -yApós instalada, a skill é ativada automaticamente dentro do Claude Code. Sem configuração adicional.
Skills Instaladas
Skills são capacidades especializadas instaladas no Claude Code. Cada uma adiciona conhecimento profundo sobre um domínio específico — como instalar um módulo de especialista.
Segurança — API Keys & Credenciais
A parte mais crítica de qualquer estrutura com IA e automações. Credenciais expostas comprometem toda a operação.
Onde guardar cada tipo de credencial
| O que | Onde guardar |
|---|---|
| API keys de serviços | Arquivo .env local — nunca commitado |
| Credenciais de produção | Variáveis de ambiente no servidor |
| Tokens de clientes | Gerenciador de senhas (1Password, Bitwarden) |
| Service accounts (Google) | Arquivo JSON fora do repositório ou em vault |
| Secrets de CI/CD | GitHub Actions Secrets — nunca em código |
Padrão de configuração
Todo projeto usa dois arquivos:
# .env — NUNCA commitar (já está no .gitignore)
MINHA_API_KEY=valor_real_aqui
OUTRO_TOKEN=valor_real_aqui
# .env.example — commitar normalmente (sem valores)
MINHA_API_KEY=
OUTRO_TOKEN=Checklist antes de compartilhar qualquer arquivo
.env real anexado