Gutenberg y patrones

Kodavio tambien puede trabajar con el editor nativo de WordPress. Es util para paginas sencillas, contenido editorial y patrones reutilizables.

Gutenberg es el destino mas portable. Si una pagina no necesita dependencias fuertes de un builder visual, crearla como bloques nativos facilita mantenimiento, rendimiento y edicion futura.

Kodavio solo serializa contratos de bloques validos. El agente debe escribir el copy, decidir la jerarquia editorial y construir el array blocks antes de llamar a gutenberg-create-page o gutenberg-create-pattern.

Que puede hacer

Accion	Para que sirve	Como pedirlo
Listar bloques	Ver bloques registrados y filtrar por namespace.	"Lista bloques Gutenberg disponibles y dime cuales tienen contrato seguro."
Leer pagina	Ver el contenido como bloques parseados.	"Lee la pagina 123 como bloques, sin raw content salvo que lo necesites."
Validar bloques	Comprobar un contrato antes de escribir.	"Valida esta estructura de bloques y dime errores."
Crear pagina	Crear un borrador desde bloques estructurados.	"Crea en dry_run una pagina Gutenberg draft."
Actualizar pagina	Sustituir o ajustar bloques de una pagina existente.	"Actualiza solo despues de dry_run y confirm_write."
Listar patrones	Ver patrones reutilizables (`wp_block`).	"Lista patrones relacionados con CTA."
Crear/actualizar patron	Guardar bloques reutilizables.	"Crea un patron synced/unsynced en dry_run."

Crear una pagina Gutenberg

Crea una pagina Gutenberg en borrador para una landing de servicio.

Primero haz dry_run y ensename la estructura:
- copy concreto del hero con titular, texto y boton;
- bloque de beneficios con textos reales;
- seccion de proceso con pasos redactados;
- llamada final a contacto;
- array blocks que vas a enviar a Kodavio.

No publiques nada.

Contrato de bloques

Codex debe trabajar con bloques estructurados, no pegando HTML sin control. Los bloques suelen incluir:

name: nombre del bloque, por ejemplo core/heading.
attrs: atributos seguros del bloque.
text o contenido equivalente cuando aplique.
inner_blocks: bloques hijos.

Antes de escribir una estructura larga, pide validar:

Valida primero la estructura de bloques Gutenberg.

Necesito:
- errores exactos;
- warnings;
- bloques core soportados;
- si hay algun bloque de tercero sin contrato seguro.

Crear un patron reutilizable

Crea un patron Gutenberg reutilizable para una llamada a la accion.

Debe incluir:
- titulo corto;
- texto de apoyo;
- boton principal;
- clase CSS clara para poder ajustarlo despues.

Primero dry_run. No escribas hasta que confirme.

Bloques habituales

El plugin puede trabajar con bloques nativos comunes:

Paragraph.
Heading.
List.
Quote.
Image.
Buttons y Button.
Group.
Columns y Column.
Cover.
Spacer.
Separator.
Shortcode.
HTML.

Para bloques de terceros, pide primero que Codex inspeccione los tipos registrados y que no escriba hasta tener un plan claro.

Patrones sincronizados y no sincronizados

Un patron sincronizado se comporta como una pieza reusable: cambiarlo afecta a todas las inserciones conectadas. Un patron no sincronizado funciona mas como una plantilla que se copia al contenido.

Usa patrones sincronizados para:

CTAs globales.
Bloques de garantia.
Banners repetidos.
Formularios o shortcodes comunes.

Usa patrones no sincronizados para:

Secciones que cada pagina debe adaptar.
Layouts base.
Composiciones editoriales.

Conversiones con Gutenberg

Gutenberg puede ser origen o destino en conversiones.

Flujo	Buen candidato	Cuidado
Builder a Gutenberg	Paginas editoriales, landings simples, CTAs, contenido sin efectos complejos.	Puede perder detalles visuales muy especificos.
Gutenberg a Builder	Paginas que necesitan mayor control visual o componentes avanzados.	Conviene preservar jerarquia y no sobrediseniar.
Patron a Builder	Reutilizar un CTA o bloque editorial dentro de Bricks/Elementor.	Revisar clases, espaciados y responsive.

Pide siempre que se cree un borrador nuevo y que la pagina original permanezca intacta.