lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

configuración intermedio claude-codepythonmonorepomcp

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

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: prepara el ejemplo

Comprueba que tienes Git, uv y Python ≥3.11 disponibles. El README indica:

git clone https://github.com/coleam00/helpline.git
cd helpline
uv sync --extra dev
uv run pytest

Paso 2: inspecciona y valida la capa del agente

Lee AI-LAYER.md antes de ejecutar:

uv run --extra dev python tooling/validate/validate_all.py

Selecciona después las piezas que tiene sentido adaptar a tu proyecto.

Comprobación

Distingue el resultado de las pruebas de aplicación del validador de la capa del agente. Ambos deben completarse y cada pieza elegida debe tener su ubicación identificada.

Si algo falla

Si falla un componente, usa el mapa AI-LAYER.md para localizarlo. No copies reglas de facturación ni rutas internas del ejemplo como si fueran las de tu aplicación.

ver en .md ¿Prefieres el recurso entero?

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