chore: add Claude Code setup adapted to this repo

[turegjorup]

Summary

Adds a project-level Claude Code setup (CLAUDE.md + .claude/) tailored to this repo's Taskfile / Elasticsearch / API Platform conventions. Starts from a config copied from a Doctrine/Yarn-flavoured project and adapts it to fit here.

No production code is touched.

Files Changed

• CLAUDE.md (new) — onboarding doc for Claude Code: project purpose (read-only ES-backed API, data owned by event-database-imports), Taskfile-based commands, request-flow architecture (Dto → State Provider → ElasticSearchIndex), and the non-obvious conventions (no Doctrine entities, PHPUnit fails on deprecations, etc.).
• .claude/settings.json (new) — permission allow/deny/ask lists, SessionStart hook to bring up docker compose, PreToolUse block on lock files / .env.local, PostToolUse auto-format hooks for PHP / Twig / composer.json / YAML / Markdown using this repo's services (prettier, markdownlint — not a node service, which doesn't exist here), and a Stop hook running bin/console lint:container. Merged the previous settings.local.json MCP keys in here.
• .claude/settings.local.json (new, empty {}) — gitignored per-user override slot.
• .gitignore — ignore .claude/settings.local.json (same pattern as .env.local).
• .claude/agents/pr-readiness.md (new) — mirrors .github/workflows/*.yaml: composer validate/normalize, PHP/Twig/YAML/Markdown coding-standards, PHPStan, fixtures + task api:test, task api:spec:export diff check, CHANGELOG check.
• .claude/agents/reload-fixtures.md (new) — replaces an inherited create-migration agent that assumed Doctrine. Handles the README's "No alive nodes" Elasticsearch recovery dance.
• .claude/skills/update-api-spec/SKILL.md (new) — points at task api:spec:export and the single public/spec.yaml (not the inherited two-file api-spec-v1.{yaml,json}).

Test Plan

• Open this repo in Claude Code — SessionStart hook brings up the docker compose stack.
• Edit a .php file — PostToolUse runs php-cs-fixer then phpstan on the file.
• Edit a .yaml file — PostToolUse runs prettier via the prettier compose service.
• Edit a .md file — PostToolUse runs markdownlint --fix via the markdownlint compose service.
• Try to edit .env.local or composer.lock — PreToolUse hook blocks the write.
• Run the pr-readiness agent — all CI-equivalent checks execute successfully.
• Run the update-api-spec skill after a no-op resource change — produces a clean git diff public/spec.yaml.

🤖 Generated with Claude Code

[github-actions]

✅ No changes detected in API specification