Instructions & Personality

Las instrucciones de categoría y la personalidad de Kody (antes Custom Prompts) te dan control total sobre cómo Kody analiza tu código y comunica los hallazgos. Personaliza qué busca la IA en cada categoría de revisión y cómo presenta las sugerencias para que coincidan con los estándares y el estilo de comunicación de tu equipo. La antigua página de Custom Prompts ya no aparece en la navegación. Sus dos partes ahora viven en dos páginas del grupo Code review de la barra lateral:

Instrucciones de categoría

Code review → What to review: un editor de Instructions en las filas Bug, Performance y Security

Personalidad de Kody

Code review → What Kody writes: el editor Personality instructions

¿Por Qué Usar Prompts Personalizados?

Estándares Específicos del Equipo

Alinea las revisiones de Kody con los estándares de codificación únicos de tu equipo, patrones arquitectónicos y mejores prácticas

Optimización del Modelo

Crea prompts optimizados para las fortalezas de tu modelo de IA específico al usar BYOK

Control del Enfoque

Dirige la atención de Kody hacia los problemas que más importan a tu proyecto y reduce el ruido

Estilo de Comunicación

Personaliza cómo Kody presenta las sugerencias — detallado para problemas críticos o conciso para los menores

Cómo Funcionan los Prompts Personalizados

Los Prompts Personalizados operan en dos niveles:

Instrucciones de categoría (What to review)

Define qué busca Kody en cada categoría de revisión. En Code review → What to review, cada fila habilitada de Bug, Performance y Security tiene un botón Instructions que despliega un editor (What counts as a bug issue, etc.). Muestra el valor predeterminado de Kody hasta que lo cambies — el chip indica Kody’s default o Custom — y Reset to default lo restaura. El editor se oculta mientras la categoría está desactivada, y Business Logic no tiene instrucciones.

Error
Seguridad
Rendimiento

Enfoque: Corrección del código y problemas de ejecuciónCobertura predeterminada:

Interrupciones de ejecución (excepciones no manejadas)
Resultados incorrectos (salida incorrecta)
Fugas de recursos (archivos, conexiones, memoria)
Corrupción de estado (estados inválidos de objetos/datos)
Errores de lógica (flujo de control incorrecto)
Condiciones de carrera (problemas de acceso concurrente)

Longitud máxima: 2000 caracteres

Personalidad de Kody (What Kody writes)

Antes la instrucción base de Suggestion Prompts. En Code review → What Kody writes, la sección Kody’s personality tiene un editor Personality instructions (máx. 2000 caracteres, con Reset to default disponible): cómo suena Kody en cada sugerencia. Se aplica por encima de las instrucciones de cada categoría. Controla cómo Kody comunica cada sugerencia individual. Esto personaliza el formato y tono del mensaje que aparece en los comentarios del PR, como:

El nuevo archivo 'create-or-update-issues-parameter.dto.ts' no sigue 
la convención de nomenclatura de la empresa. Según las Kody Rules, todos los archivos nuevos 
deben usar camelCase. Por favor, renombra el archivo a 'createOrUpdateIssuesParameter.dto.ts' 
para adherirse al estándar.

Tu prompt personalizado le indica a Kody cómo escribir los mensajes de sugerencia. El prompt recibe contexto sobre el nivel de severidad, descripción del problema, código sugerido y si es una violación de Kody Rules. Kody usa este contexto junto con tu prompt para generar mensajes apropiados para cada sugerencia. Puedes personalizar el tono, el nivel de detalle y el estilo de comunicación según las necesidades de tu equipo — desde explicaciones detalladas para problemas críticos hasta feedback conciso para los menores.

Definirlos en `kodus-config.yml`

Los mismos cuatro campos están disponibles bajo la clave v2PromptOverrides:

v2PromptOverrides:
    generation:
        main: |
            Base instruction used for every suggestion.
    categories:
        descriptions:
            bug: |
                What Kody should look for in the Bug category.
            performance: |
                What Kody should look for in the Performance category.
            security: |
                What Kody should look for in the Security category.

Estos cuatro son los que expone la interfaz web, y cada uno tiene un límite de 2000 caracteres. No hay override de prompt para la categoría Business Logic. El archivo de configuración acepta un grupo más que ninguna página de la interfaz web edita — es exclusivo del archivo de configuración. Es la rúbrica de severidad que Kody usa para clasificar un hallazgo:

v2PromptOverrides:
    severity:
        flags:
            critical: |
                Qué cuenta como crítico (crash, pérdida de datos, brecha de seguridad...).
            high: |
            medium: |
            low: |

Esto cambia cómo Kody clasifica los hallazgos, no solo cómo los redacta — una rúbrica mala puede silenciar o inflar severidades en todas las revisiones sin avisar. Parte de los valores por defecto de default-kodus-config.yml en lugar de escribir una rúbrica desde cero.

El default-kodus-config.yml que se distribuye también contiene un grupo v2PromptOverrides.level. Se sigue aceptando por retrocompatibilidad, pero el engine ya no lo lee — definirlo no cambia nada. Solo categories.descriptions, severity.flags y generation.main llegan a la revisión.

El archivo solo se lee una vez que kodusConfigFileOverridesWebPreferences está habilitado (consulta General).

Referencias Externas

Todos los prompts personalizados — instrucciones de categoría, instrucciones de personalidad e instrucciones del resumen de PR — soportan referencias a archivos reales de los repositorios a los que Kody tiene acceso. Cuando guardas una actualización, Kody detecta automáticamente las referencias externas y las resuelve para revisiones futuras.

Usa @file:path/to/file.ts para apuntar a archivos en el repositorio que estás editando; Kody intentará ubicar la ruta localmente primero.
Incluye @repo:org/project cuando hagas referencia a archivos de otro repositorio o cuando edites prompts a nivel global.
Prefiere rutas de estilo blob precisas en lugar de marcadores de posición para que el modelo pueda encontrar el archivo correcto de manera confiable.
Después de guardar, Kody procesa las referencias en segundo plano. Verifica el indicador de estado junto al editor de prompts para confirmar cuándo se completa la resolución.

Mejores Prácticas

Sé Específico para Tu Contexto

Sí: Específico al Contexto

Prompt de categoría de errores:
Enfócate en excepciones de puntero nulo en nuestros 
servicios Java, conexiones de base de datos no cerradas 
en la capa DAO, y condiciones de carrera en nuestros 
manejadores de eventos asíncronos. Verifica la limpieza 
adecuada de recursos en bloques try-finally.

No: Demasiado Genérico

Prompt de categoría de errores:
Busca errores en el código.
Verifica problemas e inconvenientes.

Evita la Redundancia Entre Prompts

Cada categoría debe tener un enfoque distinto. No repitas las mismas instrucciones en diferentes prompts.

Ejemplo: Separación Correcta

Categoría de Errores: Enfócate en la corrección de ejecución, excepciones de puntero nulo y limpieza de recursos en nuestros servicios Java.Categoría de Seguridad: Enfócate en inyección SQL, XSS y CSRF en nuestros endpoints de API. Verifica la sanitización de entrada y las consultas parametrizadas.Categoría de Rendimiento: Enfócate en consultas N+1, índices de base de datos faltantes y bucles ineficientes en el procesamiento de datos.Resultado: Cada prompt tiene un enfoque claro y sin superposición.

Anti-patrón: Prompts Redundantes

Categoría de Errores: Verifica punteros nulos, inyección SQL y consultas lentas.Categoría de Seguridad: Busca inyección SQL, punteros nulos y problemas de rendimiento.Categoría de Rendimiento: Encuentra consultas lentas, punteros nulos y vulnerabilidades de seguridad.Problema: Todos los prompts se superponen, confundiendo al modelo y reduciendo la calidad de la revisión.

Ten Cuidado con los Ejemplos

Bien: Descripción de Patrón
Arriesgado: Ejemplo Específico

Detecta inyección SQL en consultas de base de datos:
- Concatenación de cadenas sin procesar en sentencias SQL
- Entrada de usuario directamente en cadenas de consulta
- Falta de consultas parametrizadas o ORMs
- Construcción dinámica de consultas sin sanitización

Esto describe el patrón de forma amplia, capturando múltiples variaciones.

Detecta inyección SQL como esta:
query = "SELECT * FROM users WHERE id = " + userId

El modelo podría marcar solo este patrón exacto y omitir:

Template literals: SELECT * FROM users WHERE id = ${userId}
Formato de cadena: f"SELECT * FROM users WHERE id = {userId}"
Otros vectores de inyección SQL

Mantén las Sugerencias Escaneables

Para los prompts de sugerencia, haz que los mensajes sean fáciles de escanear ya que los desarrolladores revisan muchos a la vez:

Bien: Estructura Clara
Mal: Bloque de Texto

Escribe sugerencias con estructura clara. Para problemas críticos, 
comienza con el emoji 🚨, indica el problema, luego muestra "Solución:" 
seguido del código. Para otras severidades, mantenlo simple — 
solo el problema y el código sugerido.

Pon la información importante primero para que los desarrolladores puedan 
entender rápidamente qué se debe hacer.

Jerarquía clara, información importante primero

Explica el problema y por qué es importante porque podría 
causar problemas en producción y los desarrolladores deben solucionarlo 
aplicando los cambios de código sugeridos que resolverán el problema.

Difícil de escanear, entierra la acción

Usa el Contexto de Forma Significativa

Solo diferencia los formatos de sugerencia cuando haya una razón real:

Bien: Diferencia Significativa
Mal: Etiqueta Superficial

Para violaciones de Kody Rules, usa un tono más estricto: 
"**Estándar del Equipo**: [problema]. Requerido: [código]"

Para sugerencias estándar, usa un tono más amigable:
"[problema]. Sugerido: [código]"

La diferencia en el lenguaje deja claro el nivel de requerimiento.

Distinción clara: las reglas son requisitos, las sugerencias son recomendaciones

Para Kody Rules, agrega el prefijo "[REGLA]" antes del problema.
Para sugerencias, agrega el prefijo "[SUGERENCIA]" antes del problema.
De lo contrario, formalítalas de la misma manera.

Agregar solo etiquetas no aporta valor

Casos de Uso

Requisitos Específicos del Sector

Escenario: Aplicación de salud con requisitos de cumplimiento HIPAAPrompt de Seguridad Personalizado:

Focus on HIPAA compliance in data handling:
- PHI (Protected Health Information) exposure in logs or errors
- Missing encryption for PHI at rest and in transit
- Inadequate access controls for patient data
- Audit logging gaps for PHI access
- Data retention violations
- Missing patient consent verification

Beneficio: Kody detecta problemas específicos de cumplimiento que las revisiones de seguridad genéricas podrían pasar por alto.

Optimización del Stack Tecnológico

Escenario: Aplicación React/Node.js con patrones específicosPrompt de Errores Personalizado:

Focus on React and Node.js common pitfalls:
- Missing dependency arrays in useEffect/useMemo
- Unhandled promise rejections in async handlers
- Memory leaks from event listener cleanup
- Race conditions in state updates
- Missing error boundaries
- Uncaught exceptions in Express middleware

Beneficio: Las revisiones se centran exactamente en los problemas específicos de tu stack.

Ajuste Específico del Modelo

Escenario: Uso de Gemini 2.5 Flash vía BYOK para optimización de costosPrompt de Rendimiento Personalizado:

Analyze algorithmic efficiency and resource usage.
List specific issues in this format:
1. Issue type and location
2. Current complexity
3. Optimization suggestion
4. Expected improvement

Prioritize: database queries, loops, memory allocations.

Beneficio: Formato de salida estructurado que Gemini maneja excepcionalmente bien, mejorando la calidad de la revisión.

Comunicación Basada en Severidad

Escenario: Quieres explicaciones detalladas para problemas críticos pero feedback conciso para los menoresPrompt de Sugerencia Personalizado:

When writing suggestions, adjust the level of detail based on severity:

For Critical issues: Start with "🚨 CRITICAL:" followed by the problem. 
Add a line explaining "This requires immediate attention." Then provide 
the fix with "Fix:" prefix.

For High severity: Use "⚠️" emoji, state the problem, then show the fix 
with "Fix:" prefix.

For Medium and Low: Keep it brief - just state the problem and show the 
suggested code directly without extra explanation.

Beneficio: Los problemas críticos obtienen contexto adicional mientras los menores permanecen breves, mejorando la eficiencia de la revisión.

Feedback Directo y Conciso

Escenario: El equipo prefiere feedback mínimo y accionablePrompt de Sugerencia Personalizado:

Be direct and concise. State the problem in one sentence, then immediately 
show the fix with "Fix:" prefix. No additional context or explanations.

Beneficio: Cada sugerencia es breve y directa sin contexto adicional.

Sugerencias Educativas

Escenario: Los desarrolladores junior se benefician de explicaciones detalladasPrompt de Sugerencia Personalizado:

Structure suggestions in three parts:

1. **Issue:** State the problem clearly
2. **Why this matters:** Explain the impact based on severity:
   - Critical: Could cause production failures or security vulnerabilities
   - High: May lead to bugs or performance problems  
   - Medium/Low: Improves code quality and maintainability
3. **Fix:** Show the recommended code change

Make explanations educational and help developers learn why it matters.

Beneficio: Cada sugerencia incluye contexto educativo sobre su importancia.

Tono Diferente para Reglas vs Sugerencias

Escenario: Las Kody Rules son requisitos estrictos, las sugerencias son recomendacionesPrompt de Sugerencia Personalizado:

Use different tones based on the type:

For Kody Rules violations:
- Start with "**Team Standard Violation**" in bold
- State the problem
- Add "This violates documented team standards."
- Show "Required fix:" followed by the code

For standard suggestions:
- State the problem directly
- Show "Suggested improvement:" followed by the code
- Use a friendly, recommendatory tone

Beneficio: Distinción clara entre reglas obligatorias y sugerencias opcionales.

Solución de Problemas

Las Revisiones Son Demasiado Ruidosas

Síntomas: Demasiadas sugerencias de bajo valor después de la personalizaciónSoluciones:

Haz los prompts más específicos y enfocados
Agrega exclusiones para patrones que quieras ignorar
Eleva Minimum severity to post en What to review (consulta Umbral de Severidad)
Verifica la redundancia entre los prompts de categoría

Problemas Esperados No Detectados

Síntomas: Kody no detecta problemas que deberíaSoluciones:

Revisa tu prompt para ver si es demasiado estrecho o específico a ejemplos
Verifica si el problema cae en una categoría que no personalizaste
Intenta restablecer los valores predeterminados para ver si el problema es detectado
Considera si el problema podría clasificarse bajo una severidad diferente

Resultados Inconsistentes

Síntomas: El mismo tipo de problema a veces se señala y otras veces noSoluciones:

Asegúrate de que los prompts sean claros y sin ambigüedades
Elimina instrucciones contradictorias entre diferentes prompts
Verifica si estás usando ejemplos demasiado específicos
Considera si los diferentes modelos en primario/fallback tienen capacidades distintas

No Sabes Qué Personalizar

Síntomas: Quieres usar prompts personalizados pero no sabes por dónde empezarSoluciones:

Comienza ejecutando revisiones predeterminadas durante una semana
Anota patrones en falsos positivos o problemas no detectados
Personaliza solo el prompt específico relacionado con esos patrones
Mantén otros prompts en valores predeterminados hasta que veas una necesidad clara

Preguntas Frecuentes

¿Los prompts personalizados se aplican a todos los repositorios?

Depende de dónde los configures:

Configuración global: Se aplica a todos los repositorios de tu organización
Configuración por repositorio: Anula la configuración global para ese repositorio específico

Esto te permite tener estándares a nivel de organización con overrides específicos por repositorio cuando sea necesario.

¿Puedo ver los prompts predeterminados antes de personalizar?

Sí. Cada editor muestra el valor predeterminado de Kody hasta que lo cambies, y Reset to default lo restaura.

¿Qué ocurre con los PRs existentes cuando cambio los prompts?

Los cambios solo afectan a las revisiones nuevas. Vuelve a ejecutar con @kody start-review para aplicar los nuevos prompts a los PRs existentes.

¿Puedo personalizar los prompts con kodus-config.yml?

Sí, bajo la clave v2PromptOverrides — consulta “Definirlos en kodus-config.yml” más arriba. El archivo solo se lee una vez que kodusConfigFileOverridesWebPreferences está habilitado.

¿Debo personalizar todos los prompts o solo algunos?

Solo personaliza los prompts con necesidades claras y específicas. Mantén los demás en valores predeterminados para beneficiarte de nuestras mejoras. Empieza con 1-2 prompts.

¿Cómo funcionan los prompts personalizados con BYOK?

Funciona perfectamente. Adapta los prompts a las fortalezas de tu modelo. Tanto el primario como el fallback usan los mismos prompts personalizados.

¿Cuál es la diferencia entre las instrucciones de categoría y las instrucciones de personalidad?

Las instrucciones de categoría (antes prompts de Categoría, en What to review) controlan qué analiza Kody en cada categoría de revisión. Las instrucciones de personalidad (antes prompts de Sugerencia, en What Kody writes) controlan cómo Kody presenta los hallazgos a tu equipo. Puedes personalizar ambos de forma independiente.

¿Puedo usar markdown en los prompts de sugerencia?

Sí. Los prompts de sugerencia soportan formato markdown estándar, incluyendo negrita, cursiva, bloques de código y enlaces.

¿Qué ocurre si mi plantilla de sugerencia tiene errores de sintaxis?

Kody volverá al formato de sugerencia predeterminado y te notificará del error en la configuración.

¿Los prompts de sugerencia funcionan tanto para Kody Rules como para sugerencias estándar?

Sí. Usa la variable isKodyRule para crear diferentes mensajes para reglas vs sugerencias en el mismo prompt.

Comenzando

Facturación y Licencias

Revisión de Código con IA

CLI

Cockpit

Kody Issues

Organización

Seguridad

Solución de Problemas

Instructions & Personality

Instrucciones de categoría

Personalidad de Kody

¿Por Qué Usar Prompts Personalizados?

Estándares Específicos del Equipo

Optimización del Modelo

Control del Enfoque

Estilo de Comunicación

Cómo Funcionan los Prompts Personalizados

Instrucciones de categoría (What to review)

Personalidad de Kody (What Kody writes)

Definirlos en `kodus-config.yml`

Referencias Externas

Mejores Prácticas

Sé Específico para Tu Contexto

Sí: Específico al Contexto

No: Demasiado Genérico

Evita la Redundancia Entre Prompts

Ten Cuidado con los Ejemplos

Mantén las Sugerencias Escaneables

Usa el Contexto de Forma Significativa

Casos de Uso

Solución de Problemas

Preguntas Frecuentes

Instrucciones de categoría

Personalidad de Kody

​¿Por Qué Usar Prompts Personalizados?

Estándares Específicos del Equipo

Optimización del Modelo

Control del Enfoque

Estilo de Comunicación

​Cómo Funcionan los Prompts Personalizados

​Instrucciones de categoría (What to review)

​Personalidad de Kody (What Kody writes)

​Definirlos en kodus-config.yml

​Referencias Externas

​Mejores Prácticas

​Sé Específico para Tu Contexto

Sí: Específico al Contexto

No: Demasiado Genérico

​Evita la Redundancia Entre Prompts

​Ten Cuidado con los Ejemplos

​Mantén las Sugerencias Escaneables

​Usa el Contexto de Forma Significativa

​Casos de Uso

​Solución de Problemas

​Preguntas Frecuentes

¿Por Qué Usar Prompts Personalizados?

Cómo Funcionan los Prompts Personalizados

Instrucciones de categoría (What to review)

Personalidad de Kody (What Kody writes)

Definirlos en `kodus-config.yml`

Referencias Externas

Mejores Prácticas

Sé Específico para Tu Contexto

Evita la Redundancia Entre Prompts

Ten Cuidado con los Ejemplos

Mantén las Sugerencias Escaneables

Usa el Contexto de Forma Significativa

Casos de Uso

Solución de Problemas

Preguntas Frecuentes