Rewrite epic: composition-first OpenClapper (planning) #326

The app grew out of a viewfinder helper: a photo cannot exist without a rig and a shot, frame logic reaches into layers, bakes, timeline clips and thumbnails, and expert features (lights, flows, camera control) sit in the core path. The rewrite turns this into isolated building blocks (media, optics, capture, shots, composition, timeline, organisation) that the user links, with expert features packaged as extensions, on a new design system built for the desktop-style Studio.

This epic is planning only: workshops that end in written decisions in docs/rewrite/ on the branch rewrite/plan. No product code is written until the concluding workshop is approved. The rebuild then tears down with zero backwards compatibility and gets its own epic.

Decided (2026-11-12)

• Design system: foundation now (tokens, atoms, OS chrome, icons, marks), feature-level patterns after each workshop. The current feature pages are not restyled.
• Production data is dropped; the rebuild goes to staging first. The owner downloads /photos from the production media bucket before the buckets are deleted.
• Day planning is deleted. Extra fields are removed for now and parked as a future extension mechanism.
• Themes are called Light and Dark.

Workshops

• Rewrite workshop 00: Principles, layers, glossary #327 00 Principles, personas, glossary
• Rewrite workshop 01: Media library #328 01 Media library
• Rewrite workshop 02: Optics and frames #329 02 Optics and frames
• Rewrite workshop 03: Capture on the phone #330 03 Capture on the phone
• Rewrite workshop 04: Shots and planning #331 04 Shots and planning
• Rewrite workshop 05: Composition #332 05 Composition
• Rewrite workshop 06: Timeline #333 06 Timeline
• Rewrite workshop 07: Organisation and filesystem #334 07 Organisation and filesystem
• Rewrite workshop 08: Extensions #335 08 Extensions
• Rewrite workshop 09: Shells and app catalogue #336 09 Shells and app catalogue
• Rewrite workshop 10: Conclusion: target model and build plan #337 10 Conclusion: target model and build plan

Workshops 01–03 are the root of the entanglement and come first; 04–06 build on them; 07–09 depend on a stable block list.

Design track (parallel, starts after workshop 00)

• Rewrite design track D1: Design brief (master prompt) #338 D1 Design brief (master prompt)
• Rewrite design track D2: Design the foundation #339 D2 Design the foundation
• Rewrite design track D3: Adopt the foundation #340 D3 Adopt the foundation
• Rewrite design track D4: Feature-level patterns #341 D4 Feature-level patterns