Brief: testing instructions at the tool boundary
Type: types/write-brief.md
Intent
The operator commissioned this revision on 2026-11-08 during the frontier-work reconsideration. Explain what tool mocking makes observable that checking a final artifact alone would miss.
Must keep
- One concrete, generic discovery-only example, with controlled search results and captured attempted writes.
- The limits of isolation and mock fidelity; mocking is not the only testing route.
Must exclude
- Commonplace's tool inventory, search policy, or reasons for removing a search dependency. These are local details, not part of this claim.
- A test-harness design, unsupported fixture sizes, or generic testing advice added merely to expand the note.