Skip to content

Commit 9587690

Browse files
authored
docs(messaging): unified team reaction vocabulary (#89)
Reconciles the Common Reaction Patterns table with the team semantics the operator defined on 2026-08-13 (the it-maintenance skill's lifecycle reference now carries the identical table — this PR keeps the two skills from contradicting each other): - **👍** meant *acknowledged/receipt* here — receipts are **🤖** (agent read-receipt); 👍 is agreement ("I'm in") - **⏳** meant *in progress* — active work is **▶️** with the retire-on-stop lifecycle (redact the reaction when work stops); ⏳ is re-scoped to *waiting/queued* - **👀** scoped to *looking, no commitment* (was "started investigating") - adds **▶️ ↩️ 💡 🤖 👎** Counterpart: it-maintenance-skill MR !95 (internal).
2 parents 4fa765e + 30a9363 commit 9587690

1 file changed

Lines changed: 12 additions & 4 deletions

File tree

skills/matrix-communication/references/messaging-guide.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -48,14 +48,22 @@ uv run skills/matrix-communication/scripts/matrix-react.py "#dev:matrix.org" '$e
4848

4949
### Common Reaction Patterns
5050

51+
Unified team vocabulary (2026-08-13). Downstream copies of this table exist —
52+
when changing semantics here, keep them in sync:
53+
5154
| Emoji | Meaning | Use Case |
5255
|-------|---------|----------|
56+
| ▶️ | Actively working NOW | Set on the claim message; REDACT it when work stops — a lingering ▶️ reads as "still busy" |
5357
|| Done/Complete | Mark task as finished |
54-
| 👍 | Acknowledged | Confirm receipt |
55-
| 👀 | Looking into it | Started investigating |
58+
|| Waiting/queued | Nobody actively on it (NOT "in progress" — that is ▶️) |
5659
| 🚀 | Deployed/Shipped | Indicate release |
57-
|| In progress | Working on it |
58-
|| Failed/Blocked | Indicate problem |
60+
|| Attempt failed | Distinct from 👎 (declining) and ↩️ (questions) |
61+
| 👀 | Looking at it | No commitment to work on it |
62+
| ↩️ | Back to reporter | Went back with questions |
63+
| 💡 | Helpful | This message taught me something |
64+
| 🤖 | Agent read-receipt | The agent read it and tries to heed it |
65+
| 👍 | Agreement, I'm in | NOT a receipt acknowledgement (that is 🤖) |
66+
| 👎 | Count me out | Rather not |
5967

6068
**Workflow example:** Send "Going to reboot server" then later add checkmark reaction when complete.
6169

0 commit comments

Comments
 (0)