// Proyecto · Claude Code · MCP · Developer Tooling

Extender Claude Code
para que entienda monorepos complejos.

Implementación de referencia de los 6 puntos de extensión de Claude Code sobre un monorepo real de plataforma de servicios de campo. CLAUDE.md que se mejora solo tras cada sesión, skills activados por directorio, servidor MCP con navegación AST y un subagente explorador que solo puede leer — nunca modificar.

// Características del sistema

Extension points
6
todos los de Claude Code
Servicios en el monorepo
5 + 2
servicios + paquetes compartidos
Validación E2E
13
puntos de control
Bundle
portable
plug & play en cualquier monorepo

El problema

Los LLMs se pierden
en codebases grandes.
No es culpa del modelo.

01

Contexto sin estructura. Un monorepo de 50k+ líneas no cabe en ninguna ventana de contexto. Sin guías de navegación explícitas, el modelo genera código que ignora convenciones del proyecto o módulos existentes.

02

CLAUDE.md estático que queda obsoleto. La documentación de proyecto escrita una vez y nunca actualizada se vuelve mentirosa. El modelo sigue instrucciones que ya no aplican al codebase real.

03

Herramientas genéricas para código específico. Las herramientas de navegación por defecto son de propósito general. Un codebase con estructura de dominio propio necesita herramientas que entiendan ese dominio — no grep genérico.

04

Permisos de escritura donde solo hace falta leer. En monorepos multi-servicio, un agente explorador con permisos de escritura es un riesgo innecesario. La separación de roles no debe depender de la confianza en el prompt.


Cómo funciona

PUNTO 01

CLAUDE.md auto-actualizable

Un hook Stop se ejecuta al terminar cada sesión de Claude Code y actualiza CLAUDE.md con el contexto aprendido. La documentación del proyecto mejora sola — sin intervención manual.

PUNTO 02

Skills con alcance por directorio

Cada servicio del monorepo tiene su propio conjunto de skills, activados solo cuando Claude Code trabaja en ese directorio. Sin contaminación de contexto entre servicios independientes.

PUNTO 03

Servidor MCP con navegación AST

Un servidor MCP propio expone herramientas de navegación que entienden la estructura AST del codebase. Claude puede preguntar "¿dónde se define esta clase?" y obtener respuesta exacta, no grep aproximado.

PUNTO 04

Subagente explorador de solo lectura

Agente especializado en exploración con permisos exclusivamente de lectura. Puede navegar, analizar y reportar. No puede modificar nada. El rol está separado por arquitectura, no por instrucción de prompt.

Python 3.11+,
MCP propio,
navegación AST.

Implementado íntegramente en Python con uv como gestor de entorno. El servidor MCP se construye desde cero con el SDK de MCP. Pyright para type-checking estricto en todo el monorepo.

Python 3.11+ MCP (Model Context Protocol) Claude Code extension points AST navigation uv pyright Claude Code hooks Claude Code skills Subagents CLAUDE.md auto-update

Qué demuestra

Extension points completos

Los 6 puntos de extensión de Claude Code

Hooks, skills, servidores MCP, subagentes, CLAUDE.md dinámico y configuración avanzada. Una referencia reproducible de cómo llevar Claude Code al límite de sus capacidades de extensión.

Arquitectura MCP

Servidor MCP con herramientas de dominio

El servidor MCP no expone herramientas genéricas — expone herramientas que entienden la estructura AST del codebase concreto. La diferencia entre "buscar en texto" y "entender el código".

Entorno realista

Monorepo de producción como banco de pruebas

5 servicios + 2 paquetes compartidos en una plataforma de servicios de campo simulada. Los 13 puntos de validación E2E verifican que las extensiones funcionen en un entorno de complejidad real.

Bundle portable

Plugin replicable en cualquier monorepo

El conjunto de extensiones está empaquetado como bundle portable. No está acoplado a la plataforma de demostración — es una plantilla de trabajo aplicable a cualquier monorepo con estructura similar.


¿Te interesa este proyecto?

Relevante si...

  • Buscas un AI Engineer que entienda los extension points de Claude Code a fondo, no solo el uso básico
  • Trabajas con monorepos grandes donde el contexto del LLM se pierde o degrada con el tamaño
  • Necesitas construir herramientas de developer tooling basadas en MCP con herramientas de dominio
  • Quieres ver cómo separar roles de agentes (explorador vs. editor) por arquitectura, no por prompt

Menos relevante si...

  • Buscas una solución lista para instalar en producción (es una implementación de referencia, no un producto)
  • Tu codebase es pequeño y los tools por defecto de Claude Code son suficientes
  • Tu equipo no usa Claude Code como herramienta de desarrollo principal

Proyectos relacionados

RAG Agéntico · Qdrant · LangGraph

Repo Expert

RAG agéntico sobre cualquier repositorio GitHub con citas inline. 100% routing, 94% fidelidad.

Ver caso completo →
LangGraph · Azure OpenAI · Tavily

Interview Preparation Agent

Investigación de empresa con seis workers en paralelo, patrón map-reduce y dos checkpoints humanos.

Ver caso completo →

Contacto

¿Buscas un AI Engineer?
Hablemos.

30 minutos. Sin compromiso. Si veo que puedo ayudarte, te lo digo. Si no, también.

Agendar videollamada →