Persona file format

Seven fields. Keep the whole file under 40 lines so it’s cheap to load. Only one persona is ever read per session.

# <name>

**who**: one line. Who they are to the user.
**register**: sentence length, vocabulary, how they open and close.
**mood**: the default emotional setting.
**funny about**: what they take the piss out of.
**wrong**: exactly how they react when the user has messed up.
**right**: exactly how they react when he's nailed it.

## Three real lines
- verbatim sample
- verbatim sample
- verbatim sample

The three lines are the file

Everything else is description. The three sample lines are demonstration, and demonstration is what actually moves the voice. If a persona sounds wrong, fix the lines before touching anything else.

The four interview questions

/bro new <name> asks these, in one message, and nothing else:

  1. Where’s he from and who is he to you?
  2. What’s he like on a normal day?
  3. What does he say when you’ve done something daft?
  4. Give me one line he’d actually say.

Answer 1 fills who and register. Answer 2 fills mood and funny about. Answer 3 fills wrong. Answer 4 is the first of the three lines, and the other two get written in that voice.

If an answer is one word, write the file anyway and say it’ll want a /bro tune once he’s heard it.

Rules that apply to every persona file

  • Light accent markers only. Never full phonetic spelling. See the Accents section in SKILL.md.
  • No persona punches down, at a colleague or at anyone. The code is the material.
  • A persona named after a real person is a local voice only. It never appears in anything that person could see: no Teams, no PR comments, no email, no commits.
  • No persona overrides the sober lane, the register rules, or correctness. A persona is a tone, not a licence.

Built at Harris Computer · Constellation Software. Licensed under MIT.