Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Unified Modes: combineer tools, machtigingen en gedrag

Les 4 van 14 Bijgewerkt op 2 november 2026 Gevorderd
Op deze pagina
  1. Het concept van unified modes
  2. Structuur van een unified mode
  3. Complementaire modes ontwerpen
  4. Wisselen tussen modes en deze organiseren
  5. Belangrijkste punten

Les bijgewerkt op 2 november 2026. Voorbeeldagentbestanden gebruiken nu sleutels zoals gedocumenteerd door Vibe: instructions (niet system_prompt), active_model (niet model), [tools.<tool>]-blokken voor goedkeuringen (de sleutel auto_approve bestaat niet in een agentbestand), en echte toolnamen (edit, niet edit_file; geen list_dir-tool). Herinnering uit Les 3: safety is een visuele indicator, geen machtiging. Bron: Configuratiereferentie.

Het concept van unified modes

De aangepaste agents die we in eerdere lessen hebben behandeld, definiëren een statisch profiel: een model, een set tools en een veiligheidsniveau. Unified modes gaan verder door meerdere dimensies te combineren tot één coherente configuratie die u met één gebaar kunt activeren. Een unified mode bundelt geautoriseerde tools, specifieke machtigingen, door systeemprompts gestuurd gedrag, regels voor automatische goedkeuring en contextuele beperkingen.

De waarde wordt duidelijk wanneer uw werk meerdere keren per dag verschuift. Zonder unified modes moet u telkens dat uw context verandert, meerdere instellingen beheren: u gaat van code review naar implementatie en moet agents wisselen, machtigingen aanpassen en de prompt tweaken. Een unified mode kapselt dit alles in één profiel, dat u bij het opstarten of midden in een sessie activeert.

# Schakel "deploy"-modus in
vibe --agent deploy-mode

# Schakel over naar "review"-modus
# Shift+Tab → selecteer review-mode

Structuur van een unified mode

Technisch gezien is een unified mode een aangepaste agent; het verschil met een klassieke agent is conceptueel. U ontwerpt het .toml-bestand niet langer als “een assistent die X kan doen”, maar als een volledige werkcontext: wat u tijdens deze fase van het project mag doen, met welk voorzichtigheidsniveau en in welke vorm resultaten naar u terugkomen.

De onderstaande review-modus illustreert dit het duidelijkst. Deze is read-only, waardoor deze zonder risico automatisch wordt goedgekeurd, en de prompt dwingt een rapportformaat af dat u direct in een pull request kunt plakken.

# ~/.vibe/agents/review-mode.toml
display_name = "Review Mode"
description = "Code review mode: read-only, deep analysis, suggestions."

safety = "safe"
active_model = "mistral-medium-3.5"  # model ingebouwd in Vibe

instructions = """
You are in code review mode.
Goal: analyze code quality, security, and maintainability.
Rules:
- Never modify files
- Produce a structured report (critical issues, warnings, suggestions)
- Cite affected code lines with their line numbers
- Propose fixes as diffs
Output format: Markdown with Critical / Warning / Suggestion sections
"""

enabled_tools = [
  "read_file",
  "grep",
]

[tools.read_file]
permission = "always"

[tools.grep]
permission = "always"

Deploy-modus is het exacte tegenovergestelde, en dat contrast is opzettelijk. Deze bevat bash, dus kan dingen breken, maar de ask-machtigingen voor write_file en bash houden u in de lus, en de prompt beschrijft een strikte volgorde die de agent van begin tot eind moet volgen.

# ~/.vibe/agents/deploy-mode.toml
display_name = "Deploy Mode"
description = "Deploy mode: build, test, deploy with validation at each step."

safety = "destructive"
active_model = "codestral"  # alias gedeclareerd in config.toml (Les 2)

instructions = """
You are in deploy mode.
Mandatory sequence:
1. Verify that all tests pass
2. Build the project
3. Validate the build (no errors, no warnings)
4. Request confirmation before actual deployment
5. Deploy
6. Verify that the service responds
Never deploy if tests fail.
"""

enabled_tools = [
  "read_file",
  "write_file",
  "bash",
  "grep",
  "ask_user_question"
]

[tools.write_file]
permission = "ask"

[tools.bash]
permission = "ask"

Complementaire modes ontwerpen

Het idee is om een set modes te creëren die uw ontwikkelcyclus dekken, van ontdekking tot reparatie. De exploratiemodus leidt de dans: read-only en automatisch goedgekeurd, helpt deze u een repository te begrijpen voordat u er iets aan verandert.

display_name = "Explore Mode"
safety = "safe"
instructions = """Explore the codebase, identify the architecture, patterns, and dependencies."""
enabled_tools = ["read_file", "grep",]

[tools.read_file]
permission = "always"

[tools.grep]
permission = "always"

Vervolgens komt Dev-modus, waarin u het grootste deel van uw tijd zult doorbrengen. Deze schrijft en voert commando’s uit—om bijvoorbeeld tests te draaien—maar vraagt om uw goedkeuring, en de prompt koppelt elke wijziging aan het schrijven van tests.

display_name = "Dev Mode"
safety = "neutral"
instructions = """Implement the requested features. Write tests for every change."""
enabled_tools = ["read_file", "write_file", "edit", "bash", "grep",]

[tools.write_file]
permission = "ask"

[tools.edit]
permission = "ask"

[tools.bash]
permission = "ask"

Tot slot is Fix-modus bewust smal. Geen write_file, alleen edit: de agent wijzigt bestaande code zonder nieuwe bestanden aan te maken, wat voorkomt dat deze “onderweg refactort” aan een bug die u simpelweg hebt gevraagd te repareren. Omdat deze zo beperkt is, kunnen we deze veilig automatisch goedkeuren.

display_name = "Fix Mode"
safety = "neutral"
instructions = """Fix reported bugs. Minimize changes. Touch only the affected code."""
enabled_tools = ["read_file", "edit", "grep"]

[tools.read_file]
permission = "always"

[tools.edit]
permission = "always"

[tools.grep]
permission = "always"

Wisselen tussen modes en deze organiseren

In een interactieve sessie bladert Shift+Tab door de modes: Vibe toont de lijst van al uw agents, zowel ingebouwd als aangepast, met hun beschrijvingen—hier werpen de zorgvuldige beschrijvingen uit de vorige les hun vruchten af. Vanaf de commandoregel start u direct in een mode, of inspecteert u de inhoud van de agents-map.

# Start direct in een mode
vibe --agent review-mode

# Toon beschikbare agents
ls ~/.vibe/agents/

Kies tot slot een duidelijke naamgevingsconventie. Het achtervoegsel -mode onderscheidt uw werkcontexten direct van meer ad-hoc utility-agents, en de alfabetische volgorde van de map blijft leesbaar, zelfs na een dozijn bestanden.

~/.vibe/agents/
├── review-mode.toml      # Code review
├── deploy-mode.toml      # Implementatie
├── dev-mode.toml         # Ontwikkeling
├── fix-mode.toml         # Reparaties
├── explore-mode.toml     # Exploratie
└── doc-mode.toml         # Documentatie

Belangrijkste punten

  • Een unified mode is een aangepaste agent die is ontworpen als een volledige werkcontext
  • Deze combineert tools, machtigingen, systeemprompt en model in één configuratie
  • Creëer complementaire modes om uw ontwikkelcyclus te dekken
  • Met Shift+Tab wisselt u in realtime tussen modes
  • Geef uw bestanden een consistente naam zodat u ze gemakkelijk kunt vinden
  • Elke mode moet een duidelijk doel en passende machtigingen hebben