메뉴
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