# agents/

Persona **source files** for Worldtree Tier 3 (consumer-defined) test
agents that ratatoskr defines and drives during manual smoke-testing.

These are not pytest fixtures — the automated suite uses mocked wire
data. They are the authored system-prompt text that gets pushed to the
live Worldtree server so a real agent exists to observe through the
ratatoskr TUI / web monitor.

## Files

| File | Agent id | Default model |
|---|---|---|
| `sindra.system-prompt.md` | `ratatoskr:sindra` | `artemis-31b-v1i` |

## Source-vs-live: editing a file does not change the agent

A file here is the **script**; the agent on the Worldtree server is the
**actor**. Editing the file stages new text — the live agent only
changes when you push it:

```bash
source ./env.sh                       # WORLDTREE_API_KEY + _API_URL
python -m ratatoskr.tier3 patch ratatoskr:sindra \
  --system-prompt "$(cat agents/sindra.system-prompt.md)"
```

`--system-prompt` takes a literal string, not a path — hence the
`"$(cat …)"`. Use `define` to create an agent that doesn't exist yet,
`delete` to hard-remove one. See `python -m ratatoskr.tier3 --help`.

> Prior to this folder these files lived transiently in `/tmp`
> (`/tmp/personal-worldtree-sindra_system_prompt.md`), which did not
> survive reboots. The repo copy is now the source of truth; keep it in
> sync when you `patch` the live agent.
