add a writer-facing content pipeline under writing/

Dialogue was already plain text, so the gap was never the .yarn files. It was
that the character material a writing session needs was either missing or stored
somewhere a writer could not comfortably work.

Three things were wrong. The writing handbook was not in the repo and was cited
by SC101.yarn as though it were. The best voice material — register, verbal tics,
success/failure/passive samples — was a \n-escaped string inside a JSON field.
The named NPCs had no sheets at all, existing only as their Yarn lines.

writing/ now holds the dialogue-facing layer, at the repo root so it gets no
.meta files and is not a Unity asset:

  STYLE.md          register, the five tone moves, the ban list, branching
                    shapes, the Wrong Truth rule, flag families, candidate rules
  YARN-PRIMER.md    the one page of syntax needed to write a scene
  GLOSSARY.md       in-world and project vocabulary
  voices/           the eleven skill voices, one readable sheet each
  characters/       Bartender, Chevalier Cassian Thal, Bradford Kane
  scenes/           SC-101's brief: intent, beats, checks, constraints
  lore/             the three identity readings and the rules that bind them

STYLE.md is a digest of the Mystery Writing Handbook in the Obsidian vault, with
pointers rather than copies. The vault stays the authoring home for design work,
and Ground Truth — the solution document — deliberately stays out of this repo.

The voice sheets are generated from skill_bible.json but are the source of truth
for the prose. tools/writing/sync_voices.py folds edits back; voicelib.py
guarantees notes -> dict -> notes is identity for all eleven, so --to-json on
unchanged sheets is byte-identical. VoiceSheetSyncTests fails the build on drift
in either direction, and was verified to fail on real drift rather than merely
to pass.

SC101.yarn's header is trimmed from prose rationale to the six rules that bind
while editing that file, with the reasoning moved to the scene brief.

EditMode 42/42. YarnCheck compiles 9 files / 35 nodes.

Co-Authored-By: Claude Opus 5 <[email protected]>

NightclubArcadia/Assets/Dialogue/Scenes/SC101.yarn

@@ -1,28 +1,24 @@
 // SC-101 — The Card at the Desk. Opening candidate hooks.
 //
-// Scene files stay thin: set the stage, <<detour>> into hook nodes, return.
+// Brief, beats, checks and the reasoning behind every rule below:
+//   writing/scenes/sc101-the-card-at-the-desk.md
 //
-// Evidence rule: each candidate gets exactly one of each evidence type —
-// object, testimony, document, intuition. Preserve that balance; do not
-// stack types so trust becomes an artifact of imbalance.
-// See Assets/Candidates/candidates.json.
+// Rules that bind while editing THIS file — all six are deliberate, none is a
+// leftover. The brief says why; this is the short form so you do not have to
+// leave the file to avoid breaking it.
 //
-// Beat order: hooks fire in sequence from SC101_Desk (STANDING ORDER →
-// HOUSE POUR → FACEWORK → CONFLUENCE). Each remains an independently authored
-// node. Never <<if>>-guard a hook on another hook having fired, on any
-// $self_lean_*, or on skill_rank(...).
-//
-// Passive pattern (clue-bearing):
-//   one voice per hook, from the candidate's attached pair;
-//   the line is that character's argument, never a report;
-//   exactly one $self_lean_* write; set $found_<clue_id> alongside it.
-//
-// Four-voice exception: this opening uses four voice introductions (one per
-// pair) against the writing handbook's "cap introductions at three voices"
-// rule. Deliberate and for SC-101 only — do not "correct" it down to three,
-// and do not copy it as a new precedent elsewhere.
-//
-// Body stays neutral on purpose: no lean, no candidate attachment.
+// 1. Scene files stay thin: set the stage, <<detour>> into hook nodes, return.
+// 2. Evidence balance — one object / testimony / document / intuition per
+//    candidate. Never stack types. See Assets/Candidates/candidates.json.
+// 3. Beat order is fixed: STANDING ORDER -> HOUSE POUR -> FACEWORK ->
+//    CONFLUENCE. Never <<if>>-guard a hook on another hook having fired, on any
+//    $self_lean_*, or on skill_rank(...).
+// 4. Passive pattern for a clue-bearing hook: one voice, from the candidate's
+//    attached pair; the line is that voice's argument, never a report; exactly
+//    one $self_lean_* write, with $found_<clue_id> set alongside it.
+// 5. Four voice introductions, against the handbook cap of three. Deliberate,
+//    SC-101 only — one voice per pair. Do not correct it down, do not copy it.
+// 6. The body stays neutral: no lean, no candidate attachment outside the hooks.
 
 title: Start
 position: -17,-276