Route user comments through CEO agent + add draft/attachment awareness

When a user comments on a Paperclip issue, the built-in automation wakes
the assigned agent directly, bypassing the CEO. This meant user instructions
(like "read the uploaded draft and route to the right agent") were ignored.

Changes:
- Plugin: add issue.comment.created event handler that wakes the CEO agent
  with the comment context (plugin-legal-ai, separate repo)
- HEARTBEAT: add steps 2b (read recent user comments) and 2c (check
  attachments) before agents start working
- CEO agent: add comment-routing section — read, check attachments, route
- Writer agent: add step 0 — check for uploaded DOCX drafts before writing

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

.claude/agents/HEARTBEAT.md

@@ -29,6 +29,37 @@ curl -s -H "Authorization: Bearer $PAPERCLIP_API_KEY" "$PAPERCLIP_API_URL/api/ag
 - תעדוף: `in_progress` קודם, אחר כך `todo`
 - אם `PAPERCLIP_TASK_ID` מוגדר — תעדף אותו
 
+## 2b. קרא תגובות אחרונות על ה-issue
+
+לפני שאתה מתחיל לעבוד, בדוק אם יש comments חדשים מחיים:
+
+```bash
+curl -s -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
+  "$PAPERCLIP_API_URL/api/issues/{issue-id}/comments" | jq '[.[] | select(.authorUserId != null)] | .[-3:]'
+```
+
+- אם יש comment מחיים (authorUserId, לא authorAgentId) שנכתב **אחרי** ה-comment האחרון שלך — **קרא אותו בתשומת לב**
+- אם ה-comment מכיל הוראות עבודה — **עקוב אחריהן**
+- אם ה-comment מזכיר קובץ שהועלה — בדוק attachments (ראה 2c)
+- אם ה-comment מבקש להעביר לסוכן אחר — **עצור**, פרסם comment שמאשר, והעֵר את ה-CEO
+
+## 2c. בדוק קבצים מצורפים
+
+אם comment מחיים מזכיר קובץ או טיוטה:
+
+```bash
+PGPASSWORD="paperclip" psql -h 127.0.0.1 -p 54329 -U paperclip -d paperclip -c "
+SELECT a.original_filename, a.content_type, a.object_key, a.byte_size
+FROM issue_attachments ia
+JOIN assets a ON a.id = ia.asset_id
+WHERE ia.issue_id = '{issue-id}'
+ORDER BY ia.created_at DESC LIMIT 5;"
+```
+
+- נתיב מלא לקובץ: `/home/chaim/.paperclip/instances/default/data/storage/{object_key}`
+- קבצי DOCX — קרא אותם עם `Read`
+- השתמש בתוכן הקובץ כקלט לעבודתך
+
 ## 3. Checkout ועבודה
 
 ```bash