genealogist

Implement advanced Symfony 8.1 components: async/queues with Messenger (#[AsMessageHandler], transports, retry, failed messages), Serializer (serialize/deserialize, groups, context), Workflow & state machines (places/transitions, guards, transition listeners), Mercure realtime updates, Lock (mutexes/critical sections), HTTP Client (HttpClientInterface), Cache pools (CacheInterface, tags), Rate Limiter (RateLimiterFactoryInterface), Scheduler (#[AsSchedule], RecurringMessage), and Webhook/RemoteEvent consumers. Use whenever a task mentions queues, background jobs, async processing, message bus, serialization to JSON, state machines, realtime/SSE, distributed locks, calling external APIs, caching, throttling/rate limiting, cron/recurring tasks, or incoming webhooks.

Use for ANY Symfony AI task: integrating LLMs/AI into a Symfony or PHP app via the Symfony AI components. Covers the Platform component (unified interface to OpenAI, Anthropic Claude, Google Gemini, Azure, Mistral, Ollama), building an AI Agent, tool calling with the #[AsTool] attribute, Retrieval Augmented Generation (RAG) with a vector Store and embeddings, the Chat component and conversation memory, configuring everything through the AI Bundle YAML (config/packages/ai.yaml), and exposing or consuming an MCP server (MCP Bundle / Mate). Trigger on symfony/ai, ai-bundle, AsTool, MessageBag, vectorizer, SimilaritySearch, McpTool, or any "add AI/chatbot/embeddings/RAG to Symfony".

Build and wire the core architecture of a Symfony 8.1 app. Use this whenever you work with the service container, dependency injection, autowiring, service tags, factories, service decoration, the event dispatcher (listeners/subscribers), bundles, the kernel, or app configuration (config/packages, environment variables, secrets, parameters). Reach for this skill before creating a service class, injecting a dependency, hooking into a kernel event, or editing config.

Use when building Symfony 8.1 web pages and features: creating routes, controllers, Twig templates, Doctrine entities and CRUD, forms, and validation. Reach for this skill whenever you create a page, wire a URL to a controller, render HTML with Twig, persist or query data with Doctrine entities/repositories, build a Symfony form, or add validation constraints.

Use for Symfony 8.1 deployment, production configuration, and operations. Covers deploying (APP_ENV=prod, composer install --no-dev --optimize-autoloader, cache:clear/warmup, dump-env), performance tuning (OPcache, realpath cache, preloading, container single-file, classmap-authoritative), HTTP caching (Cache-Control, Expires, ETag, Last-Modified, Vary, reverse proxy, invalidation/PURGE), profiler and debugging, logging with Monolog (handlers, channels, fingers_crossed), testing with PHPUnit (WebTestCase, KernelTestCase, assertions, database), and Symfony best practices. Trigger whenever a task mentions deploy, prod env, opcache, performance, HTTP cache, reverse proxy, profiler, Monolog/logs, PHPUnit tests, or production hardening of a Symfony app.

Use for ALL Symfony 8.1 security work: authentication and authorization, login (form_login, json_login, http_basic, login link), firewalls and security.yaml, user providers, roles and role_hierarchy, password hashing, access control (access_control, #[IsGranted], denyAccessUnlessGranted), voters, CSRF protection, logout, and custom authenticators. Trigger whenever a task mentions login, secure a route, protect an endpoint, roles, permissions, hashing passwords, who can access, firewall, or security.yaml.

Use for Symfony 8.1 utility components and helper tasks. Triggers: create or test a console command (bin/console, #[AsCommand], SymfonyStyle output, command arguments/options, verbosity); send email with Mailer (Email, TemplatedEmail, attachments, Twig emails); send notifications with Notifier (SMS via Texter, chat/Slack via Chatter, multi-channel Notification); translation and i18n (translator, trans(), TranslatableMessage, placeholders, pluralization); manipulate strings with the String component (u(), b(), slugger, case conversion, truncate); transliterate emoji; sanitize untrusted HTML (HtmlSanitizer); read/write sessions and flash messages; preload assets with WebLink. Reach for this skill whenever the task is "make a command", "send an email", "send an SMS or Slack message", "translate text", "slugify", "clean user HTML", or "store something in the session".

API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination.

Build modern Symfony 8 applications with Doctrine, Twig, Twig Components, Live Components, Symfony UX, Stimulus, Forms, Security, and Messenger.

Master proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design to build maintainable, testable, and scalable systems.

This skill embodies the principles of "Clean Code" by Robert C. Martin (Uncle Bob). Use it to transform "code that works" into "code that is clean."

ALWAYS use this skill when committing code changes — never commit directly without it. Creates commits following Sentry conventions with proper conventional commit format and issue references. Trigger on any commit, git commit, save changes, or commit message task.

Create a git branch following Sentry naming conventions. Use when asked to "create a branch", "new branch", "start a branch", "make a branch", "switch to a new branch", or when starting new work on the default branch.

Alias for sentry-skills:pr-writer. Use when users explicitly ask for "create-pr" or reference the legacy skill name. Redirects to the canonical PR writing workflow.

Use the `gh` CLI for issues, pull requests, Actions runs, and GitHub API queries.