# Karpathy-inspired guidelines: acota y comprueba el trabajo del agente

> Haz explícitos los supuestos, reduce cambios ajenos a la tarea y define qué evidencia demuestra que una corrección está terminada.

Verificado el 26 oct 2026.

## Qué es

Este proyecto comunitario convierte observaciones de Andrej Karpathy sobre agentes de programación en instrucciones de trabajo. No es una publicación oficial de Karpathy: el repositorio se presenta como inspirado en sus observaciones.

## Para qué te sirve

- Cuando el agente interpreta una petición ambigua sin declarar sus supuestos.
- Cuando una corrección pequeña termina mezclada con refactorizaciones innecesarias.
- Cuando quieres definir una comprobación concreta antes de encargar un cambio.

## Cómo funciona

Las instrucciones agrupan criterios de razonamiento previo, simplicidad, alcance y ejecución con objetivos verificables. Se pueden incorporar a las reglas del proyecto o instalar como plugin de Claude Code. También hay una regla para Cursor y documentación específica de esa integración.

La idea práctica es transformar una petición en un resultado observable: reproducir el fallo, corregirlo y mostrar que la comprobación ahora pasa. Son instrucciones al modelo, no un motor que imponga esas condiciones por sí mismo.

## Antes de empezar

Revisa el archivo de instrucciones existente antes de incorporar nuevas reglas. El README conserva comandos del nombre anterior `forrestchang/andrej-karpathy-skills`, que GitHub redirige al repositorio actual. GitHub no detecta SPDX aunque el README declara MIT; no atribuyas una detección automática que no existe.

## Límites y alternativas

No todos los cambios necesitan el mismo rigor. El propio autor señala el coste de aplicar cautela excesiva a tareas triviales. Reglas similares ya pueden existir en tu proyecto: integra el contenido útil sin duplicar políticas contradictorias.

## Recursos

- [Repositorio y README](https://github.com/multica-ai/andrej-karpathy-skills) - 224605 estrellas; GitHub no detecta licencia.
