mdan-cli 2.2.0 → 2.4.0

package/cli/mdan.sh

@@ -5,7 +5,7 @@
 # Multi-Agent Development Agentic Network
 # ============================================================
 
-VERSION="2.2.0"
+VERSION="2.4.0"
 MDAN_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 
 # Colors
@@ -110,7 +110,7 @@ cmd_learn() {
             echo "---"
             ;;
         --list)
-            KNOWLEDGE_FILE=".mdan/MDAN-KNOWLEDGE.md"
+            KNOWLEDGE_FILE="mdan/MDAN-KNOWLEDGE.md"
             if [[ -f "${KNOWLEDGE_FILE}" ]]; then
                 cat "${KNOWLEDGE_FILE}"
             else
@@ -120,7 +120,7 @@ cmd_learn() {
         --capsule)
             AGENT="${1}"
             echo -e "${CYAN}Capsule for agent: ${BOLD}${AGENT}${NC}"
-            KNOWLEDGE_FILE=".mdan/MDAN-KNOWLEDGE.md"
+            KNOWLEDGE_FILE="mdan/MDAN-KNOWLEDGE.md"
             if [[ -f "${KNOWLEDGE_FILE}" ]]; then
                 grep -A 20 "### ${AGENT^} Agent" "${KNOWLEDGE_FILE}" | head -25
             else
@@ -215,41 +215,41 @@ cmd_attach() {
         echo ""
     fi
     
-    # Check if .mdan already exists
-    if [[ -d ".mdan" ]]; then
-        echo -e "${YELLOW}⚠️  .mdan folder already exists.${NC}"
+    # Check if mdan already exists
+    if [[ -d "mdan" ]]; then
+        echo -e "${YELLOW}⚠️  mdan folder already exists.${NC}"
         read -p "   Overwrite? (y/n) " -n 1 -r
         echo
         if [[ ! $REPLY =~ ^[Yy]$ ]]; then
-            echo "   Keeping existing .mdan folder."
+            echo "   Keeping existing mdan folder."
         else
-            rm -rf .mdan
+            rm -rf mdan
         fi
     fi
     
-    # Create .mdan directory structure
-    mkdir -p .mdan/agents
-    mkdir -p .mdan/artifacts
-    mkdir -p .mdan/skills
+    # Create mdan directory structure
+    mkdir -p mdan/agents
+    mkdir -p mdan/artifacts
+    mkdir -p mdan/skills
     
     # Copy core files
-    cp "${MDAN_DIR}/core/orchestrator.md" .mdan/orchestrator.md
-    cp "${MDAN_DIR}/core/universal-envelope.md" .mdan/universal-envelope.md
+    cp "${MDAN_DIR}/core/orchestrator.md" mdan/orchestrator.md
+    cp "${MDAN_DIR}/core/universal-envelope.md" mdan/universal-envelope.md
     
     # Copy all agents
-    cp "${MDAN_DIR}/agents/"*.md .mdan/agents/
+    cp "${MDAN_DIR}/agents/"*.md mdan/agents/
     
     # Copy skills if available
     if [[ -d "${MDAN_DIR}/skills" ]]; then
-        cp -r "${MDAN_DIR}/skills/"* .mdan/skills/ 2>/dev/null
+        cp -r "${MDAN_DIR}/skills/"* mdan/skills/ 2>/dev/null
     fi
     
     # Create .cursorrules
     cat "${MDAN_DIR}/core/orchestrator.md" > .cursorrules
     echo "" >> .cursorrules
     echo "## CURSOR INSTRUCTIONS" >> .cursorrules
-    echo "Agent files are in .mdan/agents/. Reference them with @file when activating agents." >> .cursorrules
-    echo "Skills are in .mdan/skills/. Reference them for extended capabilities." >> .cursorrules
+    echo "Agent files are in mdan/agents/. Reference them with @file when activating agents." >> .cursorrules
+    echo "Skills are in mdan/skills/. Reference them for extended capabilities." >> .cursorrules
     echo "" >> .cursorrules
     
     if [[ "$REBUILD_MODE" == true ]]; then
@@ -283,7 +283,7 @@ cmd_attach() {
     
     # Create MDAN-STATE.json
     if [[ "$REBUILD_MODE" == true ]]; then
-        cat > .mdan/MDAN-STATE.json << EOF
+        cat > mdan/MDAN-STATE.json << EOF
 {
   "user": {
     "name": null
@@ -313,7 +313,7 @@ cmd_attach() {
 }
 EOF
     else
-        cat > .mdan/MDAN-STATE.json << EOF
+        cat > mdan/MDAN-STATE.json << EOF
 {
   "user": {
     "name": null
@@ -345,7 +345,7 @@ EOF
     
     # Create STATUS.md
     if [[ "$REBUILD_MODE" == true ]]; then
-        cat > .mdan/STATUS.md << EOF
+        cat > mdan/STATUS.md << EOF
 # MDAN Project Status — REBUILD MODE
 
 **Project:** ${PROJECT_NAME}
@@ -375,7 +375,7 @@ Rewrite the entire project from scratch with a modern architecture.
 2. Start with: "MDAN REBUILD: Begin DISCOVER phase. Analyze this entire codebase."
 EOF
     else
-        cat > .mdan/STATUS.md << EOF
+        cat > mdan/STATUS.md << EOF
 # MDAN Project Status
 
 **Project:** ${PROJECT_NAME} (existing)
@@ -396,17 +396,17 @@ EOF
 
 ## Commands to Start
 1. Open Claude/Cursor with this project
-2. Paste .mdan/orchestrator.md as system prompt
+2. Paste mdan/orchestrator.md as system prompt
 3. Start with: "MDAN: Analyze this existing project and help me [goal]"
 EOF
     fi
     
     echo -e "${GREEN}✅ MDAN attached to ${PROJECT_NAME}!${NC}"
     echo ""
-    echo -e "  ${BOLD}MDAN files:${NC} .mdan/"
-    echo -e "  ${BOLD}Agents:${NC} .mdan/agents/"
-    echo -e "  ${BOLD}Skills:${NC} .mdan/skills/"
-    echo -e "  ${BOLD}State:${NC} .mdan/MDAN-STATE.json"
+    echo -e "  ${BOLD}MDAN files:${NC} mdan/"
+    echo -e "  ${BOLD}Agents:${NC} mdan/agents/"
+    echo -e "  ${BOLD}Skills:${NC} mdan/skills/"
+    echo -e "  ${BOLD}State:${NC} mdan/MDAN-STATE.json"
     echo ""
     
     if [[ "$REBUILD_MODE" == true ]]; then
@@ -445,33 +445,33 @@ cmd_init() {
     echo -e "${CYAN}🚀 Initializing MDAN project: ${BOLD}${PROJECT_NAME}${NC}"
     echo ""
     
-    # Create .mdan directory structure
-    mkdir -p "${PROJECT_NAME}/.mdan/agents"
-    mkdir -p "${PROJECT_NAME}/.mdan/artifacts"
-    mkdir -p "${PROJECT_NAME}/.mdan/skills"
+    # Create mdan directory structure
+    mkdir -p "${PROJECT_NAME}/mdan/agents"
+    mkdir -p "${PROJECT_NAME}/mdan/artifacts"
+    mkdir -p "${PROJECT_NAME}/mdan/skills"
     mkdir -p "${PROJECT_NAME}/mdan_output"
     
     # Copy core files
-    cp "${MDAN_DIR}/core/orchestrator.md" "${PROJECT_NAME}/.mdan/orchestrator.md"
-    cp "${MDAN_DIR}/core/universal-envelope.md" "${PROJECT_NAME}/.mdan/universal-envelope.md"
+    cp "${MDAN_DIR}/core/orchestrator.md" "${PROJECT_NAME}/mdan/orchestrator.md"
+    cp "${MDAN_DIR}/core/universal-envelope.md" "${PROJECT_NAME}/mdan/universal-envelope.md"
     
     # Copy all agents
-    cp "${MDAN_DIR}/agents/"*.md "${PROJECT_NAME}/.mdan/agents/"
+    cp "${MDAN_DIR}/agents/"*.md "${PROJECT_NAME}/mdan/agents/"
     
     # Copy templates
     cp "${MDAN_DIR}/templates/"*.md "${PROJECT_NAME}/mdan_output/"
     
     # Copy skills if available
     if [[ -d "${MDAN_DIR}/skills" ]]; then
-        cp -r "${MDAN_DIR}/skills/"* "${PROJECT_NAME}/.mdan/skills/" 2>/dev/null
+        cp -r "${MDAN_DIR}/skills/"* "${PROJECT_NAME}/mdan/skills/" 2>/dev/null
     fi
     
     # Create .cursorrules
     cat "${MDAN_DIR}/core/orchestrator.md" > "${PROJECT_NAME}/.cursorrules"
     echo "" >> "${PROJECT_NAME}/.cursorrules"
     echo "## CURSOR INSTRUCTIONS" >> "${PROJECT_NAME}/.cursorrules"
-    echo "Agent files are in .mdan/agents/. Reference them with @file when activating agents." >> "${PROJECT_NAME}/.cursorrules"
-    echo "Skills are in .mdan/skills/. Reference them for extended capabilities." >> "${PROJECT_NAME}/.cursorrules"
+    echo "Agent files are in mdan/agents/. Reference them with @file when activating agents." >> "${PROJECT_NAME}/.cursorrules"
+    echo "Skills are in mdan/skills/. Reference them for extended capabilities." >> "${PROJECT_NAME}/.cursorrules"
     
     # Create .windsurfrules
     cp "${PROJECT_NAME}/.cursorrules" "${PROJECT_NAME}/.windsurfrules"
@@ -487,7 +487,7 @@ cmd_init() {
     cp "${MDAN_DIR}/core/orchestrator.md" "${PROJECT_NAME}/.github/copilot-instructions.md"
     
     # Create STATUS.md
-    cat > "${PROJECT_NAME}/.mdan/STATUS.md" << EOF
+    cat > "${PROJECT_NAME}/mdan/STATUS.md" << EOF
 # MDAN Project Status
 
 **Project:** ${PROJECT_NAME}
@@ -520,13 +520,13 @@ EOF
     echo -e "${GREEN}✅ MDAN project initialized successfully!${NC}"
     echo ""
     echo -e "  ${BOLD}Project:${NC} ${PROJECT_NAME}/"
-    echo -e "  ${BOLD}MDAN files:${NC} ${PROJECT_NAME}/.mdan/"
+    echo -e "  ${BOLD}MDAN files:${NC} ${PROJECT_NAME}/mdan/"
     echo -e "  ${BOLD}Templates:${NC} ${PROJECT_NAME}/mdan_output/"
-    echo -e "  ${BOLD}Skills:${NC} ${PROJECT_NAME}/.mdan/skills/"
+    echo -e "  ${BOLD}Skills:${NC} ${PROJECT_NAME}/mdan/skills/"
     echo ""
     echo -e "${YELLOW}Next steps:${NC}"
     echo "  1. Open your chosen LLM"
-    echo "  2. Paste .mdan/orchestrator.md as your system prompt"
+    echo "  2. Paste mdan/orchestrator.md as your system prompt"
     echo "  3. Start with: 'MDAN: I want to build ${PROJECT_NAME}'"
     echo ""
     echo -e "  Or for Cursor/Windsurf: open the ${PROJECT_NAME}/ folder — .cursorrules is ready"
@@ -654,9 +654,9 @@ cmd_prompt() {
 # STATUS
 # ============================================================
 
-# ============================================================n# OC (Orchestrator)n# ============================================================nncmd_oc() {n    ORCH_FILE=".mdan/orchestrator.md"n    if [[ ! -f "$ORCH_FILE" ]]; thenn        ORCH_FILE="${MDAN_DIR}/core/orchestrator.md"n    fin    n    if [[ -f "$ORCH_FILE" ]]; thenn        if command -v pbcopy &> /dev/null; thenn            cat "$ORCH_FILE" | pbcopyn            echo -e "${GREEN}✅ Orchestrator prompt copied to clipboard!${NC}"n            echo "   Paste it into Claude, ChatGPT, or your favorite LLM."n        elif command -v xclip &> /dev/null; thenn            cat "$ORCH_FILE" | xclip -selection clipboardn            echo -e "${GREEN}✅ Orchestrator prompt copied to clipboard!${NC}"n            echo "   Paste it into Claude, ChatGPT, or your favorite LLM."n        elif command -v wl-copy &> /dev/null; thenn            cat "$ORCH_FILE" | wl-copyn            echo -e "${GREEN}✅ Orchestrator prompt copied to clipboard!${NC}"n            echo "   Paste it into Claude, ChatGPT, or your favorite LLM."n        elsen            cat "$ORCH_FILE"n            echo -e "\n${YELLOW}⚠️  Could not copy to clipboard automatically. Please copy the text above.${NC}"n        fin    elsen        echo -e "${RED}Orchestrator file not found.${NC}"n    fin}nn
+# ============================================================n# OC (Orchestrator)n# ============================================================nncmd_oc() {n    ORCH_FILE="mdan/orchestrator.md"n    if [[ ! -f "$ORCH_FILE" ]]; thenn        ORCH_FILE="${MDAN_DIR}/core/orchestrator.md"n    fin    n    if [[ -f "$ORCH_FILE" ]]; thenn        if command -v pbcopy &> /dev/null; thenn            cat "$ORCH_FILE" | pbcopyn            echo -e "${GREEN}✅ Orchestrator prompt copied to clipboard!${NC}"n            echo "   Paste it into Claude, ChatGPT, or your favorite LLM."n        elif command -v xclip &> /dev/null; thenn            cat "$ORCH_FILE" | xclip -selection clipboardn            echo -e "${GREEN}✅ Orchestrator prompt copied to clipboard!${NC}"n            echo "   Paste it into Claude, ChatGPT, or your favorite LLM."n        elif command -v wl-copy &> /dev/null; thenn            cat "$ORCH_FILE" | wl-copyn            echo -e "${GREEN}✅ Orchestrator prompt copied to clipboard!${NC}"n            echo "   Paste it into Claude, ChatGPT, or your favorite LLM."n        elsen            cat "$ORCH_FILE"n            echo -e "\n${YELLOW}⚠️  Could not copy to clipboard automatically. Please copy the text above.${NC}"n        fin    elsen        echo -e "${RED}Orchestrator file not found.${NC}"n    fin}nn
 cmd_status() {
-    STATUS_FILE=".mdan/STATUS.md"
+    STATUS_FILE="mdan/STATUS.md"
     if [[ -f "${STATUS_FILE}" ]]; then
         cat "${STATUS_FILE}"
     else

package/install.sh

@@ -1,7 +1,7 @@
 #!/bin/bash
 
 # ============================================================
-# MDAN Installer
+# MDAN Installer (Remote Fetch)
 # ============================================================
 
 set -e
@@ -15,6 +15,7 @@ NC='\033[0m'
 
 INSTALL_DIR="$HOME/.mdan"
 BIN_DIR="$HOME/.local/bin"
+REPO_URL="https://github.com/khalilbenaz/MDAN/archive/refs/heads/main.tar.gz"
 
 echo -e "${CYAN}"
 echo "  ███╗   ███╗██████╗  █████╗ ███╗   ██╗"
@@ -27,9 +28,6 @@ echo -e "${NC}"
 echo -e "  ${BOLD}MDAN Installer${NC}"
 echo ""
 
-# Get the directory where this script is located
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
 echo -e "${YELLOW}Installing MDAN...${NC}"
 echo ""
 
@@ -37,171 +35,35 @@ echo ""
 mkdir -p "$INSTALL_DIR"
 mkdir -p "$BIN_DIR"
 
+# Download and extract the repository
+echo "  ⬇️  Downloading latest MDAN files..."
+TMP_DIR=$(mktemp -d)
+curl -sL "$REPO_URL" | tar -xz -C "$TMP_DIR"
+MDAN_SRC="$TMP_DIR/MDAN-main"
+
 # Copy MDAN files
 echo "  📁 Copying files to $INSTALL_DIR..."
-cp -r "$SCRIPT_DIR/core" "$INSTALL_DIR/"
-cp -r "$SCRIPT_DIR/agents" "$INSTALL_DIR/"
-cp -r "$SCRIPT_DIR/phases" "$INSTALL_DIR/"
-cp -r "$SCRIPT_DIR/templates" "$INSTALL_DIR/"
-cp -r "$SCRIPT_DIR/integrations" "$INSTALL_DIR/"
-cp -r "$SCRIPT_DIR/memory" "$INSTALL_DIR/"
-cp -r "$SCRIPT_DIR/skills" "$INSTALL_DIR/" 2>/dev/null || mkdir -p "$INSTALL_DIR/skills"
-cp "$SCRIPT_DIR/MDAN.md" "$INSTALL_DIR/" 2>/dev/null || true
-cp "$SCRIPT_DIR/MDAN.fr.md" "$INSTALL_DIR/" 2>/dev/null || true
-
-# Create the mdan command
-echo "  🔧 Creating mdan command..."
+cp -r "$MDAN_SRC/core" "$INSTALL_DIR/"
+cp -r "$MDAN_SRC/agents" "$INSTALL_DIR/"
+cp -r "$MDAN_SRC/phases" "$INSTALL_DIR/"
+cp -r "$MDAN_SRC/templates" "$INSTALL_DIR/"
+cp -r "$MDAN_SRC/integrations" "$INSTALL_DIR/"
+cp -r "$MDAN_SRC/memory" "$INSTALL_DIR/"
+cp -r "$MDAN_SRC/modules" "$INSTALL_DIR/" 2>/dev/null || true
+cp -r "$MDAN_SRC/workflows" "$INSTALL_DIR/" 2>/dev/null || true
+cp -r "$MDAN_SRC/skills" "$INSTALL_DIR/" 2>/dev/null || mkdir -p "$INSTALL_DIR/skills"
+cp "$MDAN_SRC/MDAN.md" "$INSTALL_DIR/" 2>/dev/null || true
+cp "$MDAN_SRC/MDAN.fr.md" "$INSTALL_DIR/" 2>/dev/null || true
+
+# Cleanup
+rm -rf "$TMP_DIR"
+
+# Create the mdan command using the Node.js version instead of the bash version for better UX
+echo "  🔧 Setting up CLI..."
 cat > "$BIN_DIR/mdan" << 'MDAN_SCRIPT'
 #!/bin/bash
-
-VERSION="2.2.0"
-MDAN_DIR="$HOME/.mdan"
-
-# Colors
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-CYAN='\033[0;36m'
-MAGENTA='\033[0;35m'
-BOLD='\033[1m'
-NC='\033[0m'
-
-banner() {
-    echo -e "${CYAN}"
-    echo "  ███╗   ███╗██████╗  █████╗ ███╗   ██╗"
-    echo "  ████╗ ████║██╔══██╗██╔══██╗████╗  ██║"
-    echo "  ██╔████╔██║██║  ██║███████║██╔██╗ ██║"
-    echo "  ██║╚██╔╝██║██║  ██║██╔══██║██║╚██╗██║"
-    echo "  ██║ ╚═╝ ██║██████╔╝██║  ██║██║ ╚████║"
-    echo "  ╚═╝     ╚═╝╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═══╝"
-    echo -e "${NC}"
-    echo -e "  ${BOLD}Multi-Agent Development Agentic Network${NC} v${VERSION}"
-    echo ""
-}
-
-show_help() {
-    banner
-    echo -e "${BOLD}USAGE${NC}"
-    echo "  mdan <command> [options]"
-    echo ""
-    echo -e "${BOLD}COMMANDS${NC}"
-    echo "  init [name]              Create a new project"
-    echo "  attach [--rebuild]       Add MDAN to existing project"
-    echo "  status                   Show project status"
-    echo "  phase [1-5]              Show phase guide"
-    echo "  agent [name]             Show agent prompt"
-    echo "  skills                   List available skills"
-    echo "  version                  Show version"
-    echo ""
-    echo -e "${BOLD}EXAMPLES${NC}"
-    echo "  mdan init my-app              # New project"
-    echo "  cd my-project && mdan attach  # Existing project"
-    echo "  mdan attach --rebuild         # Rebuild from scratch"
-    echo ""
-    echo -e "${BOLD}AGENTS${NC}"
-    echo "  product, architect, ux, dev, test, security, devops, doc"
-}
-
-cmd_init() {
-    PROJECT_NAME="${1:-my-project}"
-    echo -e "${CYAN}🚀 Creating: ${BOLD}${PROJECT_NAME}${NC}"
-    
-    mkdir -p "${PROJECT_NAME}/.mdan/agents"
-    mkdir -p "${PROJECT_NAME}/.mdan/skills"
-    mkdir -p "${PROJECT_NAME}/docs"
-    mkdir -p "${PROJECT_NAME}/.claude/skills"
-    mkdir -p "${PROJECT_NAME}/.github"
-    
-    cp "${MDAN_DIR}/core/orchestrator.md" "${PROJECT_NAME}/.mdan/"
-    cp "${MDAN_DIR}/core/universal-envelope.md" "${PROJECT_NAME}/.mdan/"
-    cp "${MDAN_DIR}/agents/"*.md "${PROJECT_NAME}/.mdan/agents/"
-    cp "${MDAN_DIR}/templates/"*.md "${PROJECT_NAME}/mdan_output/"
-    cp -r "${MDAN_DIR}/skills/"* "${PROJECT_NAME}/.mdan/skills/" 2>/dev/null || true
-    cp -r "${MDAN_DIR}/skills/"* "${PROJECT_NAME}/.claude/skills/" 2>/dev/null || true
-    
-    cat "${MDAN_DIR}/core/orchestrator.md" > "${PROJECT_NAME}/.cursorrules"
-    echo -e "\n## CURSOR INSTRUCTIONS\nAgent files in .mdan/agents/\nSkills in .mdan/skills/" >> "${PROJECT_NAME}/.cursorrules"
-    cp "${PROJECT_NAME}/.cursorrules" "${PROJECT_NAME}/.windsurfrules"
-    cp "${MDAN_DIR}/core/orchestrator.md" "${PROJECT_NAME}/.github/copilot-instructions.md"
-    
-    echo "# ${PROJECT_NAME}\n\n> Built with MDAN" > "${PROJECT_NAME}/README.md"
-    
-    echo -e "${GREEN}✅ Created ${PROJECT_NAME}/${NC}"
-    echo ""
-    echo "  ${BOLD}Next:${NC} cursor ${PROJECT_NAME}"
-}
-
-cmd_attach() {
-    REBUILD="${1}"
-    PROJECT_NAME=$(basename "$PWD")
-    
-    if [[ "$REBUILD" == "--rebuild" ]]; then
-        echo -e "${MAGENTA}🔄 REBUILD MODE: ${BOLD}${PROJECT_NAME}${NC}"
-    else
-        echo -e "${CYAN}🔗 Attaching to: ${BOLD}${PROJECT_NAME}${NC}"
-    fi
-    
-    mkdir -p .mdan/agents .mdan/skills .claude/skills .github
-    
-    cp "${MDAN_DIR}/core/orchestrator.md" .mdan/
-    cp "${MDAN_DIR}/core/universal-envelope.md" .mdan/
-    cp "${MDAN_DIR}/agents/"*.md .mdan/agents/
-    cp -r "${MDAN_DIR}/skills/"* .mdan/skills/ 2>/dev/null || true
-    cp -r "${MDAN_DIR}/skills/"* .claude/skills/ 2>/dev/null || true
-    
-    cat "${MDAN_DIR}/core/orchestrator.md" > .cursorrules
-    if [[ "$REBUILD" == "--rebuild" ]]; then
-        echo -e "\n## REBUILD MODE\nAnalyze existing code then rewrite from scratch." >> .cursorrules
-    else
-        echo -e "\n## EXISTING PROJECT\nAnalyze codebase before making changes." >> .cursorrules
-    fi
-    cp .cursorrules .windsurfrules
-    cp "${MDAN_DIR}/core/orchestrator.md" .github/copilot-instructions.md
-    
-    echo -e "${GREEN}✅ MDAN ready!${NC}"
-    echo ""
-    if [[ "$REBUILD" == "--rebuild" ]]; then
-        echo "  Start: ${CYAN}MDAN REBUILD: Analyze and rewrite this project${NC}"
-    else
-        echo "  Start: ${CYAN}MDAN: Analyze this project${NC}"
-    fi
-}
-
-cmd_status() {
-    if [[ -f ".mdan/orchestrator.md" ]]; then
-        echo -e "${GREEN}✅ MDAN is active in this project${NC}"
-        [[ -f ".mdan/STATUS.md" ]] && cat .mdan/STATUS.md
-    else
-        echo -e "${YELLOW}No MDAN project here.${NC}"
-        echo "  Run: mdan init [name]  or  mdan attach"
-    fi
-}
-
-cmd_phase() {
-    [[ -f "${MDAN_DIR}/phases/0${1}-"*.md ]] && cat "${MDAN_DIR}/phases/0${1}-"*.md || echo "Phase 1-5"
-}
-
-cmd_agent() {
-    [[ -f "${MDAN_DIR}/agents/${1}.md" ]] && cat "${MDAN_DIR}/agents/${1}.md" || echo "Agents: product, architect, ux, dev, test, security, devops, doc"
-}
-
-cmd_skills() {
-    echo -e "${CYAN}Skills:${NC}"
-    ls "${MDAN_DIR}/skills/" 2>/dev/null || echo "  No skills installed"
-}
-
-# Main
-case "${1}" in
-    init)       cmd_init "$2" ;;
-    attach)     cmd_attach "$2" ;;
-    status)     cmd_status ;;
-    phase)      cmd_phase "$2" ;;
-    agent)      cmd_agent "$2" ;;
-    skills)     cmd_skills ;;
-    version|-v) echo "MDAN v${VERSION}" ;;
-    help|--help|-h|"") show_help ;;
-    *)          echo "Unknown: $1. Run: mdan help" ;;
-esac
+# Wrapper to run the npx version of mdan-cli to ensure the interactive wizard works
+npx --yes mdan-cli "$@"
 MDAN_SCRIPT
 
 chmod +x "$BIN_DIR/mdan"
@@ -223,6 +85,7 @@ echo ""
 echo -e "${GREEN}✅ MDAN installed successfully!${NC}"
 echo ""
 echo -e "  ${BOLD}Usage:${NC}"
-echo "  mdan init my-project        # Create new project"
-echo "  cd existing && mdan attach  # Add to existing project"
+echo "  mdan init                 # Interactive setup"
+echo "  mdan init my-project      # Quick setup"
+echo "  cd existing && mdan attach"
 echo ""

package/integrations/all-integrations.md

@@ -251,14 +251,14 @@ opencode
 opencode "I want to build [your project idea]"
 
 # Reference agent prompts
-opencode "@file .mdan/agents/dev.md Implement the user authentication feature"
+opencode "@file mdan/agents/dev.md Implement the user authentication feature"
 ```
 
 ## Notes for Opencode
 
 - Opencode excels in the BUILD phase — it can directly edit files
 - Use MDAN feature briefs as opencode tasks
-- Place agent files in `.mdan/agents/` for easy reference
+- Place agent files in `mdan/agents/` for easy reference
 
 ---
 

package/integrations/cursor.md

@@ -20,21 +20,21 @@ You are operating inside Cursor IDE. In addition to your MDAN orchestration role
 - When the Doc Agent produces documentation, write it to the mdan_output/ folder
 
 ### Agent File References
-- Product Agent: @file .mdan/agents/product.md
-- Architect Agent: @file .mdan/agents/architect.md
-- UX Agent: @file .mdan/agents/ux.md
-- Dev Agent: @file .mdan/agents/dev.md
-- Test Agent: @file .mdan/agents/test.md
-- Security Agent: @file .mdan/agents/security.md
-- DevOps Agent: @file .mdan/agents/devops.md
-- Doc Agent: @file .mdan/agents/doc.md
+- Product Agent: @file mdan/agents/product.md
+- Architect Agent: @file mdan/agents/architect.md
+- UX Agent: @file mdan/agents/ux.md
+- Dev Agent: @file mdan/agents/dev.md
+- Test Agent: @file mdan/agents/test.md
+- Security Agent: @file mdan/agents/security.md
+- DevOps Agent: @file mdan/agents/devops.md
+- Doc Agent: @file mdan/agents/doc.md
 ```
 
 ### Step 2: Copy agents to project
 
 ```bash
-mkdir -p .mdan/agents
-cp agents/*.md .mdan/agents/
+mkdir -p mdan/agents
+cp agents/*.md mdan/agents/
 ```
 
 ### Step 3: Start using MDAN in Cursor
@@ -61,7 +61,7 @@ Enable Agent mode for autonomous implementation. MDAN Core will orchestrate, and
 
 ```
 .cursorrules          ← MDAN Core orchestrator prompt
-.mdan/
+mdan/
   agents/
     product.md
     architect.md

package/integrations/mcp.md

@@ -0,0 +1,153 @@
+# MDAN MCP Integration
+
+> Configure Model Context Protocol for MDAN with your IDE
+
+## Overview
+
+MDAN supports MCP (Model Context Protocol) to provide your coding assistant (Cursor, Claude Code, Windsurf) with deep understanding of MDAN workflows, agents, and best practices.
+
+## Quick Start
+
+### 1. Generate MCP Config
+
+```bash
+# In your MDAN project
+mdan mcp init
+```
+
+This creates `.mcp.json` in your project root.
+
+### 2. Configure Your IDE
+
+#### Cursor
+1. Open Cursor Settings → Features → Models
+2. MCP should auto-detect `.mcp.json`
+3. Or manually add via: Settings → Developer → Edit MCP Config
+
+#### Claude Code
+```bash
+claude mcp add mdan --project path/to/your/project
+```
+
+#### Windsurf
+MCP configs are auto-discovered from `.mcp.json` in project root.
+
+## Configuration
+
+### .mcp.json Structure
+
+```json
+{
+  "mcpServers": {
+    "mdan-memory": { ... }
+  },
+  "capabilities": {
+    "scenarios": {
+      "enabled": true,
+      "test_paths": ["tests/scenarios/"]
+    },
+    "evaluations": {
+      "enabled": true,
+      "eval_paths": ["tests/evaluations/"]
+    }
+  },
+  "agent_prompts": {
+    "dev": "templates/prompts/dev-agent.yaml"
+  }
+}
+```
+
+## Available MCP Tools
+
+### mdan-state
+
+Read/write MDAN project state.
+
+```typescript
+// Read current state
+const state = await mdan_state({ action: "read" });
+
+// Write state
+await mdan_state({ action: "write", data: { phase: "BUILD", progress: 50 } });
+```
+
+### mdan-agents
+
+List available MDAN agents.
+
+```typescript
+const agents = await mdan_agents();
+```
+
+### mdan-phases
+
+Get phase information.
+
+```typescript
+const phase = await mdan_phases({ name: "VERIFY" });
+```
+
+## IDE Integration Examples
+
+### Cursor Rules Auto-Generation
+
+When you run `mdan init` or `mdan attach`, MDAN automatically generates:
+
+- `.cursorrules` - Cursor-specific instructions
+- `.windsurfrules` - Windsurf-specific instructions
+- `.github/copilot-instructions.md` - Copilot instructions
+
+### Agent Context
+
+MCP provides your IDE with access to:
+
+1. **Agent prompts** - Full agent definitions for context
+2. **Phase workflows** - Current phase and next steps
+3. **Quality gates** - What's required to pass
+4. **Test templates** - Scenario and evaluation paths
+
+## Troubleshooting
+
+### MCP not detected
+
+1. Check `.mcp.json` is valid JSON
+2. Restart your IDE
+3. Check IDE MCP documentation
+
+### Tools not available
+
+1. Verify MCP server is running
+2. Check console for errors
+3. Try regenerating config: `mdan mcp init --force`
+
+## Commands
+
+```bash
+mdan mcp init          # Generate MCP config
+mdan mcp validate      # Validate config
+mdan mcp list          # Show available tools
+mdan mcp update        # Update to latest version
+```
+
+## Framework Support
+
+| IDE | MCP Support | Auto-detect |
+|-----|--------------|-------------|
+| Cursor | ✅ Full | ✅ |
+| Claude Code | ✅ Full | ✅ |
+| Windsurf | ✅ Full | ✅ |
+| VS Code | ✅ Via extension | Manual |
+
+## Integration with Better Agents
+
+MDAN's MCP config is compatible with Better Agents:
+
+- Scenarios in `tests/scenarios/` are auto-discovered
+- Evaluations in `tests/evaluations/` are available
+- Prompts from `templates/prompts/` are versioned
+
+This allows you to use Better Agents CLI alongside MDAN:
+
+```bash
+npx @langwatch/better-agents test --scenarios tests/scenarios/
+```