Audit, optimize, and prepare your Laravel codebase for seamless integration with
AI coding agents (Claude Code, Cursor, Copilot, Codex).
Highlights
- Readiness Audit — 0–100 AI-readiness score with 5 analyzers (typing, Pint, Larastan, test coverage, pattern enforcement)
- Auto-Fix Pipeline — Pint, Larastan, Rector, test generation, controller refactoring, and pattern enforcement
- AGENTS.md Generator — Auto-generate structured AI agent guidelines from AST analysis
- Simulation Mode — Predict what AI agents will do with your code before they do it
- Controller Refactoring — Extract bloated controllers into Actions, Services, FormRequests, and DTOs
- Pattern Enforcement — Enforce Horizon for queues, Mailables for email, Gates/Policies for auth
- Plugin System — Extensible architecture with built-in Filament and Inertia plugins
- 9 AI-Enhanced Stubs — Model, Controller, Job, Notification, Mailable, Policy, Event, Listener, Middleware
- GitHub Actions Workflow — Reusable CI workflow with configurable minimum score
Quick Start
composer require jaygaha/laravel-ai-prep-kit --devphp artisan ai:prep --audit # Score your codebase
php artisan ai:prep --fix --dry-run # Preview auto-fixes
php artisan ai:prep --generate-guidelines # Generate AGENTS.md
php artisan ai:prep --simulate # Simulate AI agent behaviorRequirements
- PHP 8.3+
- Laravel 11 or 12
Stats
- 253 tests, 715 assertions
- 86 source files, 13 stub templates
- 8 contracts, 5 analyzers, 6 fixers, 3 rules, 5 detectors, 7 scenarios
- 2 built-in plugins (Filament, Inertia)
Full Changelog: See CHANGELOG.md