docs: update CHANGELOG for v0.4.0

.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"
 }

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:

hooks/session-start

@@ -25,7 +25,10 @@ try {
   }
 
   console.log(JSON.stringify({
-    hookSpecificOutput: { additionalContext: stripped }
+    hookSpecificOutput: {
+      hookEventName: "SessionStart",
+      additionalContext: stripped
+    }
   }));
 } catch (e) {
   console.log("{}");