# MindMachine - Task List

## 1. Product Definition
- [ ] Review and approve `REQUIREMENTS.md`
- [ ] Confirm target platform for version 1
- [ ] Confirm MVP scope
- [ ] Decide final built-in presets for v1
- [ ] Confirm safety language and disclaimer wording
- [ ] Decide whether version 1 is Android-only

## 2. UX / Product Design
- [ ] Create user flow diagram
- [ ] Define onboarding flow
- [ ] Define safety warning flow
- [ ] Define preset selection screen
- [ ] Define session setup screen
- [ ] Define active session screen
- [ ] Define completion screen
- [ ] Define simple settings screen
- [ ] Define cardboard-holder guidance content

## 3. Technical Planning
- [ ] Choose app architecture
- [ ] Define project module/package structure
- [ ] Select audio generation approach
- [ ] Select visual rendering approach
- [ ] Define timing/synchronization strategy
- [ ] Define persistence model for presets/settings
- [ ] Define interruption handling strategy

## 4. Project Setup
- [ ] Create project repository
- [ ] Initialize native mobile project
- [ ] Configure formatting/linting
- [ ] Configure unit test framework
- [ ] Configure UI/integration test foundation
- [ ] Create initial README

## 5. Core Domain Models
- [ ] Implement `SessionPreset`
- [ ] Implement `SessionConfig`
- [ ] Implement `SessionState`
- [ ] Implement `AudioConfig`
- [ ] Implement `VisualConfig`
- [ ] Implement safety acknowledgment state

## 6. Session Engine
- [ ] Implement session timer/orchestrator
- [ ] Implement start session flow
- [ ] Implement pause/resume logic
- [ ] Implement stop logic
- [ ] Implement completion behavior
- [ ] Add tests for timing and session transitions

## 7. Audio Engine
- [ ] Implement stereo tone generation
- [ ] Implement binaural beat configuration
- [ ] Implement audio lifecycle management
- [ ] Handle headphone/output changes
- [ ] Handle audio interruptions safely
- [ ] Add tests for config and lifecycle behavior

## 8. Visual Engine
- [ ] Implement full-screen rendering surface
- [ ] Implement flash pattern
- [ ] Implement pulse/fade pattern
- [ ] Implement alternating pattern option
- [ ] Connect pattern timing to session state
- [ ] Add tests for visual timing logic where practical

## 9. Safety Features
- [ ] Implement first-run safety acknowledgment
- [ ] Block session start until warnings are acknowledged
- [ ] Add seizure / photo-sensitivity warning text
- [ ] Add headphone requirement warning
- [ ] Add runtime stop/pause behavior for unsafe output changes
- [ ] Add tests for safety guardrails

## 10. UI Implementation
- [ ] Implement onboarding screen
- [ ] Implement home/preset list screen
- [ ] Implement session setup screen
- [ ] Implement active session screen
- [ ] Implement completion screen
- [ ] Implement settings screen
- [ ] Ensure controls are large and clear

## 11. Presets and Settings
- [ ] Add Relax preset
- [ ] Add Focus preset
- [ ] Add Sleep Prep preset
- [ ] Add custom session editor (if in v1)
- [ ] Persist recent settings
- [ ] Validate user-entered parameter ranges

## 12. Holder Guidance / Documentation
- [ ] Write concise holder-building instructions
- [ ] Add fit and comfort guidance
- [ ] Add safe positioning guidance
- [ ] Add end-user usage instructions
- [ ] Review for clarity and brevity

## 13. Testing
- [ ] Unit test session state transitions
- [ ] Unit test preset validation
- [ ] Unit test safety rules
- [ ] Integration test session start/stop
- [ ] Integration test interruption handling
- [ ] UI test onboarding and preset selection
- [ ] UI test active session controls
- [ ] Manual test with real stereo headphones

## 14. Pre-Release Review
- [ ] Review wording for medical/safety compliance
- [ ] Review usability in low-light conditions
- [ ] Review comfort assumptions around phone holder
- [ ] Review battery/heat impact during longer sessions
- [ ] Review failure modes and recovery behavior

## 15. Nice-to-Have After MVP
- [ ] Ambient sound mixing
- [ ] Printable holder template
- [ ] More advanced visual patterns
- [ ] Guided voice sessions
- [ ] Session history
- [ ] Expanded preset library