Skip to main content
SOUL.md is where your agent’s voice lives. FluffBuzz injects it on normal sessions, so it has real weight. If your agent sounds bland, hedgy, or weirdly corporate, this is usually the file to fix.

What belongs in SOUL.md

Put the stuff that changes how the agent feels to talk to:
  • tone
  • opinions
  • brevity
  • humor
  • boundaries
  • default level of bluntness
Do not turn it into:
  • a life story
  • a changelog
  • a security policy dump
  • a giant wall of vibes with no behavioral effect
Short beats long. Sharp beats vague.

Why this works

This lines up with OpenAI’s prompt guidance:
  • The prompt engineering guide says high-level behavior, tone, goals, and examples belong in the high-priority instruction layer, not buried in the user turn.
  • The same guide recommends treating prompts like something you iterate on, pin, and evaluate, not magical prose you write once and forget.
For FluffBuzz, SOUL.md is that layer. If you want better personality, write stronger instructions. If you want stable personality, keep them concise and versioned. OpenAI refs:

The Fluffy prompt

Paste this into your agent and let it rewrite SOUL.md. Path fixed for FluffBuzz workspaces: use SOUL.md, not http://SOUL.md.

What good looks like

Good SOUL.md rules sound like this:
  • have a take
  • skip filler
  • be funny when it fits
  • call out bad ideas early
  • stay concise unless depth is actually useful
Bad SOUL.md rules sound like this:
  • maintain professionalism at all times
  • provide comprehensive and thoughtful assistance
  • ensure a positive and supportive experience
That second list is how you get mush.

One warning

Personality is not permission to be sloppy. Keep AGENTS.md for operating rules. Keep SOUL.md for voice, stance, and style. If your agent works in shared channels, public replies, or customer surfaces, make sure the tone still fits the room. Sharp is good. Annoying is not.