Skip to content

feat(orchestrator): surface per-framework SDK docs to task agents#686

Open
gewenyu99 wants to merge 3 commits into
mainfrom
orchestrator-surface-framework-docs
Open

feat(orchestrator): surface per-framework SDK docs to task agents#686
gewenyu99 wants to merge 3 commits into
mainfrom
orchestrator-surface-framework-docs

Conversation

@gewenyu99

@gewenyu99 gewenyu99 commented Jun 18, 2026

Copy link
Copy Markdown
Collaborator

Orchestrator task agents now get the framework's own SDK docs.

  • Surfaces the per-framework reference docs the skill packages (go.md, next-js.md, …), skipping the structural files (EXAMPLE.md, COMMANDMENTS.md) and the monolith's numbered workflow files. For docs-only frameworks with no EXAMPLE.md these docs are the only HOW signal.
  • Resolves each step-skill to its per-framework variant (<baseId>-<framework>) when one is published, else falls back to the bare skill.

Collect the reference skill's per-framework docs (everything in references/
except EXAMPLE.md, COMMANDMENTS.md, and the monolith's numbered workflow files)
and inject them via a new docsReference, so docs-only frameworks (Go, Elixir,
Flutter) and every non-JS framework get their real SDK reference instead of the
step-skill's wrong JS/Node docs or nothing.

Also watch the event plan in the run cache dir as well as the project root: the
orchestrator capture step now writes .posthog-events.json under
.posthog-wizard-cache (torn down with the run), while the linear flow still
writes it at the root. The TUI can't tell the flows apart, so it watches both.

Pairs with the context-mill basic-integration skill changes.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@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.

gewenyu99 commented Jun 18, 2026

Copy link
Copy Markdown
Collaborator Author

@gewenyu99 gewenyu99 marked this pull request as ready for review June 18, 2026 15:29
gewenyu99 and others added 2 commits June 18, 2026 14:00
The SDK-divergent step-skills (install, init, capture, error-tracking) now ship
per-framework variants ided as <baseId>-<framework>. Resolve each agent's bare
skill id to the variant for the run's framework before installing, mirroring
resolveReferenceSkillId: exact match, else first granular variant, else the bare
id unchanged for the generic single-variant steps (identify, report, dashboard,
build).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The orchestrator's cache-dir event-plan watcher ran in the default RunScreen,
hitting every flow ungated. All orchestrator behaviour must sit behind the
wizard-orchestrator flag. Restore RunScreen to its main version; the orchestrator
event-plan surfacing will be re-added inside the flag-gated orchestrator path.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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.

1 participant