appiq-solution 1.6.4 → 1.6.5

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/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/data/mandatory-development-rules.md

@@ -0,0 +1,170 @@
+# MANDATORY DEVELOPMENT RULES
+## THESE RULES MUST ALWAYS BE FOLLOWED - NO EXCEPTIONS!
+
+This file provides mandatory guidance that MUST be followed by ALL agents when working with code in ANY repository.
+
+## 🚨 CRITICAL: Standard Workflow (ALWAYS FOLLOW!)
+
+### MANDATORY 8-Step Process:
+1. **THINK**: First think through the problem, read the codebase for relevant files
+2. **PLAN**: Write a detailed plan to `tasks/todo.md` with checkable items
+3. **VERIFY**: Check in with user - get plan approval before starting
+4. **WORK**: Work on todo items, marking them complete as you go
+5. **EXPLAIN**: Give high-level explanation of changes at every step
+6. **SIMPLE**: Make every change as simple as possible - impact minimal code
+7. **REVIEW**: Add review section to `todo.md` with summary of changes
+8. **COMMIT**: After every fully finished task - make git commit with proper message
+
+### MANDATORY Workflow Rules:
+- ✅ **NEVER start coding without a verified plan**
+- ✅ **ALWAYS check existing code before creating new code**
+- ✅ **ALWAYS extend existing code instead of duplicating**
+- ✅ **ALWAYS use existing patterns and folder structure**
+- ✅ **ALWAYS check if functionality already exists**
+- ✅ **ALWAYS make git commits after completed tasks**
+
+## 🎯 MANDATORY Quality Criteria (ALL 5 MUST PASS!)
+
+### 1. 🧹 DRY (Don't Repeat Yourself)
+- ✅ **NO code duplication allowed**
+- ✅ **ALWAYS reuse existing functions/classes/components**
+- ✅ **ALWAYS extract common functionality into shared utilities**
+- ✅ **ALWAYS check if similar code exists before writing new code**
+
+### 2. 📖 Readable
+- ✅ **Code MUST be self-documenting with clear naming**
+- ✅ **Methods MUST be small and focused (max 20 lines)**
+- ✅ **Classes MUST have single responsibility**
+- ✅ **Comments MUST explain WHY, not WHAT**
+
+### 3. 🔧 Maintainable
+- ✅ **MUST follow Clean Architecture with proper layer separation**
+- ✅ **MUST use dependency injection**
+- ✅ **MUST have modular design**
+- ✅ **MUST follow existing folder/file structure**
+
+### 4. ⚡ Performant
+- ✅ **MUST avoid redundant API calls**
+- ✅ **MUST use efficient algorithms**
+- ✅ **MUST optimize resource usage**
+- ✅ **MUST follow existing performance patterns**
+
+### 5. 🧪 Testable
+- ✅ **ALL business logic MUST be unit tested**
+- ✅ **ALL UI components MUST be widget tested**
+- ✅ **MUST use dependency injection for testability**
+- ✅ **MUST follow existing testing patterns**
+
+## 📱 MANDATORY Flutter-Specific Rules
+
+### Architecture Compliance (ALWAYS!)
+- ✅ **MUST follow Clean Architecture (Presentation → Domain ← Data)**
+- ✅ **MUST use Cubit for state management**
+- ✅ **MUST implement Repository pattern**
+- ✅ **MUST use GetIt for dependency injection**
+
+### Localization (ALWAYS!)
+- ✅ **NO static text allowed - EVER!**
+- ✅ **ALL user-facing text MUST use AppLocalizations**
+- ✅ **ALL localization keys MUST be descriptive**
+- ✅ **MUST add keys to ALL supported ARB files**
+
+### Code Structure (ALWAYS!)
+- ✅ **MUST follow existing folder structure**
+- ✅ **MUST use snake_case for files**
+- ✅ **MUST use PascalCase for classes**
+- ✅ **MUST use camelCase for methods/variables**
+
+### Integration Rules (ALWAYS!)
+- ✅ **BEFORE creating new files**: Check if similar exists
+- ✅ **BEFORE new widgets**: Review `lib/shared/widgets/`
+- ✅ **BEFORE new services**: Check `lib/shared/services/`
+- ✅ **BEFORE new utilities**: Review `lib/shared/utils/`
+
+## 🛠️ MANDATORY MCP Tool Usage
+
+### When to Use MCPs (ALWAYS check these!):
+- ✅ **sequential-thinking**: For complex problem analysis
+- ✅ **context7**: For up-to-date library documentation
+- ✅ **memory**: For storing important decisions/patterns
+- ✅ **puppeteer**: For web scraping/testing needs
+- ✅ **fetcher**: For external API data retrieval
+
+## 🔍 MANDATORY Pre-Development Checklist
+
+### Before ANY coding (ALWAYS!):
+- [ ] **Read existing codebase** for similar functionality
+- [ ] **Check shared components** for reusable parts
+- [ ] **Review existing patterns** in similar features
+- [ ] **Verify architecture compliance** with existing structure
+- [ ] **Plan minimal impact changes** - avoid massive refactors
+- [ ] **Ensure localization keys** are planned
+- [ ] **Identify testing requirements** early
+
+### During Development (ALWAYS!):
+- [ ] **Follow existing naming conventions** exactly
+- [ ] **Use existing error handling patterns**
+- [ ] **Reuse existing validation logic**
+- [ ] **Follow existing state management patterns**
+- [ ] **Use existing navigation patterns**
+- [ ] **Follow existing styling/theming**
+
+### After Development (ALWAYS!):
+- [ ] **Run all tests** and ensure they pass
+- [ ] **Check code coverage** meets minimum requirements
+- [ ] **Verify localization** works for all languages
+- [ ] **Test on different screen sizes**
+- [ ] **Review code** against all 5 quality criteria
+- [ ] **Make proper git commit** with descriptive message
+
+## 🚨 CRITICAL VALIDATION RULES
+
+### Code Review Criteria (ALL MUST PASS!):
+1. ✅ **Architecture**: Follows Clean Architecture with proper layer separation
+2. ✅ **Localization**: All text supports multi-language
+3. ✅ **Quality**: Passes all 5 quality criteria (DRY, Readable, Maintainable, Performant, Testable)
+4. ✅ **Documentation**: Code is properly documented with examples
+5. ✅ **Consistency**: Code style matches existing patterns
+
+### Failure Conditions (NEVER ALLOWED!):
+- ❌ **Static text in UI** - Immediate failure
+- ❌ **Code duplication** - Immediate failure
+- ❌ **Breaking existing patterns** - Immediate failure
+- ❌ **Missing tests** - Immediate failure
+- ❌ **Poor performance** - Immediate failure
+
+## 📋 MANDATORY Commit Message Format
+
+```
+type(scope): brief description
+
+- Detailed explanation of changes
+- Why the changes were made
+- What patterns were followed
+- What tests were added
+
+Quality Checklist:
+✅ DRY: No code duplication
+✅ Readable: Clear naming and structure
+✅ Maintainable: Modular design
+✅ Performant: Optimized implementation
+✅ Testable: Comprehensive test coverage
+```
+
+## 🎯 REMEMBER: Consistency is King!
+
+> **When in doubt, ALWAYS follow existing patterns in the codebase.**
+> **NEVER create new patterns without explicit approval.**
+> **ALWAYS prefer extending existing code over creating new code.**
+
+---
+
+## ⚠️ ENFORCEMENT NOTICE
+
+**These rules are MANDATORY and MUST be followed by:**
+- ✅ All BMAD agents (dev, flutter-ui-agent, flutter-cubit-agent, etc.)
+- ✅ All development workflows
+- ✅ All IDE integrations (Cursor, Claude Code, etc.)
+- ✅ All automated processes
+
+**NO EXCEPTIONS! NO SHORTCUTS! NO COMPROMISES!**

package/bmad-core/tasks/auto-detect-prds.md

@@ -0,0 +1,162 @@
+# Auto-Detect PRDs Task
+
+## Purpose
+Automatically detect PRD files based on pattern matching and trigger the complete BMAD workflow without manual Planning Phase.
+
+## Usage
+```bash
+@po auto-detect-prds
+```
+
+## Process
+
+### Step 1: Scan for PRD Files
+1. **Scan configured directories** from core-config.yaml `autoWorkflow.scanDirectories`
+2. **Look for files matching patterns**:
+   - `*_prd.md` (e.g., `livestream_prd.md`, `payment_prd.md`)
+   - `*_requirements.md`
+   - `*_feature.md`
+3. **List found files** and ask user for confirmation
+
+### Step 2: Process Each PRD File
+For each detected PRD file:
+
+1. **Validate PRD Structure**:
+   - Check for required sections (Features, Acceptance Criteria, etc.)
+   - Ensure proper markdown formatting
+   - Validate completeness
+
+2. **Auto-Shard Document**:
+   ```bash
+   md-tree explode {prd_file} docs/prd/{feature_name}
+   ```
+
+3. **Create Feature Directory Structure**:
+   ```
+   docs/
+   ├── prd/
+   │   └── {feature_name}/
+   │       ├── overview.md
+   │       ├── features.md
+   │       ├── acceptance-criteria.md
+   │       └── technical-requirements.md
+   └── stories/
+       └── {feature_name}/
+   ```
+
+### Step 3: Auto-Generate Stories
+1. **Extract Epics** from sharded PRD sections
+2. **Generate User Stories** from each epic
+3. **Create Story Files** in `docs/stories/{feature_name}/`
+4. **Apply Flutter-specific patterns** if Flutter extension detected
+
+### Step 4: Trigger Development Workflow
+1. **Notify SM** that stories are ready
+2. **Auto-start Flutter UI-First Workflow** if configured
+3. **Create initial todo.md** for development tracking
+
+## Example Workflow
+
+### Input Files:
+```
+docs/
+├── livestream_prd.md
+├── payment_prd.md
+└── user_profile_prd.md
+```
+
+### Command:
+```bash
+@po auto-detect-prds
+```
+
+### Output:
+```
+Found 3 PRD files:
+1. livestream_prd.md → Livestream Feature
+2. payment_prd.md → Payment Integration  
+3. user_profile_prd.md → User Profile Management
+
+Processing livestream_prd.md...
+✅ Sharded to docs/prd/livestream/
+✅ Generated 4 stories in docs/stories/livestream/
+✅ Ready for development
+
+Processing payment_prd.md...
+✅ Sharded to docs/prd/payment/
+✅ Generated 6 stories in docs/stories/payment/
+✅ Ready for development
+
+Processing user_profile_prd.md...
+✅ Sharded to docs/prd/user_profile/
+✅ Generated 3 stories in docs/stories/user_profile/
+✅ Ready for development
+
+🚀 All PRDs processed! Ready to start development with:
+@sm start-next-story
+```
+
+## PRD File Requirements
+
+Your `*_prd.md` files should contain:
+
+```markdown
+# Feature Name PRD
+
+## Overview
+Brief description of the feature
+
+## Features
+- Feature 1: Description
+- Feature 2: Description
+- Feature 3: Description
+
+## Acceptance Criteria
+### Feature 1
+- [ ] Criteria 1
+- [ ] Criteria 2
+
+### Feature 2
+- [ ] Criteria 1
+- [ ] Criteria 2
+
+## Technical Requirements
+- Flutter Clean Architecture
+- Cubit State Management
+- Repository Pattern
+- Unit Tests Required
+
+## User Stories
+### Epic: Feature Implementation
+- As a user I want to... so that...
+- As a user I want to... so that...
+
+## Dependencies
+- Backend API endpoints
+- Third-party integrations
+- Design assets
+```
+
+## Configuration
+
+Enable in `core-config.yaml`:
+```yaml
+autoWorkflow:
+  enabled: true
+  scanDirectories: 
+    - "docs/"
+    - "features/"
+  triggerPatterns:
+    - "*_prd.md"
+    - "*_requirements.md"
+```
+
+## Flutter-Specific Integration
+
+When Flutter extension is detected, automatically:
+1. **Apply Flutter story templates**
+2. **Set up UI-First workflow**  
+3. **Configure Clean Architecture patterns**
+4. **Prepare Cubit state management structure**
+
+This task bridges the gap between existing documentation and BMAD's development workflow, perfect for Brownfield projects!