AI guidelines

The package ships a Laravel Boost guideline at resources/boost/guidelines/core.blade.php and a Boost skill at resources/boost/skills/geolocation-lookup/SKILL.md. When a Boost user runs php artisan boost:install, or php artisan boost:update --discover after installing this package, the guideline is merged into their agent's context and the skill is installed for on-demand use.

What the guideline covers

The parts that are easy to get wrong: a missing database throwing instead of returning an empty result, the aliasing needed when importing the facade and the contract together, the geolocate request macro, and why X-Forwarded-For must not be parsed by hand.

What the skill covers

The longer material: requirements and setup, reading a result, the failure modes that throw, the geolocate request macro, testing with Geolocator::fake(), custom drivers, the update command and its events, and a troubleshooting table.

Guidelines load upfront while skills load on demand when a task matches, so the split keeps the always-on guideline short without losing detail.

Nothing depends on Boost

Discovery is by convention from vendor/sameoldnick/laravel-geolocator/resources/boost, so the guideline costs users who do not use Boost nothing at all. Boost renders a guideline as Blade and silently skips one that fails to render, so its snippets are kept inside @verbatim — see CONTRIBUTING for how to re-render it after editing.