Skip to content

feat(create-plugin): add AI authoring assistance to panel-docs codemod - #2843

Draft
sunker wants to merge 3 commits into
eriksundell/panel-docs-codemodfrom
eriksundell/panel-docs-codemod-with-ai
Draft

feat(create-plugin): add AI authoring assistance to panel-docs codemod#2843
sunker wants to merge 3 commits into
eriksundell/panel-docs-codemodfrom
eriksundell/panel-docs-codemod-with-ai

Conversation

@sunker

@sunker sunker commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

wip

Adds an opt-in --agent-loop=claude|codex|cursor|none flag that scaffolds
an AGENTS.md authoring guide plus four skills (bootstrap, write, review,
validate) for keeping panel plugin docs in sync with source. Also fixes
a Context.updateFile bug that dropped mkdirSync for files added and then
updated in the same run, and bumps the plugin-docs-cli pin to 0.2.1.
@sunker sunker added the preview Opts the PR into pkg.pr.new preview publishing label Aug 21, 2026
@pkg-pr-new

pkg-pr-new Bot commented Aug 21, 2026

Copy link
Copy Markdown

Open in StackBlitz

@grafana/create-plugin

npm i https://pkg.pr.new/grafana/plugin-tools/@grafana/create-plugin@2edacb8 -D

@grafana/eslint-config

npm i https://pkg.pr.new/grafana/plugin-tools/@grafana/eslint-config@2edacb8 -D

@grafana/eslint-plugin-plugins

npm i https://pkg.pr.new/grafana/plugin-tools/@grafana/eslint-plugin-plugins@2edacb8 -D

@grafana/plugin-docs-cli

npm i https://pkg.pr.new/grafana/plugin-tools/@grafana/plugin-docs-cli@2edacb8 -D

@grafana/plugin-docs-parser

npm i https://pkg.pr.new/grafana/plugin-tools/@grafana/plugin-docs-parser@2edacb8 -D

@grafana/plugin-e2e

npm i https://pkg.pr.new/grafana/plugin-tools/@grafana/plugin-e2e@2edacb8 -D

@grafana/plugin-meta-extractor

npm i https://pkg.pr.new/grafana/plugin-tools/@grafana/plugin-meta-extractor@2edacb8 -D

@grafana/plugin-types-bundler

npm i https://pkg.pr.new/grafana/plugin-tools/@grafana/plugin-types-bundler@2edacb8 -D

@grafana/react-detect

npm i https://pkg.pr.new/grafana/plugin-tools/@grafana/react-detect@2edacb8 -D

@grafana/sign-plugin

npm i https://pkg.pr.new/grafana/plugin-tools/@grafana/sign-plugin@2edacb8 -D

@grafana/tsconfig

npm i https://pkg.pr.new/grafana/plugin-tools/@grafana/tsconfig@2edacb8 -D

commit: 2edacb8

minimist doesn't camelCase kebab-case flags, so --agent-loop never
matched the agentLoop schema key - the flag was silently unusable no
matter what value was passed, confirmed via a live create-plugin add
panel-docs --agent-loop=claude run. Renamed to --agentLoop, matching
this repo's existing convention of camelCase flags mapping directly to
camelCase schema keys (e.g. docsPath).
@grafana-catalog-project-bot grafana-catalog-project-bot Bot moved this from 📬 Triage to 🧑‍💻 In development in Grafana Catalog Team Aug 21, 2026
Multi-page docs render on one general catalog page read by anyone
evaluating the plugin, so there is no persona to ask about - dropped
the "who is the target user" question. Also made the panel-purpose
question conditional: if source or README already state it clearly,
confirm that instead of asking an open question. Found via a live
bootstrap-plugin-docs run against clock-panel.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

preview Opts the PR into pkg.pr.new preview publishing

Projects

Status: 🧑‍💻 In development

Development

Successfully merging this pull request may close these issues.

1 participant