Kodavio Agent Kit: tu capa cliente para dirigir al agente
El plugin Kodavio convierte cada WordPress en un servidor MCP con habilidades seguras (builders, diseño, conversión, admin). Cada vez que conectas un sitio sigues su prompt de conexión y tu agente — Claude Code, Cursor, Codex, OpenCode o Kilo — ya lo tiene disponible. Kodavio guarda además en la base de datos de cada sitio su propia memoria — design memory (tokens, paleta), scope del proyecto, change log — leíble con kodavio/design-read, kodavio/scope-read.
Lo que falta es la otra mitad: memoria del operador sobre cada sitio desde fuera (caveats de hosting, idiosincrasias del cliente, incidencias pasadas, recordatorios concretos) y reglas distintas según el entorno. Esa capa cliente es el Kodavio Agent Kit: un workspace clonable, todo en markdown portable, sin lock-in.
Principio: el agente es el autor (copy, jerarquía, dirección de diseño), Kodavio es el ejecutor, y tú apruebas lo irreversible.
Por qué lo necesitas
Sin esta capa, el modelo decide solo cosas que no debería:
- Cuándo está apuntando a producción y cuándo a staging si tienes los dos MCPs cargados del mismo cliente (un prompt ambiguo puede ir al sitio equivocado).
- Si una página existe (
edit) o no (create). Reconstruir una publicada es irrecuperable. - Si la operación pide gate humano o puede ejecutarla sola, según el entorno.
- Si el sitio tiene caveats que prohíben ciertas acciones (PHP roto, hosting frágil, sin backups).
El kit lo resuelve con un registro de sitios (registry/sites.json), una matriz de guardarraíles por entorno, un protocolo de sesión que el agente ejecuta antes de tocar nada, y una memoria operativa por sitio (sites/{slug}/NOTAS.md) que sobrevive a las sesiones.
Instalación en 5 minutos
Requisitos: agente con MCP (Claude Code recomendado), Node.js ≥ 18, plugin Kodavio instalado y acceso admin al WordPress.
# 1. Clonar el kit
git clone git@github.com:flowtitude/kodavio-agent-kit.git
cd kodavio-agent-kit
# 2. Crear tu registro local desde la plantilla (queda fuera de git)
cp registry/sites.example.json registry/sites.json
# 3. Abrir el kit con tu agente
claude # o: cursor . / codex / opencode / kilocode
Al abrirlo, el agente lee su puerta de entrada (AGENTS.md, o CLAUDE.md en Claude Code) y queda operativo: ya conoce el protocolo, las reglas y las skills. No hay build ni dependencias.
Windows: clona con -c core.symlinks=true (Developer Mode), o los symlinks de CLAUDE.md y .claude/{skills,agents} llegan rotos.
Conectar tu primer sitio (un comando)
/wp-onboard-site(En Cursor / Codex / OpenCode / Kilo: "da de alta un sitio nuevo".) El agente te entrevista, verifica que Kodavio responde, registra el MCP en tu herramienta, rellena registry/sites.json con los datos reales (wp-get-config-summary) y crea su memoria. Sin agente: ./scripts/add-site.sh.
Empieza por un sitio de dev o staging. Aprende ahí, comete los errores ahí, y pasa a producción cuando el flujo te resulte natural.
Cómo se trabaja después
Cada sesión empieza por wp-site-session: el agente identifica el sitio, carga su memoria y aplica los guardarraíles del entorno. Después, en lenguaje natural:
En producción, el agente nunca publica, instala plugins, escribe PHP, borra ni hace operaciones masivas sin tu confirmación explícita.
Qué viene en el kit
- 12 skills de cliente para alta de sitio, planificación, construcción, conversión, salud, seguridad, contenido, FDS, Tailwind/WindPress, patrones y sesión.
- 10 subagentes especializados: auditor, operator, bricks/elementor/gutenberg-operator, content-architect, woo-operator, content-writer, verifier.
- 3 reglas duras locales: guardarraíles por entorno, protocolo Kodavio (orden canónico de llamadas) y código en vivo.
- Lanzador MCP con credenciales en el almacén del SO (Keychain / libsecret /
pass/ Credential Manager). Las Application Passwords no viven en archivos de config.
Seguridad y mantenimiento
El repo nunca contiene datos reales: registry/sites.json, sites/{slug}/NOTAS.md y state.md están en .gitignore. Solo se versionan plantillas. Las credenciales se quedan en el almacén del SO.
Actualizar: git pull. Tus datos locales no se tocan. Mejoras del kit → issues/PRs en su repo. Errores del plugin → canal de la beta de Flowtitude.
Angel Julian He configurado correctamente Git y mi clave SSH en mi Mac. Al intentar descargar el proyecto (git@github.com:flowtitude/kodavio-agent-kit.git) me arroja un error de 'Repository not found', por lo que asumo que es privado. ¿Podrían por favor invitarme como colaborador? Mi usuario oficial de GitHub te lo paso por privado.
Luis Muñoz Ya lo he puesto público
Le he instalado sobre la web que estoy trabajando con Kodavio y la sensación es que es más eficiente y no se toma la libertad de hacer loq ue le venga en gana. Hasta ahora las pruebas que he hecho ha modificado lo que le he pedido, sin modificar el resto, ni provocar errores paralelos. Quizás un poco más lento pero más eficiente, por lo que se gana mucho tiempo finalmente.
Luis Muñoz Gracias com siempre por el feedback, igual lo de la velocidad es pro el flujo de trabajo que adopta, iremos tratando de mejorar, sobre todo en base a mi experiencia de trabajo y vuestro feedback
Angel Julian Comento un comportamiento nuevo con los agentes. En la práctica que hice de crear CPT, taxonomía, biblioteca de iconos y campos personalizados, ahora le he hecho una auditoría y me hace una propuesta de limpiar y replantear. Las correcciones que le he ido haciendo ha ido dejando parches sobre parches, y ahora me propone hacer cambios para evitar conflictos futuros y que la web no caiga por problemas surgidos de estos parches, y me propone hacerlo en fases, con un nuevo planteamiento global.
Ante mi duda de poder yo controlar todo esto en un futuro, con mis muy básicos conocimientos, le he propuesto hacer un duplicado en JetEngine, y me da la razón y me propone hacerlo exactamente como lo había pensado.
Supongo que esto es gracias al kit de agentes, o al menos eso creo.
Pero, lo tengo qué pensar qué me conviene más, si meter un plugin con JetEngine o dejar la solución propuesta.
También me gustaría saber vuestra opinión.
Gracias.
Luis Muñoz Esto no es tanto kodavio, es el agente el responsable de haber tomado un camino no otro, lo modificare en el pack del agente para que cuando hayan varias posibilidades las fundamente y te de opcion de elegir el camino después de estar informado.
Angel Julian Tras intentar seguir las expliocaciones para instalar el kit de agentes, tuve que acudir a la IA para que me ayudara pues creo que no está detallado paso a paso lo que hay que hacer, y para un usuario de nivel medio, como puedo ser yo, se escapan muchas cosas que creo deberían estar más explicadas para que se sepa hacer y que lo que estás haciendo está correcto. Para empezar en ningún sitio dice que esto hay que hacerlo en la terminal de tu máquina (Mac en mi caso). Otra cosa es que te estés dirigiendo a una clientela con más conocimientos y que esto que expongo sea como hablarle del abecedario a un escritor.
Luis Muñoz Lo tengo en cuenta, gracias por hacer mencion, porque este tipo de cosas si se me puede pasar, en la doc de github no, pero en el post y en la doc habra documentación para que todo este perfectamente claro.
He hecho un sistema para redactar artículos, post de cpts, landing, etc. con contenidos específicos, forma de redactar, etc. para una web. Lo he hecho con ChatGPT y se ejecuta con Codex, pero necesito de un MCP para conectarme al sitio. Lo he probado con PubliWP y va, pero me gustaría hacerlo con Kodavio. ¿Cómo puedo hacerlo? ¿Dónde podría poner el agente o skill?
Luis Muñoz Es un sitema completamente autonomo y entero, no son solo skills, son agentes, workflows, etc. No hay problema, tu ssi tienes en tu instalacion del agente el mcp de Kodavio que supongo que ya tendrás, solo necesitas entrar en ese directorio y empezar a trabajar.