Red Flags and Decision Cheat Sheets

A small naming issue is usually less important than missing reasoning.

An answer is difficult to evaluate when important details are missing:

• the caller never appears;
• the resource model copies storage;
• operations have names but no behavior;
• failures remain "an error";
• retries remain "we retry"; or
• choices appear without triggers and costs.

This lesson is a final repair guide.

The first section describes eight common weaknesses. The remaining sections summarize recurring choices, the requirements that justify them, and their costs