Align inbox & scout copy with self-driving docs vocabulary (#3968)

Co-authored-by: posthog[bot] <206114724+posthog[bot]@users.noreply.github.com>
Co-authored-by: joshsny <7135900+joshsny@users.noreply.github.com>

Author: joshsny

apps/mobile/src/app/inbox/[...id].tsx

@@ -464,7 +464,7 @@ export default function ReportDetailScreen() {
 
         {/* Title */}
         <Text className="mb-2 font-semibold text-[18px] text-gray-12">
-          {report.title ?? "Untitled signal"}
+          {report.title ?? "Untitled report"}
         </Text>
 
         {/* Meta row */}
@@ -642,7 +642,7 @@ export default function ReportDetailScreen() {
       <DismissReportSheet
         visible={dismissOpen}
         reportId={report.id}
-        reportTitle={report.title?.trim() ? report.title : "Untitled signal"}
+        reportTitle={report.title?.trim() ? report.title : "Untitled report"}
         onClose={() => setDismissOpen(false)}
         onDismissed={handleDismissed}
       />

apps/mobile/src/features/inbox/components/ArchivedReportList.tsx

@@ -55,7 +55,7 @@ const ArchivedRow = memo(function ArchivedRow({
           numberOfLines={2}
           ellipsizeMode="tail"
         >
-          {report.title ?? "Untitled signal"}
+          {report.title ?? "Untitled report"}
         </Text>
 
         <View className="mt-1 flex-row flex-wrap items-center gap-2">

apps/mobile/src/features/inbox/components/ReportListRow.tsx

@@ -70,7 +70,7 @@ function ReportListRowComponent({ report, onPress }: ReportListRowProps) {
           numberOfLines={2}
           ellipsizeMode="tail"
         >
-          {report.title ?? "Untitled signal"}
+          {report.title ?? "Untitled report"}
         </Text>
 
         <View className="mt-1 flex-row items-center gap-2">

packages/ui/src/features/inbox/CLAUDE.md

@@ -4,13 +4,13 @@ The Inbox is the PostHog surface for **Self-driving**: agents that watch product
 
 ## Product Model
 
-The renderer still talks to backend endpoints and TypeScript types with the legacy `signals` naming. User-facing copy should say **Self-driving**, **Responder**, **report**, **run**, or **finding** depending on context. Do not rename backend paths or shared API fields unless the PostHog Cloud backend has changed too.
+The renderer still talks to backend endpoints and TypeScript types with the legacy `signals` naming. User-facing copy should say **Self-driving**, **agent**, **report**, **run**, or **signal** depending on context. Do not rename backend paths or shared API fields unless the PostHog Cloud backend has changed too.
 
 The main objects are:
 
 - `SignalReport`: the unit shown in all Inbox tabs.
 - Findings: the source observations that contributed to a report, fetched separately for detail screens.
-- Artefacts: structured agent output attached to a report, such as priority, actionability, suggested reviewers, repo selection, and findings from research.
+- Artefacts: structured agent output attached to a report, such as priority, actionability, suggested reviewers, repo selection, and signals from research.
 - Report tasks: links from a report to tasks created for research or implementation.
 
 ## Information Architecture
@@ -53,7 +53,7 @@ same artefact-lift pattern as `priority`/`actionability`/`already_addressed` —
 so cards avoid an N+1 per-card artefact fetch. Unknown reason codes fall back to
 the raw value; cards with no dismissal artefact simply omit the chip.
 
-Responder configuration is **not** an Inbox tab. It is the top-level Responders sidebar item at `/code/agents`. The legacy `/code/inbox/agents` route redirects there.
+Agent configuration is **not** an Inbox tab. It is the top-level Agents sidebar item at `/code/agents`. The legacy `/code/inbox/agents` route redirects there.
 
 Reviewer scope is a UI preference stored in `inboxReviewerScopeStore`. It filters the list between reports suggested for the current user and reports for someone else. It does not change tab membership; the tab predicates are independent.
 
@@ -90,7 +90,7 @@ Tab membership and counts live in `utils/reportMembership.ts`. Keep that file as
 Detail screens layer additional data on top of the base report:
 
 - `useInboxReportById(reportId)` for the report record.
-- `useInboxReportSignals(reportId)` for contributing findings.
+- `useInboxReportSignals(reportId)` for contributing signals.
 - `useInboxReportArtefacts(reportId)` for structured outputs such as suggested reviewers and repo selection.
 - `useReportTasks(reportId, status)` for linked research/implementation tasks.
 
@@ -102,7 +102,7 @@ The Inbox reads from PostHog Cloud's Self-driving backend, currently implemented
 
 - `GET /api/projects/{teamId}/signals/reports/`: paginated report list. Supports filters such as status, ordering, source product, suggested reviewers, and priority.
 - `GET /api/projects/{teamId}/signals/reports/{id}/`: single report detail.
-- `GET /api/projects/{teamId}/signals/reports/{id}/signals/`: contributing findings.
+- `GET /api/projects/{teamId}/signals/reports/{id}/signals/`: contributing signals.
 - `GET /api/projects/{teamId}/signals/reports/{id}/artefacts/`: structured report artefacts.
 - `GET /api/projects/{teamId}/signals/reports/{id}/tasks/`: tasks linked to a report.
 
@@ -112,7 +112,7 @@ Card headlines are derived client-side from `summary` by `utils/reportPresentati
 
 ## Configuration Surface
 
-Responder setup lives in `features/agents/components/AgentsView.tsx`, which mounts `ConfigureAgentsSection`. This surface composes existing GitHub, Slack, source-toggle, and MCP configuration pieces. Keep setup copy outcome-focused: the user is asking Self-driving to figure out what matters, not choosing internal artefact types.
+Agent setup lives in `features/agents/components/AgentsView.tsx`, which mounts `ConfigureAgentsSection`. This surface composes existing GitHub, Slack, source-toggle, and MCP configuration pieces. Keep setup copy outcome-focused: the user is asking Self-driving to figure out what matters, not choosing internal artefact types.
 
 Onboarding/setup should be task-backed when it starts work. Do not model it as a static checklist if the intended behavior is to launch an agent task.
 
@@ -124,7 +124,7 @@ Shared primitives exist to keep the surfaces consistent:
 
 - `InboxDetailPageHeader` for detail headers.
 - `DetailSection` for content sections inside detail screens.
-- `SignalsList` and the existing detail `SignalCard` for contributing findings.
+- `SignalsList` and the existing detail `SignalCard` for contributing signals.
 - Badge and metadata helpers in `components/utils/` and `InboxMetaRow`.
 - `SOURCE_PRODUCT_META` for source-product labels and icons.
 
@@ -134,7 +134,7 @@ When adding or changing UI, reuse those primitives first. Avoid encoding one-off
 
 - Do not reuse the deleted legacy `ReportListRow`, `ReportDetailPane`, or old list/detail stores.
 - Do not put page-level Inbox title or navigation into the global app header; `InboxView` owns the Inbox page chrome.
-- Do not add a configure shortcut back into the Inbox header; Responders configuration is a sidebar destination.
+- Do not add a configure shortcut back into the Inbox header; Agents configuration is a sidebar destination.
 - Scout (`signals_scout`) is a real Cloud source product. Keep it covered wherever source products surface: `INBOX_SOURCE_OPTIONS`, `SOURCE_PRODUCT_META`, and the scout-name display in `SignalCard`.
 - Scout management UI (fleet configuration, run history) lives in `features/scouts/` and is backed by the PostHog Cloud scout endpoints (`/api/projects/{teamId}/signals/scout/`). Do not add scout controls that have no backing endpoint there.
 - Do not put preview shims or mock report data in `apps/code/index.html`; the app shell should stay minimal.

packages/ui/src/features/inbox/components/AgentRunDetail.tsx

@@ -110,7 +110,7 @@ function RunOutputWidget({ report }: { report: SignalReport }) {
           </Text>
           <Text className="text-[12px] text-gray-11 leading-snug">
             Research couldn't complete – check the task log below for the error.
-            The Responder may retry automatically.
+            The agent may retry automatically.
           </Text>
         </Flex>
       </Flex>
@@ -123,7 +123,7 @@ function RunOutputWidget({ report }: { report: SignalReport }) {
         content={report.summary}
         fallback={
           report.status === "in_progress"
-            ? "The Responder is investigating – partial findings will appear here as they land."
+            ? "The agent is investigating – partial signals will appear here as they land."
             : "Queued for research."
         }
         variant="detail"
@@ -325,7 +325,7 @@ function AgentRunDetailContent({ report }: { report: SignalReport }) {
               <>
                 <InboxMetaSeparator />
                 <InboxMetaText className="tabular-nums">
-                  {signals.length} finding{signals.length === 1 ? "" : "s"}
+                  {signals.length} signal{signals.length === 1 ? "" : "s"}
                 </InboxMetaText>
               </>
             )}
@@ -412,7 +412,7 @@ function AgentRunDetailContent({ report }: { report: SignalReport }) {
                 title="Evidence so far"
                 rightSlot={
                   <Text className="cursor-default select-none text-[11px] text-gray-10 tabular-nums">
-                    {signals.length || report.signal_count} finding
+                    {signals.length || report.signal_count} signal
                     {(signals.length || report.signal_count) === 1 ? "" : "s"}
                   </Text>
                 }

packages/ui/src/features/inbox/components/ConfigureAgentsSection.tsx

@@ -124,7 +124,7 @@ export function ConfigureAgentsSection() {
 
       <Subsection
         title="Connections"
-        description="Foundational integrations responders read from and write to."
+        description="Foundational integrations agents read from and write to."
       >
         <GitHubIntegrationSection
           hasGithubIntegration={hasGithubIntegration}
@@ -138,7 +138,7 @@ export function ConfigureAgentsSection() {
         description={
           <>
             Scheduled agents that sweep this project on a cadence and emit
-            findings to your inbox.{" "}
+            signals to your inbox.{" "}
             {/* Placeholder docs link until a dedicated scouts page exists. */}
             <a
               href="https://posthog.com/blog/self-driving-product"
@@ -155,8 +155,8 @@ export function ConfigureAgentsSection() {
       </Subsection>
 
       <Subsection
-        title="Responders"
-        description="Each source: 1. watches for signals, 2. spins up a Responder when something matters, 3. hands you solutions."
+        title="Signal sources"
+        description="Each source watches for signals and spins up work when something matters."
       >
         {isLoading ? (
           <ResponderAgentRosterSkeleton />
@@ -207,7 +207,7 @@ export function ConfigureAgentsSection() {
 
       <Subsection
         title="MCP servers"
-        description="External tools responders can read from. PostHog data is always available; this is everything else."
+        description="External tools agents can read from. PostHog data is always available; this is everything else."
       >
         <Link
           to="/settings/$category"

packages/ui/src/features/inbox/components/DataSourceSetup.tsx

@@ -183,7 +183,7 @@ function GitHubSetup({ onComplete, onCancel }: SetupFormProps) {
         ? "We didn't hear back from GitHub. If the browser tab was closed, click Try again."
         : connecting
           ? "Waiting for GitHub… finish authorizing in your browser, then return here."
-          : "Connect your GitHub account to import issues as Self-driving findings.";
+          : "Connect your GitHub account to import issues as Self-driving signals.";
     return (
       <SetupFormContainer title="Connect GitHub">
         <Flex direction="column" gap="3">

packages/ui/src/features/inbox/components/InboxDetailFrame.tsx

@@ -137,7 +137,7 @@ export function InboxDetailFrame({
             {evidenceCount > 0 && (
               <>
                 <InboxMetaText className="tabular-nums">
-                  {evidenceCount} finding{evidenceCount === 1 ? "" : "s"}
+                  {evidenceCount} signal{evidenceCount === 1 ? "" : "s"}
                 </InboxMetaText>
                 <InboxMetaSeparator />
               </>
@@ -151,7 +151,7 @@ export function InboxDetailFrame({
                 <InboxMetaSeparator />
                 <InboxMetaSourceStack
                   sourceProducts={report.source_products}
-                  labelPrefix="Responder · "
+                  labelPrefix="Agent · "
                 />
               </>
             )}
@@ -181,7 +181,7 @@ export function InboxDetailFrame({
             <DetailSection Icon={SummaryIcon} title={summarySection.title}>
               <SignalReportSummaryMarkdown
                 content={report.summary}
-                fallback="No summary yet – the Responder is still investigating."
+                fallback="No summary yet – the agent is still investigating."
                 variant="detail"
                 pending={report.status === "in_progress"}
               />
@@ -196,7 +196,7 @@ export function InboxDetailFrame({
                 title={evidenceSection.title}
                 rightSlot={
                   <Text className="cursor-default select-none text-[11px] text-gray-10 tabular-nums">
-                    {evidenceCount} finding
+                    {evidenceCount} signal
                     {evidenceCount === 1 ? "" : "s"}
                   </Text>
                 }

packages/ui/src/features/inbox/components/PullRequestsTab.tsx

@@ -24,7 +24,7 @@ export function PullRequestsTab() {
         entireProjectTitle: "No pull requests in the project right now",
         teammateTitle: "No pull requests for this reviewer right now",
         description:
-          "When a Responder ships a code change, the PR draft lands here for you to review and publish.",
+          "When an agent ships a code change, the PR draft lands here for you to review and publish.",
       }}
     />
   );

packages/ui/src/features/inbox/components/ReportCard.tsx

@@ -323,7 +323,7 @@ export function ReportCard(props: ReportCardProps) {
         >
           <LightningIcon size={11} />
           <span className="tabular-nums">
-            {report.signal_count} finding
+            {report.signal_count} signal
             {report.signal_count !== 1 ? "s" : ""}
           </span>
         </Flex>