Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Glossary

The words of the design, each defined once. sounding has no statement yet, so the capture design (design/capture/design.md) is the binding copy. The words of millpond and of crew are millpond’s book’s, word for word. A number in parentheses cites Flywheel’s statement.

Four words mean one thing in another book and another here. A capture’s source names where its event came from, such as release, while a question’s sources are the material it starts from. millpond’s drop is a move on a signal, while sounding’s is the operator’s answer to a conclusion. The signal kind ask is one of five kinds, while sounding ask is an exit. A signal’s kind is its type, while flume’s is a list of stages, and flume’s kind question is the one that runs a sounding’s session. Each word keeps its meaning in the book it belongs to.

sounding’s words

wordmeaning
acceptthe operator’s answer that settles a conclusion’s item: millpond keeps the conclusion as the item’s record, and each piece of work it proposes becomes an item, or an entry in crew’s plan
asksounding ask: the exit that puts a question only the operator can answer on a card; the session waits for the answer
carda question or a decision put to the operator outside the session’s pane, and answered once
concludesounding conclude: the exit that writes conclusion.md and ends the round
conclusionwhat a sounding ends on: the answer, its evidence, what it would change, the work it proposes and what stays open; the operator accepts it, sends it back for another round, or drops it
dropthe operator’s answer that records the reason and removes the sounding’s worktree
exitone of the three commands through which a session reaches beyond its place: conclude, offer and ask (65)
findingsomething a session learns beyond its question; an offer hands it to millpond as a capture (58)
go onthe operator’s answer that starts the next round in the same worktree: the conclusion moves to rounds/<n>.md and the operator’s notes join the question; the herdr plugin’s send back
offersounding offer: the exit that hands a finding beyond the question to millpond land as a capture of its own, its own excerpt, of kind ask, asserted by the sounding, under the key sounding/<name>/<n> (62); the session goes on
parkedthe state of a sounding whose session is neither working nor waiting on the operator
placea sounding’s worktree of the repository its question is about, on the branch sounding/<name>, which flume makes and runs as the kind question
questionwhat a sounding works: one question whose answer the operator decides before the work it implies begins; sounding open writes it with its sources into question.md
recordan accepted conclusion as millpond keeps it on its item; curation names it when it answers a later signal on the subject (116)
roundone session’s run at the question, from its start hook to its conclusion; go on starts the next
soundingone question, worked by one session in one place, ending on one conclusion; also the tool that runs them
sourcesa question’s material: the item’s signals, the captures they came from, any earlier conclusion on the subject, and what /sound names
start hookthe Claude Code plugin’s hook that hands a round’s session its question, its sources and its earlier rounds
stop checkthe hook at a session’s end that sends it back unless it wrote a conclusion or a note saying where the next round would start
timeboxthe limit on one round’s length; when it runs out, the session concludes with what it knows
unattendedthe way of running in which the session works alone and each round ends on a card
waiting on the operatorthe state of a sounding whose conclusion, or whose ask, the operator has not answered
with the operator--with-me: the way of running in which the session works in a pane beside the operator as a conversation
workingthe state of a sounding whose session is working its round

Flywheel’s words

wordmeaning
elaborationin Flywheel, one unit of design work on an intent, worked by one free-flowing session; each one is a sounding (24)
elaboration typein Flywheel, what decides how an elaboration ends; it writes what the elaboration concludes to the design book and its claims (25, 187)
intentin Flywheel, one thread of design work about one subject, pursued until the operator closes it

Words from flume’s book

flume’s book defines these, and this page gives its definitions word for word.

wordmeaning
flumethe tool that launches and tracks one agent in one worktree through a kind’s stages, on the host it runs on, and tidies the place when the work lands or is dropped (its book)
kind (flume’s)a list of stages, each naming its prompt and its deliverable: fix, change, question, or one a repository declares

Words from millpond’s book

millpond’s book defines these, and this page gives its definitions word for word.

wordmeaning
answeredthe move that names the claim or record that settled a signal
boltin crew, a team’s branch of work: its units and chores land on it, and it lands on the shared branch
capturethe record of one source event: its key, its source, its event date and a pointer to its raw material; the same event captured twice is one capture (111)
capture contractthe JSON Lines an adapter prints and every host takes, each line holding exactly one of capture, cursor or done
chorein crew, a piece of work that needs no design of its own, such as a tool’s bump; a route move offers one
claimin Flywheel, a standing statement of what a repository must satisfy; answered and challenge name one
conformance packcontract lines and the records a host must write from them, with the meeting checks; every host and every adapter part passes it
curationa Claude session that proposes one move per signal, in batches, through millpond’s tools; the operator accepts or changes each batch (116)
excerptthe verbatim text a signal quotes from its source, with its position (113)
inboxa git repository, or a branch in one, holding captures, signals, moves and items in Flywheel’s record formats
itemthe unit of work: the signals curation joined, one or many, with its brief and its sends; Flywheel’s proposed intent (109)
jointhe move that makes an item from signals, or grows one still proposed
keya source event’s identity, the same from every host and every run (111)
kinda signal’s type, one of constraint, ask, question, commitment and reaction (113); the kind a send names, a fix or a change, is flume’s word for a list of stages
movethe one standing decision on a signal: drop, answered, challenge, join, attach or route, each with a stated consequence (107, 116)
operatorthe person who accepts or changes each batch of moves, sends items, and decides each conclusion; on its own, the user
own excerpta capture is its own excerpt when its line carries the signal’s fields, so millpond writes its one signal as it lands; a release is one
plannercrew’s agent that orders items across teams and turns each into a chore or a unit
pluginthe installable unit in every host, holding parts; Flywheel’s statement calls it a package, and a named set of parts a bundle (228, 284)
raw materialthe event as its source served it, whole: notes, a transcript, a log; the adapter writes it as raw files
sendmillpond giving one item to flume, as a fix or a change with its brief, or an item that asks a question to a sounding
signalone assertion from a capture: its kind, who asserted it, its subjects, the assertion in a sentence, the verbatim excerpt with its position, and the claims it argues with; never changed once written (113)
unitin crew, one designed piece of a team’s work, landed on its bolt
unmoveda signal with no move yet