Mental model. A team page is the rollup of an organization's KBs, members, and repos. It is not any single KB. The team-context KB (kb_type='team', aliased_team_id=<team.id>) is one of N bubbles owned by the team; the team page lists it alongside repos, channel KBs, and custom KBs.

Stats tile semantics. "Bubbles" = count of KBs where the team is owner or grantee. "Signals" = murmur count across all those KBs in last 7 days. "Discussions" = recording count + live-now subset. "Coworkers active" = users (incl. AI coworkers) who touched anything in the team this week. These need a single endpoint (GET /api/v1/teams/:team_id/stats?window=7d) returning all four — don't fan out from the client.

Active-work feed. Cross-bubble — aggregates murmurs from every KB the team owns. The murmur API today (/api/v1/teams/:team_id/murmurs) already fans across up to 20 repos; extend that to include all team-owned KBs.

Right rail. The compact bubble constellation in the right rail uses the existing KBConstellation component (apps/web/src/components/kb/KBConstellation.tsx) with the compact variant — see §12f for the encoding.

Anti-patterns to avoid.

• Don't conflate "team settings" with "team-context-KB settings." They live at separate routes (/team/[id]/settings/* vs /kb/[kb_id]/settings) and store different data.
• Don't show kb_type='team' bubbles in the  Create  flow — they auto-provision.

Files (best guess). New route apps/web/app/(protected)/team/[team_id]/page.tsx (replace existing if needed). New stats endpoint apps/api-go/internal/handlers/teams/stats.go. Existing component reuse: MurmurFeed, KBConstellation.

Why this surface matters. Without it, a team admin manages each bubble individually — a 20-tab afternoon for a team of 9 bubbles. This page makes ownership transfer, audit, and deletion tractable.

Auth. Admin-only. Use RequireTeamRole('admin') middleware. Non-admins should not see the route in their team-settings sub-nav (filter EntitySettingsNav.tsx).

Table columns. Bubble (avatar + name + slug) · Kind · Members count (with mini-stack of 3) · Last activity (with act-pulse dot) · Owner (current human accountable) · Status · Actions (⋯ menu).

Row actions.

• Transfer ownership — change kb.owner_user_id to another team member. Modal confirms the transfer; new owner is notified.
• Change visibility — toggle kb_team_grants visibility (private to grantees vs discoverable to team). Confirm modal.
• Audit grants — opens a right-side sheet showing who has access, role, granted-by, granted-at, last-active. Sortable, exportable as CSV.
• Delete bubble — permanent, confirmation modal with name-typing required (like GitHub repo delete). No archive — per the data model today.

Bulk operations. Selection checkbox per row; bulk-action bar appears at the bottom (slide-up, fade-in 150ms — single property). Bulk actions: Change visibility, Audit, Export audit log, Delete.

Empty state. "This team has no bubbles yet. The team-context bubble auto-provisions when [conditions]. Create a custom or repo bubble →" — uses the "doesn't exist yet" pattern (§12e+).

Filters. Kind · Visibility · Status · Owner — server-side filtering. Persist last-used filter in localStorage per (user, team).

Files (best guess). Route: apps/web/app/(protected)/team/[team_id]/settings/bubbles/page.tsx. Server endpoints: GET /api/v1/teams/:team_id/kbs, POST /api/v1/kb/:kb_id/transfer, PATCH /api/v1/kb/:kb_id/visibility, DELETE /api/v1/kb/:kb_id. Audit-grants sheet uses the existing kb_team_grants table.

The marquee surface. This is the most-visited KB page. Every design move here propagates to other kb_type variants.

Header. Bubble avatar (36×36, flat fill per kb_type with monogram) + plain-language title (20px, weight 600, letter-spacing: -0.015em, line-height: 1.2) + KBTypeBadge (small, demoted to slug line in V2) + RoleBadge. Slug line is 12.5px text-muted: #slug · part of @team · members · bubbles. CTA buttons right-aligned; one Copper CTA per view ("Have a discussion" or "Dictate memo" for personal). The avatar must be baseline-aligned with the title — V1 had it top-aligned which made the header read taller than it is.

Tabs. Overview · Members · Settings. Members only when kbAllowsMembers(kb.kb_type) (false for personal/profile). Settings only when viewerRole === 'admin'. Underline indicator: 2px sage-500 at bottom of the active tab. Transition the underline on tab change via a single shared pseudo-element that translateX()'s; don't fade the border-bottom independently per tab — that reads as jump.

Onboarding stepper. Horizontal compact variant. Per-user state stored as kb.metadata.viewer_onboarding_completed_at_<user_id>. Hover any step to see the data-tip explanation. The current step's tip is pinned-open via .show-tip class so first-time users get context without hover. Stepper dismisses via the "Dismiss" link; persist dismissal per (user, kb) in kb.metadata.

Connect widgets. Three cards: CLI (ox init), MCP (single per-user /api/v1/mcp endpoint — explain the ListTeams/Search tool model in the description), Slack channel (link via existing LinkChannelDialog). Adaptive — personal bubbles hide the Slack card; repo bubbles hide it too. Each card: icon tile + plain-language title + 1-line description + snippet/CTA + footer status. One CTA per card. Snippet uses the .copy-ic icon (no "Copy" text label).

Active work (Murmurs feed). Fixed-height container (max-height: 388px) with .decay class for opacity fade. See-more footer with gradient fade-in. Cross-bubble on this page — aggregates from every KB the team owns. Each row: 3-column grid (dot + content + meta), principal-first attribution. See §12i for the full row spec.

Right rail. Members (with avatar stack), Linked repos. Each section can become its own contextual sidebar item in the future. Avoid duplicating the sidebar's contextual section here.

Files. Page: apps/web/app/(protected)/kb/[kb_id]/page.tsx (refactor the existing). Sidebar morphing: apps/web/src/components/layout/nav/LeftNav.tsx + new useContextualNav() hook driven by usePathname().

No API changes required. Every field in the new design is already on the wire: principal_id, agent_type, topic, importance, repo_id, timestamp, metadata.files. This is a render-layer change only.

Row grid. grid-template-columns: 16px minmax(0,1fr) auto. Dot · content · meta. Don't let the meta wrap — it's the right-edge anchor for scanning. Time + KB chip stack in the meta column with flex-direction: column; align-items: flex-end.

Principal-first attribution. The byline shows the human the agent acted on behalf of, not the agent. Resolve principal_id → user → avatar + first name. agent_type follows as · via ✦ claude-code. When agent_type is empty (human posted), drop the entire "via …" fragment — don't replace it with "manual" or a person icon. Absence is the signal.

KB provenance chip. Distinguished by icon, not color. ⎇ org/repo for repo, 👥 Team for team-context, 📖 Name for custom, #name for channel. 11px font, mono only for repo paths. Tooltip on hover gives full KB type + activity count.

Freshness states. wip + <4h = pulsing green dot. wip + 4-24h = solid green. Anything >24h = hollow ring (border: 1.5px solid var(--char-500); bg: transparent). The content text drops to text-muted on stale rows. The biggest legibility win — without this, a 4m-old murmur and a 20h-old murmur look identical.

Importance variants. critical → 2px copper-400 left border + content stays default color (don't double-signal). ambient → row opacity 0.7. normal → no extra treatment.

File chips. Max 2 visible, then +N more. Mono, 10px, surface-2 bg, text-muted. Hover expands. Calm mode hides them entirely until row hover.

Timestamp tooltip. Two-line: localized + ISO. <time dateTime={iso}> for a11y and copy-paste. Use Radix Tooltip with delayDuration={300}, fade-only entry. No slide, no scale.

Fixed-height + decay (V2.2). Wrap the feed in .murmur-feed.fixed.decay when it lives on a KB or team overview. Row 1 = 1.0 opacity, row 2 = 0.95, row 3+ = 0.88. .see-more footer with gradient fade-in. Hover any decayed row restores 1.0.

Files. Rewrite apps/web/src/components/murmurs/MurmurItem.tsx. Container: MurmurFeed.tsx takes new props fixed?: boolean, decay?: boolean, seeMoreLink?: string.

Four-layer motion + density policy.

1. OS reduced-motion (nuclear). @media (prefers-reduced-motion: reduce) at the top of the global stylesheet. Sets animation-duration: 0.001ms, animation-iteration-count: 1, transition-duration: 0.001ms on *, *::before, *::after with !important. No opt-in.
2. Calm mode (user preference). Body attribute data-calm="true". Persists in user settings; default false. Targets only LOOPING animations (.act-pulse.live::after, .bubble-cluster .b.pulse::before, .rec-strip .rec-dot, .chat-typing span, .ambient .a-dot.live::after) — sets animation: none. Keeps hover/focus transitions but slows them to 120ms. ALSO triggers density reduction.
3. Density reduction (calm mode). Selectors that hide ancillary metadata: .murmur-files hidden, byline "via X" hidden, KB chip opacity 0.35, sidebar ambient labels hidden, card descriptions opacity 0.55. Hover the host row to reveal. Bottom-left pill reminds the user "Calm mode · hover any row for full detail".
4. Animation budget. Enforced by reviewer / lint: no more than 3 looping animations visible at once. A page that has the murmur dot pulse + recording strip + ambient strip live indicator + bubble cluster pulse is already over budget.

Contrast lock. Every text token MUST clear 4.5:1 against its host surface in both modes. V2.1 raised dark-mode --text-muted (was #8f99a3 → now #9aa3ab) and --text-subtle (was #6f767c → now #7d858c) after a contrast audit. Add a Storybook check that fails the PR on contrast regression.

Plain-language hierarchy. Human-readable name leads. Technical handle (slug, ID, protocol name) sits in --text-muted at one size smaller. Applied via the pattern: <span>Distill new content <span class="muted-suffix">· auto-summary</span></span>. Codify as a typography mixin in sageox-design.

Power-on-demand. Every keyboard shortcut MUST have a visible button. Every slash command MUST have a chip equivalent. Every ID MUST have a slug equivalent. Document in DESIGN.md.

Files. Global stylesheet (apps/web/src/index.css). New user setting under /settings/preferences for the Calm mode toggle. Hook: useCalmMode() reads from local state + persists to user prefs API.