Boost Core Laravel Package

Getting Started

Minimal Setup

1. Installation:

   composer require sandermuller/boost-core
   

   Add to composer.json under require-dev if only for local AI agent integration.

2. Initialize Configuration:

   php artisan boost:init
   

   This creates a .ai/ directory with default files (skills.md, guidelines.md, commands.md).

3. First Sync:

   php artisan boost:sync
   

   Publishes your .ai/ content to all nine supported agents (Claude, Cursor, etc.).

First Use Case

Define a project-specific AI skill in .ai/skills.md:

# Laravel API Development
- **Framework**: Laravel 11+
- **Database**: MySQL 8.0+
- **Key Patterns**:
  - Use `php artisan make:resource` for API endpoints.
  - Prefer `spatie/laravel-query-builder` for complex queries.

Sync with:

php artisan boost:sync --tags=laravel,api

Now, agents will reference this context when assisting with Laravel tasks.

Implementation Patterns

Workflow Integration

1. Skill Development:

   • Modularize .ai/skills.md by section (e.g., #Database, #Testing).
   • Use YAML frontmatter for metadata (e.g., tags: ["auth", "validation"]).
   • Example:

     ---
     title: "Laravel Auth"
     tags: ["auth", "middleware"]
     ---
     # Custom Guard Logic
     Extend `Illuminate\Auth\GuardHelpers` for role-based access.
     

2. Command Automation:

   • Define reusable CLI snippets in .ai/commands.md:

     ## Laravel Commands
     ```bash
     # Create a resource with validation
     php artisan make:resource Post -m --validation
     

   • Sync with --commands flag:

     php artisan boost:sync --commands
     

3. Tag-Based Filtering:

   • Tag skills (e.g., #database, #testing) and sync selectively:

     php artisan boost:sync --tags=database
     

   • Useful for multi-agent environments (e.g., sync only gemini for docs).

4. CI/CD Hooks:

   • Trigger syncs in GitHub Actions:

     - name: Sync AI Skills
       run: php artisan boost:sync
       env:
         BOOST_AGENTS: "claude,cursor"
     

Laravel-Specific Patterns

• Dynamic Skill Rendering: Use Laravel’s Blade in .ai/skills.md for dynamic content:

  # Current Laravel Version
  {{ config('app.version') }} ({{ config('app.env') }})
  

  Render with:

  php artisan boost:render --file=skills.md
  

• Environment-Aware Syncs: Override .ai/skills.md per environment (e.g., .ai/staging.md) and sync with:

  php artisan boost:sync --env=staging
  

Gotchas and Tips

Pitfalls

1. Agent-Specific Quirks:

   • Claude: Truncates long blocks; split skills into smaller sections.
   • Cursor: Ignores code blocks without language tags (add ````markdown`).
   • Copilot: Prefers YAML over Markdown for structured data.

2. Sync Conflicts:

   • Agents may cache old versions. Force a sync with --force:

     php artisan boost:sync --force
     

   • Monitor sync status via php artisan boost:status.

3. File Watching:

   • The package does not auto-sync on file changes. Use a watcher like nodemon:

     nodemon --watch .ai --exec "php artisan boost:sync"
     

Debugging

• Dry Runs: Test syncs without publishing:

  php artisan boost:sync --dry-run
  

• Agent Logs: Enable verbose output:

  php artisan boost:sync --verbose
  

  Logs appear in storage/logs/boost.log.

Extension Points

1. Custom Agents: Extend the Agent class to support unsupported agents:

   namespace App\Boost\Agents;
   
   use SanderMuller\BoostCore\Agent;
   
   class CustomAgent extends Agent {
       public function publish($content) {
           // Custom API call
       }
   }
   

   Register in config/boost.php:

   'agents' => [
       'custom' => \App\Boost\Agents\CustomAgent::class,
   ],
   

2. Pre/Post-Sync Hooks: Bind events in AppServiceProvider:

   use SanderMuller\BoostCore\Events\SyncStarted;
   
   public function boot() {
       SyncStarted::listen(function () {
           Log::info('AI sync initiated...');
       });
   }
   

3. Local Overrides: Use .ai/local.md for machine-specific configurations (e.g., IDE settings). Exclude from sync:

   php artisan boost:sync --exclude=local
   

Performance Tips

• Bulk Syncs: Combine skills into fewer files to reduce API calls.
• Agent Throttling: Limit concurrent agents via BOOST_CONCURRENCY env var:

  BOOST_CONCURRENCY=3 php artisan boost:sync