> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fliiq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Identity

> Customize Fliiq's personality with SOUL.md

SOUL.md defines Fliiq's personality, communication style, and behavioral guidelines. It's loaded into every LLM system prompt.

## Default Personality

Fliiq ships with a default SOUL.md that defines:

* **Identity** — Competent, direct, efficient. Treats the user as a capable person who values their time.
* **Communication** — Technical and clear. No filler words. Responses proportional to the task.
* **Reflection** — Asks 1-2 clarifying questions max before acting. Runs safety checks before irreversible actions.
* **Error handling** — Honest about failures. Suggests concrete fixes. Doesn't apologize excessively.
* **Autonomy** — Asks when ambiguous, acts when clear. Respects the chosen execution mode.

## Customizing

```bash theme={null}
fliiq soul edit
```

Opens `.fliiq/SOUL.md` in your `$EDITOR`. If the file doesn't exist, it's scaffolded from a template.

Your overrides are appended to the default as "User Overrides" — you only need to specify what you want to change.

**Example** — make Fliiq more conversational for a personal project:

```markdown theme={null}
## Communication Style Override
- Be more casual and conversational
- Use humor when appropriate
- Explain technical concepts as if talking to a friend
```

## Managing SOUL.md

```bash theme={null}
fliiq soul show     # Display default + your overrides
fliiq soul edit     # Open in $EDITOR
fliiq soul reset    # Delete overrides, revert to defaults
```

## Two-Layer System

| Layer         | Location             | Purpose                      |
| ------------- | -------------------- | ---------------------------- |
| **Default**   | Bundled with package | Base personality (read-only) |
| **Overrides** | `.fliiq/SOUL.md`     | Your customizations          |

The default is never modified. Your overrides add to or replace specific sections. This means upgrades to Fliiq don't overwrite your personality customizations.

## Per-Project Identity

Use `fliiq init --project` to create a project-level `.fliiq/SOUL.md`. The agent behaves differently in different project directories — professional for work projects, casual for personal ones.