Skip to content

observability lens

Tribunal lens card. This is not a standalone agent: when the /ca:tribunal deep audit activates the observability lens, the generic tribunal-lens-reviewer agent is dispatched once under the observability assignment and executes this card as its mandate.

Executed by tribunal-lens-reviewer under the observability assignment.

Find failures operators or callers cannot diagnose, correlate or recover from despite an applicable operational or audit obligation.

The product’s operating model requires diagnosis, correlation, security/audit events or failure visibility at the assigned boundary.

Local libraries or pure helpers with no operational/diagnostic contract need not have tracing or metrics. Record a skip when diagnosis is adequately owned by the caller and no separate obligation applies.

Critical failure/recovery paths and service/async boundaries where actionable reason, correlation or audit completeness is required.

  • Finding record (the installed plugin’s skills/tribunal/references/finding-record.md) and review risk (the installed plugin’s skills/tribunal/references/review-risk.md).
  • the repository’s .codearbiter/tech-stack.md — logging/tracing/metrics stack and operating model; applicable runbook/audit contracts and inventory boundaries.

Inspect event/error emission, correlation propagation and diagnostic consumers. Compare declared event requirements with existing logging/audit tests and operational evidence; event counts do not prove diagnostic usefulness.

  • Can an operator distinguish the critical failure reason and select recovery?
  • Is required correlation preserved across the actual async/service boundary?
  • Are security/audit outcomes complete enough for the declared forensic purpose?
  • Are diagnostic details bounded and appropriate to the recipient?
  • Does a suppressed or misleading success signal hide a relevant failure mode?

No universal tracing, structured-logging or metrics requirement applies. Central instrumentation and returned errors may satisfy a boundary’s obligation. Do not propose logging every call or emitting duplicate diagnostics without showing which real failure would remain undiagnosable.

Cite the required operational/audit obligation, failure scenario and unavailable diagnostic or recovery decision. For missing signals, state the search universe and ownership trace through emitters, middleware, collectors and callers; include available evidence about retention/visibility without assuming remote settings.

Count of applicable failure/audit boundary paths whose diagnostic outcome was traced, not raw log statements.

Send sensitive-data logging to secrets-supply and the underlying lost operation to reliability. Keep a diagnostic consequence as corroboration when it shares the same root failure rather than filing duplicate findings.

Tracing for its own sake, correctness of the logged operation, and independent secret disclosure findings.