Desenvolvimento assistido por IA

• Introduction
  • Why Laravel for AI Development?
• Laravel Boost
  • Installation
  • Available Tools
  • AI Guidelines
  • Documentation Search
  • IDE Integration
• Custom Boost Guidelines
  • Adding Project Guidelines
  • Package Guidelines

Introdução

O Laravel está numa posição única para ser o melhor framework para desenvolvimento assistido por IA e agentes. O surgimento de agentes de codificação com IA, como Claude Code , OpenCode , Cursor e GitHub Copilot, transformou a maneira como os desenvolvedores escrevem código. Essas ferramentas podem gerar funcionalidades inteiras, depurar problemas complexos e refatorar código a uma velocidade sem precedentes — mas sua eficácia depende muito de quão bem elas entendem sua base de código.

Por que usar Laravel para desenvolvimento de IA?

As convenções bem definidas e a estrutura precisa do Laravel o tornam um framework ideal para desenvolvimento assistido por IA. Quando você pede a um agente de IA para adicionar um controlador, ele sabe exatamente onde colocá-lo. Quando você precisa de uma nova migração, as convenções de nomenclatura e os locais dos arquivos são previsíveis. Essa consistência elimina as suposições que frequentemente atrapalham as ferramentas de IA em frameworks mais flexíveis.

Além da organização de arquivos, a sintaxe expressiva e a documentação abrangente do Laravel fornecem aos agentes de IA o contexto necessário para gerar código preciso e idiomático. Recursos como relacionamentos Eloquent, requisições de formulário e middleware seguem padrões que os agentes podem entender e replicar com segurança. O resultado é um código gerado por IA que parece ter sido escrito por um desenvolvedor Laravel experiente, e não apenas uma junção de trechos genéricos de PHP.

Laravel Boost

O Laravel Boost preenche a lacuna entre os agentes de IA para codificação e sua aplicação Laravel. O Boost é um servidor MCP (Model Context Protocol) equipado com mais de 15 ferramentas especializadas que fornecem aos agentes de IA uma visão profunda da estrutura, banco de dados, rotas e muito mais da sua aplicação. Ao instalar o Boost, seu agente de IA se transforma de um assistente de código genérico em um especialista em Laravel que entende a sua aplicação específica.

O Boost oferece três funcionalidades principais: um conjunto de ferramentas MCP para inspecionar e interagir com sua aplicação, diretrizes de IA componíveis criadas especificamente para o ecossistema Laravel e uma API de documentação poderosa contendo mais de 17.000 itens de conhecimento específico do Laravel.

Instalação

O Boost pode ser instalado em aplicações Laravel 10, 11 e 12 que utilizam PHP 8.1 ou superior. Para começar, instale o Boost como uma dependência de desenvolvimento:

1composer require laravel/boost --dev

Após a instalação, execute o instalador interativo:

1php artisan boost:install

O instalador detectará automaticamente seu IDE e agentes de IA, permitindo que você selecione as integrações mais adequadas ao seu projeto. O Boost gerará os arquivos de configuração necessários, como .mcp.json os para editores compatíveis com MCP e os arquivos de diretrizes para o contexto de IA.

Ferramentas disponíveis

O Boost disponibiliza um conjunto abrangente de ferramentas para agentes de IA por meio do Protocolo de Contexto de Modelo. Essas ferramentas permitem que os agentes compreendam e interajam profundamente com sua aplicação Laravel:

AI Guidelines

Boost includes a comprehensive set of AI guidelines specifically crafted for the Laravel ecosystem. These guidelines teach AI agents how to write idiomatic Laravel code, follow framework conventions, and avoid common pitfalls. Guidelines are composable and version-aware, meaning agents receive instructions appropriate for your exact package versions.

Guidelines are available for Laravel itself and over 16 packages in the Laravel ecosystem, including:

When you run boost:install, Boost automatically detects which packages your application uses and assembles the relevant guidelines into your project's AI context files.

Documentation Search

Boost includes a powerful documentation API that gives AI agents access to over 17,000 pieces of Laravel ecosystem documentation. Unlike generic web searches, this documentation is indexed, vectorized, and filtered to match your exact package versions.

When an agent needs to understand how a feature works, it can search Boost's documentation API and receive accurate, version-specific information. This eliminates the common problem of AI agents suggesting deprecated methods or syntax from older framework versions.

IDE Integration

Boost integrates with popular IDEs and AI tools that support the Model Context Protocol. Here's how to enable Boost in a few popular editors:

Boost is typically detected automatically. If manual setup is needed:
 
1. Open a terminal in your project directory
2. Run: claude mcp add laravel-boost -- php artisan boost:mcp

1. Open the command palette (Cmd+Shift+P or Ctrl+Shift+P)
2. Select "MCP: Open Settings"
3. Toggle on the "laravel-boost" option

1. Open the command palette (Cmd+Shift+P or Ctrl+Shift+P)
2. Select "MCP: List Servers"
3. Navigate to "laravel-boost" and press enter
4. Select "Start server"

1. Press Shift twice to open Search Everywhere
2. Search for "MCP Settings" and press enter
3. Enable the checkbox next to "laravel-boost"
4. Click "Apply"

Boost is typically detected automatically. If manual setup is needed:
 
1. Open a terminal in your project directory
2. Run: codex mcp add -- php artisan boost:mcp

Boost is typically detected automatically. If manual setup is needed:
 
1. Open a terminal in your project directory
2. Run: gemini mcp add laravel-boost -- php artisan boost:mcp

Custom Boost Guidelines

While Boost's built-in guidelines cover the Laravel ecosystem comprehensively, you may want to add project-specific instructions for your AI agents.

Adding Project Guidelines

To add custom guidelines for your project, create .blade.php or .md files in your application's .ai/guidelines directory:

1.ai/
2└── guidelines/
3    └── api-conventions.md
4    ├── architecture.md
5    ├── testing-standards.blade.php

These files will automatically be included when you run boost:install. Use these guidelines to document your team's coding standards, architectural decisions, domain-specific terminology, or any other context that would help AI agents write better code for your project.

Package Guidelines

If you maintain a Laravel package and want to provide AI guidelines for your users, you can include guidelines in your package's resources/boost/guidelines directory:

1resources/
2└── boost/
3    └── guidelines/
4        └── core.blade.php

As diretrizes de IA devem fornecer uma breve visão geral do que seu pacote faz, descrever qualquer estrutura de arquivos ou convenções necessárias e explicar como criar ou usar seus principais recursos (com exemplos de comandos ou trechos de código). Mantenha-as concisas, práticas e focadas nas melhores práticas para que a IA possa gerar o código correto para seus usuários. Aqui está um exemplo:

 1## Package Name
 2 
 3This package provides [brief description of functionality].
 4 
 5### Features
 6 
 7- Feature 1: [clear & short description].
 8- Feature 2: [clear & short description]. Example usage:
 9 
10@verbatim
11<code-snippet name="How to use Feature 2" lang="php">
12$result = PackageName::featureTwo($param1, $param2);
13</code-snippet>
14@endverbatim

Quando os usuários instalam o Boost em um aplicativo que inclui seu pacote, suas diretrizes serão automaticamente descobertas e incluídas no contexto de IA deles. Isso permite que os autores de pacotes ajudem os agentes de IA a entender como usar seus pacotes corretamente.