feat(plugin): add SessionStart hook for Metis project detection

Add hook that detects .metis directory and provides project context:
- Checks for metis-mcp command availability
- Outputs JSON with hookSpecificOutput for Claude
- Lists available skills and MCP server info
- Add MCP server configuration to plugin

Author: Dylan Storey

plugins/metis/.mcp.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "metis": {
+      "command": "metis-mcp",
+      "args": [],
+      "env": {}
+    }
+  }
+}

plugins/metis/README.md

@@ -9,7 +9,8 @@ Flight Levels methodology plugin for Metis work management. Includes methodology
 | **Skills** | Flight Levels methodology guidance (decomposition, phases, patterns) |
 | **Agent** | `flight-levels` - Methodology expert for document selection and best practices |
 | **Commands** | `/metis-ralph`, `/metis-decompose`, `/cancel-metis-ralph` - Iterative work loops |
-| **Hooks** | Stop hook for Ralph loop control |
+| **Hooks** | SessionStart (project detection), Stop (Ralph loop control) |
+| **MCP** | Metis MCP server configuration |
 
 ## Skills: Flight Levels Methodology
 

plugins/metis/hooks/hooks.json

@@ -1,6 +1,17 @@
 {
-  "description": "Metis Ralph stop hook for task execution and initiative decomposition loops",
+  "description": "Metis hooks for project detection and Ralph loops",
   "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/session-start-hook.sh"
+          }
+        ]
+      }
+    ],
     "Stop": [
       {
         "matcher": "*",

plugins/metis/hooks/session-start-hook.sh

@@ -0,0 +1,53 @@
+#!/bin/bash
+# SessionStart hook for Metis projects
+# Detects .metis directory and provides project context
+
+# Exit silently if not in a Metis project
+if [ ! -d "$CLAUDE_PROJECT_DIR/.metis" ]; then
+    exit 0
+fi
+
+# Check if metis-mcp is installed
+if ! command -v metis-mcp &> /dev/null; then
+    cat << 'ENDJSON'
+{
+    "hookSpecificOutput": {
+        "hookEventName": "SessionStart",
+        "additionalContext": "WARNING: This is a Metis project (`.metis` directory found) but the `metis-mcp` command is not installed or not in PATH. Install it from: https://github.com/colliery-io/metis"
+    }
+}
+ENDJSON
+    exit 0
+fi
+
+# Build context message for active Metis project
+read -r -d '' CONTEXT << 'EOF'
+This is a **Metis project** (detected `.metis` directory).
+
+## Quick Reference
+- Use `mcp__metis__list_documents` to see current project state
+- Check active work items and their phases
+- Use Metis skills for methodology guidance
+
+## Available Skills
+When working with this project:
+- **document-selection** - Guidance on choosing the right document type (vision, strategy, initiative, task, ADR)
+- **phase-transitions** - How to transition documents through phases correctly
+- **decomposition** - Patterns for breaking down work into tasks
+- **project-patterns** - Common project patterns (greenfield, tech debt, incident response, feature development)
+
+## MCP Server
+The `metis` MCP server should be connected. If Metis tools are not available, the MCP server may need to be started.
+EOF
+
+# Output JSON for Claude
+cat << ENDJSON
+{
+    "hookSpecificOutput": {
+        "hookEventName": "SessionStart",
+        "additionalContext": "$(echo "$CONTEXT" | sed 's/"/\\"/g' | tr '\n' ' ')"
+    }
+}
+ENDJSON
+
+exit 0