MDAN — Multi-Agent Development Agentic Network

MDAN est un framework de développement piloté par l'IA, composé d'agents spécialisés, de wizards interactifs pas-à-pas, d'un système de mémoire persistante et d'un protocole de débat structuré.

100% gratuit et open source. Made in Morocco.

Nouveautés v3.1 🚀

Module Ecosystem — 2,014 composants

MDAN est désormais connecté à l'écosystème complet Claude Code : 1,053 skills, 418 agents, 340 commandes, 67 hooks, 67 settings, 69 MCPs.

Sources : khalilbenaz/claude-skills-collection + aitmpl.com (davila7/claude-code-templates)

9 nouveaux agents spécialisés, dirigés par Fayçal (IA Master) et supervisés par Khalil (MDAN Master).

Serveur MCP

MDAN fonctionne comme serveur MCP — tout IDE compatible MCP (Claude Code, Cursor, etc.) peut se connecter directement et utiliser tous les workflows et agents comme des outils.

mdan serve            # transport stdio
mdan serve --sse      # SSE pour le distant

Ajoutez cette configuration dans votre .mcp.json :

{
  "mcpServers": {
    "mdan": {
      "command": "npx",
      "args": ["-y", "mdan-method", "serve"],
      "env": { "MDAN_PROJECT_ROOT": "." }
    }
  }
}

Outils MCP disponibles :

| Outil | Description | |-------|-------------| | mdan_list-workflows | Liste tous les workflows | | mdan_workflow_{name} | Exécute un workflow (create-prd, create-architecture, etc.) | | mdan_list-agents | Liste tous les agents installés | | mdan_agent_{name} | Consulte un agent spécifique | | mdan_graph_impact | Analyse d'impact en aval d'un artifact | | mdan_graph_visualize | Diagramme Mermaid du context graph | | mdan_orchestrate_party-mode | Session multi-agent (discussion/débat/consensus) | | mdan_orchestrate_create-decision-record | Crée un decision record | | mdan_ecosystem_catalog | Affiche le catalogue complet de l'écosystème (2,014 composants) | | mdan_ecosystem_search-skills | Recherche parmi 1,053 skills par mot-clé | | mdan_ecosystem_search-agents | Recherche parmi 418 templates d'agents | | mdan_ecosystem_search-commands | Recherche parmi 340 commandes | | mdan_ecosystem_read-skill | Lit le contenu d'un skill | | mdan_ecosystem_read-agent | Lit le contenu d'un template d'agent | | mdan_ecosystem_stats | Statistiques d'installation de l'écosyst��me |

Ressources MCP : mdan://state, mdan://config, mdan://graph

Context Graph

DAG léger qui trace toutes les relations entre les artifacts. Chaque workflow terminé enregistre automatiquement son artifact dans le graphe.

mdan impact <artifact-id>   # Analyse d'impact en aval
mdan graph                   # Diagramme Mermaid
mdan graph --json            # JSON brut

graph TD
  prd[PRD] -->|input_to| arch[Architecture]
  arch -->|input_to| epics[Epics & Stories]
  epics -->|input_to| sprint[Sprint Plan]
  dr-001[DR-001: API Strategy] -->|impacts| arch

Les Decision Records des débats sont aussi enregistrés dans le graphe.

Orchestration multi-agent avancée

Le Party Mode propose 3 modes :

| Mode | Description | |------|-------------| | Discussion | Conversation libre multi-agent (mode original) | | Débat | Argumentation structurée à 3 rôles → Decision Record | | Consensus | N agents convergent vers une position commune |

Mode Débat — 3 rôles : Partisan 🟢, Opposant 🔴, Arbitre ⚖️. 3 rounds structurés. Produit automatiquement un Decision Record (DR-XXX) enregistré dans le Context Graph. Disponible en sous-mode de party-mode OU directement via /mdan-debate.

Mode Consensus — 3-5 agents passent par 4 phases : positions initiales → cartographie accord/désaccord → itérations de convergence → synthèse.

Agent Sidecars — Mémoire persistante pour chaque agent entre les sessions. Les agents se souviennent des observations, préférences et décisions des sessions précédentes.

Sélection de langue

À l'installation, MDAN vous demande votre langue préférée :

1. 🇫🇷🇲🇦 Français + Darija Marocaine (par défaut)
2. 🇫🇷 Français uniquement
3. 🇬🇧 English
4. 🇲🇦 Darija Marocaine

Démarrage rapide

npx mdan-method install

L'installeur vous guide pour choisir les modules et votre IDE (Claude Code, Gemini CLI, OpenCode, QwenCoder...).

Ensuite, dans votre IDE, tapez /mdan- pour voir toutes les commandes disponibles.

Commandes disponibles

Toutes les commandes commencent par /mdan-.

Wizards — Phase 1 : Découverte

| Commande | Description | |----------|-------------| | /mdan-create-product-brief | Crée un product brief collaboratif en 6 étapes. Définit la vision, les utilisateurs cibles, le scope et les métriques de succès. | | /mdan-market-research | Recherche de marché : analyse concurrentielle, comportement clients, pain points et opportunités. | | /mdan-technical-research | Recherche technique : technologies, patterns d'architecture, intégrations et tendances. | | /mdan-domain-research | Recherche de domaine : analyse sectorielle, réglementation, paysage concurrentiel. |

Wizards — Phase 2 : Planification

| Commande | Description | |----------|-------------| | /mdan-create-prd | Crée un Product Requirements Document complet en 12 étapes. Vision, user journeys, scoping, requirements fonctionnels et non-fonctionnels. | | /mdan-create-ux-design | Planifie le design UX en 14 étapes : discovery, design system, fondations visuelles, user journeys, composants et responsive. |

Wizards — Phase 3 : Architecture

| Commande | Description | |----------|-------------| | /mdan-create-architecture | Crée l'architecture technique en 8 étapes : contexte, décisions, patterns, structure et validation. | | /mdan-create-epics-and-stories | Découpe les requirements en epics et user stories prêtes pour le développement. |

Wizards — Phase 4 : Construction

| Commande | Description | |----------|-------------| | /mdan-sprint-planning | Génère un sprint plan depuis les epics. Organise les stories en sprints avec estimation. | | /mdan-dev-story | Implémente une story depuis son fichier de spec. TDD, tests et documentation automatique. | | /mdan-code-review | Review de code adversariale : détecte les bugs, problèmes de sécurité et violations de patterns. |

Wizards — Phase 5 : Livraison

| Commande | Description | |----------|-------------| | /mdan-document-project | Génère la documentation complète du projet : overview, deep-dives, source tree. |

Flows rapides

| Commande | Description | |----------|-------------| | /mdan-quick-dev | Développement rapide en 6 étapes pour les petits changements. Détection de mode, contexte, exécution, self-check et review. | | /mdan-quick-spec | Spec technique rapide en 4 étapes. Produit une spec prête pour l'implémentation. |

Modes spéciaux

| Commande | Description | |----------|-------------| | /mdan-party-mode | Mode multi-agents : 3 modes — Discussion, Débat, Consensus. Agent sidecars, Decision Records, Context Graph. | | /mdan-debate | Débat structuré standalone entre agents (Partisan 🟢 vs Opposant 🔴 + Arbitre ⚖️). 3 rounds → Arbitrage → Decision Record. | | /mdan-brainstorming | Session de brainstorming avec 12+ techniques créatives (SCAMPER, Six Thinking Hats, Mind Mapping, etc.). |

Commandes CLI

| Commande | Description | |----------|-------------| | mdan serve | Démarre le serveur MCP (stdio ou SSE) | | mdan impact <id> | Analyse d'impact d'un artifact dans le Context Graph | | mdan graph | Affiche le Context Graph en diagramme Mermaid |

Les Agents

Les agents sont des personnalités IA spécialisées que vous pouvez invoquer directement.

Équipe principale

| Commande | Agent | Rôle | |----------|-------|------| | /mdan-agent-pm | Khalil | MDAN Master — Orchestre tout le projet, gère les wizards, garde la mémoire | | /mdan-agent-analyst | Amina | Business Analyst — Recherche, briefs, analyse de marché | | /mdan-agent-architect | Reda | Architect — Architecture système, tech stack, patterns | | /mdan-agent-dev | Haytame | Developer — Implémentation, TDD, code propre | | /mdan-agent-qa | Fatima | QA Engineer — Tests, qualité, stratégie de test | | /mdan-agent-ux-designer | Jihane | UX Designer — Design UX/UI, wireframes, prototypes | | /mdan-agent-tech-writer | Youssef | Technical Writer — Documentation technique, guides, API docs | | /mdan-agent-sm | Nadia | Scrum Master — Gestion agile, sprints, rétrospectives | | /mdan-agent-security | Yassir | Security Engineer — Audit de sécurité, threat modeling, OWASP Top 10 | | /mdan-agent-quick-flow-solo-dev | — | Solo Dev — Mode rapide tout-en-un pour développeurs solo |

Pack FinTech

| Commande | Agent | Rôle | |----------|-------|------| | /mdan-agent-fintech-compliance-officer | Rachid | Compliance Officer — Conformité réglementaire (GDPR, PCI DSS, AML/KYC), audit, politiques | | /mdan-agent-fintech-financial-analyst | Amina | Financial Analyst — Modélisation financière, analyse de marché, reporting | | /mdan-agent-fintech-risk-manager | Karim | Risk Manager — Identification et mitigation des risques, stress testing |

Pack DevOps & Azure

| Commande | Agent | Rôle | |----------|-------|------| | /mdan-agent-devops-azure-azure-specialist | Reda | Azure Specialist — Architecture cloud Azure, migration, optimisation des coûts | | /mdan-agent-devops-azure-cicd-architect | Yassine | CI/CD Architect — Pipelines CI/CD, déploiement blue-green/canary, automatisation | | /mdan-agent-devops-azure-devops-engineer | Omar | DevOps Engineer — Infrastructure as Code (Terraform, Bicep), monitoring, Kubernetes |

Pack Database Optimization

| Commande | Agent | Rôle | |----------|-------|------| | /mdan-agent-db-optimization-query-optimizer | Driss | Query Optimizer — Analyse de plans d'exécution, tuning SQL, détection N+1 | | /mdan-agent-db-optimization-indexing-specialist | Salma | Indexing Specialist — Stratégie d'indexation, index composites, audit d'index | | /mdan-agent-db-optimization-performance-analyst | Mehdi | DB Performance Analyst — Monitoring, diagnostic, capacity planning, tuning |

Pack Ecosystem — 2,014 Composants 🌐

Module qui connecte MDAN à l'écosystème complet Claude Code : 1,053 skills, 418 agents, 340 commandes, 67 hooks, 67 settings, 69 MCPs.

| Agent | Nom | Rôle | |-------|-----|------| | 🧠 IA Master | Fayçal | Chef de la stratégie IA — Fine-tuning, RAG, agents, MLOps, 130+ skills AI. Décide tous les choix IA, reporte à Khalil. | | 🎯 Skill Dispatcher | Nadia | Routeur central — Route vers les 1,053 skills, 418 agents, 340 commandes. Catalogue complet. | | 🔬 Research Team Lead | Leila | Chef de recherche — Deep research, bioinformatique, 126 skills scientifiques, PubMed, UniProt. | | 🛡️ Security Specialist | Samir | Expert sécurité — 40+ skills sécurité, pentesting, OWASP, threat modeling, compliance. | | 🏗️ Fullstack Architect | Amine | Architecte fullstack — 200+ skills dev, system design, frontend/backend/infra. | | 🚀 DevOps Commander | Youssef | Commandant DevOps — CI/CD, K8s, Terraform, 39 agents infra, 11 commandes de déploiement. | | 📈 Marketing Strategist | Imane | Stratège marketing — SEO, growth hacking, ads, contenu, email, publication multi-plateforme. | | 📊 Data Scientist | Saad | Data scientist — Analyse, visualisation, ML, ETL, dbt, Power BI, Tableau. | | 💡 Product Lead | Adnane | Chef produit — PRDs, sprints, estimation, roadmap, communication stakeholders. |

Utilisation :

> ecosystem        # 🎯 Ouvre le skill dispatcher (Nadia)
> ai               # 🧠 Consulte le IA Master (Fayçal)
> security         # 🛡️ Lance le Security Specialist (Samir)
> devops           # 🚀 Active le DevOps Commander (Youssef)
> data             # 📊 Parle au Data Scientist (Saad)
> marketing        # 📈 Consulte la Marketing Strategist (Imane)
> product          # 💡 Travaille avec le Product Lead (Adnane)
> research         # 🔬 Lance la Research Team Lead (Leila)
> fullstack        # 🏗️ Consulte le Fullstack Architect (Amine)

Hiérarchie :

🧙 Khalil (MDAN Master) — Gère TOUT le projet
  ├── 🧠 Fayçal (IA Master) — Gère tout ce qui est IA/ML
  ├── 🎯 Nadia (Skill Dispatcher) — Route vers 2,014 composants
  ├── 🔬 Leila (Research) ── 🛡️ Samir (Security)
  ├── 🏗️ Amine (Fullstack) ── 🚀 Youssef (DevOps)
  ├─��� 📈 Imane (Marketing) ── 📊 Saad (Data)
  └── 💡 Adnane (Product)

Système de mémoire

_mdan/
├── core/config.yaml            ← Configuration du projet
├── state/
│   ├── MDAN-STATE.json         ← État global persistant
│   ├── context-graph.json      ← DAG des artifacts et relations
│   └─�� sidecars/               ← Mémoire persistante de chaque agent
├── ecosystem/                  ← Bridge vers 2,014 composants
│   ├── catalog/CATALOG.md      ← Index complet de l'écosystème
│   └── agents/                 ← 9 agents spécialisés
└── _config/manifest.yaml       ← État de l'installation

Le contexte persiste entre :
- Les wizards (le PRD a accès au brief)
- Les sessions (reprise automatique)
- Les agents (décisions partagées + sidecars)
- Le Context Graph (traçabilité de tous les artifacts)

Protocole de débat

Lorsqu'une décision critique arrive (choix de stack, pattern, priorisation), les agents débattent :

Mode Discussion (Original)

Conversation libre, 2-3 agents répondent par rotation.

Mode Débat ⚔️

3 rôles : Partisan 🟢, Opposant 🔴, Arbitre ⚖️

Round 1: Ouverture     → Chaque agent présente sa position (max 150 mots)
Round 2: Réfutation    → Chaque agent répond directement à l'autre
Round 3: Final         → Derniers arguments avant l'arbitrage

→ Arbitrage : L'arbitre décide avec justification, score de confiance et dissidence
→ Decision Record (DR-XXX) : Enregistré automatiquement dans le Context Graph

Mode Consensus 🤝

3-5 agents convergent :

Phase 1: Positions    → Chaque agent présente sa position
Phase 2: Cartographie → Zones d'accord ✅ et de tension ⚠️
Phase 3: Convergence  → Les agents ajustent positions et concessions
Phase 4: Synthèse     → Position fusionnée intégrant toutes les perspectives

→ Decision Record enregistré dans le Context Graph

Architecture (v3.1)

_mdan/                          ← Modules MDAN installés
├── _config/                    ← Manifests, configuration agents
├── core/                       ← Moteur (wizard engine, workflow.xml)
├── mdan/                       ← Module principal (workflows, teams)
├── state/                      ← État runtime (graph, sidecars)
���── ecosystem/                  ← Bridge vers l'écosystème (2,014 composants)
│   ├── agents/                 ← 9 agents spécialisés
│   └── catalog/                ← Index complet
└── {module}/                   ← Modules de domaine (fintech, devops-azure, etc.)

tools/
├���─ cli/                        ← Commandes CLI (serve, impact, graph)
���   └── lib/                    ← Librairies (context-graph)
└─�� mcp/                        ← Serveur MCP
    ��── tools/                  ← Enregistrement des outils MCP
    │   ├── workflow-tools.js
    │   ├── agent-tools.js
    │   ├── graph-tools.js
    │   ├── orchestration-tools.js
    │   └── ecosystem-tools.js  ← 7 nouveaux outils écosystème
    └── resources/              ← Enregistrement des ressources MCP

Installation

Via npm (recommandé)

npx mdan-method install

Manuellement

git clone https://github.com/khalilbenaz/MDAN.git
cd MDAN && npm install
node tools/cli/mdan-cli.js install

IDE supportés

Claude Code, Gemini CLI, OpenCode, QwenCoder, Cursor, Windsurf, Cline, Codex, et bien d'autres.

⚡ Règles de communication — Tous les composants

Chaque agent, wizard et skill de MDAN applique un mode de communication ultra-concis :

• Outil d'abord, parler ensuite — Agir avant d'expliquer
• Résultat d'abord — Commencer par le résultat, pas le processus
• S'arrêter quand c'est fait — Pas de résumé, pas de récap, pas de commentaire superflu
• Pas de remplissage — Jamais de "avec plaisir", "bien sûr !", "bonne question", "je vais"
• Pas de formules de politesse — Direct et franc
• Minimum de mots — Si un mot suffit, ne pas en utiliser dix
• Pas d'explications non sollicitées — Le diff parle de lui-même

Licence

MIT