mdan-cli 2.5.0 → 2.6.0

package/phases/auto-02-discover.md

@@ -0,0 +1,207 @@
+# Auto Phase 2: DISCOVER
+
+> Analyze requirements and define user stories
+
+## Objective
+
+Analyze requirements, define user stories, and create acceptance criteria for the project.
+
+## Tasks
+
+### 2.1 Analyze Requirements
+
+- Review loaded requirements
+- Identify key features
+- Prioritize features
+- Define MVP scope
+
+### 2.2 Define User Stories
+
+- Create user stories for each feature
+- Format: "As a [role], I want [feature], so that [benefit]"
+- Assign priority (Must Have, Should Have, Could Have, Won't Have)
+- Estimate complexity
+
+### 2.3 Define Acceptance Criteria
+
+- Create acceptance criteria for each user story
+- Define measurable outcomes
+- Identify edge cases
+- Specify constraints
+
+### 2.4 Identify Dependencies
+
+- Map dependencies between stories
+- Identify external dependencies
+- Define integration points
+- Note blocking issues
+
+### 2.5 Create Feature List
+
+- Compile all features
+- Organize by priority
+- Group by functionality
+- Estimate effort
+
+## Output
+
+Generate `docs/discover.md`:
+
+```markdown
+# Discover Phase
+
+## Project Overview
+
+[Project description and goals]
+
+## Features
+
+### Must Have (MVP)
+
+#### Feature 1: [Feature Name]
+
+**User Story**:
+As a [role], I want [feature], so that [benefit].
+
+**Acceptance Criteria**:
+- [ ] [Criterion 1]
+- [ ] [Criterion 2]
+- [ ] [Criterion 3]
+
+**Priority**: Must Have
+**Complexity**: [Low/Medium/High]
+**Dependencies**: [None/Feature X]
+
+---
+
+#### Feature 2: [Feature Name]
+
+[Same structure]
+
+---
+
+### Should Have
+
+[Features for v1.1]
+
+### Could Have
+
+[Features for future versions]
+
+### Won't Have
+
+[Features explicitly out of scope]
+
+## Dependencies
+
+### Internal Dependencies
+
+- Feature A depends on Feature B
+- Feature C depends on Feature D
+
+### External Dependencies
+
+- [External service 1]
+- [External service 2]
+
+## Integration Points
+
+- [Integration point 1]
+- [Integration point 2]
+
+## Technical Considerations
+
+- [Consideration 1]
+- [Consideration 2]
+
+## Risks and Mitigations
+
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+| [Risk 1] | [High/Medium/Low] | [Mitigation] |
+| [Risk 2] | [High/Medium/Low] | [Mitigation] |
+
+## MVP Scope
+
+**Included**:
+- [Feature 1]
+- [Feature 2]
+- [Feature 3]
+
+**Excluded**:
+- [Feature 4]
+- [Feature 5]
+
+## Next Steps
+
+Proceed to PLAN phase.
+```
+
+## Quality Gates
+
+- [ ] All user stories defined
+- [ ] Acceptance criteria clear
+- [ ] Dependencies identified
+- [ ] MVP scope defined
+
+## Success Criteria
+
+- User stories cover all requirements
+- Acceptance criteria are measurable
+- Dependencies are mapped
+- MVP scope is realistic
+
+## Error Handling
+
+### Unclear Requirements
+
+- Log warning
+- Make reasonable assumptions
+- Document assumptions
+- Continue with note
+
+### Conflicting Requirements
+
+- Trigger debate
+- Resolve conflict
+- Document decision
+- Continue
+
+### Missing Information
+
+- Log warning
+- Use defaults
+- Document gaps
+- Continue
+
+## Token Management
+
+Track token usage:
+- Requirements analysis: ~2,000 tokens
+- User story creation: ~3,000 tokens
+- Acceptance criteria: ~2,000 tokens
+- Dependencies: ~1,000 tokens
+
+Total: ~8,000 tokens
+
+## Logging
+
+```
+[timestamp] Starting DISCOVER phase
+[timestamp] Analyzing requirements...
+[timestamp] Defining user stories...
+[timestamp] Creating acceptance criteria...
+[timestamp] Identifying dependencies...
+[timestamp] Token usage: X / 128,000 (X%)
+[timestamp] DISCOVER phase complete
+```
+
+## Completion Signal
+
+```
+PHASE 2 COMPLETE ✅
+```
+
+## Version
+
+MDAN-AUTO Phase 2: DISCOVER v1.0

package/phases/auto-03-plan.md

@@ -0,0 +1,509 @@
+# Auto Phase 3: PLAN
+
+> Create detailed implementation plan
+
+## Objective
+
+Create a detailed implementation plan with phased approach, breaking down features into implementable steps.
+
+## Tasks
+
+### 3.1 Create Implementation Plan
+
+- Break down features into tasks
+- Organize tasks into phases (#PHASE1, #PHASE2, etc.)
+- Define task dependencies
+- Estimate effort per task
+
+### 3.2 Define Phase Structure
+
+- #PHASE1: Foundation and Setup
+- #PHASE2: Core Features
+- #PHASE3: Advanced Features
+- #PHASE4: Integration
+- #PHASE5: Testing and Polish
+
+### 3.3 Create Task List
+
+For each phase, define:
+- Task description
+- Acceptance criteria
+- Dependencies
+- Estimated effort
+- Owner (agent)
+
+### 3.4 Define Milestones
+
+- Identify key milestones
+- Define milestone criteria
+- Set milestone dates (if applicable)
+- Link milestones to phases
+
+### 3.5 Create Risk Plan
+
+- Identify implementation risks
+- Define mitigation strategies
+- Create contingency plans
+- Set risk triggers
+
+## Output
+
+Generate `docs/plan.md`:
+
+```markdown
+# Implementation Plan
+
+## Overview
+
+This plan breaks down the project into 5 phases, each with specific tasks and deliverables.
+
+## Phase Structure
+
+- #PHASE1: Foundation and Setup
+- #PHASE2: Core Features
+- #PHASE3: Advanced Features
+- #PHASE4: Integration
+- #PHASE5: Testing and Polish
+
+---
+
+#PHASE1: Foundation and Setup
+
+## Tasks
+
+### Task 1.1: Project Initialization
+
+**Description**: Set up .NET project structure and configuration
+
+**Acceptance Criteria**:
+- [ ] Solution created with correct structure
+- [ ] Projects configured for Blazor Server
+- [ ] NuGet packages installed
+- [ ] Configuration files set up
+
+**Dependencies**: None
+**Effort**: 2 hours
+**Owner**: Dev Agent
+
+---
+
+### Task 1.2: Database Setup
+
+**Description**: Set up SQL Server database and schema
+
+**Acceptance Criteria**:
+- [ ] Database created
+- [ ] Tables created with correct schema
+- [ ] Indexes created
+- [ ] Seed data populated
+
+**Dependencies**: Task 1.1
+**Effort**: 4 hours
+**Owner**: Dev Agent
+
+---
+
+### Task 1.3: Authentication Setup
+
+**Description**: Implement authentication with Azure AD
+
+**Acceptance Criteria**:
+- [ ] Azure AD app registered
+- [ ] Authentication middleware configured
+- [ ] Login/logout implemented
+- [ ] User roles defined
+
+**Dependencies**: Task 1.1
+**Effort**: 6 hours
+**Owner**: Security Agent
+
+---
+
+## Phase 1 Deliverables
+
+- [ ] Project structure
+- [ ] Database schema
+- [ ] Authentication system
+- [ ] Configuration files
+
+## Phase 1 Success Criteria
+
+- All tasks completed
+- Application builds successfully
+- Authentication works
+- Database accessible
+
+---
+
+#PHASE2: Core Features
+
+## Tasks
+
+### Task 2.1: User Management
+
+**Description**: Implement user CRUD operations
+
+**Acceptance Criteria**:
+- [ ] User list page
+- [ ] User create/edit forms
+- [ ] User deletion
+- [ ] User search/filter
+
+**Dependencies**: #PHASE1
+**Effort**: 8 hours
+**Owner**: Dev Agent
+
+---
+
+### Task 2.2: External Service Integration
+
+**Description**: Implement generic external service framework
+
+**Acceptance Criteria**:
+- [ ] Generic service framework implemented
+- [ ] Retry logic working
+- [ ] Circuit breaker working
+- [ ] Rate limiting working
+- [ ] Caching working
+- [ ] Error handling
+
+**Dependencies**: #PHASE1
+**Effort**: 12 hours
+**Owner**: Dev Agent
+
+---
+
+## Phase 2 Deliverables
+
+- [ ] User management system
+- [ ] External service integration
+- [ ] Core UI components
+
+## Phase 2 Success Criteria
+
+- All core features working
+- External service integration functional
+- UI responsive and usable
+
+---
+
+#PHASE3: Advanced Features
+
+## Tasks
+
+### Task 3.1: Service Activity History
+
+**Description**: Implement service activity history and reporting
+
+**Acceptance Criteria**:
+- [ ] Service activity list page
+- [ ] Activity details
+- [ ] Filtering and search
+- [ ] Export functionality
+
+**Dependencies**: #PHASE2
+**Effort**: 10 hours
+**Owner**: Dev Agent
+
+---
+
+### Task 3.2: Notifications
+
+**Description**: Implement notification system
+
+**Acceptance Criteria**:
+- [ ] Real-time notifications
+- [ ] Notification history
+- [ ] Notification preferences
+- [ ] Email notifications
+
+**Dependencies**: #PHASE2
+**Effort**: 8 hours
+**Owner**: Dev Agent
+
+---
+
+### Task 3.3: Analytics Dashboard
+
+**Description**: Create analytics dashboard
+
+**Acceptance Criteria**:
+- [ ] Dashboard with charts
+- [ ] Key metrics displayed
+- [ ] Date range filters
+- [ ] Export reports
+
+**Dependencies**: #PHASE3
+**Effort**: 12 hours
+**Owner**: Dev Agent
+
+---
+
+## Phase 3 Deliverables
+
+- [ ] Service activity history
+- [ ] Notification system
+- [ ] Analytics dashboard
+- [ ] Advanced UI components
+
+## Phase 3 Success Criteria
+
+- All advanced features working
+- Dashboard displays correct data
+- Notifications delivered
+
+---
+
+#PHASE4: Integration
+
+## Tasks
+
+### Task 4.1: API Integration
+
+**Description**: Integrate all external APIs
+
+**Acceptance Criteria**:
+- [ ] All APIs connected
+- [ ] Error handling robust
+- [ ] Rate limiting implemented
+- [ ] Logging configured
+
+**Dependencies**: #PHASE3
+**Effort**: 8 hours
+**Owner**: Dev Agent
+
+---
+
+### Task 4.2: Azure Integration
+
+**Description**: Configure Azure services
+
+**Acceptance Criteria**:
+- [ ] App Service configured
+- [ ] SQL Database connected
+- [ ] Key Vault integrated
+- [ ] Monitoring set up
+
+**Dependencies**: #PHASE3
+**Effort**: 6 hours
+**Owner**: DevOps Agent
+
+---
+
+### Task 4.3: CI/CD Pipeline
+
+**Description**: Set up CI/CD pipeline
+
+**Acceptance Criteria**:
+- [ ] Build pipeline configured
+- [ ] Test pipeline configured
+- [ ] Deployment pipeline configured
+- [ ] Automated deployments working
+
+**Dependencies**: #PHASE4
+**Effort**: 8 hours
+**Owner**: DevOps Agent
+
+---
+
+## Phase 4 Deliverables
+
+- [ ] All integrations working
+- [ ] Azure services configured
+- [ ] CI/CD pipeline operational
+- [ ] Monitoring active
+
+## Phase 4 Success Criteria
+
+- All integrations tested
+- Deployment automated
+- Monitoring functional
+
+---
+
+#PHASE5: Testing and Polish
+
+## Tasks
+
+### Task 5.1: Unit Tests
+
+**Description**: Write comprehensive unit tests
+
+**Acceptance Criteria**:
+- [ ] 80%+ code coverage
+- [ ] All business logic tested
+- [ ] Edge cases covered
+- [ ] Tests passing
+
+**Dependencies**: #PHASE4
+**Effort**: 16 hours
+**Owner**: Test Agent
+
+---
+
+### Task 5.2: Integration Tests
+
+**Description**: Write integration tests
+
+**Acceptance Criteria**:
+- [ ] API endpoints tested
+- [ ] Database operations tested
+- [ ] External integrations tested
+- [ ] Tests passing
+
+**Dependencies**: #PHASE4
+**Effort**: 12 hours
+**Owner**: Test Agent
+
+---
+
+### Task 5.3: UI Polish
+
+**Description**: Polish UI/UX
+
+**Acceptance Criteria**:
+- [ ] Consistent styling
+- [ ] Responsive design
+- [ ] Accessibility improvements
+- [ ] Performance optimized
+
+**Dependencies**: #PHASE4
+**Effort**: 8 hours
+**Owner**: UX Agent
+
+---
+
+### Task 5.4: Documentation
+
+**Description**: Create documentation
+
+**Acceptance Criteria**:
+- [ ] README complete
+- [ ] API documentation
+- [ ] User guide
+- [ ] Deployment guide
+
+**Dependencies**: #PHASE5
+**Effort**: 8 hours
+**Owner**: Doc Agent
+
+---
+
+## Phase 5 Deliverables
+
+- [ ] Comprehensive test suite
+- [ ] Polished UI
+- [ ] Complete documentation
+- [ ] Production-ready code
+
+## Phase 5 Success Criteria
+
+- All tests passing
+- Coverage ≥80%
+- Documentation complete
+- UI polished
+
+---
+
+## Milestones
+
+| Milestone | Phase | Criteria | Date |
+|-----------|-------|----------|------|
+| M1: Foundation Complete | #PHASE1 | All Phase 1 tasks complete | [Date] |
+| M2: Core Features Complete | #PHASE2 | All Phase 2 tasks complete | [Date] |
+| M3: Advanced Features Complete | #PHASE3 | All Phase 3 tasks complete | [Date] |
+| M4: Integration Complete | #PHASE4 | All Phase 4 tasks complete | [Date] |
+| M5: Production Ready | #PHASE5 | All Phase 5 tasks complete | [Date] |
+
+## Risk Plan
+
+| Risk | Impact | Probability | Mitigation | Trigger |
+|------|--------|-------------|------------|---------|
+| API changes | High | Medium | Version APIs, implement adapters | API version change |
+| Performance issues | High | Low | Load testing, optimization | Slow response times |
+| Security vulnerabilities | High | Low | Security reviews, penetration testing | Security scan findings |
+| Integration failures | Medium | Medium | Comprehensive testing, fallbacks | Integration test failures |
+
+## Total Effort Estimate
+
+- #PHASE1: 12 hours
+- #PHASE2: 32 hours
+- #PHASE3: 30 hours
+- #PHASE4: 22 hours
+- #PHASE5: 44 hours
+
+**Total**: 140 hours (~17.5 days)
+
+## Next Steps
+
+Proceed to ARCHITECT phase.
+```
+
+## Quality Gates
+
+- [ ] All phases defined
+- [ ] Tasks broken down
+- [ ] Dependencies mapped
+- [ ] Effort estimated
+
+## Success Criteria
+
+- Plan covers all features
+- Tasks are actionable
+- Dependencies are clear
+- Effort is realistic
+
+## Error Handling
+
+### Unclear Requirements
+
+- Log warning
+- Make reasonable assumptions
+- Document assumptions
+- Continue
+
+### Too Many Tasks
+
+- Group related tasks
+- Create sub-phases
+- Reorganize plan
+- Continue
+
+### Unrealistic Estimates
+
+- Adjust estimates
+- Add buffer time
+- Document assumptions
+- Continue
+
+## Token Management
+
+Track token usage:
+- Plan creation: ~5,000 tokens
+- Task breakdown: ~4,000 tokens
+- Risk analysis: ~2,000 tokens
+- Effort estimation: ~2,000 tokens
+
+Total: ~13,000 tokens
+
+## Logging
+
+```
+[timestamp] Starting PLAN phase
+[timestamp] Creating implementation plan...
+[timestamp] Defining phases...
+[timestamp] Breaking down tasks...
+[timestamp] Creating risk plan...
+[timestamp] Token usage: X / 128,000 (X%)
+[timestamp] PLAN phase complete
+```
+
+## Completion Signal
+
+```
+PHASE 3 COMPLETE ✅
+```
+
+## Version
+
+MDAN-AUTO Phase 3: PLAN v1.0