docs: Mothership → Chat — dissolve the section, rework the IA around Sim-as-agent#4970
Draft
ouiliame wants to merge 4 commits into
Draft
docs: Mothership → Chat — dissolve the section, rework the IA around Sim-as-agent#4970ouiliame wants to merge 4 commits into
ouiliame wants to merge 4 commits into
Conversation
…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>
|
@ouiliame is attempting to deploy a commit to the Sim Team on Vercel. A member of the Team first needs to authorize it. |
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this does
Dissolves the Mothership section and reworks the IA around the product decision: Sim is the agent, the surface is Chat. Not a find-replace — the old section was a shadow IA (four of its eight pages mirrored the topic sections one-for-one, organized by interface instead of topic), so its content moves to where each capability is taught.
IA changes
/chat(command-center overview + research absorbed),/chat/tasks,/chat/mailer.mothership/workflows→/workflows/building-in-chat— building conversationally lives next to the visual builder.mothership/{tables,knowledge,files}→ "In chat" sections on their topic pages, with the full prompt collections preserved (grouped: creating/querying/updating/exporting, etc.)./mothership/*URL 308s to its specific new home;/copilotand/mailerchains retargeted to single hops..claude/rules/constitution.mdlanguage rules updated (Mothership → never-say column).New:
TryInChatcomponentClick-to-copy prompt lists teaching the prompting idiom per topic — 30+ instances across the chat pages and the topic "In chat" sections. The old Mothership pages were prompt showcases; this keeps the showcase, organized by topic.
Verified
Three-persona prose confusion test (brand-new user / returning Mothership user / deep builder) run via subagents; all confirmed blockers fixed — notably: the agents-you-build vs Sim-in-Chat and Chat vs chat-deployment disambiguations now live in body prose, not buried in FAQs; "an A2A agent" → "an A2A endpoint other agents can call"; legacy log trigger values labeled. Full-tree link sweep: 0 broken. All pages render; production build pattern unchanged.
https://docs.sim.ai/mothership(navbar/sidebar label)trigger: mothership/copilotenum values on the logs page (now annotated as legacy names for Chat)@mothership.sim.aimail domain on the Mailer page — flagged by our returning-user test as the most visible seam; a domain migration (or alias) is worth considering product-side/static/mothership/*asset paths (invisible to readers)chat/index¶2,introduction, andagents/index— if the wording reads wrong to you, that's the highest-value feedback./copilotnow redirects to/chat).🤖 Generated with Claude Code