docs: reconcile distribution surfaces — CLI + MCP shipped, plugin deferred#99
Merged
Merged
Conversation
…erred The Claude Code plugin was named as a packaging surface across SPEC, ROADMAP, README, and CLAUDE.md but never built, while the MCP server (PR #60) shipped and isn't a like-for-like replacement (wider reach, but today a single generate_app tool). Align all four docs on one story: - Shipped surfaces: CLI (primary) + `nativeapptemplate-agent-mcp` (multiplier). - Plugin → ROADMAP Post-v0.1 backlog, gated on streaming out of dispatch() + an orchestration skill (chain mobile-mcp walkthrough + validation), since against the single-tool MCP a plugin is a thin wrapper. - SPEC §8 historical prose left frozen per the doc's own convention; the addendum now corrects the record. - MONETIZATION.md already aligned (leans on MCP, silent on plugin) — unchanged. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This was referenced May 24, 2026
dadachi
added a commit
that referenced
this pull request
May 24, 2026
…n) (#101) #99 documented the MCP server as `npx -y nativeapptemplate-agent-mcp`, but there is no npm package by that name — it's a *bin* of the `nativeapptemplate-agent` package, so the bare form 404s. Use the package-scoped form: `npx -y -p nativeapptemplate-agent nativeapptemplate-agent-mcp`. Verified against published 0.2.1 from a clean dir with a real MCP initialize handshake (returns serverInfo nativeapptemplate-agent 0.2.1). Fixes the runnable references in README, CLAUDE.md, and ROADMAP; SPEC's bin-name mention and the ROADMAP prose identifier are left as-is (not commands). Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The Claude Code plugin was named as a packaging surface across
docs/SPEC.md,ROADMAP.md,README.md, andCLAUDE.mdbut was never built — while the MCP server (nativeapptemplate-agent-mcp, #60) actually shipped and isn't a like-for-like replacement (wider reach across every MCP client, but today exposes a singlegenerate_apptool). The docs disagreed on what ships. This aligns them on one story.npx nativeapptemplate-agent, primary) +npx -y nativeapptemplate-agent-mcp(the distribution multiplier).ROADMAP.md, gated on (1) streaming progress out ofdispatch()and (2) an orchestration skill that chains amobile-mcpwalkthrough + the validation layers — because against the single-tool MCP a plugin would be a thin wrapper (slash-command discoverability + one-step install, little else).docs/SPEC.md§8 historical prose left frozen per the doc's own "sections 1–11 unchanged" convention; the post-launch addendum now corrects the record (planned CLI+plugin → shipped CLI+MCP).docs-private/MONETIZATION.mdwas already aligned (leans on MCP, silent on the plugin) — unchanged.Files
ROADMAP.md### Claude Code pluginbacklog subsection (status: deferred, with gate).docs/SPEC.mdREADME.mdCLAUDE.mdVerification
nativeapptemplate-agent-mcpbin confirmed registered inpackage.jsonat published0.2.1, so thenpx -y nativeapptemplate-agent-mcpinvocation now in user-facing docs actually resolves.🤖 Generated with Claude Code