name: coding-guidelines
description: Principios para escribir codigo de calidad con LLMs. Aplica a cualquier tarea de desarrollo.
triggers:
- escribir codigo
- refactorizar
- coding principles
- guidelines
- buenas practicas
- code quality

Coding Guidelines

Principios core para trabajar con LLMs en tareas de desarrollo.

4 Principios

1. Pensa Antes de Codear

NO empezar a escribir codigo inmediatamente.

• Surfacea assumptions antes de implementar
• Pregunta sobre preferencias: estructuras de datos, patrones, librerias
• Presenta multiples opciones con trade-offs
• Confirma alineamiento antes de codear

2. Simplicidad Primero

El codigo mas simple que resuelve el problema.

• KISS, DRY, YAGNI siempre
• Sin abstracciones especulativas ("por si algun dia...")
• Sin features no pedidas
• Sin over-engineering: 3 lineas similares > abstraccion prematura

3. Cambios Quirurgicos

Editar lo minimo necesario.

• Matchear patterns existentes del codebase
• No refactorizar codigo que no toca la feature
• No agregar docstrings/comments donde no habia
• No cambiar estilo/formato de codigo existente

4. Objetivos Verificables

Criterios claros para saber cuando esta listo.

• Definir que significa "funciona"
• Tests que validen el comportamiento esperado
• Checkear lint, types, build antes de terminar

Aplicacion por Lenguaje

Ver referencias para reglas especificas:

• references/typescript.md - TypeScript strict mode, testing, estructura
• references/python.md - Type hints, mypy, pytest, ruff

Anti-patrones

• Saltar a codear sin discutir approach
• Agregar features "por las dudas"
• Refactorizar mientras implementas otra cosa
• Asumir en vez de preguntar
• No correr validaciones antes de terminar