Skip to content

docs(readme): overhaul README to launch grade — Soma-class shape (#2286) - #2291

Merged
mellanon merged 1 commit into
mainfrom
docs/readme-launch-2286
Jul 21, 2026
Merged

docs(readme): overhaul README to launch grade — Soma-class shape (#2286)#2291
mellanon merged 1 commit into
mainfrom
docs/readme-launch-2286

Conversation

@mellanon

Copy link
Copy Markdown
Contributor

Closes #2286 (epic #2281, wave 1 C-lane).

Rebuilds the README in the Soma shape: hero block (art pending — placeholder contract) · thesis + badges (version 6.10.3 / AGPL-3.0 / runs-on) · second-Arc-package line + Discord invite · Why → The shape (with an explicit deliberately does not own list) · See it work (~10 min) for macOS / Debian / container, arc-install-first · Install (arc primary, source fallback) · honest Status (community preview (beta) · single principal · Discord surface · federation experimental/unreleased · wire protocol evolving).

Review notes:

  • Honesty deviation, correct call: arc install cortex (registry name) is not yet true — verified arc search cortex returns nothing pre-publish. Walkthroughs use the pinned git-URL form; swap to the registry name when D1 — [HELD] soft-launch publish to the metafactory registry (unannounced) #2288 lands (tracked there).
  • Thesis line flagged for principal wordsmithing — current: "Your assistant, on your surfaces — a collaboration bus for principals and their agents." Two alternates in C2 — README overhaul to launch grade (Soma-class shape) #2286 comments.
  • Pre-existing private compass link in Contributing kept (out of scope; flagged).
  • Verified: federation appears ONLY in the Status caveat; all relative links resolve; placeholders only.

🤖 Generated with Claude Code

https://claude.ai/code/session_01MfTfScc3UjzTB2s17R15SH

Hero block + thesis + badges + second-arc-package line + Discord invite,
problem->shape narrative, The shape (bus ASCII + deliberately-does-not-own
list + Myelin layer model), three arc-install-first host walkthroughs
(macOS / Debian / container) each ending in an observable green-light
check, arc-primary Install section, honest community-preview Status
section (federation experimental/unreleased, myelin RFCs evolving),
and the retained doc map / provenance / contributing / license bodies.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KCiSxQS5EFNU2KASXusnLA
@mellanon
mellanon requested a review from jcfischer as a code owner July 21, 2026 01:37
@mellanon mellanon added documentation Improvements or additions to documentation now Currently being worked labels Jul 21, 2026
@mellanon
mellanon merged commit 0f0f9d2 into main Jul 21, 2026
10 of 12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation now Currently being worked

Projects

None yet

Development

Successfully merging this pull request may close these issues.

C2 — README overhaul to launch grade (Soma-class shape)

1 participant