Saltar al contenido
alejandro dueñas

Transparencia

Cómo se hace esta web

Esta web la escribo y la programo con agentes de IA. Pero el circuito es el mismo que montaría en un equipo: nada llega a producción sin especificación, comprobaciones automáticas y mi aprobación. Aquí lo enseño con la propia web como ejemplo.

Commit desplegado
f815d9d
Build
20 de noviembre de 2026, 22:17 (UTC)
Ejecución de Actions
local
Estado del workflow
Estado del workflow ci-cd en GitHub Actions

El circuito

El circuito,
de un vistazo.

De la idea a producción en diez pasos. Los dos en amarillo son míos; el resto lo hacen agentes y máquinas.

  1. 01 Alejandro decide y aprueba
  2. 02 Agentes de IA Claude Code: proponen, especifican, programan y comprueban
  3. 03 Repositorio público en GitHub openspec/ (propuesta · specs · diseño · tareas) y src/ (Astro + Tailwind)
  4. 04 Rama feat/* → pull request un cambio de OpenSpec por PR
  5. 05 GitHub Actions tipos · build · OpenSpec · enlaces
  6. 06 Vista previa Cloudflare Pages, una URL por PR
  7. 07 Alejandro revisa y fusiona su merge es la aprobación
  8. 08 GitHub Actions despliega el mismo artefacto que se comprobó
  9. 09 Cloudflare Pages producción en CDN, con una release y sus notas
  10. 10 alejandroduenasreal.me en producción

Responsabilidad

Cuatro pasos, y quién
decide en cada uno.

  1. 01

    Proponer

    El agente

    Lee el repositorio y redacta el cambio de OpenSpec: propuesta, specs y tareas con su comprobación.

    Yo

    Decido el alcance y qué se queda fuera.

  2. 02

    Construir

    El agente

    Programa y deja evidencia en cada tarea.

    Yo

    Reviso el código y el texto; las cifras y las fuentes las valido yo.

  3. 03

    Comprobar

    El agente

    La CI no se salta: si algo falla, el PR no se puede fusionar.

    Yo

    Miro la vista previa en una URL real.

  4. 04

    Publicar

    El agente

    Nunca fusiona.

    Yo

    Mi merge es la aprobación y queda registrado en GitHub; el despliegue es automático.

Comprobaciones

Lo que comprueba
cada PR.

Si cualquiera falla, la protección de main impide fusionar. Con persona o con agente, igual.

Comprobación Qué evita Con qué
Tipos errores de TypeScript y props mal pasadas astro check
Build páginas rotas, esquemas del blog inválidos y dos notas la misma semana astro build + regla del blog
Especificaciones cambios sin spec o con specs mal formadas openspec validate --strict
Enlaces enlaces internos rotos lychee

El despliegue

El despliegue,
de verdad.

Este es el fichero real que publica la web, leído en el build: si cambia, esta página cambia con él.

.github/workflows/ci-cd.yml Ver en GitHub ↗
# Comprobar → desplegar (vista previa en un PR, producción en main) → release.
# Se compila una vez y se despliega ese mismo artefacto: lo que se probó es lo que se publica.
# Las acciones van fijadas por SHA (la versión, en el comentario).
name: ci-cd
on:
  pull_request:
  push:
    branches: [main]

permissions:
  contents: read

concurrency:
  group: ci-cd-${{ github.ref }}
  cancel-in-progress: true

jobs:
  comprobar:
    runs-on: ubuntu-latest
    env:
      OPENSPEC_TELEMETRY: '0'
      # Datos del despliegue que enseña la página «Cómo se hace»
      PUBLIC_COMMIT: ${{ github.event.pull_request.head.sha || github.sha }}
      PUBLIC_RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
    steps:
      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
      - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
        with:
          node-version-file: .node-version
          cache: npm
      - run: npm ci
      - name: Tipos (astro check)
        run: npx astro check
      - name: Build
        run: npm run build
      - name: Especificaciones (OpenSpec)
        run: npx -y @fission-ai/openspec@2.1.1 validate --all --strict --no-interactive
      - name: Enlaces internos
        uses: lycheeverse/lychee-action@e7477775783ea5526144ba13e8db5eec57747ce8 # v2.9.0
        with:
          args: --offline --no-progress --root-dir ${{ github.workspace }}/dist 'dist/**/*.html'
          fail: true
      - uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
        with:
          name: sitio
          path: dist
          retention-days: 7

  desplegar:
    needs: comprobar
    # Los PR de forks no tienen secretos: no se despliegan
    if: github.event_name == 'push' || github.event.pull_request.head.repo.full_name == github.repository
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
      deployments: write
    environment:
      name: ${{ github.event_name == 'push' && 'produccion' || 'vista-previa' }}
      url: ${{ github.event_name == 'push' && 'https://alejandroduenasreal.me' || steps.cf.outputs.deployment-url }}
    steps:
      - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
        with:
          name: sitio
          path: dist
      - name: Desplegar en Cloudflare Pages
        id: cf
        uses: cloudflare/wrangler-action@953926a2e2182532811c01a25e53647d93bf07c0 # v4.1.3
        with:
          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
          wranglerVersion: '4.166.0'
          command: >-
            pages deploy dist --project-name=alejandroduenasreal
            --branch=${{ github.head_ref || github.ref_name }}
            --commit-hash=${{ github.sha }}
      - name: Comentar la vista previa en el PR
        if: github.event_name == 'pull_request'
        env:
          GH_TOKEN: ${{ github.token }}
          PR: ${{ github.event.pull_request.number }}
          SHA: ${{ github.event.pull_request.head.sha }}
          ALIAS: ${{ steps.cf.outputs.pages-deployment-alias-url }}
          URL: ${{ steps.cf.outputs.deployment-url }}
        run: |
          cuerpo="Vista previa: ${ALIAS:-$URL} (commit ${SHA::7})"
          gh pr comment "$PR" --repo "$GITHUB_REPOSITORY" --body "$cuerpo" --edit-last \
            || gh pr comment "$PR" --repo "$GITHUB_REPOSITORY" --body "$cuerpo"

  release:
    needs: desplegar
    if: github.event_name == 'push'
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - name: Crear la release con notas generadas
        env:
          GH_TOKEN: ${{ github.token }}
        run: gh release create "v$(date -u +%Y.%m.%d)-${GITHUB_SHA::7}" --repo "$GITHUB_REPOSITORY" --generate-notes --target "$GITHUB_SHA"

Vuelta atrás

Si algo sale mal.

  1. Normal

    Revertir el PR

    git revert -m 1 <merge> en un PR nuevo. Al fusionarlo, el mismo circuito despliega la versión anterior, con sus comprobaciones.

  2. Urgente

    Rollback en Cloudflare

    Workers & Pages → Deployments → Rollback to this deployment sobre el último despliegue bueno. Tarda segundos y no necesita build.

Volver atrás es tan rutinario como desplegar.

El blog

Cómo nace
una nota del blog.

Las notas pasan por el mismo circuito que el código: propuesta, revisión y merge.

  1. 01

    Idea

    Tipo (Guía, Opinión, Análisis o Caso), tesis y fuentes.

    Sale: una propuesta

  2. 02

    Propuesta

    Un cambio de OpenSpec con la estructura y las fuentes.

    Sale: el alcance aprobado

  3. 03

    Redacción y verificación

    Cada cifra con su fuente y cada comando probado.

    Sale: la nota terminada

  4. 04

    Publicación

    Merge en una semana libre (una nota por semana).

    Sale: la nota publicada

Coste

Lo que cuesta.

0 €, más el dominio.

Servicio Plan Coste
GitHub y ActionsGratuito con repositorio público0 €
Cloudflare PagesGratuito (Direct Upload)0 €
Cloudflare DNSGratuito0 €
Dominio .meRegistradorlo que cobre al año

Por qué lo cuento

La prueba más pequeña que puedo enseñar entera.

Es lo mismo que hago con agentes en producción: especificar, comprobar, desplegar con vuelta atrás y medir. Esta web es la prueba más pequeña que puedo enseñar entera.

Hablemos →