This directory contains Architecture Decision Records (ADRs) documenting important decisions made about the workspace structure, tooling, and architecture.

ADR Format

Standard ADR Structure

# [ADR-XXXX]: [Title]

**Status**: [Proposed/Accepted/Deprecated/Superseded]
**Date**: [YYYY-MM-DD]
**Deciders**: [List of decision makers]
**Context**: [Background and context]
**Decision**: [Decision made]
**Consequences**: [Implications and consequences]

ADR Index

Workspace Structure

ADR-0001: Use Monorepo Structure - Decision to use monorepos for related projects

Tooling

ADR-0002: Standardize on pnpm and Turborepo - Standard package manager and build tool
ADR-0003: Use Git Submodules for External Projects - Decision to use submodules for external repos

Architecture

ADR-0004: Hybrid Cloud Architecture - Decision to use hybrid cloud (Proxmox + Azure)

Creating New ADRs

Create new ADR file: ADR-XXXX-[title].md
Follow ADR format
Update this index
Submit for review

Last Updated: 2025-01-27