mdan-cli 2.3.0 → 2.4.1

package/AGENTS.md

@@ -166,7 +166,7 @@ This generates `.mcp.json` with:
 
 ```
 my-project/
-├── .mdan/
+├── mdan/
 │   ├── orchestrator.md
 │   ├── agents/
 │   │   ├── dev.md

package/README.md

@@ -156,7 +156,7 @@ pour tout réécrire from scratch.
 - **Windsurf** — `.windsurfrules` auto-généré
 - **Claude Code** — `.claude/skills/` auto-généré
 - **GitHub Copilot** — `.github/copilot-instructions.md` auto-généré
-- **Claude Web** — Copier `.mdan/orchestrator.md`
+- **Claude Web** — Copier `mdan/orchestrator.md`
 
 ---
 
@@ -164,7 +164,7 @@ pour tout réécrire from scratch.
 
 ```
 projet/
-├── .mdan/
+├── mdan/
 │   ├── orchestrator.md      # System prompt
 │   ├── agents/              # Prompts des agents
 │   ├── skills/              # Skills installés

package/cli/mdan.js

@@ -6,7 +6,7 @@ const { execSync } = require('child_process');
 const { intro, text, select, isCancel, cancel, outro, spinner } = require('@clack/prompts');
 const pc = require('picocolors');
 
-const VERSION = '2.3.0';
+const VERSION = '2.4.1';
 const MDAN_DIR = path.resolve(__dirname, '..');
 
 // Colors
@@ -104,8 +104,8 @@ async function cmdInit(initialName) {
   s.start(`Creating ${name} project structure...`);
   
   const dirs = [
-    `${name}/.mdan/agents`,
-    `${name}/.mdan/skills`,
+    `${name}/mdan/agents`,
+    `${name}/mdan/skills`,
     `${name}/mdan_output`,
     `${name}/.claude/skills`,
     `${name}/.github`,
@@ -116,11 +116,11 @@ async function cmdInit(initialName) {
   
   dirs.forEach(dir => fs.mkdirSync(dir, { recursive: true }));
   
-  fs.copyFileSync(`${MDAN_DIR}/core/orchestrator.md`, `${name}/.mdan/orchestrator.md`);
-  fs.copyFileSync(`${MDAN_DIR}/core/universal-envelope.md`, `${name}/.mdan/universal-envelope.md`);
+  fs.copyFileSync(`${MDAN_DIR}/core/orchestrator.md`, `${name}/mdan/orchestrator.md`);
+  fs.copyFileSync(`${MDAN_DIR}/core/universal-envelope.md`, `${name}/mdan/universal-envelope.md`);
   
   fs.readdirSync(`${MDAN_DIR}/agents`).filter(f => f.endsWith('.md')).forEach(f => {
-    fs.copyFileSync(`${MDAN_DIR}/agents/${f}`, `${name}/.mdan/agents/${f}`);
+    fs.copyFileSync(`${MDAN_DIR}/agents/${f}`, `${name}/mdan/agents/${f}`);
   });
   
   fs.readdirSync(`${MDAN_DIR}/templates`).filter(f => f.endsWith('.md')).forEach(f => {
@@ -132,7 +132,7 @@ async function cmdInit(initialName) {
   if (fs.existsSync(skillsDir)) {
     fs.readdirSync(skillsDir).forEach(skill => {
       const src = `${skillsDir}/${skill}`;
-      const dest1 = `${name}/.mdan/skills/${skill}`;
+      const dest1 = `${name}/mdan/skills/${skill}`;
       const dest2 = `${name}/.claude/skills/${skill}`;
       if (fs.statSync(src).isDirectory()) {
         fs.cpSync(src, dest1, { recursive: true });
@@ -143,7 +143,7 @@ async function cmdInit(initialName) {
   
   // Create .cursorrules
   let cursorrules = fs.readFileSync(`${MDAN_DIR}/core/orchestrator.md`, 'utf8');
-  cursorrules += '\n\n## CURSOR INSTRUCTIONS\nAgent files are in .mdan/agents/\nSkills are in .mdan/skills/';
+  cursorrules += '\n\n## CURSOR INSTRUCTIONS\nAgent files are in mdan/agents/\nSkills are in mdan/skills/';
   fs.writeFileSync(`${name}/.cursorrules`, cursorrules);
   fs.copyFileSync(`${name}/.cursorrules`, `${name}/.windsurfrules`);
   fs.copyFileSync(`${MDAN_DIR}/core/orchestrator.md`, `${name}/.github/copilot-instructions.md`);
@@ -205,19 +205,19 @@ async function cmdAttach(rebuildMode) {
     ? `Preparing REBUILD environment for ${projectName}...` 
     : `Attaching MDAN to ${projectName}...`);
   
-  fs.mkdirSync('.mdan/agents', { recursive: true });
-  fs.mkdirSync('.mdan/skills', { recursive: true });
+  fs.mkdirSync('mdan/agents', { recursive: true });
+  fs.mkdirSync('mdan/skills', { recursive: true });
   fs.mkdirSync('.claude/skills', { recursive: true });
   fs.mkdirSync('.github', { recursive: true });
   fs.mkdirSync('tests/scenarios', { recursive: true });
   fs.mkdirSync('tests/evaluations', { recursive: true });
   fs.mkdirSync('templates/prompts', { recursive: true });
   
-  fs.copyFileSync(`${MDAN_DIR}/core/orchestrator.md`, '.mdan/orchestrator.md');
-  fs.copyFileSync(`${MDAN_DIR}/core/universal-envelope.md`, '.mdan/universal-envelope.md');
+  fs.copyFileSync(`${MDAN_DIR}/core/orchestrator.md`, 'mdan/orchestrator.md');
+  fs.copyFileSync(`${MDAN_DIR}/core/universal-envelope.md`, 'mdan/universal-envelope.md');
   
   fs.readdirSync(`${MDAN_DIR}/agents`).filter(f => f.endsWith('.md')).forEach(f => {
-    fs.copyFileSync(`${MDAN_DIR}/agents/${f}`, `.mdan/agents/${f}`);
+    fs.copyFileSync(`${MDAN_DIR}/agents/${f}`, `mdan/agents/${f}`);
   });
   
   // Copy skills
@@ -226,7 +226,7 @@ async function cmdAttach(rebuildMode) {
     fs.readdirSync(skillsDir).forEach(skill => {
       const src = `${skillsDir}/${skill}`;
       if (fs.statSync(src).isDirectory()) {
-        fs.cpSync(src, `.mdan/skills/${skill}`, { recursive: true });
+        fs.cpSync(src, `mdan/skills/${skill}`, { recursive: true });
         fs.cpSync(src, `.claude/skills/${skill}`, { recursive: true });
       }
     });
@@ -273,7 +273,7 @@ async function cmdAttach(rebuildMode) {
 }
 
 function cmdOc() {
-  let orchFile = '.mdan/orchestrator.md';
+  let orchFile = 'mdan/orchestrator.md';
   if (!fs.existsSync(orchFile)) {
     orchFile = `${MDAN_DIR}/core/orchestrator.md`;
   }
@@ -306,10 +306,10 @@ function cmdOc() {
 }
 
 function cmdStatus() {
-  if (fs.existsSync('.mdan/orchestrator.md')) {
+  if (fs.existsSync('mdan/orchestrator.md')) {
     console.log(`${colors.green}✅ MDAN is active in this project${colors.nc}`);
-    if (fs.existsSync('.mdan/STATUS.md')) {
-      console.log(fs.readFileSync('.mdan/STATUS.md', 'utf8'));
+    if (fs.existsSync('mdan/STATUS.md')) {
+      console.log(fs.readFileSync('mdan/STATUS.md', 'utf8'));
     }
   } else {
     console.log(`${colors.yellow}No MDAN project here.${colors.nc}`);
@@ -394,15 +394,15 @@ function cmdModule(action, name) {
 
   console.log(`${colors.cyan}📦 Installing module: ${colors.bold}${name}${colors.nc}`);
   
-  if (!fs.existsSync('.mdan')) {
-    console.log(`${colors.yellow}⚠️  No .mdan folder found. Are you in an MDAN project?${colors.nc}`);
+  if (!fs.existsSync('mdan')) {
+    console.log(`${colors.yellow}⚠️  No mdan folder found. Are you in an MDAN project?${colors.nc}`);
     return;
   }
 
   // Copy agents
   if (fs.existsSync(`${moduleDir}/agents`)) {
     fs.readdirSync(`${moduleDir}/agents`).forEach(f => {
-      fs.copyFileSync(`${moduleDir}/agents/${f}`, `.mdan/agents/${f}`);
+      fs.copyFileSync(`${moduleDir}/agents/${f}`, `mdan/agents/${f}`);
       console.log(`${colors.green}  Added agent:${colors.nc} ${f}`);
     });
   }

package/cli/mdan.py

@@ -7,7 +7,7 @@ import shutil
 import json
 from pathlib import Path
 
-VERSION = "2.2.0"
+VERSION = "2.4.1"
 MDAN_DIR = Path(__file__).parent.parent
 
 # Colors
@@ -19,6 +19,7 @@ MAGENTA = "\033[0;35m"
 BOLD = "\033[1m"
 NC = "\033[0m"
 
+
 def banner():
     print(f"{CYAN}")
     print("  ███╗   ███╗██████╗  █████╗ ███╗   ██╗")
@@ -30,6 +31,7 @@ def banner():
     print(f"{NC}")
     print(f"  {BOLD}Multi-Agent Development Agentic Network{NC} v{VERSION}\n")
 
+
 def show_help():
     banner()
     print(f"{BOLD}USAGE{NC}")
@@ -50,77 +52,90 @@ def show_help():
     print(f"{BOLD}AGENTS{NC}")
     print("  product, architect, ux, dev, test, security, devops, doc")
 
+
 def cmd_init(name="my-project"):
     print(f"{CYAN}🚀 Creating: {BOLD}{name}{NC}")
-    
+
     dirs = [
-        f"{name}/.mdan/agents", f"{name}/.mdan/skills", f"{name}/mdan_output",
-        f"{name}/.claude/skills", f"{name}/.github"
+        f"{name}/mdan/agents",
+        f"{name}/mdan/skills",
+        f"{name}/mdan_output",
+        f"{name}/.claude/skills",
+        f"{name}/.github",
     ]
     for d in dirs:
         Path(d).mkdir(parents=True, exist_ok=True)
-    
-    shutil.copy(f"{MDAN_DIR}/core/orchestrator.md", f"{name}/.mdan/")
-    shutil.copy(f"{MDAN_DIR}/core/universal-envelope.md", f"{name}/.mdan/")
-    
+
+    shutil.copy(f"{MDAN_DIR}/core/orchestrator.md", f"{name}/mdan/")
+    shutil.copy(f"{MDAN_DIR}/core/universal-envelope.md", f"{name}/mdan/")
+
     for f in Path(f"{MDAN_DIR}/agents").glob("*.md"):
-        shutil.copy(f, f"{name}/.mdan/agents/")
-    
+        shutil.copy(f, f"{name}/mdan/agents/")
+
     for f in Path(f"{MDAN_DIR}/templates").glob("*.md"):
         shutil.copy(f, f"{name}/mdan_output/")
-    
+
     skills_dir = Path(f"{MDAN_DIR}/skills")
     if skills_dir.exists():
         for s in skills_dir.iterdir():
             if s.is_dir():
-                shutil.copytree(s, f"{name}/.mdan/skills/{s.name}", dirs_exist_ok=True)
-                shutil.copytree(s, f"{name}/.claude/skills/{s.name}", dirs_exist_ok=True)
-    
+                shutil.copytree(s, f"{name}/mdan/skills/{s.name}", dirs_exist_ok=True)
+                shutil.copytree(
+                    s, f"{name}/.claude/skills/{s.name}", dirs_exist_ok=True
+                )
+
     cursorrules = Path(f"{MDAN_DIR}/core/orchestrator.md").read_text()
-    cursorrules += "\n\n## CURSOR INSTRUCTIONS\nAgent files in .mdan/agents/\nSkills in .mdan/skills/"
+    cursorrules += "\n\n## CURSOR INSTRUCTIONS\nAgent files in mdan/agents/\nSkills in mdan/skills/"
     Path(f"{name}/.cursorrules").write_text(cursorrules)
     shutil.copy(f"{name}/.cursorrules", f"{name}/.windsurfrules")
-    shutil.copy(f"{MDAN_DIR}/core/orchestrator.md", f"{name}/.github/copilot-instructions.md")
+    shutil.copy(
+        f"{MDAN_DIR}/core/orchestrator.md", f"{name}/.github/copilot-instructions.md"
+    )
     Path(f"{name}/README.md").write_text(f"# {name}\n\n> Built with MDAN\n")
-    
+
     print(f"{GREEN}✅ Created {name}/{NC}\n")
     print(f"  {BOLD}Next:{NC} cursor {name}")
 
+
 def cmd_attach(rebuild=None):
     project = Path.cwd().name
-    
+
     if rebuild == "--rebuild":
         print(f"{MAGENTA}🔄 REBUILD MODE: {BOLD}{project}{NC}")
     else:
         print(f"{CYAN}🔗 Attaching to: {BOLD}{project}{NC}")
-    
-    Path(".mdan/agents").mkdir(parents=True, exist_ok=True)
-    Path(".mdan/skills").mkdir(parents=True, exist_ok=True)
+
+    Path("mdan/agents").mkdir(parents=True, exist_ok=True)
+    Path("mdan/skills").mkdir(parents=True, exist_ok=True)
     Path(".claude/skills").mkdir(parents=True, exist_ok=True)
     Path(".github").mkdir(parents=True, exist_ok=True)
-    
-    shutil.copy(f"{MDAN_DIR}/core/orchestrator.md", ".mdan/")
-    shutil.copy(f"{MDAN_DIR}/core/universal-envelope.md", ".mdan/")
-    
+
+    shutil.copy(f"{MDAN_DIR}/core/orchestrator.md", "mdan/")
+    shutil.copy(f"{MDAN_DIR}/core/universal-envelope.md", "mdan/")
+
     for f in Path(f"{MDAN_DIR}/agents").glob("*.md"):
-        shutil.copy(f, ".mdan/agents/")
-    
+        shutil.copy(f, "mdan/agents/")
+
     skills_dir = Path(f"{MDAN_DIR}/skills")
     if skills_dir.exists():
         for s in skills_dir.iterdir():
             if s.is_dir():
-                shutil.copytree(s, f".mdan/skills/{s.name}", dirs_exist_ok=True)
+                shutil.copytree(s, f"mdan/skills/{s.name}", dirs_exist_ok=True)
                 shutil.copytree(s, f".claude/skills/{s.name}", dirs_exist_ok=True)
-    
+
     cursorrules = Path(f"{MDAN_DIR}/core/orchestrator.md").read_text()
     if rebuild == "--rebuild":
-        cursorrules += "\n\n## REBUILD MODE\nAnalyze existing code then rewrite from scratch."
+        cursorrules += (
+            "\n\n## REBUILD MODE\nAnalyze existing code then rewrite from scratch."
+        )
     else:
-        cursorrules += "\n\n## EXISTING PROJECT\nAnalyze codebase before making changes."
+        cursorrules += (
+            "\n\n## EXISTING PROJECT\nAnalyze codebase before making changes."
+        )
     Path(".cursorrules").write_text(cursorrules)
     shutil.copy(".cursorrules", ".windsurfrules")
     shutil.copy(f"{MDAN_DIR}/core/orchestrator.md", ".github/copilot-instructions.md")
-    
+
     print(f"{GREEN}✅ MDAN ready!{NC}\n")
     print(f"  {BOLD}Next:{NC} Run {CYAN}mdan oc{NC} to copy prompt")
     if rebuild == "--rebuild":
@@ -128,45 +143,63 @@ def cmd_attach(rebuild=None):
     else:
         print(f"  Start: {CYAN}MDAN: Analyze this project{NC}")
 
+
 def cmd_oc():
     import subprocess
-    orch_file = Path(".mdan/orchestrator.md")
+
+    orch_file = Path("mdan/orchestrator.md")
     if not orch_file.exists():
         orch_file = Path(f"{MDAN_DIR}/core/orchestrator.md")
-        
+
     if orch_file.exists():
         content = orch_file.read_text()
         try:
             if sys.platform == "darwin":
-                subprocess.run("pbcopy", universal_newlines=True, input=content, check=True)
+                subprocess.run(
+                    "pbcopy", universal_newlines=True, input=content, check=True
+                )
             elif sys.platform == "win32":
-                subprocess.run("clip", universal_newlines=True, input=content, check=True)
+                subprocess.run(
+                    "clip", universal_newlines=True, input=content, check=True
+                )
             elif sys.platform == "linux":
                 if shutil.which("xclip"):
-                    subprocess.run(["xclip", "-selection", "clipboard"], universal_newlines=True, input=content, check=True)
+                    subprocess.run(
+                        ["xclip", "-selection", "clipboard"],
+                        universal_newlines=True,
+                        input=content,
+                        check=True,
+                    )
                 elif shutil.which("wl-copy"):
-                    subprocess.run(["wl-copy"], universal_newlines=True, input=content, check=True)
+                    subprocess.run(
+                        ["wl-copy"], universal_newlines=True, input=content, check=True
+                    )
                 else:
                     raise Exception("No clipboard tool found")
             print(f"{GREEN}✅ Orchestrator prompt copied to clipboard!{NC}")
             print("   Paste it into Claude, ChatGPT, or your favorite LLM.")
         except Exception:
             print(content)
-            print(f"\n{YELLOW}⚠️  Could not copy to clipboard automatically. Please copy the text above.{NC}")
+            print(
+                f"\n{YELLOW}⚠️  Could not copy to clipboard automatically. Please copy the text above.{NC}"
+            )
     else:
         print(f"{RED}Orchestrator file not found.{NC}")
 
+
 def cmd_status():
-    if Path(".mdan/orchestrator.md").exists():
+    if Path("mdan/orchestrator.md").exists():
         print(f"{GREEN}✅ MDAN is active in this project{NC}")
-        if Path(".mdan/STATUS.md").exists():
-            print(Path(".mdan/STATUS.md").read_text())
+        if Path("mdan/STATUS.md").exists():
+            print(Path("mdan/STATUS.md").read_text())
     else:
         print(f"{YELLOW}No MDAN project here.{NC}")
         print("  Run: mdan init [name]  or  mdan attach")
 
+
 def cmd_phase(num, action=None):
     import subprocess
+
     phases = {
         "1": ("01-discover.md", "DISCOVER"),
         "discover": ("01-discover.md", "DISCOVER"),
@@ -177,43 +210,62 @@ def cmd_phase(num, action=None):
         "4": ("04-verify.md", "VERIFY"),
         "verify": ("04-verify.md", "VERIFY"),
         "5": ("05-ship.md", "SHIP"),
-        "ship": ("05-ship.md", "SHIP")
+        "ship": ("05-ship.md", "SHIP"),
     }
-    
+
     if num not in phases:
         print("Usage: mdan phase [1-5|name] [copy]")
         return
-        
+
     file, name = phases[num]
     phase_file = Path(f"{MDAN_DIR}/phases/{file}")
-    
+
     if phase_file.exists():
         content = phase_file.read_text()
         if action in ["copy", "-c"]:
             try:
                 if sys.platform == "darwin":
-                    subprocess.run("pbcopy", universal_newlines=True, input=content, check=True)
+                    subprocess.run(
+                        "pbcopy", universal_newlines=True, input=content, check=True
+                    )
                 elif sys.platform == "win32":
-                    subprocess.run("clip", universal_newlines=True, input=content, check=True)
+                    subprocess.run(
+                        "clip", universal_newlines=True, input=content, check=True
+                    )
                 elif sys.platform == "linux":
                     if shutil.which("xclip"):
-                        subprocess.run(["xclip", "-selection", "clipboard"], universal_newlines=True, input=content, check=True)
+                        subprocess.run(
+                            ["xclip", "-selection", "clipboard"],
+                            universal_newlines=True,
+                            input=content,
+                            check=True,
+                        )
                     elif shutil.which("wl-copy"):
-                        subprocess.run(["wl-copy"], universal_newlines=True, input=content, check=True)
+                        subprocess.run(
+                            ["wl-copy"],
+                            universal_newlines=True,
+                            input=content,
+                            check=True,
+                        )
                     else:
                         raise Exception("No clipboard tool found")
                 print(f"{GREEN}✅ Phase {name} prompt copied to clipboard!{NC}")
                 print("   Paste it into your LLM to start the phase.")
             except Exception:
                 print(content)
-                print(f"\n{YELLOW}⚠️  Could not copy automatically. Please copy the text above.{NC}")
+                print(
+                    f"\n{YELLOW}⚠️  Could not copy automatically. Please copy the text above.{NC}"
+                )
         else:
             print(f"{CYAN}{BOLD}Phase {name}{NC}")
             print(content)
-            print(f"\n{YELLOW}Tip: Run '{CYAN}mdan phase {num} copy{YELLOW}' to copy this content to clipboard.{NC}")
+            print(
+                f"\n{YELLOW}Tip: Run '{CYAN}mdan phase {num} copy{YELLOW}' to copy this content to clipboard.{NC}"
+            )
     else:
         print(f"Phase file not found: {file}")
 
+
 def cmd_agent(name):
     file = Path(f"{MDAN_DIR}/agents/{name}.md")
     if file.exists():
@@ -221,6 +273,7 @@ def cmd_agent(name):
     else:
         print("Agents: product, architect, ux, dev, test, security, devops, doc")
 
+
 def cmd_skills():
     print(f"{CYAN}Skills:{NC}")
     skills_dir = Path(f"{MDAN_DIR}/skills")
@@ -230,10 +283,11 @@ def cmd_skills():
     else:
         print("  No skills installed")
 
+
 def main():
     args = sys.argv[1:]
     cmd = args[0] if args else "help"
-    
+
     if cmd in ["help", "--help", "-h", None]:
         show_help()
     elif cmd == "init":
@@ -245,7 +299,9 @@ def main():
     elif cmd == "status":
         cmd_status()
     elif cmd == "phase":
-        cmd_phase(args[1] if len(args) > 1 else None, args[2] if len(args) > 2 else None)
+        cmd_phase(
+            args[1] if len(args) > 1 else None, args[2] if len(args) > 2 else None
+        )
     elif cmd == "agent":
         cmd_agent(args[1] if len(args) > 1 else None)
     elif cmd == "skills":
@@ -255,5 +311,6 @@ def main():
     else:
         print(f"Unknown: {cmd}. Run: mdan help")
 
+
 if __name__ == "__main__":
     main()

package/cli/mdan.sh

@@ -5,7 +5,7 @@
 # Multi-Agent Development Agentic Network
 # ============================================================
 
-VERSION="2.2.0"
+VERSION="2.4.1"
 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/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/windsurf.md

@@ -23,14 +23,14 @@ You are operating inside Windsurf IDE with Cascade AI.
 - Use Cascade's flow awareness to maintain MDAN phase context across sessions
 
 ### File Organization
-All MDAN artifacts should be saved to `.mdan/artifacts/` for reference.
+All MDAN artifacts should be saved to `mdan/artifacts/` for reference.
 ```
 
 ### Step 2: Copy agents
 
 ```bash
-mkdir -p .mdan/agents .mdan/artifacts
-cp agents/*.md .mdan/agents/
+mkdir -p mdan/agents mdan/artifacts
+cp agents/*.md mdan/agents/
 ```
 
 ### Step 3: Using MDAN with Cascade
@@ -45,4 +45,4 @@ Cascade's multi-step reasoning pairs well with MDAN's structured phases. When st
 
 - Windsurf's Cascade is excellent for the BUILD phase — it can implement entire features autonomously
 - Use MDAN's Feature Briefs as Cascade tasks for predictable, structured implementation
-- Save architecture documents to `.mdan/artifacts/` so Cascade can reference them in context
+- Save architecture documents to `mdan/artifacts/` so Cascade can reference them in context

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mdan-cli",
-  "version": "2.3.0",
+  "version": "2.4.1",
   "description": "Multi-Agent Development Agentic Network - A modern, adaptive, LLM-agnostic methodology for building software",
   "main": "cli/mdan.js",
   "bin": {