docs: README reflects per-agent SELF_TOKEN model #62

2026-07-05T15:40:15+02:00

ffaerber commented

2026-07-05 15:40:15 +02:00

Follow-up to #59. Updates the Required secrets table so the docs match the shipped behavior:

TOKEN_* are now documented as primary — each agent runs with only its own token as SELF_TOKEN and acts as itself (post/commit/comment, @qa merge, gitea-api skill scopes). Notes TOKEN_QA needs write:repository.
Added TOKEN_OPS (the @ops admin token behind gitea-admin).
AGENT_TOKEN reframed as the fallback for repos without per-agent tokens (still needed for the trigger-comment + merge-fires-deploy cases the built-in token can't do).
Clarified the SELF_TOKEN selection and GITEA_TOKEN's read / identity-fallback role.

Docs-only; no workflow behavior change.

Follow-up to #59. Updates the *Required secrets* table so the docs match the shipped behavior: - `TOKEN_*` are now documented as **primary** — each agent runs with only its own token as `SELF_TOKEN` and acts as itself (post/commit/comment, `@qa` merge, `gitea-api` skill scopes). Notes `TOKEN_QA` needs `write:repository`. - Added `TOKEN_OPS` (the `@ops` admin token behind `gitea-admin`). - `AGENT_TOKEN` reframed as the **fallback** for repos without per-agent tokens (still needed for the trigger-comment + merge-fires-deploy cases the built-in token can't do). - Clarified the `SELF_TOKEN` selection and `GITEA_TOKEN`'s read / identity-fallback role. Docs-only; no workflow behavior change.

ffaerber added 1 commit 2026-07-05 15:40:15 +02:00

docs: README reflects per-agent SELF_TOKEN model 1c4e4ce950

The secret table still described AGENT_TOKEN as primary and TOKEN_* as
optional "falls back to the bot". The per-agent-token refactor inverted that:
each agent's own TOKEN_* is primary (selected into SELF_TOKEN), AGENT_TOKEN is
now only the fallback for repos without per-agent tokens. Document TOKEN_OPS,
the SELF_TOKEN selection, and that TOKEN_QA needs write:repository to merge.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

ffaerber merged commit c792228e2c into main

2026-07-05 15:40:30 +02:00

ffaerber deleted branch docs/token-model-selftoken

2026-07-05 15:40:30 +02:00

ffaerber referenced this pull request

2026-07-05 15:51:23 +02:00

agents: remove shared AGENT_TOKEN — per-agent tokens only #63

ffaerber referenced this pull request

2026-07-06 19:11:46 +02:00

agents: review round 2 — split-PR flow, thread recency, mention boundaries, learnings cap, pm model #96

Sign in to join this conversation.