appiq-solution 1.6.4 → 1.7.0

package/CHANGELOG.md

@@ -1,3 +1,65 @@
+# [1.5.0] APPIQ Flutter Mobile Dev Extension (2025-07-30)
+
+## 🚨 MAJOR FEATURES - MANDATORY DEVELOPMENT RULES
+
+### ✨ New Features
+
+* **🔧 Mandatory Development Rules System**: Complete enforcement of development standards
+  - **8-Step Standard Workflow**: THINK → PLAN → VERIFY → WORK → EXPLAIN → SIMPLE → REVIEW → COMMIT
+  - **5 Quality Gates**: DRY, Readable, Maintainable, Performant, Testable (ALL must pass!)
+  - **Automatic Rule Loading**: All agents now automatically load mandatory rules
+  - **Instant Failure Detection**: Static text, code duplication, architecture violations
+
+* **🤖 Enhanced Flutter Agents**: All agents updated with mandatory workflow enforcement
+  - **flutter-ui-agent**: Enhanced with pre-coding checklist and quality gates
+  - **flutter-cubit-agent**: Mandatory state management patterns
+  - **flutter-domain-agent**: Business logic validation rules
+  - **flutter-data-agent**: Repository pattern enforcement
+  - **shared-components-agent**: Component reuse validation
+
+* **✅ Automatic Validation System**: `validate-mandatory-rules.md` task
+  - **Script-based validation**: Automatic checks for all quality criteria
+  - **Comprehensive reporting**: Success/failure reports with specific actions
+  - **Pre-commit validation**: Prevents bad code from being committed
+  - **Architecture compliance**: Clean Architecture layer validation
+
+* **📋 Enhanced Development Guidelines**: `flutter-development-guidelines.md`
+  - **MANDATORY sections**: Critical rules that MUST be followed
+  - **Failure conditions**: Clear instant failure scenarios
+  - **Pre-coding checklists**: What to check before writing any code
+  - **Integration rules**: How to work with existing codebase
+
+* **⚙️ Core Configuration Enhancement**: `core-config-smart.yaml`
+  - **mandatoryRules enforcement**: Automatic rule application
+  - **devLoadAlwaysFiles**: Rules loaded with every agent
+  - **Quality gates configuration**: All 5 criteria enforced
+  - **Failure condition settings**: Configurable instant failures
+
+### 🔧 Improvements
+
+* **Code Reuse Optimization**: Always check existing components before creating new ones
+* **Pattern Consistency**: Enforce existing architectural patterns
+* **Localization Enforcement**: NO static text allowed - all text must use AppLocalizations
+* **Testing Requirements**: Comprehensive test coverage mandatory
+* **Performance Standards**: Optimized implementations required
+
+### 💥 Breaking Changes
+
+* **Static Text**: Now causes instant failure - ALL text must use AppLocalizations
+* **Code Duplication**: Instant failure when shared components exist
+* **Pattern Breaking**: Cannot create new patterns without approval
+* **Missing Tests**: All new features must have comprehensive tests
+* **Architecture Violations**: Clean Architecture must be followed strictly
+
+### 🎯 Developer Experience
+
+* **Consistent Code Quality**: All code looks like it's from a single developer
+* **Automatic Enforcement**: Rules applied automatically in Cursor, Claude Code, and all IDEs
+* **Clear Guidelines**: Explicit failure conditions and success criteria
+* **Validation Feedback**: Detailed reports on what needs to be fixed
+
+---
+
 ## [4.33.1](https://github.com/bmadcode/BMAD-METHOD/compare/v4.33.0...v4.33.1) (2025-07-29)
 
 

package/README.md

@@ -90,61 +90,85 @@ Since you already have documented architecture, this is the perfect starting poi
 - Creates a "Brownfield Analysis" with recommendations
 - Defines how new features fit into your existing structure
 
-### 3. Plan Livestream Feature
+### 3. Start the Master Flutter Workflow
 
-Now the Scrum Master comes into play:
+Now use the **Master Flutter Orchestrator** to automatically handle everything:
 
-```bash
-@sm
-```
-
-**The SM will ask you:**
-- Which specific livestream functions are needed
-- Which UI components are required
-- How the feature integrates into existing navigation
-- Which backend endpoints are needed
-
-### 4. Automatic Flutter Workflow Starts
-
-Once the story is defined, the `flutter-ui-first-development` workflow automatically starts:
-
-**Phase 1: UI Design (Maya - flutter-ui-agent)**
 ```
-"How should the livestream UI look?"
-"Which widgets do we need (Player, Chat, Controls)?"
-"Where in existing navigation will it be integrated?"
+/flutter-init-agent - Erstelle eine TikTok-ähnliche Livestream-UI mit:
+- Vertical Video Player (Vollbild)
+- Like Button mit Animation
+- Share Button
+- Kommentar-System (Real-time)
+- Viewer Counter
+- Follow Button
+
+Target Folder: lib/features/livestream/
+Screenshots: [Optional: Füge Screenshots oder Mockups hinzu]
 ```
 
-Maya creates:
-- Livestream pages (`livestream_page.dart`, `livestream_detail_page.dart`)
-- Custom widgets (`livestream_player_widget.dart`, `chat_widget.dart`)
-- Localization keys for all texts
-- Integration into your existing navigation
-
-**Phase 2: State Management (Alex - flutter-cubit-agent)**
-
-Alex implements:
-- `LivestreamCubit` with States (initial, loading, streaming, error)
-- `LivestreamState` class with all required data
-- Error handling for connection drops
-- Integration with your existing state patterns
-
-**Phase 3: Business Logic (Jordan - flutter-domain-agent)**
-
-Jordan creates:
-- `LivestreamEntity` (Stream-ID, URL, Viewer-Count, etc.)
-- `StartLivestreamUseCase`, `StopLivestreamUseCase`
-- `LivestreamRepository` Interface
-- Business validation (e.g., permission checks)
-
-**Phase 4: Data Layer (Sam - flutter-data-agent)**
-
-Sam implements:
-- `LivestreamRepositoryImpl`
-- `LivestreamRemoteDataSource` (API calls)
-- `LivestreamLocalDataSource` (caching)
-- `LivestreamModel` with JSON serialization
-- WebSocket integration for real-time chat
+### 4. Automatic End-to-End Workflow
+
+The `flutter-init-agent` will **automatically orchestrate the complete development process**:
+
+#### **🎯 Phase 1: Automatic Analysis**
+- **Scans your existing codebase** using `npx appiq-solution flatten`
+- **Analyzes architecture patterns** (routing, state management, DI)
+- **Identifies integration points** with your existing features
+- **Plans implementation strategy** for the new feature
+
+#### **🏗️ Phase 2: Team Orchestration**
+The agent automatically triggers this sequence:
+
+**2.1 Product Owner (@po)**
+- Creates user stories, epics, and acceptance criteria
+- Defines feature breakdown and requirements
+
+**2.2 Architect (@architect)**  
+- Analyzes existing codebase structure
+- Plans integration with current architecture
+- Defines backend requirements (Supabase tables, etc.)
+- Creates implementation guidelines
+
+**2.3 UI Development (@flutter-ui-agent)**
+- Creates pages and navigation integration
+- Implements custom widgets and animations
+- Ensures responsive design and accessibility
+
+**2.4 State Management (@flutter-cubit-agent)**
+- Implements Cubit/BLoC patterns matching your existing setup
+- Handles error states and loading management
+- Integrates with current state management
+
+**2.5 Business Logic (@flutter-domain-agent)**
+- Creates entities, use cases, and business rules
+- Implements validation and business logic
+- Defines repository interfaces
+
+**2.6 Data Layer (@flutter-data-agent)**
+- Implements repository pattern
+- Creates API integration and caching
+- Handles data serialization and persistence
+
+**2.7 Backend Integration (MCP Supabase/Firebase)**
+- Creates database tables and relationships
+- Sets up authentication and security rules
+- Implements real-time features
+
+**2.8 Quality Assurance (@qa)**
+- Performs code review against existing patterns
+- Implements comprehensive testing strategy
+- Validates architecture consistency
+
+**2.9 Security Audit (@flutter-security-agent)**
+- Checks for security vulnerabilities
+- Validates API key protection
+- Ensures data privacy compliance
+
+**2.10 Git Integration**
+- Commits changes with proper messages
+- Creates feature branches
+- Prepares for code review
 
 ### 5. Backend Integration
 
@@ -161,27 +185,49 @@ After each phase runs automatically:
 - Testing (Unit, Widget, Integration tests)
 - Security validation
 
-## 🔄 Your Concrete Workflow
+## 🔄 Your Complete Workflow
 
-**One-time setup:**
+### **One-time setup:**
 ```bash
 npx appiq-solution  # Choose appiq-flutter-mobile-dev
-@architect          # Analyze existing architecture
+@architect          # Analyze existing architecture (optional)
 ```
 
-**For each new feature:**
-```bash
-@sm  # "Create story for [Feature-Name]"
-```
-- System runs automatically through all agents
-- You provide input/feedback at respective handoff points
-- At the end you have a fully implemented feature
-
-**In your IDE (Cursor, Claude, etc.):**
+### **For each new feature - Just one command:**
 ```
-@smart-launcher
+/flutter-init-agent - Erstelle ein Instagram-ähnliches Story Feature mit:
+- Vollbild Story Viewer
+- Progress Indicators  
+- Swipe Navigation
+- Story Creation (Foto/Video)
+- Story Archive
+- View Analytics
+
+Target Folder: lib/features/stories/
+Backend: Supabase (stories table, media storage)
+Integration: Mit bestehendem User System
 ```
 
+### **What happens automatically:**
+✅ **Complete codebase analysis** and architecture understanding  
+✅ **Automatic team orchestration** through all specialized agents  
+✅ **End-to-end implementation** from UI to backend  
+✅ **Quality assurance** and security validation  
+✅ **Git integration** with proper commits  
+
+**You only need to:**
+- Provide the initial feature description
+- Give feedback when agents ask for clarification
+- Review and approve the final implementation
+
+### **Available Flutter Agents:**
+- `/flutter-init-agent` - Master orchestrator for complete features
+- `/flutter-ui-agent` - UI components and design
+- `/flutter-cubit-agent` - State management
+- `/flutter-domain-agent` - Business logic
+- `/flutter-data-agent` - Data layer and APIs
+- `/flutter-security-agent` - Security auditing
+
 ## 🗂️ Codebase Context Management
 
 Automatic context export after every feature/milestone:

package/bmad-core/core-config-extended.yaml

@@ -0,0 +1,39 @@
+markdownExploder: true
+prd:
+  prdFile: docs/prd.md
+  prdVersion: v4
+  prdSharded: true
+  prdShardedLocation: docs/prd
+  epicFilePattern: epic-{n}*.md
+  # NEUE ERWEITERUNG: PRD Pattern-Erkennung
+  prdFilePattern: "*_prd.md"  # Erkennt alle Dateien die mit _prd.md enden
+  autoPrdDetection: true      # Aktiviert automatische PRD-Erkennung
+  autoPrdSharding: true       # Automatisches Sharding bei Erkennung
+  autoPrdWorkflow: true       # Startet automatisch PO → SM → Dev Workflow
+
+architecture:
+  architectureFile: docs/architecture.md
+  architectureVersion: v4
+  architectureSharded: true
+  architectureShardedLocation: docs/architecture
+
+# Erweiterte Workflow-Automatisierung
+autoWorkflow:
+  enabled: true
+  scanDirectories: 
+    - "docs/"
+    - "features/"
+    - "./"
+  triggerPatterns:
+    - "*_prd.md"
+    - "*_requirements.md" 
+    - "*_feature.md"
+
+customTechnicalDocuments: null
+devLoadAlwaysFiles:
+  - docs/architecture/coding-standards.md
+  - docs/architecture/tech-stack.md
+  - docs/architecture/source-tree.md
+devDebugLog: .ai/debug-log.md
+devStoryLocation: docs/stories
+slashPrefix: bmad

package/bmad-core/core-config-smart.yaml

@@ -0,0 +1,184 @@
+markdownExploder: true
+
+# Standard PRD Configuration
+prd:
+  prdFile: docs/prd.md
+  prdVersion: v4
+  prdSharded: true
+  prdShardedLocation: docs/prd
+  epicFilePattern: epic-{n}*.md
+  
+  # Enhanced PRD Pattern Recognition
+  prdFilePattern: "*_prd.md"
+  requirementsFilePattern: "*_requirements.md"
+  featureFilePattern: "*_feature.md"
+  
+  # Auto-Detection Settings
+  autoPrdDetection: true
+  autoPrdSharding: true
+  autoPrdWorkflow: true
+
+architecture:
+  architectureFile: docs/architecture.md
+  architectureVersion: v4
+  architectureSharded: true
+  architectureShardedLocation: docs/architecture
+
+# Smart Analysis Configuration
+smartAnalysis:
+  enabled: true
+  
+  # Codebase Analysis
+  codebaseAnalysis:
+    enabled: true
+    scanDirectories:
+      - "lib/features/"
+      - "lib/shared/"
+      - "lib/core/"
+    
+    # Similarity Detection
+    similarityThreshold: 0.6  # 60% similarity to suggest reuse
+    keywordMatching: true
+    patternMatching: true
+    
+    # Code Reuse Detection 
+    reuseAnalysis:
+      widgets: "lib/shared/widgets/"
+      services: "lib/shared/services/"
+      utils: "lib/shared/utils/"
+      patterns: "lib/features/*/presentation/"
+  
+  # UI Reference Processing
+  uiReferenceProcessing:
+    enabled: true
+    assetDirectories:
+      - "assets/images/"
+      - "assets/icons/"
+      - "assets/mockups/"
+    supportedFormats: ["png", "jpg", "svg", "pdf"]
+    autoCreateDirectories: true
+  
+  # Architect Consultation
+  architectConsultation:
+    enabled: true
+    triggers:
+      - complexityThreshold: "high"
+      - conflictingPatterns: true
+      - noExistingPatterns: true
+      - crossFeatureDependencies: true
+    
+    analysisDepth: "deep"  # shallow, medium, deep
+    
+  # Integration Analysis
+  integrationAnalysis:
+    enabled: true
+    checkExistingFiles: true
+    validatePaths: true
+    conflictDetection: true
+    dependencyMapping: true
+
+# Auto-Workflow Configuration
+autoWorkflow:
+  enabled: true
+  
+  # Scan Configuration
+  scanDirectories: 
+    - "docs/"
+    - "features/"
+    - "./"
+    - "requirements/"
+  
+  # File Pattern Triggers
+  triggerPatterns:
+    - "*_prd.md"
+    - "*_requirements.md" 
+    - "*_feature.md"
+    - "*_spec.md"
+  
+  # Workflow Automation
+  autoSharding: true
+  autoStoryGeneration: true
+  autoArchitectConsultation: true
+  
+  # Flutter-Specific Settings
+  flutterIntegration:
+    enabled: true
+    autoDetectFlutterProject: true
+    applyFlutterPatterns: true
+    useCleanArchitecture: true
+    defaultStateManagement: "cubit"
+
+# Development Configuration
+customTechnicalDocuments: null
+devLoadAlwaysFiles:
+  - docs/architecture/coding-standards.md
+  - docs/architecture/tech-stack.md
+  - docs/architecture/source-tree.md
+  - bmad-core/data/mandatory-development-rules.md
+  - expansion-packs/appiq-flutter-mobile-dev/data/flutter-development-guidelines.md
+  
+devDebugLog: .ai/debug-log.md
+devStoryLocation: docs/stories
+
+# Enhanced Development Settings
+devEnhancements:
+  codeReuseValidation: true
+  existingComponentScan: true
+  architecturalComplianceCheck: true
+  performancePatternValidation: true
+
+# MANDATORY DEVELOPMENT RULES ENFORCEMENT
+mandatoryRules:
+  enabled: true
+  enforceStandardWorkflow: true
+  enforceQualityGates: true
+  enforcePreCodingChecklist: true
+  
+  # Standard Workflow Enforcement
+  standardWorkflow:
+    requirePlan: true
+    requireVerification: true
+    requireExplanations: true
+    requireSimpleChanges: true
+    requireReview: true
+    requireCommits: true
+  
+  # Quality Gates Enforcement (ALL 5 MUST PASS!)
+  qualityGates:
+    DRY: true              # No code duplication
+    Readable: true         # Self-documenting code
+    Maintainable: true     # Clean Architecture
+    Performant: true       # Optimized implementation
+    Testable: true         # Comprehensive tests
+  
+  # Flutter-Specific Rules
+  flutterRules:
+    noStaticText: true           # All text must use AppLocalizations
+    cleanArchitecture: true     # Presentation → Domain ← Data
+    cubitStateManagement: true  # Use Cubit patterns
+    repositoryPattern: true     # Implement Repository pattern
+    dependencyInjection: true   # Use GetIt
+    
+  # Code Integration Rules
+  codeIntegration:
+    checkExistingFirst: true    # Always check existing code first
+    reuseComponents: true       # Reuse shared components
+    followPatterns: true        # Follow existing patterns
+    extendNotDuplicate: true    # Extend instead of duplicate
+  
+  # Failure Conditions (NEVER ALLOWED!)
+  failureConditions:
+    staticTextInUI: true        # Instant failure
+    codeDuplication: true       # Instant failure
+    patternBreaking: true       # Instant failure
+    missingTests: true          # Instant failure
+    architectureViolation: true # Instant failure
+
+# Reporting Configuration
+reporting:
+  generateAnalysisReports: true
+  reportLocation: "docs/analysis/"
+  includeReuseRecommendations: true
+  includeArchitecturalSuggestions: true
+
+slashPrefix: bmad

package/bmad-core/core-config.yaml

@@ -1,20 +1,184 @@
 markdownExploder: true
+
+# Standard PRD Configuration
 prd:
   prdFile: docs/prd.md
   prdVersion: v4
   prdSharded: true
   prdShardedLocation: docs/prd
   epicFilePattern: epic-{n}*.md
+  
+  # Enhanced PRD Pattern Recognition
+  prdFilePattern: "*_prd.md"
+  requirementsFilePattern: "*_requirements.md"
+  featureFilePattern: "*_feature.md"
+  
+  # Auto-Detection Settings
+  autoPrdDetection: true
+  autoPrdSharding: true
+  autoPrdWorkflow: true
+
 architecture:
   architectureFile: docs/architecture.md
   architectureVersion: v4
   architectureSharded: true
   architectureShardedLocation: docs/architecture
+
+# Smart Analysis Configuration
+smartAnalysis:
+  enabled: true
+  
+  # Codebase Analysis
+  codebaseAnalysis:
+    enabled: true
+    scanDirectories:
+      - "lib/features/"
+      - "lib/shared/"
+      - "lib/core/"
+    
+    # Similarity Detection
+    similarityThreshold: 0.6  # 60% similarity to suggest reuse
+    keywordMatching: true
+    patternMatching: true
+    
+    # Code Reuse Detection 
+    reuseAnalysis:
+      widgets: "lib/shared/widgets/"
+      services: "lib/shared/services/"
+      utils: "lib/shared/utils/"
+      patterns: "lib/features/*/presentation/"
+  
+  # UI Reference Processing
+  uiReferenceProcessing:
+    enabled: true
+    assetDirectories:
+      - "assets/images/"
+      - "assets/icons/"
+      - "assets/mockups/"
+    supportedFormats: ["png", "jpg", "svg", "pdf"]
+    autoCreateDirectories: true
+  
+  # Architect Consultation
+  architectConsultation:
+    enabled: true
+    triggers:
+      - complexityThreshold: "high"
+      - conflictingPatterns: true
+      - noExistingPatterns: true
+      - crossFeatureDependencies: true
+    
+    analysisDepth: "deep"  # shallow, medium, deep
+    
+  # Integration Analysis
+  integrationAnalysis:
+    enabled: true
+    checkExistingFiles: true
+    validatePaths: true
+    conflictDetection: true
+    dependencyMapping: true
+
+# Auto-Workflow Configuration
+autoWorkflow:
+  enabled: true
+  
+  # Scan Configuration
+  scanDirectories: 
+    - "docs/"
+    - "features/"
+    - "./"
+    - "requirements/"
+  
+  # File Pattern Triggers
+  triggerPatterns:
+    - "*_prd.md"
+    - "*_requirements.md" 
+    - "*_feature.md"
+    - "*_spec.md"
+  
+  # Workflow Automation
+  autoSharding: true
+  autoStoryGeneration: true
+  autoArchitectConsultation: true
+  
+  # Flutter-Specific Settings
+  flutterIntegration:
+    enabled: true
+    autoDetectFlutterProject: true
+    applyFlutterPatterns: true
+    useCleanArchitecture: true
+    defaultStateManagement: "cubit"
+
+# Development Configuration
 customTechnicalDocuments: null
 devLoadAlwaysFiles:
   - docs/architecture/coding-standards.md
   - docs/architecture/tech-stack.md
   - docs/architecture/source-tree.md
+  - bmad-core/data/mandatory-development-rules.md
+  - expansion-packs/appiq-flutter-mobile-dev/data/flutter-development-guidelines.md
+  
 devDebugLog: .ai/debug-log.md
 devStoryLocation: docs/stories
-slashPrefix: BMad
+
+# Enhanced Development Settings
+devEnhancements:
+  codeReuseValidation: true
+  existingComponentScan: true
+  architecturalComplianceCheck: true
+  performancePatternValidation: true
+
+# MANDATORY DEVELOPMENT RULES ENFORCEMENT
+mandatoryRules:
+  enabled: true
+  enforceStandardWorkflow: true
+  enforceQualityGates: true
+  enforcePreCodingChecklist: true
+  
+  # Standard Workflow Enforcement
+  standardWorkflow:
+    requirePlan: true
+    requireVerification: true
+    requireExplanations: true
+    requireSimpleChanges: true
+    requireReview: true
+    requireCommits: true
+  
+  # Quality Gates Enforcement (ALL 5 MUST PASS!)
+  qualityGates:
+    DRY: true              # No code duplication
+    Readable: true         # Self-documenting code
+    Maintainable: true     # Clean Architecture
+    Performant: true       # Optimized implementation
+    Testable: true         # Comprehensive tests
+  
+  # Flutter-Specific Rules
+  flutterRules:
+    noStaticText: true           # All text must use AppLocalizations
+    cleanArchitecture: true     # Presentation → Domain ← Data
+    cubitStateManagement: true  # Use Cubit patterns
+    repositoryPattern: true     # Implement Repository pattern
+    dependencyInjection: true   # Use GetIt
+    
+  # Code Integration Rules
+  codeIntegration:
+    checkExistingFirst: true    # Always check existing code first
+    reuseComponents: true       # Reuse shared components
+    followPatterns: true        # Follow existing patterns
+    extendNotDuplicate: true    # Extend instead of duplicate
+  
+  # Failure Conditions (NEVER ALLOWED!)
+  failureConditions:
+    staticTextInUI: true        # Instant failure
+    codeDuplication: true       # Instant failure
+    patternBreaking: true       # Instant failure
+    missingTests: true          # Instant failure
+    architectureViolation: true # Instant failure
+
+# Reporting Configuration
+reporting:
+  generateAnalysisReports: true
+  reportLocation: "docs/analysis/"
+  includeReuseRecommendations: true
+  includeArchitecturalSuggestions: true
+
+slashPrefix: bmad