Arguments
Source text. Post-mortem, debug session transcript, retro notes, or any text containing lessons learned.
Optional canonical entity name for the caveats.
Output format
Caveat writing rules
Each caveat must:- Start with a verb: “Never”, “Always”, “Watch out”, “Check”, “Verify”
- Be one sentence — concise and actionable
- Be concrete — include specific names, numbers, conditions
- Capture something painful — things the reader does NOT want to relearn