Skip to content

docs(#3222): add guidance for validating appConfigExamples on new plugins - #3223

Open
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/3222-add-plugin-config-guidance
Open

docs(#3222): add guidance for validating appConfigExamples on new plugins#3223
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/3222-add-plugin-config-guidance

Conversation

@fullsend-ai-coder

Copy link
Copy Markdown
Contributor

Add "Adding New Plugins to Existing Workspaces" section to AGENTS.md, placed after the existing "Adding a New Workspace" section. The new guidance instructs code agents to read the upstream plugin's config.d.ts or configSchema before writing appConfigExamples in metadata YAML, rather than copying config patterns from sibling plugins in the same workspace.

This addresses the pattern seen in PR #3220 where the kserve plugin metadata was created with appConfigExamples copied from the model-catalog sibling, but the kserve plugin expects a different config shape (nested cluster objects vs flat baseUrl strings).

The section covers five verification steps: reading the upstream config schema, cross-referencing appConfigExamples types, avoiding verbatim sibling copies, checking upstream READMEs, and running smoke tests.


Closes #3222

Post-script verification

  • Branch is not main/master (agent/3222-add-plugin-config-guidance)
  • Secret scan passed (gitleaks — ed16ff0d1430c2f8f6a7c044f7a2e28a086a7750..HEAD)
  • Pre-commit hooks passed (authoritative run on runner)
  • Tests ran inside sandbox

…gins

Add "Adding New Plugins to Existing Workspaces" section to AGENTS.md,
placed after the existing "Adding a New Workspace" section. The new
guidance instructs code agents to read the upstream plugin's config.d.ts
or configSchema before writing appConfigExamples in metadata YAML, rather
than copying config patterns from sibling plugins in the same workspace.

This addresses the pattern seen in PR #3220 where the kserve plugin
metadata was created with appConfigExamples copied from the model-catalog
sibling, but the kserve plugin expects a different config shape (nested
cluster objects vs flat baseUrl strings).

The section covers five verification steps: reading the upstream config
schema, cross-referencing appConfigExamples types, avoiding verbatim
sibling copies, checking upstream READMEs, and running smoke tests.

Closes #3222
@openshift-ci

openshift-ci Bot commented Aug 10, 2026

Copy link
Copy Markdown

Hi @fullsend-ai-coder[bot]. Thanks for your PR.

I'm waiting for a redhat-developer member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work.

Regular contributors should join the org to skip this step.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

@sonarqubecloud

Copy link
Copy Markdown

@github-actions github-actions Bot added the non-workspace-changes PR changes files outside workspace directories label Aug 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs-ok-to-test non-workspace-changes PR changes files outside workspace directories

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add AGENTS.md guidance for validating appConfigExamples when adding new plugins

0 participants