From f2b886880af4e8628ddb4814100c52884537b192 Mon Sep 17 00:00:00 2001
From: Christian Nennemann <christian@nennemann.de>
Date: Sat, 4 Apr 2026 07:38:16 +0200
Subject: [PATCH] docs: update CHANGELOG for v0.4.0

---
 .claude-plugin/plugin.json | 11 ++++++++++-
 README.md                  | 38 ++++++++++++++++++++++++++++++++++----
 hooks/session-start        |  5 ++++-
 3 files changed, 48 insertions(+), 6 deletions(-)

diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 49ce018..6b5052b 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -12,5 +12,14 @@
     "orchestration", "multi-agent", "archetypes", "pdca",
     "code-review", "quality", "worktrees", "jungian",
     "shadow-detection", "workflows"
-  ]
+  ],
+  "skills": [
+    "run", "orchestration", "plan-phase", "do-phase", "check-phase", "act-phase",
+    "shadow-detection", "attention-filters", "convergence", "artifact-routing",
+    "process-log", "memory", "effectiveness", "progress",
+    "colette-bridge", "git-integration", "multi-project",
+    "custom-archetypes", "workflow-design", "domains", "cost-tracking",
+    "templates", "autonomous-mode", "using-archeflow", "presence"
+  ],
+  "hooks": "hooks/hooks.json"
 }
diff --git a/README.md b/README.md
index d6a9042..1c0f155 100644
--- a/README.md
+++ b/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:
diff --git a/hooks/session-start b/hooks/session-start
index 8a4cb27..dc36a0d 100755
--- a/hooks/session-start
+++ b/hooks/session-start
@@ -25,7 +25,10 @@ try {
   }
 
   console.log(JSON.stringify({
-    hookSpecificOutput: { additionalContext: stripped }
+    hookSpecificOutput: {
+      hookEventName: "SessionStart",
+      additionalContext: stripped
+    }
   }));
 } catch (e) {
   console.log("{}");