Architecture Decision Records

Short records of the significant decisions on this project, in Nygard ADR format: context → decision → consequences. They are the durable record of why the project is shaped the way it is. The architecture and structure live in ../architecture.md; the phased build plan is tracked as GitHub issues.

ADR

Decision

Status

0000

Stack: Python, FastAPI, PostgreSQL, React

Accepted

0001

RAG retrieval boundary: a shared rag_core library

Accepted

0002

Embedding and reranking stack: local open-source models

Accepted

0003

Deployment scope: local single-user

Accepted

0004

Document ingestion: CLI batch

Accepted

0005

Documentation site tooling: Sphinx, MyST, and Furo

Accepted