gh-atournayre-claude-marketplace-dev/commands/docker.md

allowed-tools, description, model

allowed-tools	description	model
Bash Read Grep Glob	Indique d'utiliser docker pour faire la ou les actions définies dans le prompt	claude-sonnet-4-5-20250929

Contexte Docker

Active le mode Docker pour exécuter toutes les actions dans des conteneurs Docker plutôt que directement sur l'hôte.

Purpose

Cette commande active un contexte spécial où Claude utilisera systématiquement Docker pour :

• Exécuter des commandes système
• Builder des projets
• Lancer des tests
• Gérer les dépendances
• Toute autre opération technique

Variables

• DOCKER_COMPOSE_FILE: Fichier docker-compose à utiliser (défaut: docker-compose.yml)
• DOCKER_SERVICE: Service Docker à cibler pour les commandes (optionnel)
• DOCKER_ENV: Environnement Docker (dev/staging/prod, défaut: dev)

Relevant Files

• docker-compose.yml - Configuration Docker Compose
• Dockerfile - Définition des images
• .dockerignore - Fichiers exclus du build
• docker/ - Configurations Docker additionnelles

Workflow

Étape 1: Analyse de l'environnement Docker

• Détecter le fichier docker-compose.yml ou Dockerfile
• Identifier les services Docker disponibles
• Vérifier l'état des conteneurs (docker ps)
• Lister les services configurés

Étape 2: Validation de Docker

• Vérifier que Docker est installé et accessible
• Confirmer que les conteneurs nécessaires sont démarrés ou peuvent l'être
• Identifier le service principal si plusieurs services existent

Étape 3: Configuration du contexte

• Enregistrer le mode Docker comme actif pour la session
• Déterminer le préfixe de commande à utiliser :
  • docker exec [container] pour conteneurs running
  • docker-compose exec [service] pour docker-compose
  • docker run pour images standalone
• Mémoriser les paramètres pour les prochaines commandes

Étape 4: Rapport de configuration

• Afficher la configuration Docker détectée
• Confirmer le mode actif
• Indiquer comment les prochaines commandes seront exécutées

Instructions pour Claude

MODE DOCKER ACTIF

À partir de maintenant et jusqu'à nouvel ordre :

1. Toutes les commandes système doivent être exécutées via Docker

2. Format des commandes :

   • Avec Docker Compose : docker compose exec [service] [commande]
   • Sans Docker Compose : docker exec [container] [commande]
   • Pour les builds : docker compose build ou docker build

3. Exemples de transformation :

   # Au lieu de : composer install
   # Utiliser : docker compose exec php composer install
   
   # Au lieu de : npm run build
   # Utiliser : docker compose exec node npm run build
   
   # Au lieu de : php bin/console cache:clear
   # Utiliser : docker compose exec php php bin/console cache:clear
   

4. Services communs à identifier :

   • php / app - Application PHP
   • node / frontend - Build frontend
   • web / nginx - Serveur web
   • db / database - Base de données

5. Gestion des erreurs :

   • Si un conteneur n'est pas démarré → suggérer docker compose up -d
   • Si un service n'existe pas → lister les services disponibles
   • Si Docker n'est pas accessible → indiquer clairement l'erreur

6. Persistance du contexte :

   • Ce mode reste actif pour toute la session
   • Peut être désactivé avec une commande explicite de l'utilisateur
   • S'applique à toutes les opérations : build, test, deploy, etc.

Report

🐳 Mode Docker Activé

Configuration détectée :
- Fichier : [docker-compose.yml / Dockerfile]
- Services disponibles :
  • [service1] - [description]
  • [service2] - [description]
  • [service3] - [description]

État des conteneurs :
- [X] [service1] - Running
- [ ] [service2] - Stopped
- [X] [service3] - Running

Format des commandes :
docker compose exec [service] [commande]

Exemples :
• composer install → docker compose exec php composer install
• npm run build → docker compose exec node npm run build
• php bin/console → docker compose exec php php bin/console

ℹ️ Toutes les prochaines commandes système seront exécutées via Docker.

Examples

Activation basique

/docker

Avec projet Symfony + Docker Compose

🐳 Mode Docker Activé

Services disponibles : php, nginx, database, redis

Commandes transformées :
• composer install → docker compose exec php composer install
• symfony console cache:clear → docker compose exec php php bin/console cache:clear

Avec projet Node.js

🐳 Mode Docker Activé

Service : node

Commandes transformées :
• npm install → docker compose exec node npm install
• npm run dev → docker compose exec node npm run dev

Best Practices

• Toujours vérifier que Docker est accessible avant d'activer le mode
• Identifier le service principal pour les commandes fréquentes
• Proposer docker compose up -d si les conteneurs ne sont pas démarrés
• Conserver le contexte Docker pour toute la session une fois activé
• Adapter les commandes de manière transparente pour l'utilisateur
• En cas d'échec Docker, expliquer clairement la raison et la solution