Commit 07819aa

HPCesia <me@hpcesia.com>
2026-09-08 01:37:20
docs: update AGENTS.md
1 parent 065bd20
Changed files (1)
AGENTS.md
@@ -5,8 +5,10 @@ and [den](https://github.com/denful/den).
 
 ## Code Style
 
-- DO NOT ADD ANY COMMENTS unless asked. Comments should describe why not what,
-  code should be self documenting as to what.
+- Comments should describe why not what, code should be self documenting as to
+  what. After edit, refine your comments that exceed 2 lines.
+- Always use the current workspace changes as the baseline. If current workspace
+  changed unexpectedly, they are user-made; always respect the user's changes.
 - After 3+ workarounds in the same area, redesign the component instead of
   patching further.
 
@@ -14,11 +16,18 @@ and [den](https://github.com/denful/den).
 
 ```sh
 # Build a nixosConfiguration for specific host
-just build <hostname> --no-nom --diff=never
+just build <hostname> --no-nom --diff=never -- --verbose
 
-# Regenerate flake.nix & flake.lock after add modify flake inputs by flake-file
+# Regenerate flake.nix & flake.lock after modifying flake inputs by flake-file
 just write-flake
 
+# Edit and cache Vaultix secrets, need password and ONLY for human use
+edit-secret <file_path> # `edit-secret` available in nix devshell
+git add <file_path> # or any command to track secret file in git
+
+cache-secret # also in nix devshell
+git add ./.secrets # or any command to track cached secret files in git
+
 # Get path of a nix flake input
 nix eval --impure --expr '(builtins.import ./default.nix).inputs.<input>.outPath'
 ```