6869: Add automation recommendations (agents, skills, hooks, MCP)

Add PR readiness and migration generator agents, update-api-spec skill,
PreToolUse lock file guard, Prettier PostToolUse hook, and team-shared
.mcp.json with context7.

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

Author: turegjorup

.claude/agents/create-migration.md

@@ -0,0 +1,15 @@
+---
+name: create-migration
+description: Generate and validate a Doctrine migration after entity changes
+model: sonnet
+---
+
+After entity changes, generate and validate a Doctrine migration:
+
+1. Run `docker compose exec -T phpfpm bin/console doctrine:migrations:diff` to generate a migration
+2. Read the generated migration file and verify the SQL looks correct
+3. Run `docker compose exec -T phpfpm bin/console doctrine:migrations:migrate --no-interaction`
+4. Run `docker compose exec -T phpfpm bin/console doctrine:schema:validate`
+
+Report the migration file path, the SQL it contains, and whether schema validation passed.
+If schema validation fails, investigate and report the discrepancies.

.claude/agents/pr-readiness.md

@@ -0,0 +1,24 @@
+---
+name: pr-readiness
+description: Run all CI-equivalent checks locally before creating a PR
+model: haiku
+---
+
+Run the following checks in sequence inside Docker and report results for each.
+Stop early if a critical check fails.
+
+## Checks
+
+1. **Composer validate**: `docker compose exec -T phpfpm composer validate --strict`
+2. **Composer normalize**: `docker compose exec -T phpfpm composer normalize --dry-run`
+3. **PHP coding standards**: `docker compose exec -T phpfpm composer coding-standards-check`
+4. **PHPStan**: `docker compose exec -T phpfpm vendor/bin/phpstan analyse --no-progress`
+5. **PHPUnit tests**: `docker compose exec -T phpfpm composer tests`
+6. **Twig coding standards**: `docker compose exec -T phpfpm vendor/bin/twig-cs-fixer lint templates/`
+7. **JS coding standards**: `docker compose run --rm -T node yarn coding-standards-check`
+8. **API spec up to date**: Run `docker compose exec -T phpfpm composer update-api-spec`, then check `git diff --exit-code public/api-spec-v1.*`
+9. **CHANGELOG updated**: Verify CHANGELOG.md has changes compared to the base branch (`git diff develop -- CHANGELOG.md`)
+
+## Output
+
+Report a summary table with columns: Check Name, Status (pass/fail), and error output for failures.

.claude/settings.json

@@ -91,6 +91,17 @@
         ]
       }
     ],
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "case \"$CLAUDE_FILE_PATH\" in */composer.lock|*/yarn.lock|*/.env.local|*/.env.local.*) echo 'BLOCKED: Do not edit lock files or .env.local directly' >&2; exit 1 ;; esac"
+          }
+        ]
+      }
+    ],
     "PostToolUse": [
       {
         "matcher": "Write|Edit",
@@ -114,6 +125,11 @@
             "type": "command",
             "command": "case \"$CLAUDE_FILE_PATH\" in */composer.json) docker compose exec -T phpfpm composer normalize --quiet 2>/dev/null || true ;; esac",
             "timeout": 30
+          },
+          {
+            "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",
+            "timeout": 15
           }
         ]
       }

.claude/skills/update-api-spec/SKILL.md

@@ -0,0 +1,12 @@
+---
+name: update-api-spec
+description: Regenerate and stage API spec files after API resource changes
+user-invocable: true
+---
+
+When API resources or operations change, regenerate the OpenAPI spec files:
+
+1. Run `docker compose exec -T phpfpm composer update-api-spec`
+2. Check `git diff public/api-spec-v1.*` for changes
+3. If changed, stage the spec files with `git add public/api-spec-v1.yaml public/api-spec-v1.json`
+4. Report what changed in the API spec

.gitignore

@@ -30,5 +30,4 @@ yarn-error.log
 phpstan.neon
 ###< phpstan/phpstan ###
 .phpunit.cache
-.claude
 .twig-cs-fixer.cache

.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstreamapi/context7-mcp@latest"]
+    }
+  }
+}