diff --git a/profiles/sets/coding/agents/agents.nix b/profiles/sets/coding/agents/agents.nix
index b89a531..4cfbf93 100644
--- a/profiles/sets/coding/agents/agents.nix
+++ b/profiles/sets/coding/agents/agents.nix
@@ -61,23 +61,28 @@
     };
   };
 
+  # NOTE: llm-agent packages are consumed via the `llm-agents` namespace
+  # (pkgs.llm-agents.*), provided by numtide/llm-agents.nix's
+  # `overlays.shared-nixpkgs`. The consumer's nixos-config MUST apply that
+  # overlay — namespaced refs fail loudly if it is missing, instead of
+  # silently falling back to (outdated) nixpkgs attributes.
   home.packages = with pkgs; [
     agenix-cli
-    agent-browser
+    llm-agents.agent-browser
     m3taHomeInputs.agent-lib.packages.${pkgs.stdenv.hostPlatform.system}.agent-lib-cli
-    beads
+    llm-agents.beads
     buzz
     crunch
     docker-sbx
-    herdr
+    llm-agents.herdr
     pi-coding-agent
-    (qmd.override {
+    (llm-agents.qmd.override {
       vulkanSupport = videoDrivers == ["amdgpu"];
       cudaSupport = videoDrivers == ["nvidia"];
     })
     opencode-desktop
     openshell
-    openspec
+    llm-agents.openspec
     openwork
     talk
   ];