Three Kinds of Error, and Optional Steps Never Block
A blocked memo is the worst outcome. Every error says whether MemoPop is down, the request is wrong, or the step can be skipped.
- Path
- decisions/Three-Kinds-of-Error-and-Optional-Steps-Never-Block.md
- Authors
- Michael Staton
- Augmented with
- Claude Code on Claude Opus 5.5 (1M context)
- Tags
- Decision · MemoPop · Error-Handling · API-Design
Three Kinds of Error, and Optional Steps Never Block
The decision
Every error belongs to one of three kinds, and each kind tells Claude exactly what to do:
| Kind | Means | Claude should |
|---|---|---|
| Down | MemoPop is unreachable, timed out, or failed on our side. Nothing was saved | Tell the partner MemoPop is unavailable and try again later. Never retry in a tight loop |
| Invalid | The request is wrong: bad input, unknown deal, wrong firm, a step submitted out of order | Fix the request using the message, or ask the partner for what’s missing. Never resend it unchanged |
| Skipped | One step’s agent is out of service, but the memo can go on without it | Tell the partner in one line and call next_step. The run continues |
Optional steps skip; they never block. Every enhancement (citations,
tables, diagrams, the one-pager, scoring) is optional. The server records
each skip on the deal: list_deals shows it, the compiled memo’s run report
lists it, and the step can be re-run once its agent is back.
Only required steps may block, and the list stays short: creating the deal, submitting a section’s research, submitting a section’s draft, and compiling. Even then, a “down” error costs nothing, because nothing was saved and the partner picks up where they left off.
Tests cover each kind. CI checks that every failure returns the right kind, and that switching off any optional agent produces a skip rather than a block.
Decided 2026-10-10 by Michael Staton.
Why
A partner mid-memo, with Claude stopped and nothing useful to say, is the worst experience the product can give. Most failures don’t need to stop the memo; they only need to be recorded so the step can be run again later.
Still open
Whether a section’s research may also be skipped, with Claude drafting from the partner’s materials alone.
Related
- [[MemoPop-as-a-Claude-Connector]] — the exploration this came from
- [[No-Tool-Ships-Without-Its-Docs-and-Tests]] — the error format every tool uses
- [[The-Server-Hands-Claude-the-Method-One-Step-at-a-Time]] — the steps that can skip or block