diff --git a/docs/fr/how-to/customize-bmad.md b/docs/fr/how-to/customize-bmad.md index 76bb14502..fe67424fe 100644 --- a/docs/fr/how-to/customize-bmad.md +++ b/docs/fr/how-to/customize-bmad.md @@ -2,7 +2,7 @@ title: "Comment personnaliser BMad" description: Personnalisez les agents, les workflows et les modules tout en préservant la compatibilité avec les mises à jour sidebar: - order: 7 + order: 8 --- Utilisez les fichiers `.customize.yaml` pour adapter le comportement, les personas[^1] et les menus des agents tout en préservant vos modifications lors des mises à jour. diff --git a/docs/fr/how-to/established-projects.md b/docs/fr/how-to/established-projects.md index 4f7e1cd24..ac25619ba 100644 --- a/docs/fr/how-to/established-projects.md +++ b/docs/fr/how-to/established-projects.md @@ -2,7 +2,7 @@ title: "Projets existants" description: Comment utiliser la méthode BMad sur des bases de code existantes sidebar: - order: 6 + order: 7 --- Utilisez la méthode BMad efficacement lorsque vous travaillez sur des projets existants et des bases de code legacy. diff --git a/docs/fr/how-to/get-answers-about-bmad.md b/docs/fr/how-to/get-answers-about-bmad.md index 7e05e11d4..c7789c445 100644 --- a/docs/fr/how-to/get-answers-about-bmad.md +++ b/docs/fr/how-to/get-answers-about-bmad.md @@ -2,7 +2,7 @@ title: "Comment obtenir des réponses à propos de BMad" description: Utiliser un LLM pour répondre rapidement à vos questions sur BMad sidebar: - order: 4 + order: 5 --- Utilisez l'aide intégrée de BMad, la documentation source ou la communauté pour obtenir des réponses — du plus rapide au plus approfondi. diff --git a/docs/fr/how-to/install-custom-modules.md b/docs/fr/how-to/install-custom-modules.md new file mode 100644 index 000000000..4271c0871 --- /dev/null +++ b/docs/fr/how-to/install-custom-modules.md @@ -0,0 +1,180 @@ +--- +title: "Installer des modules personnalisés et communautaires" +description: Installer des modules tiers depuis le registre communautaire, des dépôts Git ou des chemins locaux +sidebar: + order: 3 +--- + +Utilisez l'installateur BMad pour ajouter des modules depuis le registre communautaire, des dépôts Git tiers ou des chemins locaux. + +## Quand l'utiliser + +- Installer un module contribué par la communauté depuis le registre BMad +- Installer un module depuis un dépôt Git tiers (GitHub, GitLab, Bitbucket, auto-hébergé) +- Tester un module que vous développez localement avec BMad Builder +- Installer des modules depuis un serveur Git privé ou auto-hébergé + +:::note[Prérequis] +Nécessite [Node.js](https://nodejs.org) v20+ et `npx` (inclus avec npm). Les modules personnalisés et communautaires peuvent être sélectionnés lors d'une nouvelle installation ou ajoutés à une installation existante. +::: + +## Modules communautaires + +Les modules communautaires sont regroupés dans le [marketplace de plugins BMad](https://github.com/bmad-code-org/bmad-plugins-marketplace). Ils sont organisés par catégorie et épinglés à un commit approuvé pour des raisons de sécurité. + +### 1. Lancer l'installateur + +```bash +npx bmad-method install +``` + +### 2. Parcourir le catalogue communautaire + +Après avoir sélectionné les modules officiels, l'installateur demande : + +``` +Would you like to browse community modules? +``` + +Sélectionnez **Yes** pour accéder au navigateur de catalogue. Vous pouvez : + +- Parcourir par catégorie +- Voir les modules phares +- Voir tous les modules disponibles +- Rechercher par mot-clé + +### 3. Sélectionner des modules + +Choisissez des modules dans n'importe quelle catégorie. L'installateur affiche les descriptions, versions et niveaux de confiance. Les modules déjà installés sont pré-sélectionnés pour la mise à jour. + +### 4. Poursuivre l'installation + +Après avoir sélectionné les modules communautaires, l'installateur passe aux sources personnalisées, puis à la configuration des outils/IDE et au reste du flux d'installation. + +## Sources personnalisées (URL Git et chemins locaux) + +Les modules personnalisés peuvent provenir de n'importe quel dépôt Git ou d'un répertoire local sur votre machine. L'installateur résout la source, analyse la structure du module et l'installe aux côtés de vos autres modules. + +### Installation interactive + +Durant l'installation, après l'étape des modules communautaires, l'installateur demande : + +``` +Would you like to install from a custom source (Git URL or local path)? +``` + +Sélectionnez **Yes**, puis indiquez une source : + +| Type d'entrée | Exemple | +| ------------------------- | ------------------------------------------------- | +| URL HTTPS (tout hôte) | `https://github.com/org/repo` | +| URL HTTPS avec sous-rép. | `https://github.com/org/repo/tree/main/my-module` | +| URL SSH | `git@github.com:org/repo.git` | +| Chemin local | `/Users/me/projects/my-module` | +| Chemin local avec tilde | `~/projects/my-module` | + +L'installateur clone le dépôt (pour les URL) ou lit directement depuis le disque (pour les chemins locaux), puis présente les modules découverts pour la sélection. + +### Installation non interactive + +Utilisez l'option `--custom-source` pour installer des modules personnalisés depuis la ligne de commande : + +```bash +npx bmad-method install \ + --directory . \ + --custom-source /path/to/my-module \ + --tools claude-code \ + --yes +``` + +Quand `--custom-source` est fourni sans `--modules`, seuls le cœur et les modules personnalisés sont installés. Pour inclure également les modules officiels, ajoutez `--modules` : + +```bash +npx bmad-method install \ + --directory . \ + --modules bmm \ + --custom-source https://gitlab.com/myorg/my-module \ + --tools claude-code \ + --yes +``` + +Plusieurs sources peuvent être séparées par des virgules : + +```bash +--custom-source /path/one,https://github.com/org/repo,/path/two +``` + +## Fonctionnement de la découverte de modules + +L'installateur utilise deux modes pour trouver les modules installables dans une source : + +| Mode | Déclencheur | Comportement | +| ----------- | ------------------------------------------------- | -------------------------------------------------------------------------------------------- | +| Découverte | La source contient `.claude-plugin/marketplace.json` | Liste tous les plugins du manifeste ; vous choisissez lesquels installer | +| Direct | Aucun `marketplace.json` trouvé | Analyse le répertoire pour trouver des skills (sous-répertoires avec `SKILL.md`), les résout en un module unique | + +Le mode découverte est typique des modules publiés. Le mode direct est pratique pour pointer vers un répertoire de skills pendant le développement local. + +:::note[À propos de `.claude-plugin/`] +Le chemin `.claude-plugin/marketplace.json` est une convention standard adoptée par plusieurs installateurs d'outils IA pour la découvabilité des plugins. Il ne nécessite pas Claude, n'utilise pas les API Claude et n'a aucun impact sur l'outil d'IA que vous utilisez. Tout module contenant ce fichier peut être découvert par tout installateur suivant cette convention. +::: + +## Flux de travail en développement local + +Si vous construisez un module avec [BMad Builder](https://github.com/bmad-code-org/bmad-builder), vous pouvez l'installer directement depuis votre répertoire de travail : + +```bash +npx bmad-method install \ + --directory ~/my-project \ + --custom-source ~/my-module-repo/skills \ + --tools claude-code \ + --yes +``` + +Les sources locales sont référencées par leur chemin, non copiées dans un cache. Lorsque vous mettez à jour la source de votre module et réinstallez, l'installateur récupère les dernières modifications. + +:::caution[Suppression de la source] +Si vous supprimez le répertoire source local après l'installation, les fichiers du module installé dans `_bmad/` sont préservés. Le module sera ignoré lors des mises à jour tant que le chemin source n'est pas restauré. +::: + +## Ce que vous obtenez + +Après l'installation, les modules personnalisés apparaissent dans `_bmad/` aux côtés des modules officiels : + +``` +your-project/ +├── _bmad/ +│ ├── core/ # Module cœur intégré +│ ├── bmm/ # Module officiel (si sélectionné) +│ ├── my-module/ # Votre module personnalisé +│ │ ├── my-skill/ +│ │ │ └── SKILL.md +│ │ └── module-help.csv +│ └── _config/ +│ └── manifest.yaml # Suit tous les modules, versions et sources +└── ... +``` + +Le manifeste enregistre la source de chaque module personnalisé (`repoUrl` pour les sources Git, `localPath` pour les sources locales) afin que les mises à jour rapides puissent localiser la source à nouveau. + +## Mettre à jour les modules personnalisés + +Les modules personnalisés participent au flux de mise à jour normal : + +- **Mise à jour rapide** (`--action quick-update`) : Rafraîchit tous les modules depuis leurs sources d'origine. Les modules Git sont re-téléchargés ; les modules locaux sont relus depuis leur chemin source. +- **Mise à jour complète** : Relance la sélection de modules pour que vous puissiez ajouter ou retirer des modules personnalisés. + +## Créer vos propres modules + +Utilisez [BMad Builder](https://github.com/bmad-code-org/bmad-builder) pour créer des modules que d'autres pourront installer : + +1. Exécutez `bmad-module-builder` pour générer la structure de votre module +2. Ajoutez des skills, agents et workflows avec les divers outils BMad Builder +3. Publiez dans un dépôt Git ou partagez le dossier +4. D'autres installent avec `--custom-source ` + +Pour que les modules supportent le mode découverte, incluez un fichier `.claude-plugin/marketplace.json` à la racine de votre dépôt (c'est une convention multi-outils, pas spécifique à Claude). Consultez la [documentation BMad Builder](https://github.com/bmad-code-org/bmad-builder) pour le format du fichier `marketplace.json`. + +:::tip[Tester localement d'abord] +Pendant le développement, installez votre module avec un chemin local pour itérer rapidement avant de publier dans un dépôt Git. +::: diff --git a/docs/fr/how-to/non-interactive-installation.md b/docs/fr/how-to/non-interactive-installation.md index 328b7e9d4..17b3062ba 100644 --- a/docs/fr/how-to/non-interactive-installation.md +++ b/docs/fr/how-to/non-interactive-installation.md @@ -22,21 +22,22 @@ Nécessite [Node.js](https://nodejs.org) v20.12+ et `npx` (inclus avec npm). ### Options d'installation -| Option | Description | Exemple | -|------|-------------|---------| -| `--directory ` | Répertoire d'installation | `--directory ~/projects/myapp` | -| `--modules ` | IDs de modules séparés par des virgules | `--modules bmm,bmb` | -| `--tools ` | IDs d'outils/IDE séparés par des virgules (utilisez `none` pour ignorer) | `--tools claude-code,cursor` ou `--tools none` | -| `--action ` | Action pour les installations existantes : `install` (par défaut), `update`, ou `quick-update` | `--action quick-update` | +| Option | Description | Exemple | +|-----------------------------|------------------------------------------------------------------------------------------------|------------------------------------------------| +| `--directory ` | Répertoire d'installation | `--directory ~/projects/myapp` | +| `--modules ` | IDs de modules séparés par des virgules | `--modules bmm,bmb` | +| `--tools ` | IDs d'outils/IDE séparés par des virgules (utilisez `none` pour ignorer) | `--tools claude-code,cursor` ou `--tools none` | +| `--action ` | Action pour les installations existantes : `install` (par défaut), `update`, ou `quick-update` | `--action quick-update` | +| `--custom-source ` | URLs Git ou chemins locaux séparés par des virgules pour les modules personnalisés | `--custom-source /path/to/module` | ### Configuration principale -| Option | Description | Par défaut | -|------|-------------|---------| -| `--user-name ` | Nom à utiliser par les agents | Nom d'utilisateur système | -| `--communication-language ` | Langue de communication des agents | Anglais | -| `--document-output-language ` | Langue de sortie des documents | Anglais | -| `--output-folder ` | Chemin du dossier de sortie (voir les règles de résolution ci-dessous) | `_bmad-output` | +| Option | Description | Par défaut | +|---------------------------------------|------------------------------------------------------------------------|---------------------------| +| `--user-name ` | Nom à utiliser par les agents | Nom d'utilisateur système | +| `--communication-language ` | Langue de communication des agents | Anglais | +| `--document-output-language ` | Langue de sortie des documents | Anglais | +| `--output-folder ` | Chemin du dossier de sortie (voir les règles de résolution ci-dessous) | `_bmad-output` | #### Résolution du chemin du dossier de sortie @@ -45,17 +46,17 @@ La valeur passée à `--output-folder` (ou saisie de manière interactive) est r | Type d'entrée | Exemple | Résolu comme | |-------------------------------|----------------------------|--------------------------------------------------------------| | Chemin relatif (par défaut) | `_bmad-output` | `/_bmad-output` | -| Chemin relatif avec traversée | `../../shared-outputs` | Chemin absolu normalisé — ex. `/Users/me/shared-outputs` | +| Chemin relatif avec traversée | `../../shared-outputs` | Chemin absolu normalisé — example : `/Users/me/shared-outputs` | | Chemin absolu | `/Users/me/shared-outputs` | Utilisé tel quel — la racine du projet n'est **pas** ajoutée | Le chemin résolu est ce que les agents et les workflows vont utiliser lors de l'écriture des fichiers de sortie. L'utilisation d'un chemin absolu ou d'un chemin relatif avec traversée vous permet de diriger tous les artefacts générés vers un répertoire en dehors de l'arborescence de votre projet — utile pour les configurations partagées ou les monorepos. ### Autres options -| Option | Description | -|------|-------------| -| `-y, --yes` | Accepter tous les paramètres par défaut et ignorer les invites | -| `-d, --debug` | Activer la sortie de débogage pour la génération du manifeste | +| Option | Description | +|---------------|----------------------------------------------------------------| +| `-y, --yes` | Accepter tous les paramètres par défaut et ignorer les invites | +| `-d, --debug` | Activer la sortie de débogage pour la génération du manifeste | ## IDs de modules @@ -76,12 +77,13 @@ Exécutez `npx bmad-method install` de manière interactive une fois pour voir l ## Modes d'installation -| Mode | Description | Exemple | -|------|-------------|---------| -| Entièrement non-interactif | Fournir toutes les options pour ignorer toutes les invites | `npx bmad-method install --directory . --modules bmm --tools claude-code --yes` | -| Semi-interactif | Fournir certains options ; BMad demande les autres | `npx bmad-method install --directory . --modules bmm` | -| Paramètres par défaut uniquement | Accepter tous les paramètres par défaut avec `-y` | `npx bmad-method install --yes` | -| Sans outils | Ignorer la configuration des outils/IDE | `npx bmad-method install --modules bmm --tools none` | +| Mode | Description | Exemple | +|----------------------------------|------------------------------------------------------------|---------------------------------------------------------------------------------------------------| +| Entièrement non-interactif | Fournir toutes les options pour ignorer toutes les invites | `npx bmad-method install --directory . --modules bmm --tools claude-code --yes` | +| Semi-interactif | Fournir certains options ; BMad demande les autres | `npx bmad-method install --directory . --modules bmm` | +| Paramètres par défaut uniquement | Accepter tous les paramètres par défaut avec `-y` | `npx bmad-method install --yes` | +| Source personnalisée uniquement | Installer le cœur + les modules personnalisés | `npx bmad-method install --directory . --custom-source /path/to/module --tools claude-code --yes` | +| Sans outils | Ignorer la configuration des outils/IDE | `npx bmad-method install --modules bmm --tools none` | ## Exemples @@ -119,6 +121,33 @@ npx bmad-method install \ --action quick-update ``` +### Installer depuis une source personnalisée + +Installez un module depuis un chemin local ou tout hôte Git : + +```bash +npx bmad-method install \ + --directory . \ + --custom-source /path/to/my-module \ + --tools claude-code \ + --yes +``` + +Combinez avec des modules officiels : + +```bash +npx bmad-method install \ + --directory . \ + --modules bmm \ + --custom-source https://gitlab.com/myorg/my-module \ + --tools claude-code \ + --yes +``` + +:::note[Comportement des sources personnalisées] +Quand `--custom-source` est utilisé sans `--modules`, seuls le cœur et les modules personnalisés sont installés. Ajoutez `--modules` pour inclure également les modules officiels. Consultez [Installer des modules personnalisés et communautaires](./install-custom-modules.md) pour plus de détails. +::: + ## Ce que vous obtenez - Un répertoire `_bmad/` entièrement configuré dans votre projet diff --git a/docs/fr/how-to/project-context.md b/docs/fr/how-to/project-context.md index 4dc1067c3..e9e4d5210 100644 --- a/docs/fr/how-to/project-context.md +++ b/docs/fr/how-to/project-context.md @@ -2,7 +2,7 @@ title: "Gérer le contexte du projet" description: Créer et maintenir project-context.md pour guider les agents IA sidebar: - order: 8 + order: 9 --- Utilisez le fichier `project-context.md` pour garantir que les agents IA respectent les préférences techniques et les règles d'implémentation de votre projet tout au long des workflows. Pour vous assurer qu'il est toujours disponible, vous pouvez également ajouter la ligne `Le contexte et les conventions importantes du projet se trouvent dans [chemin vers le contexte du projet]/project-context.md` à votre fichier de contexte ou de règles permanentes (comme `AGENTS.md`). diff --git a/docs/fr/how-to/quick-fixes.md b/docs/fr/how-to/quick-fixes.md index 868b5df2e..152676bed 100644 --- a/docs/fr/how-to/quick-fixes.md +++ b/docs/fr/how-to/quick-fixes.md @@ -2,7 +2,7 @@ title: "Corrections Rapides" description: Comment effectuer des corrections rapides et des modifications ciblées sidebar: - order: 5 + order: 6 --- Utilisez **Quick Dev** pour les corrections de bugs, les refactorisations ou les petites modifications ciblées qui ne nécessitent pas la méthode BMad complète. diff --git a/docs/fr/how-to/shard-large-documents.md b/docs/fr/how-to/shard-large-documents.md index a23af0607..5b4fd05a0 100644 --- a/docs/fr/how-to/shard-large-documents.md +++ b/docs/fr/how-to/shard-large-documents.md @@ -2,7 +2,7 @@ title: "Guide de Division de Documents" description: Diviser les fichiers markdown volumineux en fichiers plus petits et organisés pour une meilleure gestion du contexte sidebar: - order: 9 + order: 10 --- Utilisez l'outil `bmad-shard-doc` si vous avez besoin de diviser des fichiers markdown volumineux en fichiers plus petits et organisés pour une meilleure gestion du contexte. diff --git a/docs/fr/how-to/upgrade-to-v6.md b/docs/fr/how-to/upgrade-to-v6.md index ba19211a1..2b5d89240 100644 --- a/docs/fr/how-to/upgrade-to-v6.md +++ b/docs/fr/how-to/upgrade-to-v6.md @@ -2,7 +2,7 @@ title: "Comment passer à la v6" description: Migrer de BMad v4 vers v6 sidebar: - order: 3 + order: 4 --- Utilisez l'installateur BMad pour passer de la v4 à la v6, qui inclut une détection automatique des installations existantes et une assistance à la migration.