added agent mode tip and included caution on running upstream before downstream

Author: raphael-intugle

docsite/docs/vibe-coding.md

@@ -79,4 +79,14 @@ You can also perform a semantic search on your data.
 
 The assistant will code out the semantic search capabilities of your `SemanticModel` to find and return relevant columns from your datasets.
 
+:::tip Agent Mode
+Most modern, AI-powered clients support an "agent mode" where the coding assistant can handle the entire workflow for you.
+
+For example, you can directly ask for a final output, like a CSV file:
+
+`/intugle-vibe create a CSV of the top 10 patients by claim count`
+
+The agent will understand the end goal and perform all the necessary intermediate steps for you. It will realize it needs to build the semantic model, generate the data product specification, execute it, and finally provide you with the resulting CSV file—all without you needing to manage the code or the process.
+:::
+
 This workflow accelerates your journey from raw data to insightful data products. Simply describe what you want in plain English and let the assistant handle the details, freeing you from the hassle of digging through documentation.

src/intugle/mcp/semantic_layer/prompts/intugle_vibe_prompt.md

@@ -23,7 +23,10 @@ You also have access to the following tools to inspect the data model:
 
 These tools are useful for understanding the available data to answer user questions or to gather the necessary information for building a data product specification.
 
-**Important:** These tools will only return a response if a semantic model has already been generated and loaded in the user's environment.
+**Important:** 
+- These tools will only return a response if a semantic model has already been generated and loaded in the user's environment.
+
+> **Semantic Search** and **Data Product Generation** both require a `SemanticModel` to be built first. Before you can perform a search or create a data product, you MUST ensure a semantic model has been built. If it hasn't, you should guide the user to build one or build it for them depending on the scenario.
 
 ## Your Task