docs(README): comprehensive refresh — landing-page icon (light/dark SVG) + 8 runtimes + Canvas v4 + Memory v2 + SaaS + channel plugin #5

2026-05-06T23:56:35Z

2026-05-06 23:56:35 +00:00

Why

The README hadn't been refreshed since the v0 wave. Several major shipped surfaces weren't called out (Canvas v4 warm-paper theme, Memory v2 with pgvector, RFC #2967 typed-SSOT A2A response path, the SaaS control plane, the molecule-mcp-claude-channel plugin we just shipped via v0.4.0/0.4.1/0.4.2). The runtime list still said "6" when 8 are in production. The icon was a 1.3 MB PNG with no light-mode variant.

What changed

Landing-page-derived SVG icon with prefers-color-scheme styles so the GitHub README renders cleanly in both light + dark. Wordmark variant added.
8 production runtimes named throughout: Claude Code, Hermes, Gemini CLI, LangGraph, DeepAgents, CrewAI, AutoGen, OpenClaw. Comparison table grew Hermes 4 + Gemini CLI rows.
Canvas v4 — warm-paper theme system called out alongside the existing stack notes.
Memory v2 backed by pgvector — semantic-recall callout in pitch + runtime sections.
RFC #2967 typed-SSOT A2A response path named in platform ship list + arch diagram.
SaaS surface section — multi-tenant EC2 + Neon + Cloudflare Tunnels, WorkOS + Stripe, KMS envelope, tenant_resources audit + 30-min reconciler. Cross-links molecule-controlplane.
molecule-mcp-claude-channel plugin — Claude Code entry point. Documents the standard /plugin marketplace add install flow + multi-tenant config.
Architecture diagram redrawn with Canvas → Platform → Postgres + Provisioner (Docker | EC2+SSM) layout, plus a SaaS control plane block.
Quick Start URL fixed (molecule-monorepo → molecule-core); Go 1.25, Python ≥3.11 noted.

Diff

README.md                              | 75 +++++++++++++++++++++++-----------
docs/assets/branding/molecule-icon.svg | 28 +++++++++++++
docs/assets/branding/molecule-logo.svg | 17 ++++++++
3 files changed, 97 insertions(+), 23 deletions(-)

Docs-only; no code change. The provisioner refactor that lived alongside an earlier draft on docs/readme-refresh-2026-05-06 is OUT of this PR (shipped separately via #6).

Out of scope (parked)

README.zh-CN.md mirror — non-trivial translation; file as separate issue if wanted.
molecule-ai/.github org-profile README — Gitea has no equivalent surface, and the GitHub org is suspended.

🤖 Generated with Claude Code

## Why The README hadn't been refreshed since the v0 wave. Several major shipped surfaces weren't called out (Canvas v4 warm-paper theme, Memory v2 with pgvector, RFC #2967 typed-SSOT A2A response path, the SaaS control plane, the molecule-mcp-claude-channel plugin we just shipped via v0.4.0/0.4.1/0.4.2). The runtime list still said "6" when 8 are in production. The icon was a 1.3 MB PNG with no light-mode variant. ## What changed - **Landing-page-derived SVG icon** with `prefers-color-scheme` styles so the GitHub README renders cleanly in both light + dark. Wordmark variant added. - **8 production runtimes** named throughout: Claude Code, Hermes, Gemini CLI, LangGraph, DeepAgents, CrewAI, AutoGen, OpenClaw. Comparison table grew Hermes 4 + Gemini CLI rows. - **Canvas v4** — warm-paper theme system called out alongside the existing stack notes. - **Memory v2 backed by pgvector** — semantic-recall callout in pitch + runtime sections. - **RFC #2967 typed-SSOT A2A response path** named in platform ship list + arch diagram. - **SaaS surface section** — multi-tenant EC2 + Neon + Cloudflare Tunnels, WorkOS + Stripe, KMS envelope, tenant_resources audit + 30-min reconciler. Cross-links `molecule-controlplane`. - **molecule-mcp-claude-channel plugin** — Claude Code entry point. Documents the standard `/plugin marketplace add` install flow + multi-tenant config. - **Architecture diagram** redrawn with Canvas → Platform → Postgres + Provisioner (Docker | EC2+SSM) layout, plus a SaaS control plane block. - **Quick Start URL fixed** (`molecule-monorepo` → `molecule-core`); Go 1.25, Python ≥3.11 noted. ## Diff ``` README.md | 75 +++++++++++++++++++++++----------- docs/assets/branding/molecule-icon.svg | 28 +++++++++++++ docs/assets/branding/molecule-logo.svg | 17 ++++++++ 3 files changed, 97 insertions(+), 23 deletions(-) ``` Docs-only; no code change. The provisioner refactor that lived alongside an earlier draft on `docs/readme-refresh-2026-05-06` is OUT of this PR (shipped separately via #6). ## Out of scope (parked) - README.zh-CN.md mirror — non-trivial translation; file as separate issue if wanted. - molecule-ai/.github org-profile README — Gitea has no equivalent surface, and the GitHub org is suspended. 🤖 Generated with Claude Code

hongming was assigned by claude-ceo-assistant

2026-05-07 10:29:23 +00:00

Ghost approved these changes 2026-05-07 11:38:49 +00:00

Dismissed

Ghost left a comment

Hongming-approved (chat 2026-05-07): README refresh + branding SVGs. Doc-only.

claude-ceo-assistant force-pushed docs/readme-comprehensive-refresh-2026-05-06 from 04e0e3d2c6 to ea7f35b724

2026-05-07 11:42:59 +00:00

Compare

Ghost approved these changes 2026-05-07 11:46:27 +00:00

Ghost left a comment

Rebase clean post-cascade. README + branding SVGs. Hongming approved content earlier; pre-existing infra-class CI failures unrelated to this PR.