The world’s shortest project brief
You open a new coding session. The previous one left an impressive amount of code and the instruction “continue.” Continue what? The feature? The failing test? The optimistic interpretation of “done”?
Bob has seventeen tabs open and a very reasonable question: could the last session have left a note instead of a mystery?
Leave a checkpoint, not a transcript
Before changing sessions or tools, write a small handoff in the project’s approved workspace. You do not need to paste every message. You need enough evidence for the next person or agent to understand the work.
Record the intended outcome, the files changed, the checks actually run, and the unresolved decision. Keep “not run” separate from “passed.” A command suggested by an agent is not evidence that the command succeeded.
A five-line handoff
Outcome: what should the user be able to do?
Changed: which files or commit contain the work?
Verified: which checks ran, and where is the result?
Open: what failed, remains untested, or needs a decision?
Next: what is the smallest authorized action to take?
Try it on a disposable example
Use a small sample repository with no employer secrets or customer data. Make a trivial change, run the appropriate check, and write the five lines. Start a fresh session and ask it to read the handoff before proposing its next action.
Review the proposal yourself. Does it understand the target? Does it distinguish evidence from intention? Does it stay within the scope you approved? This is a repeatable exercise, not proof of a production outcome or a measured time saving.
The next session does not inherit permission
A handoff should never contain tokens, passwords or private customer records. Refer to approved locations instead of copying confidential material. Credentials and system access still follow the permissions of the environment.
The handoff helps explain what happened. It does not authorize a deployment, a purchase, a new integration, or a change to production. Keep the human decision visible.
Bob’s closing note
“Continue” is a word. A handoff is a courtesy.
FRIEDBOB focuses on the working experience around Claude Code and Codex. Better Work is the wider home for the humans doing the work. This field note is available in full on the web; no email subscription is required.