Context Bundles

What is a context bundle?

A context bundle is a structured markdown document that combines your project outline with relevant code from your indexed codebase. It's designed to be pasted into an AI coding assistant so the assistant has full context for implementation.

What's included

Each context bundle contains:

• Project outline — your map's description, goals, and scope from the Outline tab
• Relevant code snippets — up to 20 code chunks pulled via semantic search from your indexed repos, including file paths, symbol names, and line numbers

The bundle is intentionally focused on the outline rather than individual stories. This gives the AI assistant a high-level understanding of the project without overwhelming it with too much detail.

Choosing a target system

When generating a bundle, you select which AI coding tool you're targeting:

• Lovable — for Lovable project prompts
• Cursor — for Cursor composer or chat
• Claude Code — for Claude Code sessions
• Windsurf — for Windsurf AI
• Generic — a general-purpose format for any AI coding agent

The target selection customizes the bundle header so the AI assistant understands the intended context.

Generating a bundle

1. Open your map and go to the Outline tab
2. Click the Context Bundle button in the top right
3. Select your target system from the dropdown
4. A progress bar shows while ArcLume searches your codebase for relevant code
5. Review the generated markdown in the preview modal
6. Click Copy to copy to clipboard, or Download to save as a .md file

Story-level bundles

You can also generate context bundles for individual stories. Open a story and click Generate Context Bundle. Story-level bundles include:

• Story title, description, and acceptance criteria
• Epic context
• Complexity and labels
• Implementation context
• Up to 25 relevant code snippets

Story-level bundles also support an AI Synthesize toggle that has Claude rewrite the bundle into an optimized prompt with clear instructions, specific file references, and architectural overview.

Using bundles with your tools

Context bundles work with any AI coding tool that accepts text input:

• Lovable — paste the bundle as your project prompt
• Cursor — paste into the composer or chat
• Claude Code — paste into your session, or use the MCP server for direct integration
• Windsurf — paste into the AI chat