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, Azure Repos o Forgejo)
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:
  bug: true
  security: true
  performance: true
  business_logic: true

suggestionControl:
  severityLevelFilter: medium
  applyFiltersToKodyRules: false

automatedReviewActive: true

​

Paso 3 — Importa reglas existentes de herramientas del IDE

1. En la barra lateral, selecciona 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. Kodus detecta archivos .cursorrules, .github/copilot-instructions.md y .claude
3. Revisa las reglas importadas y conserva 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
Execution mode: Per file
Path: 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
Execution mode: Per file
Path: 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 Minimum severity to post en Code review → What to review (severityLevelFilter en kodus-config.yml)
• ¿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? → Selecciona el repositorio en el selector de alcance, abre Code review → Kody Rules, haz clic en Configuration y activa Generate from past reviews 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
• Activa Kody knowledge approval (Code review → Kody Rules → Configuration) si quieres revisar lo que aprende Kody