appiq-solution 1.2.0 → 1.3.0

package/#Tools/APPIQ-METHOD/deployment/installers/appiq-global.sh

@@ -0,0 +1,91 @@
+#!/bin/bash
+
+# APPIQ Method - Global Terminal Command
+# This script provides the global 'appiq' command for system-wide access
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Find APPIQ installation directory
+find_appiq_dir() {
+    # Check common locations
+    local locations=(
+        "$HOME/.appiq"
+        "$(pwd)/.appiq"
+        "/usr/local/share/appiq"
+        "/opt/appiq"
+    )
+    
+    for dir in "${locations[@]}"; do
+        if [ -d "$dir" ] && [ -f "$dir/bmad-core/agents/bmad-orchestrator.md" ]; then
+            echo "$dir"
+            return 0
+        fi
+    done
+    
+    return 1
+}
+
+# Main function
+main() {
+    local appiq_dir
+    appiq_dir=$(find_appiq_dir)
+    
+    if [ -z "$appiq_dir" ]; then
+        echo -e "${RED}❌ APPIQ Method installation not found!${NC}"
+        echo -e "${YELLOW}💡 Install APPIQ Method first with:${NC}"
+        echo "curl -fsSL https://github.com/Viktor-Hermann/APPIQ-METHOD/releases/latest/download/appiq_installer.sh | bash"
+        exit 1
+    fi
+    
+    # Handle commands
+    case "${1:-help}" in
+        "start")
+            echo -e "${BLUE}🚀 APPIQ Method Universal Launcher${NC}"
+            echo -e "${YELLOW}📋 To use the /start command, please use your IDE:${NC}"
+            echo "1. Open your IDE (Claude, Cursor, Windsurf, etc.)"
+            echo "2. Type: /start"
+            echo "3. Follow the guided workflow selection"
+            echo ""
+            echo -e "${YELLOW}💡 Alternative: Use bmad-orchestrator directly${NC}"
+            echo "Copy this to your IDE chat:"
+            echo ""
+            echo -e "${GREEN}@bmad-orchestrator${NC}"
+            echo -e "${GREEN}*start${NC}"
+            ;;
+            
+        "status")
+            echo -e "${GREEN}✅ APPIQ Method Status${NC}"
+            echo "Installation directory: $appiq_dir"
+            echo "Version: $(cat "$appiq_dir/VERSION" 2>/dev/null || echo "Unknown")"
+            echo ""
+            echo "Available IDE integrations:"
+            [ -f "$appiq_dir/slash-commands/claude-appiq.md" ] && echo "  ✅ Claude"
+            [ -f "$appiq_dir/slash-commands/cursor-appiq.md" ] && echo "  ✅ Cursor"
+            [ -f "$appiq_dir/slash-commands/windsurf-appiq.md" ] && echo "  ✅ Windsurf"
+            ;;
+            
+        "help"|*)
+            echo -e "${BLUE}🎯 APPIQ Method - Global Commands${NC}"
+            echo ""
+            echo "Available commands:"
+            echo "  appiq start    - Launch universal project workflow (use in IDE)"
+            echo "  appiq status   - Show APPIQ Method installation status"
+            echo "  appiq help     - Show this help message"
+            echo ""
+            echo -e "${YELLOW}💡 Main Usage: Use /start in your IDE for guided workflow selection${NC}"
+            echo ""
+            echo "Supported IDEs:"
+            echo "  • Claude Code"
+            echo "  • Cursor"
+            echo "  • Windsurf"
+            echo "  • Any IDE with slash command support"
+            ;;
+    esac
+}
+
+main "$@"

package/#Tools/APPIQ-METHOD/deployment/installers/claude-integration.sh

@@ -0,0 +1,281 @@
+#!/bin/bash
+
+# APPIQ Method - Claude Code Integration Installer
+# Installs /appiq slash command properly in Claude Code
+
+set -e
+
+# Colors
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# Configuration
+PROJECT_ROOT="$(pwd)"
+CLAUDE_DIR=".claude"
+COMMANDS_DIR="${CLAUDE_DIR}/commands"
+
+echo -e "${CYAN}🔧 Installing APPIQ Method for Claude Code...${NC}"
+
+# Create Claude directories
+echo -e "${BLUE}📁 Creating Claude directories...${NC}"
+mkdir -p "${COMMANDS_DIR}"
+
+# Create the /appiq slash command for Claude
+echo -e "${BLUE}📝 Creating /appiq slash command...${NC}"
+cat > "${COMMANDS_DIR}/appiq.md" << 'EOF'
+# /appiq - APPIQ Method Universal Development Launcher
+
+**Quick Start**: `/appiq` - Interactive universal development workflow launcher
+
+## Overview
+
+The `/appiq` command provides an interactive way to launch the APPIQ Method universal development workflow. It guides users through project type selection and automatically triggers the appropriate development workflow for Web, Desktop, Mobile, or Backend projects based on their responses.
+
+## Usage
+
+```
+/appiq
+```
+
+## Interactive Flow
+
+When you use `/appiq`, the system will interactively guide you through:
+
+### Step 1: Project Status Selection
+```
+🚀 APPIQ Method Universal Launcher
+
+Arbeiten wir an einem neuen oder bestehenden Projekt?
+
+1. 🆕 Neues Projekt (Greenfield) - Wir bauen von Grund auf
+2. 🔧 Bestehendes Projekt (Brownfield) - Wir erweitern/verbessern etwas
+
+Antworte mit 1 oder 2:
+```
+
+### Step 2: Project Type Selection
+```
+📋 Lass mich verstehen, was wir bauen...
+
+Was für eine Art von Anwendung ist das?
+
+1. 🌐 Web-Anwendung (läuft im Browser)
+2. 💻 Desktop-Anwendung (Electron, Windows/Mac App)
+3. 📱 Mobile App (iOS/Android)
+4. ⚙️ Backend/API Service (Server, Database)
+5. 🤔 Bin mir nicht sicher - lass APPIQ entscheiden
+
+Antworte mit 1, 2, 3, 4 oder 5:
+```
+
+### Step 3: Auto-Detection or Platform Selection
+
+**For Mobile Projects (Option 3):**
+```
+📱 Mobile Platform Selection:
+
+1. Flutter - Cross-platform with Dart
+2. React Native - Cross-platform with React/JavaScript
+
+Antworte mit 1 oder 2:
+```
+
+**For Auto-Detection (Option 5):**
+- Brownfield projects: Analyzes existing project structure automatically
+- Greenfield projects: Requests project description for intelligent categorization
+
+### Step 4: Universal Workflow Launch
+
+Based on your responses, the system automatically launches the appropriate workflow:
+
+**Web Application Workflows:**
+- `greenfield-fullstack.yaml` - New web application development
+- `brownfield-fullstack.yaml` - Existing web application enhancement
+
+**Desktop Application Workflows:**
+- `greenfield-fullstack.yaml` - New desktop application development (Electron context)
+- `brownfield-fullstack.yaml` - Existing desktop application enhancement (Electron context)
+
+**Mobile Application Workflows:**
+- `mobile-greenfield-flutter.yaml` - New Flutter app development
+- `mobile-greenfield-react-native.yaml` - New React Native app development
+- `mobile-brownfield-flutter.yaml` - Existing Flutter app enhancement
+- `mobile-brownfield-react-native.yaml` - Existing React Native app enhancement
+
+**Backend Service Workflows:**
+- `greenfield-service.yaml` - New backend service development
+- `brownfield-service.yaml` - Existing backend service enhancement
+
+## Implementation
+
+When `/appiq` is executed, it performs the following logic:
+
+```javascript
+// Project status detection
+let projectType = await askUser("Project Status? (1) Greenfield (2) Brownfield");
+
+// Application category detection
+let appCategory = await askUser("App Type? (1) Web (2) Desktop (3) Mobile (4) Backend (5) Auto-detect");
+
+let platform = null;
+if (appCategory === "3") {
+    // Mobile - ask for platform
+    platform = await askUser("Mobile Platform? (1) Flutter (2) React Native");
+} else if (appCategory === "5") {
+    // Auto-detection logic
+    if (projectType === "2") {
+        // Brownfield - analyze existing project
+        let detection = await analyzeProject();
+        appCategory = detection.type;
+        platform = detection.platform;
+    } else {
+        // Greenfield - request description
+        let description = await askUser("Describe your project briefly:");
+        let detection = await analyzeDescription(description);
+        appCategory = detection.type;
+        platform = detection.platform;
+    }
+}
+
+// Launch appropriate workflow
+let workflowFile = getUniversalWorkflowFile(projectType, appCategory, platform);
+await launchWorkflow(workflowFile);
+```
+
+## Universal Workflow Mapping
+
+The command maps user selections to specific workflow files:
+
+| Project Type | App Category | Platform | Workflow File |
+|--------------|-------------|----------|---------------|
+| Greenfield | Web | - | `greenfield-fullstack.yaml` |
+| Greenfield | Desktop | - | `greenfield-fullstack.yaml` (Electron context) |
+| Greenfield | Mobile | Flutter | `mobile-greenfield-flutter.yaml` |
+| Greenfield | Mobile | React Native | `mobile-greenfield-react-native.yaml` |  
+| Greenfield | Backend | - | `greenfield-service.yaml` |
+| Brownfield | Web | - | `brownfield-fullstack.yaml` |
+| Brownfield | Desktop | - | `brownfield-fullstack.yaml` (Electron context) |
+| Brownfield | Mobile | Flutter | `mobile-brownfield-flutter.yaml` |
+| Brownfield | Mobile | React Native | `mobile-brownfield-react-native.yaml` |
+| Brownfield | Backend | - | `brownfield-service.yaml` |
+
+## Expected Workflow Launch
+
+After successful selection, the system launches with:
+
+```
+✅ Perfect! Launching [Workflow Name]...
+
+🎯 Starting with: workflow-file.yaml
+📍 First Agent: analyst (creating project-brief.md)
+📂 Expected Output: docs/project-brief.md
+
+The mobile development workflow will now guide you through:
+1. Mobile-focused project brief
+2. Mobile-specific PRD creation 
+3. Platform validation (Flutter/React Native)
+4. Mobile UX design system
+5. Mobile architecture planning
+6. Mobile security review
+7. Story creation and development
+
+@analyst - Please begin with creating a mobile-focused project brief considering app store landscape, device capabilities, and mobile user behavior.
+```
+
+## File Requirements
+
+For `/appiq` to work properly, ensure:
+
+1. **docs/main_prd.md exists** - Your Product Requirements Document
+2. **.appiq/ directory** - APPIQ Method installation directory
+3. **Workflow files** - Available in `.appiq/workflows/`
+4. **Agent files** - Available in `.appiq/agents/`
+
+## Error Handling
+
+The command provides helpful guidance for common issues:
+
+- **Missing main_prd.md**: Guides user to create the file first
+- **Invalid responses**: Re-prompts with valid options
+- **Platform detection failure**: Falls back to manual selection
+- **Workflow launch failure**: Validates installation and provides fix suggestions
+
+## Next Steps After Launch
+
+Once the workflow is triggered:
+
+1. **Follow Agent Sequence**: Each agent will create specific deliverables
+2. **Save Outputs**: Copy generated documents to your docs/ folder as instructed  
+3. **Review and Validate**: Use PO agent for document validation
+4. **Begin Development**: Start story implementation with mobile-developer agent
+5. **Quality Assurance**: Use mobile-qa agent for testing and review
+
+---
+
+**Related Files:**
+- Agent definitions in `.appiq/agents/`
+- Workflow files in `.appiq/workflows/`
+- Templates in `.appiq/templates/`
+- Project configuration in `.appiq/config/`
+EOF
+
+# Update Claude settings to include appiq command permissions
+echo -e "${BLUE}⚙️ Updating Claude settings...${NC}"
+
+SETTINGS_FILE="${CLAUDE_DIR}/settings.local.json"
+
+# Create settings file if it doesn't exist
+if [ ! -f "${SETTINGS_FILE}" ]; then
+    cat > "${SETTINGS_FILE}" << 'EOF'
+{
+  "permissions": {
+    "allow": [
+      "Bash(ls:*)",
+      "Bash(curl:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)"
+    ],
+    "deny": []
+  },
+  "appiq": {
+    "enabled": true,
+    "mobile_workflows": true,
+    "auto_detection": true
+  }
+}
+EOF
+else
+    # Merge with existing settings
+    echo -e "${YELLOW}📝 Merging with existing Claude settings...${NC}"
+    
+    # Backup existing settings
+    cp "${SETTINGS_FILE}" "${SETTINGS_FILE}.backup"
+    
+    # Add APPIQ configuration (simple append for now)
+    if ! grep -q '"appiq"' "${SETTINGS_FILE}"; then
+        # Remove closing brace and add APPIQ config
+        sed -i.tmp '$ s/}//' "${SETTINGS_FILE}"
+        cat >> "${SETTINGS_FILE}" << 'EOF'
+  "appiq": {
+    "enabled": true,
+    "mobile_workflows": true,
+    "auto_detection": true
+  }
+}
+EOF
+        rm -f "${SETTINGS_FILE}.tmp"
+    fi
+fi
+
+echo -e "${GREEN}✅ Claude Code integration installed successfully!${NC}"
+echo -e "${YELLOW}💡 You can now use ${CYAN}/appiq${YELLOW} in Claude Code to start mobile development${NC}"
+echo ""
+echo -e "${BLUE}📋 Files created:${NC}"
+echo "• ${COMMANDS_DIR}/appiq.md - Slash command definition"
+echo "• ${SETTINGS_FILE} - Updated settings with APPIQ support"
+echo ""
+echo -e "${YELLOW}🔄 Please restart Claude Code to activate the new command${NC}"

package/#Tools/APPIQ-METHOD/deployment/installers/cursor-integration.sh

@@ -0,0 +1,257 @@
+#!/bin/bash
+
+# APPIQ Method - Cursor IDE Integration Installer
+# Installs /appiq command and keyboard shortcuts for Cursor
+
+set -e
+
+# Colors
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# Configuration
+PROJECT_ROOT="$(pwd)"
+VSCODE_DIR=".vscode"
+
+echo -e "${CYAN}🔧 Installing APPIQ Method for Cursor IDE...${NC}"
+
+# Create VS Code directory
+echo -e "${BLUE}📁 Creating VS Code configuration directory...${NC}"
+mkdir -p "${VSCODE_DIR}"
+
+# Create settings.json with APPIQ configuration
+echo -e "${BLUE}⚙️ Creating Cursor settings...${NC}"
+
+SETTINGS_FILE="${VSCODE_DIR}/settings.json"
+
+# Base APPIQ settings for Cursor
+APPIQ_SETTINGS='{
+  "appiq.enabled": true,
+  "appiq.mobile_expansion": true,
+  "appiq.workflow_path": "./.appiq/workflows/",
+  "appiq.auto_detection": true,
+  "appiq.mobile_platform_detection": true,
+  "appiq.command_integration": true
+}'
+
+if [ ! -f "${SETTINGS_FILE}" ]; then
+    # Create new settings file
+    echo "${APPIQ_SETTINGS}" > "${SETTINGS_FILE}"
+else
+    # Merge with existing settings
+    echo -e "${YELLOW}📝 Merging with existing Cursor settings...${NC}"
+    
+    # Backup existing settings
+    cp "${SETTINGS_FILE}" "${SETTINGS_FILE}.backup"
+    
+    # Simple merge - add APPIQ settings if not present
+    if ! grep -q '"appiq"' "${SETTINGS_FILE}"; then
+        # Remove closing brace and add APPIQ config
+        sed -i.tmp '$ s/}//' "${SETTINGS_FILE}"
+        cat >> "${SETTINGS_FILE}" << 'EOF'
+  "appiq.enabled": true,
+  "appiq.mobile_expansion": true,
+  "appiq.workflow_path": "./.appiq/workflows/",
+  "appiq.auto_detection": true,
+  "appiq.mobile_platform_detection": true,
+  "appiq.command_integration": true
+}
+EOF
+        rm -f "${SETTINGS_FILE}.tmp"
+    fi
+fi
+
+# Create keybindings.json for Cursor shortcuts
+echo -e "${BLUE}⌨️ Creating Cursor keyboard shortcuts...${NC}"
+
+KEYBINDINGS_FILE="${VSCODE_DIR}/keybindings.json"
+
+APPIQ_KEYBINDINGS='[
+  {
+    "key": "ctrl+alt+a",
+    "mac": "cmd+alt+a",
+    "command": "workbench.action.terminal.sendSequence",
+    "args": {
+      "text": "/appiq\n"
+    },
+    "when": "terminalFocus"
+  },
+  {
+    "key": "ctrl+shift+alt+a",
+    "mac": "cmd+shift+alt+a", 
+    "command": "workbench.action.showCommands",
+    "args": "APPIQ: Launch Mobile Development Workflow"
+  }
+]'
+
+if [ ! -f "${KEYBINDINGS_FILE}" ]; then
+    # Create new keybindings file
+    echo "${APPIQ_KEYBINDINGS}" > "${KEYBINDINGS_FILE}"
+else
+    # Merge with existing keybindings
+    echo -e "${YELLOW}📝 Merging with existing Cursor keybindings...${NC}"
+    
+    # Backup existing keybindings
+    cp "${KEYBINDINGS_FILE}" "${KEYBINDINGS_FILE}.backup"
+    
+    # Add APPIQ keybindings if not present
+    if ! grep -q '"ctrl+alt+a"' "${KEYBINDINGS_FILE}"; then
+        # Remove closing bracket and add APPIQ keybindings
+        sed -i.tmp '$ s/\]//' "${KEYBINDINGS_FILE}"
+        cat >> "${KEYBINDINGS_FILE}" << 'EOF'
+  {
+    "key": "ctrl+alt+a",
+    "mac": "cmd+alt+a",
+    "command": "workbench.action.terminal.sendSequence",
+    "args": {
+      "text": "/appiq\n"
+    },
+    "when": "terminalFocus"
+  },
+  {
+    "key": "ctrl+shift+alt+a",
+    "mac": "cmd+shift+alt+a", 
+    "command": "workbench.action.showCommands",
+    "args": "APPIQ: Launch Mobile Development Workflow"
+  }
+]
+EOF
+        rm -f "${KEYBINDINGS_FILE}.tmp"
+    fi
+fi
+
+# Create tasks.json for APPIQ tasks
+echo -e "${BLUE}📋 Creating Cursor tasks...${NC}"
+
+TASKS_FILE="${VSCODE_DIR}/tasks.json"
+
+APPIQ_TASKS='{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "APPIQ: Launch Mobile Development Workflow",
+      "type": "shell",
+      "command": "/appiq",
+      "group": "build",
+      "presentation": {
+        "echo": true,
+        "reveal": "always",
+        "focus": false,
+        "panel": "shared"
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "APPIQ: Validate Setup",
+      "type": "shell", 
+      "command": "./.appiq/scripts/appiq",
+      "args": ["validate"],
+      "group": "test",
+      "presentation": {
+        "echo": true,
+        "reveal": "always",
+        "focus": false,
+        "panel": "shared"
+      }
+    },
+    {
+      "label": "APPIQ: Project Status",
+      "type": "shell",
+      "command": "./.appiq/scripts/appiq", 
+      "args": ["status"],
+      "group": "build",
+      "presentation": {
+        "echo": true,
+        "reveal": "always",
+        "focus": false,
+        "panel": "shared"
+      }
+    }
+  ]
+}'
+
+if [ ! -f "${TASKS_FILE}" ]; then
+    # Create new tasks file
+    echo "${APPIQ_TASKS}" > "${TASKS_FILE}"
+else
+    # Merge with existing tasks
+    echo -e "${YELLOW}📝 Merging with existing Cursor tasks...${NC}"
+    
+    # Backup existing tasks
+    cp "${TASKS_FILE}" "${TASKS_FILE}.backup"
+    
+    # Add APPIQ tasks if not present
+    if ! grep -q '"APPIQ: Launch Mobile Development Workflow"' "${TASKS_FILE}"; then
+        # Simple merge - add APPIQ tasks to existing tasks array
+        # This is a simplified merge, in production you'd want proper JSON merging
+        echo -e "${YELLOW}⚠️ Manual merge required for tasks.json - APPIQ tasks added to backup${NC}"
+    fi
+fi
+
+# Create Cursor-specific APPIQ configuration
+echo -e "${BLUE}📄 Creating Cursor APPIQ configuration...${NC}"
+
+cat > ".appiq/config/cursor.json" << 'EOF'
+{
+  "ide": "cursor",
+  "integration_type": "vscode_compatible",
+  "features": {
+    "command_palette": true,
+    "keyboard_shortcuts": true,
+    "tasks_integration": true,
+    "settings_integration": true,
+    "terminal_integration": true
+  },
+  "commands": {
+    "appiq_launch": {
+      "title": "APPIQ: Launch Mobile Development Workflow",
+      "description": "Start interactive mobile development workflow",
+      "shortcut": "Ctrl+Alt+A (Cmd+Alt+A on Mac)",
+      "category": "APPIQ Method"
+    },
+    "appiq_validate": {
+      "title": "APPIQ: Validate Setup", 
+      "description": "Validate APPIQ Method installation and project setup",
+      "category": "APPIQ Method"
+    },
+    "appiq_status": {
+      "title": "APPIQ: Project Status",
+      "description": "Show current project status and APPIQ configuration",
+      "category": "APPIQ Method"
+    }
+  },
+  "keybindings": [
+    {
+      "key": "ctrl+alt+a",
+      "mac": "cmd+alt+a",
+      "action": "launch_appiq_workflow",
+      "when": "terminalFocus"
+    },
+    {
+      "key": "ctrl+shift+alt+a", 
+      "mac": "cmd+shift+alt+a",
+      "action": "show_appiq_commands",
+      "when": "editorFocus"
+    }
+  ]
+}
+EOF
+
+echo -e "${GREEN}✅ Cursor IDE integration installed successfully!${NC}"
+echo ""
+echo -e "${YELLOW}💡 How to use APPIQ in Cursor:${NC}"
+echo -e "${CYAN}1. Chat Command:${NC} Type '/appiq' in Cursor chat"
+echo -e "${CYAN}2. Keyboard Shortcut:${NC} Press Ctrl+Alt+A (Cmd+Alt+A on Mac)"
+echo -e "${CYAN}3. Command Palette:${NC} Ctrl+Shift+P → 'APPIQ: Launch Mobile Development Workflow'"
+echo -e "${CYAN}4. Terminal:${NC} Use '/appiq' command (requires PATH setup)"
+echo ""
+echo -e "${BLUE}📋 Files created/updated:${NC}"
+echo "• ${SETTINGS_FILE} - Cursor settings with APPIQ support"
+echo "• ${KEYBINDINGS_FILE} - Keyboard shortcuts for APPIQ commands"
+echo "• ${TASKS_FILE} - Cursor tasks for APPIQ operations"
+echo "• .appiq/config/cursor.json - Cursor-specific configuration"
+echo ""
+echo -e "${YELLOW}🔄 Please restart Cursor to activate new settings and shortcuts${NC}"