Incorporación de un nuevo equipo

​

Descripción general

​

Paso 1 — Crea y configura el workspace

1. Regístrate en kodus.io o accede a tu instancia autohospedada
2. Crea un nuevo workspace para tu equipo
3. Conecta tu proveedor de Git (GitHub, GitLab, Bitbucket o Azure DevOps)
4. Selecciona los repositorios a monitorear

​

Paso 2 — Establece la línea base de revisión

# kodus-config.yml — coloca esto en la raíz de cada repositorio
reviewOptions:
  security: true
  code_style: true
  kody_rules: true
  refactoring: true
  error_handling: true
  maintainability: true
  potential_issues: true
  performance_and_optimization: true
  business_logic: true

suggestionControl:
  groupingMode: full
  limitationType: pr
  maxSuggestions: 9
  severityLevelFilter: medium

automatedReviewActive: true

​

Paso 3 — Importa reglas existentes de herramientas del IDE

1. Ve a Configuración de Code Review → Kody Rules
2. Kodus detecta archivos .cursorrules, .github/copilot-instructions.md y .claude
3. Importa las que tengan sentido para la revisión de código

​

Paso 4 — Enseña tus 5 principales convenciones

@kody remember: we use camelCase for variables and PascalCase for types.

@kody remember: all API responses use the standard envelope format
{ data, error, meta }.

@kody remember: we prefer composition over inheritance.
Use interfaces and dependency injection.

@kody remember: every public function must have JSDoc with
@param and @returns descriptions.

@kody remember: database queries go through the repository layer only.
No direct DB access from services or controllers.

​

Paso 5 — Crea 2-3 reglas críticas

Name: No console.log in production code
Scope: File
Paths: src/**/*.ts
Severity: High
Instructions: Flag any console.log, console.warn, or console.error
in fileDiff. Use the project logger instead.
Exclude test files (*.spec.ts, *.test.ts).

Name: No hardcoded API URLs
Scope: File
Paths: src/**/*.ts
Severity: Critical
Instructions: Flag any hardcoded URL (http:// or https://)
in fileDiff that looks like an API endpoint.
URLs must come from environment variables or config files.

​

Paso 6 — Conecta la gestión de tareas (opcional pero recomendado)

​

Paso 7 — Ejecuta un PR piloto

• Los comentarios de Kodus aparecen en el PR
• Las sugerencias son relevantes y tienen la severidad correcta
• Tus reglas personalizadas se activan cuando corresponde
• Las Memorias se reflejan en el contexto de la revisión

​

Paso 8 — Recopila comentarios después de una semana

• ¿Hay demasiadas sugerencias? → Sube severityLevelFilter o baja maxSuggestions
• ¿Las reglas generan demasiado ruido? → Reduce las rutas de archivos o añade exclusiones
• ¿Faltan patrones importantes? → Añade nuevas reglas o Memorias
• ¿Quieres reglas generadas automáticamente? → Haz clic en Generar Kody Rules para obtener sugerencias del historial de revisiones

​

Consejos

• No sobrecargues con reglas el primer día — empieza pequeño y crece
• Deja que el equipo enseñe a Kody de forma natural mediante conversaciones antes de formalizarlo como reglas
• Usa @kody start-review durante los primeros PRs para que el equipo vea a Kodus en acción
• Habilita la aprobación de memorias generadas por LLM si quieres revisar lo que aprende Kody