Maps & Stories

What is a map?

A map is the top-level workspace for planning a feature area or initiative. It groups related stories and transcripts in one place. Think of it as a project board scoped to a specific body of work.

Creating a map

From your organization's dashboard, click New Map. Give it a name and an optional description. You can update both later.

Map workspace

Each map has a multi-tab workspace with an AI chat panel:

• Outline — describe your project, goals, and scope. The outline is the foundation for AI story generation and context bundle generation. Changes auto-save as you type.
• Transcripts — paste or upload meeting transcripts and briefs. These provide additional context for the AI when generating stories.
• Diagrams — create and edit Mermaid diagrams to visualize architecture, flows, and relationships. Attach diagrams to stories for visual context.
• Stories — view, create, edit, and manage all stories. Generate stories with AI or create them manually. Copy individual stories or all at once.

On desktop, the Chat panel is always visible alongside the workspace. On mobile, tap the chat icon to open it as a drawer. The chat has full context of your outline, transcripts, stories, and indexed codebase. See Chat for details.

Stories

Stories are individual units of work. Each story includes:

• Title and description
• Acceptance criteria
• Complexity estimate — Small, Medium, or Large
• Labels — for categorization (frontend, backend, infrastructure, etc.)
• Implementation context — relevant code paths and patterns from your codebase

You can edit any field inline, reorder stories, and add or remove stories.

Generating stories with AI

From the Stories tab, click Generate with AI. The AI uses three sources of context:

• Project outline — from the Outline tab
• Meeting transcripts — all transcripts attached to the map
• Codebase context — relevant code retrieved via semantic search from your indexed repos

Claude creates stories in real time — you'll see them appear as the AI works. You can also generate stories conversationally through the Chat panel by asking questions like "Generate stories from my outline" or "Break this down into smaller tasks."

Working with stories

From the stories view, you can:

• Edit story details inline
• Generate a context bundle from the Outline tab for implementation handoff
• Push stories to Linear
• Copy individual stories or all stories to clipboard
• Create, update, or delete stories via the AI chat