The README mentions key scopes generally, but troubleshooting would be clearer if common scope failures were mapped to the tools users are calling. Add a compact reference for required capabilities and likely API errors.
Acceptance criteria:
- Document which tools require jobs:read, jobs:write, or artifact-related access if applicable.
- Include examples of common 401/403 messages and the user action to fix them.
- Keep secrets guidance clear for host config examples.
- Ensure README and examples remain consistent.
The README mentions key scopes generally, but troubleshooting would be clearer if common scope failures were mapped to the tools users are calling. Add a compact reference for required capabilities and likely API errors.
Acceptance criteria: