feat: Initialize the n8n agent project with comprehensive AI skills, documentation, and configuration templates.

README.md

@@ -0,0 +1,169 @@
+# N8N Agent Consultant Expert
+
+Agent Claude spécialisé en création, optimisation et correction de workflows N8N de haute qualité.
+
+## Caractéristiques
+
+- **1,084 nœuds N8N** supportés (537 core + 547 community)
+- **7 skills spécialisées** pour la construction de workflows de production
+- **20 outils MCP** pour interagir avec N8N
+- **2,709 templates** de workflows avec métadonnées complètes
+- **87% de couverture documentaire** officielle
+- **5 patterns architecturaux** éprouvés sur 2,653+ templates
+
+## Capacités de l'Agent
+
+### Création de Workflows
+- Conception d'architectures scalables et robustes
+- Utilisation des patterns éprouvés (Webhook, API, Database, AI, Scheduled)
+- Configuration optimale des 525+ nœuds supportés
+- Gestion d'erreurs et retry logic professionnels
+- Expressions N8N avancées avec variables et fonctions
+
+### Correction et Optimisation
+- Diagnostic précis des problèmes (erreurs, performance, logique)
+- Validation et auto-sanitization des configurations
+- Optimisation des performances et de la fiabilité
+- Refactoring selon les meilleures pratiques
+- Tests et validation complète
+
+### Expertise Technique
+- Maîtrise des expressions `{{}}` et variables ($json, $node, $now, $env)
+- Code Nodes JavaScript et Python avec patterns testés
+- Intégration APIs tierces avec authentification (OAuth, API Key, Basic)
+- 8 types de connexions AI (OpenAI, Anthropic, Gemini, etc.)
+- Gestion avancée des données et transformations
+
+## Installation Rapide
+
+1. **Configurez le serveur MCP N8N**
+   ```bash
+   # Copiez le template
+   cp .mcp.json.template .mcp.json
+
+   # Éditez avec vos credentials
+   nano .mcp.json
+   ```
+
+2. **Installez les skills N8N**
+   ```bash
+   /plugin install czlonkowski/n8n-skills
+   ```
+
+3. **Lancez l'agent**
+   ```bash
+   claude
+   ```
+
+Pour l'installation détaillée, consultez [INSTALLATION.md](INSTALLATION.md).
+
+## Structure du Projet
+
+```
+n8n-Agent/
+├── Claude.md                # Configuration de l'agent expert N8N
+├── README.md                # Ce fichier
+├── INSTALLATION.md          # Guide d'installation complet
+├── .mcp.json.template       # Template de configuration MCP
+├── .env.template            # Template de variables d'environnement
+├── .gitignore               # Protection des secrets
+└── workflows/               # Vos workflows N8N (optionnel)
+```
+
+## Utilisation
+
+### Créer un Nouveau Workflow
+
+```
+"Je veux créer un workflow qui :
+1. Reçoit des données via webhook
+2. Enrichit les données avec une API externe
+3. Stocke dans Airtable
+4. Envoie une notification Slack"
+```
+
+### Corriger un Workflow Existant
+
+```
+"Mon workflow ID 123 génère une erreur 'Cannot read property of undefined'.
+Peux-tu l'analyser et corriger ?"
+```
+
+### Optimiser un Workflow
+
+```
+"Ce workflow est lent et consomme beaucoup de ressources.
+Peux-tu l'optimiser en utilisant le batch processing ?"
+```
+
+## Sécurité
+
+**⚠️ IMPORTANT ⚠️**
+
+- **JAMAIS** éditer directement les workflows de production
+- **TOUJOURS** tester dans un environnement de développement
+- **TOUJOURS** exporter des backups avant modifications
+- **TOUJOURS** valider les changements avant déploiement
+
+## Skills Disponibles
+
+1. **n8n Expression Syntax** - Syntaxe et variables
+2. **n8n MCP Tools Expert** - Utilisation optimale des outils
+3. **n8n Workflow Patterns** - 5 patterns architecturaux
+4. **n8n Validation Expert** - Gestion des erreurs de validation
+5. **n8n Node Configuration** - Configuration avancée des nœuds
+6. **n8n Code JavaScript** - Patterns JavaScript testés
+7. **n8n Code Python** - Code Python avec limitations
+
+## Outils MCP
+
+### Documentation (7 outils)
+- Recherche de nœuds et validation
+- Documentation des propriétés
+- Accès aux templates et configurations
+
+### Gestion N8N (13 outils)
+- CRUD workflows
+- Activation/désactivation
+- Gestion des exécutions
+- Import/export
+- Gestion des credentials
+
+## Patterns de Workflows
+
+1. **Webhook Processing** - Réception et traitement de webhooks
+2. **HTTP API** - Appels API avec retry et error handling
+3. **Database** - CRUD et synchronisation de données
+4. **AI** - Intégrations IA avec prompts dynamiques
+5. **Scheduled** - Tâches planifiées et batch processing
+
+## Configuration Requise
+
+- Node.js
+- Claude Code CLI ou Claude Desktop
+- Instance N8N (cloud ou self-hosted)
+- API Key N8N
+
+## Ressources
+
+- **Documentation N8N** : https://docs.n8n.io
+- **N8N MCP Server** : https://github.com/czlonkowski/n8n-mcp
+- **N8N Skills** : https://github.com/czlonkowski/n8n-skills
+- **Claude Code** : https://claude.com/claude-code
+
+## Support
+
+Pour toute question :
+- [INSTALLATION.md](INSTALLATION.md) pour l'installation
+- [Claude.md](Claude.md) pour la configuration de l'agent
+- Issues : Voir les repos GitHub des composants
+
+## Licence
+
+Les composants utilisés ont leurs propres licences :
+- N8N MCP Server : MIT
+- N8N Skills : MIT
+
+---
+
+**Créé avec** [Claude Code](https://claude.com/claude-code)