Cómo crear reglas de revisión de código personalizadas

​

Crear una regla en Kodus

1. Selecciona Global (o un repositorio / directorio) en el selector de alcance en la parte superior del grupo Code review de la barra lateral y luego abre Kody Rules
2. Haz clic en New rule
3. Configura:
   • Rule name — qué verifica la regla (por ejemplo, “Los archivos de servicio deben tener pruebas”)
   • Execution mode — Per file (analiza cada archivo modificado) o Per PR (analiza el PR completo)
   • Path — patrón glob para apuntar a archivos específicos (por ejemplo, src/services/**/*.ts); las reglas Per PR no lo usan
   • Severidad — Crítica, Alta, Media o Baja
   • Instrucciones — descripción detallada de qué verificar

​

Qué hace que las reglas sean poderosas

• Variables como fileDiff, pr_title, pr_description, pr_files_diff
• Referencias a archivos con @file:ruta/al/archivo.ts para comparar contra patrones
• Funciones MCP para obtener datos de herramientas conectadas (Jira, estructura del repositorio, etc.)

​

Ejemplo: Regla de límite de arquitectura

Nombre: La capa de dominio no debe depender de la infraestructura
Modo de ejecución: Per PR
Instrucciones: Verificar en pr_files_diff si hay alguna importación en src/domain/
que haga referencia a src/infrastructure/. Consultar
@file:docs/architecture.md para las dependencias permitidas.

​

Ejemplo: Regla de cobertura de pruebas

Nombre: Cada servicio debe tener un archivo de prueba
Modo de ejecución: Per PR
Instrucciones: Para cada archivo modificado en src/services/,
verificar que exista un archivo de prueba correspondiente en test/services/.
Usar MCP para revisar el árbol de archivos del repositorio.

​

Más formas de agregar reglas

• Importar desde la Biblioteca de Reglas — haz clic en Discovery en la página de Kody Rules para navegar por reglas probadas por lenguaje y categoría
• Sincronizar desde herramientas de IDE — importa automáticamente reglas desde Cursor, Copilot, Claude
• Reglas de repositorio — define reglas en archivos markdown en tu repositorio
• Generación automática — Kody sugiere reglas basadas en tu historial de revisiones