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 conforme o prazo de mobilização acordado 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

Uma fábrica pode construir e sustentar o contrato de API; a alocação coloca um especialista no time que já o opera. Os dois modelos falham quando a fonte da verdade é uma pessoa, não um artefato. Em uma eventual substituição, o sucessor precisa receber o schema no handoff.

Onboarding não deve ser prometido em horas. O desenho recomendado usa o artefato versionado como fonte de verdade; contexto apenas no chat prejudica a transição.

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 que um PR de “limpeza” quebre os consumidores. A mobilização não substitui o schema no Git; uma eventual substituição também depende desse artefato no handoff. O quadro branco alinha a conversa, e o repositório preserva o contrato.

Como a Tech Coders recebe o especialista no contrato

Na fábrica de software, quem entra no projeto pode usar schema, exemplos e testes de contrato como parte do onboarding. Em uma alocação, o mesmo kit ajuda a preservar contexto; a janela de mobilização acordada não substitui o contrato técnico. Quando contratada, a sustentação precisa operar a interface documentada e registrar qualquer divergência entre o quadro e o sistema real.

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.