agent-rules-books: los clásicos del software como reglas para el agente
El agente escribe código que funciona, pero tiende a crear abstracciones superficiales, mezclar capas y refactorizar a la vez que añade funciones. Este repositorio ofrece 14 juegos de reglas basados en libros conocidos de diseño, arquitectura, DDD y código heredado, cada uno en tres tamaños: mini para el día a día, nano para contextos justos y full como referencia completa.
Reglas de Clean Code y Code Complete sobre nombres, funciones cortas, responsabilidades, programación defensiva y tests.
Juegos de arquitectura: Clean Architecture, Patterns of Enterprise Application Architecture y tres libros sobre diseño guiado por el dominio.
Código heredado según Michael Feathers: tests de caracterización, costuras, ruptura de dependencias, sprout method y wrap method.
El juego release-it, basado en Michael Nygard, trata timeouts, reintentos, circuit breakers, bulkheads y observabilidad.
Cada SKILL.md carga por defecto la versión mini y deja la full a mano como material de consulta.
Cuándo usarla
Antes de una refactorización grande, cuando el agente debe avanzar a pasos cortos sin cambiar el comportamiento.
Un proyecto con DDD donde el agente debe pensar en bounded contexts y agregados, no en tablas ni DTO.
La revisión de un servicio con colas y API externas, donde timeouts y reintentos marcan la estabilidad.
Pídale al agente
Refactoriza el módulo billing con las reglas de refactoring: pasos cortos y tests tras cada uno
Revisa este servicio con las reglas de release-it y marca las llamadas sin timeout ni límite de reintentos
Divide la clase heredada OrderManager, pero antes escribe tests de caracterización
Preguntas
¿Cómo se instala agent-rules-books?
Todos los juegos con npx skills add ciembor/agent-rules-books --all, o uno solo con --skill y su nombre, por ejemplo --skill refactoring. Con --list ves la lista sin instalar nada.
¿Funciona agent-rules-books en Cursor y Codex?
Sí. Las reglas son Markdown neutro para AGENTS.md o skills, y docs/USAGE.md explica la configuración para Codex, Claude Code y Cursor.
¿Qué diferencia hay entre mini, nano y full?
full es el texto canónico completo, mini es la versión recomendada y más corta para tareas reales, y nano es la reserva compacta para contextos muy limitados.
