Struct Soul 

pub struct Soul {
    pub identity: String,
    pub core_beliefs: String,
    pub communication_style: String,
    pub scope_and_boundaries: String,
    pub source_path: String,
}

Parsed representation of a SOUL.md document.

Runtime completely read-only — user-provided identity document. The agent cannot write or modify this struct after loading.

Fields

identity: String

## Identity — who the agent is: name, role, persona description

core_beliefs: String

## Core Beliefs — non-negotiable values (OpenClaw: “Core Truths”)

communication_style: String

## Communication Style — tone, language preferences, reply style

scope_and_boundaries: String

## Scope & Boundaries — what the agent will and will not do

source_path: String

Source path (for display/logging only)

Implementations

impl Soul

pub fn parse(content: &str, source_path: &str) -> Self

Parse a SOUL.md string into a Soul struct.

Section detection is case-insensitive. Content before the first ## heading is treated as a preamble and ignored.

pub fn load(path: &Path) -> Result<Self>

Load a SOUL.md file from disk.

pub fn auto_load(explicit_path: Option<&str>, workspace: &str) -> Option<Self>

Auto-discover and load SOUL.md from the resolution chain.

Returns None if no SOUL.md is found anywhere in the chain.

pub fn offer_bootstrap_soul_if_missing( workspace: &str, explicit_path: Option<&str>, ) -> bool

If no SOUL exists in the resolution chain and stdin is a TTY, prompt the user to create a minimal template at workspace/.skilllite/SOUL.md. When the user confirms (y/Y), write MINIMAL_SOUL_TEMPLATE and return true; otherwise return false. Does nothing when explicit_path is Some (user already chose a path) or when not interactive (no TTY).

pub fn to_planning_scope_block(&self) -> Option<String>

Render the SOUL Scope & Boundaries as a planning constraint block (A8).

Injected into the planning prompt so the LLM respects “in scope” / “out of scope” when generating task lists. Planning must NOT create tasks that violate these rules.

pub fn to_system_prompt_block(&self) -> String

Render the SOUL as a system prompt injection block.

Only non-empty sections are included to keep the prompt lean.

Trait Implementations

impl Clone for Soul

fn clone(&self) -> Soul

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Soul

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.