docs(agents): errors surface through OpenTelemetry, not global slog

This commit is contained in:
sam committed 2026-10-27 20:51:52 +11:00
1 parent 004e38b8eb
commit 1cd8955d23
1 file changed
+2
+2
View File
@@ -100,6 +100,8 @@ When sources disagree, the higher one wins:
`infrastructure` implements `domain` interfaces, `domain` imports neither.
`cmd/` parses flags and calls `app`, nothing else.
- Fix invalid state where it is produced, not with checks where it is consumed.
- Errors surface through OpenTelemetry: record them on the request's span
(`trace.SpanFromContext(ctx).RecordError`), never the global `slog`.
- If a fix fails twice, throw the block away and rewrite it simply.
- Comments say why, briefly. No migration history, phase names or issue
narration in code.