Saltar al contenido

Programar a partir de indicaciones con Blockstudio

Andrej Karpathy acuñó el término «programación por intuición» en febrero 2025 para describir un flujo de trabajo en el que explicas lo que quieres a una IA y esta escribe el código. Un año después, la práctica ha madurado hasta convertirse en lo que ahora llama «ingeniería con agentes»: desarrolladores que coordinan agentes de IA en lugar de escribir código línea por línea.

Blockstudio se creó para esto. Su arquitectura basada en archivos, la ausencia de herramientas de compilación y una estructura de proyecto predecible lo convierten en uno de los mejores entornos para el desarrollo de WordPress asistido por IA.

Esta guía presenta patrones prácticos para usar agentes de programación con IA con Blockstudio, desde la configuración del proyecto hasta la generación de sitios completos.

Por qué Blockstudio funciona bien con agentes de IA

Archivos, no bases de datos

Los agentes de programación con IA leen y escriben archivos. Esa es su interfaz principal. Blockstudio guarda todo en el sistema de archivos: un block.json y un archivo de plantilla por bloque, un page.json por página y un pattern.json por patrón. No hay entradas de base de datos que gestionar, ni que recorrer el panel de administración UI, ni pasos de compilación que ejecutar.

Esto importa porque los sistemas de archivos y los comandos de shell representan una de las mayores fuentes de datos de preentrenamiento para los LLM. Todos los modelos han visto millones de ejemplos de lectura, escritura y organización de archivos. Cuando tu flujo de desarrollo de WordPress coincide con esa interfaz, los agentes pueden trabajar con instrucciones mínimas.

Estructura predecible

Todos los bloques de Blockstudio siguen el mismo patrón:

Código
my-block/
├── block.json    # Configuration + fields
├── index.php     # Template
└── style.css     # Styles (optional)

Esta coherencia permite que un agente que haya creado un bloque pueda crear cien. No hay sorpresas, casos especiales ni configuración oculta. El mismo patrón se aplica a páginas (page.json + plantilla), patrones (pattern.json + plantilla) y extensiones (extend.json).

Páginas completas en archivos

La creación tradicional de páginas de WordPress requiere el editor de bloques: arrastrar bloques, configurar opciones y guardar desde el panel de administración. Los agentes de IA no pueden hacer nada de eso. Necesitan archivos.

Las páginas basadas en archivos de Blockstudio lo resuelven por completo. Un page.json define los metadatos de la página y una plantilla index.php define la estructura de bloques mediante HTML:

Código
pages/about/
├── page.json     # Title, slug, post type, template lock
└── index.php     # Block structure as HTML
HTML
<block name="core/cover" key="hero" url="https://example.com/bg.jpg">
  <h1 blockEditingMode="contentOnly">About Us</h1>
  <p blockEditingMode="contentOnly">Our story.</p>
</block>

<div key="team">
  <h2>The Team</h2>
  <block name="my/team-member" />
  <block name="my/team-member" />
</div>

Un agente puede crear desde cero una página completa de WordPress, con bloques del núcleo y personalizados, bloqueo de plantilla y controles de edición, escribiendo solo dos archivos. Ejecuta wp bs pages sync para aplicar el origen a WordPress; abrir el panel de administración no realiza esa sincronización automáticamente.

Esta es una de las funciones más potentes para el desarrollo asistido por IA. En vez de describir la distribución de una página y montarla a mano en el editor, se la describes a un agente y este escribe la plantilla. El resultado queda bajo control de versiones, es reproducible y se puede modificar en segundos.

Sin pasos de compilación

No hay nada que compilar, empaquetar ni transpilAR. El agente crea un archivo y funciona de inmediato. SCSS se compila en el servidor. Los módulos ES se resuelven en tiempo de ejecución. Tailwind CSS se compila en cada solicitud del frontend. El ciclo entre «el agente escribe código» y «el código se ejecuta en el navegador» es lo más corto posible.

Por qué Tailwind CSS es la opción adecuada

Blockstudio admite tanto CSS convencional como Tailwind CSS, pero Tailwind ofrece una ventaja importante al trabajar con agentes de IA.

Los LLM conocen muy bien Tailwind

Tailwind CSS se usa en decenas de miles de repositorios de código abierto. Da vida a las interfaces de Claude.ai, Vercel, Shopify, Cursor y los propios productos de OpenAI. Su presencia en los datos de entrenamiento hace que los LLM generen clases de Tailwind con gran precisión y rara vez inventen utilidades inexistentes.

El vocabulario de clases es finito y está bien definido. Un agente no puede inventar una propiedad de CSS que no exista, lo que reduce considerablemente los errores de estilo frente a CSS libre, donde el agente podría generar selectores no válidos o interpretar mal el comportamiento de la cascada.

Los estilos están en el marcado

Con Tailwind, toda la información de estilo se encuentra junto a la plantilla HTML. El agente ve en un solo lugar la descripción visual completa de un elemento. No hace falta consultar archivos .css separados, entender el orden de la cascada ni seguir conflictos de especificidad.

Esto resulta especialmente útil para los bloques de Blockstudio, cuya plantilla ya está en un solo archivo. El agente puede generar de una vez un componente completo y con estilos:

PHP
<div useBlockProps class="bg-white rounded-2xl shadow-lg p-8">
  <h2 class="text-2xl font-bold text-gray-900">
    <?php echo $a['title']; ?>
  </h2>
  <p class="mt-4 text-gray-600 leading-relaxed">
    <?php echo $a['description']; ?>
  </p>
</div>

Agentes en paralelo sin conflictos

Como los estilos de Tailwind se limitan a cada plantilla, varios agentes (o desarrolladores) pueden trabajar en distintos bloques a la vez sin conflictos de fusión CSS. No hay una hoja de estilos compartida donde los cambios de un componente puedan romper otro por accidente. Cada bloque es independiente.

Esto también funciona bien con CSS convencional si se usan los estilos con ámbito de Blockstudio (style.scoped.css), pero Tailwind elimina por completo el archivo CSS, así que el agente tiene que gestionar un archivo menos por bloque.

CSS convencional también funciona

Tailwind no es obligatorio. La cadena de recursos de Blockstudio gestiona automáticamente los archivos .css y .scss, incluidos los estilos con ámbito que se limitan a cada bloque. Si tu proyecto usa otra metodología de CSS, los agentes también pueden trabajar con ella. La ventaja de Tailwind es simplemente que los LLM lo manejan mejor gracias a la cobertura de los datos de entrenamiento y a que los estilos están junto al marcado.

Agentes de programación con IA

Las siguientes herramientas de CLI pueden trabajar con proyectos de Blockstudio desde el primer momento. Leen y escriben archivos, ejecutan comandos de shell y entienden la estructura del proyecto a partir de archivos de contexto.

Agentes de terminal (CLI)

Herramienta Proveedor Notas
Claude Code Anthropic Agente centrado en la terminal. Lee CLAUDE.md para conocer el contexto del proyecto.
Codex CLI OpenAI CLI de código abierto creado en Rust. También disponible como aplicación de escritorio.
Gemini CLI Google Código abierto, con una ventana de contexto de 1M tokens. Lee GEMINI.md.
GitHub Copilot CLI GitHub Agentes paralelos especializados en explorar, ejecutar tareas, planificar y revisar.
Aider Código abierto Compatible con 100+ proveedores de LLM, incluidos modelos locales.
OpenCode Código abierto TUI de terminal con integración LSP. Compatible con más de 75 proveedores.
Amazon Q Developer CLI AWS Tiene un plan gratuito. Ideal para proyectos integrados con AWS.

Agentes de IDE

Herramienta Proveedor Notas
Cursor Cursor Bifurcación de VS Code con IA integrada. También tiene un CLI (beta).
Windsurf Cognition AI Bifurcación de VS Code con el asistente agéntico Cascade.
Cline Código abierto Extensión de VS Code con aprobación paso a paso. También tiene un CLI.
Kilo Code Código abierto Modo orquestador con subagentes coordinados.
Continue Código abierto Extensión de VS Code/JetBrains con agentes asíncronos de CI/CD.
Augment Code Augment Orientado a empresas, con indexación profunda del código base.

Todas estas herramientas pueden crear y editar archivos en un directorio de proyecto de Blockstudio. Los agentes de terminal son especialmente adecuados porque el desarrollo de Blockstudio no requiere funciones específicas de un IDE: se basa únicamente en archivos.

Preparar el proyecto para agentes de IA

Archivo de contexto del LLM

Blockstudio incluye un archivo de contexto prediseñado que indexa toda la documentación del framework. No es un resumen ni una guía rápida: cada documento aparece una sola vez, con su ruta, su propósito y los identificadores que contiene, para que el agente encuentre la página que responde a una pregunta y abra solo esa. El texto completo de cada documento y esquema está disponible en un segundo archivo para las herramientas que necesiten todo el conjunto de una vez.

Actívalo en tu blockstudio.json:

JSON
{
  "ai": {
    "enableContextGeneration": true
  }
}

El índice ya está disponible en your-site.com/blockstudio-llm.txt y el texto completo, en your-site.com/blockstudio-llm-full.txt. Indica a tu herramienta de IA que use el índice y podrá acceder a toda la documentación de Blockstudio API sin instrucciones adicionales. Consulta la documentación de integración con IA para ver la configuración específica de cada herramienta.

Así ya no necesitas escribir instrucciones específicas del framework. Con acceso a blockstudio-llm.txt, un agente puede averiguar cómo crear bloques, definir campos, escribir plantillas, configurar Tailwind, preparar páginas y usar todos los hooks que ofrece Blockstudio.

Archivos de contexto específicos del proyecto

La mayoría de los agentes de programación con IA también leen un archivo de contexto del proyecto con instrucciones específicas para tu código base. La convención depende de la herramienta:

Archivo Herramienta
CLAUDE.md Claude Code
AGENTS.md Codex CLI, Gemini CLI, Copilot CLI y otras
.cursor/rules/*.mdc Cursor
.github/copilot-instructions.md GitHub Copilot

Como blockstudio-llm.txt ya cubre el framework, el archivo de contexto de tu proyecto solo debe describir lo que lo hace único: estructura de directorios, convenciones de nombres, comandos y límites.

Si instalas blockstudio/phpstan, no tienes que redactar esa descripción a mano. vendor/bin/blockstudio-agents genera un AGENTS.md a partir de tu blockstudio.json y tus propios archivos, donde indica qué crea el proyecto, qué funciones están activadas, qué rechazará el análisis y qué comandos se aplican. No sobrescribe archivos que no haya creado y conserva tus notas al volver a generarlo.

Markdown
# My WordPress Site

Built with Blockstudio 7. File-based blocks with Tailwind CSS.

Fetch https://example.com/blockstudio-llm.txt for full framework docs.

## Structure

- `blockstudio/` - Custom blocks (block.json + index.php)
- `pages/` - File-based pages (page.json + index.php)
- `patterns/` - Block patterns (pattern.json + index.php)
- `blockstudio.json` - Plugin settings

## Conventions

- Use Tailwind utility classes for all styling
- Keep blocks small and focused: one component per block
- Use `$a['fieldId']` to access field values in templates

## Commands

- `wp server` - Start local development server

Herramientas de desarrollo para flujos de trabajo con IA

Blockstudio incluye dos herramientas de desarrollo diseñadas específicamente para el desarrollo asistido por IA.

Canvas

El canvas ofrece una vista general de todas tus páginas de Blockstudio, similar a Figma, representadas como mesas de trabajo en iframes activos en una sola vista. Desplázate con el panel táctil y amplía o reduce con el gesto de pellizcar o Ctrl+scroll.

Resulta útil al trabajar con agentes de IA porque ofrece una vista general de cada página sin cambiar de pestaña ni recorrer el panel de administración de WordPress. Cuando un agente modifica una plantilla de página, puedes ver el resultado de inmediato. Activa el modo en vivo para que el canvas se actualice automáticamente al cambiar los archivos.

Actívalo en blockstudio.json:

JSON
{
  "dev": {
    "canvas": {
      "enabled": true,
      "adminBar": false
    }
  }
}

Después, ve a /wp-admin/admin.php?page=blockstudio-canvas. Alterna entre la vista de páginas (mesas de trabajo a todo lo ancho) y la vista de bloques (cuadrícula con todos los bloques registrados y sus valores predeterminados).

Capturador de elementos

El capturador de elementos resuelve un problema habitual en los flujos de trabajo con IA: indicar al agente qué archivo muestra un elemento específico de la página.

Añade ?blockstudio-devtools a cualquier URL del frontend y, a continuación, mantén pulsadas Cmd+C (Mac) o Ctrl+C (Windows) durante 100ms. Se activa un selector en forma de punto de mira que resalta los bloques Blockstudio al pasar el cursor por encima. Haz clic en un elemento para copiar su contexto al portapapeles:

Código
@<div>

<div class="my-block">
  Hello world
</div>
  in theme-name/blockstudio/blocks/my-block/index.php

Pega esto en tu herramienta de programación con IA y el agente sabrá de inmediato la ruta del archivo, la estructura de HTML y a qué elemento señalas. Ya no tendrás que buscar las rutas de los archivos de plantilla a mano.

Actívalo en blockstudio.json:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}

Patrones prácticos

Crear un solo bloque

El flujo más sencillo: describe lo que quieres y deja que el agente lo cree.

Instrucción:

Crea un bloque de testimonios con campos para la cita (área de texto), el nombre del autor (texto), su cargo (texto) y su foto (archivos). Usa Tailwind para los estilos. La cita debe aparecer en una fuente grande en cursiva, con unas comillas decorativas.

El agente creará:

Código
blockstudio/testimonial/
├── block.json
└── index.php

Crear una página completa

Las páginas basadas en archivos de Blockstudio permiten que un agente cree desde cero una página entera de WordPress en forma de plantilla. Aquí está la verdadera ventaja: en vez de crear los bloques uno por uno, el agente construye de una vez toda la estructura de la página con todos sus bloques.

Instrucción:

Crea una página «Acerca de» con una sección principal, una cuadrícula del equipo y un formulario de contacto de ejemplo. Usa los bloques existentes cuando sea posible y crea otros cuando hagan falta. Asígnala al ID de entrada 2. Bloquea la plantilla, pero permite editar el contenido de los encabezados y párrafos.

El agente crea:

Código
pages/about/
├── page.json     # postId: 2, templateLock: "all"
└── index.php     # Full block structure with core + custom blocks

Además, crea los bloques personalizados a los que hace referencia (e.g., blockstudio/team-member/). Ejecuta wp bs pages sync para crear la entrada de WordPress con el bloqueo de plantilla y los controles de edición. Toda la página queda bajo control de versiones y es reproducible.

Crear un sitio completo

Aquí es donde la arquitectura de Blockstudio realmente destaca. Una sola instrucción puede generar un sitio entero porque cada elemento es un archivo:

Instrucción:

Crea un sitio web de portafolio con estas páginas: Inicio, Trabajos, Acerca de y Contacto. Crea bloques personalizados para la sección principal, la cuadrícula de proyectos, las tarjetas de proyectos, los miembros del equipo, la información de contacto y el pie de página. Usa un tema oscuro con Tailwind. Configura Tailwind en blockstudio.json con una paleta de colores personalizada.

El agente crea los directorios de bloques, las plantillas de página, un blockstudio.json con configuración de Tailwind y, de forma opcional, patrones para secciones reutilizables. Todo se confirma en git como un único conjunto de cambios.

Flujos de trabajo con agentes en paralelo

Algunas herramientas (la aplicación de escritorio de Codex, GitHub Copilot CLI y Kilo Code) permiten ejecutar varios agentes en paralelo. La arquitectura de Blockstudio, con un archivo por bloque, hace que sea seguro:

  • Agente 1: crea el bloque principal y la página de inicio
  • Agente 2: crea el bloque de tarjetas de proyectos y la página de trabajos
  • Agente 3: crea el bloque del formulario de contacto y la página de contacto

Como cada bloque tiene su propio directorio y los estilos de Tailwind están junto a las plantillas, estos agentes no entrarán en conflicto. El único archivo compartido es blockstudio.json, que normalmente solo hay que configurar una vez al principio.

Consejos para obtener mejores resultados

  1. Haz referencia al archivo de contexto del LLM. Los agentes producen código de Blockstudio mucho mejor cuando pueden acceder a la documentación del framework. Indícales siempre blockstudio-llm.txt y dales un AGENTS.md generado para el proyecto.

  2. Especifica los tipos de campo. En vez de decir «añade un campo de imagen», di «añade un campo de archivos con allowedTypes: ['image'] y returnFormat: 'object'». Cuanto más precisas sean las definiciones de los campos, menos iteraciones harán falta.

  3. Empieza con un bloque y luego amplía. Pide al agente que cree bien un bloque, revisa sus patrones y después encárgale el resto siguiendo las mismas convenciones. Así tendrá una referencia que mejorará los resultados siguientes.

  4. Revisa el resultado. La programación por intuición no significa aceptar el código a ciegas. Comprueba que los tipos de campo se ajusten a lo que necesitas, que las plantillas se muestren correctamente y que las clases de Tailwind produzcan el resultado visual esperado. El código generado por IA debe revisarse antes de publicarlo.

  5. Usa esquemas de block.json. Blockstudio ofrece un esquema de JSON en https://blockstudio.dev/schema/block. Añade "$schema" a tu block.json para que los agentes reciban comentarios de validación y evitar configuraciones mal formadas.

  6. Mantén los bloques pequeños y enfocados. Un bloque por componente visual. Así, el agente puede razonar sobre cada bloque con más facilidad y las plantillas son lo bastante breves para caber en una sola pasada de la ventana de contexto.