diff --git a/README.md b/README.md
index d361f23..ccd7f24 100644
--- a/README.md
+++ b/README.md
@@ -79,7 +79,9 @@ points `$SCRIPTS` at it. Keep the workflow and its scripts moving together on `m
 | `AGENT_TOKEN` | PAT (issue/repository/organization/misc read+write, cross-repo) — posts the delegation comment that fires the next agent **and** powers the `gitea-api` skill (read/write issues, PRs, comments, labels, and Actions runs/logs across any repo). Do not re-narrow its scopes without also removing the `gitea-api` skill. |
 | `TOKEN_PM`,`TOKEN_SENIOR`,`TOKEN_JUNIOR`,`TOKEN_LEAD`,`TOKEN_QA` | optional — post/commit as each agent's own Gitea user (falls back to the bot) |
 
-`GITEA_TOKEN` is auto-provided. Tip: set these once at the **org** level so every repo inherits
+`GITEA_TOKEN` is auto-provided, while per-agent `TOKEN_*` secrets let each agent authenticate and
+post as its own Gitea user; otherwise the shared `AGENT_TOKEN` bot account is used.
+Tip: set these once at the **org** level so every repo inherits
 them via `secrets: inherit`.
 
 ## Also add to each consuming repo