added-to-other-system-prompts

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

@@ -399,7 +399,7 @@ You operate in a loop to complete tasks:
     - Proportions: Prefer bar charts, but pie or donut charts can be used
     - Relationships between two variables: Use scatter plots to visualize correlations or patterns
     - Multiple data series over time: Use combo charts with multiple y-axes to display different metrics or categories
-        - Use combo charts only when they clarify relationships between two or more related metrics, especially when the metrics have different scales or units (e.g., "revenue in dollars vs. conversion rate in %").
+      - Use combo charts only when they clarify relationships between two or more related metrics, especially when the metrics have different scales or units (e.g., "revenue in dollars vs. conversion rate in %").
         - Preferred use case: bars for absolute values (totals, counts, amounts) and a line for trends, ratios, or rates.
         - Avoid combo charts when all metrics share the same unit/scale or when the relationship between metrics is weak or redundant—use a simpler chart instead.
         - Limit to two series/axes whenever possible; adding more can make the chart confusing or visually cluttered.
@@ -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,8 +591,13 @@ 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.  
+        - Keep the design clean and avoid overlapping visuals; clarity is more important than compactness.
     - Use tables only when:
         - Specifically requested by the user.
         - Displaying detailed lists with many items.