> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devtune.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# DevTune Key Concepts and Terminology

> Reference for core DevTune concepts: projects, prompts, brands, tracked URLs, citations, share of voice, presence rate, and AI Search visibility metrics.

Before diving deeper into DevTune, it helps to understand the key concepts and terminology used throughout the platform.

## Core Concepts

### Projects

A **project** is your workspace for tracking one product or brand. Projects contain:

* Tracked prompts
* Brands, tracked URLs, and brand terms
* AI Search configuration
* Community Discourse and Owned Content context
* Actions workspace, briefs, backlog, and outcomes

### Product Context

**Product context** is the structured description of what your product does. During project creation, DevTune generates this automatically from your website URLs. You can review and edit it later from **Project Settings > General**.

Good product context leads to better prompt suggestions and more relevant recommendations.

### Brands

**Brands** are the organizational concept for competitive tracking. Each project has:

* A **primary brand** - your product or company
* **Competitor brands** - the brands you want to compare against

Each brand has associated tracked URLs and brand terms that DevTune uses to identify citations and mentions in AI responses.

## AI Search Concepts

### AI Search Platforms

DevTune monitors your visibility across AI-powered search platforms. The platforms available depend on your plan tier:

* **ChatGPT** - Starter and above
* **Perplexity** - Starter and above
* **Gemini** - Starter and above
* **Google AI Mode** - Pro and above
* **Microsoft Bing Copilot** - Pro and above

### Prompts

**Prompts** are the search queries you want to track across AI platforms. These are the kinds of questions users might ask when looking for solutions your product provides.

Prompts are managed from the **AI Search > Prompts** tab.

### Brand Terms

**Brand terms** are the text terms DevTune monitors for brand mentions in AI responses. These typically include your product name, company name, and common variations or abbreviations.

Brand terms are configured per brand from **Project Settings > Brands**.

### Tracked URLs

**Tracked URLs** are the domains and URLs DevTune monitors when they appear as citations in AI Search results. This typically includes:

* Your marketing website
* Your documentation site
* Your GitHub repository
* Competitor properties

Tracked URLs are managed per brand from **Project Settings > Brands**.

### Citations

**Citations** track when AI Search results link to specific URLs. This shows which of your pages are being referenced and how prominently they appear.

## Key Metrics

### Primary KPIs

These are the top-level metrics that summarize your AI Search visibility:

* **Overall Presence Rate** - The percentage of AI Search responses where your brand or tracked URLs appear
* **Share of Voice** - Your brand's share of total mentions and citations compared to competitors
* **Sentiment Score** - How positively or negatively AI platforms describe your brand when they mention it

### Secondary Metrics

These provide deeper insight into specific aspects of your visibility:

* **Docs Presence**
* **Blog Presence**
* **Brand Mentions**
* **Top of Answer**
* **Avg Citation Rank**
* **Primary Citation Share**

## Community Discourse Concepts

### Threads and Replies

Community Discourse tracks relevant discussions and their useful replies across supported developer communities.

### Source Overlaps

**Source overlaps** are threads that contain exact matches with your tracked URLs or URLs already being cited in AI Search.

### Clusters

**Clusters** are discussions where your primary brand and tracked competitors appear together, making them useful for competitive analysis.

## AI Traffic Concepts

### AI Bot Crawlers

**AI bot crawlers** are automated agents from AI platforms such as GPTBot or ClaudeBot that visit your website to index content.

### AI Referral Traffic

**AI referral traffic** consists of human visitors who arrive at your website after clicking a link in an AI-generated response.

### Tracking Snippet

The **tracking snippet** is the lightweight JavaScript snippet you install from **Project Settings > AI Traffic** to collect AI traffic data.

## Actions Concepts

### Suggestions

**Suggestions** are evidence-backed recommendations generated from the current state of your project.

### Briefs

A **brief** is a reusable execution artifact generated from a suggestion. Brief generation uses content credits.

### Content Credits

**Content credits** power brief generation and related content workflows:

* Included monthly credits come with your plan
* Purchased add-on credits never expire
* Automatic brief prewarming only uses a capped portion of included monthly credits
* Purchased add-on credits are used only after confirmation for manual generation

## Team Concepts

### Team Account

A **team account** is the shared workspace where projects are managed.

### Roles

DevTune has two primary roles:

* **Owner** - Full access including billing management, team settings, member management, and role management
* **Member** - Access to projects and analytics, with broad collaboration permissions

## Next Steps

* **[Create Your First Project](/getting-started/first-project)** - Set up your tracking
* **[Explore the Dashboard](/getting-started/dashboard-overview)** - Learn your way around
* **[Understand Visibility Metrics](/search-tracking/visibility-metrics)** - Dive deeper into metrics