diff --git a/Gradata/.dockerignore b/Gradata/.dockerignore
index 7ca294e0..4efa4d82 100644
--- a/Gradata/.dockerignore
+++ b/Gradata/.dockerignore
@@ -2,7 +2,6 @@
 .git
 .github
 .claude
-.claude-plugin
 .tmp
 .venv
 venv
diff --git a/Gradata/CHANGELOG.md b/Gradata/CHANGELOG.md
index 8450eb18..8ca151ef 100644
--- a/Gradata/CHANGELOG.md
+++ b/Gradata/CHANGELOG.md
@@ -2,6 +2,13 @@
 
 ## Unreleased
 
+### Breaking
+
+- **Plugin marketplace install path retired.** The `.claude-plugin/` directory
+  and `/plugin install gradata` flow are gone; use
+  `gradata install --agent claude-code` instead. See PR #211 for the README
+  guide. (GRA-1249, epic GRA-1198)
+
 ### Changed
 
 - Renamed the deterministic anchor-preserving prompt injection module to
diff --git a/Gradata/examples/README.md b/Gradata/examples/README.md
index 63317e6d..211f8a29 100644
--- a/Gradata/examples/README.md
+++ b/Gradata/examples/README.md
@@ -33,4 +33,5 @@ pip install gradata
 python examples/with_claude_code.py
 ```
 
-For the zero-code install, see [.claude-plugin/README.md](../.claude-plugin/README.md).
+For the zero-code install, run `gradata install --agent claude-code` — see the
+top-level [README](../README.md#install-for-claude-code) for details.
diff --git a/Gradata/examples/with_claude_code.py b/Gradata/examples/with_claude_code.py
index 7fded4a2..55068fe7 100644
--- a/Gradata/examples/with_claude_code.py
+++ b/Gradata/examples/with_claude_code.py
@@ -1,9 +1,8 @@
 """Using Gradata alongside Claude Code.
 
-With the Claude Code plugin installed (`/plugin install gradata`),
-corrections on `Edit` / `Write` tool calls are captured automatically and
-graduated rules are injected into every session. No code is needed in the
-hot path.
+With `gradata install --agent claude-code` run once, corrections on `Edit` /
+`Write` tool calls are captured automatically and graduated rules are
+injected into every session. No code is needed in the hot path.
 
 This example is the manual equivalent: the same `Brain` API the hooks use,
 run directly so you can inspect what gets stored and what would be injected.
@@ -11,7 +10,8 @@
 Run:
     python examples/with_claude_code.py
 
-See also: .claude-plugin/README.md for the zero-code install flow.
+See also: the README's "Install for Claude Code" section for the zero-code
+install flow.
 """
 
 from pathlib import Path