docs: align agent and repo docs with desktop Decman profile

system-config/README.md

@@ -5,7 +5,8 @@ A small, declarative Arch configuration managed by Decman.
 ## Design
 
 - **Concerns live in `packages/`**: each concern has a native (`*-repo.txt`)
-  and AUR (`*-aur.txt`) list.
+  and AUR (`*-aur.txt`) list, plus an optional global npm (`*-npm.txt`) list
+  for command packages unavailable through Arch packaging.
 - **Hosts live in `hosts.py`**: a host composes package concerns and explicit
   system state. `desktop()` owns this desktop's boot, storage, NVIDIA, input,
   SDDM, network-policy, and user-session configuration.
@@ -55,7 +56,9 @@ remove those explicitly in a separate reviewed package change.
 | Desktop | shared concerns, `common/hardware`, and a reviewable `desktop/local` set; host state is in `config/system/desktop/` |
 
 Every package must have a named purpose. Add a new concern when an existing one
-does not explain a package. System and user units use the same naming:
+does not explain a package. Missing packages from `*-npm.txt` are installed
+globally after the pacman and AUR steps; unrelated global npm packages are not
+removed. System and user units use the same naming:
 `manifests/common/<concern>-{system,user}.txt` or
 `manifests/laptop/<concern>-system.txt`.
 
@@ -87,8 +90,9 @@ sudo decman --source source.py --no-hooks
 ```
 
 `verify.py` proves that every currently explicit package appears exactly once
-in the active laptop profile. The ignored dependency lists prevent Decman's
-orphan cleanup from removing dependencies during adoption.
+in the active desktop profile, including global npm command packages. The
+ignored dependency lists prevent Decman's orphan cleanup from removing
+dependencies during adoption.
 
 After intentional package changes, regenerate and review concern lists: