OpenChoreo Developer Guide

Help an application developer ship and operate a service on OpenChoreo through the control-plane MCP server. Discover the live platform shape via MCP; read detailed references only when the task needs them.

Step 0 — Confirm MCP connectivity

Run list_namespaces. If the tool isn't reachable, tell the user the openchoreo-cp MCP server needs configuring per https://openchoreo.dev/docs/ai/mcp-servers/ and stop.

Step 1 — Load concepts (MANDATORY)

Read ./references/concepts.md in full before anything else. Not optional, even if the task looks simple — you'll get these wrong from memory. Load once per session; if you catch yourself acting without it, stop and load now.

Then load the matching reference for the task:

• First-time deploy (no Project yet, or first time touching OpenChoreo) → ./references/getting-started.md
• Working with existing Components → straight to the matching recipe. To pick between BYO and source-build for an existing Component, get_component and check spec.workflow: present → build-from-source.md, absent → deploy-prebuilt-image.md.

Step 2 — Load the PE skill for platform tasks