docs: rewrite README with accurate install, commands, and architecture

- Switch to English as primary language, French version in README.fr.md
- Fix install instructions: pnpm → bun (correct package manager)
- Fix badge to point to release-gate.yml on main branch
- Remove non-existent commands (config set, audit_memory)
- Add real CLI commands (run, models, providers, stats, generate)
- Add prerequisites section (Bun >= 1.3.11, Git, API key)
- Add supported providers list (15+)
- Add architecture diagram and monorepo structure table
- Add development section with release:gate workflow
- Add known limitations section
- Add branch convention (main/dev)

https://claude.ai/code/session_01A8LkdCir3TS3uCbx9L8CAb

Author: claude

README.fr.md

@@ -8,91 +8,157 @@
   </a>
 </p>
 
-<p align="center"><b>OpenCode : L'Agentic Operating System (V3)</b></p>
-<p align="center">L'assistant de codage open-source, sécurisé et doté d'une conscience cognitive.</p>
+<p align="center"><b>OpenCode — L'OS de Codage Agentique Open-Source</b></p>
+<p align="center">Assistant IA multi-provider avec memoire long-terme, securite adaptive et planification parallele.</p>
 
 <p align="center">
   <a href="https://discord.gg/opencode"><img alt="Discord" src="https://img.shields.io/discord/1391832426048651334?style=flat-square&label=discord" /></a>
   <a href="https://github.com/Rwanbt/opencode"><img alt="GitHub" src="https://img.shields.io/github/stars/Rwanbt/opencode?style=flat-square" /></a>
-  <a href="https://github.com/Rwanbt/opencode/actions/workflows/publish.yml"><img alt="Statut de Build" src="https://img.shields.io/github/actions/workflow/status/Rwanbt/opencode/publish.yml?style=flat-square&branch=dev" /></a>
+  <a href="https://github.com/Rwanbt/opencode/actions/workflows/release-gate.yml"><img alt="Release gate" src="https://img.shields.io/github/actions/workflow/status/Rwanbt/opencode/release-gate.yml?style=flat-square&branch=main&label=release-gate" /></a>
 </p>
 
+<p align="center"><a href="README.md">English</a></p>
+
 ---
 
-## 🚀 Qu'est-ce qu'OpenCode (Agent OS Edition) ?
+## Qu'est-ce qu'OpenCode ?
 
-OpenCode n'est plus un simple assistant de code. Avec la version **Agent OS V3**, il évolue vers une **infrastructure cognitive complète**. Il ne se contente pas d'exécuter des commandes ; il planifie, audite, protège vos secrets et synthétise ses propres connaissances.
+OpenCode est un CLI de codage IA open-source (MIT) qui se connecte a **15+ providers LLM** et ajoute une infrastructure cognitive : memoire long-terme structuree, detection de secrets par entropie, planification DAG avec sandboxing git, et annulation physique via snapshots git.
 
-### 🌟 Fonctionnalités Exclusives (V2/V3)
+Il est distribue sous forme de binaire Bun compile pour Linux, macOS et Windows, avec un TUI integre, une interface web embarquee, des applications desktop (Tauri + Electron) et un systeme de plugins.
 
-#### 🧠 Mémoire TurboQuant V3 (LTM)
-Contrairement aux mémoires plates habituelles, TurboQuant gère une **structure de vérité** :
-- **Scores de Confiance :** Chaque leçon apprise est pondérée par sa fiabilité.
-- **Auto-Dream (Synthèse) :** Une fois par jour, l'agent fusionne ses fragments de connaissances en principes architecturaux consolidés.
-- **Résolution de Conflits :** Détecte et arbitre les contradictions entre les leçons apprises.
+### Providers supportes
 
-#### 🛡️ AgentShield 2.0 (Sécurité Adaptative)
-Une protection contre les fuites de données (DLP) de niveau industriel :
-- **Shannon Entropy :** Détecte les secrets inconnus par leur niveau de randomness mathématique.
-- **Context-Aware :** Adapte ses seuils de vigilance selon que vous manipulez un `.env` ou un log de build Git.
-- **Git Whitelist :** Ignore intelligemment les hashes de commit pour éviter les faux-positifs.
+Anthropic, OpenAI, Google (Gemini / Vertex), Amazon Bedrock, Azure OpenAI, Groq, Mistral, Cohere, Perplexity, Together AI, DeepInfra, Cerebras, xAI, OpenRouter, et tout endpoint compatible OpenAI.
 
-#### 🏗️ Planification Parallèle (DAG)
-L'agent utilise désormais un **Graphe Acyclique Dirigé (DAG)** pour orchestrer ses tâches.
-- **Isolation (Sandboxing) :** Pour les tâches parallèles, l'agent crée automatiquement des **branches Git temporaires**, isolant ses expérimentations du code principal jusqu'à validation.
+---
 
-#### 📸 Hard Safety (Restaurations Physique)
-Oubliez les "Undo" approximatifs. OpenCode utilise des **Git Snapshots** physiques via `git stash`. Vous pouvez revenir à un état antérieur du projet en une commande, avec une garantie de 100% sur l'intégrité des fichiers.
+## Installation
 
----
+### Prerequis
 
-## 📦 Installation
+- [Bun](https://bun.sh/) >= 1.3.11
+- Git
+- Une cle API pour au moins un provider supporte
+
+### Depuis les sources
 
 ```bash
-# Installation depuis le fork Agent OS
 git clone https://github.com/Rwanbt/opencode.git
 cd opencode
-pnpm install
-pnpm build
-npm link # Pour utiliser la commande 'opencode' partout
+bun install
+bun --cwd packages/opencode run dev -- --help
+```
+
+### Compiler un binaire
+
+```bash
+bun --cwd packages/opencode run build --single
+# Sortie : packages/opencode/dist/*/bin/opencode
+```
+
+---
+
+## Demarrage rapide
+
+```bash
+# Configurer votre cle provider
+export ANTHROPIC_API_KEY="sk-..."
+
+# Lancer une session interactive
+opencode
+
+# Executer une tache ponctuelle
+opencode run "ajouter la gestion d'erreurs a src/server.ts"
+
+# Commandes passives (boot instantane, pas d'init DB)
+opencode --help
+opencode --version
+opencode generate    # Generer le spec OpenAPI
+opencode models      # Lister les modeles disponibles
+opencode providers   # Lister les providers configures
+opencode stats       # Statistiques de sessions et d'utilisation
 ```
 
 ---
 
-## 🛠️ Utilisation Avancée
+## Fonctionnalites principales
+
+### Multi-Provider (15+)
+
+Passez d'un provider a l'autre a tout moment. Pas de lock-in. Apportez vos propres cles API.
+
+### TurboQuant — Memoire Long-Terme Structuree
+
+Contrairement aux fichiers de memoire plats, TurboQuant maintient une **structure de verite** :
+- **Scores de confiance** — chaque lecon apprise est ponderee par sa fiabilite
+- **Synthese Auto-Dream** — consolidation quotidienne automatique des fragments de connaissances en principes architecturaux
+- **Resolution de conflits** — detecte et arbitre les contradictions entre les lecons apprises
 
-OpenCode propose plusieurs sub-agents spécialisés :
+### AgentShield — Securite Adaptive (DLP)
 
-- **Buddy CLI :** Ton compagnon interactif. Configure ses thèmes (`CYBER`, `STEALTH`) et sa verbosité.
-- **Critic :** Le censeur invisible qui audite chaque changement et chaque nouvelle mémoire avant validation.
-- **Planner :** Utilise `task.md` pour définir le graphe de dépendances de ton projet.
+Protection contre les fuites de donnees de niveau production :
+- **Detection par entropie de Shannon** — detecte les secrets inconnus par leur niveau de randomness mathematique
+- **Seuils contextuels** — adapte la sensibilite selon le type de fichier (`.env` vs logs de build)
+- **Whitelist Git** — ignore intelligemment les hashes de commit pour eviter les faux positifs
+
+### Planification Parallele (DAG)
+
+Les taches sont orchestrees via un Graphe Acyclique Dirige :
+- **Sandboxing Git** — les taches paralleles s'executent dans des worktrees git isoles
+- **Merge automatique** — les resultats sont valides avant d'etre fusionnes dans la branche principale
+
+### Hard Safety — Annulation Physique
+
+Snapshots via `git stash`. Restaurez n'importe quel etat precedent du projet avec une garantie d'integrite.
+
+### Systeme de Plugins
+
+Extensible via des plugins TypeScript avec des hooks pour la transformation de messages, la securite et l'integration d'outils.
+
+### Support MCP
+
+Client et serveur Model Context Protocol natifs pour l'integration d'outils, ressources et prompts.
+
+---
+
+## Developpement
 
 ```bash
-# Lancer Buddy en mode Cyber
-opencode config set buddy.theme CYBER
+# Installer les dependances
+bun install
+
+# Lancer en mode dev
+bun --cwd packages/opencode run dev
+
+# Verification de types (zero erreur requise)
+bun run typecheck
+
+# Lancer les tests
+bun --cwd packages/opencode run test
 
-# Consulter l'audit de mémoire
-opencode audit_memory list
+# Gate de release (typecheck, tests, build + smoke binaire)
+bun --cwd packages/opencode run release:gate
 ```
 
+### Convention de branches
+
+- `main` — production, toujours vert
+- `dev` — developpement actif
+- Les branches feature mergent dans `dev`, puis `dev` merge dans `main`
+
 ---
 
-## 🏗️ Architecture "Cognitive OS"
+## Contribuer
 
-L'architecture repose sur un cycle **OODA (Observe, Orient, Decide, Act)** boosté :
-1. **Observe :** Analyse du workspace et des logs.
-2. **Orient :** Récupération mémorielle (TurboQuant) + Analyse de sécurité (AgentShield).
-3. **Decide :** Planification non-linéaire (DAG Planner).
-4. **Act :** Exécution avec Sandboxing Git.
-5. **Learn :** Audit par le Critic et Synthèse (Auto-Dream).
+Voir [CONTRIBUTING.md](CONTRIBUTING.md) pour la configuration de l'environnement et les directives.
 
 ---
 
-## 🤝 Contribuer
+## Licence
 
-Nous croyons en un futur où le code est écrit en symbiose entre l'humain et l'agent. Rejoignez-nous pour repousser les limites de ce qui est possible dans un terminal.
-
-[Dépôt GitHub](https://github.com/Rwanbt/opencode) | [Documentation (Wiki)](https://github.com/Rwanbt/opencode/wiki)
+[MIT](LICENSE)
 
 ---
-<p align="center">Fait avec ❤️ pour la communauté Neovim & Terminal.</p>
+
+<p align="center">Fait avec soin pour la communaute terminal.</p>