Introducción

Un comando. Múltiples agentes IA. Pipeline de calidad completo.

Karajan Code (kj) orquesta agentes de IA como un director de orquesta dirige una sinfonía. Tú defines qué tiene que pasar — codificar, revisar, testear, securizar — y Karajan asigna quién hace cada parte.

16 roles especializados. Triage, domain-curator, researcher, architect, planner, coder, reviewer, tester, security, y más.

5 agentes IA. Claude, Codex, Gemini, Aider, OpenCode. Combínalos libremente.

Sin coste adicional. Funciona con tus suscripciones existentes — no necesitas API keys.

---

El Problema

Hoy hay dos formas de usar agentes de IA para programar, y ambas tienen problemas serios:

Uso manual — Ejecutas un agente, esperas el código, lo revisas tú mismo, encuentras problemas, vuelves a hacer prompt y repites. Sin control de calidad sistemático. Lento. Depende enteramente de tu capacidad de revisión.

Uso automatizado (CI/CD) — Conectas agentes a pipelines que se ejecutan en cada push. Eliminas el cuello de botella manual, pero introduces costes sin control. Una sola tarea puede quemar tokens indefinidamente — agentes reintentando, reviewers en bucle, APIs inestables disparando reintentos ilimitados. Dinero real, sin visibilidad.

En ambos casos: no hay forma estándar de asegurar calidad, controlar el gasto, o saber cuándo parar.

La Solución

Karajan Code resuelve ambos problemas encadenando roles con quality gates y controles de coste:

1

💻

Coder

El rol coder escribe código y tests — ejecutado por el agente IA que tú elijas (ej. Claude, Codex, Gemini).

2

🛡

Guards Deterministas

Guards basados en regex escanean el diff buscando operaciones destructivas, fugas de credenciales y anti-patrones de rendimiento. Sin LLM.

3

🔍

Análisis Estático

SonarQube realiza análisis estático completo con quality gates. Opcionalmente complementado por SonarCloud para análisis advisory en la nube.

4

👁

Reviewer

El rol reviewer revisa el código buscando issues (ej. Codex). El scope filter auto-difiere items fuera de scope como deuda técnica.

5

🔄

Iterar o Aprobar

Si hay problemas, el coder recibe otra oportunidad. El bucle se repite hasta que el código es aprobado o se alcanza el límite de iteraciones.

6

💪

Guardarraíles Integrados

Máximo de iteraciones, timeouts por iteración, timeout de sesión y topes de presupuesto (USD/EUR). Fail-fast para bucles. Informes de coste con kj report --trace.

‹

›

Características Principales

Pipeline basado en Roles

16 roles especializados — cada uno asignable a cualquier agente. Triage, domain-curator, discover, researcher, architect, planner, coder, refactorer, sonar, reviewer, hu-reviewer, tester, security, audit, solomon, commiter.

5 Agentes IA

Claude, Codex, Gemini, Aider, OpenCode — combínalos por rol. Extensible via plugins en .karajan/plugins/.

Servidor MCP — 23 Herramientas

Usa kj desde tu agente IA. Herramientas standalone: kj_discover, kj_triage, kj_researcher, kj_architect, kj_hu. Notificaciones de progreso en tiempo real.

Guards Deterministas

Output guard bloquea operaciones destructivas y fugas de credenciales. Perf guard detecta anti-patrones frontend. Intent classifier pre-clasifica sin coste LLM.

Injection Guard

Escáner de inyección de prompts que protege la revisión de código por IA contra manipulación. Detecta directivas override, caracteres Unicode invisibles y payloads de comentarios sobredimensionados. También se ejecuta como GitHub Action en cada PR.

Gestor Integrado de HUs

Auto-descompone tareas complejas en historias de usuario (HUs) formales. El triage activa hu-reviewer para tareas medias/complejas, generando 2-5 HUs con dependencias. Cada HU ejecuta su propio sub-pipeline (coder→sonar→reviewer) con tracking de estado. Integración completa con PG y visualización en el board.

SonarQube + SonarCloud

Análisis estático dual: SonarQube (Docker local, quality gates bloqueantes) y SonarCloud (cloud, advisory). Ambos se ejecutan juntos en el mismo pipeline.

TDD Obligatorio

Se exigen cambios en tests cuando se modifican ficheros fuente. El pipeline rechaza iteraciones sin tests correspondientes.

Comandos de Rol Standalone

kj discover, kj triage, kj researcher, kj architect — ejecuta cualquier rol pre-build de forma independiente desde CLI o MCP.

Tracking de Presupuesto

Conteo de tokens por sesión con coste estimado equivalente a API. Karajan no tiene coste adicional — usa tus suscripciones CLI.

Resilient Run

Auto-diagnostica fallos y reanuda sesiones caídas — hasta 2 reintentos. Errores no recuperables fallan inmediatamente. Configurable via session.max_auto_resumes.

Automatización Git

Auto-commit, auto-push, auto-PR tras aprobación. Perfiles de revisión: standard, strict, relaxed, paranoid.

Gestión Inteligente de Sesiones

Pausa/reanudación con detección fail-fast. Resiliencia ante rate limits con auto-fallback. Checkpoints interactivos cada 5 minutos.

Descomposición de Tareas

Triage detecta cuándo dividir tareas y crea subtareas vinculadas en Planning Game.

‹

›

Calidad y Testing

Karajan Code esta testeado con 2599 tests automatizados en 200 ficheros de test, cubriendo cada rol del pipeline, guard, opción de config y herramienta MCP. La suite de tests se ejecuta en menos de 14 segundos con Vitest.

La calidad se aplica en múltiples capas:

• SonarQube (local, via Docker) — análisis estático completo con quality gates, bloquea en issues críticos
• SonarCloud (cloud, sin Docker) — análisis cloud complementario, modo advisory por defecto
• Guards deterministas — checks basados en regex para operaciones destructivas, fugas de credenciales y anti-patrones de rendimiento
• TDD obligatorio — los cambios en código fuente requieren cambios correspondientes en tests

Tanto SonarQube como SonarCloud pueden ejecutarse juntos en el mismo pipeline — SonarQube como gate primario y SonarCloud como lente adicional.

Dos Modos

Karajan ofrece dos formas de trabajar:

Modo Skills — 8 slash commands (/kj-code, /kj-review, /kj-run, etc.) instalados directamente en Claude Code. Cada comando incluye guardrails integrados. Sin servidor MCP — ideal para flujos con un solo agente. Instalar con kj init.

Modo Orchestrator — Servidor MCP completo con 23 herramientas. Pipeline multi-agente con orquestación de subprocesos, gestión de sesiones, tracking de presupuesto y resiliencia ante rate limits. Ideal para tareas complejas e integración CI/CD.

Ambos modos pueden convivir. Usa skills para tareas rápidas y el orchestrator cuando necesites múltiples agentes o control total del pipeline. Ver la Guía de Skills para detalles.

Siguientes Pasos

• Instalación — Instalar Karajan Code
• Inicio Rápido — Ejecutar tu primera tarea
• Modo Skills — Usar como slash commands