# Architectural Decision Records (ADRs)

This directory contains Architectural Decision Records (ADRs) for the CMS-aiChemist project.

ADRs document significant architectural decisions made during the project lifecycle. Each record follows the standard ADR format: Title, Status, Context, Decision, and Consequences.

## Decision Records

| ADR | Title | Status |
|-----|-------|--------|
| 001 | NotebookLM as Orchestration Brain | Accepted |
| 002 | pnpm Per-App Dependencies | Accepted |
| 003 | Dual Surface Architecture | Accepted |
| 004 | DTCG Tokens, CSS-First | Accepted |
| 005 | PM2 + Caddy Deployment | Accepted |
| 006 | Multi-Project System Design | Accepted |

## ADR Format

Each ADR includes:
- **Status**: Accepted, Proposed, Deprecated, or Superseded
- **Context**: The problem or situation that requires a decision
- **Decision**: The architectural choice made and its rationale
- **Consequences**: Positive, negative, and neutral outcomes of the decision

Major architectural decisions are also pushed to NotebookLM as sources for persistent orchestration memory.