improve-loop

1# Improve loop
2 
3One pass through the loop takes one story from `todo` to `done`:
4 
5```text
6pick story -> plan -> code -> ./build.sh -> snapshot -> compare -> fix -> commit -> update STORIES.md
7```
8 
9Stop after the milestone the user named, or after the current milestone if
10they named none. Then report.
11 
12## 1. Pick
13 
14Open `docs/STORIES.md`. Take the first `todo` story in the current
15milestone whose dependencies are `done`. Set it to `doing`.
16 
17## 2. Plan
18 
19If the story adds a screen, an action, or words and has no `UX:` block
20yet, call the Skill tool with `ux-design` first.
21 
22Write two to five lines in your head or in the commit body: which files
23change, which model fields are new, which menu command and shortcut it adds,
24which snapshot page shows it. If the story needs a new SwiftData field, give
25it a default value so existing databases keep loading.
26 
27## 3. Code
28 
29Follow the `swift-swiftui` and `mac-design` skills, the story's `UX:`
30block, and `design/DESIGN-SYSTEM.md` if the app has one. System hooks follow
31`os-integrations`. Keep each view file under about 300 lines.
32Put new pages in the `SidebarItem` enum so snapshot mode visits them.
33 
34## 4. Build and snapshot
35 
36Follow the `build-and-verify` skill. If the story has logic, add a test
37or a self-test step (`test-mac-app` skill). Use seed data (`APP_SEED=1`) so pages
38show real content.
39 
40## 5. Compare
41 
42Open your snapshot and the story's reference screenshot side by side with
43…