alliance-boreale/docs/gouvernance/guide-utilisation-claude.md
Dan Allaire 28b7842ffb
Some checks are pending
CI / yaml-lint (push) Waiting to run
CI / ssot-export (push) Waiting to run
CI / tests (push) Waiting to run
CI / docs (push) Waiting to run
restructuration de la documentation
2025-10-24 10:54:37 -04:00

22 KiB

Guide d'Utilisation de Claude

Exploiter le Conseiller Stratégique au Maximum

Version : 1.0
Date : 20 octobre 2025
Public : Daniel Mathieu (Président) + Équipe L'Alliance Boréale
Prérequis : Avoir lu le Pacte de Collaboration Stratégique v1.1


🎯 Objectif de ce Guide

Te donner les recettes concrètes pour :

  1. Tirer le maximum de Claude en minimum de temps
  2. Savoir quel mode utiliser dans quelle situation
  3. Formuler des demandes qui donnent les meilleurs résultats
  4. Éviter les pièges et optimiser chaque session

Temps de lecture : 15 minutes
ROI : Multiplier ton efficacité par 5x dès la première semaine


📋 PARTIE 1 : Les Bases

1.1 Démarrer une Nouvelle Conversation

À chaque nouvelle conversation avec Claude, commence par :

Claude, active le mode Conseiller Stratégique selon le Pacte v1.1.

MODE: [Sprint/Stratégie/Exécution/Réflexion]
CONTEXTE: [1-2 phrases sur où tu en es]
OBJECTIF: [Ce que tu veux accomplir]
QUESTION: [Ta question principale]

Exemple réel :

Claude, active le mode Conseiller Stratégique selon le Pacte v1.1.

MODE: Sprint
CONTEXTE: Le tunnel WireGuard vers TechnoLibre est down depuis 10 min
OBJECTIF: Rétablir la connexion immédiatement
QUESTION: Procédure de diagnostic et résolution ?

⏱️ Durée : 30 secondes à écrire, gain 10-30 minutes sur la qualité de ma réponse.


1.2 Les 4 Modes : Quand Utiliser Lequel ?

Situation Mode à Utiliser Durée Attendue Format Réponse
Problème urgent, besoin réponse rapide Sprint 5-10 min 3-5 points, direct
Décision importante, besoin analyse Stratégie 30-60 min Scénarios, pros/cons
Besoin document/code prêt à l'emploi Exécution 10-20 min Artifact utilisable
Doute éthique, besoin de réflexion Réflexion 30-90 min Questions socratiques

Règle d'or : Si tu hésites, commence par Sprint pour une première réponse, puis PIVOT vers un autre mode si nécessaire.


1.3 Commandes Magiques

Tu peux interrompre/rediriger à tout moment :

Commande Effet Quand l'Utiliser
STOP. Tu dérives du pacte. Je m'arrête, relis les instructions, reformule Quand je ne respecte pas le cadre
PIVOT. Passe en mode [X]. Je change de mode immédiatement Quand tu réalises qu'un autre mode serait mieux
Trop détaillé, synthétise. Je condense ma réponse Quand je suis trop verbeux
Pas assez approfondi, creuse. Je développe davantage Quand ma réponse manque de profondeur
Continue Je poursuis là où je me suis arrêté Quand ma réponse est tronquée

Exemple d'usage :

[Je commence à répondre en mode Stratégie, mais c'est trop long]

Toi: "PIVOT. Passe en mode Sprint."
Moi: "Compris, mode Sprint activé. Synthèse en 3 points..."

🚀 PARTIE 2 : Cas d'Usage par Situation

2.1 Lundi Matin — Point Stratégique Hebdo

Objectif : Démarrer la semaine avec clarté sur tes priorités.

Template à utiliser :

Claude, active le mode Conseiller Stratégique.

MODE: Stratégie
RITUEL: Point stratégique hebdo
CONTEXTE: Semaine du [date]
QUESTION: Quelles sont mes 3 priorités cette semaine pour L'Alliance Boréale ?

Ce que je ferai :

  1. Recherche dans le knowledge project (état actuel)
  2. Analyse des échéances imminentes
  3. Proposition de 3 priorités avec Impact/Effort
  4. Actions concrètes pour chaque priorité

Durée : 10-15 minutes
ROI : Clarté totale pour ta semaine


2.2 Problème Technique Urgent

Objectif : Débloquer une situation critique rapidement.

Template à utiliser :

MODE: Sprint
CONTEXTE: [Description du problème en 1 phrase]
QUESTION: Procédure de résolution immédiate ?
DEADLINE: Maintenant

Exemple concret :

MODE: Sprint
CONTEXTE: PostgreSQL sur ns1.chezlepro.ca ne répond plus, PowerDNS est down
QUESTION: Procédure de diagnostic et redémarrage ?
DEADLINE: Maintenant

Ce que je ferai :

  • Checklist de diagnostic (5 étapes max)
  • Action immédiate recommandée
  • Note pour éviter le problème futur

Durée : 5 minutes
ROI : Résolution 10x plus rapide


2.3 Génération de Document Important

Objectif : Créer un document de qualité professionnelle.

Template à utiliser :

MODE: Exécution
TYPE: [Document/Code/Analyse]
SPÉCIFICATIONS:
- [Critère 1]
- [Critère 2]
- [Critère 3]
FORMAT: [Markdown/YAML/Python/etc.]
USAGE: [À quoi servira ce document]
VALIDATION REQUISE PAR: [Expert qui doit le relire]

Exemple concret :

MODE: Exécution
TYPE: Document
SPÉCIFICATIONS:
- Politique de sécurité pour L'Alliance Boréale
- Conforme Loi 25 et RGPD
- Sections : Gouvernance, Incidents, Accès, Données
- Ton : Formel mais accessible
FORMAT: Markdown
USAGE: Publication sur le site de L'Alliance
VALIDATION REQUISE PAR: Avocat OBNL + Architecte sécurité

Ce que je ferai :

  • Document complet en artifact
  • Avertissement "DRAFT - Validation requise"
  • Checklist de ce qu'il faut valider

Durée : 15-30 minutes
ROI : Gain 4-8 heures de rédaction


2.4 Décision Stratégique Complexe

Objectif : Prendre une décision éclairée sur un sujet difficile.

Template à utiliser :

MODE: Stratégie
CONTEXTE: [Situation actuelle, 1 paragraphe]
OBJECTIF: [Décision à prendre]
QUESTIONS:
1. [Question stratégique 1]
2. [Question stratégique 2]
3. [Question stratégique 3]
CONTRAINTES: [Budget, délais, ressources]
VALIDATION: [Qui validera cette décision avec toi]

Exemple concret :

MODE: Stratégie
CONTEXTE: L'Alliance a 5 membres actifs. Un potentiel 6e membre 
(grosse entreprise) demande des conditions spéciales (réduction 
cotisation, pas d'audit public). Ça apporterait 50k$/an mais 
pourrait créer un précédent.
OBJECTIF: Décider si on accepte ou refuse
QUESTIONS:
1. Quels sont les risques de créer un précédent ?
2. Comment structure-t-on des "exceptions justifiées" sans ouvrir 
   la porte à tout le monde ?
3. Alternatives pour bénéficier de leur participation sans 
   compromettre nos principes ?
CONTRAINTES: Budget serré, besoin de revenus, mais intégrité essentielle
VALIDATION: Cercle Stratégique

Ce que je ferai :

  1. Analyse multi-critères des options
  2. Scénarios avec pros/cons
  3. Évaluation risques vs bénéfices
  4. Recommandation argumentée
  5. Liste des personnes à consulter

Durée : 45-60 minutes
ROI : Décision 10x mieux éclairée


2.5 Dilemme Éthique (Couche 8)

Objectif : Explorer une tension entre valeurs et réalité.

Template à utiliser :

MODE: Réflexion
QUESTIONNEMENT: [Le doute, la tension]
CONTEXTE: [Situation qui génère cette question]
VALEURS EN JEU: [Quelles valeurs semblent en conflit]
CE QUE J'AI DÉJÀ EXPLORÉ: [Tes réflexions initiales]

Exemple concret :

MODE: Réflexion
QUESTIONNEMENT: On prône la sobriété, mais pour avoir de l'impact, 
on doit grandir. Comment équilibrer croissance et sobriété sans 
se trahir ?
CONTEXTE: L'Alliance pourrait passer de 5 à 50 membres en 2 ans 
si on "pousse" le marketing. Mais ça nécessite plus de ressources, 
plus de serveurs, plus d'énergie.
VALEURS EN JEU: Sobriété vs Impact vs Viabilité économique
CE QUE J'AI DÉJÀ EXPLORÉ: 
- Croissance organique lente : moins d'impact, mais aligné
- Croissance rapide : plus d'impact, mais risque de dérive

Ce que je ferai :

  • Questions socratiques pour approfondir
  • Exploration des implications
  • Pas de réponse imposée
  • T'aider à structurer TA réflexion

Durée : 30-90 minutes
ROI : Clarté philosophique, alignement valeurs/actions


2.6 Révision de Code / Playbook Ansible

Objectif : Obtenir une revue technique de qualité.

Template à utiliser :

MODE: Exécution
TYPE: Revue de code
SPÉCIFICATIONS:
- [Fichier ou snippet à réviser]
- Focus : [Sécurité/Performance/Maintenabilité/etc.]
- Niveau critique : [Production/Test/Expérimental]
FORMAT: Commentaires + Version améliorée

Exemple concret :

MODE: Exécution
TYPE: Revue playbook Ansible
SPÉCIFICATIONS:
- Playbook : deploy-powerdns.yml
- Focus : Sécurité + Idempotence
- Niveau critique : Production (déploiement sur tous les membres)
FORMAT: Commentaires ligne par ligne + Version optimisée

[Coller ton playbook ici]

Ce que je ferai :

  • Analyse sécurité (credentials, privilèges, etc.)
  • Vérification idempotence
  • Suggestions d'amélioration
  • Version optimisée en artifact

Durée : 15-30 minutes
ROI : Éviter bugs critiques en prod


2.7 Recherche de Solutions Techniques

Objectif : Trouver la meilleure solution pour un besoin technique.

Template à utiliser :

MODE: Stratégie
CONTEXTE: [Besoin technique à résoudre]
OBJECTIF: Identifier la meilleure solution
QUESTIONS:
1. Quelles sont les 3 meilleures alternatives ?
2. Comparaison pros/cons/coûts/maturité
3. Quelle est ta recommandation ?
CONTRAINTES: [Logiciels libres, budget, compétences équipe]

Exemple concret :

MODE: Stratégie
CONTEXTE: On a besoin d'un système de monitoring distribué pour 
L'Alliance (15 membres potentiels, chacun avec son Proxmox).
OBJECTIF: Identifier la meilleure solution de monitoring
QUESTIONS:
1. Quelles sont les 3 meilleures alternatives open source ?
2. Comparaison : scalabilité, complexité, ressources nécessaires
3. Laquelle recommandes-tu pour notre cas ?
CONTRAINTES: 
- Logiciel libre obligatoire
- Doit supporter architecture fédérée
- Équipe 3 personnes (compétences Linux/Docker)

Ce que je ferai :

  1. Recherche web des alternatives
  2. Benchmark détaillé
  3. Matrice de décision
  4. Recommandation avec justification

Durée : 30-45 minutes
ROI : Choix technique optimal dès le départ


2.8 Préparation d'une Présentation

Objectif : Créer une présentation percutante rapidement.

Template à utiliser :

MODE: Exécution
TYPE: Présentation
SPÉCIFICATIONS:
- Sujet : [Thème de la présentation]
- Public : [Qui va écouter]
- Durée : [10 min / 30 min / etc.]
- Objectif : [Informer/Convaincre/Former]
- Ton : [Formel/Casual/Inspirant]
FORMAT: Structure + Points clés (pas slides complets)

Exemple concret :

MODE: Exécution
TYPE: Présentation
SPÉCIFICATIONS:
- Sujet : Pitch de L'Alliance Boréale
- Public : Investisseurs impact potentiels
- Durée : 15 minutes
- Objectif : Convaincre d'investir 250k$
- Ton : Inspirant mais crédible (vision + preuves)
FORMAT: Structure narrative + Points clés par slide

Ce que je ferai :

  • Structure narrative en 5-7 sections
  • Points clés pour chaque slide
  • Messages à retenir
  • Anticipation objections

Durée : 20-30 minutes
ROI : Présentation 5x plus percutante


🎯 PARTIE 3 : Techniques Avancées

3.1 Chaîner les Modes (Sessions Longues)

Pour les projets complexes, tu peux enchaîner plusieurs modes :

Exemple : Lancer un nouveau service dans L'Alliance

[Début de conversation]

MODE: Stratégie
Analyse : faut-il lancer un service de backup mutualisé entre membres ?

[J'analyse, je réponds]

PIVOT. Passe en mode Exécution.
Génère le document de spécification technique du service.

[Je génère]

PIVOT. Passe en mode Réflexion.
Est-ce que ce service est aligné avec notre philosophie de sobriété ?

[J'explore avec toi]

PIVOT. Passe en mode Exécution.
Rédige l'annonce du service pour la communauté.

[Je rédige]

Durée totale : 2-3 heures
ROI : Projet complet de A à Z, bien pensé


3.2 Utiliser les Conversations Passées

Si tu te rappelles avoir déjà discuté d'un sujet avec moi :

Claude, recherche dans nos conversations passées : 
[mots-clés du sujet]

Puis active le mode Conseiller Stratégique.
MODE: Stratégie
CONTEXTE: On avait discuté de [sujet], où en sommes-nous ?

Je ferai :

  1. conversation_search pour retrouver la conversation
  2. Synthèse de ce qu'on avait dit
  3. Analyse de l'évolution depuis

Durée : 10 minutes
ROI : Continuité parfaite entre sessions


3.3 Mode "Co-Rédaction" (Itératif)

Pour les documents importants, procède par itérations :

MODE: Exécution
Génère la V1 de la Charte de L'Alliance Boréale.

[Je génère V1]

Bien. Maintenant améliore la section 2 en ajoutant [précision].

[Je génère V1.1]

Parfait. Change le ton de l'introduction pour le rendre plus inspirant.

[Je génère V1.2]

Excellent. Version finale validée.

Durée : 30-60 minutes
ROI : Document parfaitement ajusté à ta vision


3.4 Déléguer la Recherche Web

Quand tu as besoin d'info récente :

MODE: Sprint
Recherche web : quelles sont les meilleures pratiques 2025 pour 
sécuriser PowerDNS en environnement multi-tenant ?

Je ferai :

  1. Recherche web active
  2. Synthèse des sources pertinentes
  3. Recommandations actionnables
  4. Citations des sources

Durée : 5-10 minutes
ROI : Veille techno automatisée


3.5 Valider une Décision Déjà Prise

Si tu as pris une décision et veux un "second avis" :

MODE: Stratégie
On a décidé de [décision]. Peux-tu identifier :
1. Les risques qu'on n'aurait pas vus
2. Les implications à long terme
3. Ce qu'il faut préparer pour l'exécution

Je ne remettrai PAS en question ta décision, mais je t'aiderai à l'exécuter au mieux.

Durée : 15-30 minutes
ROI : Exécution 2x plus solide


PARTIE 4 : Gagner du Temps

4.1 Raccourcis pour les Demandes Fréquentes

Si tu fais souvent les mêmes types de demandes, crée des "alias" :

Exemples :

Alias Signifie
Hebdo Point stratégique hebdomadaire
Debug [problème] Mode Sprint pour résolution urgente
Doc [sujet] Mode Exécution pour générer un document
Dilemme [question] Mode Réflexion pour exploration éthique
Benchmark [techno] Mode Stratégie pour comparaison solutions

Usage :

Claude, mode Conseiller Stratégique.
Hebdo

Je comprendrai que c'est le point hebdomadaire.


4.2 Préparer des "Packs de Questions"

Pour les revues mensuelles/trimestrielles, prépare un template :

Fichier : templates/revue-mensuelle.md

MODE: Stratégie
RITUEL: Revue mensuelle L'Alliance Boréale

Analyse :
1. État des 8 couches (santé de chaque couche)
2. Indicateurs clés : membres, conformité, finance
3. Blocages majeurs du mois
4. Opportunités identifiées
5. Auto-évaluation dépendance Claude
6. 3 priorités pour le mois prochain

Usage : Copier-coller ce template chaque mois.

Durée : 5 secondes pour lancer, 45 min pour la revue
ROI : Routine installée, rien n'est oublié


4.3 Utiliser les Artifacts pour Réutilisation

Quand je génère un artifact (document, code), tu peux :

  1. Le télécharger (bouton dans l'interface)
  2. Le commiter dans Git (versioning automatique)
  3. Le réutiliser dans une future conversation :
MODE: Exécution
Améliore le document [nom] que tu m'as généré la semaine dernière.
Ajoute une section sur [nouveau sujet].

[Coller le contenu de l'artifact]

ROI : Travail itératif, pas de repartir de zéro


🚨 PARTIE 5 : Éviter les Pièges

5.1 Piège #1 : Me Consulter Pour TOUT

Symptôme : Tu me poses 20 questions par jour sur des décisions mineures.

Solution :

  • Utilise la règle 10-10-10 : Cette décision aura-t-elle un impact dans 10 minutes, 10 mois, 10 ans ?
    • Si seulement 10 minutes → Décide seul
    • Si 10 mois ou 10 ans → Consulte-moi

Rappel automatique :
Si je détecte une sur-consultation, je te le dirai lors de la revue mensuelle.


5.2 Piège #2 : Ne Pas Valider Mes Livrables

Symptôme : Tu utilises directement mes documents sans les faire relire.

Solution :

  • TOUJOURS faire valider par un humain compétent :
    • Document juridique → Avocat
    • Code critique → Dev senior
    • Stratégie financière → Comptable/CFO

Rappel dans mes réponses :
Je mets systématiquement : ⚠️ VALIDATION REQUISE PAR [expert]


5.3 Piège #3 : Demandes Trop Vagues

Symptôme : "Claude, aide-moi avec L'Alliance."

Problème : Je ne sais pas par où commencer, je vais te poser 10 questions de clarification.

Solution : Utilise TOUJOURS les templates de ce guide avec :

  • MODE explicite
  • CONTEXTE clair
  • OBJECTIF précis
  • QUESTIONS spécifiques

Avant : "Claude, aide-moi avec le recrutement."
Après :

MODE: Stratégie
CONTEXTE: On doit recruter un DevOps d'ici 3 mois
OBJECTIF: Définir le processus de recrutement
QUESTIONS:
1. Où publier l'offre (Québec) ?
2. Grille d'évaluation technique ?
3. Process d'entrevue optimal ?

5.4 Piège #4 : Oublier le Knowledge Project

Symptôme : Tu me poses une question dont la réponse est dans tes docs.

Solution : Fais-moi confiance, je vais TOUJOURS chercher dans le knowledge project avant de répondre (c'est dans mes instructions permanentes).

Mais tu peux me le rappeler si j'oublie :

STOP. Tu n'as pas cherché dans le knowledge project.
Cherche d'abord, puis réponds.

5.5 Piège #5 : Accepter Mes Recommandations Sans Réfléchir

Symptôme : "Claude l'a dit, donc c'est vrai."

Solution : Je suis un outil d'aide à la décision, pas un oracle.

Réflexes à avoir :

  • Challenge mes recommandations
  • Demande-moi : "Quels sont les trous dans ton analyse ?"
  • Consulte d'autres humains
  • Fais confiance à ton instinct si ça ne résonne pas

📊 PARTIE 6 : Mesurer Ton Efficacité

6.1 Indicateurs de Bonne Utilisation

Signe que tu utilises Claude bien :

  • Tu obtiens des réponses actionnables en <10 min (mode Sprint)
  • Tes décisions stratégiques sont mieux documentées
  • Tu génères des documents de qualité en 30 min vs 4h avant
  • Tu prends des décisions importantes AVEC validation humaine
  • Tu ne me consultes PAS pour tout

Signe que tu dépends trop de moi :

  • Tu me consultes >10 fois par jour
  • Tu ne prends plus de décisions sans moi
  • Ton équipe attend "ce que Claude va dire"
  • Tu utilises mes livrables sans les valider

Auto-évaluation mensuelle :

MODE: Réflexion
Auto-évaluation : ce mois, ai-je bien utilisé Claude ?
- Combien de consultations ?
- Combien de décisions prises seul ?
- Qualité des livrables validés ?

6.2 ROI Attendu (Après 1 Mois d'Usage)

Gains mesurables :

  • ⏱️ Temps gagné : 10-15 heures/semaine
  • 📊 Qualité décisions : +50% de documentation
  • 📝 Production contenu : 3x plus rapide
  • 🎯 Clarté stratégique : +80% (perception subjective)

Test simple :
Compare une semaine AVEC Claude vs une semaine SANS Claude.
Tu devrais sentir la différence immédiatement.


🎓 PARTIE 7 : Pour Ton Équipe

7.1 Former un Nouveau Membre à Utiliser Claude

Étapes d'onboarding :

  1. Lecture (30 min) :

    • Pacte de Collaboration Stratégique
    • Ce guide d'utilisation
  2. Premier test (15 min) :

Claude, active le mode Conseiller Stratégique.
MODE: Sprint
CONTEXTE: Je découvre L'Alliance Boréale
QUESTION: Quels sont les 3 documents clés à lire pour comprendre le projet ?
  1. Première mission réelle (1 heure) :

    • Choisir un cas d'usage de la Partie 2
    • Exécuter avec Claude
    • Valider le résultat avec un collègue
  2. Feedback (15 min) :

    • Qu'est-ce qui a bien marché ?
    • Qu'est-ce qui était confus ?
    • Ajustements nécessaires ?

7.2 Adapter le Prompt à Chaque Rôle

Chaque membre de l'équipe peut ajouter son contexte spécifique :

Exemple pour un CTO :

Claude, active le mode Conseiller Stratégique.

Je suis [Nom], CTO de L'Alliance Boréale.
Mes priorités :
- Architecture Proxmox/Ceph/DNS
- Sécurité et conformité
- Automatisation Ansible

[Ensuite, la demande normale avec MODE/CONTEXTE/etc.]

Exemple pour un Community Manager :

Claude, active le mode Conseiller Stratégique.

Je suis [Nom], Community Manager de L'Alliance Boréale.
Mes priorités :
- Animation communauté (Matrix, forums)
- Communication externe
- Onboarding nouveaux membres

[Ensuite, la demande normale]

🎯 PARTIE 8 : Cas d'Usage par Rôle

8.1 Tu es Président → Tes Cas d'Usage Fréquents

  1. Lundi matin : Point stratégique hebdo
  2. Fin de mois : Revue mensuelle
  3. Décision majeure : Mode Stratégie avec analyse multi-critères
  4. Dilemme éthique : Mode Réflexion (couche 8)
  5. Présentation investisseurs : Mode Exécution (pitch deck)
  6. Arbitrage conflits : Mode Réflexion (exploration implications)

8.2 Si Tu Étais CTO → Tes Cas d'Usage Fréquents

  1. Revue architecture : Mode Stratégie (validation choix techniques)
  2. Debugging urgent : Mode Sprint (résolution rapide)
  3. Revue code/playbooks : Mode Exécution (analyse sécurité/qualité)
  4. Benchmark technos : Mode Stratégie (comparaison solutions)
  5. Documentation technique : Mode Exécution (génération guides)
  6. Veille techno : Mode Sprint (recherche web + synthèse)

8.3 Si Tu Étais Community Manager → Tes Cas d'Usage Fréquents

  1. Création contenu : Mode Exécution (articles, posts, guides)
  2. Stratégie communication : Mode Stratégie (plan 3-6 mois)
  3. Templates emails : Mode Exécution (onboarding, newsletters)
  4. Gestion crise : Mode Sprint (réponse rapide)
  5. Analyse sentiment : Mode Stratégie (feedback communauté)
  6. Formation membres : Mode Exécution (tutoriels, vidéos scripts)

CHECKLIST FINALE

Avant chaque session avec Claude :

  • J'ai défini le MODE (Sprint/Stratégie/Exécution/Réflexion)
  • J'ai préparé le CONTEXTE (1-2 phrases)
  • J'ai défini l'OBJECTIF (ce que je veux accomplir)
  • J'ai des QUESTIONS précises
  • Je sais QUI devra valider le résultat (si livrable)

**