docs: Mothership → Chat — dissolve the section, rework the IA around Sim-as-agent by ouiliame · Pull Request #4970 · simstudioai/sim

ouiliame

and others added 3 commits

June 10, 2026 19:01

…ce is Chat

The Mothership section was a shadow IA: four of its eight pages mirrored the
topic sections one-for-one, organized by interface instead of topic. With the
product retiring the brand (the built-in agent is just Sim, working in Chat),
the section dissolves into the docs proper:

- New Chat section, placed right after Get Started: chat/index (absorbs the
  command-center overview AND the research page), chat/tasks, chat/mailer.
- mothership/workflows -> workflows/building-in-chat, alongside the visual
  builder where it belongs.
- mothership/{tables,knowledge,files} fold into their topic indexes as
  condensed "In chat" sections — the capability lives with the topic.
- Prose voice throughout: "open Chat and ask" — Sim does things, Chat is the
  place. The user-built-agents collision is handled head-on (chat/index points
  at /agents; FAQ disambiguates Chat vs a chat deployment).
- Full reference sweep: homepage, introduction (10 refs), enterprise
  (retention/drains/access-control: "chat data"), costs voice table,
  workflows overview, getting-started FAQ, logs-debugging. App-facing
  literals deliberately kept until the app renames: the trigger enum values
  (mothership, copilot), drain category labels, and the @mothership.sim.ai
  mail domain.
- /mothership/:path* 308s to each new home (workflows/tables/knowledge/files/
  research/tasks/mailer all mapped individually); /copilot and /mailer chains
  retargeted to single hops.
- constitution.md language rules updated: Sim is the agent, "Chat" capitalized
  for the surface, "Mothership" moves to the never-say column.

Verified: all new pages render, every redirect class 308s to the right
target, full-tree link sweep 0 broken.

DO NOT MERGE until the app UI ships the rename — written for the future UI.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…on test

New TryInChat component (apps/docs/components/ui/try-in-chat.tsx): a titled,
click-to-copy prompt list that teaches the prompting patterns for the
surrounding page's topic. 23 instances replace the plain bullet example lists
across chat/index, chat/tasks, workflows/building-in-chat, and the In-chat
sections on tables/knowledgebase/files.

Three subagent readers (brand-new user, returning Mothership user, deep
builder) tested the renamed prose for confusion. Fixes from their confirmed
findings:

- chat/index: the agents-you-build and chat-deployment disambiguations move
  from a parenthetical and a buried FAQ into the body's second paragraph;
  subagents are marked as internal helpers, not agents you build.
- agents/index: "an agent in a chat" was ambiguous between an Agent block in
  a deployed chat and Sim's Chat — now "deployed as a chat"; and the missing
  statement that agents ship like any workflow (deploy as API/chat/MCP) is
  added, since chat/index pointed readers here for deployment.
- deployment/index: "an A2A agent" is a surface, not an agent — now "an A2A
  endpoint other AI agents can call".
- introduction: the agents bullet states the you-build vs Sim-in-Chat split at
  the first co-occurrence of both concepts.
- getting-started: <start.input> gets a reference-syntax gloss; "Chat panel"
  is pinned to the editor to avoid colliding with Chat.
- workflows overview: Start's entry points are "manual runs, API calls, and
  deployed chats" — the bare "chat" collided with three other meanings.
- logs: the mothership/copilot trigger values are labeled as legacy names for
  what is now Chat.
- building-in-chat: adds a build-an-agent prompt — the page never said Chat
  builds agents too.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

The old Mothership pages were prompt showcases — the dissolution kept the
structure but over-condensed them (~50 prompts down to ~10). The collections
are back, recovered from the pre-dissolution pages and integrated where they
teach: tables gets creating/querying/updating/exporting groups, knowledge
bases gets creating/adding/querying/managing, files gets documents/editing/
presentations/images/charts — each as a titled TryInChat block, click-to-copy.
Near-duplicates trimmed; the cross-table query capability folded into prose.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Five fixes beneath the rename: the How-you-build callout restated the lead
paragraph and the bullets a third time (cut); the anatomy section opened with
a negative strawman and claimed the sidebar mirrors a list containing
non-sidebar items (positive framing, claim dropped); the Integrations section
was a 25-name prose catalog duplicating the FAQ (now two sentences + the
catalog link; the FAQ keeps the list as its single home); 'Deployment options'
collided with Deployments-the-feature defined a section earlier (now
'Hosting'); the What-you-can-build bullets traded generic categories for
concrete examples.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…tled plainly

The folders page documented Name, Color, Nesting, and Order as individual
sections — reference-grade taxonomy for self-evident desktop-folder behavior.
Now one paragraph covers the basics, the two actions that genuinely do
something (locking, archiving) keep their substance, conventions compress to
one sentence-group, and the folders-vs-workspaces decision — the page's
actually useful part — stays intact. 78 lines -> 38.

/platform/workspaces was titled 'Workspace fundamentals'; it's 'Workspaces'.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Same V5-operation slip as using-in-workflows had (fixed in simstudioai#4896): there is no
'Get' operation — Read returns workspace file objects (not 'parsed files'),
Get Content returns text. Cards fixed: 'Using files in workflows' pointed at
passing-files, 'File block' pointed at the /files overview with the wrong
operation set — now /integrations/file with the real five. Verified accurate
while auditing: ElevenLabs audioFile output, write-time content-type detection
(manage/route.ts:351), Files panel categories, dedup suffix behavior.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>