Master production checklist: build LWA to full creator operating system in thread-sized code packs
Repository: jcamacho611/lwa-app
Author: jcamacho611
This is the master execution checklist the assistant will operate against so the conversation can progressively generate the final production codebase in usable increments instead of one giant unusable dump.
## Operating rule
We will work down this checklist in order. Each conversation/code pack should complete one or more unchecked items until the list is exhausted.
The goal is to eventually cover:
- every screen
- every route
- every backend worker
- every editor surface that actually belongs in scope
- every analytics / queue / campaign module in scope
- every wallet / settings / monetization surface
- every style-engine subsystem in scope
But we will do it in practical code packs, not one unusable monolith.
---
## PHASE 0 — FOUNDATIONS / TRUST BUGS
- [ ] URL normalization utility for public source links
- [ ] Source validation that accepts missing protocol / www
- [ ] Generate form submission path hardened
- [ ] Frontend error handling for bad source input
- [ ] Broken generate flow regression audit
- [ ] Character/world layer visibility audit
- [ ] Core frontend types normalized around clip response shape
- [ ] Frontend API client normalized around current generate contract
## PHASE 1 — SOURCE INTAKE / GENERATE EXPERIENCE
- [ ] Source input component
- [ ] Generate CTA component
- [ ] Recommendation rail component
- [ ] Processing phases component
- [ ] Quick mode / Pro mode state handling
- [ ] Manual override / auto recommendation UX cleanup
- [ ] Source intake layout polish
- [ ] Premium error / empty / loading states
## PHASE 2 — RESULTS EXPERIENCE LAYER
- [ ] HeroClip component
- [ ] Rendered video card component
- [ ] Strategy-only card component
- [ ] Clip lane layout
- [ ] Packaging rail / export rail
- [ ] Results section hierarchy cleanup
- [ ] Post-order surfacing
- [ ] Platform-fit / why-this-hits compact display
- [ ] Recovery / re-render surface where supported
## PHASE 3 — APP SHELL / BRAND / GLOBAL UI
- [ ] AppShell component
- [ ] Navbar / top shell
- [ ] Sidebar / nav rhythm if used
- [ ] Plan / credits / upgrade presentation cleanup
- [ ] Global spacing / type scale cleanup
- [ ] globals.css premium theme pass
- [ ] Tailwind/theme token audit
- [ ] Brand asset audit from `lwa-web/public/brand-source/`
- [ ] Wordmark / mark / favicon integration
- [ ] Controlled dark red accent system
## PHASE 4 — WORKSPACE SECTIONS (POLISH, NOT RESTART)
- [ ] Dashboard route polish
- [ ] Generate route polish
- [ ] Queue / ready state panel polish
- [ ] History panel polish
- [ ] Campaigns panel polish
- [ ] Wallet panel polish
- [ ] Settings panel polish
- [ ] Role-aware views audit
- [ ] Monetization shell audit and refinement
## PHASE 5 — BACKEND CONTRACT / RESPONSE SAFETY
- [ ] Response schema audit
- [ ] Clip response typing cleanup
- [ ] Generate route compatibility audit
- [ ] Processing summary normalization
- [ ] Rendered vs strategy-only state normalization
- [ ] API contract preservation pass
## PHASE 6 — CLIP INTELLIGENCE UPGRADE
- [ ] Clip ranking helper
- [ ] Opening strength scoring
- [ ] Pacing / beat quality scoring
- [ ] Silence detector/service
- [ ] Better endings logic
- [ ] More clips per run strategy where safe
- [ ] Source-grounded fallback clip generation
- [ ] Platform-fit scoring
- [ ] Packaging angle scoring
## PHASE 7 — CAPTIONS / POST-READY OUTPUT POLISH
- [ ] Caption engine service
- [ ] Burned-in caption readiness model
- [ ] Mobile readability rules
- [ ] Hook/title/CTA packaging helpers
- [ ] Thumbnail text generation rules
- [ ] Export-ready packaging bundle shape
## PHASE 8 — RENDER / ASSET PIPELINE
- [ ] Render service audit
- [ ] Export service audit
- [ ] Asset links normalization
- [ ] Preview URL normalization
- [ ] Raw vs edited clip asset handling
- [ ] Fallback behavior when render incomplete
## PHASE 9 — CAMPAIGN / OPERATOR WORKFLOW SYSTEMS
- [ ] Campaign requirement model audit
- [ ] Assignment state surface
- [ ] Submission state surface
- [ ] Payout-readiness scaffolding audit
- [ ] Queue worker / queue state audit
- [ ] Bulk workflow hooks if already supported
## PHASE 10 — STYLE ENGINE PREPARATION
- [ ] Style extractor service
- [ ] Hook pattern detector
- [ ] Pacing / rhythm analysis helper
- [ ] CTA style detector
- [ ] Topic expansion helper
- [ ] Script generator service
- [ ] Diversity engine
- [ ] Anti-repetition memory/system shape
## PHASE 11 — ANALYTICS / INSIGHT SYSTEMS (ONLY IF IN SCOPE)
- [ ] Generation event logging audit
- [ ] Clip performance field planning
- [ ] Operator-visible analytics surfaces in scope
- [ ] Monetization / credits state instrumentation review
## PHASE 12 — WORLD / CHARACTER LAYER (AFTER CORE IS ELITE)
- [ ] Character layer component
- [ ] Safe edge placement system
- [ ] State-aware world presence
- [ ] Non-cluttering background behavior
- [ ] Character asset integration if assets exist
## PHASE 13 — VERIFICATION / SHIP SAFETY
- [ ] Frontend build verification
- [ ] Key route checks (`/`, `/generate`, `/dashboard`, `/campaigns`, `/wallet`, `/settings`)
- [ ] Backend contract verification
- [ ] Railway-safe deployment review
- [ ] Confirmation no iOS changes
- [ ] Commit/push hygiene
---
## Conversation operating format
For each code pack / execution slice, return:
1. Checklist items completed
2. Files created or updated
3. Code
4. Verification notes
5. Remaining next items
This issue exists so the assistant and founder have a shared master build list and can keep moving until the full product surface is covered in practical increments.