Brain· Mukutu

Onboarding Mukutu

Referência Perene

Onboarding Mukutu / Mukutu Onboarding

Ponteiro, não cópia. O material de onboarding já está publicado e vive em um só lugar: https://onboarding.mukutu.cloud. Esta nota diz o que existe lá e onde mexer — o conteúdo não é duplicado aqui, para não criar duas fontes de verdade.

O que é / What it is

Site interno de onboarding da Mukutu — responde o que a Mukutu faz, o que ela entrega e, principalmente, como se trabalha aqui. Existe para o novo entrante não depender de perguntar, e para quem já está não responder a mesma pergunta pela décima vez. Trilha de leitura da primeira semana, em ordem (Dia 1 → Dias 3 e 4).

  • URL: https://onboarding.mukutu.cloud — atrás de login Google (oauth2-proxy). Não é público.
  • Código: mukutu-mono/apps/onboarding (Astro + Starlight, conteúdo em MDX versionado por git).
  • Regras próprias: apps/onboarding/AGENTS.md — o único app do mono que hospeda processo interno e índice de credenciais de cliente, e cujo conteúdo não vai ao ar sem aval humano. Princípios de conteúdo em .specify/memory/constitution.md. Piso de acessibilidade: WCAG 2.2 AA.

Estrutura do conteúdo / Content map

  • geral/ — quem é a Mukutu, cultura/missão/valores, quem é quem (equipe e a quem recorrer), serviços, como trabalhamos.
  • projetos/ — o processo por tipo de projeto, que é a bifurcação central da trilha: manutenção (processos de sites, relatórios, SLA), pontual (processo e etapas, templates de e-mail) e squad dedicado.
  • transversal/ — acessos, ferramentas, skills e “como manter este site”.

A leitura depende da alocação

A trilha manda o entrante parar no Dia 2 e perguntar ao GP em qual tipo de projeto foi alocado — a resposta muda qual página de processo ele lê primeiro. É a diferença entre ler o processo certo e o errado.

Cada página tem dono e data de revisão / Ownership

O frontmatter de cada MDX carrega dono e revisar_em (ex.: index.mdx → dono Ana Júlia, revisar em 29/01/2027). Conteúdo de processo sem dono nem prazo de revisão apodrece — aqui isso é campo obrigatório, não convenção.

Como atualizar / How to update

Editar o MDX em apps/onboarding/src/content/docs/, rodar os scripts de verificação do app (scripts/checar-links.mjs, checar-tema.mjs, varrer-segredos.mjs) e abrir PR. Build com corepack pnpm --filter @mukutu/onboarding build (o pnpm não está no PATH da máquina da Ana). A publicação passa por aval humano — ver AGENTS.md do app.

Por que importa para a Nova Mukutu / Why it matters

  • É o processo escrito da empresa em forma consultável — a contraparte “para pessoas” do que Governança Mukutu descreve para projetos.
  • O brain (este vault) guarda método e decisão; o onboarding guarda o processo vigente que o time segue. Fronteira explícita para evitar sobreposição.

Relacionado / Related

Fontes / Sources