added-to-other-system-prompts

packages/ai/src/agents/analyst-agent/analyst-agent-prompt.txt

@@ -407,6 +407,13 @@ You operate in a loop to complete tasks:
             - Assign the primary metric (larger values or main focus) to the left y-axis.
             - Assign the secondary metric (smaller values, ratios, or percentages) to the right y-axis.
             - Ensure each axis is clearly labeled with units, and avoid misleading scales.
+        - **Safeguards for combo chart edge cases**:
+            - **Unit compatibility**: Only combine metrics if they represent comparable units (e.g., counts vs. counts, dollars vs. dollars, percentages vs. percentages). Do not combine metrics with fundamentally different units (e.g., dollars vs clicks) on the same axis.  
+            - **Scale alignment**: Before combining, compare the ranges of the metrics. If one metric is multiple orders of magnitude larger than the other (e.g., 5k-10k vs. 20M-40M), separate them into different charts or different axes.  
+            - **Ratios and rates exception**: If one metric is a ratio or percentage (e.g., CTR, conversion rate), it may be combined with an absolute metric, but always on a **secondary axis**.  
+            - Always verify that both metrics remain visible and interpretable in the chart. If smaller values collapse visually against larger ones, split into separate visualizations.  
+        - Always provide a clear legend or labels indicating which metric corresponds to which axis.
+        - Keep the design clean and avoid overlapping visuals; clarity is more important than compactness.
   - For ambiguous requests (e.g., "Show me our revenue"), default to line charts to show trends over time. This provides both the trend and the latest value, covering multiple possibilities
   - Use number cards for displaying single values or key metrics (e.g., "Total Revenue: $1000")
     - For requests identifying a single item (e.g., "the product with the most revenue"), include the item name in the title or description (e.g., "Revenue of Top Product: Product X - $500")

packages/ai/src/agents/think-and-prep-agent/think-and-prep-agent-standard-prompt.txt

@@ -591,6 +591,11 @@ When in doubt, be more thorough rather than less. Reports are the default becaus
             - Assign the primary metric (larger values or main focus) to the left y-axis.
             - Assign the secondary metric (smaller values, ratios, or percentages) to the right y-axis.
             - Ensure each axis is clearly labeled with units, and avoid misleading scales.
+        - **Safeguards for combo chart edge cases**:
+            - **Unit compatibility**: Only combine metrics if they represent comparable units (e.g., counts vs. counts, dollars vs. dollars, percentages vs. percentages). Do not combine metrics with fundamentally different units (e.g., dollars vs clicks) on the same axis.  
+            - **Scale alignment**: Before combining, compare the ranges of the metrics. If one metric is multiple orders of magnitude larger than the other (e.g., 5k-10k vs. 20M-40M), separate them into different charts or different axes.  
+            - **Ratios and rates exception**: If one metric is a ratio or percentage (e.g., CTR, conversion rate), it may be combined with an absolute metric, but always on a **secondary axis**.  
+            - Always verify that both metrics remain visible and interpretable in the chart. If smaller values collapse visually against larger ones, split into separate visualizations.  
         - Always provide a clear legend or labels indicating which metric corresponds to which axis.
         - Keep the design clean and avoid overlapping visuals; clarity is more important than compactness.
     - Use tables only when: