Close
Closing is not paperwork. It is the step that makes the next session cheap and stops
the same work from being done twice.
1 · Audit before you close
Dispatch the loop-auditor agent on the full diff, with the item's
non-negotiables from .loop/STATE.md. Its job is to refute. Iterate until there are
zero CONFIRMED findings — and do that before anything is published, not after.
If the auditor finds a real bug, also look for the class of that bug: search for
its siblings elsewhere in the codebase and close them in the same session, or record
them as their own items. One fixed instance and three live ones is not a fix.
2 · Commit
- Stage only your own files. Never
git add -A when someone else has
uncommitted work in the tree.
- A descriptive message: what changed and why, not "fixes".
- On the working branch. Never the protected branch — publishing is the owner's
action, and it stays that way even when it is obviously fine.
- Team mode: open the pull request, make sure CI is green, assign a reviewer. Done
means merged, not "it works on my machine".
3 · Write the record
.loop/STATE.md — item to [x] plus one line of what was verified and how.
Anything unverified becomes GAP: <why>. Anything blocked becomes
PARKED: <why> + exactly what is missing..loop/DECISIONS.md — any real choice made, with the rejected alternative..loop/GOTCHAS.md — anything that fooled you: the symptom, why it was convincing,
and how to detect it next time. This file is the compound interest of the method.
4 · Report honestly
Three lists, no softening:
- Verified — with what you observed for each, in one line.
- Gaps — what is not verified and why (a missing access, no browser, no test
environment). Never dress a gap as done.
- Blocked on the owner — a key, real money, a business or legal decision, or
permission to publish. State the exact thing needed, not a vague ask.
If something failed, say it failed and show the output. A report that reads better
than the work is the one failure this method cannot recover from.
5 · Hand off
Leave .loop/STATE.md so the next session needs no instructions: the next unchecked
item is next, and the command to run it is written beside it. Print that command.
1---2name: loop-close3description: Closes a slice or a session - adversarial audit of the diff, ledger entry, selective commit, honest report, and the handoff for the next session. Use before considering anything finished.4---56# Close78Closing is not paperwork. It is the step that makes the next session cheap and stops9the same work from being done twice.1011## 1 · Audit before you close1213Dispatch the **`loop-auditor`** agent on the full diff, with the item's14non-negotiables from `.loop/STATE.md`. Its job is to refute. Iterate until there are15**zero CONFIRMED findings** — and do that *before* anything is published, not after.1617If the auditor finds a real bug, also look for **the class of that bug**: search for18its siblings elsewhere in the codebase and close them in the same session, or record19them as their own items. One fixed instance and three live ones is not a fix.2021## 2 · Commit2223- Stage **only your own files**. Never `git add -A` when someone else has24 uncommitted work in the tree.25- A descriptive message: what changed and why, not "fixes".26- On the working branch. **Never the protected branch** — publishing is the owner's27 action, and it stays that way even when it is obviously fine.28- Team mode: open the pull request, make sure CI is green, assign a reviewer. Done29 means merged, not "it works on my machine".3031## 3 · Write the record3233- `.loop/STATE.md` — item to `[x]` plus one line of *what was verified and how*.34 Anything unverified becomes `GAP: <why>`. Anything blocked becomes35 `PARKED: <why> + exactly what is missing`.36- `.loop/DECISIONS.md` — any real choice made, with the rejected alternative.37- `.loop/GOTCHAS.md` — anything that fooled you: the symptom, why it was convincing,38 and how to detect it next time. This file is the compound interest of the method.3940## 4 · Report honestly4142Three lists, no softening:4344- **Verified** — with what you observed for each, in one line.45- **Gaps** — what is not verified and why (a missing access, no browser, no test46 environment). Never dress a gap as done.47- **Blocked on the owner** — a key, real money, a business or legal decision, or48 permission to publish. State the exact thing needed, not a vague ask.4950If something failed, say it failed and show the output. A report that reads better51than the work is the one failure this method cannot recover from.5253## 5 · Hand off5455Leave `.loop/STATE.md` so the next session needs no instructions: the next unchecked56item is next, and the command to run it is written beside it. Print that command.
cbdreamer11