diff --git a/ROADMAP.md b/ROADMAP.md
index 9841c80..517e825 100644
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -237,10 +237,76 @@ Propriétés custom, AI keywords, sync API, 12 tables DB
 - [ ] Récurrence d'événements
 - [ ] Template Meeting Notes
 
-### v4.7.0 — AI Assistant
-- [ ] Intégration LLM pour écriture/résumé/traduction
-- [ ] Slash AI commands (`/ai write`, `/ai summarize`)
-- [ ] Auto-complétion
+### v4.7.0 — FlowDeck Agent (Agent IA natif)
+
+> **Objectif :** Un agent IA intégré à FlowDeck, capable de planifier, rechercher et **agir** directement sur les workspaces — collections, pages, propriétés, vues, issues Gitea. Inspiré de Notion Agent (2026).  
+> **Documentation :** [`docs/Flowdeck_Agent_integration.md`](docs/Flowdeck_Agent_integration.md) (702 lignes) · [`docs/Guide_Complet_Notion_Agent_2026.md`](docs/Guide_Complet_Notion_Agent_2026.md) (464 lignes)
+
+#### Concept
+Là où un assistant IA classique répond (`prompt → réponse`), FlowDeck Agent **réalise** :  
+`objectif → planification → collecte contexte → actions API → résultat`
+
+| Notion AI | FlowDeck Agent |
+|-----------|----------------|
+| Répond, résume, réécrit | Planifie, recherche, **agit** |
+| Bloc de texte | Crée collections, pages, propriétés, vues |
+| Sans état | Historique conversation + snapshots rollback |
+| Aucune action DB | Modifie le workspace via API FastAPI existantes |
+
+#### Fonctionnalités clés
+- [ ] **Interface conversationnelle** — panneau agent dans le sidebar (🤖 Agents) + popup chat
+- [ ] **Boucle ReAct** — Raisonnement → Action → Observation → itération (max 12 tours)
+- [ ] **Streaming SSE** — affichage temps réel du raisonnement et des actions
+- [ ] **10+ outils actionnables** — search, read/write collections/pages, views, properties, Gitea sync
+- [ ] **Permissions** — même ACL que l'utilisateur (`PermissionManager`), audit log + rollback
+- [ ] **Contexte automatique** — workspace actif, pages mentionnées, fichiers uploadés
+- [ ] **Custom agents** — instructions, modèle, outils, scope par agent
+- [ ] **Déclencheurs** — planifiés, webhooks, événements workspace
+- [ ] **Skills réutilisables** — templates d'instructions + outils (ex: "Rédiger rapport hebdo")
+- [ ] **Multi-LLM** — GPT, Claude, Gemini, modèles locaux (Ollama)
+
+#### Architecture (nouveaux composants)
+```
+app/
+├── routers/agent.py        — /api/agent/* (run, conversations, tools)
+├── services/agent_engine.py — Orchestrateur ReAct + boucle tool calls
+├── services/llm_client.py   — Abstraction multi-fournisseur LLM
+├── services/tool_registry.py — 10+ outils wrappant les API existantes
+├── services/context_builder.py — Collecte contexte workspace
+└── templates/
+    ├── agent_panel.html     — Panneau conversation Alpine.js
+    └── agent_message.html   — Fragment message (streaming)
+```
+
+#### Nouvelles tables
+| Table | Rôle |
+|-------|------|
+| `agents` | Config agent (nom, instructions, modèle, tools scope) |
+| `agent_conversations` | Sessions (titre, agent, workspace, statut) |
+| `agent_messages` | Messages (role, content, tool_calls, artifacts) |
+| `agent_actions` | Journal d'audit (tool, args, result, undo_snapshot) |
+| `agent_skills` | Skills réutilisables (nom, prompt template, outils) |
+| `agent_triggers` | Déclencheurs (cron, webhook, event, agent cible) |
+
+#### Cas d'usage FlowDeck
+- **Créer un CRM complet** — agent crée collection, propriétés, vues, exemples
+- **Résumer les notes de réunion** — lit les pages, synthétise, crée une page résumé
+- **Générer des OKR** — crée la database OKR avec relations et vues
+- **Analyser un repo Gitea** — lit les issues, crée un dashboard de suivi
+- **Rédiger un rapport hebdomadaire** — agrège les pages modifiées, génère le rapport
+
+#### Plan de migration (5 phases)
+1. **Phase 1 — Core Agent** : AgentEngine + LLMClient + 3 outils (search, read, create) + SSE streaming
+2. **Phase 2 — UI** : agent_panel.html, historique conversations, sélecteur de modèle
+3. **Phase 3 — Outils avancés** : 7 outils supplémentaires (views, properties, Gitea, uploads)
+4. **Phase 4 — Autonomie** : custom agents, skills, déclencheurs planifiés
+5. **Phase 5 — Plateforme** : API publique agent → intégrations tierces, marketplace skills
+
+#### Limitations (v1)
+- Pas de modification concurrente (lock optimiste DB)
+- Pas d'appels API externes non-FlowDeck (sandbox strict)
+- Budget tokens max par conversation (500k tokens)
+- Timeout 5 minutes par run
 
 ### v4.8.0 — Command Palette & Recherche
 - [ ] **Command palette** — Ctrl+K / Ctrl+P recherche universelle
@@ -278,9 +344,10 @@ Base + Kanban         Éditeur + Gitea      UX Pro          MVP          Onboard
 + UI Notion           + Tags + Admin                       + Sharing    COMPLETED
                       + GitHub OAuth                       + Library
 
-v4.0.2 ✅    v4.1.0 ⬜    v4.2.0 ⬜    v4.3.0 ⬜    v4.4–4.10 ⬜    v5.0.0 ⬜
-Quality     Blocks      Export       Collab      Notion          Pro
+v4.0.2 ✅    v4.1.0 ⬜    v4.2.0 ⬜    v4.3.0 ⬜    v4.4–4.7 ⬜    v5.0.0 ⬜
+Quality     Blocks       Export       Collab      Notion          Pro
 & Tests     enrichis    PDF/MD       @mentions   Parity          (futur)
+            ⬜ v4.7.0: FlowDeck Agent (IA native)
 ```
 
-*Dernière mise à jour: 2026-07-18 — Roadmap restructuré, focus MVP, stratégie de branches Gitea*
+*Dernière mise à jour: 2026-07-20 — v4.7.0 FlowDeck Agent ajouté, ARCHITECTURE.md v4.0 synchronisé*