¿Qué hace ai-coding-ironrules?
Plantilla CLAUDE.md con 11 reglas de hierro operacionales para codificación con IA, reutilizable en todos los proyectos.
Reglas de hierro para codificación con IA
Estas reglas establecen pautas estrictas para el comportamiento del agente de IA al interactuar con el código fuente. Cada regla está diseñada para prevenir errores comunes y garantizar la integridad del proyecto.
1. No modificar archivos sin permiso explícito
El agente no debe modificar, eliminar ni sobrescribir archivos a menos que el usuario lo solicite directamente o dé una instrucción clara.
2. Validar cambios antes de aplicarlos
Antes de realizar cualquier cambio, el agente debe mostrar un resumen de las modificaciones propuestas y solicitar confirmación.
3. Preservar el estilo de código existente
El agente debe seguir el estilo de código, las convenciones de nomenclatura y la estructura del proyecto ya establecidos.
4. No eliminar código sin explicación
Cualquier eliminación de código debe ir acompañada de una justificación clara y, si es posible, una sugerencia de alternativa.
5. Mantener compatibilidad hacia atrás
Los cambios no deben romper funcionalidades existentes a menos que se indique explícitamente lo contrario.
6. Documentar cambios significativos
Para cualquier cambio que afecte la lógica de negocio, la API o la estructura de datos, se debe actualizar la documentación correspondiente.
7. No introducir dependencias innecesarias
El agente no debe agregar nuevas bibliotecas o paquetes sin justificación y aprobación del usuario.
8. Ejecutar pruebas antes y después
Cuando sea posible, el agente debe ejecutar la suite de pruebas existente antes y después de los cambios para verificar que no se introduzcan regresiones.
9. Priorizar la legibilidad del código
El agente debe priorizar código claro y mantenible sobre soluciones excesivamente optimizadas o crípticas.
10. No sobrescribir configuraciones del proyecto
Las configuraciones existentes (como .gitignore, tsconfig.json, package.json) no deben modificarse sin consulta previa.
11. Reportar problemas de seguridad
Si el agente detecta posibles vulnerabilidades de seguridad, debe informarlas al usuario de inmediato y no explotarlas.
Cómo usar
- Copia este archivo como
CLAUDE.mden la raíz de tu proyecto. - Personaliza las reglas según las necesidades específicas de tu equipo.
- El agente de IA (como Claude Code) leerá automáticamente estas reglas y las aplicará durante las sesiones de codificación.
Contribuciones
Si deseas sugerir reglas adicionales o mejoras, abre un issue o envía un pull request al repositorio original.
Nota: Este skill es independiente del lenguaje o framework. Funciona con cualquier proyecto que utilice Claude Code u otros asistentes compatibles con el formato CLAUDE.md.