For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /reference/docs/decisions/README.md.

Architecture decision records

This catalogue brings the archived ADRs and the current platform decisions into one sequence. The historical records retain their original status and rationale. Read them in the context of the platform they describe; the current architecture starts with 0034 — fresh service-first skeleton.

Numbering and provenance

  • The 25 historical records come from the archived ADR directory in the main snapshot 8046ea0f1. The originals were relocated byte-for-byte into docs/content/adr under ADR 0042; docs/provenance.json records their original blobs and destinations.
  • Historical filenames are preserved, including both records numbered 0000 and both numbered 0007. Cite their full filenames to distinguish them. These exact pairs are the only exceptions to the duplicate-number check.
  • Links between ADRs resolve within this directory. Supporting documents link to their archived copies. The LFS quota record's heading is corrected from ADR-0003 to ADR-0001 to match its original filename.
  • ADR-0025 refers to a network-segmentation ADR-0024 absent from the archive. Its reference is retained as text with that limitation recorded.
  • Numbers 0026–0033 occur in open legacy proposals as checked on 13 October 2026, including the security proposals under internal_plans/adr in PR #559. They are reserved here; importing this history does not accept those proposals.
  • The five newer records are renumbered in their existing order: 0001 → 0034, 0002 → 0035, 0003 → 0036, 0006 → 0037 and 0007 → 0038. Allocate future numbers after the highest on main and in open pull requests.

Current platform decisions

ADRDecision
0034fresh service-first skeleton
0035Shared dev-box AAI
0036Isolated Icarus runtime laboratory
0037Dev-box storage from the final deployment's Rook/Ceph role
0038Platform service catalogue and shared host edge
0039Development Argo CD bootstrap and ownership (proposed)
0040Platform layout: Ansible for the cluster, Argo CD for services (proposed)
0041GitLab and Waldur as Argo CD services (proposed)
0042Preserve authorship when reactivating legacy source
0043The retained Themelio as the themelio-compat service (proposed)
0044The shared LLM stack as the llm service (proposed)
0045The development loop: deploy, reconcile and takeover (proposed)
0046Service communication, typed query contracts and composition
0047Dev-box consolidation: ownership, Argo AAI and shared data (proposed)
0048Shared infrastructure on personal development boxes
0049The Kubernetes Site Runtime as the pharos-site-runtime service (proposed)
0051Inventory-driven distributed platform setup (proposed)
0055Member SSH access to Icarus-hpc (proposed)
0056Verified platform releases from one deployment catalogue (proposed)
0057Targeted realtime messages
0058Complete distributed services composition (proposed)
0059Production Icarus-hpc provisioning and run installation (proposed)
0060Development seeds for Waldur and GitLab (proposed)
0061Support context and development broker provisioning
0062Support tickets go directly to Zammad
0063Zammad integration token
0064A dev box's Zammad is seeded from a configuration
0065Zammad is an optional Argo CD service of the dev box
0066Optional dev-box services use reviewed lifecycle selection
0067Kubeflow is one pinned Argo CD composition (proposed)
0068Platform acceptance tests with Playwright and Gherkin
0069Project-private Run services
0070Platform-side security scanning of user repositories (proposed)
0071Generated MCP access to the Go API (proposed)

Historical records

ADRDecision
0000Meta-Agentic GenAIScript System - Minimal Product Requirements & Architecture
0000Friends & Family MVP Scope
0001LFS Storage Quota Enforcement via Custom Proxy
0002Architecture Documentation Update
0003Waldur Proposal Workflow
0004Xet Content-Addressed Storage for ML Artifacts
0005AAI → Waldur User Synchronization
0006Automated Data Seeding Strategy
0007GPU Slicing and Quota Enforcement
0007Stress Test Strategy
0009Shared LLM Inference Backend
0010LLM Gateway and Project Token Quotas
0011Chat UI and Client Access for Shared LLM Services
0012Job and Deployment Management System
0013actions.yaml Automation System
0014GitLab CI Runner on Dedicated AWS EC2 Instance
0015GitLab CI Runner EC2 Instance — Ansible Onboarding
0016Declarative Database List in the Ansible postgres Role
0017Shared Themelio Database with Decoupled Schema Migrations
0018Queued Status and Over-Capacity Handling for Managed Workloads
0019Container Image Tag Management for GitOps Deployments
0020LLM Access Membership Source of Truth
0021Themelio Command-Line Interface
0023DRA GPU Allocation with Extended Resource Names
0025Scoped Istio Authorization Policies
Page source

Source snapshot · Revision f928834c8.