Skip to content

chore(alerts): add contents to the insight alert payload reference - #131430

Merged
trunk-io[bot] merged 1 commit into
masterfrom
posthog/insight-alert-payloads-contents
Nov 7, 2026
Merged

chore(alerts): add contents to the insight alert payload reference#131430
trunk-io[bot] merged 1 commit into
masterfrom
posthog/insight-alert-payloads-contents

Conversation

@posthog

@posthog posthog Bot commented Nov 7, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Problem

  • Agents who follow the authoring-insight-alerts skill to its payload reference must scan a 200-line file to find a detector or insight-kind payload.
  • The skill sends readers there in step 2 and step 5, so this is the normal authoring path.

Origin

  • Scout: a custom scout
  • First signal: 2026-11-07
  • Inbox report: open
  • Task started by: a person, from the inbox

Changes

  • The payload reference now opens with a linked contents list of its six sections and their subsections.
  • Docs only, with no code change.

How did you test this code?

  • A script checked that every contents link resolves to a heading in the file.

Test rationale: No test is needed for a Markdown navigation change.

Release status

  • No feature flag controls this change

Docs update

  • None.

🤖 Agent context

Autonomy: Fully autonomous

Agent: Claude Code, claude-opus-5-5

Skills: /writing-pr-descriptions

More context for AI agents
  • Session: PostHog Desktop task from a self-driving inbox report; tools used were the PostHog MCP, git and gh.
  • Decisions: The contents list follows the linked style that other skill references in products/ use, and it does not split the file.

Created with PostHog Desktop from an inbox report

🤖 Generated with Claude Code

@posthog
chore(alerts): add contents to the insight alert payload reference
90c1e78 
The payload reference for the authoring-insight-alerts skill runs past 200 lines, so agents sent there from the skill had to scan the whole file to find a detector or insight-kind payload.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Generated-By: PostHog Desktop
Task-Id: a5b90828-2184-4f2f-8ce8-b6a155f5671a
@posthog posthog Bot added skip-agent-review Save $$$, skip auto agent reviews (Greptile) — use for trivial or chore PRs self-driving labels Nov 7, 2026
@trunk-io

trunk-io Bot commented Nov 7, 2026 •
edited
Loading

Copy link
Copy Markdown

😎 Merged successfully - details.

@posthog
posthog Bot marked this pull request as ready for review November 7, 2026 23:09
@posthog
posthog Bot requested a review from andrewm4894 November 7, 2026 23:09
@stamphog
stamphog Bot requested a review from a team November 7, 2026 23:09
@github-actions

github-actions Bot commented Nov 7, 2026

Copy link
Copy Markdown
Contributor

🤖 CI report

⚠️ Trunk lane — backend Python lane

This PR is assigned to the backend Python lane. It runs backend Python tests and may merge in parallel with PRs in other lanes.

@andrewm4894

andrewm4894 commented Nov 7, 2026

Copy link
Copy Markdown
Member

/trunk merge

@trunk-io
trunk-io Bot merged commit 36269b1 into master Nov 7, 2026
301 of 341 checks passed
@trunk-io
trunk-io Bot deleted the posthog/insight-alert-payloads-contents branch November 7, 2026 23:39
@deployment-status-posthog

deployment-status-posthog Bot commented Nov 8, 2026 •
edited
Loading

Copy link
Copy Markdown

Deploy status

Environment Status Deployed At Workflow
dev ✅ Deployed 2026-11-08 00:00 UTC Run
prod-us ✅ Deployed 2026-11-08 00:11 UTC Run
prod-eu ✅ Deployed 2026-11-08 00:12 UTC Run

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@andrewm4894 andrewm4894 andrewm4894 approved these changes

Assignees

@andrewm4894 andrewm4894

Labels

self-driving skip-agent-review Save $$$, skip auto agent reviews (Greptile) — use for trivial or chore PRs

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@andrewm4894