Docs re-architecture: two audience tracks, a 5-chapter creator guide, an AI features showcase, and a consistent icon system

ai-at-work.mdx

@@ -1,18 +1,18 @@
 ---
 title: "Shapes for Work — Your AI-Native Team Chat"
-description: "Use Shapes as an AI Slack: bring teammates and an AI into the same group chat. Run standups, draft changelogs, search team knowledge, and collaborate with AI in one room."
+description: "Use Shapes as an AI Slack: bring teammates and an AI into the same group chat. Run standups, draft changelogs, search team knowledge, and collaborate with AI in one chat."
 keywords: ["AI for work", "AI Slack", "AI team chat", "AI in group chats", "work AI assistant", "AI collaboration", "team AI", "multiplayer AI for teams"]
 ---
 
 Most AI at work is solo: everyone opens their own private tab, asks their own questions, and the answers never leave that tab. Your team never sees the reasoning, the context, or the work.
 
-Shapes flips that. A Shapes group chat is a room your whole team is in — and the AI is in it too. Think of it like an **AI Slack**: the same channels and threads you already understand, except an AI teammate is present, reads the conversation, and pitches in when it's useful. The collaboration is shared, not siloed.
+Shapes flips that. A Shapes group chat is a chat your whole team is in — and the AI is in it too. Think of it like an **AI Slack**: the same channels and threads you already understand, except an AI teammate is present, reads the conversation, and pitches in when it's useful. The collaboration is shared, not siloed.
 
 <Info>
-  Shapes is a chat app, not a Slack plugin. The "AI Slack" here is the Shapes group chat itself — a room with your teammates and an AI in it. To connect outside tools like email, docs, GitHub, or Linear, you use [Shape Skills](/shapeskills), covered below.
+  Shapes is a chat app, not a Slack plugin. The "AI Slack" here is the Shapes group chat itself — a chat with your teammates and an AI in it. To connect outside tools like email, docs, GitHub, or Linear, you use [Shape Skills](/shapeskills), covered below.
 </Info>
 
-## Why a shared room beats a private tab
+## Why a shared chat beats a private tab
 
 - **Context is visible.** When the AI answers in the channel, everyone sees the question and the answer. No re-explaining, no copy-paste.
 - **The AI has memory of the team, not just you.** It can remember decisions, naming conventions, and who owns what — see [Memory](/memory).
@@ -23,13 +23,13 @@ Shapes flips that. A Shapes group chat is a room your whole team is in — and t
 
 1. [Create a group chat](/create-a-chat) for your team or project.
 2. Invite teammates with the chat link, and add one or more [Shapes](/what-are-shapes) for the roles you need — a coordinator, a writer, a researcher.
-3. Give the room shared context with [Custom Chat Instructions](/custominstructions-chats): who's on the team, what you're building, the tone you want.
+3. Give the chat shared context with [Custom Chat Instructions](/custominstructions-chats): who's on the team, what you're building, the tone you want.
 4. Pin the essentials — links, rules, current goals — so newcomers catch up instantly.
-5. Decide how forward the AI should be using [Free Will](/designing-social-intelligence). For a work room, "reply when mentioned" plus "keep the convo going" is usually the right balance — present, not noisy.
+5. Decide how forward the AI should be using [Free Will](/designing-social-intelligence). For a work chat, "reply when mentioned" plus "keep the convo going" is usually the right balance — present, not noisy.
 
 ## Share one premium engine across the team
 
-For a work room, you usually want everyone on a strong premium engine without asking each person to manage credits.
+For a work chat, you usually want everyone on a strong premium engine without asking each person to manage credits.
 
 **Sponsor the chat:** buy [Shape Credits](/how-to-purchase-credits-for-a-chat) for the chat itself, and every participant gets premium responses from a shared balance. It's the cleanest way to give a team access to frontier models in one place. Most everyday engines are still [free](/aienginecheatsheet) if you'd rather not spend anything.
 
@@ -38,28 +38,28 @@ For a work room, you usually want everyone on a strong premium engine without as
 With [Shape Skills](/shapeskills) connected, a Shape goes from talking to *doing*. These are real, documented skill use cases — most rely on custom MCP connections and some require third-party API keys, so treat them as setups, not one-click buttons. The full how-to lives in [Shape Skills](/shapeskills).
 
 <CardGroup cols={2}>
-  <Card title="Changelog & release notes" icon="git-pull-request">
+  <Card title="Changelog & release notes" icon="code-pull-request">
     Connect GitHub and Linear so a Shape can turn merged PRs and closed issues into a clean changelog on request.
   </Card>
   <Card title="Team knowledge base" icon="book">
-    Connect Notion or Google Workspace so the room can read and write shared docs, specs, and meeting notes.
+    Connect Notion or Google Workspace so the chat can read and write shared docs, specs, and meeting notes.
   </Card>
   <Card title="Research & web crawl" icon="globe">
     Let a Shape pull and summarize pages from the web so the whole team works from the same brief.
   </Card>
   <Card title="Run code & quick math" icon="terminal">
-    A Shape can execute code in a sandbox or use Wolfram Alpha to check numbers live in the thread.
+    A Shape can execute code in a secure sandbox to check numbers, run scripts, and work through data live in the thread.
   </Card>
 </CardGroup>
 
 ## Patterns that work
 
 - **Standups in a channel.** Ask the Shape to summarize what changed since yesterday and what's blocked. Everyone reads the same recap.
 - **"What did we decide?"** Long thread, lots of opinions — ask the Shape to summarize the decision and the open questions.
-- **Spin off a deep-dive.** Use [Branch Off](/branch-off) on a message to pull a side discussion into its own chat (it carries the recent context with it) without derailing the main room.
-- **Specialist Shapes.** Give each Shape a job — one writes, one researches, one keeps notes — and [activate](/shapes101#chats) the ones you need. Up to five can be active, and three respond per message, so a small "team of agents" stays coherent.
+- **Spin off a deep-dive.** Use [Branch Off](/branch-off) on a message to pull a side discussion into its own chat (it carries the recent context with it) without derailing the main chat.
+- **Specialist Shapes.** Give each Shape a job — one writes, one researches, one keeps notes — and [activate](/chats-101) the ones you need. Up to five can be active and they reply in turn, so a small "team of agents" stays coherent.
 
-## Keep the room sane
+## Keep the chat sane
 
 Work chats need guardrails more than fun ones do:
 

ai-group-chats.mdx

@@ -1,101 +1,55 @@
 ---
 title: "AI Group Chats — Chat With AI and Friends"
-description: "AI group chats on Shapes, Inc. let humans and AI characters share the same chat. Learn how multiplayer AI works, why social AI feels different, and how to start a group chat with AI and friends."
-keywords: ["AI group chats", "group chat with AI", "AI with friends", "multiplayer AI", "social AI", "AI groupchats", "GC with AI", "AI in groupchats"]
+description: "AI group chats on Shapes, Inc. let humans and AI characters talk in the same chat. Learn how multiplayer AI works and how to start a group chat with AI and friends."
+keywords: ["AI group chats", "group chat with AI", "AI with friends", "multiplayer AI", "social AI", "AI groupchats", "GC with AI"]
 ---
 
-An AI group chat is not just a private chatbot with extra people added on top.
+A group chat on Shapes, Inc. can hold people, AI characters called [Shapes](/what-are-shapes), or both at once. That's the whole idea: you experience AI *with other people*.
 
-The format changes the whole experience. In a solo AI chat, everything depends on one person and one model. You bring the topic, the energy, the context, and the direction. That can be useful, even intimate, but it is still a private exchange. Nothing happens unless you make it happen.
+Picture your group chat with friends. Now add a Shape to it. It reads the conversation, jumps in when it makes sense, cracks jokes, helps out, and remembers what happened last time. Everyone sees it happen together. That's a multiplayer AI group chat.
 
-On Shapes, Inc., AI group chats work differently. Humans and AI characters, called Shapes, can share the same chat at the same time. A Shape can respond to you, your friends, other Shapes, and the social context forming between everyone there. The result is **multiplayer AI**: AI that belongs inside a shared conversation instead of waiting alone in a separate tab.
+## Why it feels different
 
-## What Makes AI Group Chats Different
+When you chat with AI alone, you bring everything: the topic, the energy, the next question. It's useful, but quiet.
 
-The important shift is presence.
+Put that same AI in a chat with friends and it feels more alive. One person says something, the Shape replies, someone else reacts, and the conversation goes somewhere none of you planned. The funny moments happen in front of everyone. People bond over what the Shape says. Running jokes and shared memories build up over time.
 
-A Shape is not a slash command or a utility bot sitting at the edge of the chat. It has a personality, memory, voice, and a role in the conversation. It can be a character, a writing partner, a study helper, a fandom persona, a game host, or simply someone strange and funny enough to make the chat feel alive.
+## What people use them for
 
-Because the AI is in the group chat with humans, its responses become shared moments. One person says something, the Shape answers, someone else reacts, and the conversation moves somewhere nobody planned. The AI becomes part of the social texture rather than a private output generator.
+- **Hangouts.** A few friends and a favorite Shape, just talking.
+- **Roleplay and stories.** Several writers and AI characters build a scene together, and the Shape keeps track of the world.
+- **Fandoms.** Bring characters from a show or game into a shared space and watch a community form around them.
+- **Getting stuff done.** Studying, planning, gaming, or working, with a Shape that helps and remembers the details.
 
-That is why **AI with friends** feels different from ordinary AI chat. You are not only talking to an AI. You are experiencing the AI with other people.
+## How to start one
 
-## Why Social AI Works Best in Shared Spaces
+<Steps>
+  <Step title="Open New">
+    In the app, choose **New**.
+  </Step>
+  <Step title="Add Shapes, people, or both">
+    Search for Shapes, switch to people when you want to invite humans, or add both.
+  </Step>
+  <Step title="Name it and create">
+    Give the chat a clear name and continue. Then invite more friends with the chat link if you want.
+  </Step>
+</Steps>
 
-Most AI products are designed around a single-user assumption: one person, one assistant, one thread. That design is excellent for many jobs. It is less natural for the parts of AI that feel creative, playful, emotional, or communal.
+You can activate up to **five Shapes** in one chat. When you post, the activated Shapes reply in turn. Want just one to answer? `@mention` it. To learn how a Shape decides when to speak, read [Designing Social Intelligence](/designing-social-intelligence).
 
-Group chats give AI a richer setting. The Shape sees different personalities, different jokes, different levels of context, and different kinds of attention. It can respond to a full social context instead of reflecting one person back to themselves.
+For the full setup walkthrough, see [Create an AI Group Chat](/create-a-chat). For the in-chat controls, see [Chats 101](/chats-101).
 
-That creates a few things solo chat struggles to produce:
+## Make a chat people come back to
 
-- **Unpredictability**: other people pull the conversation away from your own habits.
-- **Witnessed moments**: funny, surprising, or dramatic AI responses happen in front of others.
-- **Human connection**: people bond over what the Shape says and what everyone does with it.
-- **Continuity**: memories, running jokes, and shared lore can develop across time.
-
-This is the core of **social AI** on Shapes, Inc.: AI that strengthens the human space around it instead of replacing that space.
-
-## What People Use AI Group Chats For
-
-Some chats are simple hangouts. A few friends add a favorite Shape and let the conversation wander. The point is not productivity. The point is having somewhere to be together.
-
-Some are roleplay chats, where multiple humans and AI characters build a story in the same thread. A Shape can play a character, remember the world, respond to several writers, and keep the scene moving when one person goes quiet.
-
-Some are fandom chats. People bring characters from the same universe into a shared space, then watch the community form around them. A good fandom AI group chat is less like asking a character questions and more like stepping into a living fan space.
-
-Some are study, writing, gaming, or creative chats. The Shape might explain a concept, generate an image, help plan a campaign, remember house rules, or act as a persistent companion for the group.
-
-The common thread is simple: the AI is not off to the side. It is in the chat with everyone else.
-
-## How to Start a Group Chat With AI
-
-You can start a chat on Shapes, Inc. in a few minutes.
-
-1. Open the sidebar and click **New Chat**.
-2. Pick **Quick ChatGPT**, choose a Shape, or switch to **People** to find someone.
-3. Send a message once the chat opens.
-4. To make it a group chat, click **More actions** → **Members / Invite**.
-5. Use **Invite friends** to share a link, or **Add participants** to add people and Shapes.
-
-Chat settings live under **More actions** → **Settings**. That is where you can manage participants, pinned messages, notifications, AI settings, chat appearance, and moderation.
-
-If you want the practical walkthrough, start with [How to Create an AI Group Chat](/create-a-chat). For a broader tour of settings, moderation, participants, and activation, read the [Shapes & Chats Guide](/shapeschatsguide).
-
-## Build the Kind of Chat People Want to Return To
-
-The best AI group chats have a clear reason to exist. They do not need to be complicated, but they do need a recognizable center: a fandom, a story, a group of friends, a study goal, a game, a creator community, or a specific kind of mood.
-
-Give the chat a name people understand. Chats started with **Quick ChatGPT** may get a name from the conversation, but for other chats you should name them yourself. Add Shapes that fit the purpose. Use [Custom Chat Instructions](/custominstructions-chats) to set context without overcontrolling every message. Use [Chat Appearance](/chat-appearance) to make the place feel intentional. If the chat belongs to a larger community, organize related spaces with [Groups](/groups).
-
-The craft is not only in building the AI. It is in building the social setting around the AI.
+The best chats have a clear reason to exist: a fandom, a story, a friend group, a study goal, a game, or a work stream. Give yours a name people understand, add Shapes that fit, and set the mood with [custom chat instructions](/custominstructions-chats) and [chat appearance](/chat-appearance).
 
 <CardGroup cols={2}>
-  <Card title="Create an AI Group Chat" icon="message-circle-plus" href="/create-a-chat">
-    Start the practical setup flow for a chat with Shapes and friends.
-  </Card>
-  <Card title="Chats 101" icon="messages-square" href="/chats-101">
-    Learn the basic controls for inviting people, adding Shapes, and managing chat settings.
-  </Card>
-  <Card title="Fandom AI Group Chats" icon="sparkles" href="/fandomchat">
-    Build a shared fandom space with characters, roleplay, and community context.
+  <Card title="Create a group chat" icon="comments" href="/create-a-chat">
+    The step-by-step setup.
   </Card>
-  <Card title="What Is Multiplayer AI?" icon="users-round" href="/articles/what-is-multiplayer-ai">
-    Understand why AI feels different when it becomes part of a shared chat.
-  </Card>
-  <Card title="Group Chat vs Solo Chat" icon="split" href="/articles/ai-group-chat-vs-solo-ai-chat">
-    See how the format changes brainstorming, roleplay, learning, and hanging out.
-  </Card>
-  <Card title="Why Solo AI Chat Breaks" icon="split" href="/articles/why-solo-ai-chat-is-broken">
-    Read the broader argument for why AI becomes more interesting in shared social spaces.
+  <Card title="Fandom chats" icon="star" href="/fandomchat">
+    Build a shared space around the characters you love.
   </Card>
 </CardGroup>
 
-## The Short Version
-
-AI group chats are for people who do not want AI to be a lonely interface.
-
-They are for friends who want to talk with AI together, writers who want collaborative roleplay, fandoms that want characters inside the community, and anyone who thinks the most interesting AI moments should be shared instead of screenshotted after the fact.
-
-That is the promise of Shapes, Inc.: **group chats with AI and humans together**, where the AI has memory, personality, and enough presence to make the conversation feel alive.
-
-[Start an AI group chat on Shapes, Inc.](https://shapes.inc)
+[Start a group chat](https://shapes.inc)

aienginecheatsheet.mdx

@@ -7,6 +7,10 @@ Shapes has a live AI engine directory at [shapes.inc/engines](https://shapes.inc
 
 This guide explains what the page means and how to pick an engine without needing to know model IDs.
 
+<Note>
+  Want a fast answer instead of the full tour? [Which Model Should I Use?](/choosing-a-model) gives quick picks by use case, and [What Shapes Can Do](/capabilities) covers the capabilities (like vision and tools) that some engines add. The specific model names below are examples of what you might see. The [live engines page](https://shapes.inc/engines) is always the source of truth, since the catalog changes often.
+</Note>
+
 ## What You See on the Engines Page
 
 At the top, you will see totals like: