# humbleagents ![humbleagents](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/assets/humble-agents-hero.png) [English](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/README.md) · [Русский](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/README.ru.md) · [Čeština](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/README.cs.md) · [Français](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/README.fr.md) Un plugin de design pour Claude Code et Codex. Passez d’un brief à des écrans : explorez des pistes, construisez un design system, créez des prototypes et évaluez le résultat. Également disponible pour Gemini CLI et Cursor. ## Installation Il vous faut Node.js 20 ou 22 et npm 10. ```sh npm install --global @humbleteam/humbleagents@next --ignore-scripts ``` Créez un dossier pour le plugin et remplacez `/path/to/humbleagents` ci-dessous par son chemin complet. Choisissez les applications que vous utilisez : ```sh humbleagents install --location "/path/to/humbleagents" --profile core --runtime claude,codex --yes ``` **Claude Code** ```sh claude --plugin-dir "/path/to/humbleagents/runtimes/claude" ``` **Codex CLI** ```sh codex plugin marketplace add "/path/to/humbleagents" codex plugin add humbleagents@humbleagents-local ``` Ouvrez une nouvelle session dans votre projet. Dans Codex, si `/humble:*` n’apparaît pas dans le menu des commandes, sélectionnez le skill **humble** et saisissez la commande. Pour Gemini CLI, Cursor ou une installation depuis les sources, consultez le [guide d’installation](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/hosts-and-updates.md). ## Ce que vous pouvez faire - **Démarrer un projet.** Précisez les besoins et la direction créative à partir de vos notes et de votre brief. - **Concevoir une fonctionnalité.** Explorez des mises en page, définissez les composants et créez un prototype fonctionnel. - **Évaluer le travail.** Vérifiez les écrans et les parcours avant de les transmettre. - **Créer des visuels publicitaires.** Développez des concepts, générez des variantes et comparez-les. Les agents s’appuient sur des références de design communes ainsi que sur le brief, les décisions et le design system de votre projet. ## Commandes | Commande | Fonction | | --- | --- | | `/humble:setup` | Préparer le brief et la direction créative | | `/humble:canvas` | Explorer des pistes de design | | `/humble:design-system` | Définir les styles, les tokens et les composants | | `/humble:product` | Créer les écrans et les parcours du produit | | `/humble:review` | Évaluer une interface | | `/humble:references` | Trouver des références de design | | `/humble:ads` | Créer et évaluer des visuels publicitaires | | `/humble:improve` | Proposer des améliorations aux connaissances partagées | | `/humble:create` | Planifier un projet à partir du modèle de l’équipe | | `/humble:access` | Vérifier votre accès à un projet | | `/humble:agents` | Parcourir les workflows disponibles | | `/humble:doctor` | Vérifier l’installation et les connexions | | `/humble:help` | Afficher l’aide | ## Exemples Pour un [projet connecté](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/project-workspaces.md) nommé `bookshop` : ```text /humble:setup project=bookshop -- Définis les besoins d’une librairie en ligne à partir du brief. /humble:design-system project=bookshop -- Définis la typographie, les couleurs et les composants réutilisables. /humble:product project=bookshop -- Crée un parcours de commande avec le design system du projet. /humble:review project=bookshop -- Évalue le parcours de commande et propose des corrections aux principaux problèmes d’ergonomie. ``` Décrivez le résultat souhaité et joignez les fichiers, écrans ou liens utiles. ## Pour aller plus loin - **Projets :** chaque projet possède son propre dépôt GitHub. Installer le plugin public ne donne aucun accès aux projets privés ni le droit de créer des dépôts dans l’organisation de l’équipe. [Connecter un projet et synchroniser son contexte](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/project-workspaces.md). - **Connexions :** utilisez Gmail et Granola via les connexions MCP de votre application. Figma et Mobbin sont également facultatifs. [Configurer les connexions](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/project-workspaces.md). - **Mises à jour :** [mettre à jour, revenir à une version précédente ou modifier l’installation](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/hosts-and-updates.md). Terminez la tâche en cours avant de mettre à jour. - **Dépannage :** lancez `/humble:doctor`. Consultez les [environnements pris en charge et les limitations connues](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/verification.md). ## Désinstallation Avec la configuration Claude Code ci-dessus, lancez Claude sans `--plugin-dir`. Pour Codex : ```sh codex plugin remove humbleagents@humbleagents-local ``` Supprimez ensuite les fichiers installés et la CLI : ```sh humbleagents uninstall --location "/path/to/humbleagents" --yes npm uninstall --global @humbleteam/humbleagents ``` Les données des projets sont conservées séparément du plugin. [Détails de désinstallation](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/hosts-and-updates.md#uninstall). ## Contribuer Ouvrez une issue ou envoyez une pull request portant sur un changement précis. Utilisez `/humble:improve` pour proposer des améliorations aux connaissances partagées en design. N’incluez pas de données clients ni d’identifiants d’accès dans vos contributions. Pour modifier le code, installez les dépendances et lancez les tests : ```sh npm ci --prefix platform --ignore-scripts npm test --prefix platform ``` [Instructions de développement et de publication](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/publication.md) · [Mentions relatives aux tiers](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/THIRD_PARTY_NOTICES.md)