Conteúdo detalhado
🧩 O que o /onboard faz
O /onboard é um wizard combinado: lê e escreve o aios-intake.md, conduz a entrevista de 7 perguntas e scaffolda o file-set completo do Dia 1 ao final. É a primeira ação que você executa após clonar o repositório AIS-OS.
🎯 O que o wizard entrega
- •Conduz as 7 perguntas com cap rígido — cada resposta em menos de 60 segundos
- •Gera todos os arquivos de contexto do Dia 1 em uma única rodada
- •Faz backup automático de tudo que existia antes de sobrescrever
- •Termina com o "wow moment" — a primeira resposta real do seu AIOS
✓ O que esperar
- ✓Sessão única de ~35 minutos do zero ao contexto vivo
- ✓Perguntas diretas, sem enrolação — cada uma com propósito claro
- ✓File-set idempotente — pode rodar de novo sem destruir o que existe
✗ O que NÃO é
- ✗Não é configuração de .env ou chaves de API (isso é Dia 2)
- ✗Não gera skills extras — apenas o file-set base
- ✗Não passa de 7 perguntas — nunca vai mais fundo no primeiro run
💡 Dica Prática
Antes de rodar o /onboard, abra os arquivos de voz que você quer colar em Q2. E-mails, posts, transcrições — qualquer texto que você escreveu sem pensar em "soar bem". A qualidade do references/voice.md determina se o AIOS vai soar como você ou como um robô.
❓ As 7 perguntas (cap rígido)
O /onboard conduz exatamente 7 perguntas, cada uma com propósito específico nos 4 Cs. O cap é rígido: nenhuma pergunta 8 no primeiro run. Cada resposta deve tomar menos de 60 segundos — se estiver levando mais, você está pensando demais.
Quem você é / O que vende / Para quem
Alimenta: context/about-me.md + about-business.md
Identidade, oferta principal, ICP e modelo de receita. Fatos concretos, não pitch de vendas.
Amostras de voz (a regra que não dobra)
Alimenta: references/voice.md
Cole textos que você escreveu naturalmente. E-mails, posts, comentários. Nunca digitados no chat durante a conversa.
Prioridades dos próximos 90 dias
Alimenta: context/priorities.md
3 a 5 objetivos concretos. "Lançar produto X", "reduzir churn em Y%". O wow moment usa isso diretamente.
Onde a receita cai
Alimenta: connections.md linha Financeiro
Stripe, PagSeguro, planilha, ERP — qual sistema registra pagamentos. Define o Domínio Tier-1 mais crítico.
Onde fala com clientes e time
Alimenta: connections.md linhas Comunicação + Clientes
WhatsApp, Slack, e-mail, Discord — quem fala onde. Cria o mapa inicial de Connections.
Onde moram reuniões e docs
Alimenta: connections.md linhas Calendário + Conhecimento
Google Calendar, Notion, Obsidian, Confluence — onde está o conhecimento registrado e o tempo organizado.
A tarefa que come a semana
Alimenta: context/priorities.md + semente do /level-up
A coisa chata, manual e repetitiva que você mais faz. Não precisa ser "automatizável" — apenas honesta. É o primeiro candidato do /level-up.
⏱️ Cap de 60 segundos
Se uma resposta está levando mais de 60 segundos, você está racionalizando demais. O /onboard quer os fatos do topo da cabeça — não o pitch perfeito. Você pode editar aios-intake.md depois e re-rodar.
🎤 A regra da voz (Q2)
Q2 é a única regra que não dobra em hipótese alguma. As amostras de voz precisam ser coladas verbatim de textos que você escreveu antes desta conversa. Nunca digitadas durante a sessão do /onboard.
⚠️ Por que isso importa
Quando você digita durante uma conversa com o Claude, o texto já está sendo moldado pelo contexto da conversa — pelo tom do modelo, pelas perguntas que acabou de responder, pelo formato esperado. O resultado não é sua voz: é sua voz filtrada pelo modelo.
"Se você digita aqui enquanto conversamos, a amostra já está moldada pela conversa." O /onboard tem instrução para recusar amostras que claramente foram digitadas no momento.
✓ Fontes válidas para Q2
- ✓E-mails que você escreveu para clientes (sem revisar para parecer "melhor")
- ✓Posts em redes sociais dos últimos 6 meses
- ✓Mensagens de WhatsApp ou Slack para o time
- ✓Comentários em documentos ou notas pessoais
✗ Fontes inválidas para Q2
- ✗Texto escrito agora, durante a sessão do /onboard
- ✗Textos revisados por IA antes de colar
- ✗"Resumo do meu jeito de escrever" que você compôs agora
- ✗Copy de site ou bio LinkedIn polida por agência
💡 Quanto colar
2 a 4 amostras de contextos diferentes (e-mail, post, mensagem informal) são suficientes. Volume não é qualidade — o modelo precisa ver variação de contexto, não repetição do mesmo registro.
📁 Scaffold do Dia 1
Ao final das 7 perguntas, o /onboard scaffolda o file-set completo. Não é um template vazio — cada arquivo já contém as respostas processadas da entrevista, prontas para uso imediato em uma nova sessão Claude.
🗂️ O que cada arquivo faz
- about-me.md: Quem você é, qual o seu papel, qual a sua principal dor. Interpretado — não um currículo.
- about-business.md: O que o negócio faz, quem é o cliente ideal, como a receita entra. Fatos, não pitch.
- priorities.md: Os 3–5 objetivos dos próximos 90 dias, mais a tarefa que come a semana (semente do /level-up).
- voice.md: As amostras verbatim de Q2. O modelo lê isso antes de qualquer output voltado para fora.
- connections.md: Tabela com os 7 domínios Tier-1 preenchida com o que você usa. Vazia onde não há ferramenta ainda.
💡 Backup automático
O /onboard faz backup de qualquer arquivo existente em archives/intake-{timestamp}/ antes de sobrescrever. Você nunca perde o que havia antes — pode comparar versões ou reverter.
✨ O "wow moment"
O prompt de fechamento do /onboard é desenhado para plantar o Default Shift imediatamente. Após gerar os arquivos, o wizard instrui você a fazer a primeira pergunta real ao seu AIOS recém-configurado.
← instrução ao usuário após o scaffold
"Agora abra uma nova sessão Claude e pergunte:
'No que devo focar essa semana?'
A resposta deve usar apenas os arquivos de contexto que acabamos de criar, apresentar 3 bullets na sua voz, cada um amarrado a uma prioridade do priorities.md."
🧠 Por que isso é o wow moment
A resposta usa só os arquivos que você acabou de criar — sem contexto de conversa, sem memória de sessão. É o AIOS respondendo do zero, com base no que você escreveu sobre si mesmo.
Quando os bullets soam como você e estão alinhados ao que você definiu como prioritário, o Default Shift acontece: você para de achar que IA é uma ferramenta de busca e começa a tratar como um sistema operacional.
- •Se a resposta está genérica → o voice.md precisa de mais amostras verbatim
- •Se a resposta está fora do foco → o priorities.md precisa de objetivos mais concretos
- •Se a resposta está perfeita → você acabou de configurar um AIOS funcional
Resposta boa parece com...
"Esta semana o foco é finalizar o onboarding do cliente X, já que isso representa a maior receita em risco antes do fim do trimestre..." (no seu tom, com contexto real)
Resposta ruim parece com...
"Para ter sucesso esta semana, você deve se concentrar em tarefas de alto impacto e gerenciar seu tempo com eficiência..." (genérico — reabasteça o voice.md)
🔄 Idempotência + re-run
O /onboard é idempotente: rodar de novo não destrói o que existe. Edite o aios-intake.md com as respostas que quer atualizar e rode novamente — o wizard atualiza apenas os arquivos afetados.
Edite o aios-intake.md
Abra o arquivo, encontre a resposta que quer atualizar, edite diretamente. As respostas originais ficam comentadas para referência.
Rode /onboard novamente
O wizard detecta o aios-intake.md existente, pula perguntas já respondidas e foca só nas que foram modificadas.
Backup automático antes de sobrescrever
Antes de atualizar qualquer arquivo, o /onboard cria um novo backup em archives/intake-{timestamp}/. Você sempre pode reverter.
📊 Quando re-rodar
- •Prioridades mudaram: novo trimestre, novo objetivo, pivô do negócio
- •Voz insatisfatória: o AIOS não está soando como você — mais amostras Q2
- •Novos sistemas conectados: atualize Q4/Q5/Q6 para refletir no connections.md
- •Onboarding de outra pessoa: clone e rode /onboard no novo projeto dela
💡 Revisão trimestral
O CLAUDE.md recomenda revisão trimestral. Use o /onboard como o mecanismo oficial de atualização — não edite os arquivos de contexto diretamente ad-hoc. Manter o aios-intake.md como fonte de verdade evita divergências entre arquivos.
🚫 O que o /onboard NÃO faz
Tão importante quanto saber o que o /onboard faz é saber o que ele não faz. Estas limitações são intencionais — não são bugs nem lacunas a corrigir.
✗ Limitações intencionais
- ✗Não passa de 7 perguntas: profundidade vem com o tempo, não no Dia 1
- ✗Não configura .env: chaves de API e credenciais ficam para o Dia 2
- ✗Não gera skills extras: apenas o file-set base — skills vêm do /level-up
- ✗Não escreve no 3ms-framework.md: documentação do framework é read-only
✓ O que vem depois
- ✓Dia 2: configure as conexões — MCPs, scripts, chaves de API
- ✓Dia 7: rode /audit para ver o score dos 4 Cs
- ✓Toda sexta: /level-up — uma automação por semana
- ✓A cada novo uso: edite aios-intake.md e re-rode para manter atualizado
🗺️ Cadência recomendada do kit
💡 A filosofia do Dia 1
O /onboard foi desenhado para que nenhuma pergunta seja bloqueante. Se você não sabe a resposta de Q4 agora, cole "Stripe — não integrado ainda" e siga. Um AIOS com 80% do contexto correto hoje vale mais do que um com 100% em duas semanas.
🚀 Resumo do Módulo
Próximo Módulo:
3.2 — /audit: Diagnóstico Four-Cs · "Veja o placar subir" · O score honesto que mostra onde o AIOS está forte e onde está thin.