UI Copy

First rule: write to the person, never about the system. Every string answers "what does this mean for me and what can I do now?", never "what state is the code in?". A string that narrates internal state, preconditions, or implementation progress is a log line, not copy, even when it is accurate. Before any rule below, reread the string as the user and ask what they would do next. Workspace setup is running independently. No session has started. → Setting up your workspace. Your session starts when it finishes. Worktree configuration is required to use "Now". → Add a workspace config to create worktrees now. Task creation sync timed out → Could not confirm the task was created. Check the task list before retrying. Comment sync still loading → Comments are loading. Workspace setup row is parked on an error → Workspace setup failed. Converging, Delivery rejected: … → never.

Voice: a competent colleague at the next desk. Says the actual thing, names the key, admits limits. Never apologizes, sells, or shouts. Model string: Updating will interrupt 3 active sessions on this device. Finish your work before updating, or choose Later.

Changing a string that already ships

Writing a new string: apply everything below. Changing one that exists: read this first. A rule matching a line is not on its own a reason to rewrite it.