My AI Guidelines for Laravel/PHP and Filament v4

Works for CLAUDE.md, AGENTS.md, Cursor .mdc files, etc.

I’ve been working with AI tools on Laravel projects, and gathered quite a few guidelines from practice - where LLMs fail to deliver the latest version code or slip somewhere else.

I will publish all those guidelines below, but first - the PROCESS.

---

New Laravel Project: My AI Workflow

For new Laravel projects, I usually do this for guidelines:

1. Install Laravel Boost right away (now it’s part of ‘laravel new’ installer)

2. Install Filament right away if I plan to use it in this project (I usually do)

3. Copy my custom guidelines from a local folder into .ai/guidelines folder - so I have two files: .ai/guidelines/php-laravel.md and .ai/guidelines/filament.md (read Laravel Boost docs on custom guidelines)

4. Re-run ‘php artisan boost:install’ which then takes my ‘.ai/guidelines’ files and put their content inside of CLAUDE.md

5. That’s it, now I can fire Claude Code and start prompting.

This is the result, visually:

For the local copies of those .ai/guidelines, I have a separate local folder connected to a GitHub repository, so if any new rules or guidelines appear, I change them locally in that folder and push to that repo.

I even built a Bash script to automate all of this:

setup-ai.sh:

#!/bin/bash

# Create directories
mkdir -p .ai/guidelines || exit 1

# Copy guidelines file
cp ../AI-Coding-Guidelines/php-laravel.md .ai/guidelines || exit 1
cp ../AI-Coding-Guidelines/filament.md .ai/guidelines || exit 1

# Install boost package
php artisan boost:install || exit 1

---

Guidelines for PHP/Laravel/Filament

Now, as promised, the contents of those files .md files, as of January 2026.

Last update Jan 10, 2026: removed a few Laravel/Filament lines, as LLMs got better to generate better code by default, powered by Boost ‘search-docs’. Also renamed the files from ‘laraveldaily.md’ to ‘php-laravel.md’, and from ‘filament-v4.md’ to more general ‘filament.md’.

php-laravel.md: