diff --git a/.goosehints b/.goosehints
new file mode 100644
index 0000000..f0bf2c7
--- /dev/null
+++ b/.goosehints
@@ -0,0 +1,21 @@
+This repository contains NixOS configurations for different machines and roles. Here's a brief overview based on the files present:
+
+- **Secrets:**
+  - `secrets/secrets.yaml`: Contains secret configurations, possibly encrypted or sensitive data.
+  
+- **Packages:**
+  - `packages/`: Nix package definitions.
+  
+- **Flake:**
+  - `flake.nix` and `flake.lock`: Nix Flake configuration files for managing the Nix environment dependencies.
+  
+- **Roles:**
+  - Various directories like `roles/kodi/`, `roles/bluetooth/`, etc., each containing `default.nix` files which possibly define role-specific configurations and modules.
+  
+- **Machines:**
+  - `machines/`: Machine-specific configurations for different machines like `nix-book`, `z790prors`, `boxy`, and `wixos`.
+  - Each machine has `configuration.nix` and `hardware-configuration.nix`, detailing the machine's system and hardware configuration.
+  
+- **Home:**
+  - `home/`: Pertains to user-specific configurations with different modules and home environment setups. Contains files like `home-nix-book.nix`, `home-z790prors.nix`, etc.
+  - Includes specific modules for software like Emacs, tmux, i3+sway, etc.