Documentation

Tenant OwnerReviewerOperator

Product knowledge base, playbooks, and embedded guidance for every persona.

Workspace Settings

Workspace Settings define how CoffeeBreakAI behaves within your team environment—from automation rules and integrations to reviewer scheduling and workflow policies. Administrators can configure these options to match your team's processes, risk tolerance, and toolchain.

🔧 Core Workspace Settings

  • Minimum Confidence Threshold Tasks with a confidence score below this threshold are automatically routed to human review.

  • Default Priority The default priority assigned to new tasks created in this workspace.

  • Retry Policy Overrides Workspace-specific limits for retry attempts and backoff timing.

  • Review Requirements Define which task types always require human approval before progressing.

These settings help ensure consistent behavior across all tasks handled by CoffeeBreakAI.

👥 Membership & Access

  • Invite Accept URL Custom URL used when sending workspace invitations.

  • Invite Email Templates Adjustable subject and body templates for workspace invitations.

  • Workspace Owners Owners can modify workspace-level settings, manage membership, and override reviewer decisions.

🗂️ Integrations

Configure how CoffeeBreakAI connects to your development and project ecosystems.

Version Control

  • Version control provider — Choose where your repositories live (e.g., GitHub, Azure DevOps).
  • Default branch — Base branch for all new work (e.g., main).
  • Commit identity — Git author name and email used for commits.
  • Access token — Stored per-workspace; used for authenticated Git operations.

Code Review System

  • Determines which pull request platform CoffeeBreakAI uses when submitting work for review.

Project Management Provider

  • Link your workspace to task/epic tracking systems such as Jira or Azure Boards.

Event Syncing

  • Select which actions should sync back to your external systems (e.g., task status updates).

🧑‍⚖️ Review Settings

  • Default SLA The number of minutes allowed before a review becomes overdue.

  • Workspace Review Settings Each workspace maintains its own default SLA, minimum confidence threshold, and max retry count.

  • Workspace Overrides Override defaults for a specific workspace when unique needs apply.

  • Task Type Overrides Apply different SLAs for specific types of tasks (e.g., security reviews).

  • Execution Overrides The most specific level: combine task type + workspace for fine-grained control.

Approval Gates

Use approval gates to ensure sensitive work pauses until the right humans sign off.

  • Required Reviewers Specify which reviewer groups must approve before tasks advance.

  • Approval Policies Require unanimous approval, single-approver sign-off, or multi-stage review sequences.

  • Auditability Every approval decision is recorded with the reviewer identity, timestamp, and outcome so teams can export evidence during security reviews.

👥 Reviewer Configuration

Administrators can manage reviewer pools and availability.

Reviewer Pools

  • Assign reviewer pools based on types of work.
  • Allow workspace owners to adjust who can review what.
  • Toggle whether the CoffeeBreak managed reviewer pool should supplement your team when all reviewers are unavailable.

Availability & Scheduling

  • Configure availability windows for each reviewer.
  • Drag-and-drop scheduling on a weekly calendar.
  • Keyboard-friendly adjustments for precise time control.
  • Time zone awareness ensures schedules make sense globally.

Coverage Overview

  • See active reviewers, out-of-office entries, and weekly coverage at a glance.
  • Quickly identify gaps in schedule coverage.

Calendar Heatmap

  • Hour-by-hour heatmap showing reviewer density.
  • Highlights availability conflicts automatically.

Conflict Alerts

  • Overlapping availability windows are flagged visually so administrators can resolve them quickly.

Reviewer Groups

  • Create groups tied to specific task types, such as “Backend Reviewers” or “Security Reviewers.”
  • At least one reviewer (or fallback to CoffeeBreak) must be included.

🔀 Routing Rules

Routing rules give administrators control over how tasks flow:

  • Execution Type — The task category the rule applies to.
  • Agent Name — Optionally direct tasks to a specific agent.
  • Allowed Domains — Restrict certain work to specific internet domains.
  • Reviewer Group — Decide which reviewer group handles tasks requiring human review.

🧩 Process Definition

Design your internal workflow stages:

  • Steps — Define custom stages such as Draft → Review → Final Approval.
  • Required Fields — Enforce specific fields before advancing a task to the next step.
  • Templates — Add optional forms or checklists for users to complete at each stage.

CoffeeBreakAI automatically versions all process definitions so you can track historical changes.

📄 Pull Request Templates

Customize how CoffeeBreakAI generates pull requests.

  • Description Template Structure PR descriptions using tokens like {summary}, {linkedIssues}, {screenshots}, {agent}, {executionTime}, and {confidence}.

  • Comment Template Tailor automated follow-up comments using tokens such as {body}, {uiLink}, and {footer}.

Both templates support Markdown and can be previewed during configuration. Validation errors are explained clearly, and you can revert changes to the last saved version at any time.

✨ Why Workspace Settings Matter

A properly configured workspace ensures:

  • The right people review the right tasks
  • CoffeeBreakAI respects your team’s workflow and risk policies
  • Integrations behave predictably
  • Automation and human oversight stay in balance