initial commit

This commit is contained in:
null 2026-05-12 21:36:25 -05:00
commit 2f43f63c5c
1 changed files with 932 additions and 0 deletions

932
execution.md Normal file
View File

@ -0,0 +1,932 @@
# Couples Connection Mobile App
# Full Execution Plan
---
# Project Stack
## Frontend
* React Native
* Expo
* TypeScript
## Backend
* Supabase
* PostgreSQL
* Supabase Auth
* Supabase Realtime
## Storage
* Cloudflare R2
## Notifications
* Expo Push Notifications
---
# Agent Assignment Matrix
| Agent | Role |
| ------------------------------------------ | ------------------------------------------------------------------- |
| Ripley | Project orchestration, execution coordination, batch sequencing |
| Neo (`agentId: neo`) | Backend systems, architecture, security, realtime, database |
| Scarlett (`agentId: scarlett`) | UI systems, mobile UX, styling, responsive layouts, design systems |
| Bishop (`agentId: bishop`) | QA, stability, testing, regression validation, release verification |
| Private_Hudson (`agentId: private_hudson`) | Content systems, moderation, admin workflows, operational tooling |
---
# Dispatch Rules
## Required On Every Agent Spawn
* Explicit `agentId`
* Project context block
* Project directory
* Relevant spec references
* Recent changes summary
* Learnings path reminder
* Report back to Ripley only
---
# Learnings Paths
| Agent | Learnings Path |
| -------------- | ---------------------------- |
| Ripley | `.learnings/` |
| Neo | `.learnings/neo/` |
| Scarlett | `.learnings/scarlett/` |
| Bishop | `.learnings/bishop/` |
| Private_Hudson | `.learnings/private_hudson/` |
---
# STAGE 1
# Foundation & Infrastructure
## Goal
Establish stable application foundation.
---
# Batch 1A
## Expo Bootstrap & Structure
### Lead
Scarlett (`agentId: scarlett`)
### Support
Neo (`agentId: neo`)
### QA
Bishop (`agentId: bishop`)
### Stack Used
* Expo
* React Native
* TypeScript
### Tasks
* Initialize Expo application
* Configure TypeScript
* Configure ESLint + Prettier
* Create folder architecture
* Configure app entry points
* Configure navigation foundation
* Setup environment structure
### Deliverables
* Running Expo app
* Stable folder structure
* Base navigation
---
# Batch 1B
## Supabase Backend Foundation
### Lead
Neo (`agentId: neo`)
### Support
Private_Hudson (`agentId: private_hudson`)
### QA
Bishop (`agentId: bishop`)
### Stack Used
* Supabase
* PostgreSQL
### Tasks
* Create Supabase project
* Configure auth providers
* Configure PostgreSQL structure
* Configure storage buckets
* Configure environment variables
* Setup baseline row level security
### Deliverables
* Working backend connection
* Secure database foundation
---
# Batch 1C
## Authentication System
### Lead
Neo (`agentId: neo`)
### Support
Scarlett (`agentId: scarlett`)
### QA
Bishop (`agentId: bishop`)
### Stack Used
* Supabase Auth
* React Native
* Expo Router
### Tasks
* Email magic link auth
* Session persistence
* Protected routes
* Login screen
* Logout handling
* Auth validation
### Deliverables
* Stable authentication flow
---
# Batch 1D
## Pairing System
### Lead
Neo (`agentId: neo`)
### Support
Scarlett (`agentId: scarlett`)
### QA
Bishop (`agentId: bishop`)
### Stack Used
* Supabase
* PostgreSQL
* React Native
### Tasks
* Pair code generation
* Pair code validation
* Couple linking logic
* Pairing UI
* Couple membership persistence
### Deliverables
* Fully working pairing system
---
# Batch 1E
## Design System Foundation
### Lead
Scarlett (`agentId: scarlett`)
### Support
Ripley
### QA
Bishop (`agentId: bishop`)
### Stack Used
* React Native
* Expo
* NativeWind/Tailwind RN strategy
### Tasks
* Typography system
* Color palette
* Spacing system
* Shared components
* Theme provider
* Dark mode foundation
### Deliverables
* Shared mobile design system
---
# STAGE 2
# Core Question Engine
## Goal
Build primary emotional interaction system.
---
# Batch 2A
## Question Database Architecture
### Lead
Neo (`agentId: neo`)
### Support
Private_Hudson (`agentId: private_hudson`)
### QA
Ripley
### Stack Used
* PostgreSQL
* Supabase
### Tasks
* Question schema
* Metadata tagging
* Category structure
* Visibility rules
* Relationship stage tagging
* Seed starter questions
### Deliverables
* Structured question engine
---
# Batch 2B
## Daily Question System
### Lead
Neo (`agentId: neo`)
### Support
Scarlett (`agentId: scarlett`)
### QA
Bishop (`agentId: bishop`)
### Stack Used
* Supabase
* React Native
### Tasks
* Daily selection logic
* Daily refresh system
* Question retrieval APIs
* Daily question UI
### Deliverables
* Daily question flow
---
# Batch 2C
## Random Question Generator
### Lead
Neo (`agentId: neo`)
### Support
Private_Hudson (`agentId: private_hudson`)
### QA
Ripley
### Stack Used
* PostgreSQL
* Supabase
### Tasks
* Randomization logic
* Category filtering
* Surprise mode
* Duplicate prevention
* Usage history filtering
### Deliverables
* Random question system
---
# Batch 2D
## Answer System
### Lead
Neo (`agentId: neo`)
### Support
Scarlett (`agentId: scarlett`)
### QA
Bishop (`agentId: bishop`)
### Stack Used
* React Native
* Supabase Realtime
### Tasks
* Text answers
* Save answers
* Partner answer retrieval
* Favorite answers
* Reactions foundation
### Deliverables
* Full answer interaction flow
---
# Batch 2E
## Custom Questions
### Lead
Private_Hudson (`agentId: private_hudson`)
### Support
Neo (`agentId: neo`)
### QA
Ripley
### Stack Used
* PostgreSQL
* Supabase
### Tasks
* Custom question creation
* Shared question libraries
* Validation rules
* Moderation structure
### Deliverables
* User generated question system
---
# STAGE 3
# Couple Interaction Systems
## Goal
Expand emotional interaction systems.
---
# Batch 3A
## Emotional Check Ins
### Lead
Scarlett (`agentId: scarlett`)
### Support
Private_Hudson (`agentId: private_hudson`)
### QA
Ripley
### Stack Used
* React Native
* Expo
### Tasks
* Mood UI
* Emotional categories
* Check in interactions
* Emotional state display
### Deliverables
* Emotional check in system
---
# Batch 3B
## Reactions & Interaction Layer
### Lead
Neo (`agentId: neo`)
### Support
Scarlett (`agentId: scarlett`)
### QA
Bishop (`agentId: bishop`)
### Stack Used
* Supabase Realtime
* React Native
### Tasks
* Reactions
* State syncing
* Interaction updates
* Lightweight engagement systems
### Deliverables
* Realtime interaction layer
---
# Batch 3C
## Realtime Infrastructure
### Lead
Neo (`agentId: neo`)
### Support
Bishop (`agentId: bishop`)
### QA
Ripley
### Stack Used
* Supabase Realtime
### Tasks
* Realtime subscriptions
* Live sync validation
* Event handling
* Presence testing
### Deliverables
* Stable realtime infrastructure
---
# STAGE 4
# Memory & Media Systems
## Goal
Build emotional memory ecosystem.
---
# Batch 4A
## Memory Vault
### Lead
Neo (`agentId: neo`)
### Support
Scarlett (`agentId: scarlett`)
### QA
Bishop (`agentId: bishop`)
### Stack Used
* Supabase
* Cloudflare R2
* React Native
### Tasks
* Memory save systems
* Favorites
* Memory categories
* Browsing UI
### Deliverables
* Functional memory vault
---
# Batch 4B
## Relationship Timeline
### Lead
Scarlett (`agentId: scarlett`)
### Support
Neo (`agentId: neo`)
### QA
Ripley
### Stack Used
* React Native
* Supabase
### Tasks
* Timeline rendering
* Milestone systems
* Timeline interactions
* Timeline UI
### Deliverables
* Relationship timeline
---
# Batch 4C
## Video Messaging Foundation
### Lead
Neo (`agentId: neo`)
### Support
Scarlett (`agentId: scarlett`)
### QA
Bishop (`agentId: bishop`)
### Stack Used
* React Native
* Expo AV
* Cloudflare R2
* Supabase
### Tasks
* Video recording flow
* Upload structure
* Metadata storage
* Playback system
### Deliverables
* Basic video messaging
### Status
Advanced video pipeline deferred for future scaling.
---
# STAGE 5
# Admin & Content Systems
## Goal
Enable scalable content operations.
---
# Batch 5A
## Admin Dashboard
### Lead
Private_Hudson (`agentId: private_hudson`)
### Support
Scarlett (`agentId: scarlett`)
### QA
Ripley
### Stack Used
* React Native Web
* Supabase
### Tasks
* Admin auth
* Content management UI
* Moderation queue
* Reporting tools
### Deliverables
* Admin dashboard
---
# Batch 5B
## Moderation Systems
### Lead
Private_Hudson (`agentId: private_hudson`)
### Support
Neo (`agentId: neo`)
### QA
Bishop (`agentId: bishop`)
### Stack Used
* PostgreSQL
* Supabase
### Tasks
* Report handling
* Approval systems
* Moderation APIs
* Enforcement logic
### Deliverables
* Moderation infrastructure
---
# Batch 5C
## Official _null Question Packs
### Lead
Private_Hudson (`agentId: private_hudson`)
### Support
Ripley
### QA
Scarlett (`agentId: scarlett`)
### Stack Used
* PostgreSQL
* Supabase
### Tasks
* Pack structure
* Metadata standards
* Scheduling
* Release organization
### Deliverables
* Official curated question system
---
# STAGE 6
# Polish & Growth Systems
## Goal
Refine production release quality.
---
# Batch 6A
## Notification Refinement
### Lead
Neo (`agentId: neo`)
### Support
Ripley
### QA
Bishop (`agentId: bishop`)
### Stack Used
* Expo Push Notifications
### Tasks
* Notification timing
* Quiet hours
* Reminder refinement
* Notification sanity testing
### Deliverables
* Balanced notification system
---
# Batch 6B
## Shareable Recaps
### Lead
Scarlett (`agentId: scarlett`)
### Support
Private_Hudson (`agentId: private_hudson`)
### QA
Ripley
### Stack Used
* React Native
* Supabase
### Tasks
* Anniversary recaps
* Story summaries
* Share cards
* Recap layouts
### Deliverables
* Shareable recap systems
---
# Batch 6C
## Stability & Production Pass
### Lead
Bishop (`agentId: bishop`)
### Support
Neo (`agentId: neo`)
* Scarlett (`agentId: scarlett`)
### QA
Ripley
### Stack Used
* Expo
* React Native
* Supabase
### Tasks
* Crash testing
* Performance optimization
* Memory leak testing
* Offline validation
* Final regression testing
### Deliverables
* Production ready release candidate
---
# Final Release Gate
## Launch Requirements
* Stable onboarding
* Stable pairing
* Stable question systems
* Secure storage
* Privacy validation
* Notification sanity
* Stable realtime systems
* Crash free baseline
* Performance validation
---
# Execution Principle
Do not build ahead of current stage.
Do not solve imaginary scaling problems before real users exist.
Ship stable emotional experiences incrementally.
Because developers routinely try to build interplanetary infrastructure for apps with seven users and one emotionally vulnerable beta tester.