Build agents the telemetry-native way

Canon: kb/167_unified_telemetry_observability.md
Runtime: kb/55_multi_agent_runtime_architecture.md

Living proof

• packages/agents-reference — every reference agent demonstrates HumanError + at least one guarded ctx.telemetry.emit where it teaches control flow.
• apps/api/src/agents/cp/ — platform agents follow the same standard.
• packages/cli templates — commented canonical pattern in generated handlers.
• SDKs — @human/client-sdk, @human/sdk, sdk-go expose author-emit helpers aligned with OpenAPI.

Author checklist

1. Throw HumanError (or mapped errors) with stable code.
2. Emit telemetry.author.* when the platform would otherwise be blind (recovered paths, domain warnings).
3. Subscribe webhooks or use CP wizard profiles for external sinks — do not hardcode vendor SDKs in business logic.

Deeper how-to

See telemetry-for-agents.md and telemetry-connectors-rollout.md.

Series

• Previous: Escalations & remediation
• Start of series: Unified telemetry overview