Bonnes pratiques

Donner du contexte

Claude Code est très efficace quand tu lui donnes du contexte précis. Plus c’est précis, plus la réponse est juste.

❌ Peu efficace :

"Le site marche pas"

✅ Efficace :

"https://kamctrl.levell.cloud retourne une page blanche sans CSS depuis
ce matin. Le container tourne (j'ai vérifié avec docker ps). Voici
l'erreur dans la console navigateur : Mixed Content blocked"

Utiliser context.md comme référence

Le fichier .lab_tracking/context.md est la source de vérité pour toutes les informations critiques (tokens, URLs, IDs). Si Claude Code te demande un token ou une URL, vérifie d’abord qu’il n’est pas déjà dans ce fichier.

Vérifier avant de confirmer

Quand Claude Code propose une modification de code, lis-la avant de confirmer. Tu peux dire :

"Montre-moi le diff avant d'appliquer"
"Explique pourquoi tu fais ce changement"

Ne pas interrompre les opérations longues

Certaines opérations prennent du temps (rebuild Docker, transfert de fichiers, etc.). Claude Code utilise des outils de monitoring en arrière-plan pour attendre. N’interromps pas avec Ctrl+C sauf si tu sais exactement ce que tu fais.

Corriger le comportement de Claude

Si Claude Code fait quelque chose que tu ne veux pas, dis-le directement :

"Non, ne fais pas ça comme ça"
"Arrête d'ajouter des commentaires dans le code"
"Je préfère que tu me demandes confirmation avant de pousser sur GitHub"

Il mémorise ces préférences pour les sessions futures (fichier feedback_xxx.md dans sa mémoire).

Pour les stagiaires : par où commencer ?

Première session

1. Lis cette documentation complète avant de commencer
2. Lis .lab_tracking/context.md pour connaître les accès
3. Relis les 10 dernières entrées de .lab_tracking/journal.md pour savoir où en est le projet
4. Démarre Claude Code et dis-lui ce que tu dois faire

Tâches typiques pour un stagiaire

Tâche	Niveau
Modifier du contenu HTML/CSS (diary, suivi)	⭐ Débutant
Ajouter un endpoint Laravel (kamctrl)	⭐⭐ Intermédiaire
Modifier un workflow n8n	⭐⭐⭐ Avancé
Déployer un nouveau service Docker	⭐⭐⭐ Avancé

Questions à poser à Claude Code

"Explique-moi comment fonctionne le workflow WF-B en détail"

"Montre-moi où est défini le modèle Reservation dans kamctrl"

"Quelles sont les dernières actions effectuées sur ce serveur ?"

"Qu'est-ce qui se passe si je lance docker compose down sur n8n ?"

Limites à connaître

Limitation	Contournement
Ne peut pas accéder à des URLs externes sans les outils WebFetch	Lui donner le contenu directement
Ne peut pas voir l’interface graphique d’un navigateur	Lui décrire ce qu’on voit, ou lui donner les logs
La session a une limite de contexte	/compact pour comprimer, ou démarrer une nouvelle session
Ne se souvient pas de la session précédente sans la mémoire	La mémoire persistante couvre les infos importantes

Sécurité

• Ne jamais partager les screenshots du terminal contenant des tokens
• Ne jamais dire à Claude Code de commiter des fichiers .env
• Si Claude Code suggère --no-verify sur un git commit, demander pourquoi avant d’accepter
• Toute suppression de container ou de volume doit être confirmée explicitement