docs: modernize the Konnect Reference Platform

[rspurgeon]

Summary

• reframes the Konnect Reference Platform as maintained architecture guidance plus a readable working example, not a bootstrap tool
• removes koctl, Konnect Orchestrator, registry, polling, and fictional reference-platform command guidance
• documents federated platform/service ownership with one default branch and distinct development/production resources
• documents direct kongctl and decK workflows, exact-artifact production promotion, RBAC boundaries, and apply-only v1 behavior
• uses Key Auth plus service-scoped ACE for protected APIs and leaves public APIs anonymous
• redirects the removed Orchestrator page and links the optional AI Marketplace skill

Working example PRs

• KongAirlines platform #295
• KongAirlines organization profile #3
• Bookings #3
• Customer #3
• Destinations #1
• Flights #4
• AI Marketplace skill #6

Compatibility dependency

The example manifests intentionally model future external lookup behavior and depend on the control-plane API implementation support in Kong/kongctl#1992. They target the expected kongctl 1.14.0 release rather than introducing a compatibility registry or unsupported wrapper.

Validation

• frontmatter validator: passed
• Vale on all changed Markdown: passed with zero findings
• YAML syntax parsing and git diff --check: passed
• stale koctl/Orchestrator search across the Reference Platform surface: clean

A full local site build could not install its Gem bundle because the outer execution sandbox denies Bundler's required /home/rspurgeon/.bundle cache path. The build did not reach documentation rendering; CI remains the full-site proof.

[netlify]

✅ Deploy Preview for kongdeveloper ready!

Name	Link
🔨 Latest commit	c5fb19a
🔍 Latest deploy log	https://app.netlify.com/projects/kongdeveloper/deploys/6a95e2e7a477230008a878c9
😎 Deploy Preview	https://deploy-preview-6981--kongdeveloper.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

---

To edit notification comments on pull requests, go to your Netlify project configuration.