Kit de arranque: tu proyecto listo para trabajar con Claude Code

Llegamos a 2.000 personas aprendiendo a dirigir la IA, y quería regalarte algo que de verdad uso. Esto es lo que hago cada vez que empiezo un proyecto, antes de pedirle a Claude la primera línea de código. Son tres piezas y te toman unos diez minutos.

La idea de fondo es simple. Claude escribe rápido, pero no recuerda lo que le dijiste ayer y no revisa su propio trabajo si nadie se lo pide. El kit se encarga de las dos cosas: deja las reglas escritas dentro del proyecto y pone controles que revisan cada cambio por ti.

1. El comando: controles en cada commit

Desde la carpeta raíz de tu proyecto (JavaScript o TypeScript, con Node 20 o más):

npx devground-init --yes

Eso instala devground, que es un proyecto mío, gratis y de código abierto. Te deja:

• Tests listos con Vitest, y un mínimo de cobertura que sube cada vez que corres test:coverage. Si la IA borra tests sin avisar, el chequeo falla.
• Linters y formato con ESLint y Prettier, que corren solo sobre los archivos que cambiaste.
• Hooks de git: antes de cada commit se revisa el código, y el mensaje tiene que decir qué tipo de cambio es (feat:, fix:, docs:).
• Reglas para la IA en un archivo AGENTS.md, enlazado como CLAUDE.md para Claude Code y con los nombres que buscan Cursor, Copilot, Gemini y Codex.

Para comprobar que quedó, haz un cambio e intenta guardarlo con git commit -am "arreglos". Lo tiene que rechazar. Con git commit -am "fix: corrige el botón" tiene que pasar.

Si quieres el detalle de cada herramienta, está en la guía de devground para vibe coders.

2. Las reglas de trabajo para tu AGENTS.md

devground te deja un AGENTS.md con buenas prácticas generales. Yo le agrego siempre estas cuatro reglas, que son las mismas que tiene el proyecto de este sitio. Abre el archivo y pégalas al final:

Cómo trabajamos

1. Piensa antes de programar. Si el pedido se puede entender de dos formas, muéstrame las dos y pregúntame. Si hay una forma más simple de hacerlo, dímelo.
2. Lo mínimo que resuelve el problema. Nada de funciones que no pedí, ni abstracciones para algo que se usa una vez.
3. Cambios quirúrgicos. Toca solo lo que el pedido necesita. Si ves código muerto o algo raro en otro archivo, avísame, pero no lo cambies.
4. Primero el test. Antes de escribir el código, escribe el test que define qué tiene que pasar, córrelo y muéstrame que falla. Después implementa hasta que pase.

No des una tarea por terminada sin correr los tests.

La cuarta es la que más cambia el resultado. Cuando Claude escribe primero el test, tiene que decidir qué significa "funciona" antes de programar, y tú tienes una forma de comprobarlo que no depende de creerle.

3. El prompt de arranque para cada cambio

Cada vez que vas a pedir algo nuevo, en vez de describir el código, describe el resultado y deja que Claude arme el plan contigo:

Quiero [describe lo que quieres que pase, en palabras de usuario].

Antes de escribir código:

1. Lee el AGENTS.md y los archivos que vas a tocar.
2. Dime en pocas líneas qué entendiste, qué archivos cambiarías y qué podría romperse.
3. Escribe los tests que demuestran que funciona y muéstrame que fallan.

Espera mi visto bueno antes de implementar.

Ese "espera mi visto bueno" es tu momento de dirigir. Lees el plan en un minuto, corriges lo que no calza, y recién ahí Claude programa. Es mucho más barato corregir un plan de diez líneas que deshacer cuarenta archivos.

Antes de seguir programando

• Corriste npx devground-init --yes en la raíz del proyecto.
• Un commit con el mensaje "arreglos" se rechaza.
• Tu AGENTS.md tiene las cuatro reglas de trabajo.
• Guardaste el prompt de arranque donde lo tengas a mano.

Con eso, cada cambio que haga la IA pasa por tests, lint y tu visto bueno antes de llegar a tu proyecto.