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.

Habilita la sincronización automática de reglas del repositorio en tu configuración

​
¿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: Activa la opción “Auto-sincronizar reglas del repositorio” en tu configuración
  2. Modal de Primera Sincronización: Aparecerá un modal preguntando si deseas sincronizar por primera vez
  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

​
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 instancias self-hosted que corren sin una licencia válida (Community Edition) evalúan como máximo 10 reglas por revisión (las más antiguas primero). Las instancias self-hosted con licencia y las de nube no tienen ese límite. Si las reglas más allá de la décima no se disparan en una instancia sin licencia, este límite es la razón.