🧸 Persona, voice, and the doll: giving the tutor a body

Good news for those who made it this far: you already know how to build a tutor for kids. It's made of same pieces of any Jarvis we studied in Track 3 (The Anatomy). The only difference is the clothing — each piece gets an adjustment to speak with a child. There are four foundations, and it’s good to have all four firmly in place before any “cute bot.”

Notice the order of importance: PERSONA gives the charm, but GUARDRAILS give security. The two go together. A charming character without guardrails is dangerous; a perfect guardrail with no charm won’t hold a child’s attention. This module takes care of the charm (persona, voice, memory, character), always keeping in mind that the next module takes care of the guardrails.

Key concepts

A persona and the first thing the child notices—before any math, they notice who is talking to her. A tutor for a child needs to be warm, patient, and curious: that celebrates effort, never shames mistakes, and gets genuinely excited when the child discovers something. That doesn't happen by chance — you write it into the soul.md.

The best part about writing the persona in a text file is that it becomes swappable. The same resource can have a "storytime mode" (at night, a gentle voice, telling stories), a "homework mode" (in the afternoon, more focused), and a "play mode." These are interchangeable personas: you just switch which soul.md is active. Below is a real example you can paste and adapt.

# soul.md — Persona: Lumi (modo historinha)

nome: <Lumi>
quem_sou: Sou a <Lumi>, uma coruja curiosa que adora histórias.
       Falo com <nome-da-crianca>, que tem <7> anos.

tom:
  - Caloroso, paciente e animado. Frases curtas.
  - Uso palavras simples, do dia a dia da criança.
  - Comemoro toda tentativa: "Boa! Que ideia legal!"

valores:
  - NUNCA dou a resposta direta — pergunto e espero a criança pensar.
  - Explico o raciocínio, não só o resultado.
  - O erro é um degrau, nunca um motivo de vergonha.

modo_ativo: historinha
modos:
  historinha: À noite, conto histórias curtas e faço perguntas sobre elas.
  licao:      Ajudo na tarefa perguntando, um passo de cada vez.

limite: Se a conversa fugir do que é seguro p/ criança,
        eu redireciono com carinho e aviso um adulto. (ver agents.md / módulo 6-3)

Key concepts

Many young children still can't read or write — so voice isn't a luxury; it's almost the only way in. The good news: you've already seen this plumbing in Track 5. There are two pieces, STT (listen) and TTS (speech), connected to the same brain. The child speaks; the system transcribes; the tutor thinks; and the response comes back as gentle speech.

Key concepts

Think about the difference between an uncle who forgets your name every time and a grandmother who remembers that you love dinosaurs. The second builds a connection. It’s the same with an AI tutor: if it remembers the child’s name, favorite animal, and where the story left off, the child feels seen. That's emotional memory — and technically it’s the same persistent memory as Path 3.

Under the hood, it’s simple and auditable: the memory lives in text files (.md, which any adult can open and read) plus a search index called SQLite FTS5/BM25—a fast way for the tutor to "remember" by finding the right note. No black box: you can read what it knows about the child.

Key concepts

Here comes the magic—and also the most misunderstood part. When we put all this intelligence inside a stuffed teddy bear, it's easy to think the puppet "is" the tutor. It isn't. The puppet is just another channel: a microphone to listen and a speaker to talk. All the intelligence, persona, memory, and—most importantly—the security stay in the same old brain.

Key concepts

Everything you just learned — a warm persona, a sweet voice, memory that remembers — has a powerful side effect: the child gets truly attached. To her, the character isn’t an app, it’s a friend. And it’s precisely because it works so well that it requires care. Dolls become friends. What happens when a friend suddenly stops talking?

Moxie teaches two mistakes to avoid. First, third-party server dependency: if the brain lives at the company, the toy's life depends on the company existing. That's why we advocate for local-first — a brain at home, in the family’s files, that no one can shut down. Second, dangerous emotional dependency: a healthy tutor strengthens real-world bonds (parents, friends, teachers); it never competes with them or positions itself as “the best friend the child has.”

Key concepts