# Design documents

Design documents describe implementation, migration, verification and recovery
for the related architecture decision. Decisions retain their canonical paths
under [`../decisions`](../decisions/); a companion DD uses the same number and
filename here. Links run in both directions so a design cannot be mistaken for
an independent architectural decision.

Implementation evidence and review approval are separate. A deployed development
design may remain Draft while wider adoption and production qualification are
pending.

- [DD-0038 — Platform edge and mesh](0038-platform-edge-catalogue.md), related to
  [ADR-0038](../decisions/0038-platform-edge-catalogue.md).
- [DD-0039 — Development Argo CD bootstrap and ownership](0039-dev-box-argocd-ownership.md),
  related to [ADR-0039](../decisions/0039-dev-box-argocd-ownership.md); draft for
  review, with owned development implementation and qualification evidence.
- [DD-0041 — GitLab and Waldur as Argo CD services](0041-gitlab-waldur-services.md),
  related to [ADR-0041](../decisions/0041-gitlab-waldur-services.md); draft for review,
  with dev-box qualification evidence.
- [DD-0043 — The retained Themelio as the `themelio-compat` service](0043-themelio-compat-service.md),
  related to [ADR-0043](../decisions/0043-themelio-compat-service.md); draft for review,
  with dev-box qualification evidence.
- [DD-0044 — The shared LLM stack as the `llm` service](0044-llm-stack-service.md),
  related to [ADR-0044](../decisions/0044-llm-stack-service.md); draft for review.
- [DD-0045 — Development loop interface](0045-development-loop.md), related to
  [ADR-0045](../decisions/0045-development-loop.md); draft for review.
- [DD-0055 — Member SSH access to Icarus-hpc](0055-hpc-ssh-key-provisioning.md),
  with [browser surface, laboratory and delivery](0055-hpc-ssh-key-provisioning-browser-and-operations.md),
  related to [ADR-0055](../decisions/0055-hpc-ssh-key-provisioning.md); draft for
  review.
- [DD-0058 — Complete distributed services composition](0058-distributed-services-composition.md),
  related to [ADR-0058](../decisions/0058-distributed-services-composition.md);
  implementation in progress, with deterministic evidence.
- [DD-0059 — Production Icarus-hpc provisioning and run installation](0059-icarus-hpc-provisioning-run-installation.md),
  related to [ADR-0059](../decisions/0059-icarus-hpc-provisioning-run-installation.md);
  draft for review, with deterministic installer evidence and production activation
  gated.
- [DD-0060 — Development seeds for Waldur and GitLab](0060-development-seeds.md),
  related to [ADR-0060](../decisions/0060-development-seeds.md); draft for review,
  with dev-box evidence.
- [DD-0067 — Kubeflow GitOps composition](0067-kubeflow-gitops-composition.md),
  related to [ADR-0067](../decisions/0067-kubeflow-gitops-composition.md); draft
  for review, with no manifests implemented yet.