docs(topics): supersede channel-adapters Gap 5 — channels ship the native feed trigger

[kyle-sexton]

Summary

docs/topics/ai-adoption-ladder/design/RESEARCH-channel-adapters.md Gap 5 (committed 2026-07-18, confidence HIGH) claimed Anthropic offers no Datadog/PagerDuty-style feed trigger for Claude Code, making a Claude-driven feed-monitor DIY-only (webhook → claude -p). The live docs now document exactly that natively: Claude Code channels (research preview) push external events into an already-running session — an MCP server declaring the claude/channel capability emits notifications/claude/channel events (delivered as a <channel> tag), opted in per session with --channels, with a first-party webhook-receiver walkthrough, two-way reply tools, sender-allowlist gating, and remote permission relay.

This PR appends a dated SUPERSEDED note at the Gap 5 site, following the dated-inline correction precedent in this design directory (design-threads.md); the original text is preserved unmodified. The note also records the supersession's bounds (research preview, Anthropic-auth only, session-open delivery, channelsEnabled org gating, dev-flag requirement for custom channels), so §c's DIY-floor statement stands.

Sources (live-fetched 2026-08-04, byte-stable across double-fetch):

• https://code.claude.com/docs/en/channels
• https://code.claude.com/docs/en/channels-reference

Verification: fresh-context Fable verifier VERIFIED 4/4 (claim-by-claim accuracy vs independently fetched live pages, precedent form, append-only single-line diff, markdownlint clean).

No linked issue

Related

• Doc-alignment roster rows 63 (channels) and 64 (channels-reference), escalated by batch B10 on 2026-08-04.

🤖 Generated with Claude Code

[cursor]

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

[claude]

Claude finished @kyle-sexton's task in 2m 13s —— View job

---

Review complete

• Gather context (diff, CLAUDE.md, referenced sources)
• Understand the request (code review of the single-line doc change)
• Review for correctness and alignment with CLAUDE.md / fresh-docs mandate
• Post findings

Scope: single line appended to docs/topics/ai-adoption-ladder/design/RESEARCH-channel-adapters.md (Gap 5), no other files touched.

Verification performed: live-fetched both cited sources (code.claude.com/docs/en/channels, code.claude.com/docs/en/channels-reference) and checked every factual claim in the added sentence against them:

• claude/channel experimental capability + notifications/claude/channel event, delivered as a <channel> tag — confirmed in Channels reference § What you need / § Notification format.
• --channels plugin:<name>@<marketplace> opt-in syntax — confirmed (e.g. claude --channels plugin:telegram@claude-plugins-official).
• The quoted webhook-receiver line ("a webhook from CI, your error tracker, a deploy pipeline...") — exact quote from Channels § How channels compare.
• Two-way reply tools, sender-allowlist gating, claude/channel/permission relay — all confirmed in the reference page.
• Bounds: research preview + flags hidden from claude --help, Anthropic-auth-only (not Bedrock/Google Agent Platform/Microsoft Foundry), session-open-only delivery, channelsEnabled org gating, --dangerously-load-development-channels for custom channels — all confirmed against the live "Research preview" and "Enterprise controls" sections.

No inaccuracies found; nothing in the added text overstates or misreads the source pages.

Precedent/style:

• Matches the dated-inline SUPERSEDED YYYY-MM-DD (...): ... correction format already used at design-threads.md:182 — same 3-space continuation indent under the numbered list item, original text left untouched (pure append, +1/-0).
• §c (referenced in "so §c's floor statement stands") exists in this same document (## Synthesis § (c) Entitlement gating vs. the free/universal floor, line 81) and its net-floor statement (line 99) does support the claim — the cross-reference resolves correctly.
• Straight quotes and spaced em-dashes used are consistent with the rest of the document; MD013 (line length) is disabled repo-wide so the long single line isn't a lint issue.
• Today's date (2026-08-04) matches the SUPERSEDED date stamp.

CLAUDE.md alignment: this is a prose research-doc correction, not a change to a plugin manifest/marketplace schema/hook contract/harness-documented surface, so the fresh-docs mandate's mandatory-citation rule doesn't strictly gate it — but the PR follows it anyway (dated, sourced, byte-stable double-fetch noted), which is good practice for a supersession note like this.

No correctness, architecture, or maintainability issues found. This is a clean, well-scoped, well-verified documentation fix.

[github-actions]

Claude has reviewed this PR 1 time. The lane skips further automatic reviews after 5; deleting this comment resets the count.