Onboarding dia 1: como o CliAI substitui "pergunta pro sênior no Slack"

A primeira semana num emprego novo é um fluxo constante de perguntas pequenas e levemente vergonhosas. Como faço tail de logs neste stack? Qual é a convenção pra conectar no banco de staging? Onde olho quando um deploy falha? Todo sênior se lembra de ter estado do lado de quem pergunta, e se lembra de responder essas mesmas coisas cinco anos depois. O custo é real dos dois lados: a pessoa nova se sente lenta; o sênior perde meia hora por dia em context-switch.

O CliAI não substitui mentoria. Achata o volume de perguntas que dão pra se auto-servir pra quase zero.

Cenário real da primeira semana

Uma engenheira nova entra no time de backend. Produção é Kubernetes, staging é um cluster menor, observabilidade vai por Loki e Prometheus. Até quarta ela precisa debugar um teste flaky que só falha no staging.

Pergunta 1: "Onde estão os logs?"

$ clai stream dos logs do deployment api em staging, última hora, só erros→ kubectl -n staging logs -l app=api --tail=-1 --since=1h \    | grep -i error

O comando mostra a estrutura: onde fica o namespace, a convenção de label-selector, o flag de janela temporal. Numa semana rodando comandos parecidos, ela absorve o "sabor" do kubectl do time sem ninguém explicar.

Pergunta 2: "Como entro no banco de staging?"

$ clai port-forward do postgres de staging pro 5432 local→ kubectl -n staging port-forward svc/postgres 5432:5432

Ela aprende a gente não ssh-a pods, a gente port-forwarda services. Uma norma do time que o CliAI deixou aparente naturalmente.

Pergunta 3: "Por que o último deploy falhou?"

$ clai eventos do deployment api em staging nos últimos 30 minutos→ kubectl -n staging get events --sort-by=.lastTimestamp \    | grep api | tail -20

Por que isso ganha do runbook

Runbook é estático. O stack do time drifta: alguém migra de Loki pra OpenSearch, alguém muda a convenção de namespace, alguém adiciona um sidecar Istio que pede outro flag de exec. O runbook envelhece. O CliAI gera contra a pergunta, não contra uma foto congelada.

O que o CliAI não faz é explicar por quê. Ele dá o kubectl certo; não diz pra pessoa nova que staging é o único ambiente onde o caminho de auth legado está ativo e por isso o teste é flaky. Essa conversa continua sendo do sênior.

Veja também

• Refinar comandos — onboarding é exatamente quando a primeira resposta nem sempre fecha.
• Documentação — referência completa pra quando a curiosidade alcançar.