Personas & Responsibilities

This guide clarifies who uses what, and which docs matter for each persona.

• Platform Admin (Org owner)

  • Sets up GCP project(s), Terraform, domains, and IAM. Reviews risk guardrails defaults and global config.
  • Key docs: Architecture, Deployment, Risk Guardrails, Security, Terraform Guide.

• Tenant Admin (Team owner)

  • Manages tenant settings, notification channels, approver groups, and per‑service guardrails. Initiates approvals.
  • Key docs: Risk Guardrails, User Guide → Settings & Configuration, Approvals flow.

• Operator / SRE

  • Reviews advise results, requests approvals, monitors jobs, and triggers rollbacks when needed.
  • Key docs: Runtime Flow, Workflows, Error Handling (operational), Approvals flow, Rollbacks.

• Developer (internal)

  • Builds agents and services, runs migrations, adds features.
  • Private docs: Developer Guide, Python APIs, Data Model, runbooks, ADRs.

• Security / Compliance

  • Reviews audit trails, secret handling, and IAM guardrails.
  • Key docs: Security, Risk Guardrails, Audit/Observability summaries.

See also: Reference → Environment Variables, Architecture → API Architecture, and the REST API reference.