Waifu card format

A waifu card is the portable definition of a character. The same card runs in Discord Waifus today and across WaifuCave as features roll out. Every card carries a schemaVersion so the format can evolve with safe migrations.

Core fields (Discord Waifus today)

Field	Type	Notes
id	string	Unique id
name / displayName	string	Identity in chat
persona	string	The personality prompt you write — identical everywhere
providerId / modelId	string	Which model powers the character
generation	object	temperature, topP, maxOutputTokens
reasoning	object	Extended-reasoning settings
availability	object	Sleep / busy schedules
tools	object	Tool-use toggle
promptLayout	object	Which prompt blocks are active + order

WaifuCave extensions (rolling out)

Field	Type	Purpose
schemaVersion	int	Format version (migrations)
slug	string	URL-safe public handle
creatorId	uuid	Owner
visibility	enum	private | unlisted | public
maturity	enum	sfw | suggestive (library stays clean)
tags	string[]	Discovery
avatar / gallery	media	Card art
vrm	media?	Optional 3D avatar for voice companion
greeting	string	Opening message
exampleDialogue	turn[]	Few-shot style anchors
loreEntries	object[]	Lightweight lorebook
voice	object?	Voice mapping for companion mode
defaultHarness	enum	discord | roleplay | story
license	enum	Remix/usage terms

The harness

A waifu’s prompt is assembled from modular blocks (identity, personality, style, guardrails, scene direction, memories, …). The persona block is the part you author and is the one constant across Discord, roleplay, and story modes.