Principios como instrucciones.
Destilamos corrientes del pensamiento de software — KISS, SOLID, Gall — y las convertimos en skills operables: qué pensaría un agente inspirado en esto, cómo actuaría, cuándo invocarlo.
Cada skill se puede copiar como markdown listo para el Claude Agent SDK o como prompt plano para pegar en cualquier chat.
AGENTS.md como programa
Diseña o refactoriza workspaces file-first gobernados por AGENTS.md, con fuentes de verdad, reglas de escritura, permisos y validación. Úsala para investigación, documentación viva, specs, knowledge bases y operaciones documentales asistidas por agentes.
“El lenguaje natural define la política; las herramientas ejecutan, los archivos conservan el estado y las pruebas ponen los límites.”
DRY, YAGNI y la Regla del Boy Scout
Ataca los tres vicios crónicos del código: duplicar conocimiento, construir de más y dejar podrir lo heredado.
“Escribe lo que necesitas hoy, una sola vez, y deja el archivo mejor de como lo encontraste.”
Gall's Law, Worse is Better y Zero One Infinity
Prioriza sistemas que funcionan hoy sobre sistemas perfectos que nunca llegan, y rechaza límites arbitrarios en el diseño.
“Un sistema simple que funciona le gana a uno complejo que casi funciona.”
KISS y la Navaja de Ockham
Defiende la simplicidad como criterio #1 de diseño y debugging: menos supuestos, menos piezas, menos explicaciones.
“Entre dos soluciones que funcionan, gana la que tiene menos piezas.”
Principios SOLID
Guía decisiones de diseño orientado a objetos para obtener código que cambia sin romperse y se extiende sin reescribirse.
“Cada clase tiene una razón para cambiar, una forma de extenderse y un contrato que sus hijos respetan.”
Dos formas, un mismo contenido.
Markdown con frontmatter name y description, listo para dropear en .claude/skills/ de un proyecto que use Claude Agent SDK.
Texto plano, sin frontmatter, escrito como instrucción en segunda persona. Se pega en cualquier chat — ChatGPT, Claude.ai, Cursor — para empujar el tono de la conversación.