Construí un Plugin de WordPress con un Equipo de 6 Agentes IA (y Procesa 16,000 Posts en 90 Segundos)

Tengo un problema que ningún plugin de WordPress resuelve bien.

ecosistemastartup.com publica ~100 posts por día. Tiene más de 16,000 artículos, 500+ términos de glosario, 500+ actores del ecosistema startup, y necesita insertar links internos automáticamente en todo ese contenido. Los plugins que probé — Link Whisper, Internal Link Juicer, Rank Math — degradan el performance cuando escalas a miles de reglas de linking.

Así que decidí construir uno. No solo. Con un equipo de 6 agentes IA usando Agent Teams de Claude Code.

El Dolor: Internal Linking a Escala No Funciona

Si tienes un blog con 50 posts, cualquier plugin de internal linking funciona. El problema aparece cuando escalas:

• Internal Link Juicer procesaba links en cada page load. Con 500+ reglas, el TTFB se iba a las nubes.
• Link Whisper necesita intervención manual para cada sugerencia. A 100 posts/día es inmanejable.
• Rank Math tiene linking automático pero limitado: no tiene API, no soporta entidades custom, no puedes automatizar.

Lo que necesitaba era simple en concepto pero complejo en ejecución:

1. Cero impacto en el frontend — 0 queries adicionales cuando un usuario visita el sitio
2. Procesamiento async — los links se insertan en background, nunca bloqueando saves ni page loads
3. API-first — poder crear reglas, importar en bulk y monitorear todo programáticamente
4. Compliance automático — links de afiliados con rel="sponsored nofollow" sin pensar

La Decisión: Agent Teams de Claude Code

Podría haberlo programado línea por línea. Pero quería probar algo diferente: diseñar el plugin completo como un proyecto de Agent Teams, donde múltiples agentes IA trabajan en paralelo con roles especializados.

La clave no es «usa IA para programar». La clave es cómo diseñas los prompts para que el equipo sea autónomo.

Las Reglas de Autonomía (Esto Cambió Todo)

El error más común con agentes IA es dejarlos preguntar demasiado. Cada interrupción rompe el flujo. Así que definí reglas explícitas:

El agente principal NUNCA consulta al usuario para:

- Crear, editar o eliminar archivos

- Decisiones de estructura de carpetas

- Elección entre implementaciones técnicas equivalentes

- Redacción de READMEs, comentarios o documentación

- Escribir tests o casos de prueba

Solo interrumpir si:

- Una decisión cambia el scope del MVP

- Ambigüedad con impacto opuesto

- Se necesita credencial o acceso externo

- Bloqueo técnico sin salida

El resultado: el equipo trabajó durante horas sin interrumpirme una sola vez.

El Equipo: 6 Agentes, Cada Uno con su Rol

No es «un agente que hace todo». Cada uno tiene un rol específico y reglas claras:

1. 🧭 Estratega

El guardián del principio absoluto: nunca impactar el performance. Cada decisión técnica pasa por este filtro. Si algo hace el plugin más pesado sin beneficio de SEO demostrable, se rechaza.

2. 🔬 Research Agent

Antes de escribir una línea de código, este agente investigó todos los competidores:

• Link Whisper, Yoast SEO, Rank Math, Internal Link Juicer, Internal Links Manager, SEOKEY
• Documentó problemas de performance con evidencia de reseñas de wordpress.org
• Entregó un reporte con tabla comparativa, antipatrones y recomendación técnica

Decisión clave del reporte: inserción on-save async con caché, no on-render. Esto es lo que mata el performance de otros plugins — procesan en cada page load.

3. 📊 SEO Engineer

Definió el algoritmo de matching: qué términos linkear, cuántos links por post, cómo tratar afiliados (rel="sponsored nofollow" siempre), qué elementos HTML nunca tocar (headings, code blocks, links existentes).

4. ⚡ Performance Agent

El rol más crítico. Definió métricas antes de que existiera código:

Métrica	Límite
TTFB con plugin activo vs inactivo	< 5ms diferencia
save_post overhead	< 50ms
Queries en frontend	0
Bulk 15,000 posts	< 4 horas
Engine con 1,000 reglas	< 500ms/post

Tiene poder de veto. Si alguna implementación degrada las métricas, se para todo.

5. 🏗️ Arquitecto / Dev

Implementa todo: schema de BD, API REST (17 endpoints), engine de matching, queue con Action Scheduler, admin UI, WP-CLI commands. Todo con PHP 8.1+, strict types, estándares de wordpress.org desde el día 1.

6. 🔍 QA

Checklists por endpoint (auth, capabilities, sanitización), tests del engine (no linkea dentro de headings/code/links), validación de performance con los benchmarks del Performance Agent.

El Proceso: De Investigación a Plugin en un Día

El flujo fue estricto y en orden:

Fase 0 — Investigación: Research Agent entrega reporte. Performance Agent define métricas. SEO Engineer define algoritmo. Estratega decide timing.

Fase 1 — Fundación: Schema de BD, openapi.yaml, Docker funcional.

Fase 2 — Engine Core: RuleMatcherEngine, ContentParser, LinkBuilder. El corazón del plugin.

Fase 3 — Queue y Processing: Action Scheduler con concurrencia de 3 jobs paralelos, lotes de 100 posts.

Fase 4 — API y Admin: 17 endpoints REST, admin UI con 5 tabs, import/export.

Fase 5 — Benchmarks y release.

Los Números Reales (En Producción Hoy)

LeanAutoLinks ya está corriendo en ecosistemastartup.com. Estos son los números reales de la migración:

Métrica	Resultado
Posts procesados	16,793
Tiempo de procesamiento	90.5 segundos
Throughput	668,009 posts/hora
Keywords activos	736
Queries en frontend	0
Reglas migradas de ILJ	492

Para contexto: Internal Link Juicer tomaba minutos en rebuilds parciales. LeanAutoLinks procesó TODO el sitio en 90 segundos.

Lecciones de Build in Public con Agent Teams

Lo que funcionó

• Roles claros > agente genérico. El Performance Agent vetando al Arquitecto fue más valioso que un solo agente haciendo todo.
• Investigación primero. Sin el reporte del Research Agent, habríamos repetido los mismos errores de los competidores.
• Métricas antes que código. Definir los benchmarks antes de implementar obliga a diseñar para performance.
• Reglas de autonomía explícitas. El equipo no me interrumpió una sola vez. Eso es productividad real.

Lo que aprendí

• Los Agent Teams no reemplazan al founder que sabe lo que quiere. El prompt inicial de 3,000 palabras fue la inversión más importante del proyecto.
• El prompt ES el producto. Si tu prompt es vago, tu software es vago.
• Build in public con IA es más potente que build in public solo — puedes mostrar el proceso Y el framework para que otros lo repliquen.

El Plugin Es Open Source

LeanAutoLinks está en GitHub: github.com/ctala/Wordpress-Lean-Auto-Links

• 17 endpoints REST con OpenAPI spec
• Background processing con Action Scheduler
• 3 capas de caché (object cache, transients particionados, content cache)
• Unicode-aware (español, portugués, diacríticos)
• WP-CLI para operaciones bulk
• Documentación para agentes IA (AGENTS.md)

Si tienes un sitio con miles de posts y los plugins de internal linking te están matando el performance, pruébalo.

¿Quieres Ver Más Procesos Así?

Estoy documentando todo lo que construyo con IA en mi comunidad. Desde plugins hasta automatizaciones con n8n, workflows de contenido, y estrategias de monetización.

Únete a Cágala, Aprende, Repite — ahí compartimos builds reales, no teoría.

---

¿Construyes con Agent Teams o agentes IA? Cuéntame tu experiencia — me interesa saber qué frameworks están usando otros builders.