Skip to content

docs: match READMEs to the build, release and wizard flow - #418

Open
gewenyu99 wants to merge 1 commit into
mainfrom
posthog/docs-accuracy-fixes
Open

gewenyu99 wants to merge 1 commit into
mainfrom
posthog/docs-accuracy-fixes

Conversation

@gewenyu99

Copy link
Copy Markdown
Collaborator

Problem

The README, CONTRIBUTING and AGENTS describe a repo layout, release assets and wizard behavior that no longer match the code.

Changes

  • README: wizard fetches skill-menu.json from releases (AWS mirror fallback), real repo tree, real release assets (manifest.json only ships inside skills-mcp-resources.zip), owners table synced to CODEOWNERS
  • Audit tables: add wizard audit attribution, all is the default leaf
  • CONTRIBUTING and AGENTS: command defaults to the variant id, wizard skill <id> replaces --skill, skill list only shows cliEntries, output ZIP names, wizard ai-observability, broken wizard CONTRIBUTING link, warlock usage, pnpm
  • example-apps: basics/ paths, Angular env vars and @ngx-env/builder, Expo app.config.js, Android file tree and snippets

Left alone on purpose: the claim that the wizard registers every cliEntries command (only audit works that way today). That needs a decision first.

Test plan

Docs only. Every changed claim was checked against origin/main of context-mill and the wizard.

🤖 Generated with Claude Code

Checked against origin/main code. Docs only.

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

github-actions Bot commented Oct 6, 2026

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 ai-observability
  • /wizard-ci basic-integration
  • /wizard-ci feature-flags
  • /wizard-ci mcp-analytics
  • /wizard-ci replay-vision
  • /wizard-ci revenue
  • /wizard-ci self-driving
  • /wizard-ci warehouse
  • /wizard-ci warehouse-seeded

Test an individual app:

  • /wizard-ci ai-observability/anthropic
  • /wizard-ci ai-observability/google-adk
  • /wizard-ci ai-observability/groq
Show more apps
  • /wizard-ci ai-observability/manual-capture
  • /wizard-ci ai-observability/openai
  • /wizard-ci ai-observability/openai-agents
  • /wizard-ci ai-observability/opentelemetry
  • /wizard-ci ai-observability/vercel-ai
  • /wizard-ci basic-integration/android
  • /wizard-ci basic-integration/angular
  • /wizard-ci basic-integration/astro
  • /wizard-ci basic-integration/django
  • /wizard-ci basic-integration/fastapi
  • /wizard-ci basic-integration/flask
  • /wizard-ci basic-integration/flutter
  • /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 feature-flags/django
  • /wizard-ci feature-flags/next-js
  • /wizard-ci mcp-analytics/custom-dispatcher
  • /wizard-ci mcp-analytics/typescript-sdk
  • /wizard-ci replay-vision/javascript-node
  • /wizard-ci replay-vision/next-js
  • /wizard-ci replay-vision/react-vite
  • /wizard-ci revenue/stripe
  • /wizard-ci self-driving/astro
  • /wizard-ci self-driving/fastapi
  • /wizard-ci self-driving/nuxt
  • /wizard-ci self-driving/react-router
  • /wizard-ci self-driving/sveltekit
  • /wizard-ci warehouse/monorepo-env
  • /wizard-ci warehouse/multi-source-next
  • /wizard-ci warehouse/stripe-node
  • /wizard-ci warehouse/zero-source
  • /wizard-ci warehouse-seeded/next-stripe
  • /wizard-ci warehouse-seeded/next-stripe-declined

Test against a wizard branch:

  • /wizard-ci all wizard:my-branch

Add wizard:<branch> to any command above to pin the wizard branch. It defaults to main.

Results will be posted here when complete.

@gewenyu99
gewenyu99 marked this pull request as ready for review October 6, 2026 16:05
@gewenyu99
gewenyu99 requested a review from a team as a code owner October 6, 2026 16:05

@johncwaters johncwaters 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.

Note

Automated review. Not written by a human.

Approved by hand after checking the automated review.


// Initialize PostHog early in Application lifecycle
val config = PostHogAndroidConfig(
apiKey = BuildConfig.POSTHOG_PROJECT_TOKEN,

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.

[suggestion] main already switched this to projectToken (#425), and posthog-android 4.0 removes apiKey (PostHog/posthog-android#871), so with #479 pinning 4.0.0 this snippet won't compile. This README also conflicts with main, #271 and #479 — could we rebase and keep projectToken?

Suggested change
apiKey = BuildConfig.POSTHOG_PROJECT_TOKEN,
projectToken = BuildConfig.POSTHOG_PROJECT_TOKEN,

buildConfigField(
"String",
"POSTHOG_PROJECT_TOKEN",
"\"${localProperties.getProperty("posthog.apiKey", "")}\""

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.

[nit] Same here — main reads posthog.projectToken from local.properties.

Suggested change
"\"${localProperties.getProperty("posthog.apiKey", "")}\""
"\"${localProperties.getProperty("posthog.projectToken", "")}\""

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.

4 participants