القائمة
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.
التثبيت باستخدام 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 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.
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 | tdd |
| description | 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. |
.ai/guidelines/testing.md.vendor/bin/pint --dirty --format agent, then commit via the commit skill (when asked).Skipping step 3 is the most common violation — a test that never failed proves nothing.
| Source | Test |
|---|---|
app/Livewire/X.php | tests/Feature/Livewire/XTest.php |
app/Services/X.php | tests/Feature/Services/XTest.php |
app/Http/Controllers/Api/EventController.php | tests/Feature/Api/EventIngestionTest.php |
app/Http/Controllers/Api/Ide/X.php | tests/Feature/Api/Ide/XTest.php |
app/Events/* (broadcast shape) | tests/Feature/Events/BroadcastShapeTest.php |
app/Console/Commands/X.php | tests/Feature/Console/XTest.php |
app/Models/X.php | tests/Feature/Models/XTest.php |
resources/views/install-script*.blade.php | tests/Feature/InstallScriptTest.php / HookSnippetTest.php |
resources/js/battlefield/<module>.js (pure logic) | tests/js/<module>.test.js |
Phaser scene-coupled JS has no test harness — extract the decision logic into a pure module first (that's the testable unit), then verify the wiring on staging.
spin exec php php artisan test --compact --filter=<Name> (container down → docker start token-slayer-php-1)npx vitest run tests/js/<file>.test.js