Everything Claude Code: El Harness con 140K Stars Explicado

TL;DR: Everything Claude Code (ECC) es un sistema de optimización para agent harnesses que unifica skills, instincts, memoria persistente, hooks de seguridad y reglas por lenguaje. Funciona en Claude Code, Cursor, Codex, OpenCode y Gemini, acumula más de 140.000 estrellas en GitHub y resuelve la fragmentación que sufre cualquiera que monte su propio setup de agentes de código.

El problema: cada equipo reinventando el mismo harness

Quien lleve varios meses con agentes de código conoce el bucle: añades una regla a CLAUDE.md, creas un slash command suelto, copias un hook de StackOverflow, y al mes siguiente no recuerdas qué de todo eso sigue vivo. Multiplica por Cursor, Codex y OpenCode, y el caos se dispara.

En escenarios reales de agentic coding, buena parte del tiempo perdido no está en prompts mal escritos, sino en la infraestructura alrededor del agente: cuándo compactar contexto, qué memoria persiste, cómo validar que no se saltó tests, cómo detectar si se está colando una API key. Ese es exactamente el nicho que cubre Everything Claude Code.

¿Qué es Everything Claude Code (ECC)?

Everything Claude Code es un sistema de configuración para agent harnesses creado por Affaan Mustafa, ganador del hackathon de Anthropic de septiembre de 2025. No es un framework ni una librería: es un conjunto opinado de agents, skills, hooks, commands y reglas que instalas como plugin y quedan disponibles dentro del harness.

Según el repositorio oficial en GitHub (affaan-m/everything-claude-code), a abril de 2026 reúne:

• 140K+ estrellas y más de 21.000 forks
• 170+ contribuidores activos
• Hasta 28 agentes especializados (planner, evaluator, security-scanner, etc.)
• Entre 56 y 119 skills, según la versión instalada
• Entre 33 y 60 slash commands personalizados
• Soporte para 12 ecosistemas de lenguaje

La versión 1.10.0 (última estable a abril de 2026) soporta instalación selectiva: eliges qué módulos cargas en tu harness en vez de arrastrar todo el paquete.

Los cinco pilares de ECC

1. Skills reutilizables

Cada skill es un SKILL.md con frontmatter YAML y un cuerpo markdown que describe cuándo y cómo aplicar un patrón. El formato es portable entre Claude Code, Codex y OpenCode sin tocar el contenido.

2. Instincts (aprendizaje continuo)

Los instincts son patrones atómicos con puntuación de confianza. Un hook observa la sesión, detecta patrones repetidos (ej: siempre que tocas tests tipas primero) y los guarda. Cuando la confianza supera un umbral, el instinct evoluciona a skill o command con /evolve. La v2.1 añadió scope por proyecto para evitar que patrones de un repo contaminen otro.

3. Memory persistence

Hooks que cargan y guardan contexto entre sesiones automáticamente. Funciona sobre el sistema de auto-memory de Claude Code, añadiendo indexación por tema y compactación estratégica con /compact en puntos lógicos en lugar de esperar al 95% del contexto.

4. Security scanning

El comando /security-scan ejecuta pattern matching contra el diff actual buscando API keys, tokens hardcodeados y llamadas peligrosas. El proyecto publica un paquete separado, ecc-agentshield, con reglas más agresivas orientadas a CI.

5. Research-first development

Una convención: antes de escribir código, el agente consulta documentación actualizada (vía MCP servers como Context7 o Tavily). Evita que Claude implemente contra su memoria de 2024 cuando la API cambió en 2026.

Instalación y estructura

La forma recomendada es el marketplace de plugins integrado en Claude Code v2.1+:

# Anade el marketplace y luego instala el plugin oficial
/plugin marketplace add affaan-m/everything-claude-code
/plugin install everything-claude-code@everything-claude-code

Tras la instalación, el árbol queda así (simplificado):

.claude/
├── agents/           # Definiciones (planner, evaluator, security)
├── skills/           # SKILL.md con frontmatter YAML
├── commands/         # Slash commands (.md)
├── hooks/            # Scripts shell/python para eventos
├── rules/            # Reglas por lenguaje (py, go, ts, swift)
└── AGENTS.md         # Universal, leido por todos los harnesses

El archivo AGENTS.md en la raíz es la pieza clave: es el único fichero que leen Claude Code, Cursor, Codex y OpenCode a la vez. Evita duplicar instrucciones en cuatro sitios. El patrón encaja con lo que vimos en cómo evitar el context drift en CLAUDE.md: una sola fuente de verdad, compacta y jerárquica.

Soporte cross-platform: qué funciona en cada harness

Codex queda por detrás en hooks (no los soporta nativamente) y se compensa con AGENTS.md más permisos de sandbox. Cursor usa un patrón adapter DRY que reutiliza los scripts de hooks de Claude Code sin duplicarlos. Si vienes de subagentes en Cursor, te sonará la filosofía.

Ejemplo: un hook de memoria persistente

Para entender el valor real, mira un hook de ECC que guarda contexto al terminar la sesión:

# Hook SessionEnd: guarda el resumen en memory/ para la proxima sesion
#!/usr/bin/env bash
session_id="${CLAUDE_SESSION_ID}"
summary_file=".claude/memory/session-${session_id}.md"

# Extrae ultimos mensajes clave y los persiste indexados por tema
jq '.messages[-20:]' "$CLAUDE_TRANSCRIPT" > "$summary_file"

No hay magia: es un script shell que el harness dispara en el evento SessionEnd. El truco está en que Claude lo lee automáticamente al inicio de la siguiente sesión sin que tengas que acordarte de nada. Es la misma idea que ya exploramos en AgentHandover y skills automáticos, llevada a escala de proyecto entero.

En Producción

ECC no es un juguete de fin de semana. Lo usan 170+ contribuidores a diario. Pero hay matices reales si lo llevas a tu equipo.

Coste en tokens

Instalar ECC completo añade instrucciones al system prompt. La v1.9.0 introdujo instalación selectiva precisamente para esto: carga solo los agents y skills que necesitas. Si tu proyecto es Python puro, desactiva las reglas de Go y Swift. La diferencia en un mes de uso intensivo puede ser significativa.

Para un desarrollador que paga su propio plan, esto importa. Complementa bien con las tácticas de optimización de tokens en agentes de código: modelo barato para routing, caching agresivo y evitar cargar toda la base de código.

Cuándo el adapter pattern de Cursor falla

El DRY adapter que reutiliza hooks de Claude Code en Cursor es elegante, pero asume que los scripts son agnósticos al harness. Si un hook llama a una variable específica de Claude Code (${CLAUDE_TRANSCRIPT}), en Cursor falla silenciosamente. Revisa los hooks que adoptes.

Seguridad: ojo con los sandbox permissions

ECC incluye hooks que ejecutan shell. El repositorio audita los scripts, pero un fork cualquiera puede no hacerlo. Instala solo desde el marketplace oficial o el repo upstream. Si tu empresa tiene datos sensibles, revisa cada hook antes de habilitarlo.

Escalabilidad

El sistema está pensado para desarrollador individual o equipo pequeño. En escenarios con monorepos y muchos developers, las instincts pueden generar ruido cruzado incluso con scope por proyecto. La documentación recomienda revisar /instinct-status periódicamente y exportar/importar (/instinct-export) los que realmente aportan.

Errores comunes y depuración

Error: los skills no se cargan tras instalar. Causa: versión de Claude Code inferior a v2.1.7, que introdujo validación estricta de frontmatter. Solución: actualiza con claude update y ejecuta claude plugin validate.

Error: AGENTS.md no se lee en Codex CLI. Causa: Codex ignora el archivo si no está en la raíz del repo o si falta el campo model_instructions_file en la config. Solución: mueve AGENTS.md a la raíz y referéncialo explícitamente.

Error: hooks duplicados disparan dos veces. Causa: ECC instalado globalmente y a nivel proyecto a la vez. Solución: desinstala uno de los dos con /plugin uninstall.

Error: /security-scan marca falsos positivos en fixtures de test. Causa: la regex detecta strings que parecen tokens. Solución: añade tests/fixtures/** a la lista de exclusión en rules/security.md.

¿Cuándo NO usar ECC?

No todo encaja. Si tu proyecto es un script de 200 líneas, ECC es overkill. Si ya tienes un setup funcional con 4-5 skills propios y hooks probados, importarlo entero puede romper lo que funciona. La recomendación honesta: adopta módulos sueltos (el hook de memoria, las reglas de tu lenguaje) antes que el paquete completo.

Quien venga de limpiar servidores MCP hasta dejar solo los que aportan entenderá la filosofía: más piezas no significa mejor agente, significa más superficie de fallo.

Preguntas frecuentes

¿ECC sustituye a CLAUDE.md?

No. ECC complementa CLAUDE.md y AGENTS.md. Tu archivo de proyecto sigue siendo la fuente de verdad para reglas específicas del repo. ECC aporta la capa compartida (agents, skills, hooks) que no quieres reescribir en cada proyecto.

¿Funciona con modelos que no son Claude?

Sí, parcialmente. El sistema es agnóstico al modelo: Codex CLI con GPT-5 y OpenCode con modelos locales usan los mismos AGENTS.md y skills. Las partes que dependen de Claude (slash commands nativos, ciertos hooks) tienen equivalentes en cada harness.

¿Cuánto cuesta mantenerlo actualizado?

El proyecto publica versiones cada pocas semanas. Con /plugin update es un comando. El coste real está en revisar el changelog antes de actualizar: un cambio en un hook puede romper tu flujo. Enganchar notificaciones del repo en GitHub es suficiente.

Cierre

Everything Claude Code no es mágico. Es la cristalización de 10+ meses de uso real de agentes de código por parte de alguien que se tomó el trabajo de documentar qué funciona y qué no. Las 140K estrellas reflejan que el problema de fragmentación de harnesses es universal, y que nadie quería seguir copiándose fragmentos entre repos.

Lo interesante del proyecto es que trata el agent harness como ingeniería, no como prompt engineering: skills versionados, hooks testeables, separación de concerns. Si llevas tiempo peleando con agentes que se saltan tests o pierden contexto entre sesiones, merece la pena al menos leer el Shorthand Guide antes de decidir.

¿Has probado ECC en tu flujo o prefieres mantener tu harness artesanal? Cuéntamelo en Twitter en @sergiomarquezp_. En el próximo post toca analizar cómo montar tus propios instincts desde cero sin depender del plugin.