---
type: doctrine
titre: "🛠️ LOI — Outils Claude & style d'utilisation"
dossier: 01_LOIS
etage: long
source: true        # SOURCE (autorite) - les projections (Chroma/graphe) en derivent
maj: 2026-05-20
hash: c04f0eed
---

> ⚠️ **OBSOLÈTE PARTIEL — audit 2026-05-13** : ce doc référence des ports morts (~~:9011~~ → :10001, ~~:9010~~ → :10001, etc.). Le seul port valide pour la sphère/cockpit est **:10001** (NEXUS). Mis à jour par 114-GAMEDIVINE. Voir `MNEMOSYNE/01_LOIS/DOCTRINE_PORTS_OLYMPUS.md`.

# 🛠️ LOI — Outils Claude & style d'utilisation

> **Cette loi prime sur l'envie d'écrire du code custom.**
> Quand un outil existe, on l'utilise. On ne réinvente pas.

---

## 🚨 Pourquoi cette loi existe

Vivien a observé une **dérive récurrente** : les chats Claude oublient les outils à disposition et **bricolent du code custom** quand un MCP, un endpoint AXIOM, ou un outil Claude natif aurait fait le même boulot en 1/10ᵉ du temps.

Conséquence : du code redondant, fragile, à maintenir.

---

## ✅ AXIOM-FIRST (= "GOD MOD" dans le langage de Vivien)

> Quand Vivien dit *"tu oublies le god mod"*, il veut dire : tu n'as pas pensé à utiliser AXIOM / le toolkit OLYMPUS en priorité.

**Avant d'écrire un script custom, vérifier dans cet ordre** :

1. **Existe-t-il un endpoint OLYMPUS** qui fait déjà ça ? → `GET /api/{tag}/...` (453 endpoints, 26 tags)
2. **Existe-t-il un module AXIOM** ? → `C:\OLYMPUS\01_SERVEUR\NEXUS\AXIOM\`
3. **Existe-t-il un MCP** branché ? → voir `.claude/connecteurs/` ou ToolSearch
4. **Existe-t-il un outil Claude natif** ? → liste ci-dessous
5. **Sinon seulement**, écrire du custom — et le ranger comme nouveau module AXIOM (pas un script perdu)

---

## 🧰 Outils Claude natifs principaux (à ne pas oublier)

### Lecture / écriture fichiers
- **`Read`** : lit un fichier (texte, image, PDF, notebook). Privilégier sur `cat`/`Get-Content`.
- **`Write`** : crée ou réécrit un fichier complet. **Toujours `Read` avant pour fichiers existants.**
- **`Edit`** : remplace une chaîne exacte dans un fichier. **Préféré à `Write` pour modifs ciblées.**

### Recherche
- **`Glob`** : cherche par nom de fichier (patterns `**/*.ts`).
- **`Grep`** : cherche par contenu (regex). **Toujours `Grep` plutôt que `grep` ou `rg` en Bash.**

### Exécution
- **`Bash`** : commandes shell. Préférer aux outils dédiés sauf si Read/Glob/Grep/Edit/Write font le boulot.
- **`PowerShell`** : pour Windows-spécifique uniquement.

### Délégation
- **`Agent`** : sous-tâche complexe (recherche multi-étapes, audit). Économise tokens.
- **`mcp__ccd_session__spawn_task`** : flagger une tâche hors-scope pour session séparée.

### Visuel (= IMPORTANT après chaque modif graphique)
- **`mcp__computer-use__screenshot`** : capture d'écran du PC entier (nécessite request_access)
- **`mcp__Claude_Preview__preview_start`** + `preview_screenshot` : pour dev servers NPM/etc. via launch.json (pas adapté à NEXUS qui tourne déjà sur ~~:10001~~ → :10001)
- **`mcp__Claude_in_Chrome__*`** : navigation web réelle — **nécessite extension "Claude in Chrome"** installée et un Chrome ouvert
- **Statut au 25/04/2026** : Chrome MCP testé via `list_connected_browsers` → aucun browser connecté. Si Vivien veut que je puisse capturer ZEUS automatiquement → installer l'extension Chrome.
- **Règle d'or** : après toute modif visuelle (HTML/CSS), **prendre une capture pour vérifier** avant de dire "c'est fait". Si pas d'outil dispo, **demander capture à Vivien explicitement** au lieu de prétendre savoir.

### MCP installés (à scanner via ToolSearch)
- Calendar, Gmail, Drive, Canva, Figma, Kubernetes, Microsoft Docs, etc.
- Liste complète : `ToolSearch(query: "*", max_results: 30)` ou regarder system-reminders.

---

## 🎯 Style d'utilisation préféré de Vivien

### ❌ À ne pas faire
- Écrire un script `.bat` custom quand un endpoint AXIOM existe
- Faire un `urllib.request` quand un client MCP est branché
- Coder un parser HTML quand BeautifulSoup ou un module existe
- Créer un nouveau fichier de config quand un dossier MNEMOSYNE convient
- **Modifier un visuel sans vérifier le rendu** → cause de "doublons / incohérences" qu'il faut détecter à l'œil

### ✅ À faire
- **Toujours commencer par `Glob` + `Grep`** pour vérifier ce qui existe déjà
- **Réutiliser les patterns standards** (Linear, Stripe, Figma, Notion) — ne pas inventer
- **Capture d'écran après modif graphique** — détecte les bugs visuels invisibles dans le code
- **Ranger comme module AXIOM** tout nouveau code Python qui sert plusieurs fois
- **Documenter dans MNEMOSYNE** les nouveaux concepts (rôles, conventions, doctrines)

---

## 🔍 Workflow de vérification visuelle après modif graphique

Quand tu modifies du HTML/CSS qui change l'apparence :

1. **Faire la modif**
2. **Prendre une capture** via `mcp__Claude_Preview__preview_start` (URL = page modifiée)
3. **Examiner la capture** (Claude est multi-modal, il *voit* le rendu)
4. **Détecter** : doublons visuels · incohérences · alignements cassés · couleurs qui jurent · texte coupé
5. **Auto-corriger** si détecté
6. **Re-capturer** pour valider
7. **Seulement alors** dire "c'est fait" à Vivien

---

## 🧠 Capacités Claude que Vivien apprécie

- **Multi-modal** : peut analyser images, captures d'écran, schémas
- **Web search** : trouve des patterns standards récents
- **Web fetch** : peut lire de la doc en ligne avant de coder
- **Tool search** : `ToolSearch` permet de découvrir les outils disponibles dans la session courante

---

## 📋 Checklist avant de dire "c'est fait"

- [ ] J'ai utilisé les outils dédiés (pas `cat`/`grep` en Bash) ?
- [ ] J'ai cherché si ça existait déjà avant de coder du custom ?
- [ ] Si modif visuelle → j'ai pris une capture pour vérifier le rendu ?
- [ ] J'ai détecté les doublons potentiels par croisement de fichiers ?
- [ ] Le nouveau code est rangé comme module (pas un fichier perdu) ?
- [ ] J'ai mis à jour le CHANGELOG / OBSERVATIONS si pertinent ?

---

## ⚠️ Limitation connue — cache sandbox Bash

> Documenté le 05/05/2026 — OBSERVATIONS_CHATS.md 2026-05-01

Le mount Linux sandbox (`/sessions/.../mnt/OLYMPUS/...`) garde un **cache figé** du contenu d'un fichier pendant toute une session Claude. Les modifications faites via `Edit` ou `Write` côté Windows ne se propagent pas au Bash sandbox immédiatement.

**Conséquence directe** : `bash -c "python3 -c \"import ...\"" ` ou `py_compile.compile(...)` sur un fichier qu'on vient de modifier → **LIT L'ANCIENNE VERSION** → résultats faux.

**Solutions** :
- Utiliser `/api/python/compile` si disponible (endpoint NEXUS qui lit le path Windows direct)
- Utiliser `Read` + validation logique en Python inline (pas depuis disque)
- Valider la syntaxe via NEXUS restart (si le module crashe au boot → erreur visible dans `/api/health`)
- **Ne jamais dire "syntaxe OK" après un `py_compile` bash sur un fichier juste édité**

---

## Liens

- **Profil Vivien** : `MNEMOSYNE/07_PREFS/profil_psychologique_vivien.md`
- **Convention propositions** : `MNEMOSYNE/01_LOIS/CONVENTION_PROPOSITIONS.md`
- **Observations chats** : `MNEMOSYNE/02_ETAT/OBSERVATIONS_CHATS.md`

---
_Migre F:->C: par docs_portability_light 2026-05-10_