Context
Post-v0.1 follow-up to #113 (charter_brief MCP tool in charter serve).
charter serve is per-repo — one MCP server instance per Charter-governed repo. Multi-repo agent workflows (which is the direction autonomous agents are heading, driven by cc-taskrunner and aegis-daemon spawns across 10+ repos) need brief access without spinning up one charter serve per repo.
The stackbilt-mcp-gateway is ecosystem-wide and already brokers OAuth + tool access across Stackbilt properties. Natural home for a gateway-hosted brief-fetcher.
Open questions
- Invocation shape:
charter_brief today takes no arguments — it's "this repo, now." Through the gateway, agents need to specify which repo. Options:
- New tool name (e.g.
stackbilt_repo_brief) with a repo: string argument — decouples from the per-repo tool entirely
- Same
charter_brief name, gateway injects the repo from tenant/session context — transparent to the agent but implicit routing
- Brief freshness: gateway serves a central cache vs. proxies to the per-repo
charter serve instance. Cache has a consistency problem (when does it invalidate?); proxy has a cold-start cost.
- Auth scoping: which tenants can read which repos? Read the existing gateway OAuth model and reuse — this shouldn't invent new permissions.
Not v0.1
charter_brief ships through per-repo charter serve first (#113). Gateway exposure is a separate ecosystem integration that lands once the brief format is stable and we have real multi-repo agent workloads asking for it.
Related
Context
Post-v0.1 follow-up to #113 (
charter_briefMCP tool incharter serve).charter serveis per-repo — one MCP server instance per Charter-governed repo. Multi-repo agent workflows (which is the direction autonomous agents are heading, driven by cc-taskrunner and aegis-daemon spawns across 10+ repos) need brief access without spinning up onecharter serveper repo.The
stackbilt-mcp-gatewayis ecosystem-wide and already brokers OAuth + tool access across Stackbilt properties. Natural home for a gateway-hosted brief-fetcher.Open questions
charter_brieftoday takes no arguments — it's "this repo, now." Through the gateway, agents need to specify which repo. Options:stackbilt_repo_brief) with arepo: stringargument — decouples from the per-repo tool entirelycharter_briefname, gateway injects the repo from tenant/session context — transparent to the agent but implicit routingcharter serveinstance. Cache has a consistency problem (when does it invalidate?); proxy has a cold-start cost.Not v0.1
charter_briefships through per-repocharter servefirst (#113). Gateway exposure is a separate ecosystem integration that lands once the brief format is stable and we have real multi-repo agent workloads asking for it.Related
charter_briefsource feature