Repository navigation
docs(adr): ADR-0063 — two kernel agents (ask/build); skills are the third-party extension primitive - #2164
Merged
Conversation
…rd-party extension primitive Supersedes ADR-0040 §3/§4: withdraws tenant-authored custom agents; the extension primitive is *.skill.ts (+ tools/MCP). Two platform-owned shells split by what they mutate — ask (records, OSS/free) and build (metadata, cloud/paid) — carrying the architecture, governance, and commercial line on one seam. Adds skill->shell affinity contract, intent-verb naming (ask/build canonical; data_chat/metadata_assistant as silent aliases), and tier-aware routing. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
10 tasks
xuyushun441-sys
added a commit
that referenced
this pull request
Jun 22, 2026
…64 tool scoping (#2167) Reverses ADR-0040's unified single-assistant core (merged first cut of ADR-0063 in #2164 kept it). ask and build are two products for different needs — like Claude Chat vs Claude Code — bound by the surface the user is in, not a per-turn intent classifier or a roster. Keeps ADR-0040's "user never picks", re-grounded as surface binding. - ADR-0063 (revised): two agents (ask ≈ Chat, free/OSS; build ≈ Code, paid/cloud); skills (+tools/MCP) are the only third-party extension primitive; *.agent.ts closed to third parties; skill→agent surface affinity; ask/build canonical naming; supersedes ADR-0040 core + §3. - ADR-0064 (new): tool scoping — an agent's tools = the union of its skills' tools; remove the global fall-through; resolves ADR-0040 §4. - Assessment: four-repo touchpoint inventory + findings that drove D2. Co-authored-by: Jack Zhuang <277994282+os-zhuang@users.noreply.github.com> Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds ADR-0063, settling the platform agent model and superseding ADR-0040 §3/§4.
Decision: the kernel keeps exactly two platform-owned agent shells, split by what they mutate:
ask(Claude-Chat analogue)@objectstack/service-ai)build(Claude-Code analogue)../cloud/service-ai-studio)Everything else — domain depth, persona, playbooks, external reach — is a skill (+ tools/MCP). Third parties extend via
*.skill.ts, never*.agent.ts. ADR-0040's 'custom agents are a builder feature' is withdrawn.Why: the platform is metadata-driven so the domain ontology is already shared with
askfor free (a custom agent to 'teach the industry' is a category error — the leftover is a skill); skills compose and scale, agents don't (Claude Code is hugely capable with zero user-authored agents); the records-vs-metadata seam carries the architectural, governance, and commercial boundary on one cut.Contents: two-shell table · skills+tools/MCP as the only third-party primitive · skill→shell affinity (
surface: ask|build|both) · naming (ask/buildcanonical,data_chat/metadata_assistantsilent aliases) · tier-aware routing · cleanup checklist (tracked as a separate issue).Docs-only; no code changes.
🤖 Generated with Claude Code