Claude Code Harness Lite: una barandilla pequeña para cambios seguros

El primer error al usar Claude Code en un repositorio real no suele ser un prompt malo. Es dejar que el agente toque demasiado antes de definir un marco. Harness Lite es ese marco mínimo: leer, editar, probar, abrir la URL pública y revisar el CTA de ingresos.

Esta es la versión inicial de Claude Code harness engineering. Cuando el repositorio es nuevo, combínala con repo map first pass y permission receipt pattern para que el alcance sea fácil de explicar.

Escribe el límite antes de la tarea

Harness Lite no debilita a Claude Code. Hace que el cambio sea explicable. Antes de pedir una modificación, define qué archivos puede leer, qué archivos puede editar, qué áreas quedan fuera, qué comando prueba el resultado y qué página pública se debe inspeccionar después.

En un sitio de contenido o productos, este orden importa mucho. El artículo, el formulario del PDF gratis, el enlace de Gumroad y la consulta suelen estar cerca. Un cambio pequeño de texto puede romper el camino entre búsqueda, registro, compra y contacto.

harness_lite:
  owner: "Masa"
  scope:
    allowed:
      - "read repository"
      - "edit selected files"
      - "run build or test"
    blocked:
      - "delete unrelated files"
      - "touch secrets"
      - "hide failed verification"
  proof:
    - "git diff reviewed"
    - "build command recorded"
    - "public URL opened"
    - "CTA path checked"

Prompt inicial copiable

Quiero hacer exactamente un cambio pequeño y seguro en este repositorio.
No edites archivos todavía.
Devuelve:
1. archivos que necesitas leer
2. archivos seguros para editar
3. áreas que deben quedar fuera de alcance
4. el comando de prueba más pequeño
5. checks de URL pública para h1, canonical, hero image y CTA
6. notas para preservar PDF gratis, Gumroad y consulta

El movimiento clave es pedir un límite, no una implementación. Cuando el límite está claro, la siguiente petición puede ser estrecha: un cambio, un comando de prueba y un recibo.

Convierte la prueba en un objeto pequeño

Después del cambio, pide a Claude Code que rellene un proof receipt. El JavaScript de abajo es simple a propósito: vuelve visible la definición mínima de terminado antes del commit.

const proof = {
  goal: "change one small thing",
  filesChanged: 2,
  commands: ["npm run build"],
  publicUrlChecked: true,
  ctaChecked: true,
};

export function isReadyToCommit(receipt) {
  return receipt.filesChanged <= 3 &&
    receipt.commands.length > 0 &&
    receipt.publicUrlChecked &&
    receipt.ctaChecked;
}

console.log(isReadyToCommit(proof)); // true significa que pasó la puerta mínima de commit

Así detectas estados a medio terminar: build aprobado sin abrir la URL pública, página con 200 OK pero artículo incorrecto, cuerpo correcto con CTA de Gumroad o consulta apuntando al lugar equivocado.

Tres casos reales

• En un artículo Astro, limita el alcance a un MDX, una imagen hero y una página de producto relacionada. Tras el deploy revisa h1, inicio del texto, canonical, formulario PDF, botón Gumroad y enlace de consulta.
• En un arreglo React pequeño, limita el alcance al componente, una prueba cercana y una captura o Storybook. Deja auth, billing, secretos y migraciones fuera del primer paso.
• En adopción de equipo, escribe en CLAUDE.md comandos seguros, zonas protegidas, formato de recibo y nota de rollback. La siguiente persona no empieza desde cero.

Fallos frecuentes

El fallo común es decir “revisa y arregla todo”. Claude Code intenta ayudar, el diff crece y la prueba se vuelve vaga. Otro fallo es tratar el build local como publicación. Una ruta pública puede devolver HTTP 200 y aun así mostrar una página fallback o un artículo viejo.

La ruta de ingresos también falla. El cuerpo recomienda el PDF gratis pero el CTA final envía a otro producto. El artículo multilingüe no explica que Gumroad hoy es sobre todo el camino en inglés. Existe un enlace de consulta, pero no dice cuándo una llamada es mejor que una guía. Harness Lite mantiene esas revisiones dentro de la tarea.

PDF gratis, Gumroad y consulta

Usa el free cheatsheet si todavía estás aprendiendo comandos y hábitos seguros. Usa 50 Prompt Templates si repites prompts de review, debugging y refactor. Usa la Setup Guide si el cuello de botella son permisos, CLAUDE.md, hooks, MCP o CI/CD. Usa consulta cuando el diseño de flujo, equipo o ingresos requiera criterio.

Qué se verificó en este artículo

Este artículo incluye objeto de prueba ejecutable, enlaces internos al harness, mapa de repositorio y recibo de permisos, además de la ruta PDF gratis, Gumroad y consulta. Los próximos números son inicios de PDF, clics Gumroad y visitas de consulta desde este slug.

Nota operativa tras publicar

Al usar este patrón en producción, no termines en “el archivo existe”. El trabajo termina cuando la URL pública permite al lector elegir el siguiente paso. En ancho móvil revisa h1, inicio del cuerpo, hero image, formulario de PDF gratis, enlaces Gumroad y enlace de consulta. Si el cuerpo está bien pero el CTA final apunta al producto equivocado, la ruta de ingresos sigue incompleta.

En artículos localizados, el mismo slug no basta. Revisa inicio del cuerpo y CTA en japonés, inglés, chino, coreano, español, francés, alemán, portugués, hindi e indonesio. Un título traducido con cuerpo o CTA en inglés es una localización fallida porque el lector no puede confiar en el siguiente paso.

Para la siguiente mejora, mira más que PV. Pon en el mismo brief inicios de registro PDF, clics Gumroad, visitas a Products, visitas a Training, mezcla de países y fuente de búsqueda. Claude Code decide mejor cuando el dato muestra si conviene reforzar el activo gratis, Prompt Templates, Setup Guide o consulta.