diff --git a/assets/SKILL.md b/assets/SKILL.md index 9b5bb9f..07d9bff 100644 --- a/assets/SKILL.md +++ b/assets/SKILL.md @@ -365,30 +365,33 @@ Read the block before picking a ticket up: it says whether somebody has already ## Who your entries are attributed to -Every comment carries an author, and by default that is the git user of the machine you -are running on, which is the human whose checkout it is and not you. Set -`WORKLANE_ACTOR` in your own environment and it becomes the author of every entry you -write, so a board several agents write to says which of them said what: +Every entry carries an author, and yours comes from `WORKLANE_ACTOR`, which your harness +sets before you run anything. **Assume it is set for you, and never spell yourself out on +a call** — a plain `worklane comment` is already attributed to you, which is what keeps a +board several agents write to saying which of them said what. It is configured once, +where your session's environment lives: `env` in `~/.claude/settings.json` for Claude +Code, and the environment opencode is started with for opencode, since it passes its own +environment to the tools it runs. + +**Reach for `--actor` only when the entry is somebody else's action**: the person asked +you to move a ticket, or to put words on the board as their comment, so name them on the +flag — the move was theirs and the words are theirs, and an entry carrying your name +reads later as though you decided both. Otherwise leave it off, unless your instructions +say to use it. It is spelled the same on every command that writes an entry: `comment`, +`mv`, `chown`, `set` and `assign`. ``` -WORKLANE_ACTOR=claude worklane comment 1b78a24 "The offset was never passed to the widget." +worklane mv 1b78a24 --status done --actor "Ansho Rei" ``` -Set it once where your session's environment is configured, not on each call: `env` in -`~/.claude/settings.json` for Claude Code, and the environment opencode is started with -for opencode, since it passes its own environment to the tools it runs. `--actor` -overrides it for one call and is spelled the same on every command that writes an entry, -`comment`, `mv`, `chown`, `set` and `assign`. An empty value counts as unset and falls -back to the -git user, and with nothing at all the author is `unknown`. It is free text, checked -against nothing: name yourself something a person reading the board will recognise. +Under a missing or empty variable the author falls back to the git user of the machine — +the human whose checkout it is — and with neither, `unknown`. It is free text, checked +against nothing: whatever name you pass, make it one a person reading the board will +recognise. On `chown`, `--actor` is not the user argument: `worklane chown alice 1b78a24` makes alice the ticket's owner, and `--actor` says who made that change. -If the variable is not set and you cannot set it, pass `--actor` rather than letting the -comment claim to be the user's. - ## Shell completions ```