@troylar/flightdeck 2.9.0 → 2.11.0

package/CHANGELOG.md

@@ -2,6 +2,53 @@
 
 <!-- Generated by build.py from src/releases.json. Edit that file, not this one. -->
 
+## 2.11.0 · Oct 28, 2026
+
+Find things in big folders.
+
+### New
+
+- **Find boxes for checklists, skills, follow-ups and people** (Everywhere). Checklists, All skills, Runs › Follow-ups and Settings › People each have a Find box. Every word you type must appear, and the count says how many match. Escape or Clear empties it, and what you typed stays across screens until you switch folders. Join's Who are you? has Find your name, and Start, Plan and Who should do it have Find a role. *Where:* Checklists, Skills, Runs › Follow-ups, Settings › People, Join, and starting or planning a run
+- **Long dropdowns have a Find box** (Everywhere). A dropdown over something that grows with your folder lists 50 choices. Past 50, a Find box narrows over all of them, and Show 50 more… or Show more choices widens the list without changing your choice. Choices with the same name say where they are. *Where:* Moved to, Filter runs, the version pickers, Export evidence, the editor's linked checklist, Move it to and the Phase select
+
+### Improved
+
+- **Long lists show a page at a time** (Everywhere). Lists that grow with your folder show 50 at a time, with Show more. Home's lists show 10, and a run step's corrections, answers and reports 20. Counts are of the whole list. Show more moves focus to the first new row and scrolls it into view. Publishing still uses every check, and Copy for Jira still copies the whole receipt. *Where:* Checklists, Skills, Runs, Home, a checklist's page, a run, How runs go, Folder health and Settings
+- **What you're working on stays on screen** (Everywhere). A row with an open form, such as a follow-up's Won't do or a correction being declined, stays drawn through Show more, Find, Open, Yours and All, and a newer read. If someone decided it elsewhere, it says so. If it was removed, what you typed stays, with Copy my text. A plan you just saved shows in Just planned above the filters. *Where:* Runs › Follow-ups and Planned, a checklist's Corrections, a run's reports
+- **Search results and Back open rows past the page** (Everywhere). A note, correction or report you open from search, View correction, View change or a Reports panel link is drawn wherever it sits in its list, focused and in view. On a phone the inspector opens on it. Back from the runs behind a number in How runs go shows that row again, with focus on its count. *Where:* Search, a checklist's Corrections, a run's notes, corrections and reports, and How runs go
+- **A step's notes show the newest 20** (Runs). A step shows its newest 20 notes, with Show 20 earlier above them. The box for a new note keeps what you typed. A note opened from search, or one you just saved, is shown under From earlier even when it sorts outside the newest 20. Notes that share an ID each open as their own. *Where:* A run, a step's notes
+- **Long notices are folded** (Everywhere). Each is one notice, with the list in a fold 50 at a time (incomplete publications 20). A report whose copies differ, drafts that share a checklist, older v0.1 runs and linked steps that can't start each say so in one line, with the names in a fold. *Where:* A run, Checklists, a checklist's page and Runs
+- **Names sort the way you'd expect** (Everywhere). Checklist 2 comes before Checklist 10, ignoring capitals. Every person picker and Settings › People list people by name. people.json keeps its own order. *Where:* Checklists, Skills, team values, person pickers and Settings › People
+
+### Fixed
+
+- **Show more in How runs go moves focus to the new rows** (Runs). Show more in the duration table and Steps that go off-script focuses the first row it adds, and choosing another version starts both lists from their first page. *Where:* Runs › How runs go, the duration table and Steps that go off-script
+- **A correction you save is shown** (Runs). The correction you just saved, a Done differently one included, is drawn, focused and scrolled into view. *Where:* A run, Correct this step
+- **Moved to keeps your choice** (Runs). A chosen run that ends or is removed, or a chosen plan that starts, stays the choice, marked, and Save writes the same reference as before. *Where:* Runs › Follow-ups, Moved to another run
+- **A chosen tag stays when no checklist has it anymore** (Checklists). A chosen tag that a newer read removes from every checklist stays, chosen, with Clear. *Where:* Checklists, Filter by tag
+- **Focus stays put when an ID has a # or /** (Everywhere). A redraw keeps focus on a row or box whose ID has a # or /. *Where:* Everywhere
+
+## 2.10.0 · Oct 27, 2026
+
+First-time clarity.
+
+### New
+
+- **Approvals have their own form, and + Add role is where you need it** (Editor). + Add approval in the outline opens a form with the approval's name and who approves; what passing approves is under More approval options. + Add role in the approval, lane and step forms adds a role to the checklist and gives it to that part in one change, with one Undo. *Where:* Editing a draft, an approval, lane or step
+
+### Improved
+
+- **A shorter step form** (Editor). A step starts with What needs to be done?, Who does it?, Must be done and + Add instructions. A step with a type shows its type and the boxes it usually needs at the top. Guidance, proof, timing, conditions and automation planning are under More options, which stays open on every step once you open it. Anything a step already uses is shown outside it, and a box never moves while you type in it. *Where:* Editing a draft, a step
+- **Must be done and Automation planned are checkboxes** (Editor). Must be done and Automation planned are two checkboxes. Checking one clears the other and says so. The checklist's Markdown is the same as before. *Where:* Editing a draft, a step
+- **The start screen asks who approves** (Runs). A checklist with an approval role opens With others and asks who approves, with a suggestion from earlier runs. On my own says it includes who approves. Start waits until it's chosen and keeps what you typed. *Where:* Starting a run or planning one
+- **Checklists, not Processes** (Everywhere). The app says Checklists and New checklist, and the plain step type is Basic step. Files, IDs, commands and the Markdown are unchanged. The type chooser groups Everyday work, Software tools and commands, and your team's types. *Where:* Navigation, the Checklists page and the step type chooser
+- **A new draft starts on its first step** (Editor). It opens on Preview, and the outline says Add your first step above the add box. A draft with any other problem still opens on Checks. *Where:* Creating a checklist
+
+### Fixed
+
+- **A detail picked from the suggestions is applied when you leave the box** (Editor). Leaving the box applies it, as typing does. When a box does hold typing that isn't applied, the message is shown beside that box with Apply and Discard, including on a phone, and a closed More options around it opens. *Where:* Editing a draft
+- **Quick add takes ^details** (Editor). A step added from the outline's quick-add box keeps the ^details typed into it. *Where:* Editing a draft, the outline
+
 ## 2.9.0 · Oct 27, 2026
 
 Team values.

package/README.md

@@ -32,7 +32,7 @@
 
 ## Words this README uses
 
-- A **process** is something your team does; the app lists them under **Processes**. Its **checklist** is the steps, written as Markdown and published as numbered **versions** (v1, v2, …).
+- A **checklist** is something your team does, written down; the app lists them under **Checklists** (called Processes before 2.10). Its steps are written as Markdown and published as numbered **versions** (v1, v2, …).
 - A **run** is one time through a checklist. One person **records** it (the **recorder**); everyone else follows along.
 - A **window** is one open Flightdeck tab. Some file names include the window that wrote them.
 - A **run detail** is a value a run carries, like the commit or the release tag. Steps refer to one as `^commit`.
@@ -64,11 +64,11 @@ flightdeck install ~/OneDrive/Team     # adds flightdeck.html; keeps the AGENTS.
 
 Run it after setup, not before: setup wants an empty folder. Teammates then open `flightdeck.html` from the team folder in Edge or Chrome. Setting the folder up in OneDrive is covered in [Flightdeck and OneDrive](https://github.com/troylar/flightdeck/blob/main/docs/onedrive.md#set-up).
 
-**Finding your way around.** The top bar has **Home**, **Runs**, **Processes** and **Settings**. **Skills** and **Step types** open from the Processes page, from Settings and from search (Ctrl+K, or Cmd+K on a Mac), which finds runs, steps, notes, corrections, follow-ups, step types and skills, and keeps its index in memory on your computer.
+**Finding your way around.** The top bar has **Home**, **Runs**, **Checklists** and **Settings**. **Skills** and **Step types** open from the Checklists page, from Settings and from search (Ctrl+K, or Cmd+K on a Mac), which finds runs, steps, notes, corrections, follow-ups, step types and skills, and keeps its index in memory on your computer.
 
-**Home** shows only what's yours, each with one button: the run you're recording, a plan to review, a skill to update, and your open follow-ups. **Processes** lists every process in your team's own groups, with **Filter by tag** and each one's version and last run. **New process** starts one.
+**Home** shows only what's yours, each with one button: the run you're recording, a plan to review, a skill to update, and your open follow-ups, 10 at a time with **Show 10 more**. **Checklists** lists every checklist in your team's own groups, with **Find a checklist** (by title, ID, group or tag), **Filter by tag** and each one's version and last run. A big folder shows 50 at a time, with **Show 50 more**. **New checklist** starts one.
 
-<p align="center"><a href="https://github.com/troylar/flightdeck/blob/main/docs/images/home-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/home-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/home-light.png" alt="Home for Casey: the things that need Casey, each with one button, then Your follow-ups with Done, Moved to a ticket, Moved to another run and Won't do" width="49%"></picture></a> <a href="https://github.com/troylar/flightdeck/blob/main/docs/images/processes-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/processes-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/processes-light.png" alt="Processes: the team's processes grouped by hierarchy, each with its version, when it last ran and its skills, with Filter by tag, and Skills, Step types and New process at the top" width="49%"></picture></a></p>
+<p align="center"><a href="https://github.com/troylar/flightdeck/blob/main/docs/images/home-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/home-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/home-light.png" alt="Home for Casey: the things that need Casey, each with one button, then Your follow-ups with Done, Moved to a ticket, Moved to another run and Won't do" width="49%"></picture></a> <a href="https://github.com/troylar/flightdeck/blob/main/docs/images/processes-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/processes-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/processes-light.png" alt="Checklists: Find a checklist and Filter by tag, then the team's checklists grouped by hierarchy, each with its version, when it last ran and its skills, and Skills, Step types and New checklist at the top" width="49%"></picture></a></p>
 
 ## How it works
 
@@ -103,23 +103,23 @@ context: commit
 
 Two phases, three steps and one gate, plus the final confirmation every checklist gets. `[!]` is a must-do. `{run.command}` is the step's type, so the run shows the command with a Copy button. `^commit` ties a step to a run detail. The gate approves exactly one thing: publishing that commit.
 
-You don't have to write Markdown. **New process** on the Processes page asks for a title and opens the editor with the **Add a step** box ready: type a step, press Enter, type the next. The group, tags, run details, roles, owner and file name are under **More options**. You can also start from Code check-in or Weekly review, or copy a prompt for your AI assistant.
+You don't have to write Markdown. **New checklist** on the Checklists page asks for a title and opens the editor with the **Add a step** box ready: type a step, press Enter, type the next. The group, tags, run details, roles, owner and file name are under **More options**. You can also start from Code check-in or Weekly review, or copy a prompt for your AI assistant.
 
-**Edit** on a process page opens its draft on a page of its own: the **Builder** (an outline) or the **Markdown**, beside **Checks** (what blocks publishing, and what's only a tip) and a **Preview**. Both views edit the same file; the builder changes only the lines you touch and never a step ID. Your AI assistant's changes to a draft you have open, with nothing unsaved, show up within seconds, marked and one Undo away.
+**Edit** on a checklist's page opens its draft on a page of its own: the **Builder** (an outline) or the **Markdown**, beside **Checks** (what blocks publishing, and what's only a tip) and a **Preview**. Both views edit the same file; the builder changes only the lines you touch and never a step ID. Your AI assistant's changes to a draft you have open, with nothing unsaved, show up within seconds, marked and one Undo away.
 
-<a href="https://github.com/troylar/flightdeck/blob/main/docs/images/builder-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/builder-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/builder-light.png" alt="The editor's Builder, with Save draft and Review &amp; publish in the header: the parts box with Phase, Gate, Step, Must-do and All parts; phases as cards with steps as rows and a striped gate bar; and the selected step's form, scrolled to its Fields: each box asks a question (Which job?, Which parameters?, Which stage do you watch?) with a short why under it, then + Job page for a box it doesn't usually need, and How long does it usually take?" width="1000"></picture></a>
+<a href="https://github.com/troylar/flightdeck/blob/main/docs/images/builder-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/builder-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/builder-light.png" alt="The editor's Builder, with Save draft and Review &amp; publish in the header: the parts box with Phase, Approval, Step, Must-do and All parts; phases as cards with steps as rows and a striped approval bar with Edit approval; and the selected Jenkins job step's form: What needs to be done?, Who does it? with its roles and + Add role, Must be done checked, then its type and Which job? at the top" width="1000"></picture></a>
 
-**The step form** asks a question for each box, with a gray example and why it matters. It shows only the boxes the step's type usually needs, and any that hold a value; the rest are one click away behind **+ add** buttons. The fields every step accepts (a link, how long it takes, a deadline, proof, a time) are under **More about this step**. A choice of five or fewer is a row of buttons. **When it's checked, they record** lists exactly what a run will ask for. In the outline, drag a step or press Alt+Up / Alt+Down to move it, and **Undo** and **Redo** step through changes.
+**The step form** starts short: what needs to be done, who does it, **Must be done**, and **+ Add instructions**. A step with a type shows its type and the boxes it usually needs at the top. Everything else (guidance, proof, timing, conditions, automation planning) is under **More options**, which stays open once you open it; anything a step already uses is shown outside it. Each box asks a question, with a gray example and why it matters, and boxes not shown yet are one click away behind **+ add** buttons. A choice of five or fewer is a row of buttons. **When it's checked, they record** lists exactly what a run will ask for. In the outline, drag a step or press Alt+Up / Alt+Down to move it, and **Undo** and **Redo** step through changes.
 
 **Details in any box.** Type `^` in a step's text, a gate's approval or a text field to pick a run detail, or use **Insert a detail**. A misspelled one is marked with a one-click fix ("Use ^environment"), and a detail that may not be set yet at that step says which step sets it. **In a run:** under the box shows it filled in, with the values from your latest run. A caret that isn't a detail, like `grep ^ERROR`, stays as written. To rename a detail everywhere at once, use **Rename** in Checklist details; a linked step in this checklist keeps passing the same value to its child. If another checklist runs this one at its latest and passes the detail by the old name, Rename says so, and Folder health flags that checklist once this version is published, until it's changed to match.
 
 <p align="center"><a href="https://github.com/troylar/flightdeck/blob/main/docs/images/autocomplete-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/autocomplete-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/autocomplete-light.png" alt="A Jenkins step's parameters box: typing ^en offers ^environment, a text detail asked when a run starts, or adding ^en as a new run detail" width="49%"></picture></a> <a href="https://github.com/troylar/flightdeck/blob/main/docs/images/rename-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/rename-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/rename-light.png" alt="Checklist details: each run detail with how many places use it and Rename; renaming ^tag to build_tag lists the steps that follow it" width="49%"></picture></a></p>
 
-**Run another process.** A step can start another checklist as a linked run. Pick the process from a list, and say where each of its details comes from: one of this run's details (under another name if you like), a fixed value, or asked when it starts. Publishing checks that against the other checklist as it is now. When you start it, its form opens with what's passed already filled in and asks only what's left (2.8).
+**Run another checklist.** A step can start another checklist as a linked run. Pick the checklist from a list, and say where each of its details comes from: one of this run's details (under another name if you like), a fixed value, or asked when it starts. Publishing checks that against the other checklist as it is now. When you start it, its form opens with what's passed already filled in and asks only what's left (2.8).
 
 <p align="center"><a href="https://github.com/troylar/flightdeck/blob/main/docs/images/nested-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/nested-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/nested-light.png" alt="A linked step in the editor: Check in code chosen from a list, Latest when this run starts, and what Check in code needs: branch asked when it starts, commit from this run's ^commit, story from this run's ^ticket" width="38%"></picture></a> <a href="https://github.com/troylar/flightdeck/blob/main/docs/images/child-start-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/child-start-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/child-start-light.png" alt="Starting the Check in code run: commit and story passed from this run, branch asked, and who's doing what" width="60%"></picture></a></p>
 
-**Save draft** saves your work. **Review & publish** goes back to the process page: there you can compare the draft with the last version, write what changed in one line, and choose **Publish vN**. Anything that blocks publishing disables the button; suggestions don't. A save goes through only if the draft is still what you opened; if a teammate changed it meanwhile, nothing is saved and you choose between their version and yours. A shared folder can't lock a file, so edit a draft with one person (or one AI assistant) at a time.
+**Save draft** saves your work. **Review & publish** goes back to the checklist's page: there you can compare the draft with the last version, write what changed in one line, and choose **Publish vN**. Anything that blocks publishing disables the button; suggestions don't. A save goes through only if the draft is still what you opened; if a teammate changed it meanwhile, nothing is saved and you choose between their version and yours. A shared folder can't lock a file, so edit a draft with one person (or one AI assistant) at a time.
 
 <a href="https://github.com/troylar/flightdeck/blob/main/docs/images/edit-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/edit-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/edit-light.png" alt="Editing a draft as Markdown, with Practice, Save draft and Review &amp; publish in the header: the open corrections with links to their lines, the Markdown on the left, and the Checks and Preview tabs on the right"></picture></a>
 
@@ -129,7 +129,7 @@ You don't have to write Markdown. **New process** on the Processes page asks for
 
 To rehearse a change with real people before everyone uses it, **stage** it. A staged version is tried by **test runs** while every real run stays on the current default:
 
-1. **Stage it.** At the end of Practice, write what changed and choose **Stage it for a test run**; or on the process page open **All versions** and choose **Stage the draft for testing**. It's written once to `staged/` and never edited.
+1. **Stage it.** At the end of Practice, write what changed and choose **Stage it for a test run**; or on the checklist's page open **All versions** and choose **Stage the draft for testing**. It's written once to `staged/` and never edited.
 2. **Try it.** **Start a test run** on the staged line. A test run is recorded like any run but is labeled **Test run** everywhere it shows, and it's never counted as a real run: How runs go, Home's running number, last-run dates and role rotation leave it out. Its follow-ups and corrections are real.
 3. **Prove it.** The staged line counts clean test runs ("2 of 3 clean test runs"). With three, the owner, or the backup owner while the owner is away, gets **Sign off staged v3**.
 4. **Make it the default.** **Make v3 the default** publishes exactly what was staged as the next version (if someone published meanwhile, it takes the next number and says so). Its clean test runs and sign-off then count for that version.
@@ -142,13 +142,13 @@ To rehearse a change with real people before everyone uses it, **stage** it. A s
 
 Publishing freezes the checklist as a numbered version, with who, when and why, in a folder that is written once and never changed. Every run keeps the version it started on, forever, and carries its own copy of the checklist and step types, so it reads the same years later. Before you publish, the panel names anything the draft uses that older copies can't run, under **Needs Flightdeck 2.0** or **Needs Flightdeck 2.1**.
 
-A process page shows its checklist (as **Checklist**, **Flight plan** or **Markdown**), **Start a run**, **Plan a run**, **How runs go** and its versions; an older version offers **Restore as draft**. Its owner and backup owner also see open corrections, **Ready for a skill?** and its skills; everyone else sees each of those as one line.
+A checklist's page shows its steps (as **Checklist**, **Flight plan** or **Markdown**), **Start a run**, **Plan a run**, **How runs go** and its versions; an older version offers **Restore as draft**. Its owner and backup owner also see open corrections, **Ready for a skill?** and its skills; everyone else sees each of those as one line.
 
 <a href="https://github.com/troylar/flightdeck/blob/main/docs/images/process-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/process-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/process-light.png" alt="The Production release process as its owner sees it: the v2 checklist with skill badges, the Checklist, Flight plan and Markdown views, Edit, Start a run and Plan a run, and the Corrections panel with two open corrections" width="1000"></picture></a>
 
 ### 4. Run it
 
-**Start a run** and type the run's details. Or **Plan a run** for later, with the details you know, who does what and an optional time; nothing starts until a person starts it, and a plan starts on the version it was planned on until you switch it. **Plan another like this** on any run copies its details and roles, never its answers.
+**Start a run** and type the run's details. Or **Plan a run** for later, with the details you know, who does what and an optional time; nothing starts until a person starts it, and a plan starts on the version it was planned on until you switch it. A plan you just saved shows in **Just planned** at the top of Runs, whatever filter is on. A checklist with many roles lists 20 at a time, with **Find a role**. **Plan another like this** on any run copies its details and roles, never its answers.
 
 <p align="center"><a href="https://github.com/troylar/flightdeck/blob/main/docs/images/runs-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/runs-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/runs-light.png" alt="Runs: one release running, two planned releases (one by Casey Nguyen with a time, one requested by an AI assistant), the newest finished runs, and a More menu with Export evidence…" width="49%"></picture></a> <a href="https://github.com/troylar/flightdeck/blob/main/docs/images/plan-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/plan-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/plan-light.png" alt="Plan a run: run name, ticket, commit and environment filled in, a time and a note, and a person for each role with the rotation's suggestion" width="49%"></picture></a></p>
 
@@ -160,7 +160,7 @@ The run screen fills the window:
 | **Recording strip** | Who's recording, with **Pause** and **Hand off** (which names the exact revision passed on), the run's details, and what this window saved and when it last checked the folder. Another window sees **Pick up recording** (when it was handed to you), **Record here** (when you're recording elsewhere) or **Take over recording** (for emergencies, when the recorder's computer is gone). |
 | **Phases** | Each phase and its gate's state by name ("Confirm deploy · Passed"), the day timeline and follow-ups. |
 | **Checklist** | Every step, with **Next up** pinned at the top. Step text shows the run's details: `Start the production deploy job v2026.10.16`, or `‹tag›` until the tag is set. A phase behind its gate offers **Preview steps**; a finished one folds to a tally with **Show steps**. Steps this run doesn't need fold into one line at the end of their phase ("1 step not needed"), each with its reason. |
-| **Selected step** | What to do (only when there's something to say), the values to copy, the evidence to record (**Fill in** only when there's something to fill in), then **Done**, **Done differently**, **Blocked** and **N/A**, and its corrections and notes. |
+| **Selected step** | What to do (only when there's something to say), the values to copy, the evidence to record (**Fill in** only when there's something to fill in), then **Done**, **Done differently**, **Blocked** and **N/A**, and its corrections and notes (the newest 20, with **Show 20 earlier**; a note you open from search is shown wherever it sorts). |
 
 Check the step Next up points at and the next one is selected, ready for **Space**. Typed evidence and unsent notes stay with their step while you move around. Notes and corrections take files (drop, paste or **Attach**): images, PDF, text and logs, CSV, JSON, YAML and .zip, up to 10 MB each. On a phone the checklist scrolls and a step opens as a full-screen sheet.
 
@@ -170,11 +170,11 @@ Every answer keeps who and when, and a re-check keeps the earlier answer as hist
 
 When the checklist is wrong mid-run, anyone can **Correct this step** (or press C): change its wording with a live Before/After, or choose **Change something else** for a missing step, the order, who does it, a screenshot or removing it, with files to show why. If you already did it another way, **Done differently** asks what happened and offers **Fix the checklist too**.
 
-<p align="center"><a href="https://github.com/troylar/flightdeck/blob/main/docs/images/correction-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/correction-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/correction-light.png" alt="Correct this step during a run: what the checklist says, the suggested wording, a Before/After redline, why, Attach for files, and Save correction" width="49%"></picture></a> <a href="https://github.com/troylar/flightdeck/blob/main/docs/images/corrections-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/corrections-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/corrections-light.png" alt="Corrections on the process page: a wording change suggested in two runs, with the runs listed, and a missing step, each with Review and apply, Mark as applied and Decline, then Copy correction brief" width="49%"></picture></a></p>
+<p align="center"><a href="https://github.com/troylar/flightdeck/blob/main/docs/images/correction-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/correction-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/correction-light.png" alt="Correct this step during a run: what the checklist says, the suggested wording, a Before/After redline, why, Attach for files, and Save correction" width="49%"></picture></a> <a href="https://github.com/troylar/flightdeck/blob/main/docs/images/corrections-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/corrections-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/corrections-light.png" alt="Corrections on the checklist's page: a wording change suggested in two runs, with the runs listed, and a missing step, each with Review and apply, Mark as applied and Decline, then Copy correction brief" width="49%"></picture></a></p>
 
-Corrections wait on the process page, grouped by step ("Suggested in 2 runs"). **Review and apply** shows what the run's version said, the draft now and the result side by side, and applies it to the draft as one change you can undo; you can also **Mark as applied**, **Decline** with a reason, or copy a correction brief for your AI assistant. The version that includes it records that, its runs show **Changed in v5** with **Why is this here?**, and Home tells whoever suggested it.
+Corrections wait on the checklist's page, grouped by step ("Suggested in 2 runs"), 50 suggestions at a time with **Show 50 more**; one a search or Home's **View change** opens is shown whatever the page. **Review and apply** shows what the run's version said, the draft now and the result side by side, and applies it to the draft as one change you can undo; you can also **Mark as applied**, **Decline** with a reason, or copy a correction brief for your AI assistant. The version that includes it records that, its runs show **Changed in v5** with **Why is this here?**, and Home tells whoever suggested it.
 
-**How runs go** shows typical time per phase, the steps that go off-script most, and who has held each role. **Flight plan** draws a version's shape: phases as waypoints, gates as checkpoints, tracks side by side, and, from its runs, typical times, autopilot (steps skills cover) and turbulence (steps that go off-script most).
+**How runs go** shows typical time per phase, the steps that go off-script most, and who has held each role. A big checklist shows 50 phases, 50 people and 20 roles at a time (**Show 20 more roles**), and **Compare versions** 20 versions at a time. **Flight plan** draws a version's shape: phases as waypoints, gates as checkpoints, tracks side by side, and, from its runs, typical times, autopilot (steps skills cover) and turbulence (steps that go off-script most).
 
 <p align="center"><a href="https://github.com/troylar/flightdeck/blob/main/docs/images/flight-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/flight-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/flight-light.png" alt="The release v1 as a flight plan: Start with autopilot, phases with typical times, turbulence notes and a connecting flight to Check in code, and gates as striped checkpoints" width="1000"></picture></a></p>
 
@@ -214,7 +214,7 @@ roles: release-lead, qa, backend
 
 | Mark | Means |
 |---|---|
-| `[!]` · `[ ]` · `[~]` | Must do · a step · automation planned |
+| `[!]` · `[ ]` · `[~]` | Must be done · a step · automation planned |
 | `READ-DO` · `DO-CONFIRM` | How a phase is worked; the app shows "Read, then do" and "Do, then confirm" |
 | `{type}` | The step's type, so it knows its fields and evidence ([Step types](#step-types)) |
 | `@role` · `^detail` | Who does it · a run detail it depends on (change the detail, redo the step) |
@@ -250,7 +250,7 @@ This is what Flightdeck is for. Outside the team it's usually called **SOP-to-sk
 
 <p align="center"><a href="https://github.com/troylar/flightdeck/blob/main/docs/images/trace-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/trace-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/trace-light.png" alt="Five steps from process to skill: prove it with 3 clean runs, the owner or backup owner signs it off, copy the brief, register the skill with its source and the steps it follows, and stay in step as new versions flag the skills they affect. Skill statuses: current, note version, needs an update, check it." width="1000"></picture></a></p>
 
-**1. Prove a version.** **Ready for a skill?** on the process page counts clean runs. A run is clean only when it ended Completed; every covered step was done; every gate on that work (and the one before it) was passed; nothing was blocked, re-checked, marked N/A or done differently, even in answers since archived; it has no unresolved conflict copies; and it kept a full record of deviations from its start (runs from before 1.9.0 can't show that). A step the run didn't need isn't held against it. A test run counts only for its staged version and the version made from exactly what was staged.
+**1. Prove a version.** **Ready for a skill?** on the checklist's page counts clean runs. A run is clean only when it ended Completed; every covered step was done; every gate on that work (and the one before it) was passed; nothing was blocked, re-checked, marked N/A or done differently, even in answers since archived; it has no unresolved conflict copies; and it kept a full record of deviations from its start (runs from before 1.9.0 can't show that). A step the run didn't need isn't held against it. A test run counts only for its staged version and the version made from exactly what was staged.
 
 **2. Sign off.** With three clean runs, the process owner signs the version off. The backup owner's sign-off counts too, recorded as the backup's, and Flightdeck offers it only while the owner is away (marked inactive or no longer on the team). A sign-off counts only for that exact published version, or, with **Sign off staged v3**, for the staged version and the version made from it.
 
@@ -285,7 +285,7 @@ flightdeck skill register ~/OneDrive/Team --from registration.json --json
 
 <p align="center"><a href="https://github.com/troylar/flightdeck/blob/main/docs/images/skills-traced-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/skills-traced-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/skills-traced-light.png" alt="A process goes from v1 to v2 and one step changes. Flightdeck checks the registered skills: release-deploy and release-notes need an update, pr-opener is current. The update brief for release-deploy shows the exact before and after for your AI assistant." width="1000"></picture></a></p>
 
-**Skills** lists every skill built from your processes, wherever it lives, and which need an update. **A skill** says what changed under it and gives your AI assistant the exact before and after.
+**Skills** lists every skill built from your processes, wherever it lives, and which need an update, with **Find a skill** (by name, checklist or tag). **A skill** says what changed under it and gives your AI assistant the exact before and after.
 
 <p align="center"><a href="https://github.com/troylar/flightdeck/blob/main/docs/images/skills-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/skills-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/skills-light.png" alt="Skills: two skills that need an update, then every skill in the team hierarchy with a tag filter" width="49%"></picture></a> <a href="https://github.com/troylar/flightdeck/blob/main/docs/images/skill-light.png" title="Open in GitHub's image viewer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/skill-dark.png"><img src="https://raw.githubusercontent.com/troylar/flightdeck/main/docs/images/skill-light.png" alt="The release-deploy skill: needs update because one of its steps changed in v2, with Copy the update brief, where the skill lives and which steps it covers" width="49%"></picture></a></p>
 
@@ -337,7 +337,7 @@ AGENTS.md              the rules any AI assistant follows in this folder (your o
 
 ### How big a folder can get
 
-Thousands of runs open and refresh without stalling. **Settings → Folder health** watches these sizes. None of them locks anything; each says what to do, and [The folder is getting big](https://github.com/troylar/flightdeck/blob/main/docs/recovery.md#the-folder-is-getting-big) has the steps.
+Thousands of runs open and refresh without stalling. Long lists show a page at a time with **Show more**, and the ones you look things up in have a **Find** box: Checklists, Skills, Follow-ups and **Settings → People** (in name order). **Settings → Folder health** watches these sizes, 50 problems a section at a time. None of them locks anything; each says what to do, and [The folder is getting big](https://github.com/troylar/flightdeck/blob/main/docs/recovery.md#the-folder-is-getting-big) has the steps.
 
 | Size | What happens |
 |---|---|