Skip to content

Commit 75797a2

Browse files
committed
Document explicit sad-path expectations
1 parent d20c578 commit 75797a2

1 file changed

Lines changed: 4 additions & 0 deletions

File tree

AGENTS.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,10 @@ without hard-coding knowledge of any one repository.
4242
for line-oriented supervised output, source labeling, and output/state
4343
extraction through pipes rather than PTY emulation or full-screen
4444
terminal behavior.
45+
- Silent failure is unacceptable. Every user-visible path should have a
46+
corresponding sad path with explicit, observable failure behavior:
47+
non-zero exits, surfaced errors, timeouts, logs, or other signals
48+
that make the failure diagnosable instead of disappearing quietly.
4549
- When forwarding inherited process output, prefer visible output over
4650
suppressing noise. Carriage-return-driven updates should be rendered
4751
as visible labeled lines; if a tool is too noisy, fix that at the

0 commit comments

Comments
 (0)