Skip to content

docs: README positioning block — clarify sym vs xmesh-agent#20

Merged
sym-bot merged 1 commit into
mainfrom
docs/positioning-vs-xmesh-agent
Apr 26, 2026
Merged

docs: README positioning block — clarify sym vs xmesh-agent#20
sym-bot merged 1 commit into
mainfrom
docs/positioning-vs-xmesh-agent

Conversation

@sym-bot
Copy link
Copy Markdown
Owner

@sym-bot sym-bot commented Apr 26, 2026

Summary

  • Adds a short blockquote directly under the install command naming SYM's role and pointing visitors to @sym-bot/xmesh-agent for the autonomous-peer use case
  • Pairs with a sister positioning block on the xmesh-agent README so a visitor landing on either repo gets the same disambiguation

Why

The current SYM README doesn't mention xmesh-agent at all. A first-time visitor evaluating both projects (both use the same MMP / CAT7 / SVAF / CMB vocabulary, both pitch "agents coordinate via mesh") can't tell whether they're alternatives, complementary, or the same thing in two clothes.

The fix: 4 lines that name what SYM is, what xmesh-agent is, and that they work in the same mesh — placed where the question lives (right under the install command).

Pair PR

xmesh-agent README — sister positioning block is going up at the same time.

Test plan

  • Block renders (markdown preview)
  • Cross-link to xmesh-agent repo is correct
  • Reviewer cold-read: would I know in <30s which to install?

🤖 Generated with Claude Code

The README never names xmesh-agent — a first-time visitor evaluating both
the SYM CLI and the xmesh-agent runtime can't tell whether they're
alternatives, complementary, or the same thing in two clothes (both use
the same MMP / CAT7 / SVAF / CMB vocabulary; both pitch 'agents coordinate
via mesh').

Adds a short blockquote directly under the install command that:
- Names SYM's role: substrate + CLI for joining existing AI copilots
- Names xmesh-agent's role: dedicated autonomous LLM peers without a host
  IDE
- Notes the two work in the same mesh

Pairs with a sister positioning block being added to the xmesh-agent
README.
@sym-bot sym-bot merged commit 80ceb4d into main Apr 26, 2026
2 checks passed
@sym-bot sym-bot deleted the docs/positioning-vs-xmesh-agent branch April 26, 2026 03:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant