docs(agents): clarify rule scope and remove permission templates

This commit is contained in:
Ryan Yin
2026-09-05 13:34:13 +08:00
parent 3f74be246c
commit 33b17baeff
4 changed files with 61 additions and 565 deletions
+8 -2
View File
@@ -9,7 +9,6 @@ The primary workflow is to symlink files from here into each agent runtime/confi
- `AGENTS.md`: global baseline rules for coding agents.
- `evals/global-rules.md`: behavioral scenarios for validating changes to the global rules.
- `permissions.md`: permission policies for agent tool access.
- `install-rules.py`: installs the baseline by creating symlinks in supported agent config dirs.
- `install-cli.md`: curated CLI install/update command snippets.
- `install-skills.md`: curated `npx skills` command snippets.
@@ -17,7 +16,7 @@ The primary workflow is to symlink files from here into each agent runtime/confi
## Core workflow
1. Maintain shared rules in `agents/AGENTS.md`.
2. Define permission policies in `agents/permissions.md`.
2. Configure permissions directly in the agent runtime; auto-approval is generally used.
3. Run `install-rules.py` to refresh symlinks in local agent homes.
4. Use `install-cli.md` and `install-skills.md` as reference snippets when needed.
@@ -42,6 +41,13 @@ Behavior:
- Missing destination directories are skipped.
- Existing destination file/symlink is replaced with a symlink to this repo source file.
The installer links only `AGENTS.md`; it does not install permission configuration, skills, or CLIs.
The repository-root `AGENTS.md` contains guidance for this Nix configuration repository. It is not
the global rules source and is not installed by this script.
Auto-approval controls tool prompting. The global rules still define task authorization, safety, and
secret handling.
## About `install-cli.md` and `install-skills.md`
Use them as snippet libraries: