Open app
Moonborn — Developers

Character bible from a persona

Export a persona as a markdown bible writers can edit, then re-import via Git sync. Keep the canonical Moonborn state in lockstep with your scriptwriter's drafts.

A persona inside Moonborn is structured data. Writers want a markdown file they can edit alongside scene notes. The bridge: Git sync — the canonical persona mirrors as YAML + markdown, writers edit, changes flow back.

Anatomy of the bible

Each persona exports as one file under {integrations.git.base_path}/{persona_id}.yaml:

---
id: persona_01H...
name: Mert Aksoy
version: 4
layer: Soul
desire: build something the world can't ignore
fear: being seen as ordinary
wound: a parent who measured love in achievement
growth_arc: from approval-seeking to self-trusting
---
 
Mert spent his twenties in the Istanbul tech scene. His first
company sold to a Turkish telco — a quiet exit that he still
describes as "fine."
 
(Story notes, scene snippets, voice references, etc.)

Frontmatter is the structured layers. The markdown body is your writing space.

Write in Git, sync to Moonborn

  1. Configure integrations.git.sync_direction = bidirectional (Git sync integration).
  2. Writer pulls the repo, edits the bible in their editor.
  3. Pull request → review → merge.
  4. Next Moonborn sync round reads the new frontmatter + body, runs the audit, fingerprints the new voice if Mask changed.

What you can edit safely

  • Any markdown body (notes, scene refs, voice samples).
  • Frontmatter desire, fear, wound, growth_arc (Soul).
  • name, age, location, occupation (Surface).

What requires more care

  • version — Moonborn manages. Don't bump by hand.
  • voice_fingerprint_id — Moonborn manages. Drops if you edit Mask.
  • id — never change; this is the lineage key.

What you can't do from Git

  • Trigger a regeneration (Mask refine, voice fingerprint re-compute). These run server-side; trigger via API or product UI.

Voice samples in the bible

A writer's bible isn't complete without sample dialogue. Embed it in the markdown body:

## Voice samples
 
> "Look, the thing about momentum is that nobody asks where it's
> taking you. You just keep moving."
 
> "I'm fine. (Beat.) I'm always fine."

These don't affect the persona's runtime voice — they're notes for human writers and reviewers.

Tier

Team and up (Git sync gated).

Related