Agent Configuration
Customize your agent's personality, behavior, and capabilities using markdown configuration files. Changes are pushed live — no restart needed.
Overview#
Lobstack agents are configured through markdown files that define their personality, rules, and behavior. These files are edited from the Config tab in your dashboard and pushed to your running agent in real-time.
| File | Purpose | Priority |
|---|---|---|
| SOUL.md | Core identity and system prompt. Overrides the default base prompt. | Highest |
| PERSONA.md | Voice, tone, and communication style. | High |
| RULES.md | Behavioral constraints and guardrails. | High |
| TOOLS.md | Tool usage patterns and preferences. | Medium |
| SKILLS.md | Skill-specific instructions and behaviors. | Medium |
| MEMORY.md | Memory schema and usage guidelines. | Low |
SOUL.md — Core Identity#
The most important configuration file. SOUL.md defines who your agent is. If provided, it replaces the default system prompt entirely. This is where you define your agent's purpose, expertise, and primary behavior.
PERSONA.md — Voice & Tone#
Defines how your agent communicates. This is appended to the system prompt after SOUL.md.
RULES.md — Behavioral Guardrails#
Sets boundaries and constraints. These are hard rules the agent should always follow.
TOOLS.md — Tool Preferences#
Guides how the agent uses its available tools. Useful for setting preferences and patterns.
MEMORY.md — Memory Guidelines#
Defines how the agent should use and interpret its persistent memory system.
Live Push#
When you save a config file in the dashboard, it's immediately pushed to your running agent via the bridge's /config endpoint. The agent's system prompt is rebuilt on the next message. No restart or rebuild is required.
Prompt structure
Editing in the Dashboard#
The Agent Config panel in the dashboard provides a built-in editor for all 6 configuration files. You can access it from the Agent tab.
- Tab switching — Click any of the 6 file tabs to switch between config files
- Live preview — Toggle the preview mode to see your markdown rendered in real-time
- Reset to default — Reset any file to its default template if you want to start over
- Instant push — Changes are pushed to your running agent immediately when you save. No rebuild needed.
API access