Skip to content

docs(self-driving): note health checks as an always-on source#706

Open
rafaeelaudibert wants to merge 1 commit into
mainfrom
posthog-code/self-driving-doc-health-checks
Open

docs(self-driving): note health checks as an always-on source#706
rafaeelaudibert wants to merge 1 commit into
mainfrom
posthog-code/self-driving-doc-health-checks

Conversation

@rafaeelaudibert

Copy link
Copy Markdown
Member

Problem

The self-driving setup is changing so it always enables the health_checks / health_issue signal source — instrumentation issues (missing events, proxy gaps, outdated SDKs) are always actionable, and a good thing for the agent to fix. ARCHITECTURE.md carries an explicit "keep this doc in lockstep with the code" rule, so it needs to reflect the new always-on source.

Changes

Updates src/lib/programs/self-driving/ARCHITECTURE.md in three places where the step-4 source behavior is described:

  • §2 step backbone (step 4) — health checks now listed alongside the scout gate as always-on.
  • §2 step table (step 4) — notes the health_checks / health_issue row is always enabled.
  • §5 sources — describes both always-on sources (scout gate + health checks).

Docs only — no code change. The actual enabling logic lives in the context-mill self-driving-setup skill (4-sources.md), updated separately.

Test plan

Docs-only change; covered by CI. No behavior change in the wizard.

LLM context

Authored by the PostHog Slack app (PostHog Code) at Rafael's request, paired with the context-mill change that adds health checks as an always-on source in 4-sources.md. This PR keeps the ARCHITECTURE doc in sync per its own lockstep rule.


Created with PostHog Code from a Slack thread

The self-driving setup now always enables the health_checks / health_issue
signal source (instrumentation findings are always actionable), so the
ARCHITECTURE doc's step-4 backbone, step table, and §5 sources description are
updated to keep them in lockstep with the context-mill skill change.

Generated-By: PostHog Code
Task-Id: f43da6e8-ca5d-4ae0-8451-e6cce79e4e85
@github-actions

Copy link
Copy Markdown

🧙 Wizard CI

Run the Wizard CI and test your changes against wizard-workbench example apps by replying with a GitHub comment using one of the following commands:

Test all apps:

  • /wizard-ci all

Test all apps in a directory:

  • /wizard-ci basic-integration
  • /wizard-ci error-tracking-upload-source-maps
  • /wizard-ci misc
  • /wizard-ci revenue

Test an individual app:

  • /wizard-ci basic-integration/android
  • /wizard-ci basic-integration/angular
  • /wizard-ci basic-integration/astro
Show more apps
  • /wizard-ci basic-integration/django
  • /wizard-ci basic-integration/fastapi
  • /wizard-ci basic-integration/flask
  • /wizard-ci basic-integration/javascript-node
  • /wizard-ci basic-integration/javascript-web
  • /wizard-ci basic-integration/laravel
  • /wizard-ci basic-integration/next-js
  • /wizard-ci basic-integration/nuxt
  • /wizard-ci basic-integration/python
  • /wizard-ci basic-integration/rails
  • /wizard-ci basic-integration/react-native
  • /wizard-ci basic-integration/react-router
  • /wizard-ci basic-integration/sveltekit
  • /wizard-ci basic-integration/swift
  • /wizard-ci basic-integration/tanstack-router
  • /wizard-ci basic-integration/tanstack-start
  • /wizard-ci basic-integration/vue
  • /wizard-ci error-tracking-upload-source-maps/android
  • /wizard-ci error-tracking-upload-source-maps/cicd-docker-node-raw
  • /wizard-ci error-tracking-upload-source-maps/cicd-github-actions-docker-node-raw
  • /wizard-ci error-tracking-upload-source-maps/cicd-github-actions-nested-docker-node-raw
  • /wizard-ci error-tracking-upload-source-maps/cicd-github-actions-node-raw
  • /wizard-ci error-tracking-upload-source-maps/cicd-gitlab-node-raw
  • /wizard-ci error-tracking-upload-source-maps/cicd-ssh-vps-node-raw
  • /wizard-ci error-tracking-upload-source-maps/flutter
  • /wizard-ci error-tracking-upload-source-maps/ios
  • /wizard-ci error-tracking-upload-source-maps/next
  • /wizard-ci error-tracking-upload-source-maps/next-no-posthog
  • /wizard-ci error-tracking-upload-source-maps/node-raw
  • /wizard-ci error-tracking-upload-source-maps/node-rollup
  • /wizard-ci error-tracking-upload-source-maps/node-rollup-typescript-plugin
  • /wizard-ci error-tracking-upload-source-maps/node-webpack
  • /wizard-ci error-tracking-upload-source-maps/nuxt-3-6
  • /wizard-ci error-tracking-upload-source-maps/nuxt-4-3
  • /wizard-ci error-tracking-upload-source-maps/react-native
  • /wizard-ci error-tracking-upload-source-maps/react-vite
  • /wizard-ci error-tracking-upload-source-maps/rust
  • /wizard-ci misc/quack-quack
  • /wizard-ci revenue/stripe

Results will be posted here when complete.

@rafaeelaudibert rafaeelaudibert requested review from a team and sortafreel June 22, 2026 17:09
@rafaeelaudibert rafaeelaudibert marked this pull request as ready for review June 24, 2026 00:46
@rafaeelaudibert rafaeelaudibert force-pushed the posthog-code/self-driving-doc-health-checks branch from ec716e4 to 39b518a Compare June 25, 2026 22:51

Copy link
Copy Markdown
Member Author

This stack of pull requests is managed by Graphite. Learn more about stacking.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants