coding-guidelines
Deep-dive con ejemplos concretos y anti-patrones de over-engineering, scope creep y scope vago. Los principios core (Simplicity First, Surgical Changes, Goal-Driven Execution) viven en ~/.claude/CLAUDE.md global y aplican siempre — este skill es el complemento cargable con casos de uso reales. Inspirado en las observaciones de Andrej Karpathy.
Cuando se activa
Al empezar tareas de codear cuando el pedido es vago o hay riesgo de over-engineering:
| Frases que activan el skill |
|---|
| “agrega X”, “implementa Y” |
| “arregla el bug” |
| “refactoriza este archivo” |
| “modifica esta funcion” |
| “mejora el codigo” |
| “hace un code review” |
Principios core (viven en CLAUDE.md global)
Este skill NO redefine los principios — los extiende con ejemplos. Resumen de referencia:
| Principio | Regla de una linea |
|---|---|
| Simplicity First | Minimo codigo que resuelve el problema. Si 200 lineas podrian ser 50, reescribi |
| Surgical Changes | Cada linea cambiada debe trazarse al pedido. No refactores de paso |
| Goal-Driven Execution | Transforma tareas vagas en objetivos verificables antes de codear |
Ejemplo: Usuario pide agregar feature
MAL (sin consultar):
import winston from 'winston';
const logger = winston.createLogger({...});
BIEN (consultar primero):
Antes de agregar logging, necesito entender:
1. Que libreria prefieren?
2. A donde van los logs?
3. Hay un formato estandar en el proyecto?
Anti-patrones
| Anti-Pattern | Problema | Violacion |
|---|---|---|
| Saltar a codear sin discutir | Se asumen decisiones que el usuario no pidio | Pensar antes de codear |
| Agregar features “por las dudas” | Codigo extra sin valor | Simplicity First |
| Refactorizar de paso | PR con cambios mezclados, dificil de revisar | Surgical Changes |
| Over-engineering | Patron Observer para un boolean | Simplicity First |
| Asumir en vez de investigar | Se reescribe codigo cuando el bug era un typo | Goal-Driven Execution |
| Tarea vaga sin test primero | Se toca codigo random sin criterio de “listo” | Goal-Driven Execution |
Reglas por lenguaje
El skill incluye referencias para reglas especificas:
references/typescript.md- TypeScript strict mode, testing, estructurareferences/python.md- Type hints, mypy, pytest, ruffreferences/karpathy-original.md- Fuente vendorizada de Karpathy