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 bf7ac6535c
commit 31ec7deb29
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.