Inicio Rápido

Esta guía asume que ya has instalado Karajan Code y ejecutado kj init.

Tu primera ejecución

1. Navega a tu proyecto

   cd /ruta/a/tu/proyecto

2. Ejecuta una tarea

   kj run "Añadir validación de inputs al formulario de registro"

   Esto lanza el pipeline completo con tus defaults configurados (ej: Claude como coder, Codex como reviewer, metodología TDD).

3. Observa el pipeline

   Verás output en tiempo real a medida que cada rol se ejecuta:

   [coder]    Escribiendo lógica de validación y tests...
   [sonar]    Quality gate passed — 0 blockers, 0 critical
   [reviewer] APPROVED — no issues found
   ✔ Pipeline completed in 2m 34s (iteration 1/5)

   Si el reviewer encuentra problemas, el coder recibe otra oportunidad. El bucle continúa hasta la aprobación o el límite de iteraciones.

4. Revisa los resultados

   git diff                  # Ver qué cambió
   kj report                 # Resumen de la sesión
   kj report --trace         # Desglose detallado de coste por etapa

Tres formas de usar kj

1. Pipeline completo (kj run)

El workflow estándar — el coder escribe, SonarQube analiza, el reviewer revisa, bucle hasta aprobación:

kj run "Corregir el bug de login que ignora contraseñas vacías"

2. Solo coder (kj code)

Sin bucle de revisión. Útil para cambios rápidos que revisarás tú mismo:

kj code "Añadir un spinner de carga al dashboard"

3. Solo reviewer (kj review)

Revisar el diff actual sin escribir código. Útil después de cambios manuales:

kj review "Revisar mi refactor de autenticación"

Uso via MCP (recomendado)

La forma más potente de usar Karajan Code es como servidor MCP dentro de tu agente de IA. Tras npm install -g karajan-code, el servidor MCP se auto-registra en Claude y Codex.

Desde tu agente, simplemente pídele que ejecute una tarea:

“Usa kj_run para corregir la vulnerabilidad de inyección SQL en el endpoint de búsqueda”

El agente envía la tarea a kj_run, recibe notificaciones de progreso en tiempo real, y obtiene resultados estructurados — todo sin salir de la conversación.

Configuración MCP manual (si es necesario):

{
  "mcpServers": {
    "karajan-mcp": {
      "command": "karajan-mcp"
    }
  }
}

Ver la guía del Servidor MCP para la lista completa de 23 herramientas disponibles.

Opciones comunes

Flag	Qué hace
--coder claude	Elegir qué agente escribe código
--reviewer codex	Elegir qué agente revisa
--methodology tdd	Forzar test-driven development
--mode paranoid	Usar el perfil de revisión más estricto
--enable-triage	Clasificar automáticamente la complejidad
--enable-security	Ejecutar auditoría de seguridad OWASP
--auto-commit	Git commit tras aprobación
--no-sonar	Saltar análisis SonarQube
--max-iterations 3	Limitar bucles coder/reviewer

Para la lista completa, ver la Referencia CLI.

Qué ocurre durante una ejecución

triage? → researcher? → planner? → coder → refactorer? → sonar? → reviewer → tester? → security? → commiter?

1. Triage (opcional) clasifica la complejidad de la tarea y activa solo los roles necesarios
2. Coder escribe código y tests siguiendo metodología TDD
3. SonarQube (opcional) ejecuta análisis estático con quality gates
4. Reviewer revisa el código con exigencia configurable
5. Si hay problemas, el coder recibe otra oportunidad con el feedback del reviewer
6. Bucle hasta aprobación o límite de iteraciones

Guardarraíles integrados previenen sesiones descontroladas: máximo de iteraciones, timeouts por iteración, timeout total de sesión, y topes de presupuesto estimado opcionales. Karajan no tiene coste adicional — ejecuta agentes CLI bajo tus suscripciones existentes.

Siguientes Pasos

• Pipeline — Entender cada rol en detalle
• Configuración — Personalizar el pipeline
• Referencia CLI — Todos los comandos y flags
• Ejemplos — Ejemplos de workflows reales