builder-intent-router.json

{
  "$schema": "./builder-intent-router.schema.json",
  "routerVersion": 1,
  "intents": [
    {
      "id": "support-truth",
      "question": "What is actually supported right now?",
      "firstHopDoc": "docs/public-surface-catalog.md",
      "firstHopCli": "pnpm run webai-bridge:cli -- surface-catalog",
      "firstHopMcp": "webai-bridge.catalog.surface_catalog",
      "whyThisFirst": [
        "Start here when you need the current truthful surface and compat boundary first.",
        "This is the fastest way to see partial vs supported without confusing builder route docs with support status."
      ],
      "doNotStartWith": [
        "docs/starter-pack-chooser.md",
        "docs/host-integration-playbooks.md"
      ],
      "truthReminder": [
        "partial is still partial",
        "read-only surfaces are still narrow"
      ],
      "relatedDocs": [
        "docs/public-surface-support-matrix.md",
        "docs/compat/README.md",
        "docs/mcp.md"
      ],
      "searchKeywords": [
        "webai-bridge support truth",
        "webai-bridge partial support",
        "webai-bridge current surface status"
      ]
    },
    {
      "id": "pick-starter-pack",
      "question": "Which starter pack should I pick first?",
      "firstHopDoc": "docs/starter-pack-chooser.md",
      "firstHopCli": "pnpm run webai-bridge:cli -- starter-pack-chooser",
      "firstHopMcp": "webai-bridge.catalog.starter_pack_chooser",
      "whyThisFirst": [
        "Start here when you already know you need a builder or skill pack but have not picked the first route.",
        "This is the narrow entry for first-hop pack selection."
      ],
      "doNotStartWith": [
        "docs/host-integration-playbooks.md",
        "docs/discoverability-keyword-truth.md"
      ],
      "truthReminder": [
        "this is a router, not a parity claim",
        "recommended pack does not mean full compatibility"
      ],
      "relatedDocs": [
        "catalogs/starter-pack-comparison.json",
        "docs/host-integration-playbooks.md",
        "starter-packs/README.md"
      ],
      "searchKeywords": [
        "webai-bridge starter pack chooser",
        "webai-bridge pick first pack",
        "webai-bridge builder first hop"
      ]
    },
    {
      "id": "pick-use-case-skill-pack",
      "question": "I need a front-door use-case skill pack for chat, research, compare, or BYOK-first work. Which route fits?",
      "firstHopDoc": "docs/starter-pack-chooser.md",
      "firstHopCli": "pnpm run webai-bridge:cli -- starter-pack-chooser",
      "firstHopMcp": "webai-bridge.catalog.starter_pack_chooser",
      "whyThisFirst": [
        "Start here when you already know you want a use-case skill pack instead of a host bridge or generic truth catalog.",
        "The chooser now exposes the chat-app, research-copilot, compare-runtime, and BYOK-first-safe packs before handing you off to the exact route card."
      ],
      "doNotStartWith": [
        "docs/compat/README.md",
        "docs/host-integration-examples.md"
      ],
      "truthReminder": [
        "front-door use-case pack does not mean full product scaffold",
        "handoff still goes through docs/host-integration-playbooks.md"
      ],
      "relatedDocs": [
        "docs/host-integration-playbooks.md",
        "catalogs/starter-pack-comparison.json",
        "starter-packs/README.md"
      ],
      "searchKeywords": [
        "webai-bridge use case skill pack",
        "webai-bridge chat research compare byok starter",
        "webai-bridge front door skill pack",
        "chat-app-runtime-pack",
        "research-copilot-pack",
        "compare-runtime-pack",
        "byok-first-safe-pack"
      ]
    },
    {
      "id": "activate-skill-pack",
      "question": "I already picked a skill pack or use-case starter. What is the coordinated CLI + MCP route?",
      "firstHopDoc": "docs/host-integration-playbooks.md",
      "firstHopCli": "pnpm run webai-bridge:cli -- skill-pack-routes",
      "firstHopMcp": "webai-bridge.catalog.skill_packs",
      "whyThisFirst": [
        "Start here once a skill pack is already chosen and you need the exact CLI plus MCP route card for the next handoff.",
        "This keeps pack-local work aligned with the landed pack files instead of reconstructing the route by hand."
      ],
      "doNotStartWith": [
        "docs/compat/README.md",
        "catalogs/starter-pack-comparison.json"
      ],
      "truthReminder": [
        "route cards stay bounded even when the eventual host shape is larger",
        "coordinated routes do not upgrade support claims"
      ],
      "relatedDocs": [
        "docs/starter-pack-chooser.md",
        "docs/mcp.md",
        "docs/public-surface-support-matrix.md",
        "starter-packs/README.md"
      ],
      "searchKeywords": [
        "webai-bridge skill pack route",
        "webai-bridge skill pack handoff",
        "webai-bridge cli mcp skill pack",
        "runtime-diagnostics-pack",
        "docs-seo-sync-pack",
        "chat-app-runtime-pack",
        "research-copilot-pack",
        "compare-runtime-pack",
        "byok-first-safe-pack"
      ]
    },
    {
      "id": "compare-packs",
      "question": "I need to compare or filter packs before choosing.",
      "firstHopDoc": "catalogs/starter-pack-comparison.json",
      "firstHopCli": "pnpm run webai-bridge:cli -- starter-pack-comparison",
      "firstHopMcp": "webai-bridge.catalog.starter_pack_comparison",
      "whyThisFirst": [
        "Start here when you are comparing constraints instead of asking for one default route.",
        "This is the right first hop for side-by-side pack truth and filtering."
      ],
      "doNotStartWith": [
        "catalogs/builder-journeys.json",
        "docs/host-integration-examples.md"
      ],
      "truthReminder": [
        "comparison is not a recommendation engine",
        "filters narrow truthful options only"
      ],
      "relatedDocs": [
        "docs/starter-pack-chooser.md",
        "starter-packs/README.md"
      ],
      "searchKeywords": [
        "webai-bridge compare starter packs",
        "webai-bridge filter packs",
        "webai-bridge pack comparison"
      ]
    },
    {
      "id": "follow-builder-journey",
      "question": "I want one full builder path to first success.",
      "firstHopDoc": "catalogs/builder-journeys.json",
      "firstHopCli": "pnpm run webai-bridge:cli -- builder-journeys",
      "firstHopMcp": "webai-bridge.catalog.builder_journeys",
      "whyThisFirst": [
        "Start here when you want one complete route instead of hopping across multiple pages yourself.",
        "This is the right first hop for bounded first-success paths."
      ],
      "doNotStartWith": [
        "docs/compat/README.md",
        "docs/provider-runtime-catalog.md"
      ],
      "truthReminder": [
        "journeys are still builder-facing and partial",
        "journeys do not imply full host or consumer parity"
      ],
      "relatedDocs": [
        "docs/starter-pack-chooser.md",
        "docs/host-integration-playbooks.md",
        "docs/host-integration-examples.md"
      ],
      "searchKeywords": [
        "webai-bridge first success journey",
        "webai-bridge builder journey",
        "webai-bridge first hop full path"
      ]
    },
    {
      "id": "wire-host",
      "question": "I already chose a route. How do I wire a host?",
      "firstHopDoc": "docs/host-integration-playbooks.md",
      "firstHopCli": "pnpm run webai-bridge:cli -- host-playbooks",
      "firstHopMcp": "webai-bridge.catalog.host_playbooks",
      "whyThisFirst": [
        "Start here once you have already chosen a pack or journey and need host wiring guidance.",
        "This is the right first hop for host-local integration steps."
      ],
      "doNotStartWith": [
        "docs/starter-pack-chooser.md",
        "docs/discoverability-keyword-truth.md"
      ],
      "truthReminder": [
        "host playbooks do not upgrade compatibility status",
        "wiring docs are still bounded to current landed shapes"
      ],
      "relatedDocs": [
        "docs/host-integration-examples.md",
        "catalogs/builder-journeys.json"
      ],
      "searchKeywords": [
        "webai-bridge host playbook",
        "webai-bridge host wiring",
        "webai-bridge integrate host"
      ]
    },
    {
      "id": "copy-host-example",
      "question": "I need a runnable host-local example.",
      "firstHopDoc": "docs/host-integration-examples.md",
      "firstHopCli": "pnpm run webai-bridge:cli -- host-examples",
      "firstHopMcp": "webai-bridge.catalog.host_examples",
      "whyThisFirst": [
        "Start here when you want a concrete host-local shape instead of a prose playbook.",
        "This is the right first hop for copyable example structure."
      ],
      "doNotStartWith": [
        "docs/discoverability-keyword-truth.md",
        "docs/compat/README.md"
      ],
      "truthReminder": [
        "examples are bounded starters",
        "examples do not imply full product-shell parity"
      ],
      "relatedDocs": [
        "docs/host-integration-playbooks.md",
        "examples/README.md"
      ],
      "searchKeywords": [
        "webai-bridge host example",
        "webai-bridge runnable host config",
        "webai-bridge copyable example"
      ]
    },
    {
      "id": "repair-web-login-session",
      "question": "I need to acquire or repair a Web/Login browser session first.",
      "firstHopDoc": "docs/runbooks/dev-bootstrap.md",
      "firstHopCli": "pnpm run webai-bridge:cli -- host-playbooks",
      "firstHopMcp": "webai-bridge.catalog.host_playbooks",
      "whyThisFirst": [
        "Start here when the real blocker is browser/session acquisition rather than host wiring or pack choice.",
        "This is the fastest first hop for auth-portal, browser hygiene, and service-first Web/Login recovery steps."
      ],
      "doNotStartWith": [
        "docs/compat/README.md",
        "catalogs/starter-pack-comparison.json"
      ],
      "truthReminder": [
        "browser/session recovery is still local-first",
        "auth-portal and runbook steps do not upgrade compatibility claims"
      ],
      "relatedDocs": [
        "docs/api/service-http-reference.md",
        "docs/api/web-login-acquisition.md",
        "docs/mcp.md"
      ],
      "searchKeywords": [
        "webai-bridge web login repair",
        "webai-bridge auth portal",
        "webai-bridge browser session recovery"
      ]
    },
    {
      "id": "keyword-claim-truth",
      "question": "Which keyword claims are truthful?",
      "firstHopDoc": "docs/discoverability-keyword-truth.md",
      "firstHopCli": "pnpm run webai-bridge:cli -- keyword-truth",
      "firstHopMcp": "webai-bridge.catalog.keyword_truth",
      "whyThisFirst": [
        "Start here when the problem is outward wording, docs sync, or truthful keyword usage.",
        "This is the right first hop for human and machine keyword truth."
      ],
      "doNotStartWith": [
        "docs/compat/README.md",
        "catalogs/builder-journeys.json"
      ],
      "truthReminder": [
        "keyword truth is not ad copy",
        "partial must stay partial"
      ],
      "relatedDocs": [
        "docs/public-surface-catalog.md",
        "docs/faq.md"
      ],
      "searchKeywords": [
        "webai-bridge keyword truth",
        "webai-bridge truthful claims",
        "webai-bridge docs seo truth"
      ]
    },
    {
      "id": "provider-directory",
      "question": "Which provider or lane am I even talking about?",
      "firstHopDoc": "docs/provider-runtime-catalog.md",
      "firstHopCli": "pnpm run webai-bridge:cli -- provider-catalog",
      "firstHopMcp": "webai-bridge.catalog.provider_catalog",
      "whyThisFirst": [
        "Start here when you need the current provider and lane directory before choosing a compat or host path.",
        "This is the right first hop for provider-scoped builder questions."
      ],
      "doNotStartWith": [
        "catalogs/builder-journeys.json",
        "catalogs/starter-pack-comparison.json"
      ],
      "truthReminder": [
        "provider directory is a runtime catalog, not a live proof verdict",
        "provider entry does not imply every host path is equally supported"
      ],
      "relatedDocs": [
        "README.md",
        "docs/media/30-second-overview.md",
        ".agents/internal-docs/contracts/provider-runtime-contract.md"
      ],
      "searchKeywords": [
        "webai-bridge provider catalog",
        "webai-bridge provider directory",
        "webai-bridge lane directory"
      ]
    },
    {
      "id": "inspect-read-only-mcp",
      "question": "What can the read-only MCP surface inspect today?",
      "firstHopDoc": "docs/mcp.md",
      "firstHopCli": "pnpm run webai-bridge:cli -- mcp-status",
      "firstHopMcp": "webai-bridge.catalog.mcp_status",
      "whyThisFirst": [
        "Start here when the question is about the current read-only MCP surface itself.",
        "This is the right first hop for MCP status, tool inventory, and fail-closed boundaries."
      ],
      "doNotStartWith": [
        "docs/host-integration-examples.md",
        "docs/starter-pack-chooser.md"
      ],
      "truthReminder": [
        "MCP is still partial and read-only",
        "MCP is not an execution brain"
      ],
      "relatedDocs": [
        "docs/api/mcp-readonly-server.md",
        "docs/public-surface-catalog.md"
      ],
      "searchKeywords": [
        "webai-bridge mcp status",
        "webai-bridge read only mcp",
        "webai-bridge mcp tool inventory"
      ]
    }
  ]
}