Drive Panel Desk from your own code

{"task":"review","dashboard":"{\"title\":\"Checkout — Service Overview\",\"panels\":[…]}","audience":"ops","emphasis":"general","environment":"Checkout service, Grafana 11.3 on Grafana Cloud, wall display in the ops room plus a runbook link","carryover":"","facts":["DS-002 critical: panels[4] \"Latency\" target A pins datasource uid PBFA97CFB590B2093","DS-011 warn: refresh 10s over 24 targets is 144 queries/min"]}

{ …envelope…, "verdict": "rework",
  "blocking": [{"item":"Rotate the Bearer token in panels[9].links[0] and delete it from the document","why":"the export is served to every viewer of the board"},
               {"item":"Give panels[0] and panels[3] a unit","why":"an unlabelled number on an incident board gets read as the wrong unit"}] }

{"task":"queries","dashboard":"{\"title\":\"Checkout — Service Overview\",\"panels\":[…]}","audience":"eng","emphasis":"queries","environment":"Mimir behind one Prometheus datasource, roughly 2.4M active series","carryover":"Previous lane: review. Verdict: rework. Blocking: embedded token, missing units…","facts":["DS-004 high: panels[2] \"Memory\" target A takes rate() over a gauge metric","DS-009 high: panels[7] target B groups by pod_id"]}

{ …envelope…, "verdict": "tune",
  "queries": [{"panel":"panels[2] \"Memory\"","ref_id":"A","verdict":"rewrite",
               "issue":"rate() is taken over a gauge, so the panel is drawing noise",
               "rewrite":"avg by (pod) (container_memory_working_set_bytes{namespace=\"$namespace\"})",
               "cardinality":"one series per pod, bounded by the namespace selector",
               "why":"a gauge has no monotonic increase for rate() to measure"}] }

{"task":"portable","dashboard":"{\"title\":\"Checkout — Service Overview\",\"panels\":[…]}","audience":"eng","emphasis":"portability","environment":"promoting staging to prod, provisioned from a Git repo with Grafana 11 file provisioning","carryover":"","facts":["DS-002 critical: 7 of 9 panels pin datasource uid PBFA97CFB590B2093","DS-007 warn: no datasource-type template variable exists"]}

{ …envelope…, "verdict": "pinned",
  "provision": {"ready": false,
    "steps": ["Add the templating entry below","Replace every literal uid with ${DS_PROM}","Null the root id and drop the __inputs wrapper"],
    "blockers": ["7 panels pin a uid that does not exist in the target org"],
    "variable_block": "{\"name\":\"DS_PROM\",\"type\":\"datasource\",\"query\":\"prometheus\",\"label\":\"Datasource\",\"current\":{}}",
    "note": "folder placement and the alert rules that reference this board stay manual"} }

{"task":"cost","dashboard":"{\"title\":\"Checkout — Service Overview\",\"panels\":[…]}","audience":"exec","emphasis":"cost","environment":"Grafana Cloud, billed on queries; the board is open on a wall display all day","carryover":"Previous lane: review. Verdict: rework…","facts":["DS-011 warn: refresh 10s over 24 targets is 144 queries/min","DS-014 note: panels[6] repeats over $pod at 12 options"]}

{ …envelope…, "verdict": "expensive",
  "budget": {"queries_per_minute_now": 144, "queries_per_minute_after": 24, "reduction_pct": 83,
    "basis": "the reader's 24 targets at the board's own 10s refresh",
    "note": "the repeat multiplier on panels[6] is a render-time factor and is counted separately, not folded in",
    "wins": [{"action":"Refresh 10s to 1m","saves":"144 to 24 queries/min","effort":"low"},
             {"action":"Precompute the two histogram_quantile panels as recording rules","saves":"the two most expensive targets stop scanning buckets","effort":"medium"}]} }

{
  "task": "review",
  "dashboard": "<the exported Grafana dashboard JSON, as a STRING>",
  "audience": "ops",
  "emphasis": "general",
  "environment": "free text: what the board is for, the Grafana version, the stack",
  "carryover": "optional: the previous lane's digest",
  "facts": ["DS-002 critical: panels[4] \"Latency\" target A pins datasource uid PBFA97CFB590B2093", "…"]
}

{
  "lane": "review",
  "dashboard_name": "Checkout — Service Overview",
  "verdict": "<one of the lane's verdict values>",
  "headline": "one sentence, under 140 characters, that a person could paste into a ticket",
  "overview": "2 to 4 sentences: what this dashboard is, what state it is in, what happens next",
  "checks": [{"name": "<one of the lane's check names, in the lane's order>",
              "status": "pass | warn | fail | n/a",
              "note": "one specific sentence"}],
  "findings": [{"id": "PD-001",
                "severity": "critical | high | medium | low",
                "title": "short, specific",
                "where": "panels[4] \"p99 latency\" target B, or templating.list[1] \"namespace\", or root",
                "why": "what goes wrong, in consequence terms",
                "fix": "what to change, concretely",
                "snippet": "the JSON or PromQL fragment to paste in, or \"\""}],
  "coverage_check": [{"flag": "DS-002", "handled": true, "note": "how this lane addressed it"}],
  "next_steps": ["3 to 6 imperative sentences, in the order they should be done"],
  "<lane block>": "<exactly one, see the table below>"
}