From 10e68957b1c42c128cf537494201c9180f0fd3fa Mon Sep 17 00:00:00 2001
From: alexion <contact@alexion.dev>
Date: Wed, 22 Jul 2026 15:27:21 -0400
Subject: [PATCH] docs: require a Waybar icon mapping for new GUI apps

---
 CLAUDE.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index cd367a7..6250656 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -28,6 +28,9 @@ The domain model (Host, Module, Skeleton, Auto-loader, Enable convention, overla
 - Commit messages follow Conventional Commits, specified in `docs/conventional-commits.md`.
   Scope is the module or host the change belongs to (`fish`, `nvim`, `neogaia`), omitted for repo-wide changes.
   Keep messages free of Gitea-specific references: this repository is mirrored to GitHub, where issue and pull-request numbers resolve to unrelated things.
+- When a graphical application is added, give it a `window-rewrite` icon mapping in `modules/desktop/waybar.nix`.
+  Without one its windows fall back to the generic default glyph on the workspace indicator instead of showing a recognisable per-application icon.
+  Match on the window class, which `hyprctl clients -j | jq -r '.[].class' | sort -u` lists for the running session.
 
 ## Gotchas