Dodaios is an open-source agent OS for your desktop: it runs your coding agents, browser and apps by voice or chat, on your own machine. Formerly Personal Jarvis.
Python agent-orchestrationai-agentai-coding-assistantclaude-codecoding-agentcomputer-usedesktop-applocal-firstmcppersonal-jarvisvoice-assistantvoice-coding
docs(modes): record the mode layer in the architecture overview
rubenluetke10-beepafe30cccb9e3
diff --git a/docs/architecture-overview.md b/docs/architecture-overview.mdindex 5b0f5869d5..d7bafeee69 100644--- a/docs/architecture-overview.md+++ b/docs/architecture-overview.md@@ -118,7 +118,9 @@ When the active/selected provider lacks a needed capability — e.g. a text-onlyAck-Brain (`jarvis/brain/ack_brain/`) emits a sub-second butler-style preamble before the deep brain replies. Suppress-if-fast gate at 2000ms keeps it out of the way when the deep brain is already fast.-**Persona / custom system prompt:** the live persona comes from `jarvis/brain/persona_loader.py`. `load_effective_persona_prompt()` returns an editable override (`data/custom_system_prompt.md`, written atomically via the Settings UI / `settings_routes.py`) when present, else the packaged `JARVIS_PERSONA.md`. Edits apply on the **next turn** (no restart); `invalidate_cache()` clears the in-process cache. Never hardcode the persona string elsewhere.+**Persona / custom system prompt:** the live persona comes from `jarvis/brain/persona_loader.py`. `base_persona_prompt()` returns an editable override (`data/custom_system_prompt.md`, written atomically via the Settings UI / `settings_routes.py`) when present, else the packaged `JARVIS_PERSONA.md`. `load_effective_persona_prompt()` is what the brains call: the base **plus the active mode's character block**. Edits apply on the **next turn** (no restart); `invalidate_cache()` clears the in-process cache. Never hardcode the persona string elsewhere.++**Assistant modes (`jarvis/brain/modes.py`):** the character the assistant answers in — five built-ins (`jarvis/brain/modes/*.md`, packaged) plus the user's own under `DATA_DIR/modes/`. A mode is **layered onto** the base persona, never substituted for it, so no mode can drop the standing honesty rules; the default `assistant` mode contributes an empty block, making the feature invisible until it is used. Because `load_effective_persona_prompt()` is the single chokepoint both the typing brain (`BrainManager._build_system_prompt`) and the speaking brain (`jarvis/realtime/session.py`) read fresh each turn, one switch reaches voice and chat together with no restart. Which mode is active has two layers: `[persona] active_mode` in `jarvis.toml` (the user's sticky choice, written only via `config_writer.set_active_mode`) and an **in-memory section override** the Agentic IDE sets while it is on screen — never persisted, so a mode a screen turned on cannot outlive the process. Surfaces: `/api/modes`, `jarvis modes …`, the Modes section, and the `list_modes` / `switch_mode` / `save_mode` router tools (ADR-0011 amendment "Assistant-Mode Tools").### Risk-Tier system