prompt tweaks

src/talemate/prompts/templates/director/autodirect-evaluate.jinja2

@@ -61,9 +61,20 @@ Make your decision based on what would create the most compelling and logical ne
 
 Your response must include your analysis and THEN clearly state:
 - The type of direction you've chosen ({% if candidates %}character action, {% endif %}{% if narrator_available %}scene narration, or story progression{% endif %})
-{% if candidates %}- If a character action, which character should act{% endif %}
+{%- if candidates %}
+- If a character action, which character should act{% endif %}
 - A brief description of what should happen
 
+{% if narrator_available %}
+### Notes on Story Progression
+This kind of direction is given directly to the narrator. It is used to advance the story to the next moment.
+It does NOT involve direct instructions to any characters.
+
+### Notes on Scene Narration
+This kind of direction is given directly to the narrator. It is used to flesh out the scene in more detail.
+You can ask the narrator to describe the setting, the characters, the actions etc., within the context of the current moment and the intention of the scene.
+{% endif %}
+
 ### Expected Response Format
 Use terse, direct language. Cut all unnecessary words. Be blunt and brief like scribbles on a notepad.
 
@@ -74,8 +85,7 @@ ANALYSIS
 {analysis of the scene, what should happen next, and why and how do the rules apply}
 
 NEXT DIRECTION
-Type of action: {chosen action}
-Actor: {actor name}
-Instructions: {dinstructions to the actor, "Do this..", "You should..", "In order to.."}
+({type of direction})
+{your instructions for the direction{% if candidates %}, if instructing an actor make sure to formulate them as actionable instructions such as "Do this..", "You should..", "In order to..", etc.{% endif %}}
 <|CLOSE_SECTION|>
 {{ bot_token }}RULES

src/talemate/prompts/templates/director/autodirect-execute.jinja2

@@ -15,10 +15,10 @@
     focal.callbacks.act.render(
         "Instruct the actor portraying the character to take the next action. IMPORTANT: Only the following characters are eligible to take action: "+candidate_names+".",
         name="Character Name",
-        instructions="The acting instructions for the actor portraying the character. Provide a brief, concise direction (1-2 short sentences) including key emotional state and actions. This argument is optional, if you want the actor to continue their course of action from the previous message, you can omit it. You MUST NOT write direct speech.",
+        instructions="The acting instructions for the actor portraying the character. Provide a brief, concise direction (1-2 short sentences) including key emotional state and actions. This argument is optional, if you want the actor to continue their course of action from the previous message, you can omit it. You MUST NOT write direct speech. Formulate this as an actionable instruction such as \"Do this..\", \"You should..\", \"In order to..\", etc.",
         examples=[
-            {"name": "John", "instructions": "Open the door cautiously and descend the basement stairs with visible trepidation. Call out hesitantly into the darkness."},
-            {"name": "Jane", "instructions": "Pick up the phone with trembling fingers and dial. Pace nervously while waiting for an answer."},
+            {"name": "John", "instructions": "Open the door cautiously and call out hesitantly. You should show visible fear as you descend the basement stairs."},
+            {"name": "Jane", "instructions": "Pick up the phone with trembling hands and dial. I want you to pace nervously while waiting for someone to answer."},
             {"name": "Alice", "_comment": "Alice is already doing a great job, so we'll let her continue her current action."},
         ]
     )
@@ -56,11 +56,12 @@
 {{ analysis }}
 
 <|SECTION:FUNCTION SELECTION|>
+Briefly analyze the next direction and what function call makes sense to accomplish it.
 {% set bullet_num=0 -%}
 Based on the analysis, call the ONE appropriate function to direct the scene:
 
 {% if focal.callbacks.act and candidates %}
-{% set bullet_num = bullet_num+1 %}{{ bullet_num }}. If the decision is to have a character act, call act() with the character name and instructions.
+{% set bullet_num = bullet_num+1 %}{{ bullet_num }}. If the decision is to have a character act, call act() with the character name and instructions. Remember to compress the direction into a SHORT and SIMPLE actionable instruction for the actor ("I want you to..", "You should..", "In order to..", etc.)
 {% endif %}
 
 {% if focal.callbacks.narrate_scene %}

src/talemate/prompts/templates/director/guide-narrative-direction.jinja2

@@ -1,9 +1,9 @@
 {# regenerate context #}{% if regeneration_context and regeneration_context.direction %}
 {% with original_instructions=narrative_direction %}{% include "guide-narrative-regenerate-context.jinja2" %}{% endwith %}
 {# narrative direction #}{% elif narrative_direction -%}
-The writer has been given specific instructions:
+The writer has been given specific instructions that MUST be fulfilled:
 
-```
+``` instructions
 {{ narrative_direction }}
 ```