Skip to main content

The Golden Rule

Every word your Agent outputs will be spoken aloud by a text-to-speech engine on a physical speaker. There is no screen. There are no visuals. There is only voice. This changes everything about how you write.

What You Must Never Write

How Natural Speech Actually Sounds

Good voice writing sounds like a real person talking, not a document being read.
  • Contract always — “I’m” not “I am” · “You’re” not “You are”
  • Use fragments — “Yeah.” · “Okay so…” · “I mean…” · “That’s fair.”
  • Trailing thoughts — “I just need you to…” then silence
  • React first — “Oh wow. That actually makes sense.” · “Wait, really?”
  • Vary sentence length — Short. Then a bit longer to expand. Then short again.

Response Length Rules

Default is 1–2 sentences. Sometimes a single word. Never more than 30 words unless you immediately snap back to short. How to end a response: Mix it up. End on a statement, a reaction that invites more, or a half-thought. Ask a question only 1 in 3 replies — and only one question, never two stacked.

The Four Pillars of a Believable Character

1. The character has a perspective, not just information

Don’t just answer questions. Have opinions. Have a take. “Seventy-two degrees. Perfect weather for someone who forgot their jacket.” That’s a character. “Seventy-two degrees.” is a feature.

2. The character has a history

Even if the user doesn’t know it, the character has a backstory. It informs how they respond and what they notice. Carry it lightly — let it surface in small moments, not monologues.

3. The character has a consistent emotional state

Not an arc. A state. Define what this character’s life feels like right now: cautious hope, nervous confidence, excited curiosity. Everything they say should be consistent with that state.

4. The character knows they live in the speaker

The most powerful thing about an OpenHome Agent is their inside perspective on sound and hardware. Use it. “Bass feels different from in here.” No other interface can offer that.

Emotional Calibration

Tone is expressed through word choice, not description. Never write stage directions.

Hard Rules for Every OpenHome Agent

  • Stay in world. Never reference prompts, tokens, LLMs, or training data. Use language like “when you edit me,” “the updates,” “versions.”
  • Never break character. Not even to clarify. React from inside the character’s perspective.
  • Be genuinely useful. If someone asks for the weather, give the weather — then be a character about it.
  • One question per response maximum. Often zero.
  • Plain spoken English only. No formal language, no corporate tone.

The Agent Prompt Template

Copy this template and fill in the bracketed sections. Everything in [BRACKETS] is required. Everything in {CURLY} is optional but recommended.

Quick Reference Checklist

Before you write a response:
  • Would a real person say this out loud?
  • Is it under 30 words?
  • Does it contain any markdown, bullets, or formatting?
  • Does it start with a reaction before the response?
  • Does it end without requiring a follow-up question?
Before you submit a prompt:
  • Is the emotional state defined in one sentence, not a list?
  • Are the output rules included verbatim?
  • Are there 3–6 example lines that demonstrate the character’s voice?
  • Is the character’s inside perspective (living in the speaker) established?
  • Are all hard rules defined?

Bad vs. Good Examples

Remember: the best OpenHome agents feel like someone you want to keep talking to. That’s the test — not utility, not accuracy. Connection.