From b866f8fecb3f163362d47680fb044a5a82083f4c Mon Sep 17 00:00:00 2001
From: only21mil <satsdev@only21mil.xyz>
Date: Sat, 31 Oct 2026 18:58:14 +0000
Subject: [PATCH 1/2] docs: composer banner guidance names a consumer that
 still exists

ComposerActivityStatus.tsx was deleted in #25401, but docs/internals/web-ui.md
still links it as the reference consumer and the ui-consistency review agent
still names it. Point both at ComposerPlanFollowUpBanner.tsx. The review agent
also stops citing ComposerStashBadge.tsx, which styles its own Root and Row and
so contradicts the "no styling of their own" claim it was an example of.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .macroscope/check-run-agents/ui-consistency.md | 2 +-
 docs/internals/web-ui.md                       | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.macroscope/check-run-agents/ui-consistency.md b/.macroscope/check-run-agents/ui-consistency.md
index 047dafbdd4be1..ed6d5860579e9 100644
--- a/.macroscope/check-run-agents/ui-consistency.md
+++ b/.macroscope/check-run-agents/ui-consistency.md
@@ -44,7 +44,7 @@ The reference for how this codebase wants UI built is the composer banner system
 
 - `ComposerBanner.tsx` exports one object of small slot components (`Root`, `Row`, `Icon`, `Content`, `Actions`, `Dismiss`, `Children`, and so on). Each slot owns its own Tailwind classes, exposes a `data-slot` attribute, takes `className` and spreads the rest of its props, and uses `cn` so callers can adjust without overriding. Variants and density are props on `Root`, not ad hoc class strings at call sites. Where a slot needs a real control it renders `Button` from `ui/` rather than a styled `<button>`.
 - `ComposerBannerStack.tsx` composes those slots into the ordered stack and owns only stack behavior (priority, expand and collapse, dismiss transitions).
-- Consumers such as `ComposerActivityStatus.tsx`, `ComposerStashBadge.tsx`, and `ComposerPlanFollowUpBanner.tsx` are a few lines of `<ComposerBanner.Row><ComposerBanner.Icon/><ComposerBanner.Content>…` with no styling of their own.
+- Consumers such as `ComposerPlanFollowUpBanner.tsx` are a few lines of `<ComposerBanner.Row><ComposerBanner.Icon/><ComposerBanner.Content>…` with no styling of their own.
 
 Hold new and changed UI to that shape:
 
diff --git a/docs/internals/web-ui.md b/docs/internals/web-ui.md
index 13b7d9df99fd0..2cb439a49e2b8 100644
--- a/docs/internals/web-ui.md
+++ b/docs/internals/web-ui.md
@@ -32,7 +32,7 @@ The composer banners are the reference.
 - [`ComposerBannerStack.tsx`](../../apps/web/src/components/chat/ComposerBannerStack.tsx) composes
   the slots and owns only stack behavior: priority, expand and collapse, dismiss transitions.
 - Consumers are a few lines of slots, and the slots carry the styling:
-  [`ComposerActivityStatus.tsx`](../../apps/web/src/components/chat/ComposerActivityStatus.tsx).
+  [`ComposerPlanFollowUpBanner.tsx`](../../apps/web/src/components/chat/ComposerPlanFollowUpBanner.tsx).
 
 Build new UI the same way. Compose or extend a component instead of copying its markup and classes.
 When a call site repeats a treatment another one already uses, make it a variant or a slot on the

From 12dc9c4163ef263673436a52c89a367bfa2d0e0b Mon Sep 17 00:00:00 2001
From: only21mil <satsdev@only21mil.xyz>
Date: Sat, 31 Oct 2026 19:37:11 +0000
Subject: [PATCH 2/2] docs: banner consumers style only their own content

ComposerPlanFollowUpBanner.tsx puts text classes on its own spans, so the
ui-consistency rule that consumers have "no styling of their own" flagged
the example it cites. Say consumers style only their own content and leave
banner styling to the slots, and say the same in web-ui.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .macroscope/check-run-agents/ui-consistency.md | 2 +-
 docs/internals/web-ui.md                       | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.macroscope/check-run-agents/ui-consistency.md b/.macroscope/check-run-agents/ui-consistency.md
index ed6d5860579e9..905823d1d1a9e 100644
--- a/.macroscope/check-run-agents/ui-consistency.md
+++ b/.macroscope/check-run-agents/ui-consistency.md
@@ -44,7 +44,7 @@ The reference for how this codebase wants UI built is the composer banner system
 
 - `ComposerBanner.tsx` exports one object of small slot components (`Root`, `Row`, `Icon`, `Content`, `Actions`, `Dismiss`, `Children`, and so on). Each slot owns its own Tailwind classes, exposes a `data-slot` attribute, takes `className` and spreads the rest of its props, and uses `cn` so callers can adjust without overriding. Variants and density are props on `Root`, not ad hoc class strings at call sites. Where a slot needs a real control it renders `Button` from `ui/` rather than a styled `<button>`.
 - `ComposerBannerStack.tsx` composes those slots into the ordered stack and owns only stack behavior (priority, expand and collapse, dismiss transitions).
-- Consumers such as `ComposerPlanFollowUpBanner.tsx` are a few lines of `<ComposerBanner.Row><ComposerBanner.Icon/><ComposerBanner.Content>…` with no styling of their own.
+- Consumers such as `ComposerPlanFollowUpBanner.tsx` are a few lines of `<ComposerBanner.Row><ComposerBanner.Icon/><ComposerBanner.Content>…` and style only their own content.
 
 Hold new and changed UI to that shape:
 
diff --git a/docs/internals/web-ui.md b/docs/internals/web-ui.md
index 2cb439a49e2b8..c54a3802be941 100644
--- a/docs/internals/web-ui.md
+++ b/docs/internals/web-ui.md
@@ -31,7 +31,7 @@ The composer banners are the reference.
   renders `Button`.
 - [`ComposerBannerStack.tsx`](../../apps/web/src/components/chat/ComposerBannerStack.tsx) composes
   the slots and owns only stack behavior: priority, expand and collapse, dismiss transitions.
-- Consumers are a few lines of slots, and the slots carry the styling:
+- Consumers are a few lines of slots, and the slots carry the banner styling:
   [`ComposerPlanFollowUpBanner.tsx`](../../apps/web/src/components/chat/ComposerPlanFollowUpBanner.tsx).
 
 Build new UI the same way. Compose or extend a component instead of copying its markup and classes.