diff --git a/CLAUDE.md b/CLAUDE.md
index 4dbf2ef..d745136 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -80,6 +80,10 @@ utils/pkgs/<package-name>/
 └── (other files like patches, lock files)
 ```
 
+## Workflow
+
+**IMPORTANT: Always run `./scripts/test-configuration <hostname>` after making any changes** to verify the NixOS configuration builds successfully. This is required before committing.
+
 ## Conventions
 
 - Nix files: two-space indentation, lower kebab-case naming