Skip to content

docs: add edge case catalogue and full local stack recipe - #1451

Closed
gewenyu99 wants to merge 1 commit into
mainfrom
vincent/docs-edge-cases-local-stack
Closed

gewenyu99 wants to merge 1 commit into
mainfrom
vincent/docs-edge-cases-local-stack

Conversation

@gewenyu99

Copy link
Copy Markdown
Collaborator

Problem

The posthog.com wizard handbook links to an edge case catalogue and a full local stack recipe that don't exist in this repo.

Changes

  • docs/edge-cases.md: intro, why generic agents fail, how to add a case, an index of 913 cases, and 42 open cases without snippets. Generated from the edge case tally in Edge case tally: what the wizard skills stamp out that a generic agent gets wrong #1439. Cases that named a third-party project or customer were left out.
  • docs/edge-cases/<category>.md: one page per category with Problem, Impact, Rule location, Sources, and wrong and fixed snippets. Split because one 1.3 MB file would not render on GitHub.
  • docs/local-dev.md: new "Run the full stack locally" section with a port table and one recipe for local PostHog, ai-gateway, context mill, MCP, and a --local-dev wizard build.

Test plan

Docs only. Rendered every page with the GitHub markdown API and checked that headings and code fences balance. Checked the recipe's commands, flags, ports, and settings against src/shared/local-dev.ts, src/agent/gateway-session.ts, package.json, the ai-gateway justfile and README, context-mill scripts/dev-server.js, and the posthog bin/setup-gateway-e2e, bin/start-ai-gateway, hogli.yaml, and devenv/intent-map.yaml. The recipe was not run end to end.

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 5.5 <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 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 Context Mill branch:

  • /wizard-ci all context-mill:my-branch

Add context-mill:<branch> to any command above to pin the Context Mill branch. It defaults to main.

Results will be posted here when complete.

@gewenyu99

Copy link
Copy Markdown
Collaborator Author

Closing. The edge case catalogue now lives only in the handbook bestiary, and the full-stack recipe is in #1452.

@gewenyu99 gewenyu99 closed this Oct 16, 2026
@gewenyu99
gewenyu99 deleted the vincent/docs-edge-cases-local-stack branch October 16, 2026 18:24
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