# Helpline: ejemplo de configuración de agentes en un monorepo

> Estudia una base de código de demostración con instrucciones, hooks, skills y búsqueda estructurada para adaptar ese patrón a tu proyecto.

Verificado el 26 oct 2026.

## Qué es

Helpline es una base de demostración de Cole Medin para enseñar cómo preparar un proyecto para Claude Code. Simula una plataforma de soporte con varios servicios y paquetes compartidos; su finalidad principal es mostrar la capa de trabajo del agente.

## Para qué te sirve

- Cuando tu agente pierde convenciones al moverse entre servicios de un monorepo.
- Cuando quieres ver ejemplos ejecutables de hooks, skills y un subagente de exploración.
- Cuando necesitas adaptar búsqueda estructurada de código a tu propia organización de archivos.

## Cómo funciona

`AI-LAYER.md` relaciona cada concepto con su implementación. Hay instrucciones por carpeta, hooks de inicio y final de sesión, skills de dominio y un servidor MCP de búsqueda basado en AST. Un validador comprueba esa capa además de las pruebas de la aplicación.

Parte del material se empaqueta en un plugin portable; otras piezas, como reglas de facturación, son ejemplos específicos que debes reconstruir para tu dominio. No confundas el negocio ficticio con un producto de soporte listo para clientes.

## Antes de empezar

Necesitas Git, Python y uv para el camino de ejecución documentado. Usa una copia local de estudio y lee las reglas antes de activar hooks en otro proyecto. GitHub no detecta licencia: comprueba los permisos de reutilización antes de distribuir derivados.

## Límites y alternativas

La validez del ejemplo no demuestra que sus convenciones sean adecuadas en tu código. Las rutas y reglas de negocio requieren adaptación. Para un repositorio pequeño puede bastar una configuración mucho más corta.

## Recursos

- [Repositorio y README](https://github.com/coleam00/helpline) - 115 estrellas; GitHub no detecta licencia.