From 6f297101291c101a742cd0903f0dc02fff35ca5d Mon Sep 17 00:00:00 2001 From: ahfoysal Date: Sun, 5 Jul 2026 16:20:15 +0600 Subject: [PATCH] docs: make pack routers cloud-agent safe --- ocp-admin/AGENTS.md | 2 +- rh-ai-engineer/AGENTS.md | 2 +- rh-automation/AGENTS.md | 4 ++-- rh-basic/AGENTS.md | 2 +- rh-developer/AGENTS.md | 2 +- rh-sre/AGENTS.md | 4 ++-- rh-virt/AGENTS.md | 2 +- 7 files changed, 9 insertions(+), 9 deletions(-) diff --git a/ocp-admin/AGENTS.md b/ocp-admin/AGENTS.md index 22d9ecdb..1862f31f 100644 --- a/ocp-admin/AGENTS.md +++ b/ocp-admin/AGENTS.md @@ -38,7 +38,7 @@ After completing a skill, suggest relevant next-step skills to the user. ## MCP Servers -Three MCP servers are available. Skills manage these automatically — do not call their tools directly. +Three MCP servers may be available in local runtimes. Skills manage these automatically — do not call their tools directly. - **openshift-self-managed** (Required for cluster-creator, cluster-inventory) — Assisted Installer API for self-managed cluster lifecycle (OCP, SNO). Requires OFFLINE_TOKEN from https://cloud.redhat.com/openshift/token. - **openshift-ocm-managed** (Required for cluster-inventory) — OpenShift Cluster Manager API for managed service clusters (ROSA, ARO, OSD). Requires OFFLINE_TOKEN. diff --git a/rh-ai-engineer/AGENTS.md b/rh-ai-engineer/AGENTS.md index 31299dfb..c2afbe87 100644 --- a/rh-ai-engineer/AGENTS.md +++ b/rh-ai-engineer/AGENTS.md @@ -42,7 +42,7 @@ After completing a skill, suggest relevant next-step skills to the user. ## MCP Servers -Three MCP servers are available. Skills manage these automatically — do not call their tools directly. +Three MCP servers may be available in local runtimes. Skills manage these automatically — do not call their tools directly. - **openshift** (Required) — Kubernetes resource CRUD, pod logs, events. The reliable foundation. - **rhoai** (Preferred) — RHOAI-specific convenience tools. May return auth errors; skills fall back to openshift automatically. diff --git a/rh-automation/AGENTS.md b/rh-automation/AGENTS.md index 2e93308d..10f1556e 100644 --- a/rh-automation/AGENTS.md +++ b/rh-automation/AGENTS.md @@ -46,7 +46,7 @@ After completing a skill, suggest relevant next-step skills (for example, after ## MCP Servers -Six HTTP MCP servers are configured for this pack. Skills wrap these — do not call their tools directly. +Six HTTP MCP servers may be available in local runtimes. Skills wrap these — do not call their tools directly. - **aap-mcp-job-management** (Required for jobs and execution) — Job templates, launches, events, statuses, workflows, approvals. - **aap-mcp-inventory-management** (Required for inventory-scoped work) — Inventories, hosts, groups, host facts (`ansible_facts`). @@ -55,7 +55,7 @@ Six HTTP MCP servers are configured for this pack. Skills wrap these — do not - **aap-mcp-system-monitoring** (Required for full governance readiness) — Instance groups, activity stream, mesh topology, platform status. - **aap-mcp-user-management** (Required for full governance readiness) — Users, teams, organizations, roles, RBAC. -Environment variables `AAP_MCP_SERVER` and `AAP_API_TOKEN` are defined in `mcps.json` using `${...}` placeholders only; never expose secret values in chat output. +Environment variables `AAP_MCP_SERVER` and `AAP_API_TOKEN` should be configured with `${...}` placeholders only; never expose secret values in chat output. ## Global Rules diff --git a/rh-basic/AGENTS.md b/rh-basic/AGENTS.md index 71085c7f..c26e3624 100644 --- a/rh-basic/AGENTS.md +++ b/rh-basic/AGENTS.md @@ -25,7 +25,7 @@ If the request doesn't clearly match one skill, ask the user to clarify. ## MCP Servers -One MCP server is configured for this pack. Skills wrap it — do not call its tools directly. +One MCP server may be available in local runtimes. Skills wrap it — do not call its tools directly. - **red-hat-security** — Red Hat Security API: CVE metadata, advisories, and errata data. Uses Red Hat Customer Portal browser SSO — no credentials or env vars required. diff --git a/rh-developer/AGENTS.md b/rh-developer/AGENTS.md index 55478f73..0a3d8141 100644 --- a/rh-developer/AGENTS.md +++ b/rh-developer/AGENTS.md @@ -54,7 +54,7 @@ After completing a skill, suggest relevant next-step skills to the user. ## MCP Servers -Five MCP servers are available. Skills manage these automatically — do not call their tools directly. +Five MCP servers may be available in local runtimes. Skills manage these automatically — do not call their tools directly. - **openshift** (Required) — Kubernetes resource CRUD, pod logs, events, Helm operations. The reliable foundation. - **observability** (Required) — Prometheus metric discovery, metadata, series, and PromQL queries. Used by `/incident-triage` for trend analysis and saturation detection. diff --git a/rh-sre/AGENTS.md b/rh-sre/AGENTS.md index 432f74d5..120ca0ae 100644 --- a/rh-sre/AGENTS.md +++ b/rh-sre/AGENTS.md @@ -46,13 +46,13 @@ After completing a skill, suggest relevant next-step skills (for example, after ## MCP Servers -Three MCP server families are configured for this pack. Skills wrap these — do not call their tools directly. +Three MCP server families may be available in local runtimes. Skills wrap these — do not call their tools directly. - **lightspeed-mcp** (Required for CVE/inventory skills) — Red Hat Lightspeed: CVE data, affected systems, inventory, playbook generation entrypoints used by skills. - **aap-mcp-job-management** (Required for execution paths) — AAP job templates, projects, job runs. - **aap-mcp-inventory-management** (Required for execution paths) — AAP inventories and hosts. -Environment variables are defined in `mcps.json` using `${...}` placeholders only; never expose secret values in chat output. +Environment variables should be configured with `${...}` placeholders only; never expose secret values in chat output. ## Global Rules diff --git a/rh-virt/AGENTS.md b/rh-virt/AGENTS.md index 34baf35d..40f741af 100644 --- a/rh-virt/AGENTS.md +++ b/rh-virt/AGENTS.md @@ -40,7 +40,7 @@ After completing a skill, suggest relevant next-step skills to the user. ## MCP Servers -One MCP server is available. Skills manage it automatically — do not call its tools directly. +One MCP server may be available in local runtimes. Skills manage it automatically — do not call its tools directly. - **openshift-virtualization** (Required) — KubeVirt operations for VM management. Uses OpenShift/Kubernetes API via KUBECONFIG. Requires cluster with OpenShift Virtualization operator installed (>= 4.19).