Skip to content

Systems

The core nomenclature patterns apply everywhere, but each system has specific conventions for how identifiers map to that platform’s constructs. This section covers the system-specific details.

SystemKey ConceptsPage
Google WorkspaceGroups, Drives, OUs, GAM automationGoogle Workspace
Platform EngineeringShared admin accounts, fleet naming, infra conventionsPlatform Engineering
AWSIdentity Center, Organizations, account namingAWS
Git (GitLab / GitHub)Repo naming, namespace conventions, hosting chooserGit

These principles apply regardless of which system you’re configuring:

  1. Same tokens everywhere. The prv-{team}-{type}-{qualifier} pattern and the same token vocabulary apply in every system.
  2. Groups for access, not individuals. Map role groups to system-level permissions wherever the system supports it.
  3. Least privilege. Grant the minimum access needed. Prefer scoped roles over broad ones.
  4. Documentation. Every system integration should document which role groups map to which system permissions.