shopsys

Create or extend an administration CRUD controller (list / detail / create / edit / delete pages for an entity) built on Shopsys\AdministrationBundle\Controller\AbstractCrudController. Use when the user asks for a new admin section, admin list, admin…

Create or extend an administration CRUD controller (list / detail / create / edit / delete pages for an entity) built on Shopsys\AdministrationBundle\Controller\AbstractCrudController. Use when the user asks for a new admin section, admin list, admin…

Finds similar implementations, usage examples, and established patterns in this Shopsys project that you can model new work after. Like codebase-locator, but it also returns concrete code snippets with file:line references, not just locations.

Generates a Czech sprint summary article from Jira sprint data (Jira MCP first, CSV fallback), publishes it to Confluence with embedded screenshots and MP4 clips, and records the clips with Playwright MCP (visible cursor, ffmpeg post-processing).

Write, fix, and review Cypress acceptance tests for Shopsys storefront. Use when working with Cypress test files (.cy.ts), adding test IDs (TIDs), or debugging test failures. Enforces project conventions: TID-based selectors, proper snapshot setup, and…

Audits current storefront worktree or branch changes for code and artifacts that are unnecessary, dead, speculative, equivalent, redundant, or unrelated. Use before committing storefront changes, when simplifying a frontend diff, or when the user asks whether…

Connects to the Odin review server via SSH and searches Docker container logs for errors, exceptions, and 5xx responses on a given review branch.

Rebase a branch onto the latest base branch and apply its fixup commits (git rebase --autosquash), resolving conflicts semantically along the way. Works on a pull request (rebases its head branch, force-pushes with --force-with-lease only, and posts a report…

Fan-out code review of multiple/all open PRs - one parallel worktree-isolated agent per PR, each following the review-pr skill protocol, then cross-PR verification, cleanup and summary. Use when asked to review all open PRs or several PRs at once; a single PR…

Detailed code review of ONE pull request - scope vs its (possibly stacked) base, verification-first findings (render + tests + web research), posting a GitHub review with anchored inline comments signed "Claude Agent (CR)". Use when asked to review a specific…

Conventions for creating GitHub issues in this repository - body structure, title prefixes, the label taxonomy and cross-linking rules. Use whenever filing new issues or turning analysis/review findings into backlog items.

Diagnosing a failed deploy on a real cluster - identifying which phase failed from the end states, where the logs are, recovery commands, and what must NOT be done. Use when a helmfile/wrapper deploy fails or behaves unexpectedly.

Helm and Kubernetes best practices plus this repository's hard-won gotchas (template pitfalls, hook lifecycle, secrets patterns, determinism rules). Read BEFORE writing or modifying any chart template, values file or hook.

Lifecycle of implementing a backlog issue - triage, scope decisions, the PR flow and the closing retrospective comment. Use when asked to implement an issue from the tracker.

End-to-end workflow for preparing a pull request in this repository - branching, implementation checklist, the full verification suite, commit/PR conventions and stacked-PR handling. Use whenever implementing an issue or any change that will become a PR.

Porting changes from the legacy shopsys/deployment package (upstream PRs, manifest fixes) into these charts. Use when asked to review/port upstream deployment PRs or to check what changed upstream.

The command catalog for this Shopsys project — how to build, run, test, check code, access the database, and sync the GraphQL schema, including the macOS Mutagen workflow. Read it when you need the exact command for a task and which run inside Docker…

Write, review, debug or select tests for the Shopsys Next.js storefront. Covers Vitest and React Testing Library and routes browser E2E/visual work to cypress-tests. Excludes administration Jest and PHP GraphQL server tests.

Write, review, debug or select tests for Shopsys backend and administration, including PHPUnit PHP/GraphQL tests and Jest admin JavaScript tests. Use for backend Test.php files and administration JS tests, not Next.js storefront tests.

Coding principles and conventions for this Shopsys project — DRY/KISS/reuse, comment and docblock quality, test-code rules, the project visibility/typing rules, and documentation best practices. Read it before writing or modifying PHP so your code matches the…

Decide whether to add, extend or reuse tests for Shopsys implementation changes, then select the testing layer and domain specialist. Also use for testing requests with unclear or cross-domain scope.

Create or extend an administration CRUD controller (list / detail / create / edit / delete pages for an entity) built on Shopsys\AdministrationBundle\Controller\AbstractCrudController. Use when the user asks for a new admin section, admin list, admin…

Finds similar implementations, usage examples, and established patterns in this Shopsys project that you can model new work after. Like codebase-locator, but it also returns concrete code snippets with file:line references, not just locations.

Use PROACTIVELY when you investigate, analyze, debug, or review performance issues using Blackfire.io profiles. Triggers on: 'blackfire profile', 'performance analysis', 'investigate slow', 'profile URL', app.blackfire.io URLs, slow requests, high CPU/IO, N+1…

Use PROACTIVELY when you implement, review, audit, debug, or optimize bulk operations (imports, mass edits, variant creation, batch updates) in Doctrine/Shopsys codebases. Triggers on: slow batch operations, 'Doctrine CPU spiral', N+1 queries in loops,…