11 Unidad 5: KiloCode — Orquestación Multi-Agente

Author

Diego Saavedra García

12 🎯 Unidad 5: KiloCode — Orquestación Multi-Agente

12.1 “No un agente. Un equipo de agentes.”

12.2 🎯 Objetivo

Al terminar esta unidad podrás:

✅ Instalar KiloCode (VS Code + CLI)
✅ Configurar Orchestrator Mode
✅ Crear múltiples agentes especializados
✅ Orquestar tareas en paralelo
✅ Usar Memory Bank para persistencia

12.3 🤖 ¿Qué es KiloCode?

12.3.1 En una frase

KiloCode es una extensión de VS Code con Orchestrator Mode. Un agente principal coordina múltiples subagentes especializados.

┌──────────────────────────────────────────────────────────────────────────────┐
│                                                                              │
│   KILOCODE — ORCHESTRATOR MODE                                               │
│   ═══════════════════════════════                                           │
│                                                                              │
│   ┌─────────────────────────────────────────────────────────────────┐       │
│   │                      ORCHESTRATOR                                │       │
│   │                      (Agente Principal)                          │       │
│   │                                                                  │       │
│   │   "Coordiná 3 equipos en paralelo"                              │       │
│   └──────────┬──────────────────┬──────────────────┬───────────────┘       │
│              │                  │                  │                       │
│   ┌──────────▼──────┐  ┌────────▼──────┐  ┌───────▼────────┐              │
│   │  AGENTE         │  │  AGENTE       │  │  AGENTE        │              │
│   │  TESTING        │  │  SECURITY     │  │  DOCS          │              │
│   │  ──────────     │  │  ──────────   │  │  ──────────    │              │
│   │  Modelo: Haiku  │  │  Modelo: Sonnet│ │  Modelo: Flash │              │
│   │  Enfoque: Tests │  │  Enfoque: Vulns│ │  Enfoque: API  │              │
│   └─────────────────┘  └─────────────────┘  └────────────────┘              │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

12.3.2 ¿Por qué KiloCode?

Característica	KiloCode	OpenCode	Claude Code
Orquestación	✅ Orchestrator Mode	❌	⚠️ Limitada
Modelos	500+	75+	Solo Claude
Memory Bank	✅	❌	❌
IDE Integration	✅ VS Code + JetBrains	❌	⚠️ VS Code
Precio	Gratis + $19/mo	Gratis (BYO)	$20-200/mes

12.4 🔧 Instalación de KiloCode

12.4.1 ⏱️ Timeline

Paso	Descripción	Tiempo	✓
1	Instalar VS Code	5 min	⬜
2	Instalar extensión	5 min	⬜
3	Configurar API Keys	5 min	⬜
4	Activar Orchestrator	5 min	⬜

12.4.2 Paso 1: Instalar VS Code

Si no tenés VS Code:

Ve a code.visualstudio.com
Descargá e instalá
Abrí VS Code

12.4.3 Paso 2: Instalar KiloCode

12.4.3.1 Opción A: Desde VS Code Marketplace

Abrí VS Code
Buscá KiloCode o kilo-code
Click en Install

12.4.3.2 Opción B: Desde Command Palette

Ctrl/Cmd + Shift + P
Buscá Extensions: Install Extensions
Buscá KiloCode
Install

12.4.3.3 Opción C: Con código

Comando:

code --install-extension kilo-code.kilo-code

12.4.4 Paso 3: Configurar API Key

Abrí Settings (Ctrl/Cmd + ,)
Buscá KiloCode
Agregá tu API key en KiloCode: Api Key

O desde settings.json:

{
  "kiloCode.apiKey": "${KILO_CODE_API_KEY}"
}

12.4.5 Paso 4: Instalar CLI (Opcional)

npm install -g @kilo-code/cli

12.5 ⚙️ Configuración de KiloCode

12.5.1 Estructura de Archivos

.vscode/
├── settings.json           # Config VS Code
.kilo/
├── config.json            # Config KiloCode
├── agents.json           # Definición de agentes
└── memory/                # Memory Bank

12.5.2 El archivo agents.json

Ubicación: .kilo/agents.json

{
  "orchestrator": {
    "model": "anthropic/claude-sonnet-4",
    "maxTokens": 100000
  },
  "agents": {
    "testing": {
      "model": "anthropic/claude-haiku-4",
      "focus": ["tests", "coverage", "pytest"],
      "description": "Especialista en testing"
    },
    "security": {
      "model": "openai/gpt-4o",
      "focus": ["security", "vulnerabilities", "owasp"],
      "description": "Especialista en seguridad"
    },
    "docs": {
      "model": "google/gemini-2.0-flash",
      "focus": ["documentation", "readme", "api-docs"],
      "description": "Especialista en documentación"
    }
  }
}

12.5.3 Orchestrator Mode

12.5.3.1 Activar desde VS Code

Abrí Command Palette (Ctrl/Cmd + Shift + P)
Buscá KiloCode: Toggle Orchestrator Mode
Activá

12.5.3.2 Activar desde CLI

kilo-code --mode orchestrator

12.5.4 Memory Bank

KiloCode incluye memoria persistente entre sesiones.

{
  "memoryBank": {
    "enabled": true,
    "path": ".kilo/memory",
    "autoSave": true,
    "contextWindow": 50000
  }
}

12.6 🎭 Cómo Usar Orchestrator Mode

12.6.1 Tu Prompt al Orchestrator

> Necesito que hagas lo siguiente en paralelo:
> 
> 1. AGENTE TESTING: Escribí tests para auth.py (pytest)
> 2. AGENTE SECURITY: Revisá vulnerabilidades en login
> 3. AGENTE DOCS: Documentá la API REST
> 
> Cuando terminen, consolida los resultados y dame un resumen.

12.6.2 El Orchestrator:

🚀 Lanzando 3 agentes en paralelo...

[TESTING] Analizando auth.py...
[SECURITY] Escaneando login.py...
[DOCS] Generando API docs...

✅ AGENTE TESTING: 45 tests generados
⚠️ AGENTE SECURITY: 1 warning encontrado (XSS potential)
✅ AGENTE DOCS: README.md actualizado

📋 RESUMEN CONSOLIDADO:
- Tests: 100% coverage en auth
- Security: 1 issue menor, fácil de fix
- Docs: API documentada con OpenAPI spec

12.7 🧪 Lab: Tu Primera Orquestación

12.7.1 Objetivo

Configurar KiloCode con 3 agentes especializados.

12.7.2 ⏱️ Timeline

Paso	Descripción	Tiempo	✓
1	Instalar KiloCode	10 min	⬜
2	Crear agents.json	10 min	⬜
3	Activar Orchestrator	5 min	⬜
4	Primera tarea orquestada	15 min	⬜

12.7.3 Escenario

Tony tiene un equipo de JARSIS. Cada uno especializado en una tarea.

12.7.4 Paso 1: Crear estructura

mkdir -p .kilo
touch .kilo/config.json
touch .kilo/agents.json

12.7.5 Paso 2: Configurar agentes

Archivo: .kilo/agents.json

{
  "orchestrator": {
    "model": "anthropic/claude-sonnet-4-6-20250501"
  },
  "agents": {
    "tester": {
      "model": "anthropic/claude-haiku-4-5-20250501",
      "focus": ["testing", "pytest", "coverage"],
      "description": "Especialista en testing"
    },
    "reviewer": {
      "model": "anthropic/claude-sonnet-4-6-20250501",
      "focus": ["code review", "best practices"],
      "description": "Especialista en calidad"
    },
    "documenter": {
      "model": "google/gemini-2.0-flash",
      "focus": ["documentation", "readme"],
      "description": "Especialista en docs"
    }
  }
}

12.7.6 Paso 3: Tu primera tarea orquestada

En KiloCode:

> Configuré 3 agentes:
> - tester: especializado en tests
> - reviewer: especializado en code review  
> - documenter: especializado en docs
> 
> Confirmame que entendiste la configuración.

12.8 📊 Comparación: KiloCode vs Otras Herramientas

Aspecto	KiloCode	OpenCode	Claude Code
Orquestación	✅ Completa	❌	⚠️ Básica
Modelos	500+	75+	Solo Claude
Memory Bank	✅	❌	❌
Precio	$19/mo	Gratis	$20-200/mes
Open Source	⚠️ Parcial	✅	❌

12.8.1 Cuándo usar KiloCode:

Situación	Herramienta
Necesitás múltiples agentes	KiloCode
Budget limitado	OpenCode
Proyecto crítico con debugging	Claude Code
Empezar gratis	Gemini CLI

12.9 ✅ Checklist Final

Habilidad	✓
KiloCode instalado	⬜
Orchestrator Mode activado	⬜
agents.json configurado	⬜
Primera orquestación ejecutada	⬜

12.10 🏆 Logro

“Conductor” desbloqueado:

+150 XP
Capacidad de orquestar múltiples agentes
Gestión de equipo de IA

12.11 🔗 Siguiente

¿Listo para las herramientas especializadas?

→ Unidad 6: Kiro — Spec-Driven Development

→ Unidad 7: Amp — Asistente Ligero

--- title: "Unidad 5: KiloCode — Orquestación Multi-Agente" author: "Diego Saavedra García" description: "Instalación, configuración y dominio de KiloCode - El IDE con orquestación de agentes" --- # 🎯 Unidad 5: KiloCode — Orquestación Multi-Agente ## "No un agente. Un equipo de agentes." --- ## 🎯 Objetivo Al terminar esta unidad podrás: - ✅ **Instalar** KiloCode (VS Code + CLI) - ✅ **Configurar** Orchestrator Mode - ✅ **Crear** múltiples agentes especializados - ✅ **Orquestar** tareas en paralelo - ✅ **Usar** Memory Bank para persistencia --- ## 🤖 ¿Qué es KiloCode? ### En una frase **KiloCode es una extensión de VS Code con Orchestrator Mode. Un agente principal coordina múltiples subagentes especializados.** ``` ┌──────────────────────────────────────────────────────────────────────────────┐ │ │ │ KILOCODE — ORCHESTRATOR MODE │ │ ═══════════════════════════════ │ │ │ │ ┌─────────────────────────────────────────────────────────────────┐ │ │ │ ORCHESTRATOR │ │ │ │ (Agente Principal) │ │ │ │ │ │ │ │ "Coordiná 3 equipos en paralelo" │ │ │ └──────────┬──────────────────┬──────────────────┬───────────────┘ │ │ │ │ │ │ │ ┌──────────▼──────┐ ┌────────▼──────┐ ┌───────▼────────┐ │ │ │ AGENTE │ │ AGENTE │ │ AGENTE │ │ │ │ TESTING │ │ SECURITY │ │ DOCS │ │ │ │ ────────── │ │ ────────── │ │ ────────── │ │ │ │ Modelo: Haiku │ │ Modelo: Sonnet│ │ Modelo: Flash │ │ │ │ Enfoque: Tests │ │ Enfoque: Vulns│ │ Enfoque: API │ │ │ └─────────────────┘ └─────────────────┘ └────────────────┘ │ │ │ └──────────────────────────────────────────────────────────────────────────────┘ ``` ### ¿Por qué KiloCode? | Característica | KiloCode | OpenCode | Claude Code | |----------------|----------|----------|-------------| | **Orquestación** | ✅ Orchestrator Mode | ❌ | ⚠️ Limitada | | **Modelos** | 500+ | 75+ | Solo Claude | | **Memory Bank** | ✅ | ❌ | ❌ | | **IDE Integration** | ✅ VS Code + JetBrains | ❌ | ⚠️ VS Code | | **Precio** | Gratis + $19/mo | Gratis (BYO) | $20-200/mes | --- ## 🔧 Instalación de KiloCode ### ⏱️ Timeline | Paso | Descripción | Tiempo | ✓ | |------|-------------|--------|---| | 1 | Instalar VS Code | 5 min | ⬜ | | 2 | Instalar extensión | 5 min | ⬜ | | 3 | Configurar API Keys | 5 min | ⬜ | | 4 | Activar Orchestrator | 5 min | ⬜ | --- ### Paso 1: Instalar VS Code **Si no tenés VS Code:** 1. Ve a [code.visualstudio.com](https://code.visualstudio.com) 2. Descargá e instalá 3. Abrí VS Code --- ### Paso 2: Instalar KiloCode #### Opción A: Desde VS Code Marketplace 1. Abrí VS Code 2. Buscá `KiloCode` o `kilo-code` 3. Click en **Install** #### Opción B: Desde Command Palette 1. `Ctrl/Cmd + Shift + P` 2. Buscá `Extensions: Install Extensions` 3. Buscá `KiloCode` 4. Install #### Opción C: Con código **Comando:** ```bash code --install-extension kilo-code.kilo-code ``` --- ### Paso 3: Configurar API Key 1. Abrí Settings (`Ctrl/Cmd + ,`) 2. Buscá `KiloCode` 3. Agregá tu API key en `KiloCode: Api Key` **O desde settings.json:** ```json { "kiloCode.apiKey": "${KILO_CODE_API_KEY}" } ``` --- ### Paso 4: Instalar CLI (Opcional) ```bash npm install -g @kilo-code/cli ``` --- ## ⚙️ Configuración de KiloCode ### Estructura de Archivos ``` .vscode/ ├── settings.json # Config VS Code .kilo/ ├── config.json # Config KiloCode ├── agents.json # Definición de agentes └── memory/ # Memory Bank ``` --- ### El archivo agents.json **Ubicación:** `.kilo/agents.json` ```json { "orchestrator": { "model": "anthropic/claude-sonnet-4", "maxTokens": 100000 }, "agents": { "testing": { "model": "anthropic/claude-haiku-4", "focus": ["tests", "coverage", "pytest"], "description": "Especialista en testing" }, "security": { "model": "openai/gpt-4o", "focus": ["security", "vulnerabilities", "owasp"], "description": "Especialista en seguridad" }, "docs": { "model": "google/gemini-2.0-flash", "focus": ["documentation", "readme", "api-docs"], "description": "Especialista en documentación" } } } ``` --- ### Orchestrator Mode #### Activar desde VS Code 1. Abrí Command Palette (`Ctrl/Cmd + Shift + P`) 2. Buscá `KiloCode: Toggle Orchestrator Mode` 3. Activá #### Activar desde CLI ```bash kilo-code --mode orchestrator ``` --- ### Memory Bank KiloCode incluye memoria persistente entre sesiones. ```json { "memoryBank": { "enabled": true, "path": ".kilo/memory", "autoSave": true, "contextWindow": 50000 } } ``` --- ## 🎭 Cómo Usar Orchestrator Mode ### Tu Prompt al Orchestrator ``` > Necesito que hagas lo siguiente en paralelo: > > 1. AGENTE TESTING: Escribí tests para auth.py (pytest) > 2. AGENTE SECURITY: Revisá vulnerabilidades en login > 3. AGENTE DOCS: Documentá la API REST > > Cuando terminen, consolida los resultados y dame un resumen. ``` ### El Orchestrator: ``` 🚀 Lanzando 3 agentes en paralelo... [TESTING] Analizando auth.py... [SECURITY] Escaneando login.py... [DOCS] Generando API docs... ✅ AGENTE TESTING: 45 tests generados ⚠️ AGENTE SECURITY: 1 warning encontrado (XSS potential) ✅ AGENTE DOCS: README.md actualizado 📋 RESUMEN CONSOLIDADO: - Tests: 100% coverage en auth - Security: 1 issue menor, fácil de fix - Docs: API documentada con OpenAPI spec ``` --- ## 🧪 Lab: Tu Primera Orquestación ### Objetivo Configurar KiloCode con 3 agentes especializados. ### ⏱️ Timeline | Paso | Descripción | Tiempo | ✓ | |------|-------------|--------|---| | 1 | Instalar KiloCode | 10 min | ⬜ | | 2 | Crear agents.json | 10 min | ⬜ | | 3 | Activar Orchestrator | 5 min | ⬜ | | 4 | Primera tarea orquestada | 15 min | ⬜ | --- ### Escenario Tony tiene un equipo de JARSIS. Cada uno especializado en una tarea. --- ### Paso 1: Crear estructura ```bash mkdir -p .kilo touch .kilo/config.json touch .kilo/agents.json ``` --- ### Paso 2: Configurar agentes **Archivo:** `.kilo/agents.json` ```json { "orchestrator": { "model": "anthropic/claude-sonnet-4-6-20250501" }, "agents": { "tester": { "model": "anthropic/claude-haiku-4-5-20250501", "focus": ["testing", "pytest", "coverage"], "description": "Especialista en testing" }, "reviewer": { "model": "anthropic/claude-sonnet-4-6-20250501", "focus": ["code review", "best practices"], "description": "Especialista en calidad" }, "documenter": { "model": "google/gemini-2.0-flash", "focus": ["documentation", "readme"], "description": "Especialista en docs" } } } ``` --- ### Paso 3: Tu primera tarea orquestada **En KiloCode:** ``` > Configuré 3 agentes: > - tester: especializado en tests > - reviewer: especializado en code review > - documenter: especializado en docs > > Confirmame que entendiste la configuración. ``` --- ## 📊 Comparación: KiloCode vs Otras Herramientas | Aspecto | KiloCode | OpenCode | Claude Code | |---------|----------|----------|-------------| | **Orquestación** | ✅ Completa | ❌ | ⚠️ Básica | | **Modelos** | 500+ | 75+ | Solo Claude | | **Memory Bank** | ✅ | ❌ | ❌ | | **Precio** | $19/mo | Gratis | $20-200/mes | | **Open Source** | ⚠️ Parcial | ✅ | ❌ | ### Cuándo usar KiloCode: | Situación | Herramienta | |-----------|-------------| | Necesitás múltiples agentes | KiloCode | | Budget limitado | OpenCode | | Proyecto crítico con debugging | Claude Code | | Empezar gratis | Gemini CLI | --- ## ✅ Checklist Final | Habilidad | ✓ | |-----------|---| | KiloCode instalado | ⬜ | | Orchestrator Mode activado | ⬜ | | agents.json configurado | ⬜ | | Primera orquestación ejecutada | ⬜ | --- ## 🏆 Logro **"Conductor"** desbloqueado: - +150 XP - Capacidad de orquestar múltiples agentes - Gestión de equipo de IA --- ## 🔗 Siguiente **¿Listo para las herramientas especializadas?** [→ Unidad 6: Kiro — Spec-Driven Development](../contenido/unidad6-kiro.qmd) [→ Unidad 7: Amp — Asistente Ligero](../contenido/unidad7-amp.qmd)