appiq-solution 1.3.2 → 1.4.2

package/#Tools/APPIQ-METHOD/bmad-core/working-in-the-brownfield.md

@@ -2,10 +2,10 @@
 
 > **HIGHLY RECOMMENDED: Use Gemini Web or Gemini CLI for Brownfield Documentation Generation!**
 >
-> Gemini Web's 1M+ token context window or Gemini CLI (when its working) can analyze your ENTIRE codebase or critical sections of it all at once (obviously within reason):
+> Gemini Web's 1M+ token context window or Gemini CLI (when it's working) can analyze your ENTIRE codebase, or critical sections of it, all at once (obviously within reason):
 >
 > - Upload via GitHub URL or use gemini cli in the project folder
-> - If in the web: Upload up to 1000 files or the zipped project or just give it the github url
+> - If working in the web: use `npx bmad-method flatten` to flatten your project into a single file, then upload that file to your web agent.
 
 ## What is Brownfield Development?
 
@@ -22,10 +22,13 @@ Brownfield development refers to adding features, fixing bugs, or modernizing ex
 
 ## When NOT to use a Brownfield Flow
 
-If you have just completed an MVP with BMad, and you want to continue with post-MVP, its easier to just talk to the PM and ask him to work with you to create a new epic to add into the PRD, shard out the epic, update any architecture documents with the architect, and just go from there.
+If you have just completed an MVP with BMad, and you want to continue with post-MVP, its easier to just talk to the PM and ask it to work with you to create a new epic to add into the PRD, shard out the epic, update any architecture documents with the architect, and just go from there.
 
 ## The Complete Brownfield Workflow
 
+1. **Follow the [<ins>User Guide - Installation</ins>](user-guide.md#installation) steps to setup your agent in the web.**
+2. **Generate a 'flattened' single file of your entire codebase** run: ```npx bmad-method flatten```
+
 ### Choose Your Approach
 
 #### Approach A: PRD-First (Recommended if adding very large and complex new features, single or multiple epics or massive changes)
@@ -48,20 +51,29 @@ If you have just completed an MVP with BMad, and you want to continue with post-
 
 #### Phase 1: Define Requirements First
 
-**In Gemini Web (with your codebase uploaded):**
+**Create PRD.md file directly:**
 
-```bash
-@pm
-*create-doc brownfield-prd
-```
+Instead of asking questions, simply create a `docs/prd.md` file in your project with your enhancement requirements. The AI agents (PO, PM, Architect) can then work with this existing document.
 
-The PM will:
+**PRD.md Template:**
+```markdown
+# Project Requirements Document
 
-- **Ask about your enhancement** requirements
-- **Explore the codebase** to understand current state
-- **Identify affected areas** that need documentation
-- **Create focused PRD** with clear scope
+## Project Overview
+- **Project Name**: [Your project name]
+- **Enhancement**: [Brief description of what you want to add]
+
+## Requirements
+- [List your specific requirements]
+- [Integration needs]
+- [Constraints]
+
+## Existing System
+- [Brief description of current system]
+- [Key components that will be affected]
+```
 
+**Key Advantage**: AI agents can immediately work with your PRD without needing to ask questions about project details!
 **Key Advantage**: The PRD identifies which parts of your monorepo/large codebase actually need documentation!
 
 #### Phase 2: Focused Documentation
@@ -69,7 +81,7 @@ The PM will:
 **Still in Gemini Web, now with PRD context:**
 
 ```bash
-@analyst
+@architect
 *document-project
 ```
 
@@ -104,22 +116,21 @@ For example, if you say "Add payment processing to user service":
 1. **Go to Gemini Web** (gemini.google.com)
 2. **Upload your project**:
    - **Option A**: Paste your GitHub repository URL directly
-   - **Option B**: Upload up to 1000 files from your src/project folder
-   - **Option C**: Zip your project and upload the archive
-3. **Load the analyst agent**: Upload `dist/agents/analyst.txt`
+   - **Option B**: Upload your flattened-codebase.xml file
+3. **Load the analyst agent**: Upload `dist/agents/architect.txt`
 4. **Run documentation**: Type `*document-project`
 
 The analyst will generate comprehensive documentation of everything.
 
 #### Phase 2: Plan Your Enhancement
 
-#### Option A: Full Brownfield Workflow (Recommended for Major Changes)
+##### Option A: Full Brownfield Workflow (Recommended for Major Changes)
 
 **1. Create Brownfield PRD**:
 
 ```bash
 @pm
-*create-doc brownfield-prd
+*create-brownfield-prd
 ```
 
 The PM agent will:
@@ -146,7 +157,7 @@ The PM agent will:
 
 ```bash
 @architect
-*create-doc brownfield-architecture
+*create-brownfield-architecture
 ```
 
 The architect will:
@@ -157,13 +168,13 @@ The architect will:
 - **Identify technical risks**
 - **Define compatibility requirements**
 
-#### Option B: Quick Enhancement (For Focused Changes)
+##### Option B: Quick Enhancement (For Focused Changes)
 
 **For Single Epic Without Full PRD**:
 
 ```bash
 @pm
-*brownfield-create-epic
+*create-brownfield-epic
 ```
 
 Use when:
@@ -177,7 +188,7 @@ Use when:
 
 ```bash
 @pm
-*brownfield-create-story
+*create-brownfield-story
 ```
 
 Use when:
@@ -191,7 +202,7 @@ Use when:
 
 ```bash
 @po
-*execute-checklist po-master-checklist
+*execute-checklist-po
 ```
 
 The PO ensures:
@@ -201,26 +212,27 @@ The PO ensures:
 - Risk mitigation strategies in place
 - Clear integration approach
 
-### Phase 4: Transition to Development
-
-Follow the enhanced IDE Development Workflow:
+### Phase 4: Save and Shard Documents
 
-1. **Ensure documents are in project**:
+1. Save your PRD and Architecture as:
+   docs/brownfield-prd.md
+   docs/brownfield-architecture.md
+2. Shard your docs:
+   In your IDE
 
-   - Copy `docs/prd.md` (or brownfield-prd.md)
-   - Copy `docs/architecture.md` (or brownfield-architecture.md)
-
-2. **Shard documents**:
+   ```bash
+   @po
+   shard docs/brownfield-prd.md
+   ```
 
    ```bash
    @po
-   # Ask to shard docs/prd.md
+   shard docs/brownfield-architecture.md
    ```
 
-3. **Development cycle**:
-   - **SM** creates stories with integration awareness
-   - **Dev** implements with existing code respect
-   - **QA** reviews for compatibility and improvements
+### Phase 5: Transition to Development
+
+**Follow the [<ins>Enhanced IDE Development Workflow</ins>](enhanced-ide-development-workflow.md)**
 
 ## Brownfield Best Practices
 
@@ -287,7 +299,7 @@ Document:
 ### Scenario 3: Bug Fix in Complex System
 
 1. Document relevant subsystems
-2. Use `brownfield-create-story` for focused fix
+2. Use `create-brownfield-story` for focused fix
 3. Include regression test requirements
 4. QA validates no side effects
 
@@ -310,7 +322,7 @@ Document:
 
 ### "Too much boilerplate for small changes"
 
-**Solution**: Use `brownfield-create-story` instead of full workflow
+**Solution**: Use `create-brownfield-story` instead of full workflow
 
 ### "Integration points unclear"
 
@@ -322,19 +334,19 @@ Document:
 
 ```bash
 # Document existing project
-@analyst → *document-project
+@architect → *document-project
 
 # Create enhancement PRD
-@pm → *create-doc brownfield-prd
+@pm → *create-brownfield-prd
 
 # Create architecture with integration focus
-@architect → *create-doc brownfield-architecture
+@architect → *create-brownfield-architecture
 
 # Quick epic creation
-@pm → *brownfield-create-epic
+@pm → *create-brownfield-epic
 
 # Single story creation
-@pm → *brownfield-create-story
+@pm → *create-brownfield-story
 ```
 
 ### Decision Tree

package/#Tools/APPIQ-METHOD/commands/README.md

@@ -0,0 +1,28 @@
+# APPIQ Commands Reference
+
+## Available Commands
+
+### `/appiq`
+Start intelligent project creation with automatic tech stack detection
+
+### `/story`
+Create a new development story with context-aware template selection
+
+### `/analyze`
+Analyze current project structure and recommend optimal workflow
+
+### `/help`
+Show all available commands with examples
+
+
+## Usage
+Simply type any command (e.g., `/appiq`) in your IDE to start the intelligent workflow.
+
+## Support
+- 📚 [User Guide](bmad-core/user-guide.md)
+- 🎯 [Agent Reference](bmad-core/agents/)
+- 💬 [Discord](https://discord.gg/gk8jAdXWmj)
+- 🐙 [GitHub](https://github.com/Viktor-Hermann/APPIQ-METHOD)
+
+---
+*Generated by APPIQ Smart Installer v4.0.0*

package/#Tools/APPIQ-METHOD/commands/analyze.md

@@ -0,0 +1,27 @@
+# /analyze
+
+## Description
+Analyze current project structure and recommend optimal workflow
+
+## Usage
+Type `/analyze` in your IDE to activate the APPIQ Smart Launcher.
+
+## What happens:
+1. **Context Analysis** - Analyzes your current project setup
+2. **Agent Activation** - Loads the bmad-smart-launcher agent
+3. **Intelligent Guidance** - Provides step-by-step workflow guidance
+4. **Task Execution** - Coordinates appropriate agents to complete tasks
+
+## Prerequisites
+- APPIQ-METHOD installed in project
+- Supported IDE (Cursor, Claude, VS Code)
+- Node.js v20+
+
+## Related Commands
+- `/appiq` - Main project creation workflow
+- `/story` - Development story creation
+- `/analyze` - Project analysis
+- `/help` - Command reference
+
+---
+*Generated by APPIQ Smart Installer v4.0.0*

package/#Tools/APPIQ-METHOD/commands/appiq.md

@@ -0,0 +1,27 @@
+# /appiq
+
+## Description
+Start intelligent project creation with automatic tech stack detection
+
+## Usage
+Type `/appiq` in your IDE to activate the APPIQ Smart Launcher.
+
+## What happens:
+1. **Context Analysis** - Analyzes your current project setup
+2. **Agent Activation** - Loads the bmad-smart-launcher agent
+3. **Intelligent Guidance** - Provides step-by-step workflow guidance
+4. **Task Execution** - Coordinates appropriate agents to complete tasks
+
+## Prerequisites
+- APPIQ-METHOD installed in project
+- Supported IDE (Cursor, Claude, VS Code)
+- Node.js v20+
+
+## Related Commands
+- `/appiq` - Main project creation workflow
+- `/story` - Development story creation
+- `/analyze` - Project analysis
+- `/help` - Command reference
+
+---
+*Generated by APPIQ Smart Installer v4.0.0*

package/#Tools/APPIQ-METHOD/commands/help.md

@@ -0,0 +1,27 @@
+# /help
+
+## Description
+Show all available commands with examples
+
+## Usage
+Type `/help` in your IDE to activate the APPIQ Smart Launcher.
+
+## What happens:
+1. **Context Analysis** - Analyzes your current project setup
+2. **Agent Activation** - Loads the bmad-smart-launcher agent
+3. **Intelligent Guidance** - Provides step-by-step workflow guidance
+4. **Task Execution** - Coordinates appropriate agents to complete tasks
+
+## Prerequisites
+- APPIQ-METHOD installed in project
+- Supported IDE (Cursor, Claude, VS Code)
+- Node.js v20+
+
+## Related Commands
+- `/appiq` - Main project creation workflow
+- `/story` - Development story creation
+- `/analyze` - Project analysis
+- `/help` - Command reference
+
+---
+*Generated by APPIQ Smart Installer v4.0.0*

package/#Tools/APPIQ-METHOD/commands/story.md

@@ -0,0 +1,27 @@
+# /story
+
+## Description
+Create a new development story with context-aware template selection
+
+## Usage
+Type `/story` in your IDE to activate the APPIQ Smart Launcher.
+
+## What happens:
+1. **Context Analysis** - Analyzes your current project setup
+2. **Agent Activation** - Loads the bmad-smart-launcher agent
+3. **Intelligent Guidance** - Provides step-by-step workflow guidance
+4. **Task Execution** - Coordinates appropriate agents to complete tasks
+
+## Prerequisites
+- APPIQ-METHOD installed in project
+- Supported IDE (Cursor, Claude, VS Code)
+- Node.js v20+
+
+## Related Commands
+- `/appiq` - Main project creation workflow
+- `/story` - Development story creation
+- `/analyze` - Project analysis
+- `/help` - Command reference
+
+---
+*Generated by APPIQ Smart Installer v4.0.0*

package/#Tools/APPIQ-METHOD/dist/agents/bmad-orchestrator.txt

@@ -77,7 +77,6 @@ persona:
     - Always remind users that commands require * prefix
 commands:
   help: Show this guide with available agents and workflows
-  start: Universal project launcher with smart detection and guided workflow selection
   chat-mode: Start conversational mode for detailed assistance
   kb-mode: Load full BMad knowledge base
   status: Show current context, active agent, and progress
@@ -99,7 +98,6 @@ help-display-template: |
 
   Core Commands:
   *help ............... Show this guide
-  *start .............. 🚀 Universal project launcher (RECOMMENDED FOR BEGINNERS)
   *chat-mode .......... Start conversational mode for detailed assistance
   *kb-mode ............ Load full BMad knowledge base
   *status ............. Show current context, active agent, and progress
@@ -161,115 +159,6 @@ workflow-guidance:
   - Adapt questions to the specific domain (e.g., game dev vs infrastructure vs web dev)
   - Only recommend workflows that actually exist in the current bundle
   - When *workflow-guidance is called, start an interactive session and list all available workflows with brief descriptions
-start-behavior:
-  step1-project-status:
-    question: |
-      🚀 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:
-    responses:
-      '1': new_project
-      '2': existing_project
-  step2-project-type:
-    question: |
-      📋 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:
-    responses:
-      '1': web_app
-      '2': desktop_app
-      '3': mobile_app
-      '4': backend_service
-      '5': auto_detect
-  workflow-mapping:
-    new_project:
-      web_app: greenfield-fullstack.yaml
-      desktop_app: greenfield-fullstack.yaml
-      mobile_app: mobile-platform-selection
-      backend_service: greenfield-service.yaml
-      auto_detect: project-description-analysis
-    existing_project:
-      web_app: brownfield-fullstack.yaml
-      desktop_app: brownfield-fullstack.yaml
-      mobile_app: mobile-platform-detection
-      backend_service: brownfield-service.yaml
-      auto_detect: project-structure-analysis
-  auto-detection:
-    new-project-analysis:
-      prompt: |
-        🔍 Lass uns gemeinsam herausfinden, was das beste für dein Projekt ist...
-
-        Beschreibe kurz dein Projekt in 1-2 Sätzen:
-        (z.B. "Eine Ecommerce-Website mit Admin-Panel" oder "Eine Todo-App für Windows")
-      keywords:
-        web:
-          - website
-          - web
-          - browser
-          - online
-          - webapp
-          - ecommerce
-          - cms
-        desktop:
-          - desktop
-          - electron
-          - windows
-          - mac
-          - app
-          - gui
-          - standalone
-        mobile:
-          - mobile
-          - ios
-          - android
-          - app store
-          - phone
-          - tablet
-        backend:
-          - api
-          - server
-          - backend
-          - database
-          - service
-          - microservice
-    existing-project-analysis:
-      message: |
-        🔍 Analysiere dein bestehendes Projekt...
-
-        Ich schaue mir deine Projekt-Struktur an...
-      file-patterns:
-        desktop:
-          - package.json + electron dependency
-        mobile-react-native:
-          - package.json + react-native dependency
-        mobile-flutter:
-          - pubspec.yaml present
-        web:
-          - package.json + (next|react|vue|angular)
-        backend-node:
-          - package.json + (express|fastify|koa)
-        backend-python:
-          - requirements.txt + (flask|django|fastapi)
-        backend-java:
-          - pom.xml or build.gradle
-  context-messages:
-    desktop: Fokus auf Electron Desktop-Anwendung mit plattformspezifischen Optimierungen
-    mobile: Plattform-Erkennung erforderlich (Flutter/React Native)
-    web: Full-Stack Web-Anwendung mit Frontend und Backend Komponenten
-    backend: API-Design und Datenarchitektur im Fokus
 dependencies:
   tasks:
     - advanced-elicitation.md

package/#Tools/APPIQ-METHOD/dist/agents/pm.txt

@@ -74,6 +74,8 @@ commands:
   - help: Show numbered list of the following commands to allow selection
   - create-prd: run task create-doc.md with template prd-tmpl.yaml
   - create-brownfield-prd: run task create-doc.md with template brownfield-prd-tmpl.yaml
+  - create-brownfield-epic: run task brownfield-create-epic.md
+  - create-brownfield-story: run task brownfield-create-story.md
   - create-epic: Create epic for brownfield projects (task brownfield-create-epic)
   - create-story: Create user story from requirements (task brownfield-create-story)
   - doc-out: Output full document to current destination file

package/#Tools/APPIQ-METHOD/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt

@@ -157,7 +157,6 @@ persona:
     - Always remind users that commands require * prefix
 commands:
   help: Show this guide with available agents and workflows
-  start: Universal project launcher with smart detection and guided workflow selection
   chat-mode: Start conversational mode for detailed assistance
   kb-mode: Load full BMad knowledge base
   status: Show current context, active agent, and progress
@@ -179,7 +178,6 @@ help-display-template: |
 
   Core Commands:
   *help ............... Show this guide
-  *start .............. 🚀 Universal project launcher (RECOMMENDED FOR BEGINNERS)
   *chat-mode .......... Start conversational mode for detailed assistance
   *kb-mode ............ Load full BMad knowledge base
   *status ............. Show current context, active agent, and progress
@@ -241,115 +239,6 @@ workflow-guidance:
   - Adapt questions to the specific domain (e.g., game dev vs infrastructure vs web dev)
   - Only recommend workflows that actually exist in the current bundle
   - When *workflow-guidance is called, start an interactive session and list all available workflows with brief descriptions
-start-behavior:
-  step1-project-status:
-    question: |
-      🚀 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:
-    responses:
-      '1': new_project
-      '2': existing_project
-  step2-project-type:
-    question: |
-      📋 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:
-    responses:
-      '1': web_app
-      '2': desktop_app
-      '3': mobile_app
-      '4': backend_service
-      '5': auto_detect
-  workflow-mapping:
-    new_project:
-      web_app: greenfield-fullstack.yaml
-      desktop_app: greenfield-fullstack.yaml
-      mobile_app: mobile-platform-selection
-      backend_service: greenfield-service.yaml
-      auto_detect: project-description-analysis
-    existing_project:
-      web_app: brownfield-fullstack.yaml
-      desktop_app: brownfield-fullstack.yaml
-      mobile_app: mobile-platform-detection
-      backend_service: brownfield-service.yaml
-      auto_detect: project-structure-analysis
-  auto-detection:
-    new-project-analysis:
-      prompt: |
-        🔍 Lass uns gemeinsam herausfinden, was das beste für dein Projekt ist...
-
-        Beschreibe kurz dein Projekt in 1-2 Sätzen:
-        (z.B. "Eine Ecommerce-Website mit Admin-Panel" oder "Eine Todo-App für Windows")
-      keywords:
-        web:
-          - website
-          - web
-          - browser
-          - online
-          - webapp
-          - ecommerce
-          - cms
-        desktop:
-          - desktop
-          - electron
-          - windows
-          - mac
-          - app
-          - gui
-          - standalone
-        mobile:
-          - mobile
-          - ios
-          - android
-          - app store
-          - phone
-          - tablet
-        backend:
-          - api
-          - server
-          - backend
-          - database
-          - service
-          - microservice
-    existing-project-analysis:
-      message: |
-        🔍 Analysiere dein bestehendes Projekt...
-
-        Ich schaue mir deine Projekt-Struktur an...
-      file-patterns:
-        desktop:
-          - package.json + electron dependency
-        mobile-react-native:
-          - package.json + react-native dependency
-        mobile-flutter:
-          - pubspec.yaml present
-        web:
-          - package.json + (next|react|vue|angular)
-        backend-node:
-          - package.json + (express|fastify|koa)
-        backend-python:
-          - requirements.txt + (flask|django|fastapi)
-        backend-java:
-          - pom.xml or build.gradle
-  context-messages:
-    desktop: Fokus auf Electron Desktop-Anwendung mit plattformspezifischen Optimierungen
-    mobile: Plattform-Erkennung erforderlich (Flutter/React Native)
-    web: Full-Stack Web-Anwendung mit Frontend und Backend Komponenten
-    backend: API-Design und Datenarchitektur im Fokus
 dependencies:
   tasks:
     - advanced-elicitation.md