Los manuales están en **Contratación → Manuales**, en [/hiring/playbooks](/hiring/playbooks). Un manual es un grupo con nombre de **recursos**: documentos en Markdown escritos dentro de Kit y enlaces a material que vive en otro sitio.

**Nada de un manual se muestra nunca a los candidatos.** Es de uso interno del equipo: el portal de empleo, el portal del candidato y los correos de candidatura no leen de ahí.

El manual de un equipo de ingeniería podría contener:

| Recurso | Tipo |
|---|---|
| Vídeo de presentación de la empresa | Enlace (YouTube — se reproduce integrado) |
| Cómo hacemos la llamada inicial | Documento |
| Lista de comprobación de revisión de código — backend | Documento |
| Banco de preguntas de encaje cultural | Documento |
| Logística de la jornada presencial (Google Doc) | Enlace |

## Quién puede hacer qué

| | Leer | Crear, editar, eliminar, reordenar |
|---|---|---|
| **Miembro** de Contratación | Sí | No |
| **Admin** de Contratación | Sí | Sí |

Los niveles son por módulo: un admin de Contratación que solo sea miembro en Outreach conserva aquí el acceso de escritura completo. Consulta [Roles del equipo](/docs/team-roles).

## Documentos y enlaces

Un **documento** es Markdown que escribes en Kit. El editor tiene un selector **Escribir / Vista previa**; se renderizan encabezados, tablas, listas de tareas, tachado y URLs sueltas. El HTML sin procesar se descarta, no se escapa. El contenido tiene un tope de 100 000 caracteres.

Un **enlace** es una URL a algo que ya guardas en otro sitio. Pulsa **Obtener vista previa** y los enlaces de YouTube, Vimeo y Loom obtienen un reproductor integrado; el resto se guarda como enlace simple, que es lo habitual con documentos y wikis. No hay subida de archivos: deja el archivo donde ya está y enlázalo.

> [!WARNING]
> **El tipo de un recurso queda fijado al guardarlo.** Un documento no puede convertirse después en un enlace, ni al revés: cambiarlo dejaría huérfanos el contenido y todas sus versiones. Para cambiar de tipo, crea un recurso nuevo y elimina el antiguo.

Los administradores pueden arrastrar los recursos para ordenarlos en la página del manual. Reordenar se desactiva mientras el filtro esté en uso, porque una lista filtrada es un subconjunto.

## Sugerencias al configurar etapas

Al añadir o editar un recurso, marca tipos de etapa en **Sugerir al configurar etapas**: Enviar solicitud, Ejercicio de código, Entrevista, Oferta, Revisión de portafolio, Cuestionario, Verificación de referencias, Tarea para casa, Evaluación del equipo, Presentación en video, Respuesta en video.

Quien abra una etapa de ese tipo verá entonces un panel **De tu manual** con los recursos marcados. Cada uno se abre en una pestaña nueva, así que no se pierde nada sin guardar de la etapa.

El panel tiene un botón para ocultarlo, y ocultarlo es deliberadamente limitado:

- **Por persona.** Ocultarlo nunca lo oculta para nadie más.
- **Por tipo de etapa.** Ocultarlo en las etapas de Entrevista lo deja visible en las de Ejercicio de código.
- **Vuelve con cualquier añadido posterior.** Un recurso marcado *después* de que alguien ocultara el panel se lo devuelve. Silenciarlo una vez no entierra lo que el equipo escriba el mes que viene.

## Historial de versiones

Cada guardado que cambia el título, el contenido o el enlace de un recurso deja una instantánea. El panel **Historial** aparece junto al recurso para quien puede editarlo: las seis versiones más recientes, con las anteriores tras un desplegable. Cada entrada indica quién la guardó y qué campos cambiaron.

**Ver** abre una versión pasada. **Restaurar** vuelve a aplicarla, y restaurar es una acción hacia delante: escribe una versión *nueva* con el contenido antiguo en lugar de rebobinar el rastro. No se borra nada, y siempre puedes volver restaurando otra vez.

Al eliminar un recurso se elimina su historial con él.

## Encontrar un recurso

| Dónde | Con qué coincide |
|---|---|
| Filtro en la página de un manual (aparece a partir de 8 recursos) | Fragmento del título, del contenido o de la URL |
| Cmd+K | Nombres de manuales y títulos de recursos |
| `hiring_search_playbooks` (agentes) | Texto completo, ordenado por relevancia, en títulos, contenidos y nombres de manuales |

La búsqueda es por palabras clave, no semántica: «puntuación de la puesta en común» encuentra esas palabras, no una paráfrasis.

## Para agentes de IA

Cuatro herramientas de solo lectura. Necesitan acceso a Contratación y el ámbito de **lectura** de Contratación en la conexión, nada más. Para conectar un cliente, consulta [Agente de IA y herramientas MCP](/docs/hiring-ai-agent-mcp).

| Herramienta | Qué devuelve |
|---|---|
| `hiring_list_playbooks` | Todos los manuales con sus recursos por título, tipo, id, slug y tipos de etapa. **Sin el contenido de los documentos**: esto es el mapa. |
| `hiring_get_playbook` | Un manual por id `pbk_` o slug, con los contenidos **truncados a 2000 caracteres** y marcados cuando se truncan. |
| `hiring_read_resource` | Un recurso por id `rsc_` o slug, **completo**: todo el contenido, o la URL de un enlace. |
| `hiring_search_playbooks` | Coincidencias ordenadas por relevancia con un fragmento resaltado y el id `rsc_` con el que continuar. Los fragmentos son extractos. |

Busca o lista primero y luego usa `hiring_read_resource` para lo que necesites completo. `hiring_get_playbook` sirve para ver un manual entero de un vistazo, así que su truncado lo convierte en la última llamada equivocada antes de que un agente responda a una pregunta detallada.

## Checklist rápido

- [ ] Un manual por tipo de contratación, no uno por equipo
- [ ] Marca todo lo procedimental con los tipos de etapa a los que se aplica
- [ ] Enlaza al material que ya se mantiene en otro sitio; escribe documentos en Kit solo para aquello de lo que Kit es la sede
- [ ] Acierta con el tipo a la primera: después no se puede cambiar
- [ ] Pregúntale a tu asistente de IA algo cuya respuesta ya conoces, para comprobar que lee el recurso correcto