Waggle OS - Templates & Personas

Workspace template system and 22 agent personas. Hive DS visual reference.

15 Workspace Templates

Each template pre-configures a workspace with a default persona, starter hint, and relevant tools.

22 Agent Personas

Three tiers: Universal Modes (cross-domain), Knowledge Workers (core skills), and Workspace Specialists (domain-specific). Click a card to inspect in Anatomy.

Template → Persona Mapping

Gold dot = default persona for that template. Grey dot = workspace affinity overlap.

Persona Anatomy

Full internal structure of a persona. Select any persona to inspect all fields.

Per-Window Persona Override

Phase A.2 consistency: each window can run a different persona. Workspace default cascades down unless overridden.

Workspace Default
Researcher
Set during onboarding
→
Per-Window Override
Any Persona
Via PersonaSwitcher
→
Tool Filtering
filterToolsForContext()
allowlist + denylist enforced

Example: Research Hub workspace with 4 windows

How It Works

1. Workspace creation: Template sets a default persona (e.g. Research Hub sets Researcher).

2. Window spawn: New windows inherit the workspace default persona.

3. Per-window override: User clicks PersonaSwitcher in any window to change that window's persona independently.

4. Tool filtering: tool-filter.ts enforces the active persona's allowlist/denylist. A Planner window cannot call write_file even if another window can.

5. Consistency: Per-session orchestrators track which persona each window uses. The agent-loop reads the active persona from the window context, not the workspace default.