Foreman

Foreman / Installer

Installez Foreman.

Un dossier de fichiers Markdown. Rien à compiler ni à exécuter : Foreman s’installe partout où un agent lit des fichiers.

Votre agent + Foreman
foreman/
  SKILL.md
  toolbelt/
  templates/

01  Read the playbook
02  Describe your project
03  Review the brief
04  Build with your agent

Claude Code

Les deux lignes, dans cet ordre. Cela ajoute le playbook et ses quatre outils sous forme de commandes slash.

/plugin marketplace add Turki-Sh/Foreman
/plugin install foreman@alshuaibi

Si votre interface Claude Code ne prend pas en charge /plugin, exécutez ces commandes dans votre shell, puis démarrez une nouvelle session.

claude plugin marketplace add Turki-Sh/Foreman
claude plugin install foreman@alshuaibi

Mettre à jour ou supprimer

Mise à jour depuis votre shell :

claude plugin marketplace update alshuaibi
claude plugin update foreman@alshuaibi
/plugin uninstall foreman@alshuaibi

Utilisez-le avec votre équipe.

Facultatif, pour les projets dans lesquels Foreman fait partie du flux de travail partagé.

Depuis le répertoire du projet, exécutez :

claude plugin marketplace add Turki-Sh/Foreman
claude plugin install foreman@alshuaibi --scope project

Ceci enregistre Foreman dans .claude/settings.json:

{
  "enabledPlugins": {
    "foreman@alshuaibi": true
  }
}

Conservez les paramètres existants et les autres plugins. Vérifiez le diff, puis committez le fichier pour partager la configuration. Chaque collaborateur doit encore exécuter les deux commandes une fois sur sa machine. Le commit des paramètres ne télécharge pas le plugin à sa place.

Pour un usage personnel, gardez l’installation par défaut au niveau utilisateur. Le partage est facultatif et fonctionne aussi dans les dépôts privés. N’incluez pas d’identifiants ni de réglages personnels dans le fichier partagé.

Étendues de l'installation · Paramètres partagés

Applications Claude

Télécharger foreman.skill puis importez-le dans les paramètres des skills. Il contient les modes et les quatre outils. Demandez un outil avec vos propres mots, par exemple « lance Punch list sur mon site ».

Tous les autres agents

Cursor, Windsurf, Codex, Copilot, Gemini CLI, Cline, ou tout agent lisant des skills ou des règles. Un seul dossier à copier.

git clone https://github.com/Turki-Sh/Foreman.git
cp -r Foreman/plugins/foreman/skills/foreman ~/.agents/skills/
OutilOù va le dossier
Répertoire universel des skills~/.agents/skills/foreman/
Cursor~/.cursor/rules/, ou .cursor/rules/ dans le projet
Codex~/.codex/skills/foreman/, ou référencez-le à partir de AGENTS.md
GitHub Copilot.github/copilot-instructions.md, ou pointez-le vers SKILL.md
Windsurf.windsurfrules, ou le répertoire des règles de l’espace de travail
Gemini CLIGEMINI.md, ou le répertoire des extensions
Cline, Continue, RooLe champ d'instructions ou de règles personnalisées

Les chemins évoluent avec les outils. La règle qui reste valable : placez SKILL.md là où votre outil lit ses instructions permanentes, et gardez references/, toolbelt/ et assets/ à côté. AGENTS.md contient le tableau à jour.

Un chat sans prise en charge des skills

Collez SKILL.md dans la conversation et dites « guide-moi avec cette méthode ». Les étapes, modes et validations fonctionnent à partir de ce seul fichier. Les références apportent des précisions.

Vérifiez qu'il est chargé

Dites aide-moi à créer mon portfolio. La première réponse est cette carte, sans rien après. Si l’agent commence à écrire du HTML, Foreman n’a pas été chargé.

         _____ ___  ____  _____ __  __    _    _   _
        |  ___/ _ \|  _ \| ____|  \/  |  / \  | \ | |
        | |_ | | | | |_) |  _| | |\/| | / _ \ |  \| |
        |  _|| |_| |  _ <| |___| |  | |/ ___ \| |\  |
        |_|   \___/|_| \_\_____|_|  |_/_/   \_\_| \_|

+--------------------------------------------------------------+
|                                                              |
|                        _______________                       |
|                    ___/               \___                   |
|                   /_________________________\                |
|                   \_________________________/                |
|                      |  .---.     .---.  |                   |
|                      |  | O |-----| O |  |                   |
|                      |  '---'     '---'  |                   |
|                      |         v         |                   |
|                      |     ~~~~~~~~~     |                   |
|                       \_________________/                    |
|                                                              |
|   PLAYBOOK  Foreman 3.0.1 by Turki Alshuaibi                 |
|   STATUS    Step 1 of 8 . Orient                             |
|   METHOD    Decide > Look > Brief > Build > Verify > Ship    |
|   MODE      Blueprint. Say survey or stress test to switch   |
|   RULE      No site code until you sign off the brief        |
|                                                              |
+--------------------------------------------------------------+
|   What are you building, and what do you already have?       |
+--------------------------------------------------------------+

Questions

Est-ce qu'il exécute quelque chose sur ma machine ? Non. Foreman contient du Markdown et des modèles à remplir. Aucun script, hook, serveur MCP ni appel réseau. La CI échoue si l’un de ces éléments apparaît. Votre agent utilise ses propres outils, avec votre autorisation, comme d’habitude.

A-t-il besoin d'Internet ? Non. Survey et Board sont plus efficaces avec un accès web. Si votre agent ne peut pas naviguer, Foreman le signale en une phrase.

Avec quels modèles fonctionne-t-il ? Tout modèle compatible exécuté par votre agent. Les exécutions enregistrées sur ce site ont utilisé Claude Sonnet.

Combien ça coûte ? Rien. Licence MIT.