# AgentCategorySection

## 2026-07-12 — New component (BUILD-2354)

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

### What changed
- New organism: overline title + optional count `Badge` + optional description + a responsive
  card grid (`grid-cols-1 sm:grid-cols-2 lg:grid-cols-3`) that accepts arbitrary `children`.
- Renders `children` generically rather than a typed `agents: []` array, so a single section can
  mix different card types (e.g. `AgentCard` and `IntegrationServiceCard`) when the category
  genuinely contains both kinds of entity.

### Why
- No existing component grouped arbitrary cards under a titled, countable section — the closest
  thing was a `SectionBlock` defined locally inside the Agent List page story (not exported, not
  reusable, shaped for form sections rather than card grids).
- Generic `children` (over a typed array) keeps the organism dumb/reusable and lets the page own
  composition — matches this repo's "templates/pages own the mock/real data wiring" convention.
  Platform Connectors needed to mix `AgentCard` (Broker Engine, Quickli) and
  `IntegrationServiceCard` (Gmail, etc.) in the same section at the time this was built; a
  typed-array API couldn't express that without a second "kind" discriminant.

### Affected tokens / files
- `packages/shadcn/src/components/ui/ai-builder/agent-category-section.tsx`
- Story: `apps/docs/stories/shadcn/templates/ai-builder/ai-builder.stories.tsx`
  ("AgentCategorySection — Platform Connectors")