Agree on what you are building, in writing, before an agent builds it.
Ask an AI agent to build something and it will. The trouble starts one step earlier: you and it never wrote down what "it" was. So the agent guesses, guesses reasonably, and you find out three files later.
flw settles that first. You have a conversation, and the conversation becomes a file that says what will be true when the work is done. A second agent builds against that file, and anything it finds missing comes back as a question rather than an invention.
It is four workflow skills your AI coding assistant loads, plus a small command-line tool. It intercepts nothing, runs nothing in the background, and never declares work finished — that judgment stays yours.
Any project, any language. Nothing chains automatically: you drive each step, and each one leaves something on disk you can read.
One file per project. It describes what is true when the work is done — the parts the software has, what each promises, and how you would know one was broken.
One file per change. It records how the destination moved this time: what was decided and why, what was rejected, and the ordered list of work.
Agents forget everything between sessions. These are the three kinds of memory flw keeps, held apart on purpose — mixing them is how notes go stale without anyone noticing.
| where | what it holds | what makes it wrong |
|---|---|---|
| .flw/extensions/ | House rules for this repo — conventions, how you like things done. | A human changes their mind. |
| flw know | What the code is built of and what connects to what, filed by location. | Someone changes the structure. |
| flw kb | Hard-won craft that travels — a library's quirk, a trap somebody measured. | Rarely anything. |
Unsure where something goes? Ask whether a commit could make it wrong. If yes, it is knowledge. If only a decision could make it wrong, it is a house rule.
Anything where you would be annoyed to find out afterwards that the agent understood it differently. Anything more than one person will touch.
If there is no contract yet and nobody asked for one, just do the work. flw is a way to agree, not a tax on every edit.