Skip to main content
Kodus puede sincronizar e importar automáticamente tus archivos de reglas del IDE existentes para mejorar la revisión de código de Kody con los estándares de codificación y preferencias establecidas de tu equipo.

Auto-sync rules from repo en el panel Configuration de Kody Rules (alcance de repositorio)

​
¿Qué es la Detección de Archivos de Reglas?

La Detección de Archivos de Reglas detecta e importa automáticamente archivos de configuración de herramientas y asistentes de codificación con IA populares en tu repositorio. Esto garantiza que Kody entienda y respete tus estándares de codificación existentes sin necesidad de configuración manual.

​
Archivos de Reglas Soportados

Kodus detecta e importa automáticamente los siguientes patrones de archivos de reglas:

​
Cursor

  • .cursorrules - Archivo principal de reglas de Cursor (heredado)
  • .cursor/rules/**/*.mdc - Reglas de Cursor en subdirectorios

​
GitHub Copilot

  • .github/copilot-instructions.md - Instrucciones de Copilot
  • .github/instructions/**/*.instructions.md - Archivos de instrucciones detalladas

​
Agentic (convención agents.md)

  • AGENTS.md - El archivo estándar de facto para guiar agentes
  • .agents.md / .agent.md - Variantes con punto

​
Claude

  • CLAUDE.md - Reglas específicas de Claude
  • .claude/settings.json - Configuración de Claude

​
Windsurf

  • .windsurfrules - Reglas del IDE Windsurf

​
Sourcegraph Cody

  • .sourcegraph/**/*.rule.md - Archivos de reglas de Cody

​
OpenCode

  • .opencode.json - Configuración de OpenCode

​
Aider

  • .aider.conf.yml - Configuración de Aider
  • .aiderignore - Patrones de ignorado de Aider

​
Reglas Genéricas/Internas

  • .rules/**/* - Directorio de reglas genéricas
  • .kody/rules/** y rules/**/*.md - Reglas específicas de Kody (consulta Reglas de Repositorio — se importan literalmente, sin reescritura por LLM)
  • docs/coding-standards/**/* - Estándares de codificación basados en documentación

​
Detalles de la detección

  • Se descubren archivos anidados. Cada patrón anterior se busca en la raíz del repositorio y bajo cualquier subdirectorio. Un services/billing/CLAUDE.md se importa y se acota automáticamente a services/billing/** — los archivos de guía por directorio (la convención habitual en monorepos) funcionan sin configuración.
  • La coincidencia no distingue mayúsculas. claude.md y CLAUDE.md son equivalentes.
  • Se siguen las referencias @file. Si un archivo de reglas referencia otro con la convención @ (p. ej. @AGENTS.md dentro de CLAUDE.md), el contenido referenciado se descarga y se incluye durante la importación (un nivel de profundidad, hasta 5 referencias por archivo, 100KB por archivo referenciado).
  • Se admiten varios globs por regla. Una ruta como app/**/*.rb,lib/**/*.rb (o una lista path: [] en el frontmatter de Reglas de Repositorio) aplica la regla a los archivos que coincidan con cualquiera de los globs.

​
Cómo Funciona

​
Configuración Inicial

  1. Habilitar Sincronización Automática: En la barra lateral, elige el repositorio en el selector de alcance en la parte superior del grupo Code review, abre Kody Rules, haz clic en Configuration y activa Auto-sync rules from repo
  2. Diálogo de Primera Sincronización: Un diálogo (Sync repository rules now?) pregunta si deseas sincronizar por primera vez. Elige Sync now, o Skip initial scan para esperar a la próxima sincronización
  3. Escaneo del Repositorio: Al confirmar, Kodus escanea todo tu repositorio en busca de archivos de reglas soportados
  4. Generación de Reglas: Un LLM procesa los archivos encontrados y crea automáticamente las Kody Rules correspondientes. Excepción: los archivos de plantilla .kody/rules/** y rules/**/*.md se importan literalmente — sin conversión por LLM — preservando instrucciones, ejemplos e identificadores tal como se escribieron. Si uno de esos archivos no sigue la plantilla (frontmatter ausente o inválido, o sin title), vuelve a la ruta del LLM

​
Valor predeterminado para toda la organización

Configura “Auto-sincronizar reglas del repositorio” una vez en la configuración Global de Kody Rules y todos los repositorios que no definan su propio valor lo seguirán. La configuración propia de un repositorio siempre prevalece. Activarla globalmente no ejecuta el escaneo inicial: cada repositorio importa los archivos de reglas a medida que cambian en Pull Requests fusionados.

​
Sincronización Continua

  • Actualizaciones Automáticas: La sincronización ocurre automáticamente cuando se cierra un Pull Request
  • Cambios de Archivos Detectados:
    • Nuevos archivos de reglas → Crea nuevas Kody Rules
    • Archivos de reglas modificados → Actualiza las Kody Rules existentes
    • Archivos de reglas eliminados → Elimina las Kody Rules correspondientes

​
Sincronización Manual (Interruptor Deshabilitado)

Puedes sincronizar archivos de reglas individuales sin habilitar la sincronización automática:
  1. Agrega @kody-sync en cualquier parte de tu archivo de regla
  2. Haz commit del cambio
  3. Kody sincronizará solo ese archivo específico
Esto te permite sincronizar selectivamente reglas sin habilitar la sincronización automática para todos los archivos.

​
Excluir un archivo (@kody-ignore)

Para mantener un archivo de reglas/guía en tu repositorio pero evitar que Kody lo convierta en Kody Rules, agrega @kody-ignore en cualquier parte del archivo:
  1. Agrega @kody-ignore en cualquier parte del archivo de reglas (sin distinguir mayúsculas)
  2. Haz commit del cambio
En la siguiente sincronización Kody omitirá ese archivo y eliminará las Kody Rules creadas a partir de él. Las reglas vuelven automáticamente si más adelante quitas el marcador @kody-ignore (o agregas @kody-sync). Úsalo para mantener documentos de estilo interno como un CLAUDE.md o AGENTS.md sin que se conviertan en reglas aplicadas en la revisión.
Si editas manualmente una Kody Rule que fue creada desde un archivo de regla del IDE, tus cambios serán sobreescritos la próxima vez que el archivo correspondiente sea modificado y sincronizado.

​
Verificar sincronización y evaluación de reglas (self-hosted)

En despliegues self-hosted los logs de la API llevan marcadores grep-ables para depurar:
  • [kody-rules-sync] — resumen por ejecución: qué archivos se importaron, se omitieron (con el motivo) o se eliminaron.
  • [kody-rules-eval] — traza de evaluación por archivo durante una revisión: exactamente qué reglas (uuid + título) se seleccionaron para el prompt de cada archivo revisado.
Si una regla aparece activa en la UI pero nunca sale en [kody-rules-eval] para los archivos que esperas, revisa su glob de Path — una regla solo se ejecuta sobre archivos que coincidan con su ruta.

​
Límites de reglas

Las organizaciones en el plan Free de la nube (o cuya suscripción fue cancelada o expiró) y las instancias self-hosted que corren sin una licencia válida (Community Edition) evalúan como máximo 10 reglas activas por revisión (las más antiguas primero). Las reglas que superan el límite permanecen en la lista como Locked y se omiten en cada PR; un banner en Code review → Kody Rules indica cuántas se omiten. Los planes de pago en la nube y las instancias self-hosted con licencia no tienen ese límite. Si las reglas más allá de la décima no se disparan, este límite es la razón.