dream-content-authoring

name

dream-content-authoring

description

Use when writing, editing, or reviewing dream-of-one player-facing content — Korean NPC dialogue and tone, storylets, scenario canon, suspicion why-lines, HUD strings, or six-locale localization. Triggers include "storylet", "대사", "말투", "why-line", "이유 문장", "Korean voice", and "localization keys". NOT for engineering docs, code comments, runtime logic (dream-npc-runtime), or client presentation (dream-godot-client).

Dream of One — Content Authoring

Write player-facing content — Korean dialogue and tone, storylets, scenario canon, HUD strings — inside the repo's canon and voice contract. Paths below are from the repository root; the cited docs stay the source of truth.

Canon First

Reuse before writing. Active canon lives in docs/scenario/ — the file map is docs/scenario/content/README.md. New canon must follow docs/game/content-guide.md and use docs/game/glossary.md terms exactly: do not coin synonyms for Station, record, civic ledger, suspicion signal, route, or storylet.

Tone and Setting

• Mundane-administrative with a low hum of wrongness. NPCs are polite, procedural, never cartoonishly sinister; dread comes from how ordinary the questions are and how permanent records feel.
• Stateless district: no real-world countries, cities, brands, currencies, or holidays. Generic-administrative naming (스테이션, 구역/번호, 스튜디오); role titles over surnames. Korean is the authoring language, but nothing in the text may pin the place to Korea.
• Register follows docs/scenario/content/korean-voice-notes.md: 존댓말 defaults, clipped clerk speech, the Station's flat officialese.
• Role voice separation is strict: NPC speech, player choices, and system/HUD text use distinct registers and are never cross-attributed.

What Content May and May Not Contain

Production storylets carry scene facts, actor goals, ending thresholds, and outcome presentation only. They never contain choice lists, NPC reply sequences, classification rules, or ordered social consequences — live wording and judgment come from the selected provider. Fixed dialogue lives only in scripted test adapters. Provider failure is a visible simulation interruption and must never select a production line-bank response.

Every suspicion movement needs a player-readable why-line (이유 문장) in the run locale; Korean remains the authored source. Prompt-side content must never introduce facts absent from the NPC's visible context.

Owner-set never-accept failures — content and prompts actively defend against them: an NPC breaking the fiction (admitting it is an AI, referencing the real world) and an NPC contradicting what it just said.

Localization

Author Korean first, then localize through the same content path into English, Italian, Simplified Chinese, French, and Japanese. The exact locale contract, parity timing, and terminology rules live in docs/game/content-guide.md and the active plan under docs/plan/. Player-facing strings live in content files and translation keys, not code.

Verification

Storylet data validates inside the backend check; localization keys have a headless smoke:

bun run --cwd backend/npc-runtime check
$GODOT_BIN --headless --path godot --script res://tools/localization_smoke.gd

Read Before Writing

Doc	When
docs/game/content-guide.md	every content slice
docs/scenario/content/korean-voice-notes.md	any Korean wording
docs/game/glossary.md	naming anything
docs/game/core-loop.md	answer surface, suggestion gradient, session shape

Gotchas

• Store-specific scenario pages are M1 regression/source material. Do not restore commerce, the Store layout, authored choices, or ordered reactions in M3R; adapt tone and procedural pressure to studio, office, park, and Station through docs/game/content-guide.md.
• A record can change factual memory and institutional pressure, but it cannot directly move a resident's personal stance. That requires remembered real speech; a vouch additionally requires meaningful first-hand player contact.
• Keep hidden speech hidden. Player-facing logs may name an encountered provenance chain without revealing words the player never heard or later learned in-world.