https://gitlab.synchro.net/main/sbbs/-/commit/5cbe1fab2f98678027cdf926
Modified Files:
src/doors/clans-src/release/prompt.md
Log Message:
Strengthen quest generator prompt from first real-world LLM generation feedback
Feedback from an LLM generating the "Under the Stone Sky" quest pack using
the older prompt version. Changes address observed failures, knowledge gaps, and ambiguities that caused backtracking or incorrect assumptions.
Observed failures:
- Add Silent IntroTopic to COMMON GENERATION FAILURES (WRONG/RIGHT examples)
- Require unconditional Text in every IntroTopic (field description + catchup
example updated)
- Add file-handling discipline section: initialize before appending, checkpoint
after each location cluster, verify on failure
- Add >> delimiter bold warning at first mention in syntax rules
- Add post-write verification for flag table >> delimiters in output order
Engine behaviour documentation:
- Add command visibility section (always/conditionally/always silent)
- Add automatic pause insertion points (after IntroTopic, Topic, EndChat, quest)
- Add pause deduplication behaviour (consecutive pauses collapsed by flag)
- Add color code error handling (ecomp does not validate; garbled output, not crash)
- Document EndChat in IntroTopic still consumes a chat slot
- Document execution model: unreached Result blocks have no side effects
- Document quests.hlp constraints (no line limit, 254 chars/line, 22-line pages)
- Document HereNews supports pipe codes, timing tied to OddsOfSeeing roll
- Document GiveItem allows duplicates (separate inventory slots)
- Document Prompt is pure text output (no input waiting)
- Document Chat with missing NPC prints error, no crash
- Document Option limit: 16 per menu
- Clarify XP formula in plain language (damage/difficulty, not C variables)
Specification gaps:
- Add NpcFile to alias cross-reference check (was missing from 4-source list)
- Document NPC info file split mirrors chat file split
- Add lore keeper + daily quest hub combination guidance
- Tie ambient NPC generation sequence to file-handling (minimum 3 tool calls)
Source code reference cleanup:
- Replace all C identifiers with plain-language equivalents throughout
(bytecode, rputs, door_pause, JustPaused, MyOpen, RunEvent, Status=Here,
QuestsDone/bitmask/bitwise, FIGHTSPERDAY, ChatsToday, NPC_ChatNPC,
Topics[].Known, PClan.*, Damage/3+1 formula, \n\r, today.asc)
Clarity improvements:
- Rewrite generation rhythm as numbered procedural sequence (removes
ambiguous "do not pause" / "continue immediately" idioms)
- Trim redundant chat-only context restatement in TellTopic description
- Remove Useless Old Man reference (not described in prompt)
Co-Authored-By: Claude Opus 4.6 <
noreply@anthropic.com>
---
■ Synchronet ■ Vertrauen ■ Home of Synchronet ■ [vert/cvs/bbs].synchro.net