Initial commit: add .gitignore and README

decisions/README.md

@@ -0,0 +1,54 @@
+# 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
+```markdown
+# [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](./0001-use-monorepo-structure.md) - Decision to use monorepos for related projects
+
+### Tooling
+- [ADR-0002: Standardize on pnpm and Turborepo](./0002-standardize-pnpm-turborepo.md) - Standard package manager and build tool
+- [ADR-0003: Use Git Submodules for External Projects](./0003-use-git-submodules.md) - Decision to use submodules for external repos
+
+### Architecture
+- [ADR-0004: Hybrid Cloud Architecture](./0004-hybrid-cloud-architecture.md) - 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
+