# AgentCard / AgentMenuModal

## 2026-07-23 | Remove status dot, Switch is the only state cue

**Prompted by:** Hellen (PO)

### What changed
- Removed the leading status dot (green when enabled / grey when off) from the `AgentCard` header row.
- The `Switch` on the right is now the single source of on/off state; the row starts with the brand icon (when present) or the title.

### Why
- The dot duplicated the Switch's state and added visual noise.

### Affected tokens / files
- `packages/shadcn/src/components/ui/ai-builder/agent-card.tsx`


## 2026-07-22 | Optional brand icon slot on AgentCard

**Prompted by:** Clint

### What changed
- New optional `iconNode` prop on `AgentCard`: renders a 24px brand icon between the status dot and the title.
- No visual change when the prop is omitted.

### Why
- Platform Connector cards (Broker Engine, Quickli, Sales Trekker) need their real brand marks now that Clint supplied the logos.

### Affected tokens / files
- `packages/shadcn/src/components/ui/ai-builder/agent-card.tsx`


## 2026-07-12 — Agent-specific detail content, drop generic fallback copy (BUILD-2354)

**Prompted by:** Automated design pass for BUILD-2354 ("AI Builder Agent List: Categories,
Agent-Specific Details & Default-Off Toggles")

### What changed
- `AgentMenuModal`: added optional `example?: string` (a short "for example" scenario) and
  `dataTouched?: string[]` (badges listing the data this agent reads/writes), each rendered as
  its own labelled section only when provided.
- `AgentMenuModal`'s default `description` changed from a hardcoded mortgage-lead-gen sentence
  ("AI-powered lead management...") to a neutral "Details for this agent haven't been added yet."
  fallback.
- `AgentMenuModal`'s default `features` changed from the hardcoded `AGENT_FEATURES` list (Lead
  Capture / Initial Engagement / Smart Follow-Up / Appointment Scheduling / Performance Tracking —
  now removed) to an empty array; the feature-list section no longer renders when empty.

### Why
- The modal previously showed the exact same generic description + feature list for every agent
  regardless of which one was opened — the literal bug the PRD calls out. Callers must now supply
  agent-specific content (looked up from a slug-keyed content map, e.g.
  `AGENT_DETAIL_CONTENT` in `apps/docs/stories/_shared/ai-builder-mocks.ts`) or fall back to the
  agent's own backend `description` — the component itself no longer has a plausible-but-wrong
  default to silently fall back on.

### Affected tokens / files
- `packages/shadcn/src/components/ui/ai-builder/agent-card.tsx`
- Story: `apps/docs/stories/shadcn/templates/ai-builder/ai-builder.stories.tsx`
  ("AgentMenuModal — Authored" / "AgentMenuModal — Fallback (No Authored Content)")