df13094a
docs: trial ergonomic choices before recording acceptance
a73x 2026-09-05 12:38
Commit message
RETRO.md
| Old | New | ||
|---|---|---|---|
| @@ -187,7 +187,8 @@ before Sprint 4 and close each with evidence at its retrospective. | |||
| 187 | - [x] Start with a bounded cleanup of the lifecycle and state-ownership paths; | 187 | - [x] Start with a bounded cleanup of the lifecycle and state-ownership paths; |
| 188 | keep substantial refactors explicit and preserve the closing cleanup package. | 188 | keep substantial refactors explicit and preserve the closing cleanup package. |
| 189 | Sprint 4 opening cleanup `aa5e977` centralizes attachment startup/teardown; | 189 | Sprint 4 opening cleanup `aa5e977` centralizes attachment startup/teardown; |
| 190 | review, 33 native tests, and `make check` passed. Closing cleanup remains open. | 190 | review, 33 native tests, and `make check` passed. Sprint 4 closing cleanup is |
| 191 | complete and consolidated the remaining lifecycle paths. | ||
| 191 | - [x] Persist the relative weights and stable pane/tab identity introduced here; | 192 | - [x] Persist the relative weights and stable pane/tab identity introduced here; |
| 192 | round-trip nested layouts after minimum clamping and at a different display scale. | 193 | round-trip nested layouts after minimum clamping and at a different display scale. |
| 193 | Nested weights/identities survived 8x8 clamping and actual 100% save to 200% | 194 | Nested weights/identities survived 8x8 clamping and actual 100% save to 200% |
| @@ -209,8 +210,9 @@ before Sprint 4 and close each with evidence at its retrospective. | |||
| 209 | The final source is reviewed and frozen; the 45-second actual Sway recording is | 210 | The final source is reviewed and frozen; the 45-second actual Sway recording is |
| 210 | privately available at `https://charizard.folk-amberjack.ts.net/sprint4/`. | 211 | privately available at `https://charizard.folk-amberjack.ts.net/sprint4/`. |
| 211 | 212 | ||
| 212 | Relative weights remain in memory until Sprint 4 persistence, whose implementer | 213 | Historical Sprint 3 note: relative weights remained in memory until Sprint 4 |
| 213 | owns that planned work. No new correctness debt was deferred by the closing review. | 214 | persistence, whose implementer owned that planned work. No new correctness debt |
| 215 | was deferred by the closing review. | ||
| 214 | 216 | ||
| 215 | ## Native tiling — Sprint 4, 2026-09-05 | 217 | ## Native tiling — Sprint 4, 2026-09-05 |
| 216 | 218 | ||
| @@ -276,6 +278,9 @@ at the final milestone retrospective. | |||
| 276 | release review; build both demo binaries together in an isolated ReleaseSafe | 278 | release review; build both demo binaries together in an isolated ReleaseSafe |
| 277 | prefix and report sampled input latency separately from frame timing. | 279 | prefix and report sampled input latency separately from frame timing. |
| 278 | - [ ] Obtain explicit Sprint 4 demo acceptance before beginning the release review. | 280 | - [ ] Obtain explicit Sprint 4 demo acceptance before beginning the release review. |
| 281 | - [ ] Run the next ergonomic trial from proposed defaults through implementation | ||
| 282 | and demo, apply any requested adjustments, and record whether feedback came | ||
| 283 | from the recording or a hands-on trial, if available, separately from automation. | ||
| 279 | - [ ] Start with a bounded review/cleanup of the accumulated native workflow, then | 284 | - [ ] Start with a bounded review/cleanup of the accumulated native workflow, then |
| 280 | retain a closing cleanup pass; avoid introducing tabs UI or terminal tiling changes. | 285 | retain a closing cleanup pass; avoid introducing tabs UI or terminal tiling changes. |
| 281 | - [ ] Review delayed destructive actions across focus, picker, resize, drag, | 286 | - [ ] Review delayed destructive actions across focus, picker, resize, drag, |
| @@ -286,6 +291,10 @@ at the final milestone retrospective. | |||
| 286 | shared sessions, state ownership/failures, high DPI, and cleanup of owned fixtures. | 291 | shared sessions, state ownership/failures, high DPI, and cleanup of owned fixtures. |
| 287 | - [ ] Record final demo acceptance separately from automation and any hands-on | 292 | - [ ] Record final demo acceptance separately from automation and any hands-on |
| 288 | ergonomic feedback, update the spec's completion status, and commit the milestone. | 293 | ergonomic feedback, update the spec's completion status, and commit the milestone. |
| 294 | - [ ] Evaluate model economy for the sprint using available evidence: record the | ||
| 295 | bounded pair's task scope, review yield, and observed token/time cost, explicitly | ||
| 296 | noting unavailable measurements, then decide whether the current model defaults | ||
| 297 | remain economical for the next sprint. | ||
| 289 | 298 | ||
| 290 | ### Sprint 4 follow-up: raw-output responsiveness | 299 | ### Sprint 4 follow-up: raw-output responsiveness |
| 291 | 300 | ||
docs/native-sprint-workflow.md
| Old | New | ||
|---|---|---|---|
| @@ -7,8 +7,12 @@ packages. Keep one sprint active, ending in a working demo and explicit acceptan | |||
| 7 | 7 | ||
| 8 | 1. **Review and scope.** Read the previous sprint's actions in [RETRO.md](../RETRO.md). | 8 | 1. **Review and scope.** Read the previous sprint's actions in [RETRO.md](../RETRO.md). |
| 9 | Define the smallest useful deliverable, its acceptance scenarios, and what | 9 | Define the smallest useful deliverable, its acceptance scenarios, and what |
| 10 | belongs to later sprints. Settle material interaction choices before UI work; | 10 | belongs to later sprints. Use existing agreements for material scope and |
| 11 | record proposed defaults as proposals until the user accepts them. | 11 | destructive-action semantics; clarify only unresolved points before |
| 12 | implementation. For other ergonomic choices, record the proposed defaults, | ||
| 13 | implement them as trial behavior, demonstrate them, and adjust them from the | ||
| 14 | resulting feedback. Record whether feedback comes from the recorded demo or a | ||
| 15 | hands-on trial; hands-on feedback is optional. | ||
| 12 | 2. **Tidy the starting point.** Inspect the code the sprint will touch. Make small, | 16 | 2. **Tidy the starting point.** Inspect the code the sprint will touch. Make small, |
| 13 | behavior-preserving refactors that simplify the planned work, review them, | 17 | behavior-preserving refactors that simplify the planned work, review them, |
| 14 | run affected checks and `make check`, and commit separately. No cleanup quota: | 18 | run affected checks and `make check`, and commit separately. No cleanup quota: |
| @@ -120,10 +124,12 @@ packages. Keep one sprint active, ending in a working demo and explicit acceptan | |||
| 120 | server's teardown command. Funnel and audio are unnecessary for this workflow. | 124 | server's teardown command. Funnel and audio are unnecessary for this workflow. |
| 121 | 10. **Close honestly.** Inspect the final diff, commit validated work, and provide | 125 | 10. **Close honestly.** Inspect the final diff, commit validated work, and provide |
| 122 | the demo, controls, test results, and material limits. User demo acceptance is | 126 | the demo, controls, test results, and material limits. User demo acceptance is |
| 123 | distinct from passing automation. Update the spec/plan status and RETRO.md with | 127 | distinct from passing automation. Record whether acceptance covers a recording |
| 124 | resolved findings and checkable next-sprint actions. Mark acceptance only when | 128 | or a hands-on trial, and capture any requested ergonomic adjustments separately. |
| 125 | given; a recorded-demo approval does not imply hands-on feedback. Then begin | 129 | Update the spec/plan status and RETRO.md with resolved findings and checkable |
| 126 | the next authorized sprint with step 1. | 130 | next-sprint actions. Mark acceptance only when given; a recorded-demo approval |
| 131 | does not imply hands-on feedback. Then begin the next authorized sprint with | ||
| 132 | step 1. | ||
| 127 | 133 | ||
| 128 | Sprint 2 established the recorded Sway/private Serve demo route. Sprint 3 adds the | 134 | Sprint 2 established the recorded Sway/private Serve demo route. Sprint 3 adds the |
| 129 | opening cleanup pass by user request; keep the closing cleanup as well. | 135 | opening cleanup pass by user request; keep the closing cleanup as well. |
docs/superpowers/plans/2026-09-05-native-tiling.md
| Old | New | ||
|---|---|---|---|
| @@ -10,6 +10,11 @@ Follow the reusable [sprint workflow](../../native-sprint-workflow.md), includin | |||
| 10 | a bounded pre-sprint cleanup pass and separate validated cleanup commit before | 10 | a bounded pre-sprint cleanup pass and separate validated cleanup commit before |
| 11 | feature changes. The closing refactoring package remains mandatory. | 11 | feature changes. The closing refactoring package remains mandatory. |
| 12 | 12 | ||
| 13 | For ergonomic choices, use propose → implement a trial → demo → adjust. State | ||
| 14 | trial defaults before UI work, then record requested changes and whether feedback | ||
| 15 | came from a recording or hands-on use. Demo acceptance does not imply advance | ||
| 16 | agreement or a hands-on trial. Keep agreed behavior and scope authoritative. | ||
| 17 | |||
| 13 | Keep one sprint active. The root agent owns integration, user updates, acceptance | 18 | Keep one sprint active. The root agent owns integration, user updates, acceptance |
| 14 | evidence, and commits. Assign one implementer and one independent adversarial | 19 | evidence, and commits. Assign one implementer and one independent adversarial |
| 15 | reviewer by default. Reuse those agents across packages; do not spawn a new agent | 20 | reviewer by default. Reuse those agents across packages; do not spawn a new agent |