القائمة
Use when adding or renaming a real-time broadcast event — walks the full PHP→Echo→scene chain so all three names stay aligned and the shape test exists.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when committing changes in this repo — enforces the Angular commit convention with project scopes, staging discipline, and the files that must never be committed.
Use for EVERY behavior change in this repo — enforced red/green workflow with the project's source→test path mapping. Write the failing test first, watch it fail, then implement.
Use when running or scoping tests in this repo — correct commands, how to scope runs, environment gotchas, and how to read failures.
Use when working in resources/js/battlefield/ — the Phaser 3 real-time battlefield game (scene, snapshot, leaderboard, projectile, attacks, layout, bus) or wiring a Laravel broadcast event to it. Covers the Echo→bus→scene data flow, the event-name/payload contract, snapshot round-trip, and Phaser teardown rules.
Develops real-time broadcasting with Laravel Echo. Activates when setting up broadcasting (Reverb, Pusher, Ably); creating ShouldBroadcast events; defining broadcast channels (public, private, presence, encrypted); authorizing channels; configuring Echo; listening for events; implementing client events (whisper); setting up model broadcasting; broadcasting notifications; or when the user mentions broadcasting, Echo, WebSockets, real-time events, Reverb, or presence channels.
Use for any task or question involving Livewire. Activate if user mentions Livewire, wire: directives, or Livewire-specific concepts like wire:model, wire:click, wire:sort, or islands, invoke this skill. Covers building new components, debugging reactivity issues, real-time form validation, drag-and-drop, loading states, migrating from Livewire 3 to 4, converting component formats (SFC/MFC/class-based), and performance optimization. Do not use for non-Livewire reactive UI (React, Vue, Alpine-only, Inertia.js) or standard Laravel forms without Livewire.
| name | scaffold-broadcast-event |
| description | Use when adding or renaming a real-time broadcast event — walks the full PHP→Echo→scene chain so all three names stay aligned and the shape test exists. |
A broadcast event spans four files. Missing any one fails silently in production. Work through ALL steps in order.
app/Events/<Name>.php:
ShouldBroadcastNow for latency-sensitive gameplay events (hits, charging, joins); queued ShouldBroadcast only with a stated reason.broadcastOn(): array → [new Channel('battlefield')]broadcastAs(): string → PascalCase name, e.g. 'FighterStunned'broadcastWith(): array → snake_case scalars only, never models. Resolve user display fields the way sibling events do.resources/js/battlefield/index.js: add the ECHO_EVENT_MAP entry mapping the broadcastAs name to a kebab-case bus key (FighterStunned → fighter-stunned).resources/js/battlefield/scene.js: register the bus key in _busHandlers; the handler must be released on shutdown like its siblings.tests/Feature/Events/BroadcastShapeTest.php locking channel, broadcastAs, and broadcastWith keys. Write it FIRST (tdd skill).rescue() if fired from the ingestion path.broadcastAs() string === ECHO_EVENT_MAP key (Echo subscribes with a leading .)scene.js and torn down on shutdownbroadcastWith()rescue() around dispatch on the hook pathspin exec php php artisan test --compact --filter=BroadcastShape + npm run buildThen request review from the broadcast-reviewer agent.