Organizations

An Organization (internally called a “tenant”) is the top-level container for all data in GuideMode. Every team, repository, project, session, and metric belongs to exactly one organization, ensuring complete data isolation between different companies or workspaces.

Overview

When you sign up for GuideMode, an organization is created for you. This organization becomes the home for:

• People who are members of your organization
• Teams that group people together
• Repositories - code repositories connected from GitHub, GitLab, or Bitbucket that serve as the source for issues, pull requests, and deployments
• Projects - bodies of work from GitHub Projects, Linear Projects, or Jira Projects that group related issues across repositories
• Sessions uploaded from AI coding assistants
• Surveys for gathering team feedback
• Analytics derived from all of the above

All data is strictly isolated - members of one organization cannot see data from another organization.

Organization Structure

Key Fields

Field	Description
name	Display name for your organization (e.g., “Acme Corp”)
slug	URL-friendly identifier (e.g., “acme-corp”), must be unique
onboardingCompletedAt	When the initial setup wizard was completed
onboardingGoals	Goals selected during onboarding (discovery, delivery, etc.)
seedDataCreated	Whether demo/seed data was created for the organization

Organization Settings

Each organization has configurable settings that control behavior across the platform:

General Settings

Setting	Default	Description
timezone	UTC	Organization’s timezone for scheduling and reports
notificationsEnabled	true	Whether to send email notifications

Data Retention

Setting	Default	Description
autoCleanupEnabled	false	Automatically delete old data
autoCleanupDays	30	Days after which to clean up data
dataRetentionDays	90	How long to retain historical data

Survey Settings

Setting	Default	Description
surveyMinimumIntervalDays	7	Minimum days between surveys for a user
surveyMaxActivePerUser	1	Maximum concurrent pending surveys per user

Member Roles

People join organizations with specific roles that determine their permissions:

Role	Capabilities
Owner	Full control: billing, delete org, manage all settings, invite/remove anyone
Admin	Manage teams, settings, integrations, and members (except owner)
Member	View data, upload sessions, respond to surveys, access dashboards
Support	Special role for GuideMode support staff (not counted in billing)

Onboarding Flow

New organizations go through an onboarding wizard to configure initial settings:

1. Welcome - Introduction to GuideMode
2. Goals Selection - Choose focus areas (discovery, delivery, AI productivity)
3. Integration Connection - Connect GitHub, Jira, Linear, or Notion
4. Team Setup - Import or create initial teams
5. Seed Data (optional) - Create demo data to explore features

The onboardingCompletedAt timestamp records when this flow was finished.

Data Isolation

GuideMode implements strict multi-tenancy:

• Every database query is scoped to the current organization
• API authentication includes organization context
• Cross-organization data access is impossible through the API
• Background jobs process data within organization boundaries

This means:

• Your sessions and metrics are never visible to other organizations
• Your team structure and projects are completely private
• Your survey responses stay within your organization

Related Documentation

• People - Users within organizations
• Teams - Team structure and grouping
• Repositories - Code repository tracking
• Projects - Project tracking across providers
• Surveys - Team feedback system