Quando o especialista entra no meio do jogo, o primeiro dia é ler o contrato versionado, não reconstruir o significado no WhatsApp. O quadro alinha o que já é estável e o que ainda é improviso. Sem schema, o recém-chegado herda fofoca de endpoint. Com schema, herda interface.

Comece o ano sem improviso é o princípio. Contrato para parceiro e agente é o consumidor duplo. Vantagens de fábrica incluem onboarding pelo artefato. Este texto é o meio do campeonato: time já em campo, gente nova.

O kit de onboarding de contrato

  • OpenAPI (ou equivalente) no repo, na versão que produção usa;
  • exemplo de erro real;
  • política de versão e deprecation;
  • quem aprova breaking change;
  • mock ou ambiente que o contrato descreve.

Se o kit não existe, o primeiro sprint do especialista é extraí-lo do código e do tráfego — caracterização — não “mais um campo para o front de sexta”. Alocação em cinco dias úteis só é honesta se o acesso ao repo for no dia 1; o contrato é o mapa. A cadeira pode ser alocada; o tema deste artigo continua o contrato, não o matching.

O que o especialista não deve fazer na primeira semana

Não deve quebrar o parceiro para “limpar” o JSON. Não deve criar API paralela para o agente. Não deve tratar o chat do time antigo como spec. Pode propor v2 com prazo. Pode recusar PR que muda significado sem nota.

Meio do jogo tem pressão. Pressão sem contrato é o improviso que janeiro tentou matar e julho reviveu.

Fábrica e alocação no mesmo recorte

Fábrica constrói e sustenta o contrato no sprint de 15 dias. Alocação põe o especialista no time que já opera o contrato. Os dois falham se a fonte da verdade for pessoa, não artefato. Substituição em 48h também: o sucessor lê o schema.

Não prometemos onboarding em horas. Prometemos que o artefato é o caminho. Pessoa só no chat é o anti-onboarding.

O especialista no meio do jogo também herda o agente e o parceiro no mesmo endpoint, se esse for o desenho. Ler o contrato evita o PR de “limpar o JSON” que quebra os dois na mesma semana. Cinco dias úteis de alocação não substituem o schema no Git. Substituição em 48h também lê o schema. O quadro branco alinha a conversa; o repo alinha o próximo outubro.

Como a Tech Coders recebe o especialista no contrato

Na fábrica de software, gente no meio do jogo onboarding pelo schema, exemplo e teste de contrato no sprint de 15 dias. Se a pessoa vem por alocação, o mesmo kit vale — cinco dias úteis de entrada não substituem o contrato. Sustentação 24×7 opera a interface que o quadro descreveu. Resgate começa quando o quadro mente.

Perguntas frequentes

Não há OpenAPI. Por onde o especialista começa?

Pelo tráfego e pelos consumidores. Documenta o que produção faz. Isso é o contrato de fato. Ferramenta de spec vem na sequência, não o inverso.

Posso mandar o agente gerar o spec no dia 1?

Pode rascunhar. O sênior confirma com o consumidor. Spec gerado sem tráfego mente com confiança.

Breaking change urgente no meio do jogo?

Nota de versão, prazo, comunicacão aos consumidores (parceiro e agente). Urgência não apaga os dois clientes. Campo novo opcional vence rename silencioso.

O quadro branco substitui o Git?

Substitui a conversa. Não substitui o artefato. No fim do dia o schema no repo é o que o próximo especialista vai ler em outubro.