Skip to content

fix(self-driving): Rename "canonical" scouts to "built-in" in self-driving prompt#717

Merged
sortafreel merged 1 commit into
mainfrom
posthog-code/self-driving-built-in-scouts
Jun 23, 2026
Merged

fix(self-driving): Rename "canonical" scouts to "built-in" in self-driving prompt#717
sortafreel merged 1 commit into
mainfrom
posthog-code/self-driving-built-in-scouts

Conversation

@sortafreel

Copy link
Copy Markdown
Contributor

Problem

During cloud onboarding testing, "canonical" was flagged as confusing UX — it is not a word product users know. The self-driving program prompt and the user-facing decline label used it. The user-facing label fix lives in PostHog/context-mill#199; this mirrors the vocabulary in the wizard so the agent's instructions match the skill it drives.

Changes

  • prompt.ts: "canonical troop" / "canonical scout bodies" → "built-in".
  • ARCHITECTURE.md: updated the two stale quotes of the decline label (None — keep the canonical troopbuilt-in) to match.
  • Left backend mechanism names (sync_canonical_skills, the seeded_by canonical-vs-custom discriminator) unchanged — those are code-level identifiers, not user-facing copy.

Test plan

Docs/prompt-text only; no behavior change. Covered by CI.


Created with PostHog Code from a Slack thread

Mirrors the context-mill rename (PostHog/context-mill#199): swaps the jargon word "canonical" for the plainer "built-in" in the self-driving program prompt, and updates the two stale decline-label quotes in ARCHITECTURE.md to match the new label. Leaves backend mechanism names (sync_canonical_skills, the seeded_by discriminator) unchanged.

Generated-By: PostHog Code
Task-Id: ed014c8d-4c01-499b-879e-de953dc34179
@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-github-actions-single-stage-docker-node-raw
  • /wizard-ci error-tracking-upload-source-maps/cicd-gitlab-node-raw
  • /wizard-ci error-tracking-upload-source-maps/cicd-monorepo-pnpm-node-react
  • /wizard-ci error-tracking-upload-source-maps/cicd-monorepo-raw-node-react
  • /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.

@sortafreel sortafreel marked this pull request as ready for review June 23, 2026 17:32
Copilot AI review requested due to automatic review settings June 23, 2026 17:32
@sortafreel sortafreel changed the title Rename "canonical" scouts to "built-in" in self-driving prompt fix(self-driving): Rename "canonical" scouts to "built-in" in self-driving prompt Jun 23, 2026
@sortafreel sortafreel merged commit e99450e into main Jun 23, 2026
20 of 21 checks passed

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates self-driving program copy to replace the user-confusing term “canonical” with “built-in”, aligning the wizard’s prompt language with the corresponding context-mill skill vocabulary.

Changes:

  • Updated the self-driving agent prompt to refer to the “built-in troop” and “built-in scout bodies”.
  • Updated self-driving architecture documentation quotes of the decline label to use “built-in”.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
src/lib/programs/self-driving/prompt.ts Renames “canonical” to “built-in” in STEP 7 instructions so the agent’s guidance matches updated UX terminology.
src/lib/programs/self-driving/ARCHITECTURE.md Updates documentation references to the decline label to use “built-in” for consistency with the prompt/skill language.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines 67 to +68
6. **Configure scout troop** — materialize the canonical troop, then enable a deliberately small set: `general` (always) + the **1–2 specialists** for the products this project uses most; never `error-tracking`/`session-replay` (consumed as native sources); disable the rest. The enabled troop lands at **2–5** (general + 1–2 specialists + 0–2 custom).
7. **Design custom scouts** — gap-analyze the repo against the troop, propose **at most 2** candidates in one ask (each a plain-language `label` + a dimmed `description`, behind a leading "None — keep the canonical troop" default option), create the approved subset (the only place custom scouts are made).
7. **Design custom scouts** — gap-analyze the repo against the troop, propose **at most 2** candidates in one ask (each a plain-language `label` + a dimmed `description`, behind a leading "None — keep the built-in troop" default option), create the approved subset (the only place custom scouts are made).
@sortafreel sortafreel deleted the posthog-code/self-driving-built-in-scouts branch June 23, 2026 17:34
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