# Documentation

High-level documentation for Airut. These documents describe concepts, security
properties, and operational procedures.

For implementation-level specifications, see [spec/](../spec/).

## Architecture

- [architecture.md](architecture.md) — System architecture and data flow
- [security.md](security.md) — Security model (email auth, isolation,
  credentials)
- [execution-sandbox.md](execution-sandbox.md) — Container isolation and
  resource limits
- [network-sandbox.md](network-sandbox.md) — Network allowlist and proxy
  architecture
- [agentic-operation.md](agentic-operation.md) — Email-to-PR workflow patterns

## Operations

- [deployment.md](deployment.md) — Installation and server configuration
- [m365-oauth2.md](m365-oauth2.md) — Microsoft 365 OAuth2 setup for IMAP/SMTP
- [repo-onboarding.md](repo-onboarding.md) — Onboarding new repositories
- [gerrit-onboarding.md](gerrit-onboarding.md) — Gerrit-specific onboarding
