Modos unificados: combina herramientas, permisos y comportamientos
En esta página
Lección actualizada el 2 de noviembre de 2026. Los archivos de agente de ejemplo usan ahora las claves documentadas por Vibe:
instructions(en lugar desystem_prompt),active_model(en lugar demodel), bloques[tools.<tool>]para aprobaciones (la claveauto_approveno existe en un archivo de agente) y nombres reales de herramientas (edit, noedit_file; sin herramientalist_dir). Recordatorio de la Lección 3:safetyes un indicador visual, no un permiso. Fuente: Referencia de configuración.
El concepto de modos unificados
Los agentes personalizados que hemos visto en lecciones anteriores definen un perfil estático: un modelo, un conjunto de herramientas y un nivel de seguridad. Los modos unificados van más allá al combinar múltiples dimensiones en una única configuración coherente que puedes activar con un solo gesto. Un modo unificado agrupa herramientas autorizadas, permisos específicos, comportamiento guiado por el prompt del sistema, reglas de aprobación automática y restricciones contextuales.
El valor resulta evidente cuando tu trabajo cambia varias veces en un mismo día. Sin modos unificados, tienes que gestionar múltiples configuraciones cada vez que cambia tu contexto: pasas de la revisión de código al despliegue y debes cambiar de agente, ajustar permisos y modificar el prompt. Un modo unificado encapsula todo eso en un único perfil, que activas al iniciar la sesión o a mitad de ella.
# Activar el modo "deploy"
vibe --agent deploy-mode
# Cambiar al modo "review"
# Mayús+Tab → seleccionar review-mode
Estructura de un modo unificado
Técnicamente, un modo unificado es un agente personalizado; la diferencia con un agente clásico es conceptual. Ya no diseñas el archivo .toml como «un asistente que puede hacer X», sino como un contexto de trabajo completo: qué tienes permitido hacer durante esta fase del proyecto, con qué nivel de precaución y en qué formato recibes los resultados.
El modo de revisión siguiente ilustra esto con claridad. Es de solo lectura, por lo que se aprueba automáticamente sin riesgo, y su prompt impone un formato de informe que puedes incluir directamente en una pull request.
# ~/.vibe/agents/review-mode.toml
display_name = "Review Mode"
description = "Modo de revisión de código: solo lectura, análisis profundo, sugerencias."
safety = "safe"
active_model = "mistral-medium-3.5" # modelo integrado en Vibe
instructions = """
Estás en modo de revisión de código.
Objetivo: analizar la calidad, seguridad y mantenibilidad del código.
Reglas:
- Nunca modifiques archivos
- Genera un informe estructurado (incidencias críticas, advertencias, sugerencias)
- Cita las líneas de código afectadas con sus números de línea
- Propón correcciones como diffs
Formato de salida: Markdown con secciones Crítico / Advertencia / Sugerencia
"""
enabled_tools = [
"read_file",
"grep",
]
[tools.read_file]
permission = "always"
[tools.grep]
permission = "always"
El modo de despliegue es exactamente lo opuesto, y ese contraste es intencionado. Incluye bash, por lo que puede romper cosas, pero sus permisos ask en write_file y bash te mantienen en el bucle de control, y su prompt describe una secuencia estricta que el agente debe seguir de principio a fin.
# ~/.vibe/agents/deploy-mode.toml
display_name = "Deploy Mode"
description = "Modo de despliegue: compilación, pruebas y despliegue con validación en cada paso."
safety = "destructive"
active_model = "codestral" # alias declarado en config.toml (Lección 2)
instructions = """
Estás en modo de despliegue.
Secuencia obligatoria:
1. Verifica que todas las pruebas pasan
2. Compila el proyecto
3. Valida la compilación (sin errores, sin advertencias)
4. Solicita confirmación antes del despliegue real
5. Despliega
6. Verifica que el servicio responde
Nunca despliegues si las pruebas fallan.
"""
enabled_tools = [
"read_file",
"write_file",
"bash",
"grep",
"ask_user_question"
]
[tools.write_file]
permission = "ask"
[tools.bash]
permission = "ask"
Diseño de modos complementarios
La idea consiste en crear un conjunto de modos que cubran tu ciclo de desarrollo, desde la exploración hasta la corrección. El modo de exploración abre el camino: es de solo lectura y se aprueba automáticamente, lo que te ayuda a entender un repositorio antes de tocar nada.
display_name = "Explore Mode"
safety = "safe"
instructions = """Explora la base de código, identifica la arquitectura, los patrones y las dependencias."""
enabled_tools = ["read_file", "grep",]
[tools.read_file]
permission = "always"
[tools.grep]
permission = "always"
A continuación llega el modo Dev, donde pasarás la mayor parte del tiempo. Escribe y ejecuta comandos —para lanzar pruebas, por ejemplo—, pero solicita tu aprobación y su prompt vincula cada cambio a la escritura de pruebas.
display_name = "Dev Mode"
safety = "neutral"
instructions = """Implementa las funcionalidades solicitadas. Escribe pruebas para cada cambio."""
enabled_tools = ["read_file", "write_file", "edit", "bash", "grep",]
[tools.write_file]
permission = "ask"
[tools.edit]
permission = "ask"
[tools.bash]
permission = "ask"
Por último, el modo Fix es deliberadamente estrecho. Sin write_file, solo edit: el agente modifica código existente sin crear nuevos archivos, lo que evita que «refactorice de paso» un error que simplemente le pediste corregir. Al estar tan restringido, podemos aprobarlo automáticamente con seguridad.
display_name = "Fix Mode"
safety = "neutral"
instructions = """Corrige los errores reportados. Minimiza los cambios. Toca solo el código afectado."""
enabled_tools = ["read_file", "edit", "grep"]
[tools.read_file]
permission = "always"
[tools.edit]
permission = "always"
[tools.grep]
permission = "always"
Cambio entre modos y organización
En una sesión interactiva, Mayús+Tab alterna entre modos: Vibe muestra la lista de todos tus agentes, integrados y personalizados, con sus descripciones; aquí es donde resultan útiles las descripciones cuidadosas de la lección anterior. Desde la línea de comandos, inicias directamente en un modo o inspeccionas el contenido del directorio de agentes.
# Iniciar directamente en un modo
vibe --agent review-mode
# Listar agentes disponibles
ls ~/.vibe/agents/
Por último, adopta una convención de nomenclatura clara. El sufijo -mode distingue inmediatamente tus contextos de trabajo de agentes utilitarios más ad hoc, y el orden alfabético del directorio se mantiene legible incluso tras una docena de archivos.
~/.vibe/agents/
├── review-mode.toml # Revisión de código
├── deploy-mode.toml # Despliegue
├── dev-mode.toml # Desarrollo
├── fix-mode.toml # Correcciones
├── explore-mode.toml # Exploración
└── doc-mode.toml # Documentación
Puntos clave
- Un modo unificado es un agente personalizado diseñado como un contexto de trabajo completo
- Combina herramientas, permisos, prompt del sistema y modelo en una única configuración
- Crea modos complementarios para cubrir tu ciclo de desarrollo
Mayús+Tabte permite cambiar entre modos en tiempo real- Nombra tus archivos de forma consistente para encontrarlos fácilmente
- Cada modo debe tener un objetivo claro y permisos adecuados