Créer un agent personnalisé pour Boost

interface SupportsGuidelines
{
    // Chemin de fichier où écrire les guidelines d'IA
    public function guidelinesPath(): string;

    // Le fichier de guidelines nécessite-t-il un frontmatter ?
    public function frontmatter(): bool;

    // Post-traite le Markdown de guidelines généré
    public function transformGuidelines(string $markdown): string;
}

interface SupportsMcp
{
    // Utiliser un chemin absolu pour la commande MCP ?
    public function useAbsolutePathForMcp(): bool;

    // Retourne le chemin de l'exécutable PHP
    public function getPhpPath(bool $forceAbsolutePath = false): string;

    // Retourne le chemin d'artisan
    public function getArtisanPath(bool $forceAbsolutePath = false): string;

    // Installe la configuration du serveur MCP
    public function installMcp(string $key, string $command, array $args = [], array $env = []): bool;

    // Installe la configuration MCP en HTTP
    public function installHttpMcp(string $key, string $url): bool;
}

interface SupportsSkills
{
    // Chemin du répertoire où écrire les Agent Skills
    public function skillsPath(): string;
}

// Cas d'une sortie en fichier unique
public function guidelinesPath(): string
{
    return 'MYAGENT.md';
}

public function guidelinesPath(): string
{
    return config('boost.agents.my_agent.guidelines_path', 'MYAGENT.md');
}

public function frontmatter(): bool
{
    return true;
}

public function transformGuidelines(string $markdown): string
{
    // Ajouter un en-tête spécifique à l'agent
    $header = "<!-- Generated by Laravel Boost for MyAgent -->\n\n";

    return $header . $markdown;
}

.ai/
└── guidelines/
    ├── my-domain-rules.blade.php
    └── coding-standards.blade.php

## Règles spécifiques au projet

Dans ce projet, respectez les conventions suivantes :

- Placer les modèles obligatoirement dans le namespace `App\Models\`
- Créer tous les endpoints API sous `App\Http\Controllers\Api\`
- Encapsuler les transactions BDD avec `DB::transaction()` à l'intérieur de la classe de service

@verbatim
<code-snippet name="Exemple de transaction dans une classe de service" lang="php">
DB::transaction(function () use ($data) {
    $order = Order::create($data);
    $order->items()->createMany($data['items']);
    event(new OrderCreated($order));
});
</code-snippet>
@endverbatim

# Surcharger "Inertia React v2 Form Guidance" de Boost
.ai/guidelines/inertia-react/2/forms.blade.php

.ai/
└── skills/
    └── creating-invoices/
        └── SKILL.md

---
name: creating-invoices
description: Skill utilisée pour implémenter la création, la mise à jour et l'envoi des factures (Invoice).
---

# Skill de création de factures

## Quand utiliser cette skill

À utiliser lors de l'implémentation du modèle de facture, de la génération PDF de la facture et de l'envoi par e-mail.

## Structure des fichiers

- `app/Models/Invoice.php` — Modèle de facture
- `app/Services/InvoiceService.php` — Logique métier
- `app/Jobs/SendInvoiceEmail.php` — Job d'envoi d'e-mail

## Patterns d'implémentation

### Création d'une facture

```php
// $items est un tableau passé depuis le contrôleur ou un autre service
$invoice = InvoiceService::create([
    'user_id' => $user->id,
    'items' => $items,
    'due_date' => now()->addDays(30),
]);

use Barryvdh\DomPDF\Facade\Pdf;
use Illuminate\Support\Facades\Storage;

$pdf = Pdf::loadView('invoices.pdf', ['invoice' => $invoice]);
Storage::put("invoices/{$invoice->id}.pdf", $pdf->output());

# Personnaliser la skill livewire-development
.ai/skills/livewire-development/SKILL.md

resources/
└── boost/
    └── guidelines/
        └── core.blade.php

## MyPackage

Ce package fournit [aperçu des fonctionnalités].

### Utilisation de base

@verbatim
<code-snippet name="Initialisation de MyPackage" lang="php">
$result = MyPackage::create([
    'option' => 'value',
]);
</code-snippet>
@endverbatim

resources/
└── boost/
    └── skills/
        └── mypackage-development/
            └── SKILL.md

---
name: mypackage-development
description: Skill pour implémenter les fonctionnalités de MyPackage.
---

# MyPackage Development

## Quand utiliser cette skill
À utiliser lors de l'implémentation de fonctionnalités utilisant MyPackage.

## Fonctionnalités principales

- Fonctionnalité 1 : ...
- Fonctionnalité 2 : ...

<?php

declare(strict_types=1);

namespace App\Boost;

use Laravel\Boost\Contracts\SupportsGuidelines;
use Laravel\Boost\Install\Agents\Agent;
use Laravel\Boost\Install\Enums\Platform;

class PipelineAgent extends Agent implements SupportsGuidelines
{
    public function name(): string
    {
        return 'pipeline_agent';
    }

    public function displayName(): string
    {
        return 'Pipeline Agent (CI/CD)';
    }

    public function systemDetectionConfig(Platform $platform): array
    {
        // Détecter la présence via une variable d'environnement CI
        return [
            'command' => match ($platform) {
                Platform::Windows => 'cmd /c echo %CI_AGENT_VERSION% 2>nul',
                default => 'echo $CI_AGENT_VERSION',
            },
        ];
    }

    public function projectDetectionConfig(): array
    {
        // Détecter via un fichier de configuration à la racine du projet
        return [
            'files' => ['.pipeline-agent.yml'],
        ];
    }

    public function guidelinesPath(): string
    {
        // Chemin des conventions lu par l'agent CI/CD
        return '.pipeline/CODING_GUIDELINES.md';
    }

    public function frontmatter(): bool
    {
        return false;
    }

    public function transformGuidelines(string $markdown): string
    {
        // Ajouter un en-tête de métadonnées pour le pipeline
        $timestamp = now()->toIso8601String();

        return "<!-- Generated by Laravel Boost at {$timestamp} -->\n\n{$markdown}";
    }
}

use App\Boost\PipelineAgent;
use Laravel\Boost\Boost;

public function boot(): void
{
    Boost::registerAgent('pipeline_agent', PipelineAgent::class);
}

php artisan boost:install --agent=pipeline_agent