mdan-cli 2.5.1 → 2.7.0

package/AGENTS.md

@@ -228,6 +228,8 @@ my-project/
 | `mdan init` | Initialize project |
 | `mdan attach` | Add MDAN to existing project |
 | `mdan phase` | Show/run phase |
+| `mdan auto` | Run autonomous full-cycle development |
+| `mdan resume` | Resume from saved context |
 | `mdan mcp init` | Generate MCP config |
 | `mdan prompt list` | List prompts |
 | `mdan test` | Run tests |
@@ -235,12 +237,85 @@ my-project/
 
 ---
 
+## Agent Registry
+
+### Core Agents
+
+| Agent | Phase | Expertise |
+|-------|-------|-----------|
+| Product Agent (Khalil) | DISCOVER | Requirements gathering, PRD creation |
+| Architect Agent (Reda) | DESIGN | System architecture, tech stack |
+| UX Agent (Jihane) | DESIGN | User experience, UI/UX design |
+| Dev Agent (Haytame) | BUILD | Implementation, coding |
+| Security Agent (Said) | BUILD/VERIFY | Security review, vulnerability assessment |
+| Test Agent (Youssef) | VERIFY | Testing strategy, test execution |
+| DevOps Agent (Anas) | SHIP | Deployment, CI/CD, Azure |
+| Doc Agent (Amina) | SHIP | Documentation, user guides |
+| Learn Agent | Transverse | Knowledge management, learning |
+
+### Autonomous Agents
+
+| Agent | Phase | Expertise |
+|-------|-------|-----------|
+| Auto Orchestrator | ALL | Autonomous full-cycle development coordination |
+
+The Auto Orchestrator executes all 8 phases (LOAD → DISCOVER → PLAN → ARCHITECT → IMPLEMENT → TEST → DEPLOY → DOC) without human intervention, with context save/load capabilities and multi-agent debate support.
+
+---
+
+## CrewAI Integration
+
+MDANV2 includes a comprehensive CrewAI integration for intelligent multi-agent orchestration.
+
+### Installation
+
+```bash
+pip install -r requirements_crewai.txt
+```
+
+### Environment Variables
+
+```bash
+export SERPER_API_KEY="your-serper-api-key"
+export OPENAI_API_KEY="your-openai-api-key"
+```
+
+### Usage
+
+```python
+import asyncio
+from integrations.crewai import CrewAIOrchestrator
+
+async def main():
+    orchestrator = CrewAIOrchestrator(
+        project_path="/path/to/project",
+        llm=your_llm_instance,
+        auto_mode=True
+    )
+
+    # Run autonomous mode
+    result = await orchestrator.run_auto_mode("Build a todo app")
+
+asyncio.run(main())
+```
+
+### Components
+
+- **8 CrewAI Agents**: Product, Architect, UX, Dev, Test, Security, DevOps, Doc
+- **4 CrewAI Flows**: Auto, Discovery, Build, Debate
+- **3 Custom Tools**: Serper (web search), SQL (async database), File (file operations)
+- **Skill Router**: Intelligent skill detection and routing (50+ skills)
+
+### Documentation
+
+See `core/crewai_orchestrator.md` for complete documentation.
+
 ## Resources
 
 - [MDAN Documentation](https://github.com/khalilbenaz/MDAN)
 - [Better Agents](https://langwatch.ai/docs/better-agents)
 - [Agent Skills Standard](https://agentskills.io)
+- [CrewAI Documentation](https://docs.crewai.com)
 
 ---
-
 *This file is auto-generated by MDAN. Edit with care.*

package/README.md

@@ -27,16 +27,21 @@ Les outils IA traditionnels font le travail à votre place, produisant des résu
 
 ---
 
-## 🚀 Nouveautés dans MDAN v2.4
+## 🚀 Nouveautés dans MDAN v2.5
 
 **MDAN évolue rapidement avec des optimisations incluant :**
 
+- **MDAN-AUTO v1.0** — Mode de développement autonome sans intervention humaine
+- **Context Save/Resume** — Sauvegarde et reprise automatique du contexte à 80% des tokens
+- **Multi-Agent Debates** — Débats entre agents pour les décisions complexes
 - **Cross Platform Agent Team** — Agents multi-plateformes (Cursor, Windsurf, Claude Code, VS Code)
 - **Sub Agent Inclusion** — Sous-agents spécialisés pour des tâches ciblées
 - **Skills Architecture** — Architecture de skills extensible et modulable
 - **MDAN Builder v1** — Créez vos propres agents et workflows
 - **Dev Loop Automation** — Automatisation complète du cycle de développement
 - **Better Agents Integration** — Scenarios et evaluations intégrés
+- **Templates Génériques** — Templates services externes, .NET Blazor, SQL Server
+- **Architecture Modulaire** — Skills extensibles et modules spécialisés
 
 ---
 
@@ -119,8 +124,12 @@ MDAN s'étend avec des modules officiels pour domaines spécialisés :
 | Module | Description |
 |--------|-------------|
 | **MDAN Core** | Framework principal avec 5 phases |
+| **MDAN-AUTO** | Mode de développement autonome (8 phases) |
+| **External Services** | Templates d'intégration services externes génériques |
+| **.NET Blazor** | Templates projets .NET 8.0 Blazor Server |
+| **SQL Server** | Templates SQL Server (schema, stored procedures, functions) |
+| **Azure DevOps** | Skills pour Azure DevOps Services |
 | **Agile Scrum** | Workflows Agile/Scrum (Sprint, backlog, retrospectives) |
-| **Skills** | Compétences additionnelles |
 
 ```bash
 # Ajouter un module
@@ -129,8 +138,83 @@ mdan module add agile-scrum
 
 ---
 
+## 📋 Templates Disponibles
+
+MDAN fournit des templates génériques et réutilisables pour accélérer le développement :
+
+### External Services
+
+Templates d'intégration de services externes (APIs, microservices) :
+
+- `IService.cs` — Interface de base pour les services
+- `ServiceBase.cs` — Classe de base avec logging et gestion d'erreurs
+- `ServiceProvider.cs` — Gestionnaire de dépendances
+- `ExampleService.cs` — Exemple d'implémentation
+
+```bash
+# Utiliser le template
+cp templates/external-services/IService.cs src/Services/
+```
+
+### .NET Blazor
+
+Templates pour projets .NET 8.0 Blazor Server :
+
+- Structure de projet standard
+- Configuration de base
+- Exemples de composants
+
+```bash
+# Initialiser un projet Blazor
+mdan init mon-projet --template dotnet-blazor
+```
+
+### SQL Server
+
+Templates SQL Server pour bases de données :
+
+- `schema.sql` — Schéma de base de données
+- `stored-procedures.sql` — Procédures stockées
+- `functions.sql` — Fonctions SQL
+
+```bash
+# Utiliser les templates SQL
+cp templates/sql-server/schema.sql database/
+```
+
+---
+
 ## 🔧 Fonctionnalités Avancées
 
+### MDAN-AUTO v1.0 — Mode Autonome
+
+Développement entièrement autonome sans intervention humaine :
+
+```bash
+# Démarrer le mode autonome
+mdan auto
+
+# Reprendre depuis une sauvegarde
+mdan resume /tmp/mdan-save-1234567890.json
+```
+
+**Phases Autonomes** :
+1. **LOAD** — Chargement du contexte et des exigences
+2. **DISCOVER** — Analyse des exigences et user stories
+3. **PLAN** — Plan d'implémentation détaillé (#PHASE1, #PHASE2...)
+4. **ARCHITECT** — Conception de l'architecture système
+5. **IMPLEMENT** — Exécution de l'implémentation
+6. **TEST** — Tests complets (unitaires, intégration, E2E)
+7. **DEPLOY** — Déploiement en production
+8. **DOC** — Génération de la documentation
+
+**Fonctionnalités Clés** :
+- 🔄 Sauvegarde automatique à 80% des tokens
+- 🎯 Débats multi-agents pour décisions complexes
+- ⚡ Exécution séquentielle sans pause
+- 🚨 Fail-fast sur erreurs critiques
+- 📊 Signaux de progression (PHASE X COMPLETE ✅)
+
 ### Scenarios (Better Agents)
 
 Tests conversationnels end-to-end pour valider le comportement des agents.
@@ -187,8 +271,36 @@ mdan module add [nom]    # Installer un module
 mdan oc                  # Copier l'orchestrateur
 mdan agent [nom]         # Voir un agent
 mdan skills              # Lister les skills
+mdan auto                # Démarrer le mode autonome
+mdan resume <save-file>  # Reprendre depuis une sauvegarde
 mdan mcp [action]        # Config MCP
 mdan prompt [action]     # Gérer les prompts
+mdan crewai <command>    # CrewAI integration commands
+```
+
+### CrewAI CLI Commands
+
+```bash
+# Initialize CrewAI in a project
+mdan crewai init
+
+# Run autonomous mode
+mdan crewai auto "Build a todo app"
+
+# Start multi-agent debate
+mdan crewai debate "Best architecture for a microservices app"
+
+# Execute task with specific agent
+mdan crewai agent dev "Implement user authentication"
+
+# Execute specific flow
+mdan crewai flow discovery "Analyze requirements"
+
+# List available skills
+mdan crewai skills
+
+# Show CrewAI status
+mdan crewai status
 ```
 
 ---
@@ -215,12 +327,31 @@ projet/
 │   │   ├── test.md
 │   │   └── ...
 │   └── skills/              # Skills installés
+├── integrations/
+│   └── crewai/              # CrewAI integration
+│       ├── agents/          # 8 CrewAI agents
+│       ├── flows/           # 4 CrewAI flows
+│       ├── tools/           # Custom tools (Serper, SQL, File)
+│       ├── skills/          # Skill router
+│       └── orchestrator.py  # Main orchestrator
 ├── tests/
 │   ├── scenarios/           # Tests conversationnels
 │   └── evaluations/        # Évaluations benchmarks
 ├── templates/
-│   ├── prompts/            # Prompts versionnés (YAML)
-│   └── prompts.json        # Registre des prompts
+│   ├── external-services/   # Templates services externes génériques
+│   ├── dotnet-blazor/       # Templates .NET 8.0 Blazor Server
+│   ├── sql-server/          # Templates SQL Server
+│   ├── prompts/             # Prompts versionnés (YAML)
+│   └── prompts.json         # Registre des prompts
+├── phases/
+│   ├── auto-01-load.md      # Phase LOAD (autonome)
+│   ├── auto-02-discover.md  # Phase DISCOVER (autonome)
+│   ├── auto-03-plan.md      # Phase PLAN (autonome)
+│   ├── auto-04-architect.md # Phase ARCHITECT (autonome)
+│   ├── auto-05-implement.md # Phase IMPLEMENT (autonome)
+│   ├── auto-06-test.md      # Phase TEST (autonome)
+│   ├── auto-07-deploy.md    # Phase DEPLOY (autonome)
+│   └── auto-08-doc.md       # Phase DOC (autonome)
 ├── mdan_output/            # Artifacts générés par les agents
 ├── .cursorrules            # Pour Cursor
 ├── .windsurfrules         # Pour Windsurf
@@ -228,6 +359,7 @@ projet/
 ├── .github/               # Pour Copilot
 ├── .mcp.json             # Configuration MCP
 ├── AGENTS.md              # Guidelines de développement
+├── requirements_crewai.txt # CrewAI dependencies
 └── MDAN-STATE.json        # État de la session
 ```
 
@@ -250,6 +382,143 @@ MDAN se compose de plusieurs composants interconnectés :
 
 ---
 
+## 🧪 Tests et Qualité
+
+MDAN inclut une suite de tests complète pour garantir la qualité du code :
+
+### Framework de Tests
+
+- **pytest** — Framework de tests Python
+- **pytest-cov** — Couverture de code
+- **pytest-mock** — Mocking pour tests
+
+### Types de Tests
+
+| Type | Description | Emplacement |
+|------|-------------|-------------|
+| **Tests CLI** | Commandes CLI (init, attach, auto, etc.) | `tests/test_cli.py` |
+| **Tests Templates** | Validation des templates | `tests/test_templates.py` |
+| **Tests Services** | Patterns services externes | `tests/test_external_services.py` |
+| **Tests Installation** | Vérification installation | `tests/test_installation.py` |
+| **Tests Régression** | Pas de références wallet | `tests/test_regression.py` |
+
+### Exécuter les Tests
+
+```bash
+# Tous les tests
+pytest tests/ -v
+
+# Avec couverture
+pytest tests/ --cov=cli --cov-report=html
+
+# Tests spécifiques
+pytest tests/test_cli.py -v
+```
+
+### CI/CD
+
+GitHub Actions configurés pour :
+
+- **Tests automatiques** à chaque push
+- **Linting** avec ruff et mypy
+- **Couverture de code** minimale 80%
+
+```bash
+# Workflows CI/CD
+.github/workflows/test.yml
+.github/workflows/lint.yml
+```
+
+---
+
+## 🤖 CrewAI Integration
+
+MDANV2 includes a comprehensive CrewAI integration for intelligent multi-agent orchestration.
+
+### Installation
+
+```bash
+# Note: CrewAI requires Python 3.10-3.13
+pip install -r requirements_crewai.txt
+```
+
+### Environment Variables
+
+```bash
+export SERPER_API_KEY="your-serper-api-key"
+export OPENAI_API_KEY="your-openai-api-key"
+```
+
+### Usage
+
+```python
+import asyncio
+from integrations.crewai import CrewAIOrchestrator
+
+async def main():
+    orchestrator = CrewAIOrchestrator(
+        project_path="/path/to/project",
+        llm=your_llm_instance,
+        auto_mode=True
+    )
+
+    # Run autonomous mode
+    result = await orchestrator.run_auto_mode("Build a todo app")
+
+asyncio.run(main())
+```
+
+### Components
+
+- **8 CrewAI Agents**: Product, Architect, UX, Dev, Test, Security, DevOps, Doc
+- **4 CrewAI Flows**: Auto, Discovery, Build, Debate
+- **3 Custom Tools**: Serper (web search), SQL (async database), File (file operations)
+- **Skill Router**: Intelligent skill detection and routing (50+ skills)
+
+### Example Scripts
+
+See the `examples/` directory for complete examples:
+
+- `examples/crewai_auto_mode.py` — Autonomous mode example
+- `examples/crewai_debate.py` — Multi-agent debate example
+- `examples/crewai_custom_crew.py` — Custom crew creation example
+- `examples/crewai_with_sql.py` — SQL integration example (in-memory SQLite)
+- `examples/crewai_with_serper.py` — Web search example
+
+### Troubleshooting
+
+**Python Version Issue**: CrewAI requires Python 3.10-3.13. If you're using Python 3.14, you'll need to use a different Python version.
+
+```bash
+# Check Python version
+python --version
+
+# Create a virtual environment with Python 3.13
+python3.13 -m venv venv
+source venv/bin/activate
+pip install -r requirements_crewai.txt
+```
+
+**Import Errors**: Make sure you're running from the project root directory.
+
+```bash
+# Run from project root
+cd /path/to/MDANV2
+python examples/crewai_auto_mode.py
+```
+
+**Missing API Keys**: Ensure your environment variables are set.
+
+```bash
+# Check if keys are set
+echo $OPENAI_API_KEY
+echo $SERPER_API_KEY
+```
+
+### Documentation
+
+See `core/crewai_orchestrator.md` for complete documentation.
+
 ## 📚 Documentation
 
 | Document | Description |
@@ -257,6 +526,7 @@ MDAN se compose de plusieurs composants interconnectés :
 | [ARCHITECTURE.md](ARCHITECTURE.md) | Architecture technique |
 | [MDAN.md](MDAN.md) | Spécification complète |
 | [AGENTS.md](AGENTS.md) | Guidelines de développement |
+| [core/crewai_orchestrator.md](core/crewai_orchestrator.md) | CrewAI integration documentation |
 | [docs/fr/](docs/fr/) | Documentation en français |
 
 ---