Update README.md to provide a comprehensive overview of The Order monorepo, including repository structure, quickstart guide, development workflow, and contribution guidelines.

docs/architecture/adrs/README.md

@@ -0,0 +1,65 @@
+# Architecture Decision Records
+
+This directory contains Architecture Decision Records (ADRs) for The Order project.
+
+## What is an ADR?
+
+An Architecture Decision Record is a document that captures an important architectural decision made along with its context and consequences.
+
+## ADR Format
+
+Each ADR should follow this structure:
+
+```markdown
+# ADR-XXX: [Title]
+
+## Status
+[Proposed | Accepted | Deprecated | Superseded]
+
+## Context
+Describe the issue that is motivating this decision or change.
+
+## Decision
+State the architectural decision that is being made.
+
+## Consequences
+Describe the consequences, both positive and negative, of this decision.
+
+## Alternatives Considered
+List alternatives that were considered and why they were rejected.
+
+## References
+Links to related ADRs, issues, or documentation.
+```
+
+## ADR Numbering
+
+ADRs are numbered sequentially:
+- `adr-001-*.md`
+- `adr-002-*.md`
+- etc.
+
+## Creating a New ADR
+
+1. Create a new file: `adr-XXX-short-title.md`
+2. Use the template above
+3. Set status to "Proposed"
+4. Create a PR for discussion
+5. Update status to "Accepted" after approval
+
+## ADR Lifecycle
+
+1. **Proposed**: Initial proposal, under discussion
+2. **Accepted**: Decision has been made and approved
+3. **Deprecated**: Decision is no longer followed
+4. **Superseded**: Replaced by a newer ADR
+
+## Current ADRs
+
+*No ADRs yet. Create the first one using the template above.*
+
+## References
+
+- [ADR Template](https://github.com/joelparkerhenderson/architecture-decision-record)
+- [Documenting Architecture Decisions](https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions)
+