# Personas

A persona is someone, or something, your product is for: a shop manager, a
nightly indexer, an agent that answers support mail. Personas are who plays
your [use cases](https://alepha.dev/lore/docs/plan-use-cases.md), and the reason a requirement
exists at all.

Personas are part of the **Requirements** option of the **Plan** capability, a
switch under **Plan** in **Settings ▸ General ▸ Capabilities**. It is off until
you turn it on. Turning it off hides **Requirements** in the sidebar and
deletes nothing.

## The Personas tab

**Requirements** in the sidebar opens a page with three tabs: **Requirements**,
**Use cases** and **Personas**. The **Personas** tab draws one card per
persona, numbered `#A1`, `#A2` and so on, with its kind, its role and the
first line of its goals. The kind filter at the top shows **Human**,
**System** or **Agent** personas only.

![The Personas tab](/screenshots/lore/requirements-personas-light.png)

A banner says what is left **to cover**: the personas with no passing use
case, and the use cases never run.

**New persona** (also in the **Create** menu) opens the form:

| Field                           | What it holds                                               |
| ------------------------------- | ----------------------------------------------------------- |
| **Name**                        | How everyone calls them: `Léa`, `Indexer`.                  |
| **Kind**                        | **Human**, **System** or **Agent**.                         |
| **Role**                        | What they do, in a few words.                               |
| **Who they are**                | A paragraph, in Markdown.                                   |
| **Goals**, **Frustrations**     | What they come for, and what gets in their way.             |
| **Alepha role**                 | The role the app gives them, as text.                       |
| **Demo account**, **Demo seed** | The login a tester uses, and the seed file that creates it. |
| **App**, **Environment**        | The app copy they use: what **Open as** opens.              |
| **Areas**                       | The areas of the project they touch.                        |

Reading personas needs `persona:read`, which every rank has, the **Viewer**
included. Writing needs `persona:write`.

## A persona's page

Opening a card shows the persona's identity card on the left and its tabs:

- **Overview**: who they are, their goals and frustrations, and a **Changes**
  card when their scope changed.
- **Changes**: the quests completed since the persona's last run that touch
  them, each saying how it was found: through an epic covering one of their
  use cases, or because it mentions them (`[[#A2]]`). Below, **What's new for**
  the persona lists every such quest, release by release.
- **Showcase**: the latest recording of each of their use cases, per release,
  read from the evidence of their runs. The tab hides while there is no
  recording.
- **Activity**: who changed what, and when.

When a quest touching the persona completes after their last run, a banner
says the scope changed and how many use cases to verify again.

**Open as** opens the persona's app copy in a new tab. Lore signs no one in:
copy the demo account from the identity card and sign in yourself. The button
is hidden when the persona names no copy, or the copy is gone, and is refused
on a production copy. **Verify** opens the [Verify dialog](https://alepha.dev/lore/docs/plan-verify.md)
for all the persona's use cases.

## From the command line

```bash
lore persona list --project acme
lore persona create --name "Léa" --kind human --role "Shop manager"
lore persona get A1
lore persona comment add A1 --body "Interviewed on Tuesday"
```

See [The lore CLI](https://alepha.dev/lore/docs/reference-cli.md).

## From an agent

An agent reads and writes personas with `persona_list`, `persona_get`,
`persona_create`, `persona_update`, `persona_delete` and
`persona_comment_add`. A persona is referenced as `[[#A2]]` in any quest,
epic, folio or comment, and the reference becomes a link. The full list is in
[MCP tools](https://alepha.dev/lore/docs/reference-mcp-tools.md).

## Next

- [Use cases](https://alepha.dev/lore/docs/plan-use-cases.md): what personas do.
- [Verify and runs](https://alepha.dev/lore/docs/plan-verify.md): checking that they still can.
