Skip to main content

Crew Configuration

Customize your AI crews to match your specific requirements, brand voice, and workflow preferences.

Configuration Basics​

Every crew can be configured at multiple levels:

  1. Global Settings - Apply to all outcomes
  2. Crew-Specific Settings - Apply to a particular crew type
  3. Outcome-Level Settings - Override defaults for individual outcomes

Access Configuration​

Via Dashboard:

  1. Go to Settings → Crews in your HornetHive dashboard
  2. Select the crew you want to configure
  3. Modify settings and save

Via API:

POST /v1/crews/{crew_id}/configure

HiveWriter Configuration​

Content Guidelines​

{
  "brand_voice": {
    "tone": "professional yet approachable",
    "style": "conversational",
    "avoid_phrases": ["leverage", "synergy", "best practice"],
    "preferred_phrases": ["use", "work together", "effective approach"]
  },
  "content_structure": {
    "include_intro": true,
    "include_conclusion": true,
    "use_subheadings": true,
    "max_paragraph_length": 150
  },
  "seo_settings": {
    "target_keywords": ["AI automation", "business efficiency"],
    "meta_description_template": "Learn how {topic} can {benefit} for {audience}",
    "include_alt_text": true
  }
}

Publishing Rules​

{
  "auto_publish": {
    "enabled": false,
    "channels": ["linkedin", "company_blog"],
    "schedule": "immediate",
    "approval_required": true
  },
  "content_formats": {
    "blog_posts": {
      "format": "markdown",
      "include_toc": true,
      "word_count_range": [800, 1500]
    },
    "social_posts": {
      "platform_optimization": true,
      "include_hashtags": true,
      "character_limits": {
        "linkedin": 3000,
        "twitter": 280
      }
    }
  }
}

Quality Controls​

{
  "review_settings": {
    "fact_checking": true,
    "plagiarism_check": true,
    "brand_compliance": true,
    "readability_score_min": 60
  },
  "approval_workflow": {
    "require_human_review": true,
    "reviewers": ["content-team@company.com"],
    "auto_approve_score_threshold": 95
  }
}

HivePilot Configuration​

PRD Templates​

{
  "prd_structure": {
    "sections": [
      "executive_summary",
      "problem_statement", 
      "user_stories",
      "technical_requirements",
      "success_metrics",
      "timeline"
    ],
    "detail_level": "comprehensive",
    "include_mockups": false
  },
  "stakeholder_settings": {
    "target_audiences": ["engineering", "design", "product"],
    "technical_depth": "medium",
    "business_context": "always_include"
  }
}

Ticket Generation​

{
  "ticket_settings": {
    "story_point_estimation": true,
    "default_assignee": "unassigned",
    "priority_mapping": {
      "critical": "P0",
      "high": "P1", 
      "medium": "P2",
      "low": "P3"
    },
    "include_acceptance_criteria": true
  },
  "integration_settings": {
    "jira_project": "PROD",
    "linear_team": "product-team",
    "default_labels": ["ai-generated", "needs-review"]
  }
}

Delivery Tracking​

{
  "tracking_settings": {
    "check_frequency": "daily",
    "alert_on_delays": true,
    "stakeholder_updates": "weekly",
    "blockers_escalation": true
  },
  "reporting": {
    "include_velocity_metrics": true,
    "burndown_charts": true,
    "risk_assessment": true
  }
}

HiveMind Configuration​

Meeting Processing​

{
  "meeting_settings": {
    "auto_summarize": true,
    "extract_action_items": true,
    "identify_decisions": true,
    "track_attendees": true,
    "meeting_types": ["standup", "planning", "retrospective", "all-hands"]
  },
  "summary_format": {
    "style": "executive_summary",
    "max_length": 500,
    "include_timestamps": false,
    "highlight_blockers": true
  }
}

Task Management​

{
  "task_settings": {
    "auto_assign": false,
    "due_date_estimation": true,
    "priority_scoring": true,
    "dependency_detection": true
  },
  "notification_rules": {
    "slack_channels": ["#general", "#product"],
    "email_stakeholders": true,
    "escalation_timeline": "24_hours"
  }
}

Context Integration​

{
  "context_sources": {
    "slack_channels": ["#engineering", "#product", "#general"],
    "google_calendar": true,
    "project_management": ["jira", "linear"],
    "documentation": ["notion", "confluence"]
  },
  "processing_rules": {
    "ignore_informal_messages": true,
    "context_window": "7_days",
    "relevance_threshold": 0.7
  }
}

Global Configuration​

Team Settings​

{
  "team_preferences": {
    "timezone": "America/New_York",
    "business_hours": {
      "start": "09:00",
      "end": "17:00",
      "days": ["monday", "tuesday", "wednesday", "thursday", "friday"]
    },
    "holiday_calendar": "US",
    "emergency_contacts": ["ops@company.com"]
  }
}

Integration Defaults​

{
  "integrations": {
    "slack": {
      "default_channel": "#ai-crew-updates",
      "mention_on_completion": false,
      "thread_responses": true
    },
    "google_drive": {
      "default_folder": "/HornetHive Outcomes",
      "sharing_permissions": "view",
      "auto_organize": true
    },
    "linear": {
      "default_project": "PROD",
      "auto_assign_team": "product",
      "status_sync": true
    }
  }
}

Security & Compliance​

{
  "security_settings": {
    "data_retention": "90_days",
    "pii_detection": true,
    "content_filtering": true,
    "audit_logging": true
  },
  "compliance": {
    "gdpr_mode": false,
    "data_residency": "US",
    "encryption_at_rest": true,
    "access_logging": true
  }
}

Advanced Configuration​

Custom Prompts​

Override default agent prompts for specialized use cases:

{
  "custom_prompts": {
    "content_agent": {
      "system_prompt": "You are a technical writer specializing in AI/ML content...",
      "temperature": 0.7,
      "max_tokens": 2000
    },
    "editor_agent": {
      "system_prompt": "You are a senior editor focused on clarity and engagement...",
      "temperature": 0.3,
      "max_tokens": 1500
    }
  }
}

Outcome Templates​

Create reusable templates for common tasks:

{
  "templates": {
    "weekly_report": {
      "crew": "hivemind",
      "brief_template": "Summarize this week's progress for {team}",
      "default_context": "Include: completed work, blockers, next week priorities",
      "requirements": {
        "format": "executive_summary",
        "length": "500-750 words",
        "tone": "professional"
      }
    },
    "feature_announcement": {
      "crew": "hivewriter", 
      "brief_template": "Announce new feature: {feature_name}",
      "default_context": "Target audience: existing customers",
      "requirements": {
        "format": "blog_post",
        "tone": "excited but professional",
        "include_screenshots": true
      }
    }
  }
}

Workflow Automation​

Set up automated crew deployment based on triggers:

{
  "automation_rules": [
    {
      "trigger": "calendar_event",
      "condition": "title contains 'standup'",
      "action": {
        "deploy_crew": "hivemind",
        "brief": "Summarize standup meeting and extract action items",
        "auto_approve": false
      }
    },
    {
      "trigger": "slack_message",
      "condition": "channel=#product AND mentions @ai-crew",
      "action": {
        "deploy_crew": "hivewriter",
        "brief": "Create social media post based on this announcement",
        "requirements": {
          "platforms": ["linkedin", "twitter"]
        }
      }
    }
  ]
}

Configuration Examples​

For Content Marketing Teams​

{
  "crew": "hivewriter",
  "brand_voice": {
    "tone": "friendly and helpful",
    "target_audience": "small business owners",
    "key_messages": ["AI makes work easier", "save time and money"]
  },
  "content_calendar": {
    "posting_schedule": "Tuesday/Thursday",
    "content_mix": {
      "educational": 60,
      "promotional": 20, 
      "behind_scenes": 20
    }
  },
  "seo_optimization": {
    "target_keywords": ["AI automation", "small business tools"],
    "competitor_analysis": true,
    "trending_topics": true
  }
}

For Product Teams​

{
  "crew": "hivepilot",
  "development_process": {
    "methodology": "agile",
    "sprint_length": "2_weeks",
    "story_point_scale": "fibonacci"
  },
  "stakeholder_communication": {
    "update_frequency": "weekly",
    "report_format": "dashboard_summary",
    "escalation_rules": {
      "blocked_items": "immediate",
      "scope_changes": "24_hours"
    }
  }
}

For Operations Teams​

{
  "crew": "hivemind",
  "meeting_optimization": {
    "max_meeting_length": "30_minutes",
    "require_agenda": true,
    "auto_followup": true
  },
  "task_prioritization": {
    "criteria": ["business_impact", "effort", "dependencies"],
    "auto_assignment": false,
    "capacity_planning": true
  }
}

Configuration Best Practices​

1. Start Simple​

Begin with default settings and gradually customize based on your team's needs.

2. Test Changes​

Use outcome templates to test configuration changes before applying globally.

3. Version Control​

Keep track of configuration changes and their impact on outcome quality.

4. Team Alignment​

Ensure all team members understand and agree on crew configurations.

5. Regular Review​

Periodically review and update configurations as your team's needs evolve.

Troubleshooting Configuration​

Common Issues​

Outcomes don't match expected tone: → Check brand_voice settings and provide more specific examples

Content is too technical/simple: → Adjust target_audience and technical_depth settings

Integrations not working: → Verify API keys and permission settings

Low quality scores: → Review quality control settings and approval thresholds

Getting Help​

  • Documentation: Detailed guides for each crew type
  • Support: hello@hornethive.ai
  • Community: Share configuration tips with other users

Next Steps: