refactor: record learning M247 - acknowledge user messages mid-operation

Author: cowwoc

.claude/cat/retrospectives/mistakes.json

@@ -52,6 +52,33 @@
         "catches_variations": true
       },
       "correct_behavior": "Search conversation for --- XXX --- marker in PRE-COMPUTED WORK BOXES, copy entire box verbatim, only replace placeholder text with actual values"
+    },
+    {
+      "id": "M247",
+      "timestamp": "2026-01-25T14:10:00Z",
+      "category": "protocol_violation",
+      "description": "Ignored user's mid-operation message embedded in system-reminder, continued with task completion without acknowledging",
+      "root_cause": "Focused on task completion over user interaction; did not parse system-reminders for user messages mid-operation",
+      "rca_method": "B",
+      "rca_method_name": "taxonomy",
+      "prevention_type": "skill",
+      "prevention_path": "${CLAUDE_PROJECT_DIR}/plugin/hooks/inject-session-instructions.sh",
+      "pattern_keywords": [
+        "user message",
+        "system-reminder",
+        "acknowledge",
+        "mid-operation",
+        "ignored"
+      ],
+      "prevention_implemented": true,
+      "prevention_verified": true,
+      "recurrence_of": null,
+      "prevention_quality": {
+        "verification_type": "positive",
+        "fragility": "medium",
+        "catches_variations": true
+      },
+      "correct_behavior": "When user input arrives mid-operation: STOP, ACKNOWLEDGE the message in response text, then address or track before continuing"
     }
   ]
 }

.claude/cat/retrospectives/retrospectives.json

@@ -1,6 +1,6 @@
 {
   "last_retrospective": "2026-01-25T00:00:00Z",
-  "mistake_count_since_last": 2,
+  "mistake_count_since_last": 3,
   "config": {
     "mistake_count_threshold": 5,
     "trigger_interval_days": 7

plugin/hooks/inject-session-instructions.sh

@@ -44,9 +44,10 @@ MESSAGE=$(cat << 'INSTRUCTIONS'
 
 **When user input arrives mid-operation**:
 1. **STOP** current task analysis immediately
-2. Track with TaskCreate if needed (all issues, even just 2-3 items)
-3. If impacts current task → address now; else → add to end
-4. Acknowledge before continuing
+2. **ACKNOWLEDGE** the user's message in your response text
+3. Track with TaskCreate if needed (all issues, even just 2-3 items)
+4. If impacts current task → address now; else → add to end
+5. Continue only after acknowledgment
 
 **Common failure**: Continuing to analyze tool output while ignoring embedded user request.
 

plugin/hooks/prompt_handlers/user_issues.py

@@ -45,6 +45,12 @@
     "wrong output",
     "wrong result",
     "incorrect result",
+    # M247: User message handling failures
+    "ignored",
+    "you ignored",
+    "didn't acknowledge",
+    "didn't respond to",
+    "expected behavior",
 ]