Skip to content

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.

docs(agents): describe agent patterns directly instead of naming another product (#923)

Ruben Lütke481dc39bb667
diff --git a/docs/agent-society/MASTERPLAN.md b/docs/agent-society/MASTERPLAN.md
index 3e886450ae..76f887d141 100644
--- a/docs/agent-society/MASTERPLAN.md
+++ b/docs/agent-society/MASTERPLAN.md
@@ -275,8 +275,8 @@ A dedicated art-direction pass
### 4.4 Communication surfaces
-Per-agent canonical chat (persistent `agent_chat` session; routine results labeled inline — Grok's
-"Aktualisiert: Routine" pattern; approval cards). Society feed: inter-agent messages grouped by
+Per-agent canonical chat (persistent `agent_chat` session; routine results labeled inline as
+routine updates; approval cards). Society feed: inter-agent messages grouped by
thread/room, every message attributed ("Scout → Archivist"); clicking a world bubble opens the same
thread. Per-agent routines are namespaced `[agent:<name>]` entries in the existing Automations
scheduler and appear in BOTH the Automations view and the model card (finish-it-everywhere rule).
@@ -342,7 +342,7 @@ add the four controls it lacked: authenticated writes (chokepoint), bounded non-
- **Parity (AP-4):** `tier`, `state`, `msg_type` cross Python↔SQL↔Pydantic↔TS↔UI → five-layer
pattern + parity tests. `test_routing.py` gains the new router tool. World rendering gets a
headless-Chrome measurement check (recipe exists in project memory).
-- **App-closed semantics:** local-first inverts Grok's promise — a closed app freezes the society.
+- **App-closed semantics:** local-first means a closed app freezes the society.
Honest UX copy + missed-routine catch-up policy (run-once-on-next-boot per routine, opt-in).
- **Accessibility:** `prefers-reduced-motion` → static world or Ledger; keyboard/screen-reader path
= Ledger + model cards (declared equivalent); no strobe/flash effects.
diff --git a/docs/agent-society/agent-definition.md b/docs/agent-society/agent-definition.md
index 699e15c90a..3d9cbd01b3 100644
--- a/docs/agent-society/agent-definition.md
+++ b/docs/agent-society/agent-definition.md
@@ -223,7 +223,7 @@ derived focus as chips the user can add to / remove; a wrong guess is a one-clic
A "Gmail agent" therefore: keeps every tool (so it can still look something up in the wiki or
the calendar), gets Gmail listed first and briefed as its primary hand, and its description
-tells it what it owns. That is the Grok behavior ("the description stores durable rules") on top
+tells it what it owns. The description stores durable rules, layered on top
of our tiers.
### 3.3 Prompt assembly — how the agent knows the ecosystem
@@ -335,7 +335,7 @@ Gmail agent stood on the island. The team card (`dodaios/society/lead_card.py`)
"lang": "de" }` — text is for humans, `refs` are what the receiver opens. Every envelope carries
`trace_id`; a reply carries `parent_event_id`.
-### 4.3 Handoff = `RESULT` payload (Grok's record, made mandatory)
+### 4.3 Handoff = `RESULT` payload (a mandatory record)
```
{ "type": "RESULT", "status": "done | partial | blocked",
"output": ["file:...", "wiki:..."], # where the work is
@@ -398,7 +398,7 @@ vault cannot: taint state, curation cursors, FTS over agent notes — derived, r
---
-## 6. Lifecycle & housekeeping (Grok parity)
+## 6. Lifecycle & housekeeping
- **Create (2026-10-05)**: one click. The row gets a placeholder name, a random appearance
and the lead chat's current seat; its chat opens at once. On the first turn the fresh agent
@@ -431,7 +431,7 @@ vault cannot: taint state, curation cursors, FTS over agent notes — derived, r
| Agent knows the whole Jarvis ecosystem | ecosystem card + roster line in the prompt (§3.3) |
| Wiki as shared memory | §5, namespaced writes, reviewed promotion |
| Context exchange between agents | `refs` in envelopes, `RESULT` handoff record (§4.2–4.3) |
-| Per-agent approval rules like Grok | `approval_rules` under the ceiling (§3.4) |
+| Per-agent approval rules | `approval_rules` under the ceiling (§3.4) |
| Onboarding | seed proposals from connected capabilities (§6) |
---
diff --git a/dodaios/society/seeds.py b/dodaios/society/seeds.py
index 41b864d34c..a9296b788d 100644
--- a/dodaios/society/seeds.py
+++ b/dodaios/society/seeds.py
@@ -8,7 +8,7 @@ Two things happen here:
a meta flag, adoptable by name like any other agent, archivable by the
user like any other agent. An empty island reads as broken; two teammates
read as a team.
-* ``propose_seeds`` — Grok's onboarding idea done local-first: teammates
+* ``propose_seeds`` — onboarding done local-first: teammates
proposed from CONNECTED capabilities. A mail agent is proposed only when a
mail plugin is connected, a repo agent only with ``gh``, and so on. Pure
function over the catalog; the UI shows the proposals, the person picks.
diff --git a/tests/unit/ci/test_check_design_references.py b/tests/unit/ci/test_check_design_references.py
index 6c9c20e2bd..709d19ea7b 100644
--- a/tests/unit/ci/test_check_design_references.py
+++ b/tests/unit/ci/test_check_design_references.py
@@ -29,7 +29,7 @@ import check_design_references as gate # noqa: E402
"Rebuilt after a pipeline inspired by Hermes Agent",
"The quick switcher is a Spotlight-style launcher.",
"# --- the Codex-like look: filled discs, a glossy orb",
- "Approval rules — Grok-style, require wins.",
+ "Approval rules — Raycast-style, require wins.",
],
)
def test_design_references_are_flagged(line: str) -> None: