AddThisFeature

AI Insight Cards

Turn a report into a few grounded cards, each tied to a number the app calculated.

involved AI Analysis & Search

What it adds

A small set of cards summarising notable movements in a report, each linked to the query and figure that produced it.

What your agent is told to do

5
  1. 1

    Detect candidate movements in the app first, using the report's own aggregations. The model ranks and phrases the candidates it is given; it does not go looking for them and it does not produce the arithmetic.

  2. 2

    Bind each card to the query, metric, and period that support it, and make the card link through to the filtered view so a reader can check it in one click.

  3. 3

    Set a materiality threshold before generation, in both relative and absolute terms, so a swing on a metric with three events does not outrank a real change on a metric with thousands.

  4. 4

    Cap the set at a handful of cards and deduplicate before rendering. Two cards describing the same movement from different angles read as two separate problems.

  5. 5

    This feature owns the individual, evidenced cards. The dashboard-level narrative paragraph belongs to AI Dashboard Insights; where both exist, that feature should summarise these cards rather than analysing the data a second time.

Edge cases it handles

8
  • A card with no traceable support is not shippable. Every card must carry the metric and query behind it, and any card whose supporting query cannot be re-run must be dropped rather than shown unsourced.
  • The same movement will surface through several metrics at once. Deduplicate on the underlying movement, not on the wording, or a single drop will produce four near-identical cards.
  • Percentage change on a small base is noise. Enforce a minimum absolute volume alongside the relative threshold so a move from two to four does not present as a hundred percent surge.
  • Every number rendered on a card comes from the app's own calculation. Do not display a figure the model produced, even when it appears to match, because the one time it does not will be silent.
  • Cards are tied to a filter set and a data snapshot. When filters change or the source data is reprocessed, expire the cards and regenerate rather than leaving figures that no longer reconcile with the report.
  • Cards must respect the viewer's permissions individually. A card built on a metric this viewer cannot access must not render, even when the report itself is visible to them.
  • Set a per-generation cost and token ceiling, and cache by filter set and snapshot so that reopening a report does not trigger a fresh run.
  • A refusal, timeout, or unparseable response should show no cards and no error framing that suggests the report itself is broken.

Definition of done

9
  • Every card cites the metric and query supporting it and links to the filtered view.
  • All displayed figures come from the app's own calculations, never from model output.
  • Cards describing the same underlying movement are collapsed into one.
  • Materiality thresholds combine relative and absolute change, so small-base noise is excluded.
  • Cards expire and regenerate when filters or source data change.
  • Cards built on metrics the viewer cannot access are not rendered.
  • A model failure yields no cards while the report remains fully usable.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.