Skip to content

Fix wizard orchestrator remarks: stale tool names + doc gaps - #272

Draft
posthog[bot] wants to merge 1 commit into
mainfrom
posthog-code/mini-agent-remarks-1
Draft

Fix wizard orchestrator remarks: stale tool names + doc gaps#272
posthog[bot] wants to merge 1 commit into
mainfrom
posthog-code/mini-agent-remarks-1

Conversation

@posthog

@posthog posthog Bot commented Jul 22, 2026

Copy link
Copy Markdown

Summary

Fixes derived from clustering wizard remark telemetry (self-driving and integrate task types) over the last several hours — each verified against the live PostHog MCP tool schema or the actual example-app code before fixing:

  • self-driving / products-enable: this MCP tool does not exist (confirmed via live search/tools listing, and independently reported by ~16 orchestrator runs). Added a soft-degrade instruction so the step records a follow-up instead of stalling.
  • self-driving / signals-scout-config-*, signals-scout-project-profile-get: confirmed via info to be deprecated aliases (DEPRECATED: renamed to scout-config-*). Switched all references to the current scout-config-* / scout-project-profile-get names.
  • integration (legacy flow) / notebook mirroring: added explicit JSON-escaping guidance for the report → notebook step, matching what the newer integration-v2 notebook skill already documents. This was the single highest-volume complaint cluster (~19 independent remarks) — agents kept hand-splicing raw multi-line text into the notebooks-create JSON payload instead of building it as one escaped JSON value.
  • commandments.yaml / Python: resolved a real contradiction — the general rule said "always use the Posthog() class constructor", but the Flask/FastAPI/Django sections (and their example apps in example-apps/) correctly use the module-level posthog.api_key API for those frameworks. Scoped the general rule to standalone scripts/CLIs so it no longer conflicts with the framework-specific guidance.

Why

An orchestrator remarks-triage loop reads wizard remark telemetry, clusters recurring complaints, and verifies each against the live tool schema/code before fixing — this avoids acting on any single agent's possibly-wrong self-report. Left out of scope: a report that the audit skill's init-not-duplicated check ID isn't in the wizard's seeded ledger — the check ID is legitimate on the context-mill side, so the mismatch likely needs a wizard-repo fix (not available in this checkout).

Test plan

  • npm test — 137 tests pass
  • npm run build — full build succeeds, no errors

Created with PostHog Code

Fixes surfaced by clustering `wizard remark` telemetry (task_type=self-driving, integrate) from the last several hours:

- self-driving: `products-enable` MCP tool doesn't exist (confirmed via live tool search) — add a soft-degrade instruction so the step records a follow-up instead of failing.
- self-driving: `signals-scout-config-*` / `signals-scout-project-profile-get` are deprecated aliases (confirmed via `info`) — switch references to the current `scout-config-*` / `scout-project-profile-get` names.
- integration (old flow): add explicit JSON-escaping guidance for the notebook-mirroring step, matching the escaping note already present in integration-v2's notebook skill — this was the single highest-volume complaint cluster.
- commandments.yaml: resolve a real contradiction in the Python section — the general rule said "always use the Posthog() class constructor", but the Flask/FastAPI/Django sections (and their example apps) correctly use the module-level `posthog.api_key` API for those frameworks. Scoped the general rule to standalone scripts/CLIs.

Left for later (needs the wizard repo, not available in this checkout): a possible mismatch between the audit skill's `init-not-duplicated` check ID and the wizard's ledger seed list.

Generated-By: PostHog Code
Task-Id: 5d7dc36c-18c9-447f-93d1-4e9722437e5b
@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 mcp-analytics
  • /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 mcp-analytics/custom-dispatcher
  • /wizard-ci mcp-analytics/typescript-sdk
  • /wizard-ci revenue/stripe

Results will be posted here when complete.

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.

0 participants