Habilitación de champions y documentación interna

Módulo 8 · Metodología de entrega · Lección 5 de 7

Al terminar esta lección podrás definir el rol del champion (la persona que impulsa la adopción dentro del equipo), entregar un CLAUDE.md que valga la pena heredar y configurar un chequeo de salud que te indique si el despliegue sigue activo a los 90 días.

Cada despliegue necesita a alguien cuyo trabajo es que siga funcionando.

Definición del rol

Ser champion de Claude Code es un rol específico, no un título

Un champion nombrado, con una descripción de puesto clara, dura más que un equipo entusiasta sin responsables. La diferencia entre un despliegue que se acumula y uno que se degrada es si alguien es responsable activo de él.

Qué hace: mantenimiento y crecimiento activos. Mantiene y evoluciona los archivos CLAUDE.md a medida que cambian la base de código y las prácticas del equipo. Organiza horas de oficina semanales o un canal de equipo permanente. Incorpora a los nuevos desarrolladores. Escala los bloqueos de adopción que requieren apoyo del consultor.

Qué no hace: ser el único experto. El champion no es la mesa de ayuda de Claude Code del equipo. Su trabajo es construir la capacidad colectiva del equipo, no responder personalmente a cada pregunta. Si se convierte en el único depositario del conocimiento, el despliegue es frágil.

Qué necesita: traspaso y ruta de escalamiento documentados. Un CLAUDE.md poblado, un catálogo de comandos personalizados con al menos tres a cinco comandos y una línea directa con el consultor para los problemas que excedan su alcance. La conversación de traspaso ocurre antes del Día 30, no en él.

Qué convierte a alguien en buen candidato: influencia y motivación intrínseca. Lo bastante senior para influir en las normas del equipo. Lo bastante técnico para escribir el CLAUDE.md y evaluar comandos personalizados. Motivado de forma intrínseca, no asignado. Los mejores candidatos se identifican durante la Fase 2, al involucrarse a fondo sin que se les pida.

La inversión que se acumula

CLAUDE.md no es documentación. Es memoria institucional que Claude lee en cada sesión.

Un equipo que invierte 30 minutos a la semana en evolucionar sus archivos CLAUDE.md obtiene rendimientos compuestos. El comportamiento de Claude al inicio de cada sesión refleja la calidad de lo que el equipo ha escrito. Un CLAUDE.md genérico produce un Claude genérico. Un CLAUDE.md bien mantenido codifica las convenciones, los patrones, las herramientas preferidas y el contexto de dominio del equipo, y cada desarrollador se beneficia de cada actualización que hace otro.

A diferencia de una guía de configuración de Salesforce que duerme en Confluence hasta que alguien la necesita, el CLAUDE.md es activo: da forma al comportamiento de Claude en tiempo real. El trabajo del champion es tratarlo como un artefacto vivo, no como un entregable puntual.

La entrega del engagement debe incluir siempre tres componentes además del plan del champion:

• Un CLAUDE.md que cubra las convenciones de la empresa a nivel empresarial.
• Al menos un CLAUDE.md específico del repositorio, para el proyecto en el que trabajó la cohorte del piloto.
• Un catálogo de comandos personalizados con al menos tres a cinco comandos, documentados con frontmatter, descripciones de parámetros y ejemplos de invocación.

Estos componentes se cubren en detalle en los Cursos 4 y 5. Si el equipo del piloto no los ha construido, ese es el trabajo de la Fase 3 y de la sesión de traspaso.

flowchart LR
    A["Entrega del engagement"] --> B["Plan del champion"]
    A --> C["CLAUDE.md empresarial"]
    A --> D["CLAUDE.md del repositorio del piloto"]
    A --> E["Catálogo de comandos personalizados (mínimo 3 a 5)"]
    B --> F["Champion con traspaso y ruta de escalamiento"]
    C --> F
    D --> F
    E --> F
    F --> G["Salud del despliegue a 90 días"]

Principio de traspaso. La calidad de un despliegue 90 días después de que te vayas la determina la calidad del CLAUDE.md que entregas.

Comprueba tu comprensión

Champions y CLAUDE.md: ¿verdadero o falso?

Tres afirmaciones sobre la selección del champion y el papel del CLAUDE.md en los despliegues sostenibles. Actividad: ¿verdadero o falso? Selecciona una respuesta por afirmación.

1. “El champion debe ser el desarrollador técnicamente más avanzado del equipo.” ¿Verdadero o falso?

Ver respuesta

Respuesta: falso.

Falso. La fluidez técnica importa, pero la influencia y la motivación intrínseca importan más. El desarrollador más avanzado técnicamente puede tener flujos de trabajo inusuales que no se generalizan al equipo. El champion necesita dar forma a las normas del equipo, no solo ser bueno con la herramienta a nivel personal.

2. “El CLAUDE.md debe quedar terminado y estable antes de que termine el engagement.” ¿Verdadero o falso?

Ver respuesta

Respuesta: falso.

Falso. El CLAUDE.md es un documento vivo que debe evolucionar de forma continua a medida que se desarrollan la base de código, las prácticas del equipo y los patrones de uso de Claude. “Terminado” es el encuadre equivocado. El traspaso debe incluir un CLAUDE.md lo bastante bueno como para producir una mejora significativa de inmediato, además de un responsable claro que lo irá evolucionando.

3. “Los comandos personalizados son opcionales en el traspaso si el equipo es pequeño.” ¿Verdadero o falso?

Ver respuesta

Respuesta: falso.

Falso. Los comandos personalizados codifican las mejores prácticas del equipo con Claude Code en una forma reutilizable que sobrevive a los cambios de personal. Un equipo pequeño que no invierte en comandos en los primeros 30 días normalmente no los construye después, y pierde una de las herramientas de configuración de mayor palanca del stack. Tres a cinco comandos es un umbral bajo y debe ser innegociable en el traspaso.

Punto clave: el rol de champion exige influencia y motivación, no solo habilidad técnica. El CLAUDE.md es un artefacto vivo, no un entregable. Los comandos personalizados en el traspaso son infraestructura necesaria, no un extra.

Artefacto del curso: Delivery Plan Pack

Esta lección aporta la sección de plan de champions, el último componente del Delivery Plan Pack.

1. Nombra al candidato a champion: rol, por qué es la elección correcta (influencia, motivación, encaje técnico). Indica si se identificó durante la Fase 2 o si fue seleccionado.
2. Enumera los tres artefactos que entregarás al champion al cierre del engagement: CLAUDE.md (empresarial y a nivel de repositorio), catálogo de comandos personalizados (mínimo tres comandos) y ruta de escalamiento.
3. Escribe una frase que describa cómo medirás la efectividad del champion en la revisión a los 30 días posteriores al engagement. Nombra la métrica o señal que usarás.

Ideas clave

• El champion se define por influencia y motivación, no solo por habilidad técnica.
• El CLAUDE.md es la memoria institucional que Claude lee en cada sesión: es un artefacto vivo, no un entregable.
• El traspaso debe incluir tres componentes: el CLAUDE.md empresarial, el CLAUDE.md del repositorio del piloto y un catálogo de comandos personalizados (mínimo tres a cinco).
• La calidad del despliegue a los 90 días depende de la calidad del CLAUDE.md que se entrega.
• Un champion nombrado, con un rol documentado, un CLAUDE.md sólido y un catálogo de comandos, es lo que separa un despliegue que se acumula de uno que se degrada.

Siguiente: Modos de fallo comunes y cómo anticiparlos