[lightdash-bot]

The Agent context page described where lightdash.project_context.yml lives but not when Lightdash actually reads it and when agents actually use it — both are gated and easy to assume work by default.

Adds a "When agents load it" section stating that:

• The file is only ingested into a project when the organization setting Review AI agent turns (Settings → Ask AI → General) is on, and only after the project is recompiled (Refresh dbt/Refresh models, or lightdash deploy).
• Agents only load project context on projects connected through GitHub or GitLab — a project with no repository connection, including a CLI-created preview (lightdash preview, lightdash start-preview, or a repo-less lightdash deploy), never ingests or loads the file.
• Clarifies that a preview built from a connected GitHub/GitLab branch does read the file from that branch at compile time, while a CLI-created preview with no repository connection has no branch to read it from.

Also tightens the intro to note the file lives in the connection's configured Project directory path, which isn't always the repository root.

---

Cloudy found this docs gap while working a support thread. Written by Cloudy's docs writer; a teammate reviews it before merge, and edits are welcome.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
lightdash	🟢 Ready	View Preview	Oct 23, 2026, 4:00 PM

[github-actions]

Documentation validation

✅ All blocking checks passed.

Component system

0 finding(s) across the corpus.

Findings on lines this pull request touched are annotated inline in Files changed.

View the validation run.