Skip to content

khalilbenaz/MDAN

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
.claude/commands
.claude/commands
 
 
_mdan
_mdan
 
 
docs
docs
 
 
tools
tools
 
 
.gitignore
.gitignore
 
 
CHANGELOG.md
CHANGELOG.md
 
 
README.md
README.md
 
 
package-lock.json
package-lock.json
 
 
package.json
package.json
 
 

Repository files navigation

MDAN — Multi-Agent Development Agentic Network

MDAN

npm License: MIT Wizards Agents Packs

MDAN howa framework dial développement b l'IA, fih des agents spécialisés, des wizards interactifs step-by-step, un systÚme de mémoire persistante, w un protocole de débat structuré.

100% gratuit w open source. Made in Morocco.

Jdid f v3 🚀

MCP Server

Daba MDAN kaychtaghel bhal MCP server — ay IDE compatible b MCP (Claude Code, Cursor, etc.) ygdar yconnecter directement w yst3mel ga3 les workflows w les agents bhal des tools.

mdan serve            # stdio transport
mdan serve --sse      # SSE l remote

Zid had la config f .mcp.json dyalek :

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

Les MCP tools li disponibles :

Tool Chnou kadir
mdan_list-workflows Kaylisté ga3 les workflows
mdan_workflow_{name} Kayexécuté un workflow (create-prd, create-architecture, etc.)
mdan_list-agents Kaylisté ga3 les agents installés
mdan_agent_{name} Kayconsulté un agent spécifique
mdan_graph_impact Analyse d'impact en aval d'un artifact
mdan_graph_visualize Diagramme Mermaid dial le context graph
mdan_orchestrate_party-mode Session multi-agent (discussion/debate/consensus)
mdan_orchestrate_create-decision-record Créé un decision record

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

Context Graph

DAG léger li kaytracké ga3 les relations entre les artifacts. Kol workflow mlli kaykmel, l'artifact automatiquement kayt-enregistré f 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
Loading

Les Decision Records dial les débats aussi kayt-enregistrów f le graphe.

Multi-Agent Orchestration Avancée

Party Mode daba 3endo 3 modes :

Mode Chnou fih
Discussion Conversation libre multi-agent (mode original)
Debate Argumentation structurĂ©e b 3 d les rĂŽles → Decision Record
Consensus N agents kayt-convergéw vers position mochterka

Debate mode — 3 rĂŽles : Proponent 🟱, Opponent 🔮, Arbitrator ⚖. 3 rounds structurĂ©s. Automatiquement kayproduisĂ© Decision Record (DR-XXX) w kayt-enregistrĂ© f le Context Graph.

Consensus mode — 3-5 agents kaymchiw f 4 phases : positions initiales → mapping d'accord/dĂ©saccord → itĂ©rations de convergence → synthĂšse.

Agent Sidecars — MĂ©moire persistante l kol agent entre les sessions. Les agents kaytfekrĂłw les observations, les prĂ©fĂ©rences, w les dĂ©cisions dial les sessions prĂ©cĂ©dentes.

Bdew mn hna — Quick Start

npx mdan-method install

L'installeur kayguide-k bach tkhtar les modules w l'IDE dyalek (Claude Code, Gemini CLI, OpenCode, QwenCoder...).

Mn b3d, f l'IDE dyalek, kteb /mdan- w ghadi tchof ga3 les commandes li disponibles.

Les commandes li kaynin

Ga3 les commandes kaybdaw b /mdan-.

Wizards — Phase 1 : Discover (Lektichaf)

Commande Chnou kadir
/mdan-create-product-brief Kaycréé lik product brief collaboratif f 6 d les étapes. Kaydéfini la vision, les utilisateurs cibles, le scope w les métriques de succÚs.
/mdan-market-research Recherche dial souk : analyse concurrentielle, comportement dial les clients, pain points w les opportunités.
/mdan-technical-research Recherche technique : les technologies, patterns d'architecture, intégrations w les tendances.
/mdan-domain-research Recherche dial domaine : analyse sectorielle, réglementation, paysage concurrentiel.

Wizards — Phase 2 : Plan (Tkhtiit)

Commande Chnou kadir
/mdan-create-prd Kaycréé Product Requirements Document kamel f 12 étape. Fih la vision, les user journeys, le scoping, les requirements fonctionnels w non-fonctionnels.
/mdan-create-ux-design Kayplani le design UX f 14 Ă©tape : discovery, design system, fondations visuelles, user journeys, composants w responsive.

Wizards — Phase 3 : Architect (L'handasa)

Commande Chnou kadir
/mdan-create-architecture Kaycréé l'architecture technique f 8 étapes : contexte, décisions, patterns, structure w validation.
/mdan-create-epics-and-stories Kayfssel les requirements l epics w user stories prĂȘtes bach tbda le dĂ©veloppement.

Wizards — Phase 4 : Build (Lbni)

Commande Chnou kadir
/mdan-sprint-planning Kaygénéré sprint plan mn les epics. Kayorganisi les stories f les sprints b estimation.
/mdan-dev-story Kayimplémenté une story b le fichier de spec dyalha. TDD, tests, w documentation automatique.
/mdan-code-review Review de code adversariale : kaylga les bugs, les problÚmes de sécurité w les violations dial patterns.

Wizards — Phase 5 : Ship (Tslim)

Commande Chnou kadir
/mdan-document-project Kaygénéré la documentation kamla dial le projet : overview, deep-dives, source tree.

Quick Flows (Bsser3a)

Commande Chnou kadir
/mdan-quick-dev Dev b ssre3a f 6 étapes l les changements sghir. Détection de mode, contexte, exécution, self-check w review.
/mdan-quick-spec Spec technique b ssre3a f 4 Ă©tapes. Kayproduit spec prĂȘte l l'implĂ©mentation.

Special (Khassa)

Commande Chnou kadir
/mdan-party-mode Mode multi-agents : 3 modes — Discussion, Debate, Consensus. Agent sidecars, Decision Records, Context Graph.
/mdan-brainstorming Session de brainstorming b 12+ techniques créatives (SCAMPER, Six Thinking Hats, Mind Mapping, etc.).

CLI Commands (Jdid f v3)

Commande Chnou kadir
mdan serve Kaystart le MCP server (stdio ou SSE)
mdan impact <id> Analyse d'impact d'un artifact f le Context Graph
mdan graph Kayaffiche le Context Graph bhal Mermaid diagram

Les Agents

Les agents homa des personnalités IA spécialisées, t9der t3ayyet 3lihom directement.

L'Ă©quipe principale

Commande Agent Chnou kaydir
/mdan-agent-pm Khalil Product Manager — Vision produit, PRD, priorisation, roadmap
/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 (STRIDE), OWASP Top 10, audit de dĂ©pendances, hardening
/mdan-agent-quick-flow-solo-dev — Solo Dev — Mode rapide tout-en-un l les dĂ©veloppeurs solo

Pack FinTech

Commande Agent Chnou kaydir
/mdan-agent-fintech-compliance-officer Rachid Compliance Officer — ConformitĂ© rĂ©glementaire (GDPR, PCI DSS, AML/KYC), audit, policies
/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 w mitigation dial les risques, stress testing

Pack DevOps & Azure

Commande Agent Chnou kaydir
/mdan-agent-devops-azure-azure-specialist Reda Azure Specialist — Architecture cloud Azure, migration, optimisation dial les 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 Chnou kaydir
/mdan-agent-db-optimization-query-optimizer Driss Query Optimizer — Analyse dial 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

SystĂšme de MĂ©moire

_mdan/
├── core/config.yaml            ← Configuration dial le projet
├── state/
│   ├── MDAN-STATE.json         ← État global persistant
│   ├── context-graph.json      ← DAG dial les artifacts w les relations
│   └── sidecars/               ← MĂ©moire persistante dial kol agent
└── _config/manifest.yaml       ← État dial l'installation

Le contexte kaybqa entre :
- Les wizards (le PRD 3endo accĂšs l le brief)
- Les sessions (reprise automatique)
- Les agents (les décisions partagées + sidecars)
- Le Context Graph (traçabilité dial ga3 les artifacts)

Debate Protocol

Mlli katwsel décision critique (choix de stack, pattern, priorisation), les agents kaydébatiw :

Discussion Mode (Original)

Conversation libre, 2-3 agents kaytjawbow b turn rotation.

Debate Mode (Jdid f v3) ⚔

3 rĂŽles : Proponent 🟱, Opponent 🔮, Arbitrator ⚖

Round 1: Opening      → Kol agent kayprĂ©sentĂ© la position dyalo (max 150 mots)
Round 2: Rebuttal     → Kol agent kayrĂ©pondĂ© directement l l'autre
Round 3: Final        → Derniers arguments avant l'arbitrage

→ Arbitration : L'arbitre kaydĂ©cidĂ© b rationale, confidence score w dissent
→ Decision Record (DR-XXX) : Kayt-enregistrĂ© automatiquement f le Context Graph

Consensus Mode (Jdid f v3) đŸ€

3-5 agents kayt-convergéw :

Phase 1: Positions    → Kol agent kayprĂ©sentĂ© la position dyalo
Phase 2: Mapping      → Zones d'accord ✅ w de tension ⚠
Phase 3: Convergence  → Les agents kaybddlo positions, concessions
Phase 4: SynthĂšse     → Position merguĂ©e li kaydkhol fiha ga3 les perspectives

→ Decision Record kayt-enregistrĂ© f le Context Graph

Architecture (v3)

_mdan/                          ← Modules MDAN installĂ©s
├── _config/                    ← Manifests, config agents
├── core/                       ← Moteur (wizard engine, workflow.xml)
├── mdan/                       ← Module principal (workflows, teams)
├── state/                      ← État runtime (graph, sidecars)
└── {module}/                   ← Modules de domaine (fintech, devops-azure, etc.)

tools/                          ← Nouveau f v3
├── cli/                        ← Commandes CLI (serve, impact, graph)
│   └── lib/                    ← Librairies (context-graph)
└── mcp/                        ← MCP Server
    ├── tools/                  ← Enregistrement dial les MCP tools
    └── resources/              ← Enregistrement dial les MCP resources

Installation

B 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

Les IDE supportés

Claude Code, Gemini CLI, OpenCode, QwenCoder, Cursor, Windsurf, Cline, Codex, w bzzaf d'autres.

Licence

MIT

16 wizards · 19 agents · 3 packs · MCP Server · Context Graph · Debate/Consensus
Msnou3 f lMghrib par @khalilbenaz

About

đŸ€– MDAN — Multi-Agent Development Agentic Network. 25 wizards, 29 agents, mĂ©moire persistante, debate protocol.

Topics

javascript automation memory multi-agent ai-agents llm agentic debate-protocol

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

2 tags

Packages

 
 
 

Contributors

Languages