onboard

Visão geral do skill onboard

O que o onboard faz

onboard é um skill de Knowledge Capture para o sistema c-level-agents. Ele conduz uma entrevista estruturada com o fundador por meio de /cs:onboard e transforma as respostas em ~/.claude/company-context.md, o arquivo compartilhado de contexto da empresa usado pelos advisors virtuais de C-level antes de fazerem recomendações.

Isso não é um checklist genérico de onboarding. O skill onboard foi criado para capturar fatos de negócio duradouros: estágio da empresa, número de pessoas, geografia, modelo de negócio, ICP, ACV, crescimento, funding, runway, metas estratégicas, restrições e contexto operacional. A função real dele é impedir que os agentes advisors tenham que adivinhar.

Melhor encaixe para o skill onboard

Use onboard quando estiver configurando c-level-agents para uma empresa, atualizando o contexto depois de uma mudança importante ou se preparando para fluxos com advisors, como /cs:boardroom, /cs:brief ou orientações executivas específicas por função.

Ele é especialmente útil para founders, chiefs of staff, operadores de startups e advisors que precisam que agentes de IA raciocinem a partir da mesma fonte da verdade. Se o contexto da sua empresa está espalhado entre pitch decks, notas de CRM, updates para investidores e memória das pessoas, onboard oferece uma primeira captura prática e organizada.

O que diferencia de um prompt comum

Um prompt comum pode pedir “aprenda sobre minha empresa”, mas normalmente deixa categorias importantes de fora ou registra as informações de forma inconsistente. O skill onboard usa um schema canônico de 7 dimensões e uma entrevista de 12 perguntas; depois grava o resultado em um caminho de arquivo previsível, lido pelo restante do ecossistema de advisors cs-*.

Esse handoff baseado em arquivo é o principal diferencial: onboard é valioso porque cria contexto reutilizável, não apenas uma transcrição de chat para uso único.

Como usar o skill onboard

Instalação do onboard e primeiros arquivos para inspecionar

Instale com a skills CLI:

npx skills add alirezarezvani/claude-skills --skill onboard

O código-fonte fica em c-level-advisor/c-level-agents/skills/onboard. Comece lendo SKILL.md; este skill tem uma estrutura de repositório compacta e não depende de scripts, referências ou pastas de recursos extras. O detalhe de implementação mais importante é o arquivo de saída esperado: ~/.claude/company-context.md.

Depois da instalação, invoque o comando como /cs:onboard no ambiente em que seus Claude skills estiverem disponíveis. Rode-o antes dos outros comandos de advisors C-level para que eles possam ler o contexto da empresa em vez de depender de suposições genéricas.

Entradas de que o skill onboard precisa

Prepare dados factuais antes de começar. A entrevista cobre fundamentos da empresa, modelo de negócio, perfil de clientes, crescimento e restrições operacionais; portanto, respostas fracas ou vagas vão enfraquecer todos os advisors usados depois.

Notas úteis de preparação incluem:

• Nome da empresa e pitch de uma frase
• Estágio, headcount total e headcount por função
• Sede, divisão entre remoto e presencial, e países importantes para a operação
• Modelo de receita: SaaS, uso, transação, marketplace, hardware, serviços ou híbrido
• ICP, incluindo um cliente real e por que ele representa o segmento
• Faixa de ACV, ACV mediano e volume recente de deals
• Crescimento de ARR ou, para empresas pré-receita, a principal métrica antecedente
• Status de funding, runway, expectativas de board/investidores e prioridades estratégicas atuais

Se você não souber um número, diga isso diretamente. Um desconhecido marcado é melhor do que um palpite confiante, porque trabalhos futuros com advisors podem pedir o dado que está faltando.

Transformando um objetivo vago em um bom prompt para onboard

Um prompt fraco seria: “Help onboard my startup.”

Um uso mais forte do onboard seria:

“Run /cs:onboard for a seed-stage B2B SaaS company. Ask me the founder interview questions one at a time. If my answer is vague, ask a follow-up before writing ~/.claude/company-context.md. Preserve unknowns instead of inventing numbers. Make the final context useful for /cs:boardroom and role-specific cs advisors.”

Isso melhora a saída porque informa ao skill o estágio da empresa, o estilo de entrevista desejado, a tolerância à incerteza, o arquivo de destino e o caso de uso posterior.

Fluxo prático para obter melhores resultados

Rode onboard em três passagens. Primeiro, complete a entrevista sem editar demais. Segundo, revise ~/.claude/company-context.md em busca de falsa precisão, números desatualizados ou restrições ausentes. Terceiro, faça um follow-up pedindo ao agente que identifique “lacunas de contexto que causariam recomendações executivas ruins”.

Rode onboard novamente depois de uma rodada de captação, pivot relevante, novo ICP, mudança de pricing, aquisição, troca de liderança ou alteração significativa na taxa de crescimento. Esses são os momentos em que um contexto antigo da empresa passa a ser ativamente prejudicial.

FAQ do skill onboard

O onboard é só para founders?

Não. O skill onboard foi escrito como uma entrevista com o founder, mas um chief of staff, operador, advisor ou membro do time fundador pode usá-lo se conhecer a empresa bem o suficiente para responder às perguntas centrais. Para melhores resultados, a pessoa que executar o fluxo deve entender tanto os números quanto os tradeoffs estratégicos.

Quando eu não devo usar onboard?

Não use onboard como substituto de uma data room completa, exportação de CRM, modelo financeiro ou board memo. Ele captura contexto operacional duradouro, não cada detalhe em nível de transação. Também não é uma boa opção se você só precisa de um brainstorming pontual e não pretende usar o fluxo mais amplo de c-level-agents.

Se você não puder compartilhar dados sensíveis de negócio no seu ambiente de IA, redija ou generalize as entradas antes de rodar o skill.

Como o onboard ajuda em Knowledge Capture?

Para Knowledge Capture, onboard cria um artefato estável de contexto da empresa, em vez de deixar fatos importantes presos no histórico da conversa. Isso importa porque os agentes advisors podem voltar ao mesmo arquivo e manter consistência em discussões de estratégia, finanças, produto, GTM e operação.

O melhor uso não é “guardar tudo”. O melhor uso é “guardar os fatos que o raciocínio executivo futuro não deveria precisar redescobrir”.

O onboard é amigável para iniciantes?

Sim, se você conseguir responder às perguntas da entrevista. O skill fornece a estrutura, então você não precisa criar seu próprio schema de contexto da empresa. Iniciantes devem avançar com calma, responder com faixas quando números exatos não estiverem disponíveis e evitar que o modelo preencha lacunas com estereótipos sobre startups.

Como melhorar o skill onboard

Melhore as entradas do onboard antes de rodar advisors

A qualidade do onboard determina a qualidade das orientações C-level posteriores. Antes de usar /cs:boardroom ou outros advisors, fortaleça o arquivo de contexto com números específicos, exemplos de clientes nomeados, restrições reais e prioridades estratégicas atuais.

Troque “vendemos para empresas enterprise” por “vendemos software de workflow de compliance para provedores de saúde nos EUA; o melhor encaixe são sistemas com 500 a 5.000 funcionários e times internos de legal operations.” A especificidade muda o tipo de recomendação que os agentes conseguem dar.

Fique atento aos modos de falha mais comuns

Os maiores modos de falha são métricas desatualizadas, precisão inventada, ICP amplo demais e restrições ausentes. Se o contexto diz “enterprise SaaS”, mas omite duração do ciclo de vendas, comprador, ACV, carga de implementação e risco de churn, os advisors podem recomendar estratégias que parecem plausíveis, mas não se encaixam.

Outro problema comum é tratar aspirações como fatos. Separe “ICP atual” de “ICP futuro desejado”, e separe “ARR hoje” de “ARR alvo”.

Itere depois da primeira saída

Depois que o primeiro ~/.claude/company-context.md for gerado, pergunte:

• “What assumptions in this context are most likely to mislead a CFO, CMO, or COO advisor?”
• “Which answers are too vague to support board-level recommendations?”
• “What follow-up questions would improve the 7-dimension company context?”
• “Rewrite the context to distinguish facts, estimates, and unknowns.”

Isso transforma onboard de um formulário pontual em um ciclo prático de melhoria da qualidade do contexto.

Mantenha o onboard atualizado

Melhore onboard tornando a atualização de contexto parte da operação da empresa. Revise o arquivo mensalmente em empresas early-stage, trimestralmente em empresas mais maduras e imediatamente após mudanças importantes de financiamento, reestruturação, pricing, mercado ou produto.

O skill é mais valioso quando company-context.md reflete a empresa que os líderes estão realmente operando hoje, não a empresa descrita no deck do trimestre passado.