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
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.
- 01 Alejandro decide y aprueba
- 02 Agentes de IA Claude Code: proponen, especifican, programan y comprueban
- 03 Repositorio público en GitHub openspec/ (propuesta · specs · diseño · tareas) y src/ (Astro + Tailwind)
- 04 Rama feat/* → pull request un cambio de OpenSpec por PR
- 05 GitHub Actions tipos · build · OpenSpec · enlaces
- 06 Vista previa Cloudflare Pages, una URL por PR
- 07 Alejandro revisa y fusiona su merge es la aprobación
- 08 GitHub Actions despliega el mismo artefacto que se comprobó
- 09 Cloudflare Pages producción en CDN, con una release y sus notas
- 10 alejandroduenasreal.me en producción
Responsabilidad
Cuatro pasos, y quién
decide en cada uno.
-
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.
-
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.
-
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.
-
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.
# 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"
Se compila una vez y se despliega ese mismo artefacto.
Lo que se probó es lo que se publica.
Cada PR tiene su vista previa.
Una URL real, comentada en el PR.
Producción solo se toca al fusionar en
main.Y cada vez queda una release con sus notas.
Vuelta atrás
Si algo sale mal.
-
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. -
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.
-
01
Idea
Tipo (Guía, Opinión, Análisis o Caso), tesis y fuentes.
Sale: una propuesta
-
02
Propuesta
Un cambio de OpenSpec con la estructura y las fuentes.
Sale: el alcance aprobado
-
03
Redacción y verificación
Cada cifra con su fuente y cada comando probado.
Sale: la nota terminada
-
04
Publicación
Merge en una semana libre (una nota por semana).
Sale: la nota publicada
- ◆ Una nota por semana.
- ◆ Cifras con fuente.
- ◆ Nada de datos de clientes ni de empresas.
- ◆ Sin mi merge, no se publica.
Coste
Lo que cuesta.
0 €, más el dominio.
| Servicio | Plan | Coste |
|---|---|---|
| GitHub y Actions | Gratuito con repositorio público | 0 € |
| Cloudflare Pages | Gratuito (Direct Upload) | 0 € |
| Cloudflare DNS | Gratuito | 0 € |
| Dominio .me | Registrador | lo 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.