AI Insights — Optimal Docs

AI Insights

AI Insights provides instant summaries of trends, bottlenecks, and outliers across your Insights dashboards. It’s available via the purple ⚡ AI Insight button on most views.

Each summary includes real metrics, percentage changes, and practical next steps — helping engineering leads, managers, and CTOs see the story behind the numbers in seconds.

Overview

AI Insights analyzes the data on any Insights dashboard you’re viewing — whether it’s PR Cycle Time, Activity, Contributors, or Distributions — and translates it into natural-language insights.

It automatically applies all the filters you’ve already set (date range, repositories, teams, and users), so every summary is contextual and accurate to what you’re looking at.

The panel provides five key sections:

  1. TL;DR — A short, readable summary of overall trends and performance changes since the last time window.
  2. Trends — Highlights percentage increases or decreases across your main metrics.
  3. Notable patterns — Points out specific behaviors such as who’s reviewing most often, when work tends to happen, or whether large PRs are becoming more common.
  4. Actionable insights — Plain-English recommendations on what to investigate or improve next.
  5. Context — Shows your selected date range, repositories, and teams, with metric definitions.

Where to Find It

The analysis always respects the page’s date picker, team/user filter, and repository filter.

How It Works

  1. You set the view — Choose the time window, team/user, and repositories.
  2. Click “AI Insight” — We compute deltas vs. the prior comparable window and scan for patterns: review behavior, PR sizes, merge cadence, comment density, rework hotspots, weekend activity, etc.
  3. We generate the panel — The right-rail shows Date Range, TL;DR, Activity/PR Trends, Notable Trends, and Actionable Insights.
  4. You drill down — Sort PR tables to find which ones drove the metrics. Use the Activity legend to see who did what, when.

What AI Insights Covers by Page

PR Cycle Time

Identifies which parts of your PR process are speeding up or slowing down:

Activity (Bubble Timeline)

Gives a visual summary of the week’s development activity:

Contributors

Provides an AI-generated coaching summary for each engineer:

Allocations / Distributions

When your team uses labels like feature, tech-debt, security, or bug in GitHub or Jira, AI Insight breaks down your engineering effort by category.

Why Teams Use It

AI Insights is most valuable when:

Pro Tips

Notes & Behavior

Troubleshooting

Issue Fix
Panel shows generic text Make sure your selected period contains activity
Not enough data Switch to a longer date range (e.g., 30 days)
Missing data Verify GitHub and Jira integrations are synced and active
Distributions showing “Unlabeled” Add consistent issue/PR labels
Unexpected deltas Toggle from Average → Median in Settings