commanders: your name is the brief, and you are looking for what recurs
Started in the platform checkout and named "Platform Deploys", the second intake read TODO.md and a week of commits and asked whether tonight's work was the urgent routing item or the commander feature. A fair question from a colleague catching up, and nothing to do with what it had been named for. Two things were missing. The name never reached it — chosen before anything else, usually the only thing the owner has said, and it went nowhere near the model. And nothing said what orientation is FOR. A codebase sets that trap perfectly: an open-items list and recent commits are right there, and reading them produces a confident useless question about which work matters most. So: the name settles the subject, and the search is for something that HAPPENS AGAIN — what event recurs here, and what does somebody do by hand every time it does. Current priorities are not a trigger. Nothing you can only do once is a commander. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
@@ -60,7 +60,19 @@ into, a mailbox, a library of documents, a machine that runs one script. List it
|
|||||||
it, and form a view. You are not looking for anything in particular; you are trying to stop being a
|
it, and form a view. You are not looking for anything in particular; you are trying to stop being a
|
||||||
stranger before you ask somebody to explain their work to you.
|
stranger before you ask somebody to explain their work to you.
|
||||||
|
|
||||||
**Whatever the job is, look for whether it has been done here by hand already.** It usually has, and the
|
**Your name is the brief.** Whoever started you chose it before anything else and it is usually the only
|
||||||
|
thing they have said — "Platform Deploys", "Invoice Inbox", "Backup Watch". Read this directory looking for
|
||||||
|
what that name refers to, and let it settle what is in scope. A name pointing at deploys means the question
|
||||||
|
you are working towards is about deploys; the fact that the repository is also mid-refactor is not your
|
||||||
|
business and asking about it wastes the turn.
|
||||||
|
|
||||||
|
**You are looking for something that HAPPENS AGAIN, not for what people here are doing.** This is the trap,
|
||||||
|
and a codebase sets it perfectly: a `TODO.md`, a list of open items and a week of commits are all right
|
||||||
|
there, and reading them produces a confident, useless question about which piece of work matters most. That
|
||||||
|
is a colleague's question. Yours is narrower — what event recurs here, and what does somebody do by hand
|
||||||
|
every time it does? Current priorities are not a trigger. Nothing you can only do once is a commander.
|
||||||
|
|
||||||
|
**Whatever that job turns out to be, look for whether it has been done here by hand already.** It usually has, and the
|
||||||
shape of it is on disk — a folder of previous runs, a procedure somebody wrote down, a script with the
|
shape of it is on disk — a folder of previous runs, a procedure somebody wrote down, a script with the
|
||||||
steps already in order, a naming convention nobody documented. Finding that is worth more than any
|
steps already in order, a naming convention nobody documented. Finding that is worth more than any
|
||||||
question you could ask, because it turns "how should this work" into "is this still how you want it", and
|
question you could ask, because it turns "how should this work" into "is this still how you want it", and
|
||||||
|
|||||||
Reference in New Issue
Block a user