mdan-method 2.6.3

package/INSTALL.md

@@ -0,0 +1,246 @@
+# MDAN Installation Guide
+
+This guide will help you install and set up MDAN on your system.
+
+## 📋 Prerequisites
+
+Before installing MDAN, ensure you have the following:
+
+- **Node.js** v20.0.0 or higher
+- **npm** v9.0.0 or higher
+- **Git** (for cloning the repository)
+- **Python** v3.8 or higher (for running agents)
+- An AI IDE (Claude Code, Cursor, or similar)
+
+### Checking Prerequisites
+
+```bash
+# Check Node.js version
+node --version  # Should be v20.0.0 or higher
+
+# Check npm version
+npm --version   # Should be v9.0.0 or higher
+
+# Check Python version
+python --version  # Should be v3.8 or higher
+
+# Check Git version
+git --version
+```
+
+## 🚀 Installation Methods
+
+### Method 1: NPM Installation (Recommended)
+
+This is the easiest way to install MDAN globally on your system.
+
+```bash
+# Install MDAN globally
+npm install -g mdan-ai
+
+# Verify installation
+mdan-ai --version
+```
+
+**Package URL:** https://www.npmjs.com/package/mdan-ai
+
+### Method 2: Local Installation
+
+Install MDAN locally in your project directory.
+
+```bash
+# Create a new project directory
+mkdir my-mdan-project
+cd my-mdan-project
+
+# Initialize MDAN
+npx mdan-ai install
+```
+
+### Method 3: Clone from GitHub
+
+Clone the repository and install dependencies manually.
+
+```bash
+# Clone the repository
+git clone https://github.com/khalilbenaz/MDANV2.git
+cd MDANV2
+
+# Install dependencies
+npm install
+
+# Link globally
+npm link
+
+# Verify installation
+mdan --version
+```
+
+**Repository URL:** https://github.com/khalilbenaz/MDANV2
+
+## ⚙️ Configuration
+
+### Environment Variables
+
+Create a `.env` file in your project root:
+
+```bash
+# Copy the example environment file
+cp .env.example .env
+
+# Edit the .env file with your configuration
+nano .env
+```
+
+Required environment variables:
+
+```env
+# AI Model Configuration
+OPENAI_API_KEY=your_openai_api_key_here
+ANTHROPIC_API_KEY=your_anthropic_api_key_here
+
+# MCP Server Configuration (Optional)
+BRAVE_API_KEY=your_brave_api_key_here
+GITHUB_TOKEN=your_github_token_here
+
+# MDAN Configuration
+MDAN_LOG_LEVEL=info
+MDAN_MAX_CONCURRENT_AGENTS=5
+```
+
+### MCP Server Configuration
+
+MDAN uses the Model Context Protocol (MCP) for tool access. The configuration is in `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/your/project"]
+    },
+    "brave-search": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-brave-search"]
+    },
+    "git": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-git", "--repository", "/path/to/your/project"]
+    },
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"]
+    }
+  }
+}
+```
+
+**Note:** Update the file paths to match your project directory.
+
+### AI IDE Configuration
+
+#### Claude Code
+
+1. Open Claude Code
+2. Open your project directory
+3. The `CLAUDE.md` file will be automatically loaded
+4. MDAN agents will be available in the agent selector
+
+#### Cursor
+
+1. Open Cursor
+2. Open your project directory
+3. The `.cursor/mcp.json` symlink will be automatically detected
+4. MDAN agents will be available in the agent selector
+
+## 🧪 Verification
+
+After installation, verify that everything is working correctly:
+
+```bash
+# Run the test suite
+npm test
+
+# Run scenario tests
+npm run test:scenarios
+
+# Run evaluations
+npm run test:evaluations
+```
+
+All tests should pass successfully.
+
+## 📦 Module Installation
+
+MDAN supports modular installation. You can install only the modules you need:
+
+```bash
+# Install only the FinTech pack
+npx mdan-ai install --modules fintech
+
+# Install multiple modules
+npx mdan-ai install --modules fintech devops-azure db-optimization
+
+# Install all modules
+npx mdan-ai install --modules all
+```
+
+Available modules:
+- `core` - Core MDAN framework
+- `mmm` - Business Model & Management
+- `mmb` - Module Builder
+- `cis` - Creative Innovation Strategy
+- `tea` - Test Engineering & Architecture
+- `fintech` - FinTech Pack
+- `devops-azure` - DevOps/Azure Pack
+- `db-optimization` - Database Optimization Pack
+
+## 🔧 Troubleshooting
+
+### Common Issues
+
+#### Issue: "node: command not found"
+
+**Solution:** Install Node.js from [nodejs.org](https://nodejs.org)
+
+#### Issue: "npm: command not found"
+
+**Solution:** npm is included with Node.js. Reinstall Node.js.
+
+#### Issue: "python: command not found"
+
+**Solution:** Install Python from [python.org](https://python.org)
+
+#### Issue: Tests fail with import errors
+
+**Solution:** Ensure all dependencies are installed:
+```bash
+npm install
+pip install -r requirements.txt
+```
+
+#### Issue: MCP servers not connecting
+
+**Solution:** Check that the file paths in `.mcp.json` are correct and that you have the necessary API keys in `.env`.
+
+### Getting Help
+
+If you encounter any issues not covered here:
+
+1. Check the [Documentation](./README.md)
+2. Search [GitHub Issues](https://github.com/khalilbenaz/MDANV2/issues)
+3. Create a new issue with detailed information about your problem
+
+## 🚀 Next Steps
+
+After successful installation:
+
+1. Read the [Usage Guide](./USAGE.md) to learn how to use MDAN
+2. Explore the [Agent List](./AGENTS_LIST.md) to see available agents
+3. Check the [Architecture Documentation](./ARCHITECTURE.md) to understand the system
+4. Start building with MDAN!
+
+---
+
+**Last Updated:** 28 February 2026
+**Version:** 2.6.0

package/LICENSE

@@ -0,0 +1,30 @@
+MIT License
+
+Copyright (c) 2025 MDAN Code, LLC
+
+This project incorporates contributions from the open source community.
+See [CONTRIBUTORS.md](CONTRIBUTORS.md) for contributor attribution.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+TRADEMARK NOTICE:
+MDAN™, MDAN Method™, and MDAN Core™ are trademarks of MDAN Code, LLC, covering all
+casings and variations (including MDAN, mdan, MDANMethod, MDAN-METHOD, etc.). The use of
+these trademarks in this software does not grant any rights to use the trademarks
+for any other purpose. See [TRADEMARK.md](TRADEMARK.md) for detailed guidelines.

package/MDAN.fr.md

@@ -0,0 +1,259 @@
+# MDAN — Spécification de la méthode v1.0
+
+> La spécification complète et faisant autorité de la méthode MDAN.
+
+---
+
+## Partie 1 : Vue d'ensemble
+
+MDAN (prononcé "em-dan") est une méthode structurée pour le développement logiciel piloté par l'IA.
+
+**Prémisse fondamentale :** Construire des logiciels avec des agents IA nécessite la même discipline que construire des logiciels avec des équipes humaines — des rôles clairs, des phases structurées, une qualité imposée et des transferts explicites. Sans cette structure, les agents IA inventent des tâches, se contredisent, sautent la validation et produisent des résultats incohérents.
+
+**La réponse MDAN :** Un orchestrateur central (MDAN Core) qui coordonne des agents spécialisés à travers un workflow en 5 phases, avec des portes de qualité imposées à chaque transition.
+
+---
+
+## Partie 2 : Principes
+
+### P1 — Orchestrer, pas exécuter
+MDAN Core est un agent de réflexion et de planification. Il n'exécute jamais directement. L'exécution appartient aux agents spécialisés.
+
+### P2 — Une phase à la fois
+Les phases sont séquentielles et non négociables. Une phase DISCOVER complète produit un meilleur BUILD qu'un DISCOVER bâclé ne le fera jamais.
+
+### P3 — Artefacts plutôt que mots
+Chaque phase produit des artefacts — des documents structurés avec des modèles définis. Des mots dans une fenêtre de chat ne sont pas des artefacts.
+
+### P4 — Validation explicite
+Chaque phase se termine par l'approbation explicite des artefacts par l'utilisateur. MDAN Core ne progresse jamais sans approbation.
+
+### P5 — Agnosticisme LLM
+MDAN produit des résultats identiques quel que soit le LLM sous-jacent. L'Universal Envelope est le mécanisme technique qui permet cela.
+
+### P6 — La sécurité n'est pas optionnelle
+Le Security Agent est actif en BUILD et VERIFY. La sécurité n'est pas une liste de contrôle en fin de projet — c'est une préoccupation parallèle tout au long du développement.
+
+### P7 — Échouer vite, échouer tôt
+Un problème trouvé en DISCOVER coûte 1 unité d'effort. Le même problème trouvé en SHIP coûte 100 unités.
+
+---
+
+## Partie 3 : Le MDAN Core
+
+MDAN Core est l'orchestrateur central. Il fonctionne selon ces règles :
+
+**Sait tout :** MDAN Core dispose toujours du contexte complet — PRD, architecture, spec UX, fonctionnalité en cours, décisions précédentes.
+
+**Délègue tout :** MDAN Core n'écrit jamais de code, ne conçoit pas d'interfaces, ne rédige pas de documentation. Il active l'agent approprié avec un brief précis.
+
+**Valide tout :** Chaque sortie d'agent est examinée par MDAN Core avant d'être présentée à l'utilisateur.
+
+**Guide et Assiste :** MDAN Core agit comme un collaborateur expert. L'utilisateur peut taper `/mdan-help` à tout moment pour obtenir des conseils contextuels sur la prochaine étape.
+
+**Mode "Party" :** Pour les problèmes complexes, MDAN Core peut invoquer plusieurs agents simultanément avec `/party [sujet]` pour faciliter un débat entre experts (ex: l'Architecte et l'Agent de Sécurité) avant de prendre une décision.
+
+**Contrôle les transitions de phase :** Seul MDAN Core peut déclarer une phase terminée et passer à la suivante. L'utilisateur doit approuver explicitement chaque transition.
+
+---
+
+## Partie 4 : Réseau d'agents
+
+### Règles de conception des agents
+
+Chaque agent MDAN est :
+1. **Personnifié** — Possède un prénom (ex: Khalil, Reda) pour rendre la collaboration naturelle
+2. **Spécialisé** — Un domaine, une expertise profonde
+3. **Autonome** — Opère indépendamment dans son domaine
+4. **Borné** — Ne peut pas prendre de décisions en dehors de son domaine (escalade au Core)
+5. **Auto-vérificateur** — Exécute une checklist de qualité avant de soumettre
+6. **Universel** — Fonctionne identiquement sur tous les LLMs via l'Universal Envelope
+
+### Hiérarchie des agents
+
+```
+MDAN Core (Orchestrateur)
+│
+├── Phase 1 — DISCOVER
+│   └── Product Agent
+│
+├── Phase 2 — DESIGN
+│   ├── Architect Agent
+│   └── UX Agent
+│
+├── Phase 3 — BUILD
+│   ├── Dev Agent
+│   └── Security Agent (concurrent)
+│
+├── Phase 4 — VERIFY
+│   ├── Test Agent
+│   └── Security Agent
+│
+└── Phase 5 — SHIP
+    ├── DevOps Agent
+    └── Doc Agent
+```
+
+---
+
+## Partie 5 : L'Universal Envelope
+
+L'Universal Envelope est la structure de prompt standard utilisée pour tous les agents MDAN. Il résout le problème de compatibilité LLM en normalisant le comportement des agents.
+
+### Champs de l'Envelope
+
+| Champ | Objectif |
+|-------|---------|
+| NAME | Identifiant de l'agent |
+| VERSION | Version du prompt pour le suivi |
+| ROLE | Description du rôle en une ligne |
+| PHASE | Phase(s) dans lesquelles l'agent opère |
+| REPORTS_TO | Toujours MDAN Core |
+| IDENTITY | Qui est l'agent — expertise et état d'esprit |
+| CAPABILITIES | Ce que l'agent peut produire |
+| CONSTRAINTS | Limites strictes sur ce que l'agent ne doit PAS faire |
+| INPUT_FORMAT | Ce que l'agent attend de MDAN Core |
+| OUTPUT_FORMAT | Comment l'agent doit structurer sa réponse |
+| QUALITY_CHECKLIST | Auto-validation avant soumission |
+| ESCALATION | Quand remonter des problèmes à MDAN Core |
+
+---
+
+## Partie 6 : Standard des artefacts
+
+Chaque artefact produit par les agents MDAN suit cet en-tête :
+
+```
+---
+Artefact : [Nom de l'artefact]
+Phase : [Nom de la phase]
+Agent : [Nom de l'agent]
+Version : [X.Y]
+Statut : Brouillon | Révision | Validé
+Date : [AAAA-MM-JJ]
+Projet : [Nom du projet]
+---
+```
+
+---
+
+## Partie 7 : Portes de qualité
+
+### Porte 1 : DISCOVER → DESIGN
+
+```
+[ ] Le problème est spécifiquement défini
+[ ] Au moins un persona utilisateur est complètement décrit
+[ ] Les métriques de succès sont mesurables
+[ ] Les contraintes sont documentées
+[ ] Le PRD est complet avec priorisation MoSCoW
+[ ] Le périmètre MVP est réaliste
+[ ] Toutes les user stories ont des critères d'acceptation
+[ ] Les risques sont identifiés avec plans de mitigation
+[ ] Les éléments hors périmètre sont explicitement listés
+[ ] L'utilisateur a approuvé le PRD
+```
+
+### Porte 2 : DESIGN → BUILD
+
+```
+[ ] Le diagramme d'architecture système est complet
+[ ] Toutes les exigences du PRD sont adressées
+[ ] La stack technique complète est spécifiée avec justifications
+[ ] Tous les modèles de données sont définis
+[ ] Tous les endpoints API sont spécifiés
+[ ] L'architecture de sécurité est définie
+[ ] Les exigences non-fonctionnelles sont adressées
+[ ] Les conventions de code sont documentées
+[ ] Au moins un ADR existe
+[ ] Le design system est complet
+[ ] Tous les écrans ont tous leurs états définis
+[ ] Les deux documents sont approuvés par l'utilisateur
+```
+
+### Porte 3 : BUILD → VERIFY
+
+```
+[ ] Toutes les fonctionnalités MVP sont implémentées
+[ ] Chaque fonctionnalité a des tests unitaires
+[ ] Aucun constat de sécurité CRITIQUE non résolu
+[ ] Aucun constat de sécurité ÉLEVÉ non résolu
+[ ] Le code suit les conventions du projet
+[ ] Pas de secrets codés en dur
+[ ] Tous les chemins d'erreur sont gérés
+```
+
+### Porte 4 : VERIFY → SHIP
+
+```
+[ ] Tous les critères d'acceptation ont une couverture de test
+[ ] Tous les tests passent
+[ ] La couverture de tests atteint la cible
+[ ] Les tests d'intégration passent
+[ ] Au moins 3 scénarios E2E validés
+[ ] Les critères de performance sont atteints
+[ ] La revue de sécurité finale est complète
+[ ] La documentation est complète
+[ ] Le runbook de déploiement est complet
+```
+
+---
+
+## Partie 8 : Cycle de vie MDAN
+
+```
+L'utilisateur présente l'idée de projet
+         │
+         ▼
+Phase 1 : DISCOVER
+   MDAN Core pose les 5 questions de découverte
+   Product Agent crée le PRD
+   L'utilisateur valide le PRD
+         │
+   [Porte 1]
+         │
+         ▼
+Phase 2 : DESIGN
+   Architect Agent crée le Document d'Architecture
+   UX Agent crée la Spécification UX
+   L'utilisateur valide les deux
+         │
+   [Porte 2]
+         │
+         ▼
+Phase 3 : BUILD
+   Pour chaque fonctionnalité :
+     Dev Agent implémente
+     Security Agent revoit
+     MDAN Core valide
+         │
+   [Porte 3]
+         │
+         ▼
+Phase 4 : VERIFY
+   Test Agent crée et exécute la suite de tests
+   Security Agent fait la revue finale
+   L'utilisateur approuve
+         │
+   [Porte 4]
+         │
+         ▼
+Phase 5 : SHIP
+   DevOps Agent déploie
+   Doc Agent documente
+   Validation post-déploiement
+         │
+         ▼
+   🚀 LANCÉ
+         │
+         ▼
+   Itération suivante → Retour en Phase 1
+```
+
+---
+
+## Partie 9 : Historique des versions
+
+| Version | Date | Changements |
+|---------|------|-------------|
+| 1.0.0 | 2025 | Version initiale |