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

Merged

claude-ceo-assistant merged 2 commits from docs/readme-comprehensive-refresh-2026-05-06 into staging 2026-05-07 11:46:29 +00:00

Conversation 0 Commits 2 Files Changed 4 +145 -42

claude-ceo-assistant commented 2026-05-06 23:56:35 +00:00

Owner

Copy Link

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

claude-ceo-assistant added 1 commit 2026-05-06 23:56:36 +00:00

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

## 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.

## Changes

### Landing-page-derived SVG icon

- New `docs/assets/branding/molecule-icon.svg` matches the landing
  page's `public/favicon.svg` shape (5-spoke molecular graph) but
  carries `prefers-color-scheme` styles so it adapts to GitHub's
  light/dark modes. The PNG stays for back-compat with anything
  that hotlinks it.
- `docs/assets/branding/molecule-logo.svg` adds a wordmark variant
  for places that want the brand name alongside the icon.
- README hero replaces the PNG `<img>` with the SVG so contributors
  reading on GitHub light see a tinted version that doesn't blow
  out the page background.

### Comprehensive doc updates

- **8 production runtimes** named explicitly throughout: Claude
  Code, Hermes, Gemini CLI, LangGraph, DeepAgents, CrewAI, AutoGen,
  OpenClaw. Comparison table grew Hermes 4 + Gemini CLI rows with
  the integration mechanism (Option B upstream hook, A2A bridge,
  multi-provider derivation).
- **Canvas v4** — warm-paper theme system (light / dark / follow-
  system) called out alongside the existing Next.js 15 / React Flow /
  Zustand stack.
- **Memory v2 backed by pgvector** — semantic recall callout in
  both the "memory model" pitch line and the runtime stack section.
- **RFC #2967 typed-SSOT A2A response path** named in the platform
  ship list + architecture diagram.
- **SaaS surface section** added — multi-tenant EC2 + Neon +
  Cloudflare Tunnels, WorkOS + Stripe, KMS envelope, tenant_resources
  audit + 30-min reconciler. Cross-links to molecule-controlplane.
- **molecule-mcp-claude-channel plugin** added — entry point for
  Claude Code users to bridge A2A traffic into a local session via
  MCP. Documents the standard marketplace 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** repo URL fixed (`molecule-monorepo` → `molecule-core`),
  Go version bumped to 1.25, Python ≥3.11 noted.

### Repo URL fixes

- Deploy buttons + Quick Start URL all bump from the old
  `molecule-monorepo` name to the current `molecule-core`. Pre-fix
  these clicked through to a 404.

## Why these three files only

The provisioner refactor (`registry.go` deletion + RegistryPrefix
env-driven changes) that lived alongside an earlier draft of this
README on the `docs/readme-refresh-2026-05-06` branch is OUT of
this PR — that work shipped separately via #6. This branch is
docs-only so the review surface is small and the merge is reversible.

## Verification

- `git diff staging --stat`:
  ```
  README.md                              | 75 +++++++++++++++++++++++-----------
  docs/assets/branding/molecule-icon.svg | 28 +++++++++++++
  docs/assets/branding/molecule-logo.svg | 17 ++++++++
  3 files changed, 97 insertions(+), 23 deletions(-)
  ```
- SVGs validated in a browser at light + dark `prefers-color-scheme`.
- All linked docs (./docs/index.md, ./docs/quickstart.md, ./docs/
  architecture/architecture.md, ./docs/api-protocol/platform-api.md,
  ./docs/agent-runtime/workspace-runtime.md, ./LICENSE, etc.) verified
  to exist on staging.

## Out of scope (parked)

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

🤖 Generated with [Claude Code](https://claude.com/claude-code)

claude-ceo-assistant added 1 commit 2026-05-07 00:00:23 +00:00

docs(README.zh-CN): mirror EN refresh — 8 runtimes + Canvas v4 + Memory v2 + SaaS + channel plugin ... 04e0e3d2c6

Brings the Chinese README to parity with the comprehensive English
refresh in the same PR:

- Icon: PNG → SVG (light/dark adaptive)
- Runtimes: 6 → 8 (added Hermes 4 + Gemini CLI to pitch line, "Runtime
  choice" section, comparison table)
- Canvas v4 — warm-paper 主题系统 callout
- Memory v2 — pgvector 语义召回 callout
- RFC #2967 typed-SSOT A2A 响应路径 — platform ship list + arch diagram
- SaaS section — 多租户 EC2 + Neon + Cloudflare Tunnels, WorkOS, Stripe,
  KMS, tenant_resources 审计 + 30 分钟 reconciler
- molecule-mcp-claude-channel section — 在 Claude Code 里直接接入,
  marketplace 安装流程, 多租户配置
- Architecture diagram redrawn (Canvas v4 → Platform 1.25 → Provisioner
  Docker|EC2+SSM, plus SaaS Control Plane block)
- "Current Scope" updated — Canvas v4, Memory v2, 8 adapters, RFC
  #2967, SaaS surface

Translation kept idiomatic — used Chinese tech terms where natural
(语义召回, 多租户, 信封加密) and kept English for established
proper nouns (Hermes, Gemini CLI, RFC #2967, pgvector, WorkOS, KMS).

🤖 Generated with [Claude Code](https://claude.com/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

First-time contributor

Copy Link

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

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

First-time contributor

Copy Link

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

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

claude-ceo-assistant merged commit fd1fbd2c5f into staging 2026-05-07 11:46:29 +00:00

claude-ceo-assistant referenced this issue from a commit 2026-05-07 11:46:31 +00:00

Merge pull request 'docs(README): comprehensive refresh — landing-page icon (light/dark SVG) + 8 runtimes + Canvas v4 + Memory v2 + SaaS + channel plugin' (#5) from docs/readme-comprehensive-refresh-2026-05-06 into staging

claude-ceo-assistant referenced this issue from a commit 2026-05-08 11:24:50 +00:00

test(local-e2e): verify dev-department extraction end-to-end via real resolveYAMLIncludes

claude-ceo-assistant referenced this pull request 2026-05-08 11:25:17 +00:00

test(local-e2e): verify dev-department extraction end-to-end via real resolveYAMLIncludes #103

claude-ceo-assistant referenced this issue from a commit 2026-05-08 11:46:36 +00:00

fix(provisioner)+test: EvalSymlinks templatePath; stage-2 e2e for files_dir consumption

claude-ceo-assistant referenced this pull request 2026-05-08 11:47:36 +00:00

fix(provisioner)+test: EvalSymlinks templatePath; stage-2 e2e for files_dir consumption #104

claude-ceo-assistant referenced this issue from a commit 2026-05-08 12:17:58 +00:00

feat(org-import): `!external` cross-repo subtree resolver (Phase 3a, internal#77 / task #222)

claude-ceo-assistant referenced this pull request 2026-05-08 12:18:37 +00:00

feat(org-import): !external cross-repo subtree resolver (Phase 3a, task #222) #105

claude-ceo-assistant referenced this pull request 2026-05-08 14:52:58 +00:00

feat(plugins): hot-reload path for SKILL-content-only updates (bypass restart) #112

claude-ceo-assistant referenced this pull request 2026-05-08 14:52:59 +00:00

feat(plugins): canary tier filter for /admin/plugin-updates/:id/apply #115

Sign in to join this conversation.

Reviewers

No reviewers

Ghost

Labels

Clear labels   

tier:high

High risk per dev-sop §SOP-6 — ceo only, 24h cooldown

  

tier:low

Low risk per dev-sop §SOP-6 — engineers/managers/ceo can approve

  

tier:medium

Medium risk per dev-sop §SOP-6 — managers/ceo can approve

No Label

tier:high

tier:low

tier:medium

Milestone

Clear milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

No Assignees

hongming

2 Participants

Notifications

Subscribe

Due Date

The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: molecule-ai/molecule-core#5

No description provided.