@appiq/flutter-workflow 1.3.0 → 1.4.1

package/templates/task-breakdown-template.md

@@ -0,0 +1,265 @@
+---
+feature_name: ${FEATURE_NAME}
+status: planning
+created_date: ${DATE}
+feature_file: docs/features/${FEATURE_NAME}.md
+agents_assigned: 8
+estimated_duration: ${ESTIMATE}
+priority: ${PRIORITY}
+---
+
+# ${FEATURE_NAME} - Task Breakdown & Implementation Plan
+
+## 📋 Overview
+**Feature**: ${FEATURE_NAME}
+**Status**: ${STATUS}
+**Created**: ${DATE}
+**FeatureMaster Analysis**: Completed
+**Implementation Phase**: Ready to Start
+
+## 🎯 Implementation Summary
+${IMPLEMENTATION_SUMMARY}
+
+## 📊 Agent Task Assignments
+
+### 📋 PO Agent (Phoenix) - Requirements & Planning
+**Status**: ⏳ Pending
+**Estimated Duration**: ${PO_DURATION}
+**Priority**: High
+
+#### Tasks:
+- [ ] **REQ-001**: Analyze feature requirements from docs/features/${FEATURE_NAME}.md
+- [ ] **REQ-002**: Create detailed user stories with acceptance criteria
+- [ ] **REQ-003**: Define functional and non-functional requirements
+- [ ] **REQ-004**: Create stakeholder communication plan
+- [ ] **REQ-005**: Validate technical feasibility and constraints
+
+**Acceptance Criteria**:
+- [ ] All requirements clearly documented
+- [ ] User stories with acceptance criteria defined
+- [ ] Technical constraints identified
+- [ ] Stakeholder approval obtained
+
+**Deliverables**:
+- Updated feature documentation
+- Detailed task specifications
+- Risk assessment report
+
+---
+
+### 🎨 UI Agent (Aria) - Presentation Layer
+**Status**: ⏳ Pending
+**Estimated Duration**: ${UI_DURATION}
+**Priority**: High
+
+#### Tasks:
+- [ ] **UI-001**: Design responsive screen layouts
+- [ ] **UI-002**: Create reusable widget components
+- [ ] **UI-003**: Implement accessibility features
+- [ ] **UI-004**: Add localization support
+- [ ] **UI-005**: Design user interaction flows
+
+**Acceptance Criteria**:
+- [ ] Responsive design for all screen sizes
+- [ ] Accessibility compliance (WCAG 2.1)
+- [ ] Consistent design system implementation
+- [ ] Smooth user interactions
+
+**Deliverables**:
+- Screen implementations
+- Reusable widget library
+- Accessibility documentation
+
+---
+
+### 🔄 Cubit Agent (Sage) - State Management
+**Status**: ⏳ Pending
+**Estimated Duration**: ${CUBIT_DURATION}
+**Priority**: High
+
+#### Tasks:
+- [ ] **STATE-001**: Design state structure and management
+- [ ] **STATE-002**: Implement business logic flows
+- [ ] **STATE-003**: Create error handling mechanisms
+- [ ] **STATE-004**: Optimize performance and memory usage
+- [ ] **STATE-005**: Implement state persistence
+
+**Acceptance Criteria**:
+- [ ] Clean state management architecture
+- [ ] Comprehensive error handling
+- [ ] Performance optimized
+- [ ] State persistence working
+
+**Deliverables**:
+- Cubit implementations
+- State management documentation
+- Performance benchmarks
+
+---
+
+### 🏗️ Domain Agent (Atlas) - Business Logic
+**Status**: ⏳ Pending
+**Estimated Duration**: ${DOMAIN_DURATION}
+**Priority**: High
+
+#### Tasks:
+- [ ] **DOMAIN-001**: Define business entities and models
+- [ ] **DOMAIN-002**: Implement use cases and business rules
+- [ ] **DOMAIN-003**: Create repository interfaces
+- [ ] **DOMAIN-004**: Design domain events and workflows
+- [ ] **DOMAIN-005**: Validate business logic compliance
+
+**Acceptance Criteria**:
+- [ ] Clean Architecture compliance
+- [ ] Business rules properly implemented
+- [ ] Domain isolation maintained
+- [ ] Use cases fully tested
+
+**Deliverables**:
+- Domain entities
+- Use case implementations
+- Repository interfaces
+- Business logic documentation
+
+---
+
+### 📊 Data Agent (Nova) - Data Layer
+**Status**: ⏳ Pending
+**Estimated Duration**: ${DATA_DURATION}
+**Priority**: High
+
+#### Tasks:
+- [ ] **DATA-001**: Implement repository pattern
+- [ ] **DATA-002**: Create API integration layer
+- [ ] **DATA-003**: Set up local storage and caching
+- [ ] **DATA-004**: Implement data validation and security
+- [ ] **DATA-005**: Add offline functionality support
+
+**Acceptance Criteria**:
+- [ ] Repository pattern properly implemented
+- [ ] API integration working
+- [ ] Local storage functional
+- [ ] Data security measures in place
+
+**Deliverables**:
+- Repository implementations
+- API integration code
+- Local storage setup
+- Data security documentation
+
+---
+
+### 🔒 Security Agent (Guardian) - Security & Compliance
+**Status**: ⏳ Pending
+**Estimated Duration**: ${SECURITY_DURATION}
+**Priority**: Critical
+
+#### Tasks:
+- [ ] **SEC-001**: Implement authentication and authorization
+- [ ] **SEC-002**: Ensure COPPA compliance measures
+- [ ] **SEC-003**: Add data encryption and protection
+- [ ] **SEC-004**: Create security audit logging
+- [ ] **SEC-005**: Validate API security protocols
+
+**Acceptance Criteria**:
+- [ ] Authentication system secure
+- [ ] COPPA compliance verified
+- [ ] Data encryption implemented
+- [ ] Security audit trail active
+
+**Deliverables**:
+- Security implementation
+- COPPA compliance documentation
+- Security audit reports
+- Vulnerability assessment
+
+---
+
+### 🧪 Test Agent (Trinity) - Quality Assurance
+**Status**: ⏳ Pending
+**Estimated Duration**: ${TEST_DURATION}
+**Priority**: High
+
+#### Tasks:
+- [ ] **TEST-001**: Create unit test suite
+- [ ] **TEST-002**: Implement widget testing
+- [ ] **TEST-003**: Set up integration testing
+- [ ] **TEST-004**: Performance testing and benchmarks
+- [ ] **TEST-005**: Security testing and validation
+
+**Acceptance Criteria**:
+- [ ] 90%+ test coverage achieved
+- [ ] All tests passing
+- [ ] Performance benchmarks met
+- [ ] Security tests validated
+
+**Deliverables**:
+- Complete test suite
+- Test coverage reports
+- Performance benchmarks
+- Quality assurance documentation
+
+---
+
+### ✅ Integration Validator - Final Integration
+**Status**: ⏳ Pending
+**Estimated Duration**: ${INTEGRATION_DURATION}
+**Priority**: Critical
+
+#### Tasks:
+- [ ] **INT-001**: Validate complete system integration
+- [ ] **INT-002**: Configure dependency injection
+- [ ] **INT-003**: Set up provider hierarchy
+- [ ] **INT-004**: Perform final system validation
+- [ ] **INT-005**: Prepare deployment documentation
+
+**Acceptance Criteria**:
+- [ ] All components properly integrated
+- [ ] No integration errors
+- [ ] System performance validated
+- [ ] Deployment ready
+
+**Deliverables**:
+- Integration validation report
+- Deployment documentation
+- System performance metrics
+- Final quality assurance
+
+---
+
+## 📈 Progress Tracking
+
+### Overall Progress: 0% Complete
+```
+🟪🟪🟪🟪🟪🟪🟪🟪🟪🟪 0/10 phases complete
+```
+
+### Agent Progress:
+- 📋 **PO Agent**: ⏳ Not Started (0/5 tasks)
+- 🎨 **UI Agent**: ⏳ Not Started (0/5 tasks)  
+- 🔄 **Cubit Agent**: ⏳ Not Started (0/5 tasks)
+- 🏗️ **Domain Agent**: ⏳ Not Started (0/5 tasks)
+- 📊 **Data Agent**: ⏳ Not Started (0/5 tasks)
+- 🔒 **Security Agent**: ⏳ Not Started (0/5 tasks)
+- 🧪 **Test Agent**: ⏳ Not Started (0/5 tasks)
+- ✅ **Integration Validator**: ⏳ Not Started (0/5 tasks)
+
+## 🎯 Next Steps
+1. **Activate PO Agent** to begin requirements analysis
+2. **Update task status** as agents complete work
+3. **Monitor progress** through this document
+4. **Coordinate handoffs** between agents
+5. **Track quality gates** and blockers
+
+## 📝 Implementation History
+### ${DATE} - Task Breakdown Created
+- FeatureMaster completed initial analysis
+- Task breakdown created with 8 agent assignments
+- Implementation plan ready for execution
+- Waiting for user approval to begin
+
+---
+
+**Last Updated**: ${DATE} by FeatureMaster
+**Next Review**: After each agent completion
+**Quality Gate**: All tasks must be completed and validated before deployment

package/templates/task-history-template.md

@@ -0,0 +1,276 @@
+# ${FEATURE_NAME} - Implementation History & Activity Log
+
+## 📊 Feature Summary
+**Feature Name**: ${FEATURE_NAME}
+**Start Date**: ${START_DATE}
+**Current Status**: ${CURRENT_STATUS}
+**Completion**: ${COMPLETION_PERCENTAGE}%
+**Total Agents**: 8
+**Active Agent**: ${CURRENT_AGENT}
+
+---
+
+## 🎯 FeatureMaster Activity Log
+
+### ${DATE} - Initial Analysis Complete
+**Agent**: FeatureMaster 🎯
+**Duration**: ${ANALYSIS_DURATION}
+**Status**: ✅ Complete
+
+**Activities Performed**:
+- Analyzed feature requirements from docs/features/${FEATURE_NAME}.md
+- Created comprehensive implementation plan
+- Identified COPPA compliance requirements
+- Designed agent coordination workflow
+- Generated task breakdown document
+
+**Key Findings**:
+${KEY_FINDINGS}
+
+**Decisions Made**:
+${DECISIONS_MADE}
+
+**Files Created/Modified**:
+- `docs/tasks/${FEATURE_NAME}_tasks.md` - Created task breakdown
+- `docs/tasks/${FEATURE_NAME}_history.md` - Created this history log
+- `docs/features/${FEATURE_NAME}.md` - Updated status to 'planning'
+
+---
+
+## 📋 Agent Activity Timeline
+
+### PO Agent (Phoenix) 📋
+**Status**: ${PO_STATUS}
+**Start**: ${PO_START_DATE}
+**Duration**: ${PO_DURATION}
+
+#### Activities:
+${PO_ACTIVITIES}
+
+#### Completed Tasks:
+${PO_COMPLETED_TASKS}
+
+#### Deliverables:
+${PO_DELIVERABLES}
+
+#### Issues/Blockers:
+${PO_ISSUES}
+
+---
+
+### UI Agent (Aria) 🎨
+**Status**: ${UI_STATUS}
+**Start**: ${UI_START_DATE}
+**Duration**: ${UI_DURATION}
+
+#### Activities:
+${UI_ACTIVITIES}
+
+#### Completed Tasks:
+${UI_COMPLETED_TASKS}
+
+#### Deliverables:
+${UI_DELIVERABLES}
+
+#### Issues/Blockers:
+${UI_ISSUES}
+
+---
+
+### Cubit Agent (Sage) 🔄
+**Status**: ${CUBIT_STATUS}
+**Start**: ${CUBIT_START_DATE}
+**Duration**: ${CUBIT_DURATION}
+
+#### Activities:
+${CUBIT_ACTIVITIES}
+
+#### Completed Tasks:
+${CUBIT_COMPLETED_TASKS}
+
+#### Deliverables:
+${CUBIT_DELIVERABLES}
+
+#### Issues/Blockers:
+${CUBIT_ISSUES}
+
+---
+
+### Domain Agent (Atlas) 🏗️
+**Status**: ${DOMAIN_STATUS}
+**Start**: ${DOMAIN_START_DATE}
+**Duration**: ${DOMAIN_DURATION}
+
+#### Activities:
+${DOMAIN_ACTIVITIES}
+
+#### Completed Tasks:
+${DOMAIN_COMPLETED_TASKS}
+
+#### Deliverables:
+${DOMAIN_DELIVERABLES}
+
+#### Issues/Blockers:
+${DOMAIN_ISSUES}
+
+---
+
+### Data Agent (Nova) 📊
+**Status**: ${DATA_STATUS}
+**Start**: ${DATA_START_DATE}
+**Duration**: ${DATA_DURATION}
+
+#### Activities:
+${DATA_ACTIVITIES}
+
+#### Completed Tasks:
+${DATA_COMPLETED_TASKS}
+
+#### Deliverables:
+${DATA_DELIVERABLES}
+
+#### Issues/Blockers:
+${DATA_ISSUES}
+
+---
+
+### Security Agent (Guardian) 🔒
+**Status**: ${SECURITY_STATUS}
+**Start**: ${SECURITY_START_DATE}
+**Duration**: ${SECURITY_DURATION}
+
+#### Activities:
+${SECURITY_ACTIVITIES}
+
+#### Completed Tasks:
+${SECURITY_COMPLETED_TASKS}
+
+#### Deliverables:
+${SECURITY_DELIVERABLES}
+
+#### Issues/Blockers:
+${SECURITY_ISSUES}
+
+---
+
+### Test Agent (Trinity) 🧪
+**Status**: ${TEST_STATUS}
+**Start**: ${TEST_START_DATE}
+**Duration**: ${TEST_DURATION}
+
+#### Activities:
+${TEST_ACTIVITIES}
+
+#### Completed Tasks:
+${TEST_COMPLETED_TASKS}
+
+#### Deliverables:
+${TEST_DELIVERABLES}
+
+#### Issues/Blockers:
+${TEST_ISSUES}
+
+---
+
+### Integration Validator ✅
+**Status**: ${INTEGRATION_STATUS}
+**Start**: ${INTEGRATION_START_DATE}
+**Duration**: ${INTEGRATION_DURATION}
+
+#### Activities:
+${INTEGRATION_ACTIVITIES}
+
+#### Completed Tasks:
+${INTEGRATION_COMPLETED_TASKS}
+
+#### Deliverables:
+${INTEGRATION_DELIVERABLES}
+
+#### Issues/Blockers:
+${INTEGRATION_ISSUES}
+
+---
+
+## 📈 Progress Milestones
+
+### Completed Milestones:
+- ✅ **${DATE}**: FeatureMaster analysis complete
+- ✅ **${DATE}**: Task breakdown created
+- ✅ **${DATE}**: Agent coordination plan established
+
+### Upcoming Milestones:
+- ⏳ **${PO_MILESTONE_DATE}**: PO requirements complete
+- ⏳ **${UI_MILESTONE_DATE}**: UI implementation complete
+- ⏳ **${CUBIT_MILESTONE_DATE}**: State management complete
+- ⏳ **${DOMAIN_MILESTONE_DATE}**: Business logic complete
+- ⏳ **${DATA_MILESTONE_DATE}**: Data layer complete
+- ⏳ **${SECURITY_MILESTONE_DATE}**: Security implementation complete
+- ⏳ **${TEST_MILESTONE_DATE}**: Testing complete
+- ⏳ **${INTEGRATION_MILESTONE_DATE}**: Integration validation complete
+
+---
+
+## 🚨 Issues & Resolution Log
+
+### Open Issues:
+${OPEN_ISSUES}
+
+### Resolved Issues:
+${RESOLVED_ISSUES}
+
+---
+
+## 📊 Quality Gates Status
+
+### Requirements Phase:
+- [ ] Requirements analysis complete
+- [ ] Stakeholder approval obtained
+- [ ] Technical feasibility confirmed
+- [ ] Risk assessment completed
+
+### Development Phase:
+- [ ] UI implementation reviewed
+- [ ] State management validated
+- [ ] Business logic tested
+- [ ] Data layer verified
+- [ ] Security measures implemented
+
+### Testing Phase:
+- [ ] Unit tests passing (90%+ coverage)
+- [ ] Integration tests successful
+- [ ] Performance benchmarks met
+- [ ] Security testing complete
+
+### Integration Phase:
+- [ ] System integration validated
+- [ ] Deployment readiness confirmed
+- [ ] Documentation complete
+- [ ] Final quality approval
+
+---
+
+## 📝 Lessons Learned
+
+### What Went Well:
+${LESSONS_POSITIVE}
+
+### Areas for Improvement:
+${LESSONS_IMPROVEMENT}
+
+### Process Optimizations:
+${PROCESS_OPTIMIZATIONS}
+
+---
+
+## 📋 Final Summary
+**Feature Status**: ${FINAL_STATUS}
+**Total Duration**: ${TOTAL_DURATION}
+**Quality Score**: ${QUALITY_SCORE}/100
+**Team Satisfaction**: ${TEAM_SATISFACTION}/10
+**Deployment Status**: ${DEPLOYMENT_STATUS}
+
+---
+
+**Last Updated**: ${LAST_UPDATE_DATE}
+**Updated By**: ${LAST_UPDATE_AGENT}
+**Next Review**: ${NEXT_REVIEW_DATE}

package/agents/claude/initial-flow-agent.md

@@ -1,55 +0,0 @@
----
-name: appiq-initial-flow-agent
-description: Use this agent for Flutter project initialization, provider setup, dependency injection configuration, and integration after feature implementation. Prevents cubit initialization errors and ensures proper provider setup. Examples: <example>Context: Feature implementation complete, need integration setup. user: "All feature components are implemented, need proper initialization" assistant: "I'm going to use the Task tool to launch the appiq-initial-flow-agent to configure dependency injection and provider setup" <commentary>Since the user needs post-implementation integration, use the initial flow agent to set up proper initialization and prevent common errors.</commentary></example> <example>Context: Cubit initialization errors or provider issues. user: "Getting BlocProvider context errors and cubit not initialized" assistant: "Let me use the appiq-initial-flow-agent to resolve provider setup and dependency injection issues" <commentary>The user has common initialization problems, so use the initial flow agent to fix provider hierarchy and DI setup.</commentary></example>
-model: sonnet
----
-
-You are InitFlow, the AppIQ Flutter Initialization & Provider Setup Specialist. You ensure seamless integration of all feature components, eliminating common initialization errors and provider setup issues that can break application flow.
-
-## Your Mission
-Configure complete dependency injection, provider hierarchy, and feature integration after implementation, preventing cubit initialization errors and ensuring proper component integration throughout the application.
-
-## Core Responsibilities
-1. **Dependency Injection Setup**: Complete GetIt configuration for all architectural layers
-2. **Provider Hierarchy Management**: BLoC provider setup with proper context access
-3. **Integration Validation**: Comprehensive testing of all component integrations
-4. **Error Prevention**: Eliminate common initialization and provider context errors
-5. **Performance Optimization**: Efficient provider setup and resource management
-6. **Testing Infrastructure**: Mock setup and integration test configuration
-
-## Common Issues You Resolve
-- **BlocProvider Context Errors**: "BlocProvider.of() called with a context that does not contain a Cubit"
-- **Duplicate Registrations**: Dependency injection conflicts and duplicate providers
-- **Provider Hierarchy**: Incorrect provider setup and context access issues
-- **Cubit Initialization**: Cubit not initialized or dependency injection failures
-- **Memory Leaks**: Unclosed streams and improper resource disposal
-- **Integration Errors**: Component integration and architectural layer communication
-
-## Dependency Injection Patterns
-- **Repository Registration**: Proper repository and data source injection
-- **Use Case Registration**: Domain layer use case configuration
-- **Cubit Registration**: State management component setup
-- **Service Registration**: External service and utility integration
-- **Mock Setup**: Testing infrastructure with proper mock configuration
-
-## Provider Configuration
-- **MultiBlocProvider Setup**: Proper provider hierarchy in main.dart
-- **Feature Providers**: Feature-specific provider registration and setup
-- **Global Providers**: App-level state management and shared services
-- **Context Access**: Proper provider context access and widget integration
-- **Provider Disposal**: Resource cleanup and memory management
-
-## Integration Architecture
-- **Layer Integration**: Presentation, Domain, Data, and Infrastructure layer coordination
-- **Service Integration**: External APIs, local storage, authentication, and analytics
-- **Route Configuration**: Navigation setup with proper provider access
-- **Error Handling**: Comprehensive error handling and logging infrastructure
-- **Performance Optimization**: Startup time and resource usage optimization
-
-## Quality Validation
-- **Integration Testing**: Complete feature integration and provider setup validation
-- **Error Resolution**: Identification and resolution of initialization issues
-- **Performance Testing**: Provider setup performance and resource usage validation
-- **Documentation**: Comprehensive integration documentation and setup guides
-
-After completing initialization and integration, coordinate with the Orchestrator for final workflow validation and deployment readiness confirmation.

package/agents/claude/orchestrator.md

@@ -1,41 +0,0 @@
----
-name: appiq-orchestrator
-description: Use this agent to coordinate AppIQ Flutter feature development workflow. Manages 8 specialized agents (PO, UI, Cubit, Domain, Data, Security, Test) following Clean Architecture principles. Examples: <example>Context: Starting new Flutter feature development. user: "I want to create a user profile feature" assistant: "I'm going to use the Task tool to launch the appiq-orchestrator agent to coordinate the complete feature development workflow" <commentary>Since the user wants to develop a Flutter feature, use the appiq-orchestrator to manage the complete workflow through all 8 agents.</commentary></example> <example>Context: Managing ongoing feature development. user: "What's the status of my authentication feature?" assistant: "Let me use the appiq-orchestrator agent to check the current workflow status and coordinate next steps" <commentary>The user needs workflow status updates, so use the orchestrator to manage and report on feature development progress.</commentary></example>
-model: sonnet
----
-
-You are Conductor, the AppIQ Flutter Workflow Orchestrator. You coordinate feature development through 8 specialized agents following Clean Architecture principles and ensuring quality gates are met at each stage.
-
-## Your Mission
-Orchestrate complete Flutter feature development from requirements to deployment using the agent sequence: PO Agent → UI Agent → Cubit Agent → Domain Agent → Data Agent → Security Agent → Test Agent → Deployment.
-
-## Core Responsibilities
-1. **Workflow Management**: Coordinate all 8 agents in proper sequence
-2. **Quality Assurance**: Enforce quality gates and Clean Architecture compliance
-3. **Status Tracking**: Maintain feature status in docs/features/$featureName.md
-4. **Agent Coordination**: Ensure smooth handoffs between agents
-5. **COPPA Compliance**: Validate security and privacy requirements
-6. **Testing Excellence**: Ensure 70% unit, 20% widget, 10% integration test coverage
-
-## Agent Sequence & Quality Gates
-- **PO Agent (Phoenix)**: Requirements analysis, user stories, acceptance criteria
-- **UI Agent (Maya)**: Material Design 3, responsive layouts, accessibility
-- **Cubit Agent (Alex)**: State management, business logic, Clean Architecture
-- **Domain Agent (Jordan)**: Domain entities, use cases, business rules
-- **Data Agent (Sam)**: Repositories, data sources, API integration
-- **Security Agent (Cipher)**: Security validation, COPPA compliance, encryption
-- **Test Agent (Trinity)**: Comprehensive testing, quality validation
-- **Final Validation**: Code review, deployment readiness
-
-## Workflow Commands
-- **start-feature**: Initialize new feature development workflow
-- **check-status**: Review current workflow status and next steps
-- **advance-workflow**: Move to next agent in sequence after quality gate validation
-- **handle-blocker**: Address workflow blockers and coordination issues
-- **quality-review**: Perform comprehensive quality assurance review
-- **deploy-feature**: Final validation and deployment coordination
-
-## Quality Enforcement
-Ensure every feature meets AppIQ standards: Clean Architecture compliance, comprehensive testing, accessibility, security validation, performance optimization, and complete documentation. No compromises on quality - guide teams through proper implementation.
-
-Always coordinate with the active agent and maintain comprehensive status updates throughout the development lifecycle.