Skip to content

docs(deployment): remove plugin/IDE/NATS references - #426

Open
ruslan-bulko wants to merge 6 commits into
codemie-ai:mainfrom
ruslan-bulko:feature/EPMCDME-14449-remove-plugin-ide-nats-references
Open

ruslan-bulko wants to merge 6 commits into
codemie-ai:mainfrom
ruslan-bulko:feature/EPMCDME-14449-remove-plugin-ide-nats-references

Conversation

@ruslan-bulko

Copy link
Copy Markdown

Summary

Removes outdated references to the plugin toolkit, plugin-engine, and NATS broker across deployment and user guides, and adds migration guidance pointing users to the CodeMie CLI and MCP bridge instead.

Changes

  • Deleted plugin-engine.mdx and the shared _plugin-engine-content.mdx partial; removed plugin-engine from components-deployment and infrastructure-deployment pages (AWS/Azure/GCP Kubernetes)
  • Removed NATS references from on-VM architecture.mdx and prerequisites.md (AWS/Azure/GCP), shared _cluster-requirements.mdx, and _deployment-machine-tools.mdx
  • Rewrote docs/user-guide/tools_integrations/tools/plugin.md (267 lines removed) and docs/admin/update/nats-upgrade.md (68 lines removed) to drop obsolete plugin/NATS content
  • Added CLI/MCP bridge migration guidance to vscode-native-extension.md, mcp/index.md, api-configuration.md, and security-and-identity.md
  • Updated sidebars.ts and template catalogs (assistant-templates.md, workflow-templates.md) to remove plugin toolkit entries

Testing

  • Tested locally with npm start
  • All pages render correctly
  • Images display properly
  • Internal links work
  • Sidebar navigation works

Quality Checks

  • npm run check passes (typecheck + lint + commitlint)
  • No MDX compilation errors
  • No raw angle brackets ( must be <text>)
  • Sidebar references document IDs (not filenames)
  • Images stored locally next to content (not in static/img/)
  • Commit messages follow Conventional Commits
  • No secrets or credentials in documentation

Additional Notes

Part of EPMCDME-14449 — deprecating the plugin/IDE workflow in favor of CodeMie CLI + MCP.

Withdraw Local Developer via Plugin Engine and its Diff variant, and
Local Python Unit Tests Generation Workflow (PoC), from the assistant
and workflow template catalogs. Remove Plugin toolkit references from
GitLab CI/CD Assistant, Autonomous Python/Java Unit Tests Generation
Workflow, and Python Code Coverage Analysis Workflow tool columns.

EPMCDME-14479
Expand the plugin.md deprecation notice and mcp/index.md with
guidance pointing to CodeMie CLI for local/in-editor work and MCP
servers for tool access, explaining that MCP servers configured in
the platform run inside the MCP Connect bridge rather than on the
user's machine, and that MCP is not a drop-in replacement for the
Plugin key-plus-CLI-session flow. Mark the Pluggable Architecture
capability and glossary Plugin entry as deprecated, and add a
deprecation warning to the Plugin-based Claude Code configuration
sub-section in vscode-native-extension.md.

The admin release notes entry for this retirement is deferred: this
repo's release-notes.md entries are created by an automated commit
at actual release-cut time with the real version number (see e.g.
c8adf64, e48e408) — no prior entry ever used a placeholder version.
The drafted Configuration Changes wording is kept in the task plan
under docs/superpowers/tasks/2026-09-18-epmcdme-14477-cli-mcp-guidance/
for whoever adds it once the EPMCDME-14351 release version is cut.

EPMCDME-14477
…ent guides

Remove NATS, NATS Auth Callout, and Plugin Engine from deployment
guidance across AWS, Azure, and GCP: component tables, manual and
scripted deployment procedures, on-VM prerequisites, and shared
cluster-requirements content. Delete the plugin-engine.mdx pages and
shared content for all three clouds, fix the manual-deployment
pagination chain to skip the removed page, and update sidebars.ts.

Mark the NATS_PLUGIN_* env var block in api-configuration.md as
deprecated, and fully retire nats-upgrade.md and the operative
install/setup guide in plugin.md (previously only their top-level
banners were deprecated; the bodies still instructed installing and
running codemie-plugins). Remove Plugin Engine template references
from customer-feature-configuration.md, now that EPMCDME-14479 has
withdrawn the template itself.

The AWS NLB row in infrastructure-deployment/index.md is flagged as
under review rather than removed, since this repo has no way to
confirm whether it also serves non-NATS traffic.

npm run build passes with no broken links.

EPMCDME-14478
…shared prerequisites

Follow-up to e9b824e: a repo-wide search after that commit surfaced 5
files not covered by the original file list. Remove the nats /
nats-auth-callout service rows from the on-VM architecture pages
(AWS, Azure, GCP), the NATS + Auth Callout row from the shared
Kubernetes container-resources sizing table, and the natscli / nsc
tool requirements from the shared Kubernetes deployment-machine
prerequisites (a separate file from the on-VM prerequisites.md pages
already cleaned in e9b824e).

The AWS NLB row in infrastructure-deployment/index.md remains the
one intentional exception, flagged for review rather than removed
per e9b824e.

npm run build passes with no broken links.

EPMCDME-14478
Realign markdown table column padding after content edits from the
EPMCDME-14449 subtasks; no content changes.
@ruslan-bulko
ruslan-bulko force-pushed the feature/EPMCDME-14449-remove-plugin-ide-nats-references branch from ff9bcff to d8681c9 Compare September 18, 2026 14:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant