01 Qué hace el comando
/team-onboarding es un comando integrado de Claude Code. Al ejecutarlo, Claude revisa tus sesiones, los comandos que has usado y los servidores MCP con los que has trabajado en los últimos 30 días, y redacta una guía en Markdown. La persona que la recibe la pega como primer mensaje en su propia sesión de Claude Code y el asistente le ayuda a dejar el entorno igual que el tuyo.
La diferencia con documentar a mano es que parte de lo que usas de verdad, no de lo que tienes instalado. Si un MCP lleva dos meses sin usarse, probablemente no aparezca; si cada día lanzas /plan antes de tocar código, quedará reflejado.
/team-onboarding02 Prepara el terreno antes de ejecutarlo
La guía será tan buena como la información de la que parte. Dedica diez minutos a ordenar tu entorno y te ahorrarás mucho trabajo de limpieza después.
-
1
Actualiza el CLAUDE.md del proyecto
Es la fuente principal de convenciones. Si no existe o está anticuado, ejecuta /init o pide a Claude que lo revise con lo que ha cambiado en el equipo.
-
2
Revisa la memoria con /memory
Separa lo que es preferencia personal de lo que es norma del proyecto. Lo personal no debería acabar en la guía.
-
3
Ordena los MCP con /mcp
Desactiva los servidores que solo estabas probando para que no aparezcan como herramienta del equipo.
-
4
Repasa skills y subagentes
Con /skills ves cuáles están disponibles y su visibilidad. Los subagentes del proyecto viven en .claude/agents/.
-
5
Ejecuta /team-onboarding en el repositorio correcto
Hazlo en el proyecto donde trabaja el equipo, no en una carpeta personal de pruebas.
03 Qué suele contener la guía
Pasos previos
Qué instalar, en qué cuentas autenticarse y qué servidores MCP conectar antes de empezar.
Contexto del proyecto
Para qué sirve el repositorio y cómo trabaja el equipo, extraído sobre todo del CLAUDE.md.
Comandos habituales
Los que más usas, con ejemplos de cuándo recurrir a cada uno.
Herramientas conectadas
Los MCP con los que trabajas y para qué sirven en el día a día.
Convenciones
Estilo de código, ramas, mensajes de commit y cosas que no se deben hacer.
04 Pule el resultado con estos prompts
El documento sale en bruto: mezcla hábitos tuyos con normas compartidas y da por sabidas cosas que una persona nueva desconoce. Pégalo en Claude junto con alguno de estos prompts.
Te paso la guía que ha generado /team-onboarding. Quiero enviársela a una persona que se incorpora al equipo.
Clasifica cada apartado en tres grupos: preferencias mías que no aportan a otros, normas o herramientas del equipo que debe conocer, y tareas que tendrá que hacer antes de empezar.
Devuélveme una versión limpia que elimine lo personal, explique siglas y nombres internos que no se entiendan desde fuera, y coloque al principio un apartado «Antes de empezar» con las tareas pendientes en orden.Reescribe esta guía para [perfil: desarrollador junior / desarrollador senior / gestor de proyecto / diseñador / colaborador externo].
Ajusta el nivel técnico y el vocabulario a ese perfil, añade un glosario breve si hace falta y marca con claridad qué partes no aplican a su rol. Mantén la estructura original y no inventes herramientas ni procesos que no aparezcan en el documento.Esta guía se ha generado a partir de mi uso de Claude Code en los últimos 30 días, así que solo refleja lo que yo he hecho. Hazme preguntas para descubrir lo que falta: procesos que se ejecutan poco (despliegues, cierres de mes), decisiones de arquitectura, errores que el equipo ya ha aprendido a evitar y quién decide qué.
Cuando te responda, propón los bloques que debería añadir y redáctalos con el mismo tono que el resto del documento.Resume esta guía en una versión que se lea en cinco minutos: un párrafo de contexto, una lista de cinco a siete tareas para dejar el entorno listo hoy y un apartado final con lo que puede leer más adelante. Deja fuera todo lo opcional.05 Revisión de privacidad antes de enviarla
El comando no filtra información sensible: resume lo que ha visto. Repasa el documento antes de compartirlo, especialmente si va a alguien de fuera de la empresa.
- ✓No hay claves de API, tokens, contraseñas ni valores de variables de entorno.
- ✓Las rutas absolutas de tu ordenador se han sustituido por rutas relativas al repositorio.
- ✓No aparecen nombres de clientes, correos ni datos personales que el destinatario no deba ver.
- ✓Los MCP conectados a datos de producción indican qué permisos hacen falta y quién los concede.
- ✓Los enlaces a herramientas internas son accesibles para el destinatario o se han eliminado.
06 Límites y otros usos útiles
| Lo que no recoge | Cómo cubrirlo |
|---|---|
| Herramientas que no has usado en 30 días | Revisa el .mcp.json y la carpeta .claude/ del proyecto y añádelas a mano |
| El porqué de las decisiones | Documéntalo en el CLAUDE.md o en registros de decisiones de arquitectura |
| La parte humana: quién decide qué, canales, reuniones | Una llamada de bienvenida breve centrada en lo que el documento no explica |
| Contradicciones entre lo escrito y lo que haces | Corrígelas en el CLAUDE.md antes de volver a generar la guía |
Traspaso de proyectos
Antes de dejar un proyecto, genera la guía para que quien lo herede sepa cómo lo trabajabas.
Foto periódica
Ejecutarlo cada mes te deja un histórico de cómo evoluciona la forma de trabajar del equipo.
Alinear al equipo
Si dos personas generan su guía y las comparas, lo común es estándar y lo distinto es algo que decidir.
Preguntas frecuentes
Escribe / en Claude Code y filtra por team. Si no aparece, actualiza Claude Code; con /release-notes puedes ver los cambios de cada versión.
No. Genera un texto que resume tu forma de trabajar. La persona que lo recibe tendrá que instalar y autenticar sus propias herramientas siguiendo las instrucciones.
La guía será pobre. Trabaja unos días con el flujo habitual del proyecto o completa el documento a mano con lo que falte.
Ahorra la parte mecánica de configurar el entorno, pero el contexto, las decisiones y la relación con el equipo siguen necesitando una conversación.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.