docs(profile): add org-profile README + branding assets, document layout convention

GitHub renders `<org>/.github/profile/README.md` as the org's public
landing page. Mirroring the same path here on Gitea so once GitHub
access is restored and repo-sync pushes this content over, it lands
in the right place automatically — no path translation step.

## Adds

- `profile/README.md` — comprehensive org-level intro (different from
  molecule-core's product-deep README): pitch in 1 paragraph, "what we
  ship" in 4 bullets, "where to start" routing table, repos-in-this-org
  index split by purpose (product / adapters / marketing), license +
  community footer.
- `profile/assets/molecule-icon.svg` — same SVG that landed on
  molecule-core's README in PR #5; light/dark adaptive via
  prefers-color-scheme styles.
- `profile/assets/molecule-logo.svg` — wordmark variant.

## Updates

- `README.md` (repo root, not user-visible on the org page) — documents
  the layout convention + lists the other cross-org defaults GitHub
  picks up from `<org>/.github/` (CONTRIBUTING.md, SECURITY.md,
  SUPPORT.md, issue/PR templates, workflow templates) so a future
  contributor knows where to add things.

## Why this content shape

GitHub org-profile READMEs are user-visible on the org's public page.
Standard wisdom for that surface:

- short — 1-2 screens, not the deep product pitch (which lives at
  molecule-core)
- routes the reader to the right repo for what they actually want
  (product / SaaS / Claude integration / docs / new runtime)
- lists the major repos with one-line descriptions so a visitor can
  navigate without 30 tabs
- names the license model (BSL 1.1 → Apache 2.0 on 2029-01-01)

The "Where to start" table is the load-bearing piece — the rest is
context. If a visitor only reads the table, they still know where to
go.

## Out of scope (parked)

- CONTRIBUTING.md, SECURITY.md, SUPPORT.md — would normally live here
  too. Skipping for now; current per-repo guidance is fine. File when
  the org has enough cross-cutting policy to warrant it.
- GitHub Actions workflow templates — not relevant while we're on
  Gitea + operator-host deploys.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
This commit is contained in:
parent 7ca052db24
commit f0c13be92a
4 changed files with 141 additions and 2 deletions

View File

@ -1,3 +1,27 @@
# .github
# `Molecule-AI/.github`
Org profile (README rendered on org page) + shared workflow templates
Org-level community files + the org-profile README rendered on the org page.
## Layout
```
.github/
├── README.md # this file (repo entry point, not user-visible on the org page)
└── profile/
├── README.md # rendered on github.com/Molecule-AI when GitHub access is restored
└── assets/
├── molecule-icon.svg
└── molecule-logo.svg
```
## Convention
GitHub renders `<org>/.github/profile/README.md` as the org's public landing page. We mirror the same path on Gitea so once GitHub access is restored and repo-sync starts pushing, the file lands in the right place automatically.
## Adding more cross-org defaults
GitHub also picks up `<org>/.github/CONTRIBUTING.md`, `SECURITY.md`, `SUPPORT.md`, issue / PR templates under `.github/`, and workflow templates under `.github/workflow-templates/`. Add as needed — keep them generic; per-repo overrides win.
## Editing
PR against `main`; org-profile content is user-visible, so pair-review even trivial edits.

70
profile/README.md Normal file
View File

@ -0,0 +1,70 @@
<div align="center">
<p>
<img src="./assets/molecule-icon.svg" alt="Molecule AI" width="160" />
</p>
<h1>Molecule AI</h1>
<h3>The Org-Native Control Plane for Heterogeneous AI Agent Teams</h3>
<p>
Molecule AI is the operating system for AI agent organizations. One control plane, eight runtimes, organization-aware memory, real ops surfaces — built for teams that want to move past the demo.
</p>
<p>
<a href="https://moleculesai.app"><strong>moleculesai.app</strong></a> ·
<a href="https://github.com/Molecule-AI/molecule-core"><strong>molecule-core</strong></a> ·
<a href="https://github.com/Molecule-AI/molecule-mcp-claude-channel"><strong>Claude Code plugin</strong></a> ·
<a href="https://github.com/Molecule-AI/molecule-core/blob/main/docs/index.md"><strong>Docs</strong></a>
</p>
</div>
---
## What we ship
- **Org-native workspace abstraction** — every node is a role with persistent identity, memory boundary, hierarchy position, and A2A interface. Workspaces grow into teams without breaking external integrations.
- **Eight production agent runtimes** behind one workspace contract — Claude Code, Hermes 4, Gemini CLI, LangGraph, DeepAgents, CrewAI, AutoGen, OpenClaw. Mix them across teams without giving up shared governance.
- **Memory v2** with pgvector semantic recall, scoped to organizational boundaries (`LOCAL` / `TEAM` / `GLOBAL`). Memories promote into hot-loadable skills as workflows mature.
- **A real operational plane** — Canvas v4 (warm-paper themed), live activity streams, restart/pause/resume, terminal + files into running workspaces, Langfuse traces, the whole picture.
## Where to start
| If you want to … | Go to |
|---|---|
| Read the pitch + run it locally | [`molecule-core`](https://github.com/Molecule-AI/molecule-core) — Apache 2.0-converting BSL 1.1, Quick Start in 5 commands |
| Try the hosted SaaS | [moleculesai.app](https://moleculesai.app) — multi-tenant, EC2 + Cloudflare Tunnels, WorkOS auth, Stripe billing |
| Bridge a Claude Code session into a Molecule workspace | [`molecule-mcp-claude-channel`](https://github.com/Molecule-AI/molecule-mcp-claude-channel) — `/plugin marketplace add Molecule-AI/molecule-mcp-claude-channel` |
| Browse the architecture | [docs/architecture/architecture.md](https://github.com/Molecule-AI/molecule-core/blob/main/docs/architecture/architecture.md) |
| See the memory model | [docs/architecture/memory.md](https://github.com/Molecule-AI/molecule-core/blob/main/docs/architecture/memory.md) |
| Add a new runtime / template | [`molecule-ai-workspace-runtime`](https://github.com/Molecule-AI/molecule-ai-workspace-runtime) (mirror of `workspace/`) + the `molecule-ai-workspace-template-*` repos |
## Repos in this org
### Product
- **[`molecule-core`](https://github.com/Molecule-AI/molecule-core)** — the platform. Go control plane + Next.js Canvas + Python workspace runtime. Open source under BSL 1.1 (converts to Apache 2.0 on 2029-01-01).
- **`molecule-controlplane`** — SaaS multi-tenant orchestration on top of `molecule-core`. Private; backs [moleculesai.app](https://moleculesai.app).
### Adapters & integrations
- **[`molecule-mcp-claude-channel`](https://github.com/Molecule-AI/molecule-mcp-claude-channel)** — Claude Code MCP plugin: bridges Molecule A2A traffic into a local Claude Code session.
- **[`molecule-ai-workspace-runtime`](https://github.com/Molecule-AI/molecule-ai-workspace-runtime)** — Python adapter runtime, mirrored from `molecule-core/workspace/`. Published as a PyPI wheel.
- **`molecule-ai-workspace-template-*`** — one repo per supported runtime template (claude-code, hermes, langgraph, …).
### Marketing & community
- **[`landingpage`](https://github.com/Molecule-AI/landingpage)** — [moleculesai.app](https://moleculesai.app) source.
- **[`molecule-ai-status`](https://github.com/Molecule-AI/molecule-ai-status)** — public status page.
## License & community
Most user-facing code is open source under the Business Source License 1.1 (converts to Apache 2.0 on 2029-01-01). Personal, internal, and non-commercial use is permitted without restriction; commercial use that competes with the hosted product is what the BSL gates.
Issues, PRs, and design discussions land on the individual repos above. The platform repo's [Docs Home](https://github.com/Molecule-AI/molecule-core/blob/main/docs/index.md) is the canonical entry point for engineering depth.
---
<sub>Org profile last refreshed 2026-05-06.</sub>

View File

@ -0,0 +1,28 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
<style>
.bg { fill: #0a1120; }
.accent { fill: #7fe8d6; }
.accent-stroke { stroke: #7fe8d6; }
@media (prefers-color-scheme: light) {
.bg { fill: #f5f7fa; }
.accent { fill: #1a8a72; }
.accent-stroke { stroke: #1a8a72; }
}
</style>
<rect class="bg" width="64" height="64" rx="14"/>
<g class="accent-stroke" stroke-width="2.4" stroke-linecap="round" fill="none">
<line x1="32" y1="32" x2="12" y2="14"/>
<line x1="32" y1="32" x2="52" y2="18"/>
<line x1="32" y1="32" x2="10" y2="40"/>
<line x1="32" y1="32" x2="54" y2="44"/>
<line x1="32" y1="32" x2="32" y2="56"/>
</g>
<g class="accent">
<circle cx="32" cy="32" r="6.5"/>
<circle cx="12" cy="14" r="3.5"/>
<circle cx="52" cy="18" r="3.5"/>
<circle cx="10" cy="40" r="3.5"/>
<circle cx="54" cy="44" r="3.5"/>
<circle cx="32" cy="56" r="3.5"/>
</g>
</svg>

After

Width:  |  Height:  |  Size: 957 B

View File

@ -0,0 +1,17 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="Molecule AI">
<g stroke="#7fe8d6" stroke-width="2.6" stroke-linecap="round" fill="none">
<line x1="32" y1="32" x2="12" y2="14"/>
<line x1="32" y1="32" x2="52" y2="18"/>
<line x1="32" y1="32" x2="10" y2="40"/>
<line x1="32" y1="32" x2="54" y2="44"/>
<line x1="32" y1="32" x2="32" y2="56"/>
</g>
<g fill="#7fe8d6">
<circle cx="32" cy="32" r="7"/>
<circle cx="12" cy="14" r="3.6"/>
<circle cx="52" cy="18" r="3.6"/>
<circle cx="10" cy="40" r="3.6"/>
<circle cx="54" cy="44" r="3.6"/>
<circle cx="32" cy="56" r="3.6"/>
</g>
</svg>

After

Width:  |  Height:  |  Size: 662 B