docs(agents): align prose with writing guide

configs/nixos/modules/shell/herdr.nix

@@ -18,7 +18,8 @@ in
     home-manager.users.${user} = {
       home.packages = [ pkgs.herdr ];
 
-      # Run `PI_CODING_AGENT_DIR=$PWD/.pi herdr integration install pi` from the monorepo root to refresh the vendored project-local Pi extension.
+      # Refresh the vendored project-local Pi extension from the monorepo root.
+      # Run `PI_CODING_AGENT_DIR=$PWD/.pi herdr integration install pi`.
       xdg.configFile."herdr/config.toml".text = ''
         [keys]
         prefix = "ctrl+space"

configs/nixos/modules/shell/pi/default.nix

@@ -21,7 +21,7 @@ in
 {
   options.modules.shell.pi = {
     enable = lib.mkEnableOption ''
-      Pi, a terminal coding agent, configured via home-manager'';
+      Pi, a terminal coding agent, configured through home-manager'';
   };
 
   config = lib.mkIf cfg.enable {