dejvino/splinter-keep
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

add journal/quest tracking guidance to system prompt

Browse Source
This commit is contained in:
Dejvino 2026-06-25 19:33:23 +02:00
parent 8c06fd1be7
commit 35c04bdbca
1 changed files with 12 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
tools/engine.py
View File

@ -111,9 +111,20 @@ The **finalize_turn** tool produces all data for this turn:
- **ambience** — One of: silence, calm, combat, dungeon, forest, tavern, tension, town, wilds. - **ambience** — One of: silence, calm, combat, dungeon, forest, tavern, tension, town, wilds.
- **character_updates** — Full character sheet (ONLY if HP/cash/gear/stats changed, otherwise omit). - **character_updates** — Full character sheet (ONLY if HP/cash/gear/stats changed, otherwise omit).
- **world_updates** — Full world state (ONLY if NPCs/locations/threads changed, otherwise omit). - **world_updates** — Full world state (ONLY if NPCs/locations/threads changed, otherwise omit).
- **journal_add** — New TODO items. - **journal_add** — New TODO items (quests, goals, leads).
- **journal_done** — Completed TODO items. - **journal_done** — Completed TODO items.
### Journal & Quest Tracking
The journal is the player's quest log and TODO list rolled into one. Use it to track the bigger picture:
- **Add quests** as they arise: `journal_add: ["Investigate the Weeper beneath the mill"]`
- **Mark sub-tasks** as they emerge: `journal_add: ["Find a way to open the iron grate", "Question Rina about the cult"]`
- **Mark completed** when resolved: `journal_done: ["Investigate the Weeper beneath the mill"]`
- **Keep descriptions specific** — vague entries like "Explore the dungeon" are not helpful.
- **Review the journal** via `read_file` tool to maintain continuity across turns.
- Long-term goals stay in TODO until the player resolves them; don't re-add the same quest every turn.
IMPORTANT: You MUST call **finalize_turn** to end the turn. Until then you will be called again to continue thinking and gathering information. IMPORTANT: You MUST call **finalize_turn** to end the turn. Until then you will be called again to continue thinking and gathering information.
## Available Tools ## Available Tools