Arquivo de contexto de IA do time

Visão geral

A maioria das pessoas usa a IA como um organograma de uma pessoa: apenas a pessoa e suas ferramentas. Cada pessoa tem seus próprios prompts, suas próprias instruções e sua própria noção sobre o que é aceitável compartilhar. O time não está na sala.

Este modelo traz o time de volta. Em uma sessão, seu time vai cocriar o TEAM.md: um arquivo de contexto compartilhado que diz às suas ferramentas de IA (Claude, ChatGPT, Copilot, Cursor) quem vocês são, como trabalham e quais proteções se aplicam.

O arquivo importa, mas a conversa importa mais. Escrever quem realmente decide o quê, e o que vocês sempre manterão humano, traz à tona desacordos que a maioria dos times nunca discutiu em voz alta. O TEAM.md é aquilo que a IA do seu time herda dessa conversa.

O que você vai levar

• Um arquivo TEAM.md cobrindo sete áreas: quem vocês são, membros do time, como vocês decidem, como se comunicam, como usam a IA, proteções de IA e principais fluxos de trabalho

• Uma linha de gatilho que indica à sua IA quando usar o TEAM.md, para que ele seja carregado quando o trabalho precisar, não em todo chat

• Um titular e um ritmo de revisão, para que o arquivo se mantenha fiel à medida que o time muda

Para quem é

Qualquer time que já use IA no dia a dia. Funciona para times técnicos e não técnicos.

Tempo

45 a 60 minutos em grupo, ou de forma assíncrona ao longo de 1 a 2 dias. Reserve mais 30 minutos depois para revisar o arquivo e incorporá-lo.

Como conduzir

Antes da sessão

• Compartilhe o link do board com todo o time.

• Peça que as pessoas leiam o prompt no cabeçalho de cada coluna antes de adicionar notas adesivas.

• Indique um titular que manterá o TEAM.md atualizado após a sessão.

Durante a sessão

Comece com o propósito: "Estamos criando um TEAM.md compartilhado que fornece às nossas ferramentas de IA o contexto de que precisam para fazer um trabalho melhor para este time." Para cada seção, o time faz brainstorming com notas adesivas. Aponte qualquer coisa ambígua ou contraditória e adicione, altere ou remova notas adesivas até que o board reflita como o time realmente trabalha.

Passo 1: Quem somos (5 min). Uma pessoa escreve 2 a 3 frases sobre as responsabilidades do time e os resultados esperados. Os demais reagem e editam com notas adesivas.

Passo 2: Membros do time (10 min). Cada pessoa adiciona sua própria nota adesiva: nome, função, pelo que sou responsável, como trabalho melhor. Seja sincero. Isso é para a IA, não uma avaliação de desempenho.

Passo 3: Como decidimos (10 min). Liste seus direitos reais de decisão, não os aspiracionais. Quem tem a palavra final sobre cada assunto? O que precisa de escalonamento e o que as pessoas podem decidir por conta própria?

Passo 4: Como nos comunicamos (5 min). Canais, tom e pontos de revisão, internos e externos. Concentre-se no que um novo integrante (ou uma IA) entenderia errado sem ser informado.

Passo 5: Como usamos IA (10 min). Duas partes: para o que o time usa ativamente a IA e o que mantém deliberadamente humano. Ambos importam.

Passo 6: Proteções de IA (10 min). Esta é a seção mais importante. Escreva cada proteção como uma regra clara começando com "Nunca" ou "Sempre". Que dados nunca devem entrar em um prompt? O que sempre precisa de aprovação humana antes de ser enviado?

Passo 7: Fluxos de trabalho principais (10 min). Nomeie seus 3 a 5 fluxos de trabalho recorrentes mais importantes, usando os nomes que o seu time realmente fala em voz alta. Para cada um, marque onde a IA ajuda e onde um humano permanece no processo. Esses nomes se tornam o gatilho que indica à sua IA quando usar TEAM.md.

Após a sessão

1. Gerar (5 min). Execute o fluxo de IA "Run Prompt" para transformar o board em um rascunho TEAM.md.

2. Revisar em conjunto (15 min). Leia em voz alta. Corrija qualquer coisa que soe aspiracional em vez de verdadeira e verifique se cada diretriz de IA está formulada claramente como "Nunca" ou "Sempre".

3. Escrever o gatilho (5 min). Concordem em uma ou duas frases sobre quando a IA do seu time deve usar TEAM.md. Por exemplo: "Use isto quando uma solicitação envolver quem é responsável por o quê, quem aprova, como nos comunicamos externamente, ou [seus fluxos de trabalho principais]." A maioria das solicitações não precisa do contexto do time. O gatilho evita que o contexto atrapalhe até que seja necessário.

4. Integrar. Exporte o documento como um arquivo .md e coloque-o em um local onde a IA do seu time possa encontrá-lo:

• Claude Code ou outras ferramentas baseadas em repositório: salve-o como uma skill no seu repositório (por exemplo .claude/skills/team-context/), usando o gatilho como descrição da skill.

• Projetos Claude ou ChatGPT: adicione TEAM.md como conhecimento do projeto e coloque seu gatilho nas instruções do projeto.

• Qualquer outra ferramenta de IA: cole o gatilho nas instruções compartilhadas ou personalizadas e anexe TEAM.md como arquivo de referência.

5. Mantenha-o atualizado. O titular mantém o TEAM.md atualizado. Revise-o trimestralmente, ou sempre que o time, suas ferramentas ou suas proteções mudarem.

Um TEAM.md que surge de problemas reais é mais útil do que um escrito de forma especulativa. Comece pelo que é verdade hoje e aperfeiçoe-o cada vez que o time enfrentar algo novo.