docs: update CHANGELOG for v0.4.0

README.md

@@ -16,14 +16,44 @@ The key insight: archetypes are not just system prompts. Each one has a **virtue
 
 ### 1. Install
 
-```bash
-# From Git
-claude plugin install --url https://git.xorwell.de/c/claude-archeflow-plugin
+**From the marketplace** (recommended):
 
-# Local development
+```bash
+# Add the marketplace (one time)
+/plugin marketplace add https://git.xorwell.de/c/claude-archeflow-plugin
+
+# Install the plugin
+/plugin install archeflow@claude-archeflow-plugin
+```
+
+**From Git URL directly:**
+
+```bash
+/plugin marketplace add https://git.xorwell.de/c/claude-archeflow-plugin.git
+/plugin install archeflow --scope user
+```
+
+**Local development:**
+
+```bash
 claude --plugin-dir ./archeflow
 ```
 
+After installing, run `/reload-plugins` or restart Claude Code. ArcheFlow activates automatically on session start.
+
+#### Verify installation
+
+```
+/plugin         # Opens plugin manager — check "Installed" tab
+/af-status      # Should show "no active run"
+```
+
+#### Scopes
+
+- `--scope user` — available in all your projects (recommended)
+- `--scope project` — only in the current project
+- `--scope local` — only in the current directory
+
 ### 2. Run your first orchestration
 
 Just describe a task. ArcheFlow activates automatically for multi-file changes: