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 — Usa las instrucciones que ya escribiste para agentes de código

1. En la barra lateral, selecciona Global o un repositorio en el selector de alcance en la parte superior del grupo Code review, abre What to review y activa Coding-agent instructions
2. Kody lee los archivos de instrucciones que cubren los archivos modificados de cada pull request y señala los cambios que los incumplen
3. Para una convención que quieras aplicar en cada revisión, escríbela como un archivo de regla en .kody/rules

​

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