Add dry-rebuild alias, laptop battery widget, and commit message convention

1 files changed, 9 insertions, 1 deletions

diff --git a/CLAUDE.md b/CLAUDE.md
index 08ef55a..713c793 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -8,6 +8,13 @@ This is a NixOS flake-based configuration managing three machines: desktop, lapt
 
 ## Common Commands
 
+### Verify Changes (use this first)
+```bash
+dry-rebuild  # Alias for: nix build ~/.config/nixos#nixosConfigurations.$(hostname).config.system.build.toplevel --no-link
+```
+
+**Always run `dry-rebuild` after making changes** to catch evaluation and build errors without needing sudo or activating the system. Claude Code cannot run `sudo`, so `dry-rebuild` is the required verification step.
+
 ### Rebuild System
 ```bash
 rebuild  # Alias for: sudo nixos-rebuild switch --flake ~/.config/nixos
@@ -164,5 +171,6 @@ in
 3. **User-level modules** contain pure home-manager configuration
 4. **Hardware configuration files** are auto-generated - do not manually edit
 5. **Use unstable overlay** when you need bleeding-edge versions of specific packages
-6. **Test changes** with `nixos-rebuild switch` before committing
+6. **Verify changes** with `dry-rebuild` before committing
 7. **Format code** with nixfmt before committing
+8. **Commit messages** should be a single short sentence — no body, no bullet points, no co-author line