feat(create-plugin): add AI authoring assistance to panel-docs codemod - #2843
Draft
sunker wants to merge 3 commits into
Draft
feat(create-plugin): add AI authoring assistance to panel-docs codemod#2843sunker wants to merge 3 commits into
sunker wants to merge 3 commits into
Conversation
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.
@grafana/create-plugin
@grafana/eslint-config
@grafana/eslint-plugin-plugins
@grafana/plugin-docs-cli
@grafana/plugin-docs-parser
@grafana/plugin-e2e
@grafana/plugin-meta-extractor
@grafana/plugin-types-bundler
@grafana/react-detect
@grafana/sign-plugin
@grafana/tsconfig
commit: |
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).
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
wip