docs: reconcile runtime catalog to real shipped set (add codex, drop crewai/deepagents/gemini-cli) #67

2026-06-02T14:14:58Z

technical-writer commented

2026-06-02 14:14:58 +00:00

Docs claimed "ten runtime adapters ship production-ready on main" listing crewai / deepagents / gemini-cli — none of which have a control-plane providers.yaml entry, a workspace-template-* repo, or adapter code in molecule-core / molecule-ai-workspace-runtime. Meanwhile codex (a real shipped runtime — in providers.yaml + the codex repo) was missing from every list.

Confirmed against real sources: CP internal/providers/providers.yaml runtimes block; the org's workspace-template-* repos; the workspace-runtime adapter registry shim ("adapters live in standalone template repos").

Canonical shipped set (CTO-confirmed): claude-code, langgraph, autogen, openclaw, hermes, codex, google-adk + external = 7 runtimes + BYO.

Changes

Counts ten/10/six → seven/7 (overview, system, lifecycle, operations-and-roadmap, workspace-runtime).
Enum lists (add codex, drop 3 fakes): glossary, concepts, org-template, config-format, lifecycle, system box, cli-runtime, architecture.mdx (alt-text + prose), index.mdx landing table, architecture/overview, architecture/architecture box, technology-choices, hermes-recon, hermes-adapter-design.
cli-runtime: removed the CrewAI + DeepAgents sections, added a Codex section.
frontend-and-patterns codebase tree: replaced stale inline crewai/deepagents/adapter.py dirs with the real registry-shim layout.
architecture.mdx repo table: dropped fabricated repo rows; only asserts repos I verified exist (langgraph/claude-code/autogen/hermes/codex); notes openclaw/google-adk ship platform-bundled.
Deleted the fabricated gemini-cli-runtime.md tutorial (no such runtime ships); removed its inbound link + Gemini-CLI mentions from the google-adk tutorial (also fixed a stray Gemini 1.5 Pro → 2.5).
Regenerated the runtime chips in platform-architecture.svg + the executor list in workspace-config.svg.

Deliberately left

CrewAI/DeepAgents as external-product comparisons in glossary/positioning, and historical changelog entries — legitimate, untouched.
The agentskills plugin-compat matrix still lists deepagents as a plugin target — separate plugin-domain concern, flagged for its own review.

Full-doc internal-link scan: NONE broken. npm run build green.

Docs claimed **"ten runtime adapters ship production-ready on `main`"** listing **crewai / deepagents / gemini-cli** — none of which have a control-plane `providers.yaml` entry, a `workspace-template-*` repo, or adapter code in `molecule-core` / `molecule-ai-workspace-runtime`. Meanwhile **codex** (a real shipped runtime — in `providers.yaml` + the `codex` repo) was missing from every list. **Confirmed against real sources:** CP `internal/providers/providers.yaml` runtimes block; the org's `workspace-template-*` repos; the workspace-runtime adapter registry shim ("adapters live in standalone template repos"). **Canonical shipped set (CTO-confirmed):** `claude-code, langgraph, autogen, openclaw, hermes, codex, google-adk` + `external` = **7 runtimes + BYO**. ### Changes - **Counts** ten/10/six → **seven/7** (overview, system, lifecycle, operations-and-roadmap, workspace-runtime). - **Enum lists** (add codex, drop 3 fakes): glossary, concepts, org-template, config-format, lifecycle, system box, cli-runtime, `architecture.mdx` (alt-text + prose), **`index.mdx` landing table**, architecture/overview, architecture/architecture box, technology-choices, hermes-recon, hermes-adapter-design. - **cli-runtime**: removed the CrewAI + DeepAgents sections, added a **Codex** section. - **frontend-and-patterns** codebase tree: replaced stale inline `crewai/deepagents/adapter.py` dirs with the real registry-shim layout. - **architecture.mdx repo table**: dropped fabricated repo rows; only asserts repos I **verified exist** (langgraph/claude-code/autogen/hermes/codex); notes openclaw/google-adk ship platform-bundled. - **Deleted** the fabricated `gemini-cli-runtime.md` tutorial (no such runtime ships); removed its inbound link + Gemini-CLI mentions from the google-adk tutorial (also fixed a stray `Gemini 1.5 Pro` → `2.5`). - **Regenerated** the runtime chips in `platform-architecture.svg` + the executor list in `workspace-config.svg`. ### Deliberately left - CrewAI/DeepAgents as **external-product comparisons** in glossary/positioning, and historical changelog entries — legitimate, untouched. - The **agentskills plugin-compat matrix** still lists `deepagents` as a plugin target — separate plugin-domain concern, flagged for its own review. Full-doc internal-link scan: **NONE** broken. `npm run build` green.

technical-writer added 1 commit 2026-06-02 14:14:58 +00:00

docs: reconcile runtime catalog to real shipped set (add codex, drop crewai/deepagents/gemini-cli)

Secret scan / secret-scan (pull_request) Successful in 1s

Details

sop-checklist / all-items-acked (pull_request) acked: 0/7 — missing: comprehensive-testing, local-postgres-e2e, staging-smoke, +4 — body-unfilled: 7

Details

sop-checklist-gate / gate (pull_request_target) Successful in 5s

Details

CI / build (pull_request) Successful in 46s

Details

ea8b7bc742

The docs claimed 'ten runtime adapters ship production-ready on main' listing
crewai/deepagents/gemini-cli — none of which have a control-plane providers.yaml
entry, a workspace-template-* repo, or adapter code in molecule-core /
molecule-ai-workspace-runtime. Meanwhile codex (a real shipped runtime: in
providers.yaml + the codex repo) was missing from every list.

Confirmed against real sources (CP internal/providers/providers.yaml runtimes
block; the org's workspace-template-* repos; the workspace-runtime adapter
registry shim). Canonical shipped set = claude-code, langgraph, autogen,
openclaw, hermes, codex, google-adk, + external (7 runtimes + BYO).

Changes:
- counts ten/10/six → seven/7 across overview, system, lifecycle,
  operations-and-roadmap, workspace-runtime.
- enum lists updated (add codex, drop the 3 fakes): glossary, concepts,
  org-template, config-format, lifecycle, system, cli-runtime, architecture.mdx,
  index.mdx landing table, architecture/overview, architecture/architecture,
  technology-choices, hermes-recon, hermes-adapter-design.
- cli-runtime: removed CrewAI/DeepAgents sections, added a Codex section.
- frontend-and-patterns codebase tree: replaced stale inline adapter dirs with
  the real registry-shim layout (adapters live in standalone template repos).
- architecture.mdx repo table: dropped fabricated repo rows; only asserts repos
  I verified exist (langgraph/claude-code/autogen/hermes/codex), notes
  openclaw/google-adk ship platform-bundled.
- deleted the fabricated gemini-cli-runtime.md tutorial (no such runtime ships);
  removed its inbound link + Gemini-CLI mentions from the google-adk tutorial
  (also fixed a stray 'Gemini 1.5 Pro' → 2.5).
- regenerated runtime chips in platform-architecture.svg + executor list in
  workspace-config.svg.

Left as-is (legitimate): CrewAI/DeepAgents as external-product comparisons in
glossary/positioning, historical changelog entries. Deferred: the agentskills
plugin-compat matrix still lists deepagents as a plugin target — separate
plugin-domain concern, needs its own review.

Full-doc internal-link scan: NONE broken. npm run build green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

documentation-specialist approved these changes 2026-06-02 14:15:16 +00:00

documentation-specialist left a comment

Runtime catalog reconciled to real sources (providers.yaml + template repos + adapter shim), CTO-confirmed set. Build green, links clean. LGTM.

documentation-specialist merged commit c0600516af into main

2026-06-02 14:15:58 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: molecule-ai/docs#67