6869: Fix hook file paths for Docker and update README

Convert absolute host paths to relative paths in all PostToolUse hooks
using ${CLAUDE_FILE_PATH#$CLAUDE_PROJECT_DIR/} so tools inside Docker
containers can resolve the files. Document agents, skills, hooks, and
MCP servers in README.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: turegjorup

.claude/settings.json

@@ -108,17 +108,17 @@
         "hooks": [
           {
             "type": "command",
-            "command": "case \"$CLAUDE_FILE_PATH\" in *.php) docker compose exec -T phpfpm vendor/bin/php-cs-fixer fix --quiet \"$CLAUDE_FILE_PATH\" 2>/dev/null || true ;; esac",
+            "command": "case \"$CLAUDE_FILE_PATH\" in *.php) REL_PATH=\"${CLAUDE_FILE_PATH#$CLAUDE_PROJECT_DIR/}\"; docker compose exec -T phpfpm vendor/bin/php-cs-fixer fix --quiet \"$REL_PATH\" 2>/dev/null || true ;; esac",
             "timeout": 30
           },
           {
             "type": "command",
-            "command": "case \"$CLAUDE_FILE_PATH\" in *.php) docker compose exec -T phpfpm vendor/bin/phpstan analyse --no-progress --error-format=raw \"$CLAUDE_FILE_PATH\" 2>/dev/null || true ;; esac",
+            "command": "case \"$CLAUDE_FILE_PATH\" in *.php) REL_PATH=\"${CLAUDE_FILE_PATH#$CLAUDE_PROJECT_DIR/}\"; docker compose exec -T phpfpm vendor/bin/phpstan analyse --no-progress --error-format=raw \"$REL_PATH\" 2>/dev/null || true ;; esac",
             "timeout": 30
           },
           {
             "type": "command",
-            "command": "case \"$CLAUDE_FILE_PATH\" in *.twig) docker compose exec -T phpfpm vendor/bin/twig-cs-fixer lint --fix \"$CLAUDE_FILE_PATH\" 2>/dev/null || true ;; esac",
+            "command": "case \"$CLAUDE_FILE_PATH\" in *.twig) REL_PATH=\"${CLAUDE_FILE_PATH#$CLAUDE_PROJECT_DIR/}\"; docker compose exec -T phpfpm vendor/bin/twig-cs-fixer lint --fix \"$REL_PATH\" 2>/dev/null || true ;; esac",
             "timeout": 15
           },
           {
@@ -128,7 +128,7 @@
           },
           {
             "type": "command",
-            "command": "case \"$CLAUDE_FILE_PATH\" in *.js|*.css|*.scss|*.yaml|*.yml|*.md) docker compose run --rm -T node npx prettier --write \"$CLAUDE_FILE_PATH\" 2>/dev/null || true ;; esac",
+            "command": "case \"$CLAUDE_FILE_PATH\" in *.js|*.css|*.scss|*.yaml|*.yml|*.md) REL_PATH=\"${CLAUDE_FILE_PATH#$CLAUDE_PROJECT_DIR/}\"; docker compose run --rm -T node npx prettier --write \"$REL_PATH\" 2>/dev/null || true ;; esac",
             "timeout": 15
           }
         ]

README.md

@@ -16,17 +16,17 @@ information about sites and installations running on the server. These are sent
 
 This allows us to monitor
 
-* What is installed and running
-* Which sites/domains we are hosting
-* What docker images we are running
-* What packages and modules we are running
-* If there are known CVE's for the packages/modules
-* What git repositories we are hosting
+-   What is installed and running
+-   Which sites/domains we are hosting
+-   What docker images we are running
+-   What packages and modules we are running
+-   If there are known CVE's for the packages/modules
+-   What git repositories we are hosting
 
 Additionally we can register and document
 
-* All OpenID Connect setups
-* All Services Certificates
+-   All OpenID Connect setups
+-   All Services Certificates
 
 Servers, OpenID Connect setups, Services Certificates must be created and maintained manually.
 All other information is kept up to date by analysing the DetectionResults.
@@ -74,9 +74,9 @@ AZURE_AZ_OIDC_REDIRECT_URI=https://itksites.local.itkdev.dk/openid-connect/gener
 
 There are not implemented on
 
-* sites
-* installations
-* domains
+-   sites
+-   installations
+-   domains
 
 This is due to automated processes and scripts that listen from sites and data
 is therefore not relevant to have. The architecture makes it possible to delete
@@ -150,7 +150,7 @@ and is not portable across tools.
 The following plugins are enabled in `.claude/settings.json`:
 
 | Plugin              | Purpose                                                                     | Source                                                                       |
-|---------------------|-----------------------------------------------------------------------------|------------------------------------------------------------------------------|
+| ------------------- | --------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
 | `php-lsp`           | PHP language server for type-aware code intelligence                        | [claude-plugins-official](https://github.com/anthropics/claude-code-plugins) |
 | `context7`          | Up-to-date documentation lookup for Symfony, Doctrine, API Platform, etc.   | [claude-plugins-official](https://github.com/anthropics/claude-code-plugins) |
 | `code-review`       | Pull request code review                                                    | [claude-plugins-official](https://github.com/anthropics/claude-code-plugins) |
@@ -162,3 +162,43 @@ The following plugins are enabled in `.claude/settings.json`:
 > **Note:** The `php-lsp` plugin requires [Intelephense](https://intelephense.com/)
 > installed globally: `npm install -g intelephense`. All other plugins work
 > without additional dependencies.
+
+#### Claude Code agents
+
+Custom agents in `.claude/agents/` automate multi-step workflows:
+
+| Agent              | Purpose                                                           |
+| ------------------ | ----------------------------------------------------------------- |
+| `pr-readiness`     | Runs all CI-equivalent checks locally before creating a PR        |
+| `create-migration` | Generates and validates a Doctrine migration after entity changes |
+
+#### Claude Code skills
+
+Custom skills in `.claude/skills/` provide repeatable task shortcuts:
+
+| Skill             | Invocation         | Purpose                                               |
+| ----------------- | ------------------ | ----------------------------------------------------- |
+| `update-api-spec` | `/update-api-spec` | Regenerate and stage OpenAPI spec files after changes |
+
+#### Claude Code hooks
+
+Hooks in `.claude/settings.json` run automatically on tool events:
+
+| Hook           | Trigger        | Purpose                                                |
+| -------------- | -------------- | ------------------------------------------------------ |
+| Docker start   | `SessionStart` | Starts Docker services on session start                |
+| PHP-CS-Fixer   | `PostToolUse`  | Auto-formats PHP files on edit                         |
+| PHPStan        | `PostToolUse`  | Runs static analysis on edited PHP files               |
+| Twig-CS-Fixer  | `PostToolUse`  | Auto-formats Twig templates on edit                    |
+| Composer norm  | `PostToolUse`  | Normalizes `composer.json` on edit                     |
+| Prettier       | `PostToolUse`  | Auto-formats JS, CSS, YAML, and Markdown files on edit |
+| Lock guard     | `PreToolUse`   | Blocks edits to lock files and `.env.local`            |
+| Container lint | `Stop`         | Validates Symfony DI container before stopping         |
+
+#### MCP servers
+
+A shared `.mcp.json` provides team-wide MCP server configuration:
+
+| Server     | Purpose                                                                   |
+| ---------- | ------------------------------------------------------------------------- |
+| `context7` | Live documentation lookup for Symfony, Doctrine, API Platform, and others |