Gate de revisión antes del commit con Claude Code

Cuanto más rápido escribe Claude Code, más importan los últimos diez minutos. Antes del commit no necesitas ánimo. Necesitas un gate que detecte diffs rotos, tests faltantes, CTAs malos y cambios ajenos.

Por qué importa este patrón

Un review gate no es una ceremonia. Es el punto donde decides si el commit puede pasar. En artículos y landing pages, build verde no basta. URL pública, canonical, h1, PDF gratis, Gumroad y consultoría afectan la ruta de ingresos.

Leer también: Leer también 1, Leer también 2, Leer también 3.

Flujo práctico

Fija alcance con git status y git diff —stat. Pasa el diff a Claude Code y exige findings primero. Después de corregir, ejecuta build. Si cambia contenido, revisa h1 y CTA en URL pública o preview. Stagea solo archivos del objetivo.

Kit mínimo para copiar

git status --short
git diff --stat
git diff -- src tests
npm.cmd run build

Review this diff before commit.
Prioritize bugs, regressions, missing tests, broken CTAs, and risky commands.
Return findings first.
For each finding include severity, file evidence, user impact, and smallest fix.
If there are no findings, list what remains unverified.

review_gate:
  must_check:
    - build_result
    - changed_files
    - public_url_when_content_changes
    - revenue_cta_links
  block_commit_if:
    - failing_build
    - untranslated_body
    - fallback_page
    - unrelated_diff

Ejemplos reales

Si cambia una CTA, revisa enlaces Gumroad y consultoría como puntos obligatorios.
Si solo querías añadir tests, verifica que config y lockfiles no entraron por accidente.
En artículos localizados, revisa cuerpo inicial y CTA, no solo frontmatter.

Checklist operativo

Este patrón está pensado para repetirse durante trabajo real con Claude Code. Si cambias un artículo, una página de producto o una ruta de consulta, usa esta lista como control compacto.

Escribe el objetivo en una frase y nombra archivos o funciones fuera de alcance.
Separa los archivos que Claude Code debe leer de los que debe evitar.
Deja al menos un comando de prueba. En contenido, revisa URL pública además del build.
Comprueba que PDF gratis, Gumroad y consultoría coinciden en cuerpo y CTA final.
En posts localizados, confirma title, h1, inicio del cuerpo y CTA en el idioma correcto.
No stagees archivos sucios ajenos. Divide el diff otra vez antes del commit si hace falta.
Registra riesgo restante y próxima métrica para que la siguiente sesión empiece clara.

A qué oferta debe conducir

Si el lector aún no domina comandos, la primera salida es el cheatsheet gratuito. Si el flujo se repite cada semana, Prompt Templates ayuda a estandarizar revisión, debugging y edición de artículos. Si el bloqueo está en permisos, CLAUDE.md, hooks, MCP o CI/CD, la mejor ruta self-service es Setup Guide. Si el equipo necesita diseñar ownership, verificación pública y ruta de ingresos, la salida debe ser consultoría.

Qué dejar en el handoff

El trabajo con Claude Code no termina cuando el patch parece listo. Termina cuando la siguiente persona entiende la decisión sin repetir toda la sesión. El handoff debe incluir alcance cambiado, motivo del alcance, comandos de prueba, URL pública, destino de CTA y riesgo restante. En contenido, añade heroImage, enlaces internos, enlaces externos, revisión de idioma y si PDF gratis, Gumroad y consultoría siguen en el cuerpo. En páginas cercanas a producto, separa qué lector solo necesita el recurso gratis, qué lector debe comprar una guía y qué lector necesita ayuda.

Números a mirar después

PV no es la única métrica. Tras publicar, mira indexación, países, clics cerca de la CTA final, clics a Gumroad y visitas al formulario. En un artículo popular ya existente, compara rebote y movimiento a siguiente página antes y después. Si la siguiente sesión de Claude Code recibe esos números primero, decidirá por ruta de ingresos, no solo por volumen de texto.

Casos de fallo

Pedir una revisión genérica suele producir elogios en vez de riesgos.
Saltar build antes de commit oculta errores MDX, imports y enlaces rotos.
Stagear archivos ajenos complica la depuración posterior.

Ruta hacia PDF gratis, Gumroad y consultoría

Empieza con el PDF gratuito para dominar comandos. Pasa a Gumroad cuando el flujo se repita, y usa consultoría cuando permisos, equipo o ingresos requieran diseño.

Nota de verificación

El artículo enlaza material de revisión existente e incluye prompt, comandos PowerShell y gate YAML. La ruta de ingresos separa PDF gratis, Prompt Templates, Setup Guide y consultoría.