How BB Works

An overview of BB's operation, capabilities, and configuration options across all professional areas of expertise.

Objectives-Driven Intelligence

Collaboration Structure

BB maintains context through a hierarchical objectives system that works across all areas of expertise:

  • Collaboration Goal: Set at start, provides overall context and purpose for your project
  • Statement Objectives: Generated for each user input, guides immediate tasks toward your goal
  • Turn Tracking: Monitors progress within maximum allowed turns (default: 25) to maintain focus

Expertise-Specific Examples:

Research Project:

Goal: "Analyze climate adaptation strategies in coastal cities"
Objective: "Extract key findings from these 15 papers"

Content Project:

Goal: "Create Q3 content strategy for sustainable investing"
Objective: "Develop an outline for the pillar content"

Orchestrator and Background Agents

For bigger jobs, BB can split the work. The orchestrator (the assistant you talk to) hands tasks to background agents and carries on while they work; each agent's report comes back into the conversation when it's done. Personas decide each role's model, instructions, tools and limits. See Orchestrator & Agents and Personas.

Capabilities Across Areas Of Expertise

BB employs a variety of capabilities to support different professional areas of expertise:

Research Capabilities:

  • Literature analysis and synthesis
  • Research methodology development
  • Data processing and visualization
  • Academic manuscript preparation

Content Creation Capabilities:

  • Content research and organization
  • Structured content planning
  • Multi-channel content adaptation
  • Brand voice consistency management

Analysis Capabilities:

  • Data source integration
  • Statistical analysis and pattern identification
  • Interactive visualization creation
  • Business insights extraction

Development Capabilities:

  • System architecture design
  • Code implementation and refactoring
  • Testing and documentation
  • Integration with existing systems

Technical Operation

Project Understanding

BB builds an understanding of your entire project context, regardless of area of expertise:

  • File Discovery: BB explores your project files to understand their content and relationships
  • Context Building: BB maintains awareness of your project's structure and purpose across collaborations
  • Expertise Awareness: BB adapts its approach based on your project type and expertise-specific needs

Project Types:

  • Research Projects: Literature collections, data sets, research notes
  • Content Projects: Content strategies, drafts, assets, distribution materials
  • Analysis Projects: Data sources, analysis scripts, visualizations, reports
  • Development Projects: Source code, configurations, tests, documentation

Project Manipulation

BB can create, modify, and organize files across all project types:

  • Content Changes: BB can modify existing files or create new ones with precision
  • Project Organization: BB can reorganize files and directories to improve project structure
  • Integration: BB can help integrate with external services and APIs

Expertise-Specific Examples:

  • Research: Creating structured literature reviews, organizing research findings
  • Content: Developing content calendars, adapting content for different channels
  • Analysis: Building interactive dashboards, creating data visualization scripts
  • Development: Implementing features, refactoring code, creating documentation

Resource Management

Token Usage and Collaboration Management

Managing resources effectively ensures optimal performance across all project types:

  • Collaborations have a token limit to maintain quality and performance
  • Each collaboration turn and file contributes to token usage
  • Breaking complex projects into focused collaborations improves efficiency
  • Using collaboration summaries helps maintain context while reducing token usage

Efficiency Tips by Area Of Expertise:

Research Projects:

  • Focus on one research question per collaboration
  • Share only relevant papers for specific analyses
  • Use separate collaborations for literature review vs. data analysis

Content Projects:

  • Create separate collaborations for strategy vs. creation
  • Focus on one content piece or channel at a time
  • Use collaboration summaries to track content decisions

Configuration Options

Customizing BB for Your Needs

BB can be configured to better support your specific area of expertise and project requirements:

Turn Limit

Control collaboration length to manage complexity:

api.maxTurns: 25 // Default value

Allowed Commands

Configure external commands BB can access:

api.toolConfigs.execute.allowedCommands: [ // File operations "ls", "cd", "pwd", "mv", "cp", "mkdir", // Content operations "cat", "find", "grep", "tree", // Version control "git branch", "git checkout", // Add expertise-specific tools here // ... ]

Troubleshooting Guide

Common Issues

Incremental Progress

What you might observe:

  • BB making multiple small changes rather than one large change
  • Verifying each step before proceeding
  • Adjusting approach based on results

This is normal behavior across all areas of expertise. BB works incrementally to ensure accuracy and quality.

Clarifying Questions

Why it happens:

  • BB needs to understand your objective clearly
  • Expertise-specific details may require clarification
  • Project context influences the approach

Answering BB's questions helps ensure the results match your expectations. More context leads to better outcomes.

Resource Limitations

Solutions:

  • Break complex objectives into smaller collaborations
  • Use collaboration summaries to maintain context
  • Focus on one aspect of your project at a time
  • Remove unnecessary files from the collaboration

Expertise-Specific Guides

Next Steps

Last updated: November 13, 2026