# Écriture naturelle + accès Firecrawl sur les 4 instances Hermes (19/07/2026)

## Contexte
Nabil a demandé d'appliquer deux choses à hermes-tt, hermes-nyora, hermes-perso (NAS)
et hermes-nabil (VPS) : bannir les tics d'écriture IA, et donner accès à Firecrawl
(scraping/recherche web) en usage de dernier recours, pour préserver le quota gratuit
(1000 crédits/mois, un seul compte partagé entre les 4).

## Règle d'écriture naturelle
Bloc "## ÉCRITURE — RÈGLE ABSOLUE" inséré dans les 4 SOUL.md, juste après le bloc
"## LANGUE — RÈGLE ABSOLUE" existant. Bannit : tirets longs en cascade, formules de
remplissage ("il est important de noter"), tricolons artificiels, hedging systématique,
symétrie parfaite de listes, intros/conclusions génériques.

Fichier de référence livré à Nabil : `HUMANISE.md` (pour diffusion à d'autres agents,
ex. hermes-yesmine, hors infra gérée ici).

Sauvegardes : `SOUL.md.bak_ecriture_20260719` sur les 4 instances.

## Accès Firecrawl
- Clé unique `FIRECRAWL_API_KEY` (un seul compte Firecrawl, quota partagé) :
  - VPS hermes-nabil : dans `/data/.env`
  - NAS TT/Nyora/Perso : dans `hermes-platform/.env` (racine), injectée via
    `docker-compose.yml` (bloc `environment:` des 3 services `hermes-agent-*`)
- Script partagé `firecrawl_scrape.py` (identique sur les 4 instances, seul le
  chemin de dépôt change) :
  - VPS hermes-nabil : `/data/nyora/firecrawl_scrape.py`
  - NAS TT/Perso : `data/scripts/firecrawl_scrape.py` (dossier déjà existant)
  - NAS Nyora : `data/scripts/firecrawl_scrape.py` (dossier créé, n'existait pas)
  - Usage : `python3 .../firecrawl_scrape.py <url>` (scrape) ou
    `--search "requête" [n]` (recherche)
- Consigne SOUL.md ("## RECHERCHE WEB (Firecrawl)") : dernier recours seulement,
  pas par réflexe, pour préserver le quota partagé entre les 4 instances.

## Pièges rencontrés
- `hermes-nyora/data/` n'avait pas de dossier `scripts/` (contrairement à TT et
  Perso) — créé manuellement, cohérent avec la convention des deux autres.
- `docker compose up -d <services>` interrompu par un timeout côté outil a laissé
  hermes-agent-nyora et hermes-agent-perso en état `Created` (pas démarrés) —
  `docker start <container>` explicite a suffi à débloquer, pas de recreate
  nécessaire une deuxième fois.
- `hermes-tt/data/`, `hermes-nyora/data/`, `hermes-perso/data/` sont dans le
  `.gitignore` de `hermes-platform` (volumes runtime + secrets) — aucun commit
  Git à faire pour les SOUL.md, seule la sauvegarde `.bak_*` fait foi. Seul
  `docker-compose.yml` (hors `data/`) a été commité.
- Une insertion de bloc dans le SOUL.md de hermes-nabil avait été faite sans
  accents par accident (héritage du style non accentué du reste du fichier,
  qui n'a jamais été ré-accentué au-delà des blocs de règles eux-mêmes) —
  corrigé immédiatement. Le corps du SOUL.md hermes-nabil hors blocs de règles
  reste globalement non accentué : ré-accentuation complète non faite, à
  prévoir si ça devient gênant.

## Vérification
Testé en réel sur les 4 instances après déploiement : script exécuté avec
`--search "test"`, résultat renvoyé correctement partout, `FIRECRAWL_API_KEY`
confirmée présente dans l'environnement des containers NAS.