OBSERVABILITY / grafana
Grafana App Reconciler Logic
Implement scoped resource reconciliation and status updates with explicit event and finalizer behavior.
“Implement reconcilers and watchers for grafana-app-sdk apps …”
01 / THE REASONING
Why this made the selection.
- It implements a grafana-app-sdk TypedReconciler that skips an unchanged generation and writes status with UpdateObject.
- Label filters limit which objects are reconciled, and client.Update is rejected for status because it races with spec changes.
- The definition demonstrates typed reconcile callbacks, requeue scheduling, status-subresource updates and namespace/label filters, with an explicit generation guard.
- Choose reconciliation versus event-style watchers
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- skills/grafana-app-sdk/reconciler-logic/SKILL.md
- README.md
- LICENSE
Our findings
- The reconciler observes current state and returns early when the generation was already observed.
- Status writes go through resource.UpdateObject, and the skill says not to use client.Update.
- LabelFilters such as env=prod mean only matching resources are reconciled.
- The skill does not own resources it does not declare; unmanaged kinds are deferred to a reference.
- The definition demonstrates typed reconcile callbacks, requeue scheduling, status-subresource updates and namespace/label filters, with an explicit generation guard.
- The BasicReconcileOptions example states that leaving Namespace unset watches all namespaces, while a value restricts the watch to one namespace.
Not established by this review
- The resource was not executed and its tools were not called.
- No skill execution, authenticated service operation, or outcome benchmark was performed.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
npx skills add grafana/skills/skills/grafana-app-sdk/reconciler-logic Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.
Optional: install the reviewed revision
Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.
npx skills add https://github.com/grafana/skills/tree/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-app-sdk/reconciler-logic - Install the pinned skill directory interactively, retaining its bundled references and scripts.
- Register the reconciler on the intended kind version and configure scope filters.
- Use the status subresource, handle deleted/resynced actions deliberately and verify repeated reconciliation is safe.
Before you start
- Grafana app SDK project
- Go toolchain, resource client and target kind
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- Pinned skill definition ↗Checked
https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-app-sdk/reconciler-logic/SKILL.md
Supports: summary, whySelected, bestFor, limitations, install, access, review
https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/README.md
Supports: install
- Apache-2.0 licence ↗Checked
https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/LICENSE
Supports: license
https://raw.githubusercontent.com/grafana/skills/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-app-sdk/reconciler-logic/SKILL.md
Supports: review.findings, bestFor, upstreamDescription