# Docs

This directory contains the lakehouse design package.

## Reading Order

1. [../CONTEXT.md](../CONTEXT.md) — glossary and shared language.
2. [design/v1-lakehouse-architecture.md](./design/v1-lakehouse-architecture.md) — main architecture.
3. [principles/README.md](./principles/README.md) — short platform principles.
4. [design/README.md](./design/README.md) — supporting design docs.
5. [adr/README.md](./adr/README.md) — decision log.

## Structure

- `design/` — design narratives, schemas, and component specs.
- `principles/` — short implementation-shaping platform rules.
- `adr/` — short architectural decision records.
- `agents/` — local configuration used by vendored agent skills.
- `../docs.historic/` — dated historical notes and superseded explorations.