Primeros pasos
Mapa de capacidades
Mapa de capacidades
Este mapa resume qué puede hacer Kodavio hoy en producción beta y cómo pedir cada tarea al agente sin ambigüedad.
Resumen por familia
| Familia | Qué hace | Cómo pedirlo |
|---|---|---|
| Diagnóstico | Lee estado del sitio, constructor, plugins, salud y cambios recientes. | "Haz solo lectura y devuélveme riesgos antes de escribir." |
Diseño (design.md) | Lee/importa/escribe memoria visual y tokens. | "Primero dry_run de importación y limpieza; no escribas todavía." |
Alcance (scope.md) | Planifica sitemap, backlog, integraciones y fases. | "Propón plan con vacíos y siguientes pasos, sin cambios." |
| Constructores | Crea y edita páginas y plantillas en Bricks y CrocoBuilder: reescribir sin cambiar el id, tocar un elemento suelto, condiciones de plantilla. Elementor y Gutenberg vienen apagados desde la 0.3.0. | "Prepara modelo estructurado + dry_run antes de crear." |
| Conversiones | Analiza origen, transpila al destino y reporta pérdidas/alternativas. | "No toques origen; crea borrador nuevo con diff." |
| Integraciones | Descubre capacidades de terceros y vacíos de adaptador. | "Inspecciona esquemas; no ejecutes terceros sin plan." |
| Configuración del sitio | Ajustes de WordPress, enlaces permanentes, visibilidad, comentarios, medios, menús, términos, usuarios y roles propios. La de WooCommerce todavía no. | "Enséñame el antes y el después; no confirmes hasta que te diga." |
| Administración WordPress | Plugins, contenido (slug, papelera), medios, vista previa, fragmentos, formularios, mu-plugins y PHP permitido. Deshacer viene encendido salvo para el código. | "Dry_run y confirmación explícita para cualquier operación sensible." |
| Exportación | Exporta páginas/paquetes portables con plan previo. | "Ejecuta export-plan primero y confirma alcance antes de escribir." |
Qué está sólido hoy (madurez alta)
- Conectividad MCP con preflight y clasificación de fallos.
- Flujo de seguridad
dry_run+ confirmación para escrituras críticas. - Operaciones en Bricks y CrocoBuilder con contrato estructurado.
- Configuración de WordPress con copia y marcha atrás.
- Lectura/gestión de
design.mdyscope.mdpara contexto persistente. - Auditoría operativa de cambios.
Qué requiere más revisión manual (madurez media)
- Conversiones complejas con widgets de terceros o lógica dinámica.
- Formularios avanzados y automatizaciones externas.
- Migraciones visuales muy ricas donde el constructor destino no tenga equivalente nativo.
Patrón de solicitud por tipo de trabajo
Diagnóstico
Haz diagnóstico solo lectura.
No escribas nada.
Devuélveme riesgos, límites y siguiente paso recomendado.
Escritura controlada
Primero prepara dry_run.
Enséñame la propuesta de cambios, el impacto y los avisos.
No ejecutes escritura real hasta mi confirmación.
Conversión entre constructores
Convierte [origen] a [destino] como borrador nuevo.
No toques la original.
Haz dry_run, luego creación confirmada y diff final.
Señales de calidad que debes exigir siempre
dry_runexplícito antes de escribir.- resumen de cambios y avisos de riesgo.
- identificación de limitaciones (no soportado, alternativa aplicada, pasos manuales).
- referencia verificable del resultado (ID, URL de edición, entidad creada).
Señales de alerta (detener y revisar)
- intento de escribir sin
dry_runprevio; - mezcla de servidores MCP distintos en una sola operación;
- ausencia de impacto esperado o de avisos en tareas sensibles;
- propuestas genéricas sin modelo estructurado para constructores.
Comando de orientación rápida
Si necesitas un mapa vivo del sitio actual, pide al agente: "Ejecuta kodavio/capability-map y kodavio/agent-handbook y resúmelo para operación segura."