From f5296d123b15a8c8d03bafd6d48a9c9b4e14fcfa Mon Sep 17 00:00:00 2001
From: Norman Fomferra <norman.fomferra@brockmann-consult.de>
Date: Mon, 26 Jan 2026 11:27:11 +0100
Subject: [PATCH] Added llms.txt

---
 CHANGES.md |  2 ++
 llms.txt   | 39 +++++++++++++++++++++++++++++++++++++++
 2 files changed, 41 insertions(+)
 create mode 100644 llms.txt

diff --git a/CHANGES.md b/CHANGES.md
index 6e415cc30..651a52dec 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -8,6 +8,8 @@
   original dataset structure as returned by `rioxarray`, rather than splitting
   raster bands into separate data variables. This improves data access patterns and
   avoids unnecessary transformations. Defaults are set to `True`.
+* Added a file `llms.txt` to xcube's source root to help LLMs pick up relevant 
+  project infos. 
 
 
 ## Changes in 1.13.0
diff --git a/llms.txt b/llms.txt
new file mode 100644
index 000000000..0076c7c3d
--- /dev/null
+++ b/llms.txt
@@ -0,0 +1,39 @@
+# llms.txt — xcube project summary
+
+# About
+# xcube is a Python toolkit for generating and exploiting geospatial data cubes
+# powered by xarray, dask, and zarr.
+# Docs: https://xcube.readthedocs.io/ :contentReference[oaicite:1]{index=1}
+
+## Highest-level overview
+docs/overview.md
+README.md
+CHANGES.md
+CONTRIBUTING.md
+CODE_OF_CONDUCT.md
+
+## Core code & API
+xcube/core/        # core API functions
+xcube/cli/         # CLI entry points
+xcube/webapi/      # web API + server endpoints
+xcube/util/        # helpers & utilities
+pyproject.toml
+
+## Data specs & models
+docs/source/cubespec.md  # dataset conventions & CF conventions use :contentReference[oaicite:2]{index=2}
+
+## Examples & demos
+examples/serve/demo/README.md  # server demo usage :contentReference[oaicite:3]{index=3}
+examples/serve/demo/*
+
+## Tests
+test/
+
+## Development
+docs/source/devguide.md  # coding style + contribution rules :contentReference[oaicite:4]{index=4}
+
+## What to ignore (for LLM focus)
+.github/
+docker/
+scripts/
+*.yml