docs: add Carl-bot role hierarchy troubleshooting entry

WHAT WAS DONE:
- Added troubleshooting entry to holly-wanderer-permissions-setup.md
- Documents the gray circle symptom in Carl-bot Autoroles dashboard
- Explains root cause: bot role must be above any role it assigns
- Includes fix steps and verification method

WHY:
Encountered live on 2026-03-28. New members were joining and
receiving no role. Root cause was Carl-bot's role positioned below
Wanderer in the Discord role hierarchy. One-drag fix. Documented
immediately so this is never a mystery again.

FILES MODIFIED:
- docs/guides/holly-wanderer-permissions-setup.md

Signed-off-by: Chronicler #45 <claude@firefrostgaming.com>
This commit is contained in:
Claude (Chronicler #45)
2026-03-28 20:46:38 +00:00
parent 3d7ae4d784
commit 01e5785d82

View File

@@ -343,6 +343,30 @@ They can participate in Community Hub for free, but they KNOW there's more conte
---
### **Problem: Carl-bot not assigning Wanderer role to new members (role shows gray in dashboard)**
**Symptoms:**
- New members join and receive no role at all
- In Carl-bot dashboard → Autoroles, the Wanderer role tag shows a **gray circle** on the left instead of a colored one
**Root Cause:**
Discord requires a bot's role to be **higher in the role hierarchy** than any role it tries to assign. If Carl-bot's role sits below Wanderer in the list, Discord silently blocks the assignment.
**Fix:**
1. Go to **Server Settings → Roles**
2. Find Carl-bot's role in the list
3. **Drag it above Wanderer**
4. Save
**Verification:**
The Wanderer role tag in Carl-bot's Autoroles dashboard will show a **colored circle** (not gray) once the hierarchy is correct. Test with a fresh join or by removing Wanderer from a test account and rejoining.
**Date Encountered:** March 28, 2026
**Fixed By:** Michael (Frostystyle)
**Diagnosed By:** Chronicler #45
---
## 📊 PERMISSION SUMMARY CHEAT SHEET
| Role | View Channel | Send Messages | Access |