> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

> **Themelio compatibility reference.** This page describes the retained Themelio implementation or its historical design. Check the [parallel-operation guide](/compatibility/index.md) before applying it to the current platform.

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

<details class="page-source"><summary>Page source</summary>

<a href="/source/docs/content/dd/index.md.txt">Source snapshot</a> · Revision `f928834c8`.

</details>