docs/decisions/README.md

Architecture Decision Records (ADRs)

Last Updated: 2025-01-27 Purpose: Document important architectural and technical decisions

---

Overview

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

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

---

Last Updated: 2025-01-27