El archivo de contexto de IA del equipo

Vista general

La mayoría usa la IA como un organigrama de una sola persona: solo esa persona y sus herramientas. Cada quien tiene sus propias instrucciones, sus propias pautas y su propia idea de lo que está bien compartir. El equipo no está presente.

Esta plantilla lo trae de vuelta. En una sola sesión, tu equipo co-crea TEAM.md: un archivo de contexto compartido que le dice a tus herramientas de IA (Claude, ChatGPT, Copilot, Cursor) quiénes son, cómo trabajan y qué barreras de protección se aplican.

El archivo importa, pero la conversación importa más. Escribir quién decide realmente qué, y qué siempre mantendrán los humanos, hace aflorar desacuerdos que la mayoría de los equipos nunca ha expresado en voz alta. TEAM.md es lo que la IA de tu equipo hereda de esa conversación.

Lo que obtendrás

• Un archivo TEAM.md que cubre siete áreas: quiénes son, miembros del equipo, cómo deciden, cómo se comunican, cómo usan la IA, barreras de protección de la IA y flujos de trabajo clave

• Una línea de activación que le dice a tu IA cuándo usar TEAM.md, para que se cargue cuando el trabajo lo requiera, no en cada chat

• Un propietario y un ritmo de revisión, para que el archivo se mantenga vigente a medida que el equipo cambia

Para quién es

Cualquier equipo que ya use IA en su trabajo diario. Funciona tanto para equipos técnicos como no técnicos.

Tiempo

45 a 60 minutos como grupo, o de forma asíncrona en 1 a 2 días. Reserva otros 30 minutos después para revisar el archivo e integrarlo.

Cómo llevarla a cabo

Antes de la sesión

• Comparte el enlace del tablero con todo el equipo.

• Pide a las personas que lean la instrucción en el encabezado de cada columna antes de añadir notas adhesivas.

• Nombra a un propietario que mantenga TEAM.md actualizado después de la sesión.

Durante la sesión

Comienza con el propósito: "Estamos creando un TEAM.md compartido que brinda a nuestras herramientas de IA el contexto que necesitan para hacer un mejor trabajo para este equipo." Para cada sección, el equipo hace una lluvia de ideas con notas adhesivas. Señala todo lo que sea ambiguo o contradictorio, y añade, cambia o elimina notas adhesivas hasta que el tablero refleje cómo trabajan en realidad.

Paso 1: Quiénes somos (5 min). Una persona redacta 2 a 3 frases sobre qué es responsabilidad del equipo y los resultados que debe entregar. El resto reacciona y edita con notas adhesivas.

Paso 2: Miembros del equipo (10 min). Cada persona añade su propia nota adhesiva: nombre, rol, de qué soy responsable, cómo trabajo mejor. Sé honesto. Esto es para la IA, no una evaluación de desempeño.

Paso 3: Cómo decidimos (10 min). Enumera tus derechos reales de decisión, no los aspiracionales. ¿Quién tiene la decisión final sobre qué? ¿Qué necesita escalación y qué pueden decidir las personas por su cuenta?

Paso 4: Cómo nos comunicamos (5 min). Canales, tono y puntos de revisión, internos y externos. Enfócate en lo que un nuevo integrante (o una IA) entendería mal sin que se lo digas.

Paso 5: Cómo usamos la IA (10 min). Dos partes: para qué usas activamente la IA y qué mantienes deliberadamente humano. Ambos importan.

Paso 6: Barreras de protección de la IA (10 min). Esta es la sección más importante. Escribe cada barrera de protección como una regla clara que empiece con "Nunca" o "Siempre". ¿Qué datos nunca deben incluirse en una instrucción? ¿Qué siempre necesita la aprobación humana antes de enviarse?

Paso 7: Flujos de trabajo clave (10 min). Nombra tus 3 a 5 flujos de trabajo recurrentes más importantes, usando los nombres que tu equipo realmente dice en voz alta. Para cada uno, marca dónde ayuda la IA y dónde permanece un humano en el proceso. Estos nombres se convierten en el disparador que le indica a tu IA cuándo usar TEAM.md.

Después de la sesión

1. Generar (5 min). Ejecuta el flujo de IA "Run Prompt" para convertir el tablero en un borrador de TEAM.md.

2. Revisar juntos (15 min). Léanlo en voz alta. Corrijan todo lo que suene aspiracional en lugar de verdadero y verifiquen que cada regla esté formulada claramente empezando por "Nunca" o "Siempre".

3. Escribir el disparador (5 min). Acuerden una o dos frases sobre cuándo la IA de su equipo debe usar TEAM.md. Por ejemplo: "Usen esto cuando una solicitud implique quién es responsable de qué, quién da la aprobación, cómo nos comunicamos externamente, o [sus flujos de trabajo clave]." La mayoría de las solicitudes no necesitan el contexto del equipo. El disparador evita que se use hasta que sea necesario.

4. Integrarlo. Exporten el documento como archivo .md y colóquenlo donde la IA de su equipo pueda encontrarlo:

• Claude Code u otras herramientas basadas en repositorios: guárdalo como una skill en tu repositorio (por ejemplo .claude/skills/team-context/), con tu trigger como descripción de la skill.

• Proyectos de Claude o ChatGPT: agrega TEAM.md como conocimiento del proyecto y coloca tu trigger en las instrucciones del proyecto.

• Cualquier otra herramienta de IA: pega el trigger en sus instrucciones compartidas o personalizadas y adjunta TEAM.md como archivo de referencia.

5. Manténlo actualizado. El propietario mantiene TEAM.md actualizado. Revísalo trimestralmente o cada vez que el equipo, sus herramientas o sus barreras de protección cambien.

Un TEAM.md que surge de problemas reales es más útil que uno escrito de forma especulativa. Empieza con lo que es cierto hoy y ve afinándolo cada vez que el equipo se enfrente a algo nuevo.