---
title: Design Documents
---

# Design Documents

Design Documents (DDs) are detailed technical specifications that describe *how* to implement a decision recorded in an ADR. Where an ADR answers "what did we decide and why?", a Design Document answers "how exactly do we build it?"

Each DD is linked from its corresponding ADR and is intended to be actionable by an engineer or an automated agent.

## Index

| # | Title | Related ADR |
|---|-------|-------------|
| 0005 | [AAI → Waldur User Sync](/dd/0005-aai-waldur-user-sync) | [ADR-0005](/adr/0005-aai-waldur-user-sync) |
| 0006 | [Automated Seeding Strategy](/dd/0006-automated-seeding-strategy) | [ADR-0006](/adr/0006-automated-seeding-strategy) |
| 0009 | [Shared LLM Inference Backend](/dd/0009-shared-llm-inference-backend) | [ADR-0009](/adr/0009-shared-llm-inference-backend) |
| 0010 | [LLM Gateway and Project Token Quotas](/dd/0010-project-scoped-llm-gateway-token-quotas-api-access) | [ADR-0010](/adr/0010-project-scoped-llm-gateway-token-quotas-api-access) |
| 0011 | [Chat UI and Client Access for Shared LLM Services](/dd/0011-human-web-ui-and-agent-client-access) | [ADR-0011](/adr/0011-human-web-ui-and-agent-client-access) |
| 0012 | [Job and Deployment Management System](/dd/0012-job-deployment-management-system) | [ADR-0012](/adr/0012-job-deployment-management-system) |
| 0013 | [actions.yaml Automation System](/dd/0013-actions-yaml-automation-system) | [ADR-0013](/adr/0013-actions-yaml-automation-system) |
| 0014 | [GitLab CI Runner EC2 Instance — Manual Operator Steps](/dd/0014-gitlab-ci-runner-ec2-instance) | [ADR-0014](/adr/0014-gitlab-ci-runner-ec2-instance) |
| 0015 | [GitLab CI Runner EC2 Instance — Ansible Onboarding](/dd/0015-gitlab-ci-runner-ec2-ansible-onboarding) | [ADR-0015](/adr/0015-gitlab-ci-runner-ec2-ansible-onboarding) |
| 0016 | [Declarative Database List in the Ansible postgres Role](/dd/0016-declarative-database-list-in-postgres-role) | [ADR-0016](/adr/0016-declarative-database-list-in-postgres-role) |
| 0017 | [Shared Themelio Database with Decoupled Schema Migrations](/dd/0017-shared-themelio-database-decoupled-migrations) | [ADR-0017](/adr/0017-shared-themelio-database-decoupled-migrations) |
| 0018 | [Queued Status and Over-Capacity Handling](/dd/0018-queued-status-and-over-capacity-handling) | [ADR-0018](/adr/0018-queued-status-and-over-capacity-handling) |
| 0019 | [Container Image Tag Management — Implementation](/dd/0019-container-image-tag-management) | [ADR-0019](/adr/0019-container-image-tag-management) |
| 0020 | [LLM Access Membership Source of Truth](/dd/0020-llm-access-membership-source-of-truth) | [ADR-0020](/adr/0020-llm-access-membership-source-of-truth) |
| 0021 | [Themelio CLI — Implementation](/dd/0021-themelio-cli) | [ADR-0021](/adr/0021-themelio-cli) |
| 0023 | [DRA GPU Extended Resource Implementation](/dd/0023-dra-gpu-extended-resource-names) | [ADR-0023](/adr/0023-dra-gpu-extended-resource-names) |
| 0025 | [Scoped Istio Authorization Policies — Implementation](/dd/0025-scoped-istio-authorization-policies) | [ADR-0025](/adr/0025-scoped-istio-authorization-policies) |