Skip to content

v1.0.0 — AI Readiness Audit, Auto-Fix & Simulation for Laravel

Latest

Choose a tag to compare

@jaygaha jaygaha released this 27 Mar 05:53

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 --dev
php 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 behavior

Requirements

  • 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