Cómo se hace este sitio

Todo lo que ves aquí, los textos, el código y esta misma página, se crea con ayuda de IA. Pero la IA no decide sola: cada cambio nace de un debate conmigo y nada se publica sin mi consentimiento explícito.

"Revisado y validado por mí" significa exactamente eso: lo reviso yo, sin revisión de terceros ni ningún sello externo. Lo que publico aquí son opiniones y comentarios personales.

La solución, de un vistazo

Quién interviene y cómo llega el contenido desde el debate hasta tu navegador.

Esquema de arquitectura de este sitio El autor debate con los agentes de IA (Claude Code y Codex) y toma las decisiones. Los agentes generan en el repositorio público de GitHub los artefactos de OpenSpec (openspec/: propuesta, diseño, especificaciones y tareas, con la evidencia y los consentimientos) y el código y los textos del sitio (src/: Astro y MDX). El autor revisa, aprueba e integra: cada cambio va en una rama feat/*, pasa por una pull request y el autor hace el merge a main. El push a main lanza el build en GitHub Actions, que despliega en GitHub Pages el HTML estático que recibe el visitante en pablomeleroalonso.me. OpenSpec ordena el trabajo en cuatro fases: debate, acuerdo, construcción y publicación. AUTOR decide y valida AGENTES DE IA Claude Code · Codex debate decisiones revisa, aprueba y hace merge genera artefactos, código y texto REPOSITORIO GITHUB (PÚBLICO) openspec/ proposal · design · specs · tasks evidencia y consentimientos src/ Astro + MDX páginas y posts rama feat/* → pull request → main push a main GITHUB ACTIONS build de Astro GITHUB PAGES HTML estático VISITANTE pablomeleroalonso.me OPENSPEC ordena el trabajo 01 debate → 02 acuerdo → 03 construcción → 04 publicación Esquema de arquitectura de este sitio El autor debate con los agentes de IA (Claude Code y Codex) y toma las decisiones. Los agentes generan en el repositorio público de GitHub los artefactos de OpenSpec (openspec/: propuesta, diseño, especificaciones y tareas, con la evidencia y los consentimientos) y el código y los textos del sitio (src/: Astro y MDX). El autor revisa, aprueba e integra: cada cambio va en una rama feat/*, pasa por una pull request y el autor hace el merge a main. El push a main lanza el build en GitHub Actions, que despliega en GitHub Pages el HTML estático que recibe el visitante en pablomeleroalonso.me. OpenSpec ordena el trabajo en cuatro fases: debate, acuerdo, construcción y publicación. AUTOR decide y valida debate · decisiones AGENTES DE IA Claude Code · Codex genera artefactos, código y texto revisa, aprueba y hace merge REPOSITORIO GITHUB openspec/ proposal · design · specs · tasks src/ Astro + MDX feat/* → pull request → main push a main GITHUB ACTIONS build de Astro GITHUB PAGES HTML estático VISITANTE pablomeleroalonso.me OPENSPEC ordena el trabajo 01 debate → 02 acuerdo 03 construcción → 04 publicación

El flujo, en cuatro fases

En cada fase la IA propone y yo decido. Nada pasa a la siguiente sin mi visto bueno.

  1. Debate

    La IA

    Pregunta, revisa el repositorio y el contenido que ya existe, y propone opciones con una recomendación razonada.

    Yo

    Elijo, corrijo o descarto. Decido qué entra y qué se queda fuera.

  2. Acuerdo

    La IA

    Redacta lo debatido: la propuesta, el diseño, las especificaciones que el resultado debe cumplir y las tareas con su forma de verificarlas.

    Yo

    Reviso el alcance antes de que se construya nada.

  3. Construcción

    La IA

    Escribe el código o el texto y lo comprueba: build, validación de las especificaciones, accesibilidad, rendimiento y enlaces. Deja la evidencia anotada en cada tarea.

    Yo

    Reviso el resultado. Las fuentes y las cifras las valido yo: si algo no está respaldado, no se publica.

  4. Publicación

    La IA

    Me pregunta si publico. La pregunta y mi respuesta literal quedan registradas en el repositorio.

    Yo

    Doy o niego el consentimiento. La integración final en la rama principal la hago siempre yo.

Cómo nace un artículo del blog

Lo anterior aplica a todo el sitio. Los artículos siguen el mismo flujo de OpenSpec, con una fase previa de debate editorial y reglas propias para lo que se publica.

  1. 01 skill blog-post

    Idea y debate

    La IA Me entrevista: qué tipo de post es (Opinión, Análisis, Guía o Recursos), reta la tesis con el mejor contraargumento y verifica cada dato antes de aceptarlo. No escribe nada.

    Yo Aporto la idea y elijo el tipo y el ángulo.

    Sale Tesis, evidencia y estructura acordadas

  2. 02 /opsx:propose

    Propuesta

    La IA Convierte lo debatido en un change: la propuesta, el diseño con la tesis y la estructura, y las tareas de redacción y verificación.

    Yo Reviso el alcance antes de escribir una sola línea.

    Sale Un change de OpenSpec para el artículo

  3. 03 /opsx:apply

    Redacción y verificación

    La IA Escribe el artículo, contrasta cada afirmación con su fuente, prueba los comandos de las guías en una máquina real y anota la evidencia en cada tarea.

    Yo Leo y pido ajustes de tono, estructura o recortes hasta que el texto dice lo que quiero decir.

    Sale El artículo terminado y verificado

  4. 04 /opsx:archive

    Publicación

    La IA Me pregunta si publico y registra la pregunta y mi respuesta literal. Sin consentimiento, el artículo se queda en borrador.

    Yo Doy o niego el consentimiento y hago el merge.

    Sale El artículo publicado en el blog

Reglas que se aplican a todos los artículos

  • Ningún dato, cita ni cifra sin una fuente comprobable.
  • La tesis se reta con su mejor contraargumento antes de escribirse.
  • Sin mi consentimiento explícito, no se publica.

¿Quieres comentar algo o compartir otro punto de vista? Escríbeme.