Laravel Brain Laravel Package

Product Decisions This Supports

• Technical Debt Visualization: Justify investment in refactoring by quantifying cyclomatic complexity, fat classes, and call chain sprawl. The AI context export enables data-driven prioritization of refactors.
• Onboarding Acceleration: Reduce ramp-up time for new engineers by providing an interactive architecture map. The Filament support ensures admin panel developers can visualize workflows immediately.
• Performance Debugging: Identify bottlenecks via route stress testing (integrated with laravel-stress) and DB query tracing, reducing guesswork in optimization efforts.
• AI-Assisted Development: Generate deterministic context files for Claude, Copilot, and other AI tools, reducing manual documentation overhead. The brain:generate-rules command aligns with the trend of AI-native workflows.
• Build vs. Buy: Avoid building a custom architecture visualization tool (cost: months of dev time). This package delivers 80% of the value with zero maintenance.
• Filament Adoption: For teams using Filament, this package bridges the gap between frontend panels and backend services, validating the Filament investment by surfacing hidden dependencies.

When to Consider This Package

• Look Elsewhere If:
  • Your app is monolithic with no modular boundaries (the graph will be overwhelmingly dense).
  • You’re using non-Laravel frameworks (Symfony, Django, etc.).
  • Your team rejects visual tools in favor of manual code reviews (cultural fit risk).
  • You need real-time tracing (this is a static analysis tool; use Laravel Telescope or Debugbar for runtime data).
  • Your codebase exceeds 50K+ lines of PHP without optimization (increase --memory-limit or split scans).
• Consider This Package If:
  • You’re maintaining a medium-to-large Laravel app (5K+ LOC) with unclear ownership of routes/services.
  • Your team struggles with technical debt prioritization or knowledge silos.
  • You use Filament, Livewire, or queues and want to visualize their interactions.
  • You’re integrating AI tools (Copilot, Claude) and need project-specific context.
  • You need to audit middleware, events, or scheduled tasks without reading app/Console/Kernel.php.
  • You’re onboarding engineers or preparing for a major refactor.

How to Pitch It (Stakeholders)

For Executives: "Laravel Brain is a zero-cost, zero-maintenance ‘X-ray’ for our Laravel codebase. It turns spaghetti code into an interactive map—revealing hidden dependencies, fat classes, and performance bottlenecks in seconds. For example, it flagged [X] controller with 400 lines of code and [Y] route triggering 12 DB queries, saving us [Z] hours of manual analysis. The AI context export also lets our team feed Copilot/Claude with accurate, project-specific data—cutting down on hallucinations and speeding up PR reviews. It’s like hiring a senior dev to document the system… for free."

For Engineering Leaders: *"This tool replaces three things we currently do manually:

1. Architecture diagrams (now auto-generated and clickable).
2. Code health audits (cyclomatic complexity, fat classes, query tracing).
3. Onboarding docs (interactive graph > static Confluence pages). The Filament support is a game-changer for our admin panels—we can now trace a panel action back to its service layer in one click. The route stress test feature also lets us validate performance fixes before deploying. Installation takes 10 minutes; ROI is immediate."*

For Developers: *"Imagine opening /_laravel-brain and seeing:

• Every route as a node, color-coded by HTTP method.
• One click to see the full call chain (controller → service → model → job).
• Fat classes highlighted (300+ lines or 10+ methods).
• DB queries surfaced per method—no more guessing where N+1 queries hide.
• Filament panels mapped to their backend services.
• AI-ready context for Copilot/Claude with a single button. It’s like having a live, searchable architecture doc that updates with git pull. Try it on your PR—you’ll never debug a route in php artisan tinker again."*