Descripción General

​

Dos Tipos de Kody Rules

​

Reglas de Revisión

​

Crear Reglas Personalizadas

​

Variables, Referencias a Archivos y Funciones MCP

• Nivel de Archivo:
  • fileDiff - Los cambios específicos realizados en el archivo individual que se está analizando
• Nivel de PR:
  • pr_title - El título del Pull Request
  • pr_description - La descripción/cuerpo del Pull Request
  • pr_total_additions - Número total de líneas agregadas
  • pr_total_deletions - Número total de líneas eliminadas
  • pr_total_files - Número total de archivos modificados
  • pr_total_lines_changed - Número total de líneas modificadas
  • pr_files_diff - Diff completo de todos los cambios en todo el Pull Request
  • pr_tags - Etiquetas asociadas al Pull Request
  • pr_author - Autor del Pull Request
  • pr_number - Número del Pull Request

• @file:path/to/file.ts - Referencia archivos en el mismo repositorio donde estás editando la regla
  • Úsalo cuando referencias plantillas, ejemplos o archivos de configuración dentro de tu repositorio actual
  • Ejemplo: @file:src/services/userService.ts
• @repo:org/project - Referencia archivos en otro repositorio o cuando configuras reglas fuera del contexto de un repositorio
  • Úsalo cuando apliques consistencia entre múltiples repositorios o referencíes estándares compartidos
  • Ejemplo: @repo:team/api-standards

• Kody identifica las referencias a archivos automáticamente cuando guardas una regla
• Las referencias se resuelven en segundo plano — observa el indicador de estado junto al editor para confirmar la finalización
• Usa rutas de estilo blob precisas (p. ej., src/utils/helpers.ts) en lugar de marcadores de posición
• El contenido de los archivos se inyecta en el contexto de la regla, permitiendo a Kody comparar, validar o aplicar patrones
• Funciona tanto en reglas de Nivel de Archivo como de Nivel de Pull Request

• Operaciones de repositorio: Listar repositorios, obtener archivos, contenido e idiomas del repositorio
• Análisis de PR: Obtener detalles del pull request, listar commits, analizar contenido de archivos del PR
• Recuperación de contenido de archivos: Obtener contenido de archivos y diffs
• Validación entre archivos: Realizar análisis avanzado entre múltiples archivos
• Integraciones personalizadas: Cualquier servidor MCP que hayas conectado como plugin (Jira, herramientas personalizadas, etc.)

• Usa rutas de archivos específicas en lugar de marcadores de posición genéricos
• Referencia archivos estables que representen los estándares de tu equipo
• Verifica que las referencias a archivos existan antes de guardar las reglas para evitar errores de resolución
• Combina variables, referencias a archivos y funciones MCP para una validación exhaustiva

​

Reglas a Nivel de Archivo

• Comparar con archivos de referencia usando @file o @repo
• Obtener archivos relacionados o datos del repositorio usando funciones MCP
• Combinar variables, referencias a archivos y funciones MCP para validar patrones, verificar consistencia o aplicar reglas arquitectónicas

• Nombre de la regla: Define claramente el propósito de la regla
• Rutas de archivos: Limita las reglas a archivos o directorios específicos usando patrones glob
• Severidad: Establece en Crítico, Alto, Medio o Bajo
• Instrucciones detalladas: Usa fileDiff, referencia archivos con @file/@repo y llama a funciones MCP para componer reglas potentes con contexto enriquecido

// Riesgo de bucle infinito si el incremento no es exactamente 1
for (let i = 0; i != 10; i += 2) {
  console.log(i); // Imprimirá 0, 2, 4, 6, 8, 10, 12, 14... para siempre
}

// Riesgo si el array se modifica durante la iteración
let items = [1, 2, 3, 4, 5];
for (let i = 0; i != items.length; i++) {
  if (items[i] === 3) {
    items.push(6); // Modifica la longitud, puede causar bucle infinito
  }
}

// Seguro: el bucle siempre terminará
for (let i = 0; i < 10; i += 2) {
  console.log(i); // Imprimirá 0, 2, 4, 6, 8 y se detendrá
}

// Seguro incluso si el array se modifica
let items = [1, 2, 3, 4, 5];
for (let i = 0; i < items.length; i++) {
  if (items[i] === 3) {
    items.push(6); // El bucle aún terminará de forma segura
  }
}

​

Reglas a Nivel de Pull Request

• Validar metadatos del PR usando variables como pr_title, pr_description, pr_author
• Referenciar archivos de configuración o plantillas usando @file o @repo
• Obtener contexto adicional usando funciones MCP (p. ej., verificar si archivos relacionados existen, validar contra la estructura del repositorio)
• Combinar variables de PR, referencias a archivos y funciones MCP para crear reglas de validación exhaustivas

• Cada archivo de servicio debe tener un archivo de prueba correspondiente
• La descripción del PR debe ser completa, indicando claramente qué se agregó o eliminó
• Cuando se crea una nueva ruta en un controlador, debe registrarse en routes.json
• Usa pr_total_lines_changed para señalar PRs que superan los límites de tamaño
• Combina pr_files_diff con funciones MCP para validar dependencias entre archivos
• Referencia @file:routes.json para asegurar que las nuevas rutas estén registradas
• Usa funciones MCP para verificar si existen archivos de prueba para los archivos de servicio modificados

​

Composición de Reglas Potentes

• Usa fileDiff para analizar los cambios específicos en un archivo
• Referencia archivos relacionados con @file:path/to/template.ts para comparar con patrones
• Llama a funciones MCP para obtener datos del repositorio o verificar si existen archivos relacionados
• Ejemplo: “Analiza fileDiff y asegúrate de que siga el patrón en @file:src/utils/example.ts. Usa MCP para verificar que existan archivos de prueba relacionados.”

• Usa variables de PR (pr_title, pr_description, pr_files_diff, etc.) para validar metadatos del PR y tamaño
• Referencia archivos de configuración con @file:config.json o @repo:org/shared-config para aplicar consistencia
• Llama a funciones MCP para realizar validación entre archivos, verificar la estructura del repositorio u obtener el historial de commits
• Ejemplo: “Si pr_files_diff contiene nuevas rutas, verifica que estén registradas en @file:routes.json. Usa MCP para verificar si existen archivos de prueba correspondientes para todos los archivos de servicio modificados.”

• Referencia archivos de otros repositorios con @repo:org/project para mantener consistencia entre proyectos
• Combina con funciones MCP para validar contra estándares o plantillas compartidos
• Ejemplo: “Asegúrate de que los endpoints de la API sigan el patrón definido en @repo:org/api-standards. Usa MCP para obtener el documento de estándares más reciente.”

• Las funciones MCP se ejecutan durante la evaluación de la regla, habilitando reglas que se adaptan al estado actual del repositorio
• Obtén datos en tiempo real sobre archivos, commits o la estructura del repositorio
• Ejemplo: “Usa MCP para verificar la estructura actual del repositorio y asegurarte de que los nuevos archivos sigan los patrones de directorio existentes.”

​

Importar desde la Biblioteca de Reglas

• Navega a Reglas de Descubrimiento en tu panel de Kodus.
• Filtra reglas por severidad, lenguaje o etiquetas.
• Importa y activa reglas con un solo clic.

• Seguridad: “Prohibir el uso del hash MD5 inseguro.”
• Mantenibilidad: “Limitar los componentes React a menos de 150 líneas.”

​

Memorias

​

Cómo Funcionan las Memorias

• Inyectadas en todas partes: Las Memorias se incluyen en el análisis de revisión de código (entre archivos, salvaguardas, reglas a nivel de PR) y en las interacciones conversacionales
• Contexto de alta prioridad: Las Memorias son tratadas como orientación de alta prioridad por la IA, asegurando que las convenciones de tu equipo se apliquen de manera consistente
• Deduplicación inteligente: Cuando se crea una nueva memoria, Kody usa un mecanismo de resolución basado en LLM para determinar si crearla, omitirla (si es duplicada) o actualizar una memoria existente

​

Crear Memorias

​

Vía Conversación

@kody remember: Las claves del payload de la API son camelCase, las columnas de la base de datos son snake_case.

@kody please remember: en la capa de dominio, las entidades nunca deben tener propiedades nullable por defecto.

@kody en este repo evitamos Lodash y preferimos los métodos nativos de arrays de JS por legibilidad y tamaño del bundle.

@kody para las verificaciones de existencia en Postgres preferimos EXISTS sobre COUNT(*) y sobre patrones amplios de LEFT JOIN por rendimiento.

@kody estamos migrando del AWS SDK v2 al v3; trata cualquier nueva importación de v2 como bloqueante.

​

Vía la UI

1. Ve a Configuración de Code Review → Repositorio → Kody Rules
2. Cambia a la pestaña Memorias
3. Haz clic en Agregar Memoria para crear una nueva entrada
4. Completa el contenido y el alcance de la memoria

​

Alcances de las Memorias

​

Aprobación de Memorias Generadas por LLM

1. Ve a Configuración de Code Review → Repositorio → Kody Rules → pestaña Memorias
2. Habilita Aprobación de memorias generadas por LLM

• Las memorias generadas por IA entran en un estado pendiente y no están activas hasta que se aprueben
• Aparece un badge de notificación mostrando el número de memorias pendientes
• Haz clic en Memorias Pendientes para revisar, aprobar, descartar o convertir elementos pendientes
• Tanto las nuevas creaciones de memorias como las actualizaciones de memorias existentes pasan por el flujo de aprobación

llmGeneratedMemoriesRequireApproval: true

​

Revisión de Memorias Pendientes

• Nuevas Memorias: Memorias generadas por IA en espera de aprobación
• Actualizaciones de Memorias: Cambios propuestos a memorias existentes

• Aplicar: Activar la memoria o aplicar la actualización
• Descartar: Rechazar la memoria o actualización
• Convertir a Regla de Revisión: Transformar una memoria en una Regla de Revisión estándar

​

Próximos Pasos