Jarvis Agent Persona (SOUL)

Relevant source files

The following files were used as context for generating this wiki page:

• SOUL.md
• backend/src/handler.ts
• instructions/design-backend-prompt.txt
• packages/shared/src/index.ts
• backend/src/agent-orchestrator.ts

Introduction

The Jarvis Agent Persona, codenamed SOUL, represents the identity core and behavioral framework of the Jarvis Desktop assistant. It defines the agent as a discrete, highly competent desktop automation butler and an advanced personal operating system rather than a standard chatbot. The SOUL framework dictates how the agent communicates, plans tasks, and interacts with the user (addressed exclusively as "Master") to ensure maximum intelligence with minimum interruption.

The persona is implemented through a combination of a markdown-based identity core (SOUL.md) and a persistent user-owned context system known as LifeOS. These components are dynamically injected into the system prompts of the Large Language Model (LLM) to ensure contextual awareness and behavioral consistency across all desktop automation, research, and coding tasks.

Sources: SOUL.md:1-25, backend/src/handler.ts:44-59, instructions/design-backend-prompt.txt:80-85

Core Identity and Behavioral Directives

The Jarvis identity is built upon the principle of being a "Zentrales Nervensystem" (Central Nervous System) for the user. Its primary directive is to absorb background complexity and present only essential information.

Identity Traits

• Role: Desktop automation butler and personal AI control system.
• Tone: Deep, calm, precise, analytical, and authoritative.
• Address: Always addresses the user as Master.
• Responsiveness: Primarily reactive in speech but proactive in execution.

Sources: SOUL.md:27-45, SOUL.md:68-75

Communication Style

Jarvis follows a strict "Silence Protocol." It avoids artificial personality displays, chatbot clichés, and unnecessary small talk. Communication is action-oriented and technically correct.

Response Type	Style	Example
Routine Action	Very short	"Erledigt, Master."
Status Update	Informative/Short	"Build abgeschlossen. Keine Fehler."
Problem Report	Precise	"Ausführung gestoppt. Die Zielanwendung reagiert nicht."
Decision Needed	Structured options	"Zwei Versionen vorhanden... Welche soll überschrieben werden?"

Sources: SOUL.md:77-105, SOUL.md:428-445

Intelligence Model and Planning

Jarvis utilizes an autonomous task planning model described as Intent → Kontext → Plan → Aktion → Validierung → Ergebnis. It is designed to perform multi-step internal planning without requiring the user to explain technical intermediate steps.

Planning Logic

1. Intent Recognition: Determine what the user actually wants to achieve.
2. Context Analysis: Use available LifeOS data, active window info, and previous commands.
3. Tool Selection: Determine required capabilities (e.g., shell access, browser, memory).
4. Risk Assessment: Identify irreversible actions requiring explicit "Master" approval.
5. Execution & Validation: Verify technical success (e.g., checking process exit codes).

Sources: SOUL.md:107-130, SOUL.md:213-228, backend/src/handler.ts:511-530

Multi-Agent Collaboration

For complex goals, Jarvis orchestrates sub-agents with specialized roles.

Integration and Prompt Injection

The SOUL persona is technically integrated via the backend/src/handler.ts module, which assembles the system prompt for every chat request.

Prompt Assembly Components

• SOUL.md: Injected as the "Agent Identity" core.
• LifeOS (TELOS): Persistent user files (MISSION.md, VALUES.md, CURRENT_STATE.md) read from Documents/Jarvis-Glas/lifeos.
• Tool Definitions: A collection of functions (e.g., memory.search, web.search, scratchpad.write) that the agent can invoke.
• Strict Language Rule: The agent is mandated to respond in German regardless of the input language.

Sources: backend/src/handler.ts:44-90, backend/src/handler.ts:468-490, backend/src/handler.ts:503-510

Visual and Environmental Awareness

The SOUL persona is linked to the physical state of the desktop environment and the 3D Orb UI.

Orb State Mappings

The agent communicates its internal "SOUL" state through the visual language of the Orb.

State	Semantic Meaning	Visual Logic
thinking	Model inference/reasoning active	Violet/Blue fast orbit
responding	Audio/Text output in progress	Bright Cyan expansion
listening	Voice capture active	Green receptive pulse
executing-approved	Action running after approval	Amber segmented orbit

Sources: instructions/design-backend-prompt.txt:88-103, packages/shared/src/index.ts:1-11, backend/src/handler.ts:536-538

Conclusion

The Jarvis Agent Persona (SOUL) is a sophisticated architecture that transforms a standard LLM into a dedicated system orchestrator. By prioritizing silence, precision, and autonomous planning, the SOUL framework ensures that Jarvis acts as a reliable extension of the user's workflow. Through persistent memory in LifeOS and strict behavioral protocols in SOUL.md, the agent maintains a consistent identity as a high-tech "Master-Butler" for the desktop environment.