From a48057e3c863b899e204be5e2cce45dd114e728b Mon Sep 17 00:00:00 2001
From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com>
Date: Wed, 9 Sep 2026 07:06:20 +0000
Subject: [PATCH] docs(TSP-1438): add builder home page Status section
 documentation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Documents the Status section on the builder home page — health strips,
performance charts, interactive click-through, and the Configure panel.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 build/home-page.mdx | 57 +++++++++++++++++++++++++++++++++++++++++++++
 docs.json           |  3 ++-
 2 files changed, 59 insertions(+), 1 deletion(-)
 create mode 100644 build/home-page.mdx

diff --git a/build/home-page.mdx b/build/home-page.mdx
new file mode 100644
index 00000000..b14a44c8
--- /dev/null
+++ b/build/home-page.mdx
@@ -0,0 +1,57 @@
+---
+title: 'Builder home page'
+sidebarTitle: 'Home page'
+description: 'An at-a-glance health overview of your agents and workforces on the builder home page.'
+---
+
+The builder home page includes a **Status** section that shows the recent health of your most important agents and workforces. The Status section is visible to project admins and editors.
+
+## What the Status section shows
+
+The section displays up to five agents or workforces. Each row contains three elements:
+
+| Element | Description |
+|---------|-------------|
+| **Name** | The agent or workforce name |
+| **30-day health strip** | Color-coded daily bars showing task health over the past 30 days |
+| **Performance score chart** | A compact chart of the agent's or workforce's recent performance score |
+
+## Clicking through to details
+
+Each row has three clickable areas that take you directly to the relevant page:
+
+<CardGroup cols={3}>
+  <Card title="Name" icon="robot" href="/build/agents/create-an-agent">
+    Clicking the agent or workforce name opens it in the builder.
+  </Card>
+  <Card title="Health strip" icon="chart-bar" href="/build/agents/give-your-agent-tasks/tasks-page">
+    Clicking a health bar opens Task Operations filtered to that agent or workforce.
+  </Card>
+  <Card title="Performance chart" icon="chart-line" href="/enterprise/analytics">
+    Clicking the performance chart opens the Analytics performance dashboard.
+  </Card>
+</CardGroup>
+
+<Note>
+The Analytics dashboard is an Enterprise feature. The performance chart links to it, but access depends on your plan. See [Analytics](/enterprise/analytics) for details.
+</Note>
+
+## Configuring the Status section
+
+By default, the Status section auto-selects agents and workforces ranked by most recent task activity. To control which items appear:
+
+<Steps>
+  <Step title="Open the configure panel">
+    Click **Configure** in the top-right corner of the Status section.
+  </Step>
+  <Step title="Select your items">
+    Choose the agents and workforces you want to track. You can select up to five items and drag them to set the display order.
+  </Step>
+  <Step title="Save">
+    Click **Save**. Your selection is saved per region and project.
+  </Step>
+</Steps>
+
+<Note>
+The Status section shows a maximum of five items. If you have not configured anything, the section falls back to the five agents or workforces with the most recent task activity.
+</Note>
diff --git a/docs.json b/docs.json
index ddf85285..e82e37e0 100644
--- a/docs.json
+++ b/docs.json
@@ -101,7 +101,8 @@
               {
                 "group": "Overview",
                 "pages": [
-                  "build/introduction"
+                  "build/introduction",
+                  "build/home-page"
                 ]
               },
               {