# INSTRUCTIONS CLAUDE - ICHIGRIDEA

## SYSTÈME DE TRAÇABILITÉ

### Fichiers de traçabilité (tous sur GitHub)
| Fichier | Rôle |
|---------|------|
| `PROJECT.json` | Source de vérité unique (stats, config, état) |
| `HASHES.json` | SHA-256 de TOUS les fichiers MQL5 |
| `CHANGELOG.md` | Historique des déploiements |
| `.checkpoints/` | Sauvegardes locales (pas sur GitHub) |

### Ce qu'il ne faut JAMAIS créer
- MANIFEST.json, MANIFEST_FULL.json
- MODULES_REGISTRY.json, GLOBALS_REGISTRY.json
- HASHMAP.json, INPUTS_REGISTRY.json
- TRACABILITE.md, TRACABILITY_MASTER.csv
- EA_Master_UNIFIED.xlsx

**Tout passe par PROJECT.json, HASHES.json et CHANGELOG.md**

---

## DÉBUT DE CHAQUE SESSION

### 1. Cloner le repo
```bash
cd /home/claude && rm -rf IchiGrid-EA
git clone https://github.com/KinSushi/IchiGrid-EA.git
```

### 2. Lire l'état du projet
```bash
cat /home/claude/IchiGrid-EA/PROJECT.json
```

### 3. Vérifier les hashes (intégrité)
```bash
cat /home/claude/IchiGrid-EA/HASHES.json | head -50
```

### 4. Compter les modules
```bash
ls /home/claude/IchiGrid-EA/Include/*.mqh | wc -l
```

---

## POUR GÉNÉRER UN MODULE

### 1. Lire les specs
```bash
# Document: /mnt/project/01_760.docx
# Utiliser view avec view_range pour les lignes spécifiques
```

### 2. Appliquer le pipeline
- Lire `/mnt/skills/user/mql5-pipeline/SKILL.md`
- Headers avec SHA-256 (calculé après génération)
- Annotations `[RULE:SXX_NNN]` et `[PARAM:SXX_INPNNN]`
- Classes: prefix `C`, structures: prefix `S`
- Variables: `m_` (membre), `g_` (global), `inp_` (input)

### 3. Calculer le SHA-256 du fichier généré
```bash
sha256sum /home/claude/MonModule.mqh
```

### 4. Livrer le fichier
```bash
cp /home/claude/MonModule.mqh /mnt/user-data/outputs/
```
Puis utiliser `present_files`

---

## APRÈS GÉNÉRATION

Dire à l'utilisateur:
```
Fichier généré: [nom].mqh
SHA-256: [hash]

1. Télécharge-le
2. Place-le dans: C:\Users\Enzo\Downloads\IchiGridEA\IchiGridEA\[dossier]\
3. Exécute: .\DEPLOY.ps1 deploy
   (ou DEPLOY.bat)

Le script va automatiquement:
- Nettoyer les fichiers obsolètes
- Recalculer tous les SHA-256
- Mettre à jour PROJECT.json et HASHES.json
- Commit + Push GitHub
- Sync serveur OVH
```

---

## POUR LIRE UN FICHIER DU REPO

### Option A - Depuis OVH (HTTP)
```bash
curl -s http://92.222.226.50:9000/Include/IchimokuSignals.mqh
```

### Option B - Après git clone
```bash
cat /home/claude/IchiGrid-EA/Include/IchimokuSignals.mqh
```

### Option C - Vérifier le hash
```bash
# Comparer avec HASHES.json
jq '.files["Include/IchimokuSignals.mqh"]' /home/claude/IchiGrid-EA/HASHES.json
```

---

## INFRASTRUCTURE

| Élément | Valeur |
|---------|--------|
| GitHub | https://github.com/KinSushi/IchiGrid-EA |
| OVH HTTP | http://92.222.226.50:9000/ |
| OVH SSH | ssh -i ~/.ssh/ovh_serveur ubuntu@92.222.226.50 |
| Local PC | C:\Users\Enzo\Downloads\IchiGridEA\IchiGridEA |
| Specs | /mnt/project/01_760.docx |

---

## COMMANDES DEPLOY.ps1

| Commande | Action |
|----------|--------|
| `.\DEPLOY.ps1 status` | État du projet |
| `.\DEPLOY.ps1 clean` | Nettoie fichiers obsolètes |
| `.\DEPLOY.ps1 hash` | Génère HASHES.json |
| `.\DEPLOY.ps1 verify` | Vérifie intégrité SHA-256 |
| `.\DEPLOY.ps1 checkpoint` | Crée sauvegarde |
| `.\DEPLOY.ps1 sync` | Sync GitHub → OVH |
| `.\DEPLOY.ps1 deploy` | **TOUT** (recommandé) |

---

## SECTIONS RESTANTES

| Section | Module | Priorité | Description |
|---------|--------|----------|-------------|
| S92 | ExplanatoryAI | MEDIUM | IA explicative langage naturel |
| S93 | CloneManager | MEDIUM | Protocole duplication intelligente |
| S101+ | ? | HIGH | Encapsulation finale |

---

## STRUCTURE FINALE DU REPO

```
IchiGridEA/
├── IchiGridEA.mq5          # EA principal
├── PROJECT.json            # Source de vérité
├── HASHES.json             # SHA-256 traçabilité
├── CHANGELOG.md            # Historique
├── README.md               # Documentation
├── LICENSE                 # MIT
├── .gitignore              # Fichiers ignorés
├── Include/                # 69 modules core
├── Core/                   # RuntimeCompiler (S96)
├── Memory/                 # PersistentMemory (S97)
├── Evolution/              # EvolutionLoop (S98)
├── Humanoid/               # HumanoidTrader (S99)
├── Interface/              # ExternalGUI (S100)
├── Files/Presets/          # .set files
├── tests/                  # Tests
├── docs/                   # Documentation
└── pipeline/               # Scripts Python
```

**Scripts locaux (pas sur GitHub):**
- DEPLOY.ps1
- DEPLOY.bat
- .checkpoints/