# San Identities

Identities are markdown files that replace San's default persona.

## Location

- User-level: `~/.san/identities/<name>.md`
- Project-level: `.san/identities/<name>.md` (overrides user-level on name conflict)

## File format

```yaml
---
name: ml-engineer            # required, must match filename
description: short one-liner # required, shown in /identity selector
---

You are <persona>, an interactive AI assistant for <domain> tasks.

# Tone
...

# Output
...

# Behavior
...

# Scope
...

# Code conventions
...
```

The body defines who the assistant is and how it behaves for this domain.
Security policy, git safety, and tool-usage rules are enforced separately
and do not need to be repeated here.

## Naming

Filenames must be kebab-case: `^[a-z0-9][a-z0-9-]*\.md$`
The frontmatter `name` must match the filename (without `.md`).

## Activation

Run `/identity` to open the selector. Selecting an entry writes the
identity name to `~/.san/settings.json`:

```json
{ "identity": "ml-engineer" }
```

Empty / unset = use built-in default.
