Notebook Guidance

When to Use a Notebook

Before choosing to use a notebook, evaluate the task complexity using these heuristics.

Use a notebook if you meet at least one of these criteria:

• 📈 Data Insights & Storytelling: Use a notebook for any request to "give insights", "find trends", "explore data", or "analyze data". These tasks benefit from using visualizations to present the data.
• 📊 Visualizations are requested: The user explicitly asks for charts or plots.
• 🔄 Stateful / Iterative Exploration: You need to run a query, inspect results, and decide the next query based on those results while keeping state in memory.

Do NOT use a notebook ONLY if: