From 5c705d30a99af90b0416bbf74fa93addbd743466 Mon Sep 17 00:00:00 2001 From: DariusIII Date: Tue, 11 Aug 2026 13:02:03 +0200 Subject: [PATCH] Update AGENTS.md --- AGENTS.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index c3b3e2c22..4731a76dd 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -100,6 +100,7 @@ PHPUnit only (no Pest). Create tests: `php artisan make:test --phpunit {name}` - 80+ auto-registered in `app/Console/Commands/` - Create with `php artisan make:` + `--no-interaction` - Docker/Sail convenience targets live in `Makefile`; prefer `make artisan cmd="..."`, `make test filter=TestName`, `make pint`, and `make npm-build` when working inside containers +- On WSL2, Docker may come from **Windows Docker Desktop** (not a Linux Docker package in the distro). If `docker` is missing or the daemon is unreachable, start Desktop / enable WSL integration before installing Docker inside WSL — see Sail rules below - This workspace may have cached routes under `bootstrap/cache/routes-*.php`; after adding/changing routes, refresh with `php artisan route:cache` if a route appears missing ### Admin Content @@ -291,6 +292,14 @@ This project has domain-specific skills available in `**/skills/**`. You MUST ac - Execute PHP scripts: `vendor/bin/sail php [script]` - View all available Sail commands by running `vendor/bin/sail` without arguments. +### WSL2 + Windows Docker Desktop + +Local development is often done in WSL2 while Docker itself runs via **Windows Docker Desktop** (WSL integration), not a native Linux Docker install inside the distro. + +- If `docker` / `docker compose` cannot be found, or Sail fails with "Docker is not running" / cannot connect to the daemon, do **not** assume Docker must be installed inside WSL. Check that Docker Desktop is running on Windows and that WSL integration is enabled for this distro. +- Prefer diagnosing through Docker Desktop (engine status, WSL integration settings) before suggesting `apt install docker` or similar host installs. +- Once Desktop is up and integrated, `vendor/bin/sail` and `make …` targets should work from the WSL project tree as usual. + === tests rules === # Test Enforcement