docs: add Beta labels for non-stable installations

- README: mark Claude Code plugin, Claude Desktop .mcpb, and Other methods as Beta
- docs/install/claude-code-plugin.md: add beta warning box recommending Homebrew/npm for stable use
- docs/install/claude-desktop.md: add beta warning box recommending Homebrew/npm for stable use
- docs/install/index.md:
  - Mark non-stable methods (plugin, .mcpb, other agents, web skill) as Beta in decision text
  - Add Status column to install methods table showing Stable vs Beta
  - Reorder table to put Stable methods first

Stable methods: Homebrew, npm/npx
Beta methods: Claude Code plugin, Claude Desktop .mcpb, other agents, claude.ai web skill

Author: UltimaPhoenix

README.md

@@ -91,7 +91,7 @@ devcoach install
 
 `brew tap` registers the third-party repository; `brew trust --tap` marks it trusted so Homebrew will load its formulae when `HOMEBREW_REQUIRE_TAP_TRUST` is set. Both are one-time. To update later: `brew upgrade devcoach`. One-liner: `brew install UltimaPhoenix/tap/devcoach` (run `brew trust --tap UltimaPhoenix/tap` first if your Homebrew enforces tap trust). The formula declares `depends_on "node"`, so Homebrew pulls in a recent Node automatically.
 
-### Claude Code plugin (recommended for Claude Code)
+### Claude Code plugin (recommended for Claude Code) — **Beta**
 
 The simplest way to add devcoach to **Claude Code** — one click, nothing to configure. It bundles **everything** (MCP server + automatic-coaching Stop hooks + skill), so **don't also run `devcoach install`** (or the Stop hooks get registered twice).
 
@@ -120,7 +120,7 @@ The MCP server, hooks, and skill activate on install — no restart needed. The
 
 See [Claude Code plugin](docs/install/claude-code-plugin.md) for how it works.
 
-### Claude Desktop extension (`.mcpb`) (recommended for Claude Desktop)
+### Claude Desktop extension (`.mcpb`) (recommended for Claude Desktop) — **Beta**
 
 A single bundle that runs on Claude Desktop's built-in runtime — no Node or terminal needed:
 
@@ -131,7 +131,7 @@ npm run mcpb        # → dist-mcpb/devcoach-<version>.mcpb
 
 `npm run mcpb:sign` self-signs it (installs as an *unverified publisher*; a real code-signing cert is needed for a verified signature). Prebuilt `.mcpb` releases and a Desktop directory listing are planned.
 
-### Other install methods
+### Other install methods — **Beta**
 
 <details>
 <summary><strong>npx / npm CLI</strong> (any MCP agent — no install)</summary>

docs/install/claude-code-plugin.md

@@ -1,5 +1,11 @@
 # Claude Code plugin
 
+:::warning Beta
+The Claude Code plugin and marketplace are currently in beta. They work well for most users, but report
+any issues to [GitHub Issues](https://github.com/UltimaPhoenix/dev-coach/issues). For the most stable
+experience, use [Homebrew](./homebrew.md) or [npm/npx](./npx.md).
+:::
+
 :::tip Recommended if you'd rather not use a terminal
 This is the simplest way to add devcoach to Claude Code — one click, nothing to configure. (Prefer the
 terminal and want the `devcoach` CLI too? Use [Homebrew](./homebrew.md) instead.)

docs/install/claude-desktop.md

@@ -5,6 +5,12 @@ sidebar_label: Claude Desktop (.mcpb)
 
 # Claude Desktop extension (`.mcpb`)
 
+:::warning Beta
+The `.mcpb` extension format is currently in beta. It works well for most users, but report any issues
+to [GitHub Issues](https://github.com/UltimaPhoenix/dev-coach/issues). For the most stable experience,
+use [Homebrew](./homebrew.md) or [npm/npx](./npx.md).
+:::
+
 :::tip Recommended for Claude Desktop
 The simplest, no-terminal way to add devcoach to Claude Desktop — one click, runs on Desktop's built-in
 runtime.

docs/install/index.md

@@ -18,21 +18,21 @@ devcoach works the same whichever way you install it — pick by how you like to
   `brew install` sets up devcoach **and** the `devcoach` CLI, so you also get the
   [command line](../usage/cli.md) and can launch the [dashboard](../usage/web-ui.md) with a bare
   `devcoach ui`. *(On Windows, or if you prefer npm, [npx / npm](./npx.md) is the equivalent.)*
-- **Prefer the simplest, no-terminal setup → the [Claude Code plugin](./claude-code-plugin.md)**
-  (one-click from the marketplace) or, on Claude Desktop, the **[`.mcpb` extension](./claude-desktop.md)**.
+- **Prefer the simplest, no-terminal setup → the [Claude Code plugin](./claude-code-plugin.md)** *(Beta)*
+  (one-click from the marketplace) or, on Claude Desktop, the **[`.mcpb` extension](./claude-desktop.md)** *(Beta)*.
   Nothing to configure — install and go. *(These don't add the `devcoach` CLI; run CLI commands with
-  `npx -y devcoach …` if you ever need them.)*
+  `npx -y devcoach …` if you ever need them. For the most stable experience, use Homebrew or npm.)*
 
 ## All methods
 
-| Method | Best for | Terminal? |
-|---|---|---|
-| **[Homebrew](./homebrew.md)** | **Developers on macOS / Linux who use the CLI** (recommended) | Yes |
-| **[Claude Code plugin](./claude-code-plugin.md)** | **Non-expert Claude Code users — one-click setup** (recommended) | No |
-| **[Claude Desktop (`.mcpb`)](./claude-desktop.md)** | **Non-expert Claude Desktop users — one-click setup** (recommended) | No |
-| **[npx / npm CLI](./npx.md)** | Any MCP agent · Windows · npm workflows | Yes |
-| **[Other MCP agents](./other-agents.md)** | Cursor, Windsurf, Cline, Continue, Zed | Yes |
-| **[claude.ai web](./claude-ai.md)** | claude.ai (skill-only, no MCP) | — |
+| Method | Best for | Terminal? | Status |
+|---|---|---|---|
+| **[Homebrew](./homebrew.md)** | **Developers on macOS / Linux who use the CLI** | Yes | Stable |
+| **[npx / npm CLI](./npx.md)** | Any MCP agent · Windows · npm workflows | Yes | Stable |
+| **[Claude Code plugin](./claude-code-plugin.md)** | **Non-expert Claude Code users — one-click setup** | No | Beta |
+| **[Claude Desktop (`.mcpb`)](./claude-desktop.md)** | **Non-expert Claude Desktop users — one-click setup** | No | Beta |
+| **[Other MCP agents](./other-agents.md)** | Cursor, Windsurf, Cline, Continue, Zed | Yes | Beta |
+| **[claude.ai web](./claude-ai.md)** | claude.ai (skill-only, no MCP) | — | Beta |
 
 Each page below is self-contained: it covers **install *and* connect**.