starter-pack-chooser.json

{
  "$schema": "./starter-pack-chooser.schema.json",
  "chooserVersion": 1,
  "questions": [
    {
      "id": "artifact-type",
      "prompt": "What are you building first?",
      "options": [
        {
          "id": "builder-helper",
          "label": "A builder/helper that delegates requests or inspects runtime state",
          "recommendedScenarios": [
            "codex-builder",
            "claude-code-builder",
            "openclaw-builder",
            "mcp-inspector"
          ],
          "why": [
            "Choose a builder pack when you are wiring another tool or local helper into WebaiBridge.",
            "Builder packs are the narrow path for thin compat helpers and read-only runtime inspection."
          ]
        },
        {
          "id": "skill-pack",
          "label": "A skill pack or automation starter that follows truth surfaces",
          "recommendedScenarios": [
            "runtime-diagnostics-skill",
            "docs-seo-sync-skill",
            "chat-app-runtime-skill",
            "research-copilot-skill",
            "compare-runtime-skill",
            "byok-first-safe-skill"
          ],
          "why": [
            "Choose a skill pack when you want a bounded recipe, use-case starter, or truth-surface handoff before widening claims.",
            "Skill packs keep the first route narrow and still fail-closed even when the eventual host shape is larger."
          ]
        }
      ]
    },
    {
      "id": "job-to-be-done",
      "prompt": "Which first job do you need to solve?",
      "options": [
        {
          "id": "codex-text-bridge",
          "label": "Bridge Codex-style text requests into the WebaiBridge runtime",
          "recommendedScenarios": [
            "codex-builder"
          ],
          "why": [
            "The Codex pack is the thin runtime bridge for Responses-style text traffic.",
            "It is the honest first step when you need a Codex helper, not full tool or worktree parity."
          ]
        },
        {
          "id": "claude-code-message-bridge",
          "label": "Bridge Claude Code-style message payloads into the runtime",
          "recommendedScenarios": [
            "claude-code-builder"
          ],
          "why": [
            "The Claude Code pack is the thin message/runtime bridge for gateway-style integration.",
            "It keeps terminal, approval, and tool parity out of scope."
          ]
        },
        {
          "id": "openclaw-delegation-bridge",
          "label": "Bridge delegation-first OpenClaw requests without copying the product shell",
          "recommendedScenarios": [
            "openclaw-builder"
          ],
          "why": [
            "The OpenClaw pack keeps the delegation shape while leaving operator and product-shell semantics outside WebaiBridge.",
            "It is the honest pack when you want runtime delegation, not a raw upstream fork."
          ]
        },
        {
          "id": "read-only-runtime-inspection",
          "label": "Inspect runtime truth through a read-only MCP surface",
          "recommendedScenarios": [
            "mcp-inspector"
          ],
          "why": [
            "The MCP pack is the right starter when your first goal is inspection and diagnostics through stdio tools.",
            "It is intentionally read-only and should not be mistaken for an execution backend."
          ]
        },
        {
          "id": "provider-triage",
          "label": "Produce a read-only provider triage or incident recipe",
          "recommendedScenarios": [
            "runtime-diagnostics-skill"
          ],
          "why": [
            "The runtime diagnostics pack turns support-bundle truth into a bounded incident recipe.",
            "It is the right pack when you want diagnosis without invoke or acquisition writes."
          ]
        },
        {
          "id": "docs-seo-truth-sync",
          "label": "Sync docs, SEO, or builder metadata to truthful support labels",
          "recommendedScenarios": [
            "docs-seo-sync-skill"
          ],
          "why": [
            "The docs/SEO sync pack is for truth-safe discoverability work, not launch automation.",
            "It keeps human review in the loop before any outward publishing."
          ]
        },
        {
          "id": "chat-app-runtime-bridge-planning",
          "label": "Start a chat app runtime bridge without promising a full chat shell",
          "recommendedScenarios": [
            "chat-app-runtime-skill"
          ],
          "why": [
            "The chat-app runtime pack is the honest first route when you already have a chat host and need the service-first bridge first.",
            "It keeps product-shell UI ambition downstream of runtime truth and host handoff."
          ]
        },
        {
          "id": "research-copilot-grounding",
          "label": "Ground a research copilot in truth surfaces before synthesis",
          "recommendedScenarios": [
            "research-copilot-skill"
          ],
          "why": [
            "The research copilot pack is the right starter when you need truth-surface grounding before any synthesis loop.",
            "It keeps human review and truthful claim boundaries in place."
          ]
        },
        {
          "id": "compare-runtime-routes",
          "label": "Compare runtime routes before choosing a winner",
          "recommendedScenarios": [
            "compare-runtime-skill"
          ],
          "why": [
            "The compare-runtime pack is for compare-first route selection, not auto-picking a winner.",
            "It turns the comparison catalog into a front-door worksheet you can review."
          ]
        },
        {
          "id": "byok-first-safe-handoff",
          "label": "Stay BYOK-first with safe invoke boundaries before touching Web/Login",
          "recommendedScenarios": [
            "byok-first-safe-skill"
          ],
          "why": [
            "The BYOK-first-safe pack is the honest route when you want provider truth and safe invoke planning before any heavier web-login expansion.",
            "It keeps secret handling and failover promises out of scope."
          ]
        }
      ]
    }
  ],
  "scenarios": [
    {
      "id": "codex-builder",
      "label": "Build a Codex helper that forwards text requests into WebaiBridge",
      "status": "partial",
      "starterKind": "builder",
      "recommendedPack": "codex",
      "bestEntry": "pnpm run webai-bridge:cli -- builder-kit --target codex",
      "whyThisPack": [
        "Use the Codex pack when your first need is a text-only runtime bridge.",
        "This pack already points at the narrow landed adapter instead of inventing a new compat story."
      ],
      "bestWhen": [
        "You need a helper or plugin that forwards text requests into the service runtime.",
        "You want a fail-closed Codex-shaped starter without claiming tool or worktree parity."
      ],
      "avoidWhen": [
        "You need tool execution, MCP parity, or worktree parity.",
        "You are actually trying to build a read-only runtime inspector."
      ],
      "compareAgainst": [
        "claude-code-builder",
        "openclaw-builder",
        "mcp-inspector"
      ],
      "recommendedDocs": [
        "docs/starter-pack-chooser.md",
        "docs/compat/codex.md",
        "starter-packs/README.md",
        "starter-packs/README.md"
      ],
      "searchKeywords": [
        "webai-bridge codex starter",
        "webai-bridge codex helper",
        "webai-bridge responses runtime bridge"
      ],
      "safeClaims": [
        "partial Codex compatibility",
        "thin runtime bridge",
        "fail-closed helper starter"
      ],
      "notYetSupported": [
        "tool execution parity",
        "mcp parity",
        "worktree parity"
      ]
    },
    {
      "id": "claude-code-builder",
      "label": "Build a Claude Code-style message bridge into WebaiBridge",
      "status": "partial",
      "starterKind": "builder",
      "recommendedPack": "claude-code",
      "bestEntry": "pnpm run webai-bridge:cli -- builder-kit --target claude-code",
      "whyThisPack": [
        "Use the Claude Code pack when your first need is a message/runtime bridge.",
        "This pack keeps terminal, approval, and tool claims fail-closed."
      ],
      "bestWhen": [
        "You want to adapt message-shaped traffic into the current runtime invoke route.",
        "You need a builder starter, not a terminal shell clone."
      ],
      "avoidWhen": [
        "You need terminal shell parity or full tool parity.",
        "You only need read-only inspection."
      ],
      "compareAgainst": [
        "codex-builder",
        "openclaw-builder",
        "mcp-inspector"
      ],
      "recommendedDocs": [
        "docs/starter-pack-chooser.md",
        "docs/compat/claude-code.md",
        "starter-packs/README.md",
        "starter-packs/README.md"
      ],
      "searchKeywords": [
        "webai-bridge claude code starter",
        "webai-bridge claude code gateway helper",
        "webai-bridge message runtime bridge"
      ],
      "safeClaims": [
        "partial Claude Code compatibility",
        "thin message/runtime bridge",
        "fail-closed compatibility helper"
      ],
      "notYetSupported": [
        "terminal shell parity",
        "approval parity",
        "tool parity",
        "mcp parity"
      ]
    },
    {
      "id": "openclaw-builder",
      "label": "Build an OpenClaw-style delegation bridge without copying the product shell",
      "status": "partial",
      "starterKind": "builder",
      "recommendedPack": "openclaw",
      "bestEntry": "pnpm run webai-bridge:cli -- builder-kit --target openclaw",
      "whyThisPack": [
        "Use the OpenClaw pack when your first need is delegation-first runtime bridging.",
        "This pack preserves the runtime delegation shape without importing operator or product-shell baggage."
      ],
      "bestWhen": [
        "You need a delegation-first request envelope.",
        "You want the upstream-informed runtime path while keeping WebaiBridge's product boundary intact."
      ],
      "avoidWhen": [
        "You need operator or control-plane parity.",
        "You are looking for a read-only diagnostics pack."
      ],
      "compareAgainst": [
        "codex-builder",
        "claude-code-builder",
        "mcp-inspector"
      ],
      "recommendedDocs": [
        "docs/starter-pack-chooser.md",
        "docs/compat/openclaw.md",
        "starter-packs/README.md"
      ],
      "searchKeywords": [
        "webai-bridge openclaw starter",
        "webai-bridge delegation bridge",
        "webai-bridge openclaw compat helper"
      ],
      "safeClaims": [
        "partial OpenClaw compatibility",
        "delegation-first bridge",
        "fail-closed adapter starter"
      ],
      "notYetSupported": [
        "operator control-plane parity",
        "product-shell parity",
        "channel shell parity"
      ]
    },
    {
      "id": "mcp-inspector",
      "label": "Expose WebaiBridge runtime truth through a read-only MCP inspector",
      "status": "partial",
      "starterKind": "builder",
      "recommendedPack": "mcp",
      "bestEntry": "pnpm run webai-bridge:cli -- builder-kit --target mcp",
      "whyThisPack": [
        "Use the MCP pack when your first need is read-only runtime inspection over stdio tools.",
        "This pack already matches the landed partial MCP surface without pretending it can invoke or automate browsers."
      ],
      "bestWhen": [
        "You want runtime health, provider status, remediation, or catalog truth through a local MCP client.",
        "You need a bounded inspector instead of a consumer-parity backend."
      ],
      "avoidWhen": [
        "You need runtime invoke or acquisition writes through MCP.",
        "You are actually building a compat helper for Codex, Claude Code, or OpenClaw."
      ],
      "compareAgainst": [
        "codex-builder",
        "claude-code-builder",
        "runtime-diagnostics-skill"
      ],
      "recommendedDocs": [
        "docs/starter-pack-chooser.md",
        "docs/mcp.md",
        "docs/api/mcp-readonly-server.md",
        "starter-packs/README.md"
      ],
      "searchKeywords": [
        "webai-bridge mcp starter",
        "webai-bridge read only mcp server",
        "webai-bridge runtime inspector"
      ],
      "safeClaims": [
        "partial read-only MCP surface",
        "runtime inspection only",
        "bounded MCP starter"
      ],
      "notYetSupported": [
        "execution brain",
        "runtime invoke through MCP",
        "acquisition write through MCP",
        "embedded consumer parity"
      ]
    },
    {
      "id": "runtime-diagnostics-skill",
      "label": "Create a read-only provider triage or diagnostics recipe",
      "status": "partial",
      "starterKind": "skill",
      "recommendedPack": "runtime-diagnostics-pack",
      "bestEntry": "pnpm run webai-bridge:cli -- skill-pack --target runtime-diagnostics-pack",
      "whyThisPack": [
        "Use this skill pack when you need a bounded incident recipe built on support-bundle truth.",
        "It stays read-only and is already shaped around readiness, remediation, and attach-target evidence."
      ],
      "bestWhen": [
        "You need to summarize provider readiness or triage incidents without invoking providers.",
        "You want a repeatable skill recipe for diagnostics or support work."
      ],
      "avoidWhen": [
        "You need acquisition writes, browser automation, or invoke.",
        "You only need a read-only MCP inspector with no recipe layer."
      ],
      "compareAgainst": [
        "mcp-inspector",
        "docs-seo-sync-skill"
      ],
      "recommendedDocs": [
        "docs/starter-pack-chooser.md",
        "starter-packs/README.md",
        "docs/mcp.md",
        "starter-packs/README.md"
      ],
      "searchKeywords": [
        "webai-bridge runtime diagnostics pack",
        "webai-bridge provider triage starter",
        "webai-bridge support bundle skill pack"
      ],
      "safeClaims": [
        "read-only diagnostics pack",
        "provider triage helper",
        "no invoke or write actions"
      ],
      "notYetSupported": [
        "invoke",
        "acquisition write",
        "browser automation",
        "execution-brain parity"
      ]
    },
    {
      "id": "docs-seo-sync-skill",
      "label": "Create a truth-safe docs or SEO sync helper",
      "status": "partial",
      "starterKind": "skill",
      "recommendedPack": "docs-seo-sync-pack",
      "bestEntry": "pnpm run webai-bridge:cli -- skill-pack --target docs-seo-sync-pack",
      "whyThisPack": [
        "Use this pack when you need docs or discoverability sync while keeping support claims truthful.",
        "It already assumes human review before outward publishing and keeps launch automation out of scope."
      ],
      "bestWhen": [
        "You are syncing docs, metadata, or SEO copy to the latest support labels.",
        "You want a bounded truth-sync starter, not a marketing autopilot."
      ],
      "avoidWhen": [
        "You need autonomous publishing or launch automation.",
        "You are actually trying to build a runtime bridge or diagnostics recipe."
      ],
      "compareAgainst": [
        "runtime-diagnostics-skill",
        "mcp-inspector"
      ],
      "recommendedDocs": [
        "docs/starter-pack-chooser.md",
        "starter-packs/README.md",
        "docs/discoverability-keyword-truth.md",
        "starter-packs/README.md"
      ],
      "searchKeywords": [
        "webai-bridge docs seo sync pack",
        "webai-bridge discoverability starter",
        "webai-bridge truthful seo helper"
      ],
      "safeClaims": [
        "truth-sync starter",
        "discoverability helper",
        "not a marketing autopilot"
      ],
      "notYetSupported": [
        "marketing autopilot",
        "claim escalation without review",
        "launch automation"
      ]
    },
    {
      "id": "chat-app-runtime-skill",
      "label": "Start a chat app runtime bridge without promising a full chat shell",
      "status": "partial",
      "starterKind": "skill",
      "recommendedPack": "chat-app-runtime-pack",
      "bestEntry": "pnpm run webai-bridge:cli -- skill-pack-route --target chat-app-runtime-pack",
      "whyThisPack": [
        "Use this pack when you already have a chat-shaped host and need the service-first runtime bridge before expanding the product shell.",
        "The first handoff already points at runtime doctor, runtime plan, and provider truth instead of inventing a new shell contract."
      ],
      "bestWhen": [
        "You want a chat-oriented starter that begins at the WebaiBridge runtime layer.",
        "You need a front-door use-case pack that stays smaller than a full chat product scaffold."
      ],
      "avoidWhen": [
        "You need a finished chat UI shell or tool-using agent product.",
        "You need browser/session write automation or hosted control-plane behavior."
      ],
      "compareAgainst": [
        "codex-builder",
        "research-copilot-skill",
        "byok-first-safe-skill"
      ],
      "recommendedDocs": [
        "docs/starter-pack-chooser.md",
        "docs/host-integration-playbooks.md",
        "docs/api/service-http-reference.md",
        "starter-packs/skills/chat-app-runtime-pack/README.md"
      ],
      "searchKeywords": [
        "webai-bridge chat app runtime pack",
        "webai-bridge chat runtime starter",
        "webai-bridge service first chat bridge"
      ],
      "safeClaims": [
        "chat-app runtime scaffold",
        "service-first bridge planning pack",
        "no full product shell"
      ],
      "notYetSupported": [
        "full chat product scaffold",
        "tool-using agent shell",
        "browser/session write automation"
      ]
    },
    {
      "id": "research-copilot-skill",
      "label": "Ground a research copilot in truth surfaces before synthesis",
      "status": "partial",
      "starterKind": "skill",
      "recommendedPack": "research-copilot-pack",
      "bestEntry": "pnpm run webai-bridge:cli -- skill-pack-route --target research-copilot-pack",
      "whyThisPack": [
        "Use this pack when you want a research-shaped starter that reads truth surfaces before synthesizing anything outward-facing.",
        "It keeps human review and truthful support labels in the loop instead of widening into autonomous research."
      ],
      "bestWhen": [
        "You need a research copilot starter grounded in support truth, compat targets, and keyword truth.",
        "You want a front-door use-case pack that stays read-only and reviewable."
      ],
      "avoidWhen": [
        "You need an autonomous multi-source research loop.",
        "You want browser writes, citation autopilot, or launch-style automation."
      ],
      "compareAgainst": [
        "docs-seo-sync-skill",
        "compare-runtime-skill",
        "runtime-diagnostics-skill"
      ],
      "recommendedDocs": [
        "docs/starter-pack-chooser.md",
        "docs/host-integration-playbooks.md",
        "docs/public-surface-support-matrix.md",
        "starter-packs/skills/research-copilot-pack/README.md"
      ],
      "searchKeywords": [
        "webai-bridge research copilot pack",
        "webai-bridge truth grounded research starter",
        "webai-bridge research handoff pack"
      ],
      "safeClaims": [
        "research copilot scaffold",
        "truth-surface grounding pack",
        "no autonomous research loop"
      ],
      "notYetSupported": [
        "autonomous multi-source research loop",
        "citation autopilot",
        "browser write automation"
      ]
    },
    {
      "id": "compare-runtime-skill",
      "label": "Compare runtime routes before choosing a winner",
      "status": "partial",
      "starterKind": "skill",
      "recommendedPack": "compare-runtime-pack",
      "bestEntry": "pnpm run webai-bridge:cli -- skill-pack-route --target compare-runtime-pack",
      "whyThisPack": [
        "Use this pack when your first job is comparing starter routes and constraints instead of auto-selecting a winner.",
        "It turns the comparison catalog into a front-door worksheet you can review before committing to a host path."
      ],
      "bestWhen": [
        "You need a compare-first starter for runtime or pack selection.",
        "You want a front-door use-case pack that keeps tradeoffs explicit and reviewable."
      ],
      "avoidWhen": [
        "You need a benchmark harness or automatic winner selection.",
        "You are actually trying to jump straight into a host bridge or diagnostics recipe."
      ],
      "compareAgainst": [
        "research-copilot-skill",
        "docs-seo-sync-skill",
        "mcp-inspector"
      ],
      "recommendedDocs": [
        "docs/starter-pack-chooser.md",
        "docs/host-integration-playbooks.md",
        "catalogs/starter-pack-comparison.json",
        "starter-packs/skills/compare-runtime-pack/README.md"
      ],
      "searchKeywords": [
        "webai-bridge compare runtime pack",
        "webai-bridge compare starter routes",
        "webai-bridge runtime selection worksheet"
      ],
      "safeClaims": [
        "compare-first scaffold",
        "constraint filter worksheet",
        "no automatic winner selection"
      ],
      "notYetSupported": [
        "automatic winner selection",
        "live benchmark automation",
        "consumer parity scoring"
      ]
    },
    {
      "id": "byok-first-safe-skill",
      "label": "Stay BYOK-first with safe invoke boundaries before touching Web/Login",
      "status": "partial",
      "starterKind": "skill",
      "recommendedPack": "byok-first-safe-pack",
      "bestEntry": "pnpm run webai-bridge:cli -- skill-pack-route --target byok-first-safe-pack",
      "whyThisPack": [
        "Use this pack when you want provider truth and safe invoke planning before expanding into heavier Web/Login recovery work.",
        "The route keeps BYOK and Web/Login boundaries explicit instead of smearing them into one starter."
      ],
      "bestWhen": [
        "You want a BYOK-first starter that keeps invoke planning and provider grounding explicit.",
        "You need a front-door use-case pack before deciding whether Web/Login work is even necessary."
      ],
      "avoidWhen": [
        "You need key storage workflows, web-login session repair, or automatic provider failover.",
        "You want a full chat product shell instead of a safe lane-first starter."
      ],
      "compareAgainst": [
        "chat-app-runtime-skill",
        "codex-builder",
        "runtime-diagnostics-skill"
      ],
      "recommendedDocs": [
        "docs/starter-pack-chooser.md",
        "docs/host-integration-playbooks.md",
        "docs/api/sdk-quickstart.md",
        "starter-packs/skills/byok-first-safe-pack/README.md"
      ],
      "searchKeywords": [
        "webai-bridge byok first safe pack",
        "webai-bridge byok runtime starter",
        "webai-bridge safe invoke planning"
      ],
      "safeClaims": [
        "BYOK-first scaffold",
        "safe invoke planning pack",
        "no web-login recovery claims"
      ],
      "notYetSupported": [
        "key storage workflow",
        "web-login session recovery",
        "automatic provider failover"
      ]
    }
  ]
}