Skip to content

docs(readme): reposition as MCP-first / Agent-first framework - #149

Merged
allmonday merged 3 commits into
masterfrom
docs/agent-first-readme
Sep 11, 2026
Merged

docs(readme): reposition as MCP-first / Agent-first framework#149
allmonday merged 3 commits into
masterfrom
docs/agent-first-readme

Conversation

@allmonday

Copy link
Copy Markdown
Collaborator

Summary

Reposition the README around the framework's actual purpose: building
MCP-first, Agent-first applications, with the specialty of building
APIs that agents understand easily.

Changes

  1. Tagline & intro — now lead with "A framework for building MCP-first,
    Agent-first applications"; MCP heads the protocol list. The specialty
    sentence describes the three agent-facing behaviors in plain language:
    see what data exists, explore the API piece by piece, fetch only the
    fields needed.

  2. "For AI" block — moved before "For Human" and rewritten as three
    capabilities, each titled in plain language with the term in parentheses:

    • See what data exists (field awareness)
    • Explore the API piece by piece (progressive disclosure)
    • Fetch only what is needed (field selection)

    Closing line summarizes the benefit: enough context to understand the
    data, only pulls back what it needs.

  3. New section "Build an application with a single prompt" (right after
    Installation) — features the nexusx-4phase skill install command plus the
    real prompt that kicked off MindMap X (translated from Chinese), and what
    it produced: browser canvas + MCP server + CLI + REST from one model.
    Repo: https://github.com/allmonday/mindmap-x (facts verified against its
    README: self-hosted, one-command agent connect, co-editing in real time).

  4. "Learn in layers" tail — the duplicated skill paragraph replaced with
    a cross-reference to the new section.

Docs-only change; no version bump.

🤖 Generated with Claude Code

allmonday and others added 3 commits September 11, 2026 21:59
- lead the tagline and intro with MCP-first / Agent-first positioning;
  MCP now heads the protocol list
- rewrite "For AI" as three agent-friendly capabilities in plain language
  (see what data exists / explore piece by piece / fetch only what is
  needed), moved before "For Human"
- new section "Build an application with a single prompt" right after
  Installation: nexusx-4phase skill + the real MindMap X prompt
  (translated) as a showcase of one-prompt app building
- "Learn in layers" tail now cross-references the new section

Co-Authored-By: Claude Code <noreply@anthropic.com>
Co-Authored-By: Claude Code <noreply@anthropic.com>
…homepages

- hero badge/subtitle and intro now lead with MCP-first, Agent-first
  positioning; MCP heads the protocol list; specialty = agent-friendly APIs
- For-AI card rewritten as three capabilities in plain language
  (see what data exists / explore piece by piece / fetch only what is needed)
- 4-phase section retitled "Build an application with a single prompt" and
  extended with the real MindMap X case card (prompt requirements + outcome)
- fix GitHub links pointing at allmonday/nexusx instead of KLR-Pattern/nexusx

Co-Authored-By: Claude Code <noreply@anthropic.com>
@allmonday
allmonday merged commit 511fba1 into master Sep 11, 2026
1 check passed
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