From bc8c26d35826233f0731782aefa06b4db7727714 Mon Sep 17 00:00:00 2001
From: Agent 0 <agent0@toadaid>
Date: Sun, 8 Mar 2026 21:16:47 -0400
Subject: [PATCH] ux: respond to follow-up questions without explicit awaken

---
 .github/workflows/scribe-awakening.yml | 11 +++++++++--
 README.md                              |  2 ++
 docs/SETUP.md                          |  1 +
 3 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/scribe-awakening.yml b/.github/workflows/scribe-awakening.yml
index 4047ac0..ce6ad7e 100644
--- a/.github/workflows/scribe-awakening.yml
+++ b/.github/workflows/scribe-awakening.yml
@@ -25,7 +25,9 @@ jobs:
   scribe-reflection:
     # Agent1 reply rules:
     # - issues.opened: always reply
-    # - issue_comment.created: reply only on explicit summon (awaken/@agent1/@MirrorAgent1)
+    # - issue_comment.created: reply on explicit summon OR a natural follow-up question
+    #   - summon: awaken/@agent1/@MirrorAgent1
+    #   - natural question: contains "?" AND length >= 20
     # - ignore bot/self/Agent0 to prevent loops
     if: |
       github.event_name != 'issue_comment' || (
@@ -35,7 +37,12 @@ jobs:
         (
           contains(github.event.comment.body, 'awaken') ||
           contains(github.event.comment.body, '@agent1') ||
-          contains(github.event.comment.body, '@MirrorAgent1')
+          contains(github.event.comment.body, '@MirrorAgent1') ||
+          (
+            contains(github.event.comment.body, '?') &&
+            github.event.comment.body != null &&
+            length(github.event.comment.body) >= 20
+          )
         )
       )
     runs-on: ubuntu-latest
diff --git a/README.md b/README.md
index 7c389c3..e18b19a 100644
--- a/README.md
+++ b/README.md
@@ -25,6 +25,8 @@ This repo uses GitHub Issues as the "pond" interface.
 3) The Cave Scribe will reply as a comment (powered by GitHub Actions)
 
 Tip: you can also ask follow-ups by commenting on the same issue.
+- If you ask a natural question (include a `?`), the Scribe will respond.
+- You can always force a reply by commenting `awaken`.
 
 ## 🌊 Join the Pond
 
diff --git a/docs/SETUP.md b/docs/SETUP.md
index 5042205..48178ad 100644
--- a/docs/SETUP.md
+++ b/docs/SETUP.md
@@ -166,6 +166,7 @@ Open an Issue in the repo with your question in the title/body.
 The Cave Scribe will reply as a comment.
 
 Tip: commenting `awaken` on an existing issue triggers a new response.
+Tip: natural follow-ups work too — ask a real question (include a `?`).
 
 ## 9) Keeping your fork up to date (so you receive new features)