npm - appiq-solution - Versions diffs - 1.4.8 → 1.5.0 - Mend

appiq-solution 1.4.8 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (738) hide show

package/#Tools/APPIQ-METHOD/tools/appiq-installer.js DELETED Viewed

@@ -1,2711 +0,0 @@
-#!/usr/bin/env node
-/**
- * Appiq Solution Smart Installer
- *
- * Super einfache Installation mit One-Click Workflows
- * Usage: npx appiq-solution install
- *
- * Built with ❤️ based on the amazing Bmad-Method
- * Credits: https://github.com/Viktor-Hermann/APPIQ-METHOD
- */
-const fs = require('fs');
-const path = require('path');
-const inquirer = require('inquirer');
-const chalk = require('chalk');
-const MCP_SERVERS = {
-  // 🌍 GLOBAL SERVERS
-  "sequential-thinking": {
-    name: "Sequential Thinking",
-    description: "Structured thinking for complex problem solving",
-    command: "npx",
-    args: ["-y", "@modelcontextprotocol/server-sequential-thinking"],
-    tags: ['all', 'planning', 'architect', 'pm']
-  },
-  "puppeteer": {
-    name: "Puppeteer MCP Server",
-    description: "Browser automation and web scraping",
-    command: "npx",
-    args: ["-y", "puppeteer-mcp-server"],
-    tags: ['web', 'qa', 'automation']
-  },
-  "claude-continuity": {
-    name: "Claude Thread Continuity",
-    description: "Enhanced thread continuity for Claude",
-    command: "python3",
-    args: ["~/.mcp-servers/claude-continuity/server.py"],
-    tags: ['all', 'ide-enhancement']
-  },
-  // 📁 LOCAL SERVERS
-  "extended-memory": {
-    name: "Extended Memory MCP",
-    description: "Enhanced memory capabilities for AI assistants",
-    command: "python3",
-    args: ["-m", "extended_memory_mcp.server"],
-    env: { "LOG_LEVEL": "INFO" },
-    tags: ['all', 'ide-enhancement']
-  },
-  "@21st-dev/magic": {
-    name: "21st.dev Magic MCP",
-    description: "UI builder for MCP - like v0 but in your IDE",
-    command: "npx",
-    args: ["-y", "@21st-dev/magic@latest"],
-    tags: ['web', 'flutter', 'ui', 'ux-expert', 'flutter-ui-agent']
-  },
-  "dart": {
-    name: "Dart MCP Server",
-    description: "Dart SDK integration for Flutter/Dart projects",
-    command: "dart",
-    args: ["mcp-server", "--force-roots-fallback"],
-    tags: ['flutter', 'flutter-ui-agent', 'flutter-cubit-agent', 'flutter-data-agent']
-  },
-  "firebase": {
-    name: "Firebase MCP Server",
-    description: "Firebase services - Auth, Firestore, Functions",
-    command: "npx",
-    args: ["-y", "firebase-tools@latest", "experimental:mcp"],
-    tags: ['backend', 'fullstack', 'flutter', 'web', 'dev']
-  },
-  "supabase": {
-    name: "Supabase MCP Server",
-    description: "Supabase integration - database, auth, storage",
-    command: "npx",
-    args: ["-y", "@supabase/mcp-server-supabase@latest", "--read-only"],
-    tags: ['backend', 'fullstack', 'flutter', 'web', 'dev']
-  },
-  "context7": {
-    name: "Context7 MCP (Upstash)",
-    description: "Up-to-date code documentation for any library",
-    command: "npx",
-    args: ["-y", "@upstash/context7-mcp"],
-    tags: ['all', 'research', 'dev', 'architect']
-  },
-  "stripe": {
-    name: "Stripe MCP Server",
-    description: "Stripe payment integration",
-    command: "npx",
-    args: ["-y", "@stripe/mcp", "--tools=all"],
-    tags: ['backend', 'fullstack', 'web', 'payment', 'dev']
-  }
-};
-class AppiqSolutionInstaller {
-  constructor() {
-    this.projectRoot = process.cwd();
-    this.appiqPath = path.join(this.projectRoot, "appiq-solution");
-    this.config = {
-      version: "1.0.0",
-      projectType: null, // 'greenfield' or 'brownfield'
-      techStack: {
-        platform: null, // 'flutter', 'web', 'fullstack', 'api'
-        isFlutter: false,
-        hasUI: false,
-        database: null,
-        libraries: [],
-      },
-      selectedIDEs: [],
-      projectName: null,
-      projectIdea: null,
-      targetUsers: null,
-      projectPlan: null,
-      planApproved: false,
-    };
-  }
-  async install() {
-    console.log(chalk.bold.cyan("🚀 Appiq Solution Smart Installer v1.0.0"));
-    console.log(chalk.cyan("============================================"));
-    console.log(chalk.dim("Built with ❤️  based on Bmad-Method"));
-    console.log(chalk.dim("https://github.com/Viktor-Hermann/APPIQ-METHOD\n"));
-    try {
-      // Phase 1: Project Type Detection
-      await this.detectProjectType();
-      // Phase 1.5: Tech Stack Detection (Flutter, Web, etc.)
-      await this.detectTechStack();
-      // Phase 2: Project idea collection (only for greenfield projects)
-      if (this.config.projectType === "greenfield") {
-        await this.collectProjectIdea();
-      } else {
-        // For brownfield projects: auto-set project name from directory
-        await this.generateBrownfieldProjectConfig();
-      }
-              // Phase 3: IDE Selection (MULTISELECT)
-      await this.selectIDE();
-        // Phase 5: Create project plan
-        await this.createProjectPlan();
-        // Phase 6: Plan Approval
-        await this.approvePlan();
-        // Phase 7: Installation
-      await this.performInstallation();
-        // Phase 9: BMAD Core Configuration Setup
-        await this.setupBMADCoreConfig();
-        // Phase 10: Document Templates & Dependencies
-        await this.setupDocumentTemplates();
-        // Phase 11: Agent Dependencies System (+ Flutter Agents & MCPs)
-        await this.setupAgentDependencies();
-        // Phase 12: BMAD Orchestration (Full Flow)
-        await this.setupBMADOrchestration();
-        // Phase 13: One-Click Setup
-      await this.setupOneClickWorkflows();
-        // Phase 14: Simple Instructions
-      await this.showSimpleInstructions();
-    } catch (error) {
-      console.error(chalk.red("❌ Installation failed:"), error.message);
-      process.exit(1);
-    }
-  }
-  async detectProjectType() {
-    console.log(chalk.yellow("🔍 Project Analysis..."));
-    // Auto-Detection
-    const hasPackageJson = fs.existsSync(
-      path.join(this.projectRoot, "package.json")
-    );
-    const hasPubspec = fs.existsSync(
-      path.join(this.projectRoot, "pubspec.yaml")
-    );
-    const hasExistingCode = this.hasExistingSourceCode();
-    const hasDocumentation = this.hasExistingDocumentation();
-    let suggestedType = "greenfield";
-    let reason = "New project detected";
-    if (hasExistingCode || hasDocumentation) {
-      suggestedType = "brownfield";
-      reason = "Existing code/documentation found";
-    }
-    console.log(chalk.gray(`💡 Analysis: ${reason}`));
-    console.log(
-      chalk.gray(
-        `📊 Recommendation: ${
-          suggestedType === "greenfield"
-            ? "Greenfield (New Project)"
-            : "Brownfield (Existing Project)"
-        }`
-      )
-    );
-    // User Confirmation
-    const { projectType } = await inquirer.prompt([
-      {
-        type: "list",
-        name: "projectType",
-        message: "🎯 What type of project is this?",
-        choices: [
-          {
-            name: `✨ Greenfield - New project (Recommended: ${
-              suggestedType === "greenfield" ? "✅" : "❌"
-            })`,
-            value: "greenfield",
-            short: "Greenfield",
-          },
-          {
-            name: `🔧 Brownfield - Enhance existing project (Recommended: ${
-              suggestedType === "brownfield" ? "✅" : "❌"
-            })`,
-            value: "brownfield",
-            short: "Brownfield",
-          },
-        ],
-        default: suggestedType,
-      },
-    ]);
-    this.config.projectType = projectType;
-    console.log(
-      chalk.green(
-        `✅ Project Type: ${
-          projectType === "greenfield"
-            ? "Greenfield (New)"
-            : "Brownfield (Existing)"
-        }\n`
-      )
-    );
-  }
-  async selectIDE() {
-    console.log(chalk.yellow("🛠️ IDE Selection"));
-    console.log(
-      chalk.bold.yellow.bgRed(
-        " ⚠️  MULTISELECT: Use SPACEBAR to select multiple IDEs! "
-      )
-    );
-    console.log(chalk.gray("Select ALL IDEs that you use:\n"));
-    const { ides } = await inquirer.prompt([
-      {
-        type: "checkbox",
-        name: "ides",
-        message:
-          "🎯 Which IDEs do you use? (SPACEBAR = select, ENTER = confirm)",
-        choices: [
-          { name: "🔵 Cursor", value: "cursor" },
-          { name: "🟣 Claude Code CLI", value: "claude-code" },
-          { name: "🟢 Windsurf", value: "windsurf" },
-          { name: "🔶 VS Code + Cline", value: "cline" },
-          { name: "🟠 Trae", value: "trae" },
-          { name: "🔴 Roo Code", value: "roo" },
-          { name: "🟪 Gemini CLI", value: "gemini" },
-          { name: "⚫ GitHub Copilot", value: "github-copilot" },
-        ],
-        validate: (input) => {
-          if (input.length === 0) {
-            return "Please select at least one IDE!";
-          }
-          return true;
-        },
-      },
-    ]);
-    this.config.selectedIDEs = ides;
-    const ideNames = ides.map((ide) => this.getIDEName(ide)).join(", ");
-    console.log(chalk.green(`✅ IDEs: ${ideNames}\n`));
-  }
-  async detectTechStack() {
-    console.log(chalk.yellow("🔍 Tech Stack Detection"));
-    console.log(chalk.gray("Analyzing project environment and tech stack...\n"));
-    // Check for Flutter
-    const isFlutter = fs.existsSync(
-      path.join(this.projectRoot, "pubspec.yaml")
-    );
-    // Check for existing web frameworks
-    const hasPackageJson = fs.existsSync(
-      path.join(this.projectRoot, "package.json")
-    );
-    let webFramework = null;
-    if (hasPackageJson) {
-      try {
-        const packageJson = JSON.parse(
-          fs.readFileSync(path.join(this.projectRoot, "package.json"), "utf8")
-        );
-        if (packageJson.dependencies) {
-          const deps = Object.keys(packageJson.dependencies);
-          if (deps.includes("next")) webFramework = "next.js";
-          else if (deps.includes("react")) webFramework = "react";
-          else if (deps.includes("vue")) webFramework = "vue";
-          else if (deps.includes("@nuxt/core")) webFramework = "nuxt.js";
-          else if (deps.includes("@angular/core")) webFramework = "angular";
-        }
-      } catch (e) {
-        // ignore package.json parsing errors
-      }
-    }
-    // Auto-detect or ask user
-    if (isFlutter) {
-      console.log(chalk.green("✅ Flutter project detected!"));
-      this.config.techStack.platform = "flutter";
-      this.config.techStack.isFlutter = true;
-      this.config.techStack.hasUI = true;
-      console.log(chalk.cyan("   → Dart MCP Server will be configured"));
-      console.log(
-        chalk.cyan("   → Flutter Clean Architecture Agents will be loaded\n")
-      );
-    } else if (webFramework) {
-      console.log(chalk.green(`✅ ${webFramework} project detected!`));
-      this.config.techStack.platform = "web";
-      this.config.techStack.hasUI = true;
-      console.log(
-        chalk.cyan("   → shadcn/ui + v0.dev integration will be configured\n")
-      );
-    } else {
-      // Ask user for platform
-      const { platform } = await inquirer.prompt([
-        {
-          type: "list",
-          name: "platform",
-          message: "🎯 Which tech stack are you using?",
-          choices: [
-            { name: "📱 Flutter Mobile App", value: "flutter" },
-            { name: "🌐 Web App (React/Next.js/Vue)", value: "web" },
-            { name: "🚀 Fullstack (Frontend + Backend)", value: "fullstack" },
-            { name: "⚡ API/Backend Only", value: "api" },
-            { name: "🤷 Not sure yet", value: "unknown" },
-          ],
-        },
-      ]);
-      this.config.techStack.platform = platform;
-      this.config.techStack.isFlutter = platform === "flutter";
-      this.config.techStack.hasUI = ["flutter", "web", "fullstack"].includes(
-        platform
-      );
-      if (platform === "flutter") {
-        console.log(chalk.cyan("   → Dart MCP Server will be configured"));
-        console.log(
-          chalk.cyan("   → Flutter Clean Architecture Agents will be loaded")
-        );
-      } else if (platform === "web" || platform === "fullstack") {
-        console.log(
-          chalk.cyan("   → shadcn/ui + v0.dev integration will be configured")
-        );
-      }
-      console.log("");
-    }
-  }
-  async collectProjectIdea() {
-    console.log(chalk.yellow("💡 Collecting Project Information"));
-    // For brownfield projects, skip detailed project idea collection
-    if (this.config.projectType === "brownfield") {
-      console.log(
-        chalk.gray("📁 Detected existing project - using current directory\n")
-      );
-      const dirName = path.basename(this.projectRoot);
-      this.config.projectName = dirName;
-      this.config.projectIdea = `Brownfield project: ${dirName}`;
-      this.config.targetUsers = "Existing project users";
-      console.log(chalk.green(`✅ Project identified: "${dirName}"\n`));
-      return;
-    }
-    // For greenfield projects, collect detailed information
-    console.log(chalk.gray("Describe your project concept:\n"));
-    const { projectIdea, projectName, targetUsers } = await inquirer.prompt([
-      {
-        type: "input",
-        name: "projectName",
-        message: "🏷️ What should your project be called?",
-        validate: (input) =>
-          input.length > 0 ? true : "Please enter a project name!",
-      },
-      {
-        type: "editor",
-        name: "projectIdea",
-        message: "💡 Describe your project idea (detailed):",
-        validate: (input) =>
-          input.length > 10
-            ? true
-            : "Please describe your project in more detail!",
-      },
-      {
-        type: "input",
-        name: "targetUsers",
-        message: "👥 Who are your target groups/users?",
-        validate: (input) =>
-          input.length > 0 ? true : "Please describe your target audience!",
-      },
-    ]);
-    this.config.projectName = projectName;
-    this.config.projectIdea = projectIdea;
-    this.config.targetUsers = targetUsers;
-    console.log(chalk.green(`✅ Project idea captured: "${projectName}"\n`));
-  }
-  async generateBrownfieldProjectConfig() {
-    console.log(chalk.yellow("📋 Configuring brownfield project..."));
-    // Auto-set project name from directory name
-    const dirName = path.basename(this.projectRoot);
-    this.config.projectName = dirName;
-    console.log(chalk.cyan(`🏷️ Project name: ${dirName}`));
-    console.log(chalk.gray("   → Using directory name as project name"));
-    // Set default values for brownfield projects
-    this.config.projectIdea = `Enhancing existing ${dirName} project with AI agents`;
-    this.config.targetUsers = "Existing project stakeholders and development team";
-    // Auto-create docs/prd.md if it doesn't exist
-    const docsDir = path.join(this.projectRoot, "docs");
-    const prdPath = path.join(docsDir, "prd.md");
-    if (!fs.existsSync(prdPath)) {
-      if (!fs.existsSync(docsDir)) {
-        fs.mkdirSync(docsDir, { recursive: true });
-      }
-      const prdTemplate = this.config.techStack?.isFlutter ?
-        "flutter-mobile-prd-tmpl.yaml" : "prd-tmpl.yaml";
-      console.log(chalk.cyan("📄 Creating docs/prd.md automatically"));
-      console.log(chalk.gray(`   → Using template: ${prdTemplate}`));
-      const prdContent = `# Product Requirements Document - ${dirName}
-## Project Overview
-This is a brownfield project enhancement for ${dirName}.
-**Note:** Please fill in your specific requirements, features, and objectives below.
-## Current State Analysis
-- [ ] Document existing functionality
-- [ ] Identify technical debt
-- [ ] List current features
-- [ ] Note architecture patterns
-## Enhancement Goals
-- [ ] Define new features to add
-- [ ] List improvements to make
-- [ ] Specify performance goals
-- [ ] Document user experience improvements
-## Technical Requirements
-- [ ] Document current tech stack
-- [ ] List required integrations
-- [ ] Define API requirements
-- [ ] Specify database changes
-## Next Steps
-1. Fill in the requirements above
-2. Run \`@architect\` to analyze current architecture
-3. Use \`@sm\` to create feature stories
-4. Start implementation with \`@dev\`
-`;
-      fs.writeFileSync(prdPath, prdContent);
-      console.log(chalk.green("✅ docs/prd.md created successfully"));
-    } else {
-      console.log(chalk.cyan("📄 docs/prd.md already exists"));
-    }
-    console.log(chalk.green(`✅ Brownfield project configured: "${dirName}"\n`));
-  }
-  async createProjectPlan() {
-    console.log(chalk.yellow("📋 Creating project plan..."));
-    console.log(chalk.gray("Based on your idea and project type\n"));
-    // Normally team-fullstack.yaml would be used here
-    const plan = this.generateProjectPlan();
-    this.config.projectPlan = plan;
-    console.log(chalk.cyan("📋 Your Project Plan:"));
-    console.log(chalk.white("─".repeat(50)));
-    console.log(plan);
-    console.log(chalk.white("─".repeat(50) + "\n"));
-  }
-  async approvePlan() {
-    const { approved, changes } = await inquirer.prompt([
-      {
-        type: "confirm",
-        name: "approved",
-        message: "✅ Are you satisfied with this plan?",
-        default: true,
-      },
-      {
-        type: "input",
-        name: "changes",
-        message:
-          "📝 What changes would you like? (or ENTER for no changes)",
-        when: (answers) => !answers.approved,
-      },
-    ]);
-    if (!approved && changes) {
-      console.log(chalk.yellow("📝 Adapting plan..."));
-      this.config.planChanges = changes;
-      // Plan would be adapted here
-      console.log(chalk.green("✅ Plan has been adapted!\n"));
-    } else {
-      console.log(
-        chalk.green("✅ Plan approved - development can start!\n")
-      );
-    }
-    this.config.planApproved = true;
-  }
-  generateProjectPlan() {
-    const { projectType, projectName, projectIdea, targetUsers } = this.config;
-    return `🎯 PROJECT PLAN: ${projectName}
-📊 PROJECT TYPE: ${
-      projectType === "greenfield"
-        ? "Greenfield (New Project)"
-        : "Brownfield (Existing Project)"
-    }
-👥 TARGET AUDIENCE: ${targetUsers}
-💡 PROJECT IDEA:
-${projectIdea}
-🚀 DEVELOPMENT PIPELINE:
-${
-  projectType === "greenfield"
-    ? `
-1. 📋 PO (Product Owner) → Create PRD
-2. 🏗️ Architect → Design system architecture
-3. 🎨 UX Expert → UI/UX Design
-4. 📝 Story Master → Break down user stories
-5. 💻 Developer → Implement features
-6. ✅ QA Expert → Testing & validation
-7. 📊 SM (Scrum Master) → Sprint coordination
-`
-    : `
-1. 📋 PO → Analyze existing documentation
-2. 🏗️ Architect → Architecture review
-3. 📝 Story Master → Plan new features
-4. 💻 Developer → Integrate features into existing base
-5. ✅ QA Expert → Regression testing
-6. 📊 SM → Change management
-`
-}
-🎮 ONE-CLICK COMMANDS:
-- /start → Start entire workflow
-- /plan → Detailed planning
-- /develop → Begin development
-- /review → Code review
-- /deploy → Prepare deployment`;
-  }
-  async setupBMADCoreConfig() {
-    console.log(chalk.yellow("⚙️ Setting up BMAD Core Configuration..."));
-    // Create .bmad-core directory
-    const bmadCoreDir = path.join(this.appiqPath, ".bmad-core");
-    if (!fs.existsSync(bmadCoreDir)) {
-      fs.mkdirSync(bmadCoreDir, { recursive: true });
-    }
-    // Create core-config.yaml
-    const coreConfigPath = path.join(bmadCoreDir, "core-config.yaml");
-    fs.writeFileSync(coreConfigPath, this.generateCoreConfig());
-    // Create technical-preferences.md
-    const techPrefsPath = path.join(bmadCoreDir, "data");
-    if (!fs.existsSync(techPrefsPath)) {
-      fs.mkdirSync(techPrefsPath, { recursive: true });
-    }
-    fs.writeFileSync(
-      path.join(techPrefsPath, "technical-preferences.md"),
-      this.generateTechnicalPreferences()
-    );
-    console.log(chalk.green("✅ BMAD Core Configuration bereit!\n"));
-  }
-  async setupDocumentTemplates() {
-    console.log(chalk.yellow("📄 Document Templates & Struktur einrichten..."));
-    // Create docs directory structure
-    const docsDir = path.join(this.projectRoot, "docs");
-    const archDir = path.join(docsDir, "architecture");
-    const storiesDir = path.join(docsDir, "stories");
-    [docsDir, archDir, storiesDir].forEach((dir) => {
-      if (!fs.existsSync(dir)) {
-        fs.mkdirSync(dir, { recursive: true });
-      }
-    });
-    // Create templates
-    const templatesDir = path.join(this.appiqPath, "templates");
-    if (!fs.existsSync(templatesDir)) {
-      fs.mkdirSync(templatesDir, { recursive: true });
-    }
-    // PRD Template
-    fs.writeFileSync(
-      path.join(templatesDir, "prd-template.md"),
-      this.generatePRDTemplate()
-    );
-    // Architecture Template
-    fs.writeFileSync(
-      path.join(templatesDir, "architecture-template.md"),
-      this.generateArchitectureTemplate()
-    );
-    // Story Template
-    fs.writeFileSync(
-      path.join(templatesDir, "story-template.md"),
-      this.generateStoryTemplate()
-    );
-    // Create initial PRD if planning is complete
-    if (this.config.planApproved) {
-      fs.writeFileSync(path.join(docsDir, "prd.md"), this.generateInitialPRD());
-    }
-    console.log(chalk.green("✅ Document Templates created!\n"));
-  }
-  async setupAgentDependencies() {
-    console.log(chalk.yellow("🔗 Setting up Agent Dependencies System..."));
-    const agentsDir = path.join(this.appiqPath, "agents");
-    const tasksDir = path.join(this.appiqPath, "tasks");
-    const dataDir = path.join(this.appiqPath, "data");
-    // Create directories
-    [tasksDir, dataDir].forEach((dir) => {
-      if (!fs.existsSync(dir)) {
-        fs.mkdirSync(dir, { recursive: true });
-      }
-    });
-    // Create BMAD Knowledge Base
-    fs.writeFileSync(
-      path.join(dataDir, "bmad-kb.md"),
-      this.generateBMADKnowledgeBase()
-    );
-    // Create essential tasks
-    fs.writeFileSync(
-      path.join(tasksDir, "create-doc.md"),
-      this.generateCreateDocTask()
-    );
-    fs.writeFileSync(
-      path.join(tasksDir, "shard-doc.md"),
-      this.generateShardDocTask()
-    );
-    fs.writeFileSync(
-      path.join(tasksDir, "validate-story.md"),
-      this.generateValidateStoryTask()
-    );
-    // Add Flutter-specific agents if Flutter project
-    if (this.config.techStack.isFlutter) {
-      await this.addFlutterAgents();
-    }
-    // Update agents with proper dependencies
-    await this.updateAgentsWithDependencies();
-    console.log(chalk.green("✅ Agent Dependencies System bereit!\n"));
-  }
-  async setupBMADOrchestration() {
-    console.log(chalk.yellow("🎭 BMAD Full Orchestration einrichten..."));
-    // Create orchestration config based on BMAD Flow
-    const orchestrationConfig = {
-      planningPhase: {
-        agents: ["analyst", "pm", "ux-expert", "architect", "po"],
-        workflow:
-          this.config.projectType === "greenfield"
-            ? "greenfield-planning"
-            : "brownfield-planning",
-      },
-      developmentPhase: {
-        agents: ["sm", "po", "dev", "qa"],
-        workflow: "core-development-cycle",
-      },
-      transitions: {
-        planningToIDE: "document-sharding",
-        criticalCommitPoints: ["before-next-story", "after-qa-approval"],
-      },
-    };
-    // Generate BMAD Orchestration
-    const orchestrationPath = path.join(
-      this.appiqPath,
-      "bmad-orchestration.yaml"
-    );
-    fs.writeFileSync(
-      orchestrationPath,
-      this.generateBMADOrchestration(orchestrationConfig)
-    );
-    // Create workflow guides
-    const workflowsDir = path.join(this.appiqPath, "workflows");
-    if (!fs.existsSync(workflowsDir)) {
-      fs.mkdirSync(workflowsDir, { recursive: true });
-    }
-    fs.writeFileSync(
-      path.join(workflowsDir, "planning-workflow.md"),
-      this.generatePlanningWorkflow()
-    );
-    fs.writeFileSync(
-      path.join(workflowsDir, "development-cycle.md"),
-      this.generateDevelopmentCycle()
-    );
-    fs.writeFileSync(
-      path.join(workflowsDir, "document-sharding.md"),
-      this.generateDocumentSharding()
-    );
-    console.log(chalk.green("✅ BMAD Full Orchestration bereit!\n"));
-  }
-  generateCoreConfig() {
-    return `# BMAD Core Configuration
-# Built with ❤️ based on Bmad-Method
-project:
-  name: ${this.config.projectName || "Unbenanntes Projekt"}
-  type: ${this.config.projectType}
-  created: ${new Date().toISOString()}
-# Files that dev agent should ALWAYS load into context
-devLoadAlwaysFiles:
-  - docs/architecture/coding-standards.md
-  - docs/architecture/tech-stack.md
-  - docs/architecture/project-structure.md
-# Document paths configuration
-documentPaths:
-  prd: "docs/prd.md"
-  architecture: "docs/architecture.md"
-  stories: "docs/stories/"
-  templates: "appiq-solution/templates/"
-# Agent dependencies configuration
-dependencies:
-  templates:
-    - prd-template.md
-    - architecture-template.md
-    - story-template.md
-  tasks:
-    - create-doc.md
-    - shard-doc.md
-    - validate-story.md
-  data:
-    - bmad-kb.md
-    - technical-preferences.md
-`;
-  }
-  generateTechnicalPreferences() {
-    return `# Technical Preferences
-*Diese Datei hilft PM und Architect dabei, Ihre bevorzugten Design-Patterns und Technologien zu berücksichtigen.*
-## Projekt: ${this.config.projectName || "Unbenanntes Projekt"}
-**Platform:** ${this.config.techStack.platform || "nicht definiert"}
-### Bevorzugte Technologien
-${
-  this.config.techStack.isFlutter
-    ? `
-**📱 Flutter Mobile Development:**
-- **Framework:** Flutter 3.35+ (beta), Dart 3.9+
-- **Architecture:** Clean Architecture with Feature-based structure
-- **State Management:** Cubit/BLoC pattern (preferred), Riverpod (alternative)
-- **Dependency Injection:** GetIt + Injectable
-- **Code Generation:** Freezed, Build Runner
-- **Backend Integration:** Firebase, Supabase, REST APIs, GraphQL
-- **Testing:** Unit Testing, Widget Testing, Integration Testing, Golden Tests
-**🔌 Flutter MCP Integration:**
-- **Dart MCP Server:** Automatisch konfiguriert für AI-Assistenten
-- **Hot Reload:** Via MCP für Live-Development
-- **Package Management:** pub.dev Integration via MCP
-- **Error Analysis:** Automatische Fehlererkennung via MCP
-**📦 Recommended Packages:**
-- **UI:** Material 3, Cupertino (iOS-style)
-- **Navigation:** go_router
-- **HTTP:** dio
-- **Local Storage:** shared_preferences, hive
-- **Image:** cached_network_image
-`
-    : ""
-}
-${
-  this.config.techStack.platform === "web" ||
-  this.config.techStack.platform === "fullstack"
-    ? `
-**🌐 Web Development:**
-- **Framework:** React/Next.js, Vue/Nuxt, Angular
-- **UI Library:** shadcn/ui (preferred), v0.dev components, Material-UI, Chakra UI
-- **Styling:** Tailwind CSS, CSS-in-JS, SCSS
-- **AI Design:** v0.dev für Rapid Prototyping
-**🎨 shadcn/ui + v0.dev Integration:**
-- **Design System:** shadcn/ui als Basis-Komponenten
-- **AI-Generated Components:** v0.dev für schnelle UI-Erstellung
-- **Customization:** Tailwind CSS für individuelle Anpassungen
-- **Accessibility:** Radix-UI Primitives als Basis
-`
-    : ""
-}
-${
-  this.config.projectType === "greenfield" && !this.config.techStack.isFlutter
-    ? `
-**Backend:**
-- Runtime: Node.js, Python, Go
-- Framework: Express, FastAPI, Gin
-- Database: PostgreSQL, MongoDB, Redis
-**DevOps:**
-- Deployment: Vercel, Railway, AWS
-- CI/CD: GitHub Actions, GitLab CI
-- Monitoring: Sentry, LogRocket
-`
-    : ""
-}
-${
-  this.config.projectType === "brownfield"
-    ? `
-**Bestehende Technologien erweitern:**
-- Kompatibilität mit bestehender Code-Basis beachten
-- Minimale neue Dependencies
-- Schrittweise Migration wenn nötig
-`
-    : ""
-}
-### Design Patterns
-${
-  this.config.techStack.isFlutter
-    ? `
-- **Clean Architecture** (Presentation → Domain → Data)
-- **Feature-based Structure** (/features/auth, /features/dashboard)
-- **Repository Pattern** für Datenaccess
-- **Cubit Pattern** für State Management
-- **SOLID Principles** anwenden
-`
-    : `
-- **Architektur:** Clean Architecture, Hexagonal, MVC
-- **Code Style:** DRY, SOLID Principles, KISS
-${
-  this.config.techStack.hasUI
-    ? "- **Design System:** shadcn/ui für konsistente UI"
-    : ""
-}
-`
-}
-### Testing & Quality
-${
-  this.config.techStack.isFlutter
-    ? `
-- **Dart Analysis:** Very strict linting rules
-- **Flutter Lints:** Official Flutter linting package
-- **Testing:** Minimum 80% code coverage
-- **Golden Tests:** UI consistency tests
-- **Integration Tests:** End-to-end testing
-`
-    : `
-- **Testing:** TDD/BDD, Unit + Integration Tests
-- **Documentation:** README-driven, Inline Comments
-- **Code Quality:** ESLint + Prettier (wenn applicable)
-${
-  this.config.techStack.hasUI
-    ? "- **Component Testing:** Storybook für Component Documentation"
-    : ""
-}
-`
-}
-### AI-Integration & MCP
-${
-  this.config.techStack.isFlutter
-    ? `
-- **Dart MCP Server:** Für direkten AI-Zugriff auf Flutter Tools
-- **Flutter DevTools:** MCP-basierte AI-Assistenz
-- **Package Discovery:** AI-gestützte pub.dev Suche
-- **Code Analysis:** Automatische Fehlererkennung und -behebung
-`
-    : ""
-}
-${
-  this.config.techStack.hasUI && !this.config.techStack.isFlutter
-    ? `
-- **v0.dev Integration:** AI-generierte UI-Komponenten
-- **shadcn/ui Library:** KI-optimierte Component Library
-- **Design Tokens:** Konsistente AI-generierte Designs
-`
-    : ""
-}
-### Coding Standards
-- **Naming:** ${
-      this.config.techStack.isFlutter
-        ? "lowerCamelCase für Variablen, PascalCase für Classes"
-        : "camelCase für Variablen, PascalCase für Components"
-    }
-- **Files:** ${
-      this.config.techStack.isFlutter
-        ? "snake_case für Dart Dateien"
-        : "kebab-case für Dateien, PascalCase für Components"
-    }
-- **Functions:** Kleine, fokussierte Funktionen (<50 Zeilen)
-- **Comments:** Erkläre WARUM, nicht WAS
-### Präferenzen
-- **Performance:** Optimierung vor Abstraktion
-- **Security:** Security-by-Design
-- **Accessibility:** ${
-      this.config.techStack.isFlutter
-        ? "Flutter Accessibility Widget support"
-        : "WCAG 2.1 AA Standard"
-    }
-- **Mobile:** Mobile-First Approach
----
-*Platform: ${this.config.techStack.platform}*
-*MCP Configured: ${
-      this.config.techStack.isFlutter ? "Dart MCP ✅" : "Standard"
-    }*
-*Aktualisiert: ${new Date().toLocaleDateString("de-DE")}*
-`;
-  }
-  generatePRDTemplate() {
-    return `# Product Requirements Document (PRD)
-## Projekt: [PROJECT_NAME]
-### 1. Problem Statement
-*Welches Problem lösen wir?*
-### 2. Solution Overview
-*Wie lösen wir das Problem?*
-### 3. Target Users
-*Wer sind unsere Zielgruppen?*
-### 4. Functional Requirements (FRs)
-*Was muss das System können?*
-#### 4.1 Core Features
-- [ ] Feature 1
-- [ ] Feature 2
-#### 4.2 Advanced Features
-- [ ] Advanced Feature 1
-- [ ] Advanced Feature 2
-### 5. Non-Functional Requirements (NFRs)
-*Wie gut muss das System funktionieren?*
-#### 5.1 Performance
-- Response Time: < 200ms
-- Throughput: [SPECIFY]
-#### 5.2 Security
-- Authentication: [METHOD]
-- Authorization: [RBAC/ABAC]
-#### 5.3 Scalability
-- Users: [NUMBER]
-- Data: [VOLUME]
-### 6. User Stories & Epics
-#### Epic 1: [EPIC_NAME]
-- **Story 1.1:** Als [USER] möchte ich [ACTION] um [BENEFIT]
-- **Story 1.2:** Als [USER] möchte ich [ACTION] um [BENEFIT]
-#### Epic 2: [EPIC_NAME]
-- **Story 2.1:** Als [USER] möchte ich [ACTION] um [BENEFIT]
-- **Story 2.2:** Als [USER] möchte ich [ACTION] um [BENEFIT]
-### 7. Success Metrics
-*Wie messen wir Erfolg?*
-- Metric 1: [DEFINITION]
-- Metric 2: [DEFINITION]
----
-*Erstellt mit Appiq Solution - Built with ❤️ based on Bmad-Method*
-`;
-  }
-  generateArchitectureTemplate() {
-    return `# System Architecture
-## Projekt: [PROJECT_NAME]
-### 1. Architecture Overview
-*High-level Systemübersicht*
-### 2. Technology Stack
-#### Frontend
-- Framework: [FRAMEWORK]
-- State Management: [STATE_MANAGEMENT]
-- Styling: [STYLING_SOLUTION]
-#### Backend
-- Runtime: [RUNTIME]
-- Framework: [FRAMEWORK]
-- Database: [DATABASE]
-#### Infrastructure
-- Hosting: [HOSTING_PLATFORM]
-- CI/CD: [CI_CD_SOLUTION]
-### 3. System Components
-#### 3.1 Frontend Components
-- Component Library
-- State Management
-- Routing
-- API Layer
-#### 3.2 Backend Services
-- API Layer
-- Business Logic
-- Data Access Layer
-- External Integrations
-### 4. Data Models
-#### User Model
-\`\`\`
-{
-  id: string
-  email: string
-  name: string
-  createdAt: Date
-}
-\`\`\`
-### 5. API Design
-#### Authentication
-- POST /api/auth/login
-- POST /api/auth/register
-- POST /api/auth/logout
-#### Core Resources
-- GET /api/[resource]
-- POST /api/[resource]
-- PUT /api/[resource]/:id
-- DELETE /api/[resource]/:id
-### 6. Security Considerations
-- Authentication Strategy
-- Authorization Model
-- Data Validation
-- Rate Limiting
-### 7. Performance Considerations
-- Caching Strategy
-- Database Optimization
-- CDN Usage
-- Lazy Loading
-### 8. Deployment Architecture
-- Development Environment
-- Staging Environment
-- Production Environment
----
-*Erstellt mit Appiq Solution - Built with ❤️ based on Bmad-Method*
-`;
-  }
-  generateStoryTemplate() {
-    return `# User Story: [STORY_TITLE]
-## Story Details
-**Als** [USER_TYPE]
-**möchte ich** [ACTION]
-**um** [BENEFIT]
-## Acceptance Criteria
-- [ ] Criterion 1
-- [ ] Criterion 2
-- [ ] Criterion 3
-## Technical Tasks
-- [ ] Task 1: [DESCRIPTION]
-- [ ] Task 2: [DESCRIPTION]
-- [ ] Task 3: [DESCRIPTION]
-## Definition of Done
-- [ ] Code implemented and tested
-- [ ] Unit tests written and passing
-- [ ] Integration tests passing
-- [ ] Code reviewed and approved
-- [ ] Documentation updated
-- [ ] Deployed to staging
-- [ ] User acceptance testing completed
-## Dependencies
-- [ ] Dependency 1
-- [ ] Dependency 2
-## Estimation
-**Story Points:** [POINTS]
-**Estimated Hours:** [HOURS]
-## Notes
-*Zusätzliche Notizen und Überlegungen*
----
-**Sprint:** [SPRINT_NUMBER]
-**Assigned to:** [DEVELOPER]
-**Status:** [TODO/IN_PROGRESS/REVIEW/DONE]
----
-*Erstellt mit Appiq Solution - Built with ❤️ based on Bmad-Method*
-`;
-  }
-  generateInitialPRD() {
-    const { projectName, projectIdea, targetUsers, projectType } = this.config;
-    return `# Product Requirements Document (PRD)
-## Projekt: ${projectName}
-### 1. Problem Statement
-${projectIdea}
-### 2. Target Users
-${targetUsers}
-### 3. Project Type
-${
-  projectType === "greenfield"
-    ? "✨ Greenfield (Neues Projekt)"
-    : "🔧 Brownfield (Bestehendes Projekt)"
-}
-### 4. Functional Requirements (FRs)
-*Diese Sektion wird durch den PM Agent vervollständigt*
-#### 4.1 Core Features
-- [ ] Feature wird durch PM definiert
-### 5. Non-Functional Requirements (NFRs)
-*Diese Sektion wird durch den Architect Agent vervollständigt*
-### 6. User Stories & Epics
-*Diese Sektion wird durch den Story Master Agent vervollständigt*
----
-**Status:** 📋 Planning Phase Complete - Ready for PM Agent
-**Nächster Schritt:** PM Agent für detaillierte Requirements
-**Created:** ${new Date().toLocaleDateString("de-DE")}
----
-*Erstellt mit Appiq Solution - Built with ❤️ based on Bmad-Method*
-`;
-  }
-  generateBMADKnowledgeBase() {
-    return `# BMAD Knowledge Base
-## The BMad Planning + Execution Workflow
-### Planning Workflow (Web UI or Powerful IDE Agents)
-1. **Analyst** (Optional): Market Research, Competitor Analysis, Project Brief
-2. **PM**: Create PRD from Brief with FRs, NFRs, Epics & Stories
-3. **UX Expert** (Optional): Create Front End Spec, Generate UI Prompts
-4. **Architect**: Create Architecture from PRD + UX Spec
-5. **PO**: Run Master Checklist, validate document alignment
-### Critical Transition: Web UI → IDE
-- Copy documents to project (docs/prd.md, docs/architecture.md)
-- Switch to IDE
-- **PO**: Shard Documents (CRITICAL STEP)
-- Begin Development Cycle
-### Core Development Cycle (IDE)
-1. **SM**: Review previous story dev/QA notes
-2. **SM**: Draft next story from sharded epic + architecture
-3. **PO**: Validate story draft (optional)
-4. **User Approval** of story
-5. **Dev**: Sequential task execution, implement tasks + tests
-6. **Dev**: Run all validations, mark ready for review
-7. **User Verification**: Request QA or approve
-8. **QA**: Senior dev review + active refactoring (if requested)
-9. **IMPORTANT**: Verify all regression tests and linting pass
-10. **IMPORTANT**: COMMIT CHANGES BEFORE PROCEEDING
-11. Mark story as done, loop back to SM
-### Key Principles
-- **Document Sharding**: Critical step after planning phase
-- **Context Management**: Keep files lean and focused
-- **Commit Regularly**: Save work frequently, especially after QA
-- **Agent Selection**: Use appropriate agent for each task
-- **Dependencies**: Each agent loads only what it needs
-### Special Agents
-- **BMad-Master**: Can do any task except story implementation
-- **BMad-Orchestrator**: Heavy-weight agent for web bundles only
-### Technical Configuration
-- **core-config.yaml**: devLoadAlwaysFiles configuration
-- **technical-preferences.md**: Bias PM/Architect recommendations
-- **Dependencies**: templates, tasks, data for each agent
----
-*Built with ❤️ based on Bmad-Method*
-`;
-  }
-  generateCreateDocTask() {
-    return `# Create Document Task
-## Purpose
-Create structured documents following BMAD templates and standards.
-## Usage
-This task helps agents create consistent, well-structured documents.
-## Process
-1. **Identify Document Type**: PRD, Architecture, Story, etc.
-2. **Load Template**: Use appropriate template from templates/
-3. **Gather Requirements**: Collect all necessary information
-4. **Fill Template**: Replace placeholders with actual content
-5. **Validate Structure**: Ensure all sections are complete
-6. **Save Document**: Store in correct location (docs/)
-## Templates Available
-- prd-template.md
-- architecture-template.md
-- story-template.md
-## Best Practices
-- Follow template structure exactly
-- Replace ALL placeholders
-- Include creation date and status
-- Link to related documents
-- Use consistent formatting
-## Output Location
-- PRD: docs/prd.md
-- Architecture: docs/architecture.md
-- Stories: docs/stories/[story-name].md
----
-*Built with ❤️ based on Bmad-Method*
-`;
-  }
-  generateShardDocTask() {
-    return `# Document Sharding Task
-## Purpose
-**CRITICAL STEP**: Break down large documents into focused, manageable pieces for agents.
-## When to Use
-- After planning phase completion
-- Before beginning development cycle
-- When switching from Web UI to IDE
-## Process
-1. **Identify Source Document**: Usually PRD or Architecture
-2. **Analyze Structure**: Find natural breaking points
-3. **Create Focused Files**: Each file serves one purpose
-4. **Maintain References**: Link shards together
-5. **Update devLoadAlwaysFiles**: Configure core-config.yaml
-## Sharding Strategy
-### PRD Sharding
-- **Core Requirements**: docs/requirements/core.md
-- **User Stories**: docs/stories/ (individual files)
-- **Success Metrics**: docs/metrics.md
-### Architecture Sharding
-- **Tech Stack**: docs/architecture/tech-stack.md
-- **Coding Standards**: docs/architecture/coding-standards.md
-- **Project Structure**: docs/architecture/project-structure.md
-- **API Design**: docs/architecture/api-design.md
-- **Data Models**: docs/architecture/data-models.md
-## Critical Points
-- **Lean Files**: Each shard should be focused and minimal
-- **Dev Context**: Sharded files go into devLoadAlwaysFiles
-- **Agent Performance**: Smaller context = better performance
-- **Maintainability**: Easier to update specific aspects
-## Post-Sharding
-1. Update core-config.yaml devLoadAlwaysFiles
-2. Verify all shards are accessible
-3. Test agent context loading
-4. Begin development cycle
----
-*Built with ❤️ based on Bmad-Method*
-`;
-  }
-  generateValidateStoryTask() {
-    return `# Validate Story Task
-## Purpose
-Ensure user stories align with PRD, architecture, and project goals.
-## When to Use
-- Before story implementation begins
-- When SM drafts new stories
-- When stories are modified
-## Validation Checklist
-### Story Structure
-- [ ] Clear user role defined
-- [ ] Specific action described
-- [ ] Business value stated
-- [ ] Acceptance criteria present
-### Technical Alignment
-- [ ] Aligns with architecture decisions
-- [ ] Fits within tech stack constraints
-- [ ] Dependencies identified
-- [ ] Implementation feasible
-### Business Alignment
-- [ ] Supports PRD objectives
-- [ ] Addresses user needs
-- [ ] Measurable outcomes
-- [ ] Priority justified
-### Quality Gates
-- [ ] Testable acceptance criteria
-- [ ] Definition of done complete
-- [ ] Effort estimation reasonable
-- [ ] Risk assessment done
-## Process
-1. **Load References**: PRD, Architecture, related stories
-2. **Check Structure**: Verify story template compliance
-3. **Validate Alignment**: Against PRD and architecture
-4. **Assess Dependencies**: Identify blockers or prerequisites
-5. **Review Quality**: Ensure story is ready for development
-6. **Provide Feedback**: Clear recommendations for improvements
-## Common Issues
-- Vague acceptance criteria
-- Missing technical dependencies
-- Misalignment with architecture
-- Unrealistic scope or effort
-## Output
-- **Validation Status**: Pass/Fail with reasons
-- **Recommendations**: Specific improvements needed
-- **Dependencies**: List of prerequisites
-- **Risk Assessment**: Potential implementation challenges
----
-*Built with ❤️ based on Bmad-Method*
-`;
-  }
-  async addFlutterAgents() {
-    console.log(chalk.cyan("    📱 Adding Flutter-specific agents..."));
-    const agentsDir = path.join(this.appiqPath, "agents");
-    const flutterExpansionPath = path.join(
-      __dirname,
-      "..",
-      "expansion-packs",
-      "bmad-flutter-mobile-dev",
-      "agents"
-    );
-    // Check if Flutter expansion pack exists
-    if (!fs.existsSync(flutterExpansionPath)) {
-      console.log(
-        chalk.yellow(
-          "    ⚠️  Flutter expansion pack not found - creating basic Flutter agents"
-        )
-      );
-      await this.createBasicFlutterAgents();
-      return;
-    }
-    // Copy Flutter agents from expansion pack
-    const flutterAgents = [
-      "flutter-ui-agent.md",
-      "flutter-cubit-agent.md",
-      "flutter-data-agent.md",
-      "flutter-domain-agent.md",
-      "shared-components-agent.md",
-    ];
-    for (const agentFile of flutterAgents) {
-      const sourcePath = path.join(flutterExpansionPath, agentFile);
-      const targetPath = path.join(agentsDir, agentFile);
-      if (fs.existsSync(sourcePath)) {
-        fs.copyFileSync(sourcePath, targetPath);
-        console.log(chalk.green(`      ✅ ${agentFile} hinzugefügt`));
-      }
-    }
-    // Create Flutter-specific data files
-    const dataDir = path.join(this.appiqPath, "data");
-    const flutterDataPath = path.join(
-      __dirname,
-      "..",
-      "expansion-packs",
-      "bmad-flutter-mobile-dev",
-      "data"
-    );
-    if (
-      fs.existsSync(
-        path.join(flutterDataPath, "flutter-development-guidelines.md")
-      )
-    ) {
-      fs.copyFileSync(
-        path.join(flutterDataPath, "flutter-development-guidelines.md"),
-        path.join(dataDir, "flutter-development-guidelines.md")
-      );
-      console.log(
-        chalk.green("      ✅ Flutter development guidelines hinzugefügt")
-      );
-    }
-  }
-  async createBasicFlutterAgents() {
-    console.log(chalk.gray("    🔨 Creating basic Flutter agents..."));
-    const agentsDir = path.join(this.appiqPath, "agents");
-    // Basic Flutter UI Agent
-    const flutterUIAgent = this.generateBasicFlutterUIAgent();
-    fs.writeFileSync(
-      path.join(agentsDir, "flutter-ui-agent.md"),
-      flutterUIAgent
-    );
-    // Basic Flutter State Management Agent
-    const flutterStateAgent = this.generateBasicFlutterStateAgent();
-    fs.writeFileSync(
-      path.join(agentsDir, "flutter-cubit-agent.md"),
-      flutterStateAgent
-    );
-    console.log(chalk.green("      ✅ Basic Flutter agents created"));
-  }
-  generateBasicFlutterUIAgent() {
-    return `# Flutter UI Agent
-Du bist ein spezialisierter Flutter UI Agent, der sich auf die Erstellung von benutzerfreundlichen und responsive Mobile UI-Komponenten fokussiert.
-## Rolle & Verantwortung
-- **UI Design & Implementation:** Erstelle schöne, Material 3 konforme Flutter UIs
-- **Widget Composition:** Verwende effiziente Widget-Hierarchien
-- **Responsive Design:** Sichere Kompatibilität für verschiedene Bildschirmgrößen
-- **Accessibility:** Implementiere barrierefreie UI-Komponenten
-## Expertise
-### Flutter UI Frameworks
-- **Material 3:** Modernes Material Design
-- **Cupertino:** iOS-native Looks
-- **Custom Widgets:** Individuelle UI-Komponenten
-### Best Practices
-- **Widget Keys:** Für Testability und Performance
-- **Const Constructors:** Memory-Optimierung
-- **Build Method Optimization:** Verhindere unnecessary rebuilds
-- **Theme Integration:** Konsistente Design Systems
-## Tech Stack Integration
-**Platform:** ${this.config.techStack.platform}
-**MCP:** ${this.config.techStack.isFlutter ? "Dart MCP Server ✅" : "Standard"}
-### Dart MCP Tools
-- Hot Reload via MCP
-- Widget Inspection via AI
-- pub.dev Package Discovery
-- Runtime Error Analysis
-## Workflow Integration
-**Planning Phase:** Arbeite mit UX Expert an UI Specs
-**Development Phase:** Implementiere UI basierend auf Cubit State
-**Testing Phase:** Golden Tests für UI Consistency
----
-*Built with ❤️ based on Bmad-Method*
-*Flutter Clean Architecture + Dart MCP Integration*
-`;
-  }
-  generateBasicFlutterStateAgent() {
-    return `# Flutter Cubit State Management Agent
-Du bist ein spezialisierter Flutter State Management Agent mit Fokus auf Cubit/BLoC Pattern und Clean Architecture.
-## Rolle & Verantwortung
-- **State Management:** Implementiere Cubit/BLoC Pattern
-- **Clean Architecture:** Separation of Concerns (Presentation → Domain → Data)
-- **Dependency Injection:** GetIt + Injectable Setup
-- **Event Handling:** User Interactions und API Calls
-## Expertise
-### State Management
-- **Cubit:** Simple State Management für UI
-- **BLoC:** Complex Business Logic mit Events
-- **Riverpod:** Alternative State Management (if needed)
-### Architecture Patterns
-- **Clean Architecture:** Feature-based Structure
-- **Repository Pattern:** Data Access Layer
-- **Use Cases:** Business Logic Layer
-- **Dependency Injection:** Loose Coupling
-## Tech Stack Integration
-**Platform:** ${this.config.techStack.platform}
-**MCP:** ${this.config.techStack.isFlutter ? "Dart MCP Server ✅" : "Standard"}
-### Code Generation
-- **Freezed:** Immutable Data Classes
-- **Injectable:** Dependency Injection Setup
-- **Build Runner:** Code Generation Pipeline
-## Workflow Integration
-**Planning Phase:** Definiere State Structure mit Domain Agent
-**Development Phase:** Implementiere Business Logic
-**Testing Phase:** Unit Tests für Cubits und Use Cases
----
-*Built with ❤️ based on Bmad-Method*
-*Flutter Clean Architecture + Dart MCP Integration*
-`;
-  }
-  async updateAgentsWithDependencies() {
-    console.log(chalk.gray("    🔗 Updating agents with BMAD dependencies..."));
-    const agentsDir = path.join(this.appiqPath, "agents");
-    const agents = fs.readdirSync(agentsDir);
-    for (const agentFile of agents) {
-      const agentPath = path.join(agentsDir, agentFile);
-      let content = fs.readFileSync(agentPath, "utf8");
-      // Add BMAD dependencies section to each agent
-      const dependenciesSection = `
-## 🔗 BMAD Dependencies
-### Templates
-- prd-template.md
-- architecture-template.md
-- story-template.md
-### Tasks
-- create-doc.md
-- shard-doc.md
-- validate-story.md
-### Data
-- bmad-kb.md
-- technical-preferences.md
-### Configuration
-- core-config.yaml (devLoadAlwaysFiles)
-## 🎯 BMAD Workflow Integration
-**Planning Phase:** Web UI → IDE Transition → Document Sharding
-**Development Phase:** SM → PO → Dev → QA → Loop
-**Critical Points:** Commit before proceeding, verify tests passing
-`;
-      // Add MCP integration section
-      const mcpSection = this.generateMCPAgentSection(agentFile);
-      // Add dependencies and MCP section before the final line
-      const lines = content.split("\n");
-      const lastLine = lines.pop(); // Remove last line
-      lines.push(dependenciesSection);
-      lines.push(mcpSection);
-      lines.push(lastLine); // Add last line back
-      fs.writeFileSync(agentPath, lines.join("\n"));
-    }
-  }
-  generateMCPAgentSection(agentFile) {
-    // Bestimme Agent-Typ basierend auf Dateiname
-    const agentName = agentFile.replace('.md', '').toLowerCase();
-    // Bestimme welche MCPs für diesen Agent relevant sind
-    const relevantMCPs = Object.keys(MCP_SERVERS).filter(mcpKey => {
-      const server = MCP_SERVERS[mcpKey];
-      return server.tags.includes('all') ||
-             server.tags.some(tag => agentName.includes(tag)) ||
-             (agentName.includes('architect') && server.tags.includes('architect')) ||
-             (agentName.includes('pm') && server.tags.includes('pm')) ||
-             (agentName.includes('qa') && server.tags.includes('qa')) ||
-             (agentName.includes('dev') && server.tags.includes('dev')) ||
-             (agentName.includes('ux') && server.tags.includes('ux-expert')) ||
-             (agentName.includes('flutter') && server.tags.includes('flutter')) ||
-             ((agentName.includes('web') || agentName.includes('ui')) && server.tags.includes('ui'));
-    });
-    if (relevantMCPs.length === 0) {
-      return '';
-    }
-    let section = `\n## 🔌 MCP Server Integration\n\nDu hast Zugriff auf folgende MCP Server, um deine Fähigkeiten zu erweitern:\n\n`;
-    relevantMCPs.forEach(mcpKey => {
-      const server = MCP_SERVERS[mcpKey];
-      section += `- **${server.name}:** ${server.description}\n`;
-    });
-    section += `\n**Beispiel-Anwendung:**\n`;
-    // Spezifische Beispiele basierend auf Agent-Typ
-    if (agentName.includes('flutter')) {
-      section += `- "Nutze den Dart MCP, um mein Flutter Widget zu analysieren."\n`;
-      section += `- "Verwende den 21st.dev Magic MCP, um eine neue UI-Komponente zu erstellen."\n`;
-    } else if (agentName.includes('architect')) {
-      section += `- "Nutze den Context7 MCP, um die neueste Dokumentation für React Hooks zu finden."\n`;
-      section += `- "Verwende Sequential Thinking MCP für die komplexe Architektur-Planung."\n`;
-    } else if (agentName.includes('qa')) {
-      section += `- "Nutze den Puppeteer MCP, um automatisierte Browser-Tests zu erstellen."\n`;
-    } else if (agentName.includes('dev')) {
-      section += `- "Verwende den Firebase MCP, um Firestore-Daten abzurufen."\n`;
-      section += `- "Nutze den Supabase MCP für Datenbankoperationen."\n`;
-    } else {
-      section += `- "Nutze den Context7 MCP für aktuelle Dokumentation."\n`;
-      section += `- "Verwende Sequential Thinking MCP für komplexe Problemlösungen."\n`;
-    }
-    section += `\n**Wichtig:** Die MCPs müssen in deiner IDE konfiguriert sein. Siehe mcp-setup-instructions.md für Details.\n`;
-    return section;
-  }
-  generateBMADOrchestration(config) {
-    return `# BMAD Full Orchestration
-# Built with ❤️ based on Bmad-Method
-project:
-  name: ${this.config.projectName}
-  type: ${this.config.projectType}
-  plan_approved: ${this.config.planApproved}
-  created: ${new Date().toISOString()}
-# BMAD Planning Phase (Web UI/Powerful IDE)
-planning_phase:
-  workflow: ${config.planningPhase.workflow}
-  agents:
-${config.planningPhase.agents.map((agent) => `    - ${agent}`).join("\n")}
-  flow:
-    1: "analyst → research & project brief (optional)"
-    2: "pm → create PRD from brief"
-    3: "ux-expert → create frontend spec (optional)"
-    4: "architect → create architecture from PRD + UX"
-    5: "po → run master checklist & validate alignment"
-# Critical Transition: Web UI → IDE
-transition:
-  type: ${config.transitions.planningToIDE}
-  requirements:
-    - "Copy docs/prd.md and docs/architecture.md to project"
-    - "Switch to IDE"
-    - "PO: Shard documents (CRITICAL)"
-    - "Update core-config.yaml devLoadAlwaysFiles"
-# BMAD Development Phase (IDE Only)
-development_phase:
-  workflow: ${config.developmentPhase.workflow}
-  agents:
-${config.developmentPhase.agents.map((agent) => `    - ${agent}`).join("\n")}
-  cycle:
-    1: "sm → review previous story dev/QA notes"
-    2: "sm → draft next story from sharded epic + architecture"
-    3: "po → validate story draft (optional)"
-    4: "user → approve story"
-    5: "dev → sequential task execution + implementation"
-    6: "dev → run all validations, mark ready for review"
-    7: "user → verify (request QA or approve)"
-    8: "qa → senior dev review + active refactoring (if requested)"
-    9: "CRITICAL → verify regression tests + linting pass"
-    10: "CRITICAL → COMMIT CHANGES BEFORE PROCEEDING"
-    11: "mark story done → loop back to sm"
-# Critical Commit Points
-commit_points:
-${config.transitions.criticalCommitPoints
-  .map((point) => `  - ${point}`)
-  .join("\n")}
-# IDE Integration
-ides:
-${this.config.selectedIDEs
-  .map(
-    (ide) => `  - name: ${this.getIDEName(ide)}
-    config_path: ${this.getIDEConfig(ide).dir}
-    file_format: ${this.getIDEConfig(ide).suffix}`
-  )
-  .join("\n")}
-# Context Management
-context:
-  dev_always_files:
-    - docs/architecture/coding-standards.md
-    - docs/architecture/tech-stack.md
-    - docs/architecture/project-structure.md
-  agent_dependencies:
-    templates: ["prd-template.md", "architecture-template.md", "story-template.md"]
-    tasks: ["create-doc.md", "shard-doc.md", "validate-story.md"]
-    data: ["bmad-kb.md", "technical-preferences.md"]
----
-*Powered by Appiq Solution - Built with ❤️ based on Bmad-Method*
-`;
-  }
-  generatePlanningWorkflow() {
-    return `# BMAD Planning Workflow
-## Übersicht
-Die Planungsphase folgt einem strukturierten Workflow, idealerweise in Web UI für Kosteneffizienz.
-## Planning Flow
-### 1. Start: Projektidee
-- Grundlegendes Konzept definiert
-- Problem identifiziert
-### 2. Analyst (Optional)
-**Brainstorming:**
-- Marktforschung
-- Konkurrenzanalyse
-- Projekt Brief erstellen
-### 3. Project Manager (PM)
-**PRD Erstellung:**
-- PRD aus Brief erstellen (Fast Track)
-- ODER interaktive PRD Erstellung (mehr Fragen)
-- Functional Requirements (FRs)
-- Non-Functional Requirements (NFRs)
-- Epics & Stories definieren
-### 4. UX Expert (Optional)
-**Frontend Specification:**
-- Frontend Spec erstellen
-- UI Prompts für Lovable/V0 generieren (optional)
-### 5. System Architect
-**Architektur Design:**
-- Architektur aus PRD erstellen
-- ODER aus PRD + UX Spec erstellen
-- Tech Stack definieren
-- System Components planen
-### 6. Product Owner (PO)
-**Master Checklist:**
-- Dokumenten-Alignment prüfen
-- Epics & Stories aktualisieren (falls nötig)
-- PRD/Architektur anpassen (falls nötig)
-## Kritischer Übergang: Web UI → IDE
-### ⚠️ WICHTIG: Transition Point
-Sobald PO Dokumenten-Alignment bestätigt:
-1. **Dokumente kopieren**: docs/prd.md und docs/architecture.md
-2. **IDE wechseln**: Projekt in bevorzugter Agentic IDE öffnen
-3. **Document Sharding**: PO Agent zum Shard der Dokumente verwenden
-4. **Development beginnen**: Core Development Cycle starten
-## Qualitäts-Gates
-### Planning Complete Criteria
-- [ ] PRD vollständig und genehmigt
-- [ ] Architektur vollständig und genehmigt
-- [ ] UX Spec (falls erforderlich) genehmigt
-- [ ] Alle Dokumente sind aligned
-- [ ] Epics und Stories definiert
-- [ ] Übergang zu IDE vorbereitet
-## Nächste Schritte
-Nach Planning Complete → **Document Sharding** → **Development Cycle**
----
-*Built with ❤️ based on Bmad-Method*
-`;
-  }
-  generateDevelopmentCycle() {
-    return `# BMAD Core Development Cycle
-## Übersicht
-Strukturierter Entwicklungsworkflow in der IDE nach abgeschlossener Planungsphase.
-## Voraussetzungen
-- ✅ Planning Phase abgeschlossen
-- ✅ Dokumente in Projekt kopiert (docs/prd.md, docs/architecture.md)
-- ✅ **Document Sharding** durch PO Agent durchgeführt
-- ✅ IDE-Setup komplett
-## Development Cycle Flow
-### 1. Scrum Master (SM)
-**Story Vorbereitung:**
-- Review previous story dev/QA notes
-- Draft next story from sharded epic + architecture
-- Berücksichtigt technical dependencies
-- Erstellt realistische task breakdown
-### 2. Product Owner (PO) - Optional
-**Story Validation:**
-- Validate story draft against artifacts
-- Überprüft alignment mit PRD
-- Bestätigt business value
-- Kann übersprungen werden bei erfahrenen Teams
-### 3. User Approval
-**Story Freigabe:**
-- ✅ **Approved**: Weiter zu Development
-- ❌ **Needs Changes**: Zurück zu SM für Anpassungen
-### 4. Developer (Dev)
-**Implementation:**
-- Sequential task execution
-- Implement tasks + tests
-- Run all validations
-- Mark ready for review + add notes
-- Dokumentiert implementation decisions
-### 5. User Verification
-**Review Decision:**
-- 🔍 **Request QA Review**: Weiter zu QA Agent
-- ✅ **Approve Without QA**: Direkt zu Final Checks
-- ❌ **Needs Fixes**: Zurück zu Dev
-### 6. QA Agent (Optional)
-**Quality Assurance:**
-- Senior dev review + active refactoring
-- Review code, refactor, add tests
-- Document notes and improvements
-- **Decision**: Needs Dev Work OR Approved
-### 7. Final Checks - ⚠️ CRITICAL
-**Vor dem Abschluss:**
-- ✅ Verify ALL regression tests passing
-- ✅ Verify ALL linting passing
-- ✅ Code review completed (if QA was used)
-- ✅ Documentation updated
-### 8. Commit - ⚠️ SUPER CRITICAL
-**WICHTIG: COMMIT YOUR CHANGES BEFORE PROCEEDING!**
-- Git add & commit all changes
-- Include meaningful commit message
-- Push to repository
-### 9. Story Complete
-**Mark als Done:**
-- Story status → DONE
-- Loop back to SM for next story
-## Critical Points
-### ⚠️ Commit Points
-- **After QA Approval**: Always commit before marking done
-- **Before Next Story**: Clean state for next iteration
-### 🎯 Quality Gates
-- All tests passing
-- Linting clean
-- Code reviewed (if QA used)
-- Documentation current
-### 📊 Context Management
-- Keep relevant files only in context
-- Use sharded documents
-- Maintain lean, focused files
-## Best Practices
-- **Small Stories**: Keep stories manageable (< 1 week)
-- **Regular Commits**: Commit frequently during development
-- **Test First**: Write tests before or with implementation
-- **Document Decisions**: Record architectural decisions
----
-*Built with ❤️ based on Bmad-Method*
-`;
-  }
-  generateDocumentSharding() {
-    return `# Document Sharding Guide
-## ⚠️ CRITICAL STEP
-Document Sharding ist ein **essentieller Schritt** im BMAD Flow nach der Planungsphase.
-## Wann Document Sharding durchführen?
-- ✅ Nach Planning Phase Completion
-- ✅ Beim Übergang von Web UI zu IDE
-- ✅ Vor Beginn des Development Cycles
-- ✅ Wenn Dokumente zu groß für Agent-Context werden
-## Warum Document Sharding?
-- **Performance**: Kleinere Context = bessere Agent-Performance
-- **Focus**: Jede Datei dient einem spezifischen Zweck
-- **Maintainability**: Einfacher zu aktualisieren und zu verwalten
-- **Agent Efficiency**: Agents laden nur was sie brauchen
-## Sharding Process
-### 1. PRD Sharding
-**Source**: docs/prd.md
-**Target Structure**:
-\`\`\`
-docs/
-├── requirements/
-│   ├── core.md              # Core functional requirements
-│   ├── non-functional.md    # NFRs (performance, security)
-│   └── success-metrics.md   # KPIs and success criteria
-├── stories/
-│   ├── epic-1-auth/
-│   │   ├── story-1-1-login.md
-│   │   └── story-1-2-register.md
-│   └── epic-2-dashboard/
-│       └── story-2-1-overview.md
-\`\`\`
-### 2. Architecture Sharding
-**Source**: docs/architecture.md
-**Target Structure**:
-\`\`\`
-docs/architecture/
-├── tech-stack.md           # Technology decisions
-├── coding-standards.md     # Code style and patterns
-├── project-structure.md    # File/folder organization
-├── api-design.md          # REST/GraphQL API specs
-├── data-models.md         # Database schema
-├── security.md            # Security considerations
-└── deployment.md          # Deployment architecture
-\`\`\`
-## Sharding Guidelines
-### File Size
-- **Target**: < 50 lines per sharded file
-- **Maximum**: < 100 lines per sharded file
-- **Focus**: One concern per file
-### Naming Convention
-- **kebab-case**: tech-stack.md, coding-standards.md
-- **Descriptive**: Clear purpose from filename
-- **Consistent**: Follow project conventions
-### Content Rules
-- **Atomic**: Each file covers one topic completely
-- **Self-contained**: Can be understood independently
-- **Linked**: Reference related files when needed
-- **Lean**: Remove fluff, keep essentials
-## Post-Sharding Configuration
-### 1. Update core-config.yaml
-\`\`\`yaml
-devLoadAlwaysFiles:
-  - docs/architecture/coding-standards.md
-  - docs/architecture/tech-stack.md
-  - docs/architecture/project-structure.md
-\`\`\`
-### 2. Verify Agent Access
-- Test that agents can load sharded files
-- Ensure all references are correct
-- Validate file paths in configuration
-### 3. Update Templates
-- Modify templates to reference sharded structure
-- Update agent prompts to use sharded files
-- Test template generation
-## Quality Checks
-### ✅ Sharding Complete Criteria
-- [ ] All large documents sharded
-- [ ] Each shard < 100 lines
-- [ ] devLoadAlwaysFiles updated
-- [ ] Agent dependencies resolved
-- [ ] File references working
-- [ ] Templates updated
-### 🚨 Common Mistakes
-- **Too Large**: Shards still too big (>100 lines)
-- **Too Small**: Over-sharding (many 5-line files)
-- **Broken Links**: References to old unified files
-- **Missing Config**: devLoadAlwaysFiles not updated
-## After Sharding
-1. **Test Agent Loading**: Verify agents can access all needed files
-2. **Begin Development**: Start Core Development Cycle
-3. **Monitor Performance**: Watch for context issues
-4. **Refine as Needed**: Adjust sharding based on usage
----
-*Built with ❤️ based on Bmad-Method*
-`;
-  }
-  async performInstallation() {
-    console.log(chalk.yellow("📦 Installation läuft..."));
-    // Create appiq-solution directory
-    if (!fs.existsSync(this.appiqPath)) {
-      fs.mkdirSync(this.appiqPath, { recursive: true });
-    }
-    // Install optimized agents
-    await this.installOptimizedAgents();
-    // Install project-specific configs
-    await this.installProjectConfig();
-    // Setup IDE integration
-    await this.setupIDEIntegration();
-    console.log(chalk.green("✅ Installation abgeschlossen!\n"));
-  }
-  async installOptimizedAgents() {
-    console.log(chalk.gray("  📄 Optimierte Agents installieren..."));
-    const agentsDir = path.join(this.appiqPath, "agents");
-    if (!fs.existsSync(agentsDir)) {
-      fs.mkdirSync(agentsDir, { recursive: true });
-    }
-    // Core optimized agents
-    const agents = ["init-flow-po", "architect", "pm", "sm", "dev", "qa"];
-    for (const agent of agents) {
-      await this.createOptimizedAgent(agent);
-    }
-  }
-  async createOptimizedAgent(agentName) {
-    const agentContent = this.generateOptimizedAgentContent(agentName);
-    const filePath = path.join(this.appiqPath, "agents", `${agentName}.md`);
-    fs.writeFileSync(filePath, agentContent);
-  }
-  generateOptimizedAgentContent(agentName) {
-    const agentConfigs = {
-      "init-flow-po": {
-        name: "Product Owner & Workflow Initiator",
-        role: "Intelligent Project Starter & Business Requirements",
-        commands: [
-          "/init-flow",
-          "/analyze-project",
-          "/create-epic",
-          "/start-story",
-        ],
-        description:
-          "Initiates optimal workflow based on project type and handles business requirements",
-      },
-      architect: {
-        name: "System Architect",
-        role: "Technical Architecture",
-        commands: ["/architecture", "/tech-stack", "/design"],
-        description: "Develops system architecture and tech stack",
-      },
-      pm: {
-        name: "Product Manager",
-        role: "PRD & Project Planning",
-        commands: ["/prd", "/plan", "/epic"],
-        description: "Creates PRD and project documentation",
-      },
-      sm: {
-        name: "Scrum Master",
-        role: "User Stories & Sprint Planning",
-        commands: ["/story", "/sprint", "/tasks"],
-        description: "Creates user stories and sprint planning",
-      },
-      dev: {
-        name: "Senior Developer",
-        role: "Code Implementation",
-        commands: ["/code", "/implement", "/fix"],
-        description: "Implements features and fixes bugs",
-      },
-      qa: {
-        name: "QA Expert",
-        role: "Testing & Quality",
-        commands: ["/test", "/review", "/validate"],
-        description: "Performs tests and validates code quality",
-      },
-    };
-    const config = agentConfigs[agentName];
-    return `# ${config.name}
-## 🎯 Rolle
-${config.role}
-## 📋 Verfügbare Kommandos
-${config.commands
-  .map((cmd) => `- **${cmd}** - ${config.description}`)
-  .join("\n")}
-## 🚀 One-Click Workflows
-### Für ${
-      this.config.projectType === "greenfield" ? "NEUE" : "BESTEHENDE"
-    } Projekte:
-${
-  this.config.projectType === "greenfield"
-    ? this.generateGreenfieldWorkflow(config)
-    : this.generateBrownfieldWorkflow(config)
-}
-## 🎮 Einfache Nutzung
-1. **Laden Sie diesen Agent in Ihre IDE**
-2. **Sagen Sie:** "Agiere als ${config.name}"
-3. **Verwenden Sie:** ${config.commands[0]} für Quick-Start
----
-*Automatisch optimiert für ${this.config.selectedIDEs
-      .map((ide) => this.getIDEName(ide))
-      .join(", ")}*
-*Powered by Appiq - Based on Bmad-Method*
-`;
-  }
-  generateGreenfieldWorkflow(config) {
-    const workflows = {
-      "Appiq Launcher": `
-**🚀 Schnell-Start für neues Projekt:**
-1. \`/start\` - Automatische Projekt-Analyse
-2. Erstellt automatisch: PRD-Vorlage, Architektur-Basis, erste Stories
-3. **Wo alles hingehört:** Alle Dateien werden automatisch in \`docs/\` erstellt`,
-      "Project Manager": `
-**📋 PRD Erstellung:**
-1. \`/prd\` - Startet PRD-Assistent
-2. **Datei wird erstellt:** \`docs/prd.md\`
-3. **Nächster Schritt:** Architect für Architektur`,
-      "System Architect": `
-**🏗️ Architektur erstellen:**
-1. \`/architecture\` - Basierend auf PRD
-2. **Datei wird erstellt:** \`docs/architecture.md\`
-3. **Nächster Schritt:** Story Master für erste Stories`,
-      "Story Master": `
-**📝 Erste Stories:**
-1. \`/story\` - Erstellt erste User Story
-2. **Datei wird erstellt:** \`docs/stories/story-001.md\`
-3. **Nächster Schritt:** Developer für Implementation`,
-      "Senior Developer": `
-**💻 Implementation:**
-1. \`/implement\` - Implementiert aktuelle Story
-2. **Erstellt/bearbeitet:** Entsprechende Code-Dateien
-3. **Nächster Schritt:** QA Expert für Review`,
-      "QA Expert": `
-**✅ Testing & Review:**
-1. \`/review\` - Reviewed aktuellen Code
-2. **Erstellt:** Test-Dateien und Reports
-3. **Nächster Schritt:** Zurück zu Story Master für nächste Story`,
-    };
-    return workflows[config.name] || "Standard Greenfield Workflow";
-  }
-  generateBrownfieldWorkflow(config) {
-    const workflows = {
-      "Appiq Launcher": `
-**🔧 Quick Start for Existing Project:**
-1. \`/analyze\` - Analyzes existing project
-2. **Finds:** Existing docs, code structure, tech stack
-3. **Creates:** Customized workflows for your project`,
-      "Project Manager": `
-**📋 Automatic PRD Creation:**
-1. **Creates automatically:** \`docs/prd.md\` (if not present)
-2. **For Flutter Projects:** Uses flutter-mobile-prd-tmpl.yaml
-3. **No project name prompt** - Uses directory name
-4. **Next Step:** Architect for architecture review`,
-      "System Architect": `
-**🏗️ Architecture Review:**
-1. \`/review-architecture\` - Analyzes existing structure
-2. **Creates/updates:** \`docs/architecture.md\`
-3. **Next Step:** Story Master for new features`,
-      "Story Master": `
-**📝 Feature Stories:**
-1. \`/new-feature\` - New story for existing project
-2. **File created:** \`docs/stories/feature-XXX.md\`
-3. **Considers:** Existing code base`,
-      "Senior Developer": `
-**💻 Feature Implementation:**
-1. \`/add-feature\` - Implements in existing code
-2. **Edits:** Existing files safely
-3. **Creates:** New files where needed`,
-      "QA Expert": `
-**✅ Regression Testing:**
-1. \`/regression-test\` - Tests new features
-2. **Validates:** No breaking changes
-3. **Creates:** Test reports for existing + new features`,
-    };
-    return workflows[config.name] || "Standard Brownfield Workflow";
-  }
-  async setupOneClickWorkflows() {
-    console.log(chalk.yellow("⚡ Setting up One-Click Workflows..."));
-    // Create quick commands
-    const commandsDir = path.join(this.appiqPath, "commands");
-    if (!fs.existsSync(commandsDir)) {
-      fs.mkdirSync(commandsDir, { recursive: true });
-    }
-    // Project-type specific quick starts
-    const quickStartContent = this.generateQuickStartScript();
-    fs.writeFileSync(
-      path.join(commandsDir, "quick-start.md"),
-      quickStartContent
-    );
-    console.log(chalk.green("✅ One-Click Workflows bereit!\n"));
-  }
-  generateQuickStartScript() {
-    return `# 🚀 Appiq Solution - BMAD Workflow Guide
-## Projekt: ${this.config.projectName || "Unbenanntes Projekt"}
-**Typ:** ${
-      this.config.projectType === "greenfield"
-        ? "✨ Greenfield (Neues Projekt)"
-        : "🔧 Brownfield (Bestehendes Projekt)"
-    }
-## 📋 BMAD Planning Workflow (Phase 1)
-### Option A: Web UI Planning (Kosteneffizient)
-1. Claude/Gemini/GPT mit team-fullstack Bundle verwenden
-2. **Flow:** Analyst → PM → UX Expert → Architect → PO
-3. **Output:** docs/prd.md, docs/architecture.md
-### Option B: IDE Planning (Leistungsstark)
-\`\`\`
-@analyst → Market Research & Project Brief
-@pm → PRD mit FRs, NFRs, Epics & Stories erstellen
-@ux-expert → Frontend Spec (optional)
-@architect → System Architecture design
-@po → Master Checklist & Document Alignment
-\`\`\`
-## ⚠️ KRITISCHER ÜBERGANG: Document Sharding
-**ESSENTIAL STEP:**
-\`\`\`
-@po bitte shard die PRD und Architecture Dokumente in fokussierte Dateien
-\`\`\`
-**Das erstellt:**
-- docs/architecture/tech-stack.md ← Dev lädt immer
-- docs/architecture/coding-standards.md ← Dev lädt immer
-- docs/architecture/project-structure.md ← Dev lädt immer
-- docs/requirements/core.md
-- docs/stories/ (individual story files)
-## 🚀 BMAD Development Cycle (Phase 2)
-### Core Development Loop:
-\`\`\`
-1. @sm → Review previous notes, draft next story from sharded epic
-2. @po → Validate story draft (optional)
-3. User → Approve story
-4. @dev → Sequential tasks, implement + tests, mark ready
-5. User → Verify (request QA or approve)
-6. @qa → Senior dev review + refactoring (optional)
-7. ⚠️ CRITICAL: Verify tests + linting pass
-8. ⚠️ SUPER CRITICAL: COMMIT CHANGES BEFORE PROCEEDING!
-9. Mark story done → Loop back to @sm
-\`\`\`
-## 🎯 One-Click Commands
-### Planning:
-- \`/plan\` → Start planning workflow
-- \`/prd\` → Generate PRD
-- \`/arch\` → Design architecture
-### Critical Transition:
-- \`/shard\` → Document sharding (ESSENTIAL!)
-### Development:
-- \`/story\` → Draft next story
-- \`/dev\` → Start development
-- \`/test\` → Run tests
-- \`/qa\` → Request review
-- \`/commit\` → Commit changes
-### ${
-      this.config.projectType === "greenfield" ? "Greenfield" : "Brownfield"
-    } Specific:
-${
-  this.config.projectType === "greenfield"
-    ? `
-- \`/start\` → Fresh project setup
-- \`/design\` → Create from scratch
-- \`/build\` → Build step by step
-`
-    : `
-- \`/analyze\` → Analyze existing code
-- \`/document\` → Document current state
-- \`/improve\` → Plan improvements
-`
-}
-## 📊 File Structure
-\`\`\`
-your-project/
-├── docs/
-│   ├── prd.md              ← Initial PRD
-│   ├── architecture.md     ← Initial Architecture
-│   ├── architecture/       ← Sharded files
-│   │   ├── tech-stack.md
-│   │   ├── coding-standards.md
-│   │   └── project-structure.md
-│   ├── requirements/
-│   │   └── core.md
-│   └── stories/
-│       ├── epic-1-auth/
-│       └── epic-2-features/
-├── appiq-solution/
-│   ├── agents/             ← AI-Agents
-│   ├── templates/          ← Document templates
-│   ├── workflows/          ← Workflow guides
-│   └── .bmad-core/         ← BMAD configuration
-└── .cursor/rules/          ← IDE integration
-\`\`\`
-## ⚠️ Critical Success Factors
-### Document Sharding (ESSENTIAL):
-- **MUST DO** after planning phase
-- Creates focused, lean files for agents
-- Improves agent performance dramatically
-### Commit Points:
-- After QA approval (always!)
-- Before next story (clean state)
-- Regular commits during development
-### Quality Gates:
-- All tests passing ✅
-- Linting clean ✅
-- Code reviewed (if QA used) ✅
-- Documentation updated ✅
-## 🆘 Help & Support
-- \`/help\` → Show all commands
-- \`/workflow\` → Current workflow step
-- \`/agents\` → Available agents
-- \`/docs\` → Documentation
-### Workflow Files:
-- appiq-solution/workflows/planning-workflow.md
-- appiq-solution/workflows/development-cycle.md
-- appiq-solution/workflows/document-sharding.md
----
-**IDEs:** ${this.config.selectedIDEs
-      .map((ide) => this.getIDEName(ide))
-      .join(", ")}
-**Created:** ${new Date().toLocaleDateString("de-DE")}
-**Powered by Appiq Solution - Built with ❤️ based on Bmad-Method**
-`;
-  }
-  async setupIDEIntegration() {
-    if (
-      this.config.selectedIDEs.includes("manual") &&
-      this.config.selectedIDEs.length === 1
-    )
-      return;
-    console.log(chalk.gray("  🔧 Mehrere IDE-Integrationen..."));
-    for (const ide of this.config.selectedIDEs) {
-      if (ide === "manual") continue;
-      console.log(
-        chalk.gray(`    📝 ${this.getIDEName(ide)} wird konfiguriert...`)
-      );
-      const ideConfig = this.getIDEConfig(ide);
-    const ideDir = path.join(this.projectRoot, ideConfig.dir);
-    if (!fs.existsSync(ideDir)) {
-      fs.mkdirSync(ideDir, { recursive: true });
-    }
-    // Copy agents to IDE-specific format
-      const agentsPath = path.join(this.appiqPath, "agents");
-    const agents = fs.readdirSync(agentsPath);
-    for (const agent of agents) {
-      const sourcePath = path.join(agentsPath, agent);
-        const targetPath = path.join(
-          ideDir,
-          agent.replace(".md", ideConfig.suffix)
-        );
-      fs.copyFileSync(sourcePath, targetPath);
-    }
-      console.log(chalk.green(`    ✅ ${this.getIDEName(ide)} konfiguriert`));
-    }
-    console.log(chalk.green("  ✅ Alle IDE-Integrationen abgeschlossen!"));
-  }
-  getIDEConfig(ide) {
-    const configs = {
-      cursor: { dir: ".cursor/rules", suffix: ".mdc" },
-      "claude-code": { dir: ".claude/commands/Appiq", suffix: ".md" },
-      windsurf: { dir: ".windsurf/rules", suffix: ".md" },
-      cline: { dir: ".clinerules", suffix: ".md" },
-      trae: { dir: ".trae/rules", suffix: ".md" },
-      roo: { dir: ".roo/agents", suffix: ".md" },
-      gemini: { dir: ".gemini/commands", suffix: ".md" },
-      "github-copilot": { dir: ".github/copilot", suffix: ".md" },
-    };
-    return configs[ide] || { dir: ".appiq-solution", suffix: ".md" };
-  }
-  getIDEName(ide) {
-    const names = {
-      cursor: "Cursor",
-      "claude-code": "Claude Code CLI",
-      windsurf: "Windsurf",
-      cline: "VS Code + Cline",
-      trae: "Trae",
-      roo: "Roo Code",
-      gemini: "Gemini CLI",
-      "github-copilot": "GitHub Copilot",
-      manual: "Manuell",
-    };
-    return names[ide] || ide;
-  }
-  async showSimpleInstructions() {
-    console.log(chalk.bold.green("🎉 Appiq Installation Erfolgreich!\n"));
-    console.log(chalk.dim("Built with ❤️  based on the amazing Bmad-Method"));
-    console.log(chalk.dim("https://github.com/Viktor-Hermann/APPIQ-METHOD\n"));
-    console.log(chalk.cyan("📋 Nächste Schritte (Super einfach):"));
-    console.log(chalk.white("════════════════════════════════════\n"));
-    if (
-      this.config.selectedIDEs.length > 0 &&
-      !this.config.selectedIDEs.includes("manual")
-    ) {
-      console.log(
-        chalk.yellow(
-          `1. Ihre IDEs öffnen: ${this.config.selectedIDEs
-            .map((ide) => this.getIDEName(ide))
-            .join(", ")}`
-        )
-      );
-      console.log(
-        chalk.gray(`   → Agents sind bereits in allen IDEs installiert!\n`)
-      );
-    }
-    console.log(chalk.yellow("2. 📋 BMAD Planning Workflow:"));
-    if (this.config.planApproved) {
-      console.log(
-        chalk.green(`   ✅ Planning Complete - Ready for Development!`)
-      );
-      console.log(chalk.cyan(`   → Ihre initial PRD: docs/prd.md`));
-    } else {
-      console.log(chalk.cyan(`   Option A: Web UI (kosteneffizient)`));
-      console.log(chalk.gray(`   → Claude/Gemini/GPT mit Agents verwenden`));
-      console.log(chalk.cyan(`   Option B: Direkt in IDE`));
-      console.log(chalk.gray(`   → @pm für PRD, @architect für Architecture`));
-    }
-    console.log("");
-    console.log(chalk.yellow("3. ⚠️ KRITISCHER ÜBERGANG: Document Sharding"));
-    console.log(
-      chalk.red(
-        `   → Sagen Sie Ihrer IDE: ${chalk.bold(
-          '"@po bitte shard die PRD und Architecture Dokumente"'
-        )}`
-      )
-    );
-    console.log(
-      chalk.gray(`   → Dokumente werden in fokussierte Teile aufgeteilt\n`)
-    );
-    console.log(chalk.yellow("4. 🚀 BMAD Development Cycle:"));
-    console.log(chalk.cyan(`   1. @sm → Story Draft von Sharded Epic`));
-    console.log(chalk.cyan(`   2. @po → Story Validation (optional)`));
-    console.log(chalk.cyan(`   3. User → Story Approval`));
-    console.log(chalk.cyan(`   4. @dev → Implementation + Tests`));
-    console.log(chalk.cyan(`   5. @qa → Code Review (optional)`));
-    console.log(chalk.red(`   6. ⚠️ COMMIT CHANGES BEFORE PROCEEDING!`));
-    console.log(chalk.gray(`   → Loop zurück zu @sm für nächste Story\n`));
-    console.log(chalk.yellow("5. 🎯 Quick Commands (in quick-start.md):"));
-    console.log(chalk.cyan(`   /plan → Planning starten`));
-    console.log(chalk.cyan(`   /shard → Document Sharding`));
-    console.log(chalk.cyan(`   /story → Nächste Story`));
-    console.log(chalk.cyan(`   /dev → Development`));
-    console.log(chalk.cyan(`   /qa → Quality Review`));
-    console.log(chalk.gray(`   → Alle Details in appiq-solution/workflows/\n`));
-    console.log(chalk.cyan("🎯 Das war's! Kein komplizierter Setup mehr."));
-    console.log(chalk.green("🚀 Viel Erfolg mit Appiq!\n"));
-    // Quick reference
-    console.log(chalk.dim("━".repeat(50)));
-    console.log(chalk.dim("📁 Quick Reference:"));
-    console.log(chalk.dim(`   • Agents: appiq-solution/agents/`));
-    console.log(
-      chalk.dim(`   • Quick Start: appiq-solution/commands/quick-start.md`)
-    );
-    console.log(chalk.dim(`   • Projekt-Typ: ${this.config.projectType}`));
-    console.log(
-      chalk.dim(
-        `   • IDEs: ${this.config.selectedIDEs
-          .map((ide) => this.getIDEName(ide))
-          .join(", ")}`
-      )
-    );
-  }
-  // Helper methods
-  hasExistingSourceCode() {
-    const sourceDirs = ["src", "lib", "app", "components", "pages"];
-    return sourceDirs.some(
-      (dir) =>
-      fs.existsSync(path.join(this.projectRoot, dir)) &&
-      fs.readdirSync(path.join(this.projectRoot, dir)).length > 0
-    );
-  }
-  hasExistingDocumentation() {
-    const docFiles = ["README.md", "docs", "documentation"];
-    return docFiles.some((file) =>
-      fs.existsSync(path.join(this.projectRoot, file))
-    );
-  }
-  async installProjectConfig() {
-    const configContent = this.generateProjectConfig();
-    fs.writeFileSync(
-      path.join(this.appiqPath, "project-config.yaml"),
-      configContent
-    );
-  }
-  generateProjectConfig() {
-    return `# Appiq Solution Project Configuration
-# Built with ❤️  based on Bmad-Method
-version: "1.0.0"
-project:
-  type: ${this.config.projectType}
-  created: ${new Date().toISOString()}
-  name: ${this.config.projectName || path.basename(this.projectRoot)}
-  plan_approved: ${this.config.planApproved}
-# Wo die wichtigen Dateien liegen
-paths:
-  prd: "docs/prd.md"
-  architecture: "docs/architecture.md"
-  stories: "docs/stories/"
-  agents: "appiq-solution/agents/"
-  orchestration: "appiq-solution/orchestration.yaml"
-# One-Click Workflows
-workflows:
-  ${this.config.projectType === "greenfield" ? "greenfield" : "brownfield"}:
-    start_command: "${
-      this.config.projectType === "greenfield" ? "/start" : "/analyze"
-    }"
-    agents_sequence:
-      - init-flow-po
-      - architect
-      - pm
-      - dev
-      - qa
-# IDE Integration (Mehrere IDEs)
-ides:
-${this.config.selectedIDEs
-  .map(
-    (ide) => `  - name: ${this.getIDEName(ide)}
-    config_path: ${this.getIDEConfig(ide).dir}
-    file_format: ${this.getIDEConfig(ide).suffix}`
-  )
-  .join("\n")}
-`;
-  }
-}
-// Run installer if called directly
-if (require.main === module) {
-  // Check if 'install' command is provided
-  const args = process.argv.slice(2);
-  if (args.length === 0 || args[0] === "install") {
-    const installer = new AppiqSolutionInstaller();
-  installer.install().catch(console.error);
-  } else {
-    console.log(
-      chalk.red("❌ Unknown command. Use: npx appiq-solution install")
-    );
-    process.exit(1);
-  }
-}
-module.exports = AppiqSolutionInstaller;