rhoai-mcp: Command for Claude Code

Scaffold Plugin

Scaffold a new domain or composite plugin for rhoai-mcp.

Instructions

You are scaffolding a new plugin. Follow these steps exactly.

Step 1: Gather Information

Ask the user these questions one at a time (wait for each answer before asking the next):

1. Plugin type: Domain (wraps a single K8s resource) or Composite (orchestrates multiple domains)?
2. Plugin name: snake_case module name (e.g., my_feature)
3. Resource name: Singular noun for the K8s resource (e.g., widget). Used in tool names like list_widgets, get_widget.
4. Custom CRDs? Does this domain use custom Kubernetes CRDs? If yes, ask for:
   • CRD group (e.g., my.domain.io)
   • CRD version (e.g., v1)
   • CRD plural (e.g., widgets)
   • CRD kind (e.g., Widget)
5. Optional features: Does it need MCP resources (data endpoints) or prompts (workflow guides)?
6. Maintainer: Email for the plugin maintainer (default: [email protected])

Derive these variables from the answers:

• DOMAIN_NAME = plugin name (snake_case)
• DOMAIN_CLASS = PascalCase version of plugin name (e.g., my_feature -> MyFeature)
• DOMAIN_DESCRIPTION = humanized version (e.g., "My Feature management")
• RESOURCE_NAME = resource name (snake_case singular)
• RESOURCE_CLASS = PascalCase version of resource name (e.g., widget -> Widget)
• CRD_GROUP, CRD_VERSION, CRD_PLURAL, CRD_KIND = CRD details (if applicable)
• CRD_KIND_UPPER = uppercased CRD kind (e.g., Widget -> WIDGET)
• MAINTAINER = maintainer email

Step 2: Generate Files

Replace ALL {PLACEHOLDER} patterns in the code blocks below with the derived values.

---

Domain Plugin Files

If the user chose Domain, create the following files under src/rhoai_mcp/domains/{DOMAIN_NAME}/:

__init__.py

"""{DOMAIN_DESCRIPTION} domain."""

from rhoai_mcp.domains.{DOMAIN_NAME}.client import {DOMAIN_CLASS}Client
from rhoai_mcp.domains.{DOMAIN_NAME}.models import (
    {RESOURCE_CLASS},
    {RESOURCE_CLASS}Status,
)

__all__ = [
    "{DOMAIN_CLASS}Client",
    "{RESOURCE_CLASS}",
    "{RESOURCE_CLASS}Status",
]