Skip to content

docs(adr): ADR-0040 Unified Assistant — the end user never picks an agent#1734

Merged
os-zhuang merged 1 commit into
mainfrom
docs/adr-0040-unified-assistant
Jun 11, 2026
Merged

docs(adr): ADR-0040 Unified Assistant — the end user never picks an agent#1734
os-zhuang merged 1 commit into
mainfrom
docs/adr-0040-unified-assistant

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Design record for the agent/skill boundary question raised in today's staging incident (Data Assistant accepted a whole-app build without the authoring disciplines and narrated its debugging to the user).

Core positions:

  • One platform assistant for people — default agent carries all platform skills (data + authoring) with an intent preamble; the skills system IS the per-intent behavior mechanism (no sibling-agent router).
  • Picker leaves consumer UX; explicit ?agent=/API pins stay for builder/developer/programmatic surfaces.
  • agent stays in the spec, redefined: assembled runtime configuration + governance unit (model/guardrails/planning/memory/persona/skills), selected by scenario via the existing resolution chain, configured by builders. Agents : assistants :: views : lists.
  • Custom agents = builder feature, same ADR-0033/0038 pipeline, platform guardrails as a floor.
  • Tool-scoping gap named honestly: tools are registry-global today; skills carry discipline, not access control — capability boundaries are the specified follow-up.

Implementation lands separately (service-ai default-agent composition + objectui picker removal), gated by the ADR-0038 L5 suite.

🤖 Generated with Claude Code

…gent

agent = assembled runtime configuration + governance unit (model, guardrails,
planning, memory, persona, skill composition), selected by SCENARIO via the
existing resolution chain (app.defaultAgent → platform default → first
active) and configured by BUILDERS; skill = reusable capability fragment.
The consumer picker leaves chat UX; custom agents stay a builder feature on
the same draft→verify→publish pipeline; the tool-scoping gap (tools are
registry-global; skills carry discipline, not access control) is named as
the follow-up contract.

Motivated by the 2026-06-11 staging incident: the Data Assistant accepted a
build-an-app job without the authoring disciplines and narrated its own
debugging to a business user.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 11, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
spec Ready Ready Preview, Comment Jun 11, 2026 3:37pm

Request Review

@github-actions github-actions Bot added documentation Improvements or additions to documentation size/m labels Jun 11, 2026
@os-zhuang
os-zhuang merged commit a1f8a19 into main Jun 11, 2026
12 checks passed
@os-zhuang
os-zhuang deleted the docs/adr-0040-unified-assistant branch June 11, 2026 15:39
xuyushun441-sys pushed a commit that referenced this pull request Jun 14, 2026
fix(plugin-grid): row Edit/Delete honor object userActions.{edit,delete} (#1734)

objectui@209633cf5883030f54517c3e580e9aaca70a26d9
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant