Architecture, capability catalogue, and design decisions.
ARCHITECTURE.md— the locked stack and the reasoning behind each choiceCAPABILITIES.md— what the tool does, what's buildable on open data, and the honest limits of public-data predictionSOURCES.md— data sources, libraries, research, and license attributionAPI-CONTRACT.md— the fixed JSON contract the .NET API exposes and the React UI consumesDATA-SOURCES.md— data acquisition tracker: what each source unlocks and how to get itAROMA.md— why the aroma model is deferred (clean-data audit + the empirical evaluation)
These document what we're building and why, so decisions don't get re-argued.