Initial commit

skills/make-out/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: framework:make:out
+description: Génère classe Out (DTO immuable pour output)
+license: MIT
+version: 1.0.0
+---
+
+# Framework Make Out Skill
+
+## Description
+Génère une classe Out (Data Transfer Object) immuable pour représenter les données de sortie d'une entité.
+
+La classe Out est un DTO readonly qui encapsule une entité pour l'exposition vers l'extérieur (API, vues, etc.).
+
+## Usage
+```
+Use skill framework:make:out
+
+Vous serez invité à fournir :
+- Le nom de l'entité (ex: Product, User, Order)
+```
+
+## Templates
+- `Out/UtilisateurOut.php` - Template de classe Out
+
+## Variables requises
+- **{EntityName}** - Nom de l'entité en PascalCase (ex: Utilisateur, Product)
+- **{entityName}** - Nom de l'entité en camelCase (ex: utilisateur, product)
+- **{namespace}** - Namespace du projet (défaut: App)
+
+## Dépendances
+- Requiert que l'entité existe dans `src/Entity/{EntityName}.php`
+
+## Outputs
+- `src/Out/{EntityName}Out.php`
+
+## Workflow
+
+1. Demander le nom de l'entité (EntityName)
+2. Vérifier que l'entité existe dans `src/Entity/{EntityName}.php`
+   - Si non : arrêter et demander de créer l'entité d'abord
+3. Générer la classe Out depuis le template :
+   - Remplacer `{EntityName}` par le nom fourni
+   - Remplacer `{entityName}` par la version camelCase
+4. Afficher le fichier créé
+
+## Patterns appliqués
+
+### Classe Out
+- Classe `final readonly`
+- Constructeur privé
+- Factory statique `new()` pour instanciation
+- Propriété privée de type entité
+- Objet complètement immuable
+
+## Exemple
+
+```bash
+Use skill framework:make:out
+
+# Saisies utilisateur :
+EntityName: Product
+
+# Résultat :
+✓ src/Out/ProductOut.php
+```
+
+Fichier généré :
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Out;
+
+use App\Entity\Product;
+
+final readonly class ProductOut
+{
+    private function __construct(
+        private Product $product,
+    ) {
+    }
+
+    public static function new(
+        Product $product,
+    ): self {
+        return new self(
+            product: $product,
+        );
+    }
+}
+```
+
+## Usage dans l'entité
+
+L'entité doit implémenter la méthode `out()` :
+
+```php
+public function out(): ProductOut
+{
+    return ProductOut::new(
+        product: $this,
+    );
+}
+```
+
+## Notes
+- La classe Out peut être enrichie avec des méthodes pour exposer des propriétés calculées
+- Elle sert de couche anti-corruption entre le domaine et l'extérieur
+- Permet de contrôler finement ce qui est exposé depuis l'entité
+- Respecte le principe d'immutabilité (readonly)