Perguntas Frequentes

Tire suas dúvidas.

Tudo que rolou nas aulas e mentorias do AIOX Pro, organizado pra você encontrar rápido.

Claude Code, Tokens & Custos
Preciso assinar o Claude Max ($200)? Vale mais que a API?
Não é obrigatório, mas é altamente recomendado. Uma conta de $200 equivale a ~$2.500–$3.500 de API. Se precisar de mais, compre uma segunda, terceira, quarta conta. Nunca ative o "uso extra" porque vai cobrar preço de API normal. Pense como conta de luz — custo básico de operar.
— Alan
Qual a diferença entre /compact e /clear? Quando usar cada um?
O /compact tenta comprimir o contexto mas consome ~25k tokens de buffer e a qualidade pode não ser boa. O /clear limpa tudo — o Claude volta no pico de qualidade. Desative o auto-compact em /config. Acima de 100k tokens a qualidade cai até 50%. Regra do Alan: passou de 100k, dá /clear sempre. Use /context para ver o uso atual. O /clear salva a conversa automaticamente.
— Alan/Wanderson
A troca entre Haiku, Sonnet e Opus é automática? Preciso escolher?
Sim, é automática. Você não precisa colocar /model. A IA sabe quando usar Haiku (tarefas simples), Sonnet (código complexo) ou Opus automaticamente. Cada agente já tem configurações de Front Matter que definem qual modelo usar.
— Alan
Como transferir o contexto quando preciso limpar a janela?
Use handoff (skill de transferência de contexto) ou, melhor ainda, crie um Story oficial. Pedro aboliu handoff e só usa Stories agora — o Story funciona como checkpoint. Após /clear, o agente relê o Story e retoma de onde parou.
— Alan/Pedro
Meu MacBook com 48GB de RAM já dá pra rodar modelos locais?
Sim, é suficiente para modelos menores e médios. Não precisa de Mac Studio. RAM é o principal limitador — modelos maiores precisam de mais memória.
— Comunidade
Instalação & Configuração
Posso usar o iCloud para os projetos? Onde devo salvar?
Não! iCloud dá muito problema com projetos de desenvolvimento. Crie uma pasta chamada "Code" dentro do seu usuário principal (ex: /Users/seu-nome/Code) e coloque tudo lá.
— Alan
Qual a sequência correta de setup? /init vem antes do /devops?
Sim. Sequência: Claude → /devops → *environment-bootstrap (configuração local) → *setup-github (configuração remota). O environment-bootstrap configura sua máquina (Git, GitHub CLI, variáveis). O setup-github configura o GitHub (CI/CD, CodeRabbit, branch protection, secrets).
— José Carlos/Pedro e 06
Preciso do Docker mesmo usando Supabase remoto?
Docker Desktop é usado para testes locais automatizados, não necessariamente para o banco. Precisa estar aberto no computador. É uma das obrigatoriedades do ambiente.
— Pedro
O CodeRabbit free funciona? Como é o fluxo de review?
A conta gratuita em app.coderabbit.ai funciona (30 dias grátis). Para repos privados, precisa do GitHub Pro (~$5-10). Após *setup-github, CodeRabbit é configurado automaticamente. Fluxo: você cria PR → CodeRabbit analisa → deixa comentários → @dev corrige → novo commit → re-análise (máx 5 iterações).
— Pedro/Alan e 06
Recebi um squad pelo WhatsApp. Como instalo?
Baixe o zip, descompacte e coloque dentro de squads/ na raiz do projeto. Depois no Claude Code, peça para sincronizar e criar os comandos. Pode remover a pasta __MACOSX. É bom atualizar os comandos também, porque novos comandos podem ter sido adicionados.
— Alan
A pasta skills fica onde? Qual a diferença entre local e global?
Local (por projeto): .claude/skills/ dentro do projeto — só funciona naquele projeto.
Global (todos os projetos): ~/.claude/skills/ na pasta do usuário — funciona em qualquer projeto.
— Alan/Rafael Costa
Agentes, Squads & Comandos
Quando usar / (barra) e quando usar @ (arroba)?
SEMPRE use / no Claude Code. O @ apenas lê o arquivo .md do agente sem executar os scripts (Greeting Builder, Context Detector, etc.). O / executa tudo corretamente. No Cursor e Gemini o @ funciona diferente, mas no Claude Code é sempre /.
— Alan/Pedro
Qual a diferença entre Squad Creator e Squad Curator?
Squad Creator: Ferramenta para CRIAR squads — estrutura agentes, tasks, workflows (60-70 comandos).
Squad Curator: Ferramenta que GERENCIA e ORGANIZA seus squads — mantém consistência, valida coerência entre squads.
— Pedro/Alan
Squad, Prompt e Workflow são a mesma coisa?
Não. São coisas bem diferentes. Um Squad NÃO é um Prompt (é muito mais complexo). Squad NÃO é um Workflow (Workflow é apenas um componente). Um Squad = Agentes + Tasks + Workflows + Ferramentas + Modelos de IA. Pode ter 7 agentes, 30-40 testes, múltiplos workflows — é um sistema completo.
— Alan
Como decidir o que criar como Squad? Preciso ter processo definido?
Comece com papel e caneta ao lado do computador. Toda vez que fizer tarefa repetida, marque um traço. O que tiver mais traços vira Squad primeiro. Sim, precisa ter processo. A versão nova do Squad Creator não deixa criar sem processo documentado — senão a IA inventa e mente. O Squad Creator procura os maiores especialistas do mercado e mapeia processos documentados.
— Pedro/Alan
Qual a diferença entre PM, PO e SM?
PM (Product Manager): Gestão de projetos, cria épicos, decide se é epic ou story.
PO (Product Owner): Valida stories (10-point checklist), gerencia backlog.
SM (Scrum Master): Organiza a fila de trabalho, faz o kanban, define ordem de execução.
— Pedro
Como funciona o ciclo completo Dev → QA → DevOps?
SM cria story → PO valida → Dev implementa (com self-healing, max 2 iterações) → QA faz review (QA Gate com 7 checks) → Se tem bugs, volta pro Dev com task "Apply QA Fixes" → Dev corrige → QA re-review → DevOps faz commit/push/PR → PO faz *close-story para marcar Done.
— Alan/Pedro e 02
O que é YOLO Mode? E Interactive e Pre-flight?
YOLO ("You Only Look Once"): O agente executa tudo sem parar para perguntar.
Interactive: Para no meio da execução para perguntar o que fazer.
Pre-flight: Faz todas as perguntas ANTES de começar, depois executa direto.
— Pedro
Se criei uma ferramenta pro Squad X, preciso criar de novo pro Squad Y?
Não. Quando cria um novo Squad, o sistema confere o registro de ferramentas. Se a ferramenta já existe (para outro Squad), o sistema descobre via Discovery Tools e você referencia a existente ao invés de criar uma nova. Isso garante consistência e evita duplicação.
— Alan
Qual a diferença entre CLI, API e MCP?
CLI: Instalação local na máquina, Claude Code se comunica direto (como terminal).
API: Chamada para um serviço na nuvem.
MCP: Protocolo de comunicação da IA com serviços que deixam sua API aberta — como uma caixa de ferramentas. Habilite por projeto e desative os que não usa para economizar.
— Pedro/Adriano
Design System & Storybook
Em que fase do projeto entra o Design System?
Depende do foco: se experiência do usuário é prioridade: Brainstorm → PRD → Design System → Dev. Se Data Science é prioridade: Brainstorm → PRD → Banco de Dados → Dev. Para projeto do zero (Greenfield), use *sb-install — instala Storybook + ShadCN do zero. "O que você constrói primeiro gera aderência no restante."
— Ruan/Pedro
O Storybook é usado "apenas" para visualizar componentes?
Não. Storybook é muito mais: documenta todos os componentes (fonte da verdade), testa estados/tamanhos/responsividade, verifica acessibilidade, deriva componentes faltantes automaticamente, roda testes visuais e de interação. Toda a equipe e IA consultam ali antes de criar qualquer coisa.
— Ruan Braz
Faz sentido ter um Design System padrão pra todos os projetos?
Sim, faz total sentido se você está criando produtos para si mesmo. Faz uma vez, usa para todos — é sua assinatura visual. Se presta serviço para outros, cria DS específico por cliente como parte da entrega. O Alan já tem múltiplos temas (Academia, AIOX, Vida Lendária) no mesmo Storybook.
— Ruan/Alan
Qual a diferença entre ShadCN e Vite?
São coisas completamente diferentes que podem ser usadas juntas. Vite é uma ferramenta de build/construção que cria o projeto. ShadCN/UI é uma biblioteca de componentes de interface que estiliza o projeto.
— Rafael Costa
Workflow & Desenvolvimento
Tudo roda em inglês? Posso usar português no código?
Use inglês. LLMs são treinadas com muito mais dados em inglês. Banco de dados em português tem alta chance de erro. Código em português não funciona bem. Prompts preferencialmente em inglês (exceto para usuários leigos que precisam entender a interface).
— Alan/Pedro
O que é monorepo?
"Tudo na mesma pasta." Vários sistemas compartilhando mesmo banco de dados, ambiente de staging e produção. Exemplo: Alan tem CRM + educação + formulários + comunidade tudo no mesmo projeto. Se compartilham o mesmo banco e ambiente, pode ser o mesmo PRD com enhancements. Se são serviços realmente diferentes, podem ser PRDs separados.
— José Carlos/Alan
Como informar um bug para o agente corrigir?
Tire um print, mande o print. Copie o código do erro e diga: "continua dando erro". O agente analisa o screenshot e o log. Existem comandos específicos para isso.
— Alan
Quando criar Story vs Epic vs Wave?
Quem decide é o PM. Se tem mais de 8 tasks, não cabe num Story — vira Epic. Story é chão de fábrica (time executando). Epic é gestão estratégica (objetivo final, cronograma reverso). Wave é divisão de fases dentro do Epic. Não confunda Story do AIOX com "User Stories" de produto — é story de metodologia ágil.
— Pedro/Alan
O que é Front Matter e por que é tão importante?
Front Matter é a seção no início do seu Squad onde você define: qual modelo de IA usar (Haiku, Sonnet, Opus), as permissões, qual registro de memória usar, variações de parâmetros. É o que faz cada Squad se comportar de forma única e otimizada. Sem Front Matter bem estruturado, tudo vira genérico.
— Alan
Como monetizar squads sem expor o AIOX pro cliente?
Venda a solução do problema, não o squad. Não mencione AIOX para o cliente — diga "é uma tecnologia que eu criei". Se falar AIOX, o cliente pode tentar fazer leilão ou mandar alguém interno usar. Envelopar: criar produto/serviço em cima do squad sem expor a ferramenta.
— Alan
Mentoria & Programa
Quantas sessões de mentoria eu tenho e como agendar?
6 sessões de mentoria 1:1. Sem limite semanal — agende no seu ritmo, mínimo 24h de antecedência. Acesse portal.academialendaria.ai com o login que você recebeu no privado, aceite os termos LGPD no primeiro acesso, escolha o horário e preencha a pauta (obrigatório). O link do Google Meet chega automaticamente no portal e no WhatsApp.
— Equipe CS
Quais cursos estão liberados pra mim?
Toda a grade da Academia Lendária (membros.academialendaria.ai) e todo o conteúdo do Thiago Finch (login.circle.so). Seu acesso completo já foi liberado.
— Equipe CS
Tenho uma dúvida, pergunto pra quem?
Você não está sozinho! Tem vários caminhos:

1. Tente primeiro com o AIOX/Claude — ele já conhece seu projeto e pode te ajudar na hora. Além de resolver, você vai aprendendo o caminho junto. É o melhor professor disponível 24h.
2. Dúvidas técnicas: mande pro seu mentor no grupo do WhatsApp — ele está ali pra isso.
3. Dúvidas sobre o programa: Carol e Amanda cuidam de você. Prazo de 24h para resposta.
— Comunidade/Equipe CS