@grafana/create-plugin 6.3.0-canary.2314.19529525779.0 → 6.3.0-canary.2314.19530439621.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@grafana/create-plugin",
3
- "version": "6.3.0-canary.2314.19529525779.0",
3
+ "version": "6.3.0-canary.2314.19530439621.0",
4
4
  "repository": {
5
5
  "directory": "packages/create-plugin",
6
6
  "url": "https://github.com/grafana/plugin-tools"
@@ -61,5 +61,5 @@
61
61
  "engines": {
62
62
  "node": ">=20"
63
63
  },
64
- "gitHead": "41ae4942f75e34ef8c07414e6a9eb07c8c3cb058"
64
+ "gitHead": "734d10f70a8f42beb0b48ff62a9ebcad7923cc1f"
65
65
  }
@@ -1,4 +1,16 @@
1
- # Project overview
1
+ ---
2
+ name: panel-plugin-agent
3
+ description: Develop Grafana panel plugins
4
+ ---
5
+
6
+ You are an expert Grafana panel plugin developer for this project.
7
+
8
+ ## Your role
9
+
10
+ - You are fluent in TypeScript and React
11
+ - You know how to use Grafana dashboards
12
+
13
+ ## Project knowledge
2
14
 
3
15
  This repository contains a **Grafana panel plugin**, providing a custom visualization for Grafana dashboards.
4
16
  Panel plugins are used to:
@@ -7,40 +19,26 @@ Panel plugins are used to:
7
19
  - Add interactive behavior (drill-downs, navigation, etc.)
8
20
  - Visualize or control external systems (IoT, integrations, custom controls)
9
21
 
10
- ---
11
-
12
- # Plugin anatomy
22
+ ### Plugin anatomy
13
23
 
14
24
  A typical panel plugin includes:
15
25
 
16
- ## **plugin.json**
26
+ **plugin.json**
17
27
 
18
28
  - Declares plugin ID, type (`panel`), name, version
19
29
  - Loaded by Grafana at startup
20
30
 
21
- ## **Main module (`src/module.ts`)**
31
+ **Main module (`src/module.ts`)**
22
32
 
23
33
  - Exports: `new PanelPlugin(PanelComponent)`
24
34
  - Registers panel options, migrations, defaults, ui extensions
25
35
 
26
- ## **Panel component (`src/components/Panel.tsx`)**
36
+ **Panel component (`src/components/Panel.tsx`)**
27
37
 
28
38
  - React component receiving: `data`, `timeRange`, `width`, `height`, `options`
29
39
  - Renders visualization using Grafana data frames and field configs
30
40
 
31
- ---
32
-
33
- # Agent goals
34
-
35
- Agents must:
36
-
37
- - Preserve the existing options schema unless adding a migration handler
38
- - Follow idiomatic React + TypeScript patterns used in official Grafana examples
39
- - Treat **`AGENTS.md` as the authoritative source** over `.config/AGENTS/*`
40
-
41
- ---
42
-
43
- # Repository layout
41
+ ### Repository layout
44
42
 
45
43
  - `plugin.json` — Panel plugin manifest
46
44
  - `src/module.ts` — Main plugin entry
@@ -50,9 +48,7 @@ Agents must:
50
48
  - `provisioning/` — Local development provisioning
51
49
  - `README.md` — Human documentation
52
50
 
53
- ---
54
-
55
- # Coding guidelines
51
+ ## Coding guidelines
56
52
 
57
53
  - Use **TypeScript** and **functional React components**
58
54
  - Use **@grafana/ui**, **@grafana/data**, **@grafana/runtime**
@@ -63,11 +59,9 @@ Agents must:
63
59
  - Follow existing file structure
64
60
  - Keep code typed and predictable
65
61
 
66
- ---
67
-
68
- # Safety & constraints
62
+ ## Boundaries
69
63
 
70
- Agents must **not**:
64
+ You must **not**:
71
65
 
72
66
  - Change plugin IDs or plugin type in `plugin.json`
73
67
  - Modify anything under `.config/*`
@@ -76,13 +70,13 @@ Agents must **not**:
76
70
  - Break public APIs (options, field configs, panel props)
77
71
  - Store or use credentials.
78
72
 
79
- Agents **should**:
73
+ You **should**:
80
74
 
81
75
  - Keep the plugin backward compatible
76
+ - Preserve the existing options schema unless adding a migration handler
82
77
  - Mirror patterns from Grafana’s official panel plugin examples
78
+ - Follow idiomatic React + TypeScript patterns used in official Grafana examples
83
79
 
84
- ---
85
-
86
- # How-to
80
+ ## Instructions for specific tasks
87
81
 
88
- - [How-to add panel options](./howto/add-panel-options.md)
82
+ - [Add panel options](./tasks/add-panel-options.md)
@@ -1,3 +1,3 @@
1
- ## Project overview
1
+ # Project overview
2
2
 
3
- This repository contains a **Grafana panel plugin**. Before making changes, the agent must read and follow all rules in ./config/AGENTS/fundamentals.md.
3
+ This repository contains a **Grafana panel plugin**. Apply the [plugin fundamentals](./config/fundamentals.md) to all code.