What happened
PR #6771 removed the e2e row from the Role Permissions Matrix in docs/guides/infrastructure/infrastructure-reference.md to stop implying that e2e is a user-selectable role. The review agent (run 33278403494) correctly identified two other files that still reference e2e as a valid role: docs/guides/user/bring-your-own-agent.md:338 (lists e2e in the valid values for the roles field) and docs/cli/mint.md:108 (includes e2e in the --roles flag example). Human reviewer rh-hemartin approved and merged on 2026-09-01 without addressing these findings.
What could go better
The review agent's findings were valid and actionable. After merge, two user-facing docs still list e2e as a valid role value, creating exactly the role-selection confusion that issue #6563 describes. The bring-your-own-agent.md reference is particularly problematic — a user reading that guide will see e2e as a selectable option for their agent's roles field. The mint.md case is less clear-cut since that doc may target internal operators, but at minimum deserves a note that e2e is internal-only. Confidence: high for bring-your-own-agent.md (clearly user-facing, contradicts the PR's stated goal); medium for mint.md (could be intentionally operator-facing).
Proposed change
In docs/guides/user/bring-your-own-agent.md, remove e2e from the valid-values list for the roles field (around line 338). In docs/cli/mint.md, either remove e2e from the --roles flag example (around line 108) or add a note that e2e is an internal-only role not intended for user configuration. This is a targeted docs cleanup — the structural fix of consolidating role definitions to prevent future drift is tracked in issue #2449.
Validation criteria
After the fix, searching user-facing documentation (docs/guides/user/, docs/cli/) for e2e as a listed valid role value should return zero results (or only results with an explicit 'internal-only' qualifier). The BYO agent guide should list only user-selectable roles: fullsend, triage, coder, review, fix, retro, prioritize.
Generated by retro agent from #6771
What happened
PR #6771 removed the
e2erow from the Role Permissions Matrix indocs/guides/infrastructure/infrastructure-reference.mdto stop implying thate2eis a user-selectable role. The review agent (run 33278403494) correctly identified two other files that still referencee2eas a valid role:docs/guides/user/bring-your-own-agent.md:338(listse2ein the valid values for therolesfield) anddocs/cli/mint.md:108(includese2ein the--rolesflag example). Human reviewer rh-hemartin approved and merged on 2026-09-01 without addressing these findings.What could go better
The review agent's findings were valid and actionable. After merge, two user-facing docs still list
e2eas a valid role value, creating exactly the role-selection confusion that issue #6563 describes. Thebring-your-own-agent.mdreference is particularly problematic — a user reading that guide will seee2eas a selectable option for their agent'srolesfield. Themint.mdcase is less clear-cut since that doc may target internal operators, but at minimum deserves a note thate2eis internal-only. Confidence: high forbring-your-own-agent.md(clearly user-facing, contradicts the PR's stated goal); medium formint.md(could be intentionally operator-facing).Proposed change
In
docs/guides/user/bring-your-own-agent.md, removee2efrom the valid-values list for therolesfield (around line 338). Indocs/cli/mint.md, either removee2efrom the--rolesflag example (around line 108) or add a note thate2eis an internal-only role not intended for user configuration. This is a targeted docs cleanup — the structural fix of consolidating role definitions to prevent future drift is tracked in issue #2449.Validation criteria
After the fix, searching user-facing documentation (
docs/guides/user/,docs/cli/) fore2eas a listed valid role value should return zero results (or only results with an explicit 'internal-only' qualifier). The BYO agent guide should list only user-selectable roles: fullsend, triage, coder, review, fix, retro, prioritize.Generated by retro agent from #6771