feat: Add linting script for coder_agent naming conventions

Add a simple bash script that validates module documentation uses coder_agent.main consistently. This can be integrated into CI to prevent future inconsistencies. The script checks: - Module README files use coder_agent.main - Example templates use coder_agent.main - Root documentation uses coder_agent.main Usage: ./scripts/lint-agent-names.sh
docs: Standardize module examples to use coder_agent.main
2026-06-06 06:28:14 +00:00 · 2025-11-26 19:09:38 +00:00 · 2025-11-26 18:56:30 +00:00
53 changed files with 262 additions and 200 deletions
@@ -39,7 +39,7 @@ module "cursor" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/cursor/coder"
  version  = "1.0.19"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -18,6 +18,6 @@ module "pgadmin" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/AJ0070/pgadmin/coder"
  version  = "1.0.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```
@@ -15,7 +15,7 @@ module "rustdesk" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/BenraouaneSoufiane/rustdesk/coder"
  version  = "1.0.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -42,7 +42,7 @@ module "rustdesk" {
  count             = data.coder_workspace.me.start_count
  source            = "registry.coder.com/BenraouaneSoufiane/rustdesk/coder"
  version           = "1.0.0"
-  agent_id          = coder_agent.example.id
+  agent_id          = coder_agent.main.id
  rustdesk_password = "mycustompass"
  xvfb_resolution   = "1920x1080x24"
  rustdesk_version  = "1.4.1"
@@ -16,7 +16,7 @@ up a default or custom tmux configuration with session save/restore capabilities
 module "tmux" {
  source   = "registry.coder.com/anomaly/tmux/coder"
  version  = "1.0.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -40,7 +40,7 @@ module "tmux" {
 module "tmux" {
  source        = "registry.coder.com/anomaly/tmux/coder"
  version       = "1.0.1"
-  agent_id      = coder_agent.example.id
+  agent_id      = coder_agent.main.id
  tmux_config   = ""                        # Optional: custom tmux.conf content
  save_interval = 1                         # Optional: save interval in minutes
  sessions      = ["default", "dev", "ops"] # Optional: list of tmux sessions
@@ -15,7 +15,7 @@ module "archive" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder-labs/archive/coder"
  version  = "0.0.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id

  paths = ["./projects", "./code"]
 }
@@ -44,7 +44,7 @@ module "archive" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder-labs/archive/coder"
  version  = "0.0.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id

  # Paths to include in the archive (files or directories).
  directory = "~"
@@ -62,7 +62,7 @@ module "archive" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder-labs/archive/coder"
  version  = "0.0.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id

  directory    = "/"
  paths        = ["/etc", "/home"]
@@ -79,7 +79,7 @@ module "archive" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder-labs/archive/coder"
  version  = "0.0.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id

  # Creates /tmp/coder-archive.tar.gz of the users home directory (defaults).
  create_on_stop = true
@@ -93,7 +93,7 @@ module "archive" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder-labs/archive/coder"
  version  = "0.0.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id

  # Where to look for the archive file to extract:
  output_dir   = "/tmp"
@@ -14,7 +14,7 @@ Run Auggie CLI in your workspace to access Augment's AI coding assistant with ad
 module "auggie" {
  source   = "registry.coder.com/coder-labs/auggie/coder"
  version  = "0.2.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"
 }
 ```
@@ -42,13 +42,13 @@ module "coder-login" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/coder-login/coder"
  version  = "1.0.31"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }

 module "auggie" {
  source   = "registry.coder.com/coder-labs/auggie/coder"
  version  = "0.2.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"

  # Authentication
@@ -104,7 +104,7 @@ EOF
 module "auggie" {
  source   = "registry.coder.com/coder-labs/auggie/coder"
  version  = "0.2.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"

  # Multiple MCP configuration files
@@ -14,7 +14,7 @@ Run Codex CLI in your workspace to access OpenAI's models through the Codex inte
 module "codex" {
  source         = "registry.coder.com/coder-labs/codex/coder"
  version        = "3.1.0"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  openai_api_key = var.openai_api_key
  workdir        = "/home/coder/project"
 }
@@ -34,7 +34,7 @@ module "codex" {
  count          = data.coder_workspace.me.start_count
  source         = "registry.coder.com/coder-labs/codex/coder"
  version        = "3.1.0"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  openai_api_key = "..."
  workdir        = "/home/coder/project"
  report_tasks   = false
@@ -56,13 +56,13 @@ module "coder-login" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/coder-login/coder"
  version  = "1.0.31"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }

 module "codex" {
  source         = "registry.coder.com/coder-labs/codex/coder"
  version        = "3.1.0"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  openai_api_key = "..."
  ai_prompt      = data.coder_parameter.ai_prompt.value
  workdir        = "/home/coder/project"
@@ -14,7 +14,7 @@ Run [GitHub Copilot CLI](https://docs.github.com/copilot/concepts/agents/about-c
 module "copilot" {
  source   = "registry.coder.com/coder-labs/copilot/coder"
  version  = "0.2.2"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  workdir  = "/home/coder/projects"
 }
 ```
@@ -52,7 +52,7 @@ data "coder_parameter" "ai_prompt" {
 module "copilot" {
  source   = "registry.coder.com/coder-labs/copilot/coder"
  version  = "0.2.2"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  workdir  = "/home/coder/projects"

  ai_prompt       = data.coder_parameter.ai_prompt.value
@@ -72,7 +72,7 @@ Customize tool permissions, MCP servers, and Copilot settings:
 module "copilot" {
  source   = "registry.coder.com/coder-labs/copilot/coder"
  version  = "0.2.2"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  workdir  = "/home/coder/projects"

  # Version pinning (defaults to "latest", use specific version if desired)
@@ -143,7 +143,7 @@ variable "github_token" {
 module "copilot" {
  source       = "registry.coder.com/coder-labs/copilot/coder"
  version      = "0.2.2"
-  agent_id     = coder_agent.example.id
+  agent_id     = coder_agent.main.id
  workdir      = "/home/coder/projects"
  github_token = var.github_token
 }
@@ -157,7 +157,7 @@ Run Copilot as a command-line tool without task reporting or web interface. This
 module "copilot" {
  source       = "registry.coder.com/coder-labs/copilot/coder"
  version      = "0.2.2"
-  agent_id     = coder_agent.example.id
+  agent_id     = coder_agent.main.id
  workdir      = "/home/coder"
  report_tasks = false
  cli_app      = true
@@ -14,7 +14,7 @@ Run the Cursor Agent CLI in your workspace for interactive coding assistance and
 module "cursor_cli" {
  source   = "registry.coder.com/coder-labs/cursor-cli/coder"
  version  = "0.2.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"
 }
 ```
@@ -43,7 +43,7 @@ module "coder-login" {
 module "cursor_cli" {
  source   = "registry.coder.com/coder-labs/cursor-cli/coder"
  version  = "0.2.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"

  # Optional
@@ -14,7 +14,7 @@ Run [Gemini CLI](https://github.com/google-gemini/gemini-cli) in your workspace
 module "gemini" {
  source   = "registry.coder.com/coder-labs/gemini/coder"
  version  = "2.1.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"
 }
 ```
@@ -47,7 +47,7 @@ variable "gemini_api_key" {
 module "gemini" {
  source         = "registry.coder.com/coder-labs/gemini/coder"
  version        = "2.1.1"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  gemini_api_key = var.gemini_api_key
  folder         = "/home/coder/project"
 }
@@ -80,7 +80,7 @@ module "coder-login" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/coder-login/coder"
  version  = "~> 1.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }

 data "coder_parameter" "ai_prompt" {
@@ -95,7 +95,7 @@ module "gemini" {
  count                = data.coder_workspace.me.start_count
  source               = "registry.coder.com/coder-labs/gemini/coder"
  version              = "2.1.1"
-  agent_id             = coder_agent.example.id
+  agent_id             = coder_agent.main.id
  gemini_api_key       = var.gemini_api_key
  gemini_model         = "gemini-2.5-flash"
  folder               = "/home/coder/project"
@@ -119,7 +119,7 @@ For enterprise users who prefer Google's Vertex AI platform:
 module "gemini" {
  source         = "registry.coder.com/coder-labs/gemini/coder"
  version        = "2.1.1"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  gemini_api_key = var.gemini_api_key
  folder         = "/home/coder/project"
  use_vertexai   = true
@@ -17,6 +17,6 @@ module "nextflow" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder-labs/nextflow/coder"
  version  = "0.9.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```
@@ -14,7 +14,7 @@ Run [OpenCode](https://opencode.ai) AI coding assistant in your workspace for in
 module "opencode" {
  source   = "registry.coder.com/coder-labs/opencode/coder"
  version  = "0.1.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  workdir  = "/home/coder/project"
 }
 ```
@@ -35,7 +35,7 @@ resource "coder_ai_task" "task" {
 module "opencode" {
  source   = "registry.coder.com/coder-labs/opencode/coder"
  version  = "0.1.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  workdir  = "/home/coder/project"

  ai_prompt = coder_ai_task.task.prompt
@@ -89,7 +89,7 @@ Run OpenCode as a command-line tool without web interface or task reporting:
 module "opencode" {
  source       = "registry.coder.com/coder-labs/opencode/coder"
  version      = "0.1.0"
-  agent_id     = coder_agent.example.id
+  agent_id     = coder_agent.main.id
  workdir      = "/home/coder"
  report_tasks = false
  cli_app      = true
@@ -14,7 +14,7 @@ Run [Amp CLI](https://ampcode.com/) in your workspace to access Sourcegraph's AI
 module "amp-cli" {
  source                  = "registry.coder.com/coder-labs/sourcegraph-amp/coder"
  version                 = "2.0.1"
-  agent_id                = coder_agent.example.id
+  agent_id                = coder_agent.main.id
  sourcegraph_amp_api_key = var.sourcegraph_amp_api_key
  install_sourcegraph_amp = true
  agentapi_version        = "latest"
@@ -49,7 +49,7 @@ module "amp-cli" {
  count              = data.coder_workspace.me.start_count
  source             = "registry.coder.com/coder-labs/sourcegraph-amp/coder"
  amp_version        = "2.0.1"
-  agent_id           = coder_agent.example.id
+  agent_id           = coder_agent.main.id
  amp_api_key        = var.amp_api_key # recommended for tasks usage
  workdir            = "/home/coder/project"
  instruction_prompt = <<-EOT
@@ -20,7 +20,7 @@ variable "api_key" {
 module "aider" {
  source      = "registry.coder.com/coder/aider/coder"
  version     = "2.0.0"
-  agent_id    = coder_agent.example.id
+  agent_id    = coder_agent.main.id
  api_key     = var.api_key
  ai_provider = "google"
  model       = "gemini"
@@ -51,7 +51,7 @@ variable "gemini_api_key" {
 module "aider" {
  source           = "registry.coder.com/coder/aider/coder"
  version          = "2.0.0"
-  agent_id         = coder_agent.example.id
+  agent_id         = coder_agent.main.id
  api_key          = var.gemini_api_key
  install_aider    = true
  workdir          = "/home/coder"
@@ -76,7 +76,7 @@ module "aider" {
  count               = data.coder_workspace.me.start_count
  source              = "registry.coder.com/coder/aider/coder"
  version             = "2.0.0"
-  agent_id            = coder_agent.example.id
+  agent_id            = coder_agent.main.id
  workdir             = "/home/coder"
  ai_provider         = "custom"
  custom_env_var_name = "MY_CUSTOM_API_KEY"
@@ -14,7 +14,7 @@ Run [Amazon Q](https://aws.amazon.com/q/) in your workspace to access Amazon's A
 module "amazon-q" {
  source   = "registry.coder.com/coder/amazon-q/coder"
  version  = "3.0.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  workdir  = "/home/coder"

  # Required: Authentication tarball (see below for generation)
@@ -103,7 +103,7 @@ data "coder_parameter" "ai_prompt" {
 module "amazon-q" {
  source          = "registry.coder.com/coder/amazon-q/coder"
  version         = "3.0.0"
-  agent_id        = coder_agent.example.id
+  agent_id        = coder_agent.main.id
  workdir         = "/home/coder"
  auth_tarball    = var.amazon_q_auth_tarball
  ai_prompt       = data.coder_parameter.ai_prompt.value
@@ -229,7 +229,7 @@ If no custom `agent_config` is provided, the default agent name "agent" is used.
 module "amazon-q" {
  source       = "registry.coder.com/coder/amazon-q/coder"
  version      = "3.0.0"
-  agent_id     = coder_agent.example.id
+  agent_id     = coder_agent.main.id
  workdir      = "/home/coder"
  auth_tarball = var.amazon_q_auth_tarball
 }
@@ -259,7 +259,7 @@ This example will:
 module "amazon-q" {
  source          = "registry.coder.com/coder/amazon-q/coder"
  version         = "3.0.0"
-  agent_id        = coder_agent.example.id
+  agent_id        = coder_agent.main.id
  workdir         = "/home/coder"
  auth_tarball    = var.amazon_q_auth_tarball
  ai_prompt       = "Help me set up a Python FastAPI project with proper testing structure"
@@ -280,7 +280,7 @@ module "amazon-q" {
 module "amazon-q" {
  source       = "registry.coder.com/coder/amazon-q/coder"
  version      = "3.0.0"
-  agent_id     = coder_agent.example.id
+  agent_id     = coder_agent.main.id
  workdir      = "/home/coder"
  auth_tarball = var.amazon_q_auth_tarball

@@ -306,7 +306,7 @@ module "amazon-q" {
 module "amazon-q" {
  source           = "registry.coder.com/coder/amazon-q/coder"
  version          = "3.0.0"
-  agent_id         = coder_agent.example.id
+  agent_id         = coder_agent.main.id
  workdir          = "/home/coder"
  auth_tarball     = var.amazon_q_auth_tarball
  amazon_q_version = "1.14.0" # Specific version
@@ -320,7 +320,7 @@ module "amazon-q" {
 module "amazon-q" {
  source       = "registry.coder.com/coder/amazon-q/coder"
  version      = "3.0.0"
-  agent_id     = coder_agent.example.id
+  agent_id     = coder_agent.main.id
  workdir      = "/home/coder"
  auth_tarball = var.amazon_q_auth_tarball

@@ -341,7 +341,7 @@ module "amazon-q" {
 module "amazon-q" {
  source       = "registry.coder.com/coder/amazon-q/coder"
  version      = "3.0.0"
-  agent_id     = coder_agent.example.id
+  agent_id     = coder_agent.main.id
  workdir      = "/home/coder"
  auth_tarball = var.amazon_q_auth_tarball

@@ -359,7 +359,7 @@ For environments without direct internet access, you can host Amazon Q installat
 module "amazon-q" {
  source       = "registry.coder.com/coder/amazon-q/coder"
  version      = "3.0.0"
-  agent_id     = coder_agent.example.id
+  agent_id     = coder_agent.main.id
  workdir      = "/home/coder"
  auth_tarball = var.amazon_q_auth_tarball

@@ -14,7 +14,7 @@ Run the [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude
 module "claude-code" {
  source         = "registry.coder.com/coder/claude-code/coder"
  version        = "4.2.2"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  workdir        = "/home/coder/project"
  claude_api_key = "xxxx-xxxxx-xxxx"
 }
@@ -71,7 +71,7 @@ data "coder_parameter" "ai_prompt" {
 module "claude-code" {
  source   = "registry.coder.com/coder/claude-code/coder"
  version  = "4.2.2"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  workdir  = "/home/coder/project"

  claude_api_key = "xxxx-xxxxx-xxxx"
@@ -109,7 +109,7 @@ Run and configure Claude Code as a standalone CLI in your workspace.
 module "claude-code" {
  source              = "registry.coder.com/coder/claude-code/coder"
  version             = "4.2.2"
-  agent_id            = coder_agent.example.id
+  agent_id            = coder_agent.main.id
  workdir             = "/home/coder"
  install_claude_code = true
  claude_code_version = "latest"
@@ -132,7 +132,7 @@ variable "claude_code_oauth_token" {
 module "claude-code" {
  source                  = "registry.coder.com/coder/claude-code/coder"
  version                 = "4.2.2"
-  agent_id                = coder_agent.example.id
+  agent_id                = coder_agent.main.id
  workdir                 = "/home/coder/project"
  claude_code_oauth_token = var.claude_code_oauth_token
 }
@@ -148,13 +148,13 @@ Configure Claude Code to use AWS Bedrock for accessing Claude models through you

 ```tf
 resource "coder_env" "bedrock_use" {
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  name     = "CLAUDE_CODE_USE_BEDROCK"
  value    = "1"
 }

 resource "coder_env" "aws_region" {
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  name     = "AWS_REGION"
  value    = "us-east-1" # Choose your preferred region
 }
@@ -176,13 +176,13 @@ variable "aws_secret_access_key" {
 }

 resource "coder_env" "aws_access_key_id" {
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  name     = "AWS_ACCESS_KEY_ID"
  value    = var.aws_access_key_id
 }

 resource "coder_env" "aws_secret_access_key" {
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  name     = "AWS_SECRET_ACCESS_KEY"
  value    = var.aws_secret_access_key
 }
@@ -197,7 +197,7 @@ variable "aws_bearer_token_bedrock" {
 }

 resource "coder_env" "bedrock_api_key" {
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  name     = "AWS_BEARER_TOKEN_BEDROCK"
  value    = var.aws_bearer_token_bedrock
 }
@@ -205,7 +205,7 @@ resource "coder_env" "bedrock_api_key" {
 module "claude-code" {
  source   = "registry.coder.com/coder/claude-code/coder"
  version  = "4.2.2"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  workdir  = "/home/coder/project"
  model    = "global.anthropic.claude-sonnet-4-5-20250929-v1:0"
 }
@@ -230,31 +230,31 @@ variable "vertex_sa_json" {
 }

 resource "coder_env" "vertex_use" {
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  name     = "CLAUDE_CODE_USE_VERTEX"
  value    = "1"
 }

 resource "coder_env" "vertex_project_id" {
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  name     = "ANTHROPIC_VERTEX_PROJECT_ID"
  value    = "your-gcp-project-id"
 }

 resource "coder_env" "cloud_ml_region" {
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  name     = "CLOUD_ML_REGION"
  value    = "global"
 }

 resource "coder_env" "vertex_sa_json" {
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  name     = "VERTEX_SA_JSON"
  value    = var.vertex_sa_json
 }

 resource "coder_env" "google_application_credentials" {
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  name     = "GOOGLE_APPLICATION_CREDENTIALS"
  value    = "/tmp/gcp-sa.json"
 }
@@ -262,7 +262,7 @@ resource "coder_env" "google_application_credentials" {
 module "claude-code" {
  source   = "registry.coder.com/coder/claude-code/coder"
  version  = "4.2.2"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  workdir  = "/home/coder/project"
  model    = "claude-sonnet-4@20250514"

@@ -15,7 +15,7 @@ module "code-server" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/code-server/coder"
  version  = "1.4.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -30,7 +30,7 @@ module "code-server" {
  count           = data.coder_workspace.me.start_count
  source          = "registry.coder.com/coder/code-server/coder"
  version         = "1.4.0"
-  agent_id        = coder_agent.example.id
+  agent_id        = coder_agent.main.id
  install_version = "4.8.3"
 }
 ```
@@ -44,7 +44,7 @@ module "code-server" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/code-server/coder"
  version  = "1.4.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  extensions = [
    "dracula-theme.theme-dracula"
  ]
@@ -62,7 +62,7 @@ module "code-server" {
  count      = data.coder_workspace.me.start_count
  source     = "registry.coder.com/coder/code-server/coder"
  version    = "1.4.0"
-  agent_id   = coder_agent.example.id
+  agent_id   = coder_agent.main.id
  extensions = ["dracula-theme.theme-dracula"]
  settings = {
    "workbench.colorTheme" = "Dracula"
@@ -79,7 +79,7 @@ module "code-server" {
  count      = data.coder_workspace.me.start_count
  source     = "registry.coder.com/coder/code-server/coder"
  version    = "1.4.0"
-  agent_id   = coder_agent.example.id
+  agent_id   = coder_agent.main.id
  extensions = ["dracula-theme.theme-dracula", "ms-azuretools.vscode-docker"]
 }
 ```
@@ -93,7 +93,7 @@ module "code-server" {
  count           = data.coder_workspace.me.start_count
  source          = "registry.coder.com/coder/code-server/coder"
  version         = "1.4.0"
-  agent_id        = coder_agent.example.id
+  agent_id        = coder_agent.main.id
  additional_args = "--disable-workspace-trust"
 }
 ```
@@ -109,7 +109,7 @@ module "code-server" {
  count      = data.coder_workspace.me.start_count
  source     = "registry.coder.com/coder/code-server/coder"
  version    = "1.4.0"
-  agent_id   = coder_agent.example.id
+  agent_id   = coder_agent.main.id
  use_cached = true
  extensions = ["dracula-theme.theme-dracula", "ms-azuretools.vscode-docker"]
 }
@@ -122,7 +122,7 @@ module "code-server" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/code-server/coder"
  version  = "1.4.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  offline  = true
 }
 ```
@@ -15,7 +15,7 @@ module "coder-login" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/coder-login/coder"
  version  = "1.1.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -17,7 +17,7 @@ module "cursor" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/cursor/coder"
  version  = "1.3.2"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -30,7 +30,7 @@ module "cursor" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/cursor/coder"
  version  = "1.3.2"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"
 }
 ```
@@ -46,7 +46,7 @@ module "cursor" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/cursor/coder"
  version  = "1.3.2"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"
  mcp = jsonencode({
    mcpServers = {
@@ -16,6 +16,6 @@ The devcontainers-cli module provides an easy way to install [`@devcontainers/cl
 module "devcontainers-cli" {
  source   = "registry.coder.com/coder/devcontainers-cli/coder"
  version  = "1.0.32"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```
@@ -19,7 +19,7 @@ module "dotfiles" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/dotfiles/coder"
  version  = "1.2.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -32,7 +32,7 @@ module "dotfiles" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/dotfiles/coder"
  version  = "1.2.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -43,7 +43,7 @@ module "dotfiles" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/dotfiles/coder"
  version  = "1.2.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  user     = "root"
 }
 ```
@@ -55,14 +55,14 @@ module "dotfiles" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/dotfiles/coder"
  version  = "1.2.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }

 module "dotfiles-root" {
  count        = data.coder_workspace.me.start_count
  source       = "registry.coder.com/coder/dotfiles/coder"
  version      = "1.2.1"
-  agent_id     = coder_agent.example.id
+  agent_id     = coder_agent.main.id
  user         = "root"
  dotfiles_uri = module.dotfiles.dotfiles_uri
 }
@@ -77,7 +77,7 @@ module "dotfiles" {
  count                = data.coder_workspace.me.start_count
  source               = "registry.coder.com/coder/dotfiles/coder"
  version              = "1.2.1"
-  agent_id             = coder_agent.example.id
+  agent_id             = coder_agent.main.id
  default_dotfiles_uri = "https://github.com/coder/dotfiles"
 }
 ```
@@ -15,7 +15,7 @@ module "filebrowser" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/filebrowser/coder"
  version  = "1.1.2"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -30,7 +30,7 @@ module "filebrowser" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/filebrowser/coder"
  version  = "1.1.2"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"
 }
 ```
@@ -42,7 +42,7 @@ module "filebrowser" {
  count         = data.coder_workspace.me.start_count
  source        = "registry.coder.com/coder/filebrowser/coder"
  version       = "1.1.2"
-  agent_id      = coder_agent.example.id
+  agent_id      = coder_agent.main.id
  database_path = ".config/filebrowser.db"
 }
 ```
@@ -54,7 +54,7 @@ module "filebrowser" {
  count      = data.coder_workspace.me.start_count
  source     = "registry.coder.com/coder/filebrowser/coder"
  version    = "1.1.2"
-  agent_id   = coder_agent.example.id
+  agent_id   = coder_agent.main.id
  agent_name = "main"
  subdomain  = false
 }
@@ -15,7 +15,7 @@ module "git-clone" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/git-clone/coder"
  version  = "1.2.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  url      = "https://github.com/coder/coder"
 }
 ```
@@ -29,7 +29,7 @@ module "git-clone" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/git-clone/coder"
  version  = "1.2.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  url      = "https://github.com/coder/coder"
  base_dir = "~/projects/coder"
 }
@@ -44,7 +44,7 @@ module "git-clone" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/git-clone/coder"
  version  = "1.2.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  url      = "https://github.com/coder/coder"
 }

@@ -70,7 +70,7 @@ module "git_clone" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/git-clone/coder"
  version  = "1.2.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  url      = data.coder_parameter.git_repo.value
 }

@@ -79,7 +79,7 @@ module "code-server" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/code-server/coder"
  version  = "1.0.18"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  order    = 1
  folder   = "/home/${local.username}/${module.git_clone[count.index].folder_name}"
 }
@@ -87,7 +87,7 @@ module "code-server" {
 # Create a Coder app for the website
 resource "coder_app" "website" {
  count        = data.coder_workspace.me.start_count
-  agent_id     = coder_agent.example.id
+  agent_id     = coder_agent.main.id
  order        = 2
  slug         = "website"
  external     = true
@@ -104,7 +104,7 @@ module "git-clone" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/git-clone/coder"
  version  = "1.2.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  url      = "https://github.example.com/coder/coder/tree/feat/example"
  git_providers = {
    "https://github.example.com/" = {
@@ -123,7 +123,7 @@ module "git-clone" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/git-clone/coder"
  version  = "1.2.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  url      = "https://gitlab.com/coder/coder/-/tree/feat/example"
 }
 ```
@@ -135,7 +135,7 @@ module "git-clone" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/git-clone/coder"
  version  = "1.2.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  url      = "https://gitlab.example.com/coder/coder/-/tree/feat/example"
  git_providers = {
    "https://gitlab.example.com/" = {
@@ -156,7 +156,7 @@ module "git-clone" {
  count       = data.coder_workspace.me.start_count
  source      = "registry.coder.com/coder/git-clone/coder"
  version     = "1.2.0"
-  agent_id    = coder_agent.example.id
+  agent_id    = coder_agent.main.id
  url         = "https://github.com/coder/coder"
  branch_name = "feat/example"
 }
@@ -174,7 +174,7 @@ module "git-clone" {
  count       = data.coder_workspace.me.start_count
  source      = "registry.coder.com/coder/git-clone/coder"
  version     = "1.2.0"
-  agent_id    = coder_agent.example.id
+  agent_id    = coder_agent.main.id
  url         = "https://github.com/coder/coder"
  folder_name = "coder-dev"
  base_dir    = "~/projects/coder"
@@ -193,7 +193,7 @@ module "git-clone" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/modules/git-clone/coder"
  version  = "1.2.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  url      = "https://github.com/coder/coder"
  depth    = 1
 }
@@ -209,7 +209,7 @@ module "git-clone" {
  count             = data.coder_workspace.me.start_count
  source            = "registry.coder.com/coder/git-clone/coder"
  version           = "1.2.0"
-  agent_id          = coder_agent.example.id
+  agent_id          = coder_agent.main.id
  url               = "https://github.com/coder/coder"
  post_clone_script = <<-EOT
    #!/bin/bash
@@ -23,6 +23,6 @@ module "git-commit-signing" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/git-commit-signing/coder"
  version  = "1.0.31"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```
@@ -15,7 +15,7 @@ module "git-config" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/git-config/coder"
  version  = "1.0.31"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -30,7 +30,7 @@ module "git-config" {
  count              = data.coder_workspace.me.start_count
  source             = "registry.coder.com/coder/git-config/coder"
  version            = "1.0.31"
-  agent_id           = coder_agent.example.id
+  agent_id           = coder_agent.main.id
  allow_email_change = true
 }
 ```
@@ -44,7 +44,7 @@ module "git-config" {
  count                 = data.coder_workspace.me.start_count
  source                = "registry.coder.com/coder/git-config/coder"
  version               = "1.0.31"
-  agent_id              = coder_agent.example.id
+  agent_id              = coder_agent.main.id
  allow_username_change = false
  allow_email_change    = false
 }
@@ -15,7 +15,7 @@ module "github-upload-public-key" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/github-upload-public-key/coder"
  version  = "1.0.31"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -48,7 +48,7 @@ module "github-upload-public-key" {
  count            = data.coder_workspace.me.start_count
  source           = "registry.coder.com/coder/github-upload-public-key/coder"
  version          = "1.0.31"
-  agent_id         = coder_agent.example.id
+  agent_id         = coder_agent.main.id
  external_auth_id = data.coder_external_auth.github.id
 }
 ```
@@ -14,7 +14,7 @@ Run the [Goose](https://block.github.io/goose/) agent in your workspace to gener
 module "goose" {
  source           = "registry.coder.com/coder/goose/coder"
  version          = "3.0.0"
-  agent_id         = coder_agent.example.id
+  agent_id         = coder_agent.main.id
  folder           = "/home/coder"
  install_goose    = true
  goose_version    = "v1.0.31"
@@ -39,7 +39,7 @@ module "coder-login" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/coder-login/coder"
  version  = "1.0.15"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }

 variable "anthropic_api_key" {
@@ -80,7 +80,7 @@ module "goose" {
  count            = data.coder_workspace.me.start_count
  source           = "registry.coder.com/coder/goose/coder"
  version          = "3.0.0"
-  agent_id         = coder_agent.example.id
+  agent_id         = coder_agent.main.id
  folder           = "/home/coder"
  install_goose    = true
  goose_version    = "v1.0.31"
@@ -27,7 +27,7 @@ This module lets you fetch all or selective secrets from a [HCP Vault Secrets](h
 module "vault" {
  source     = "registry.coder.com/coder/hcp-vault-secrets/coder"
  version    = "1.0.34"
-  agent_id   = coder_agent.example.id
+  agent_id   = coder_agent.main.id
  app_name   = "demo-app"
  project_id = "aaa-bbb-ccc"
 }
@@ -53,7 +53,7 @@ To fetch all secrets from the HCP Vault Secrets app, skip the `secrets` input.
 module "vault" {
  source     = "registry.coder.com/coder/hcp-vault-secrets/coder"
  version    = "1.0.34"
-  agent_id   = coder_agent.example.id
+  agent_id   = coder_agent.main.id
  app_name   = "demo-app"
  project_id = "aaa-bbb-ccc"
 }
@@ -67,7 +67,7 @@ To fetch selective secrets from the HCP Vault Secrets app, set the `secrets` inp
 module "vault" {
  source     = "registry.coder.com/coder/hcp-vault-secrets/coder"
  version    = "1.0.34"
-  agent_id   = coder_agent.example.id
+  agent_id   = coder_agent.main.id
  app_name   = "demo-app"
  project_id = "aaa-bbb-ccc"
  secrets    = ["MY_SECRET_1", "MY_SECRET_2"]
@@ -82,7 +82,7 @@ Set `client_id` and `client_secret` as module inputs.
 module "vault" {
  source        = "registry.coder.com/coder/hcp-vault-secrets/coder"
  version       = "1.0.34"
-  agent_id      = coder_agent.example.id
+  agent_id      = coder_agent.main.id
  app_name      = "demo-app"
  project_id    = "aaa-bbb-ccc"
  client_id     = "HCP_CLIENT_ID"
@@ -17,7 +17,7 @@ module "jetbrains_fleet" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/jetbrains-fleet/coder"
  version  = "1.0.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -38,7 +38,7 @@ module "jetbrains_fleet" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/jetbrains-fleet/coder"
  version  = "1.0.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -49,7 +49,7 @@ module "jetbrains_fleet" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/jetbrains-fleet/coder"
  version  = "1.0.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"
 }
 ```
@@ -61,7 +61,7 @@ module "jetbrains_fleet" {
  count        = data.coder_workspace.me.start_count
  source       = "registry.coder.com/coder/jetbrains-fleet/coder"
  version      = "1.0.1"
-  agent_id     = coder_agent.example.id
+  agent_id     = coder_agent.main.id
  display_name = "Fleet"
  group        = "JetBrains IDEs"
  order        = 1
@@ -75,7 +75,7 @@ module "jetbrains_fleet" {
  count      = data.coder_workspace.me.start_count
  source     = "registry.coder.com/coder/jetbrains-fleet/coder"
  version    = "1.0.1"
-  agent_id   = coder_agent.example.id
-  agent_name = coder_agent.example.name
+  agent_id   = coder_agent.main.id
+  agent_name = coder_agent.main.name
 }
 ```
@@ -21,7 +21,7 @@ module "jetbrains_gateway" {
  count          = data.coder_workspace.me.start_count
  source         = "registry.coder.com/coder/jetbrains-gateway/coder"
  version        = "1.2.5"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  folder         = "/home/coder/example"
  jetbrains_ides = ["CL", "GO", "IU", "PY", "WS"]
  default        = "GO"
@@ -39,7 +39,7 @@ module "jetbrains_gateway" {
  count          = data.coder_workspace.me.start_count
  source         = "registry.coder.com/coder/jetbrains-gateway/coder"
  version        = "1.2.5"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  folder         = "/home/coder/example"
  jetbrains_ides = ["GO", "WS"]
  default        = "GO"
@@ -53,7 +53,7 @@ module "jetbrains_gateway" {
  count          = data.coder_workspace.me.start_count
  source         = "registry.coder.com/coder/jetbrains-gateway/coder"
  version        = "1.2.5"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  folder         = "/home/coder/example"
  jetbrains_ides = ["IU", "PY"]
  default        = "IU"
@@ -68,7 +68,7 @@ module "jetbrains_gateway" {
  count          = data.coder_workspace.me.start_count
  source         = "registry.coder.com/coder/jetbrains-gateway/coder"
  version        = "1.2.5"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  folder         = "/home/coder/example"
  jetbrains_ides = ["IU", "PY"]
  default        = "IU"
@@ -93,7 +93,7 @@ module "jetbrains_gateway" {
  count          = data.coder_workspace.me.start_count
  source         = "registry.coder.com/coder/jetbrains-gateway/coder"
  version        = "1.2.5"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  folder         = "/home/coder/example"
  jetbrains_ides = ["GO", "WS"]
  default        = "GO"
@@ -111,7 +111,7 @@ module "jetbrains_gateway" {
  count              = data.coder_workspace.me.start_count
  source             = "registry.coder.com/coder/jetbrains-gateway/coder"
  version            = "1.2.5"
-  agent_id           = coder_agent.example.id
+  agent_id           = coder_agent.main.id
  folder             = "/home/coder/example"
  jetbrains_ides     = ["GO", "WS"]
  releases_base_link = "https://releases.internal.site/"
@@ -15,7 +15,7 @@ module "jetbrains" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/jetbrains/coder"
  version  = "1.2.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"
  # tooltip  = "You need to [Install Coder Desktop](https://coder.com/docs/user-guides/desktop#install-coder-desktop) to use this button."  # Optional
 }
@@ -41,7 +41,7 @@ module "jetbrains" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/jetbrains/coder"
  version  = "1.2.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"
  default  = ["PY", "IU"] # Pre-configure GoLand and IntelliJ IDEA
 }
@@ -54,7 +54,7 @@ module "jetbrains" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/jetbrains/coder"
  version  = "1.2.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"
  # Show parameter with limited options
  options = ["IU", "PY"] # Only these IDEs are available for selection
@@ -68,7 +68,7 @@ module "jetbrains" {
  count         = data.coder_workspace.me.start_count
  source        = "registry.coder.com/coder/jetbrains/coder"
  version       = "1.2.0"
-  agent_id      = coder_agent.example.id
+  agent_id      = coder_agent.main.id
  folder        = "/home/coder/project"
  default       = ["IU", "PY"]
  channel       = "eap"    # Use Early Access Preview versions
@@ -83,7 +83,7 @@ module "jetbrains" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/jetbrains/coder"
  version  = "1.2.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/workspace/project"

  # Custom IDE metadata (display names and icons)
@@ -109,7 +109,7 @@ module "jetbrains_pycharm" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/jetbrains/coder"
  version  = "1.2.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/workspace/project"

  default = ["PY"] # Only PyCharm
@@ -129,7 +129,7 @@ module "jetbrains" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/jetbrains/coder"
  version  = "1.2.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"
  default  = ["IU", "PY"]
  tooltip  = "You need to [Install Coder Desktop](https://coder.com/docs/user-guides/desktop#install-coder-desktop) to use this button."
@@ -17,7 +17,7 @@ module "jfrog" {
  count          = data.coder_workspace.me.start_count
  source         = "registry.coder.com/coder/jfrog-oauth/coder"
  version        = "1.2.2"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  jfrog_url      = "https://example.jfrog.io"
  username_field = "username" # If you are using GitHub to login to both Coder and Artifactory, use username_field = "username"

@@ -57,7 +57,7 @@ module "jfrog" {
  count          = data.coder_workspace.me.start_count
  source         = "registry.coder.com/coder/jfrog-oauth/coder"
  version        = "1.2.2"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  jfrog_url      = "https://example.jfrog.io"
  username_field = "email"

@@ -86,7 +86,7 @@ module "jfrog" {
  count                 = data.coder_workspace.me.start_count
  source                = "registry.coder.com/coder/jfrog-oauth/coder"
  version               = "1.2.2"
-  agent_id              = coder_agent.example.id
+  agent_id              = coder_agent.main.id
  jfrog_url             = "https://example.jfrog.io"
  username_field        = "username" # If you are using GitHub to login to both Coder and Artifactory, use username_field = "username"
  configure_code_server = true       # Add JFrog extension configuration for code-server
@@ -14,7 +14,7 @@ Install the JF CLI and authenticate package managers with Artifactory using Arti
 module "jfrog" {
  source                   = "registry.coder.com/coder/jfrog-token/coder"
  version                  = "1.2.1"
-  agent_id                 = coder_agent.example.id
+  agent_id                 = coder_agent.main.id
  jfrog_url                = "https://XXXX.jfrog.io"
  artifactory_access_token = var.artifactory_access_token
  package_managers = {
@@ -43,7 +43,7 @@ For detailed instructions, please see this [guide](https://coder.com/docs/v2/lat
 module "jfrog" {
  source                   = "registry.coder.com/coder/jfrog-token/coder"
  version                  = "1.2.1"
-  agent_id                 = coder_agent.example.id
+  agent_id                 = coder_agent.main.id
  jfrog_url                = "https://YYYY.jfrog.io"
  artifactory_access_token = var.artifactory_access_token # An admin access token
  package_managers = {
@@ -82,7 +82,7 @@ The [JFrog extension](https://open-vsx.org/extension/JFrog/jfrog-vscode-extensio
 module "jfrog" {
  source                   = "registry.coder.com/coder/jfrog-token/coder"
  version                  = "1.2.1"
-  agent_id                 = coder_agent.example.id
+  agent_id                 = coder_agent.main.id
  jfrog_url                = "https://XXXX.jfrog.io"
  artifactory_access_token = var.artifactory_access_token
  configure_code_server    = true # Add JFrog extension configuration for code-server
@@ -102,7 +102,7 @@ data "coder_workspace" "me" {}
 module "jfrog" {
  source                   = "registry.coder.com/coder/jfrog-token/coder"
  version                  = "1.2.1"
-  agent_id                 = coder_agent.example.id
+  agent_id                 = coder_agent.main.id
  jfrog_url                = "https://XXXX.jfrog.io"
  artifactory_access_token = var.artifactory_access_token
  token_description        = "Token for Coder workspace: ${data.coder_workspace_owner.me.name}/${data.coder_workspace.me.name}"
@@ -17,6 +17,6 @@ module "jupyter-notebook" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/jupyter-notebook/coder"
  version  = "1.2.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```
@@ -17,7 +17,7 @@ module "jupyterlab" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/jupyterlab/coder"
  version  = "1.2.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -30,7 +30,7 @@ module "jupyterlab" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/jupyterlab/coder"
  version  = "1.2.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  config = {
    ServerApp = {
      # Required for Coder Tasks iFrame embedding - do not remove
@@ -15,7 +15,7 @@ module "kasmvnc" {
  count               = data.coder_workspace.me.start_count
  source              = "registry.coder.com/coder/kasmvnc/coder"
  version             = "1.2.5"
-  agent_id            = coder_agent.example.id
+  agent_id            = coder_agent.main.id
  desktop_environment = "xfce"
  subdomain           = true
 }
@@ -19,7 +19,7 @@ module "kiro" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/kiro/coder"
  version  = "1.1.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -32,7 +32,7 @@ module "kiro" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/kiro/coder"
  version  = "1.1.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"
 }
 ```
@@ -48,7 +48,7 @@ module "kiro" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/kiro/coder"
  version  = "1.1.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"
  mcp = jsonencode({
    mcpServers = {
@@ -15,7 +15,7 @@ module "mux" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/mux/coder"
  version  = "1.0.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -36,7 +36,7 @@ module "mux" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/mux/coder"
  version  = "1.0.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -47,7 +47,7 @@ module "mux" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/mux/coder"
  version  = "1.0.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  # Default is "latest"; set to a specific version to pin
  install_version = "0.4.0"
 }
@@ -60,7 +60,7 @@ module "mux" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/mux/coder"
  version  = "1.0.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  port     = 8080
 }
 ```
@@ -74,7 +74,7 @@ module "mux" {
  count      = data.coder_workspace.me.start_count
  source     = "registry.coder.com/coder/mux/coder"
  version    = "1.0.1"
-  agent_id   = coder_agent.example.id
+  agent_id   = coder_agent.main.id
  use_cached = true
 }
 ```
@@ -88,7 +88,7 @@ module "mux" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/mux/coder"
  version  = "1.0.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  install  = false
 }
 ```
@@ -15,6 +15,6 @@ module "personalize" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/personalize/coder"
  version  = "1.0.31"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```
@@ -20,6 +20,6 @@ module "rstudio-server" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/rstudio-server/coder"
  version  = "0.9.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```
@@ -15,7 +15,7 @@ module "slackme" {
  count            = data.coder_workspace.me.start_count
  source           = "registry.coder.com/coder/slackme/coder"
  version          = "1.0.31"
-  agent_id         = coder_agent.example.id
+  agent_id         = coder_agent.main.id
  auth_provider_id = "slack"
 }
 ```
@@ -75,7 +75,7 @@ module "slackme" {
  count            = data.coder_workspace.me.start_count
  source           = "registry.coder.com/coder/slackme/coder"
  version          = "1.0.31"
-  agent_id         = coder_agent.example.id
+  agent_id         = coder_agent.main.id
  auth_provider_id = "slack"
  slack_message    = <<EOF
 👋 Hey there from Coder! $COMMAND took $DURATION to execute!
@@ -15,7 +15,7 @@ module "vault" {
  count      = data.coder_workspace.me.start_count
  source     = "registry.coder.com/coder/vault-github/coder"
  version    = "1.1.0"
-  agent_id   = coder_agent.example.id
+  agent_id   = coder_agent.main.id
  vault_addr = "https://vault.example.com"
 }
 ```
@@ -47,7 +47,7 @@ module "vault" {
  count                = data.coder_workspace.me.start_count
  source               = "registry.coder.com/coder/vault-github/coder"
  version              = "1.1.0"
-  agent_id             = coder_agent.example.id
+  agent_id             = coder_agent.main.id
  vault_addr           = "https://vault.example.com"
  coder_github_auth_id = "my-github-auth-id"
 }
@@ -60,7 +60,7 @@ module "vault" {
  count                  = data.coder_workspace.me.start_count
  source                 = "registry.coder.com/coder/vault-github/coder"
  version                = "1.1.0"
-  agent_id               = coder_agent.example.id
+  agent_id               = coder_agent.main.id
  vault_addr             = "https://vault.example.com"
  coder_github_auth_id   = "my-github-auth-id"
  vault_github_auth_path = "my-github-auth-path"
@@ -74,7 +74,7 @@ module "vault" {
  count             = data.coder_workspace.me.start_count
  source            = "registry.coder.com/coder/vault-github/coder"
  version           = "1.1.0"
-  agent_id          = coder_agent.example.id
+  agent_id          = coder_agent.main.id
  vault_addr        = "https://vault.example.com"
  vault_cli_version = "1.15.0"
 }
@@ -15,7 +15,7 @@ module "vault" {
  count           = data.coder_workspace.me.start_count
  source          = "registry.coder.com/coder/vault-jwt/coder"
  version         = "1.2.0"
-  agent_id        = coder_agent.example.id
+  agent_id        = coder_agent.main.id
  vault_addr      = "https://vault.example.com"
  vault_jwt_role  = "coder"                # The Vault role to use for authentication
  vault_jwt_token = "eyJhbGciOiJIUzI1N..." # optional, if not present, defaults to user's oidc authentication token
@@ -43,7 +43,7 @@ module "vault" {
  count               = data.coder_workspace.me.start_count
  source              = "registry.coder.com/coder/vault-jwt/coder"
  version             = "1.2.0"
-  agent_id            = coder_agent.example.id
+  agent_id            = coder_agent.main.id
  vault_addr          = "https://vault.example.com"
  vault_jwt_auth_path = "oidc"
  vault_jwt_role      = "coder" # The Vault role to use for authentication
@@ -59,7 +59,7 @@ module "vault" {
  count          = data.coder_workspace.me.start_count
  source         = "registry.coder.com/coder/vault-jwt/coder"
  version        = "1.2.0"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  vault_addr     = "https://vault.example.com"
  vault_jwt_role = data.coder_workspace_owner.me.groups[0]
 }
@@ -72,7 +72,7 @@ module "vault" {
  count             = data.coder_workspace.me.start_count
  source            = "registry.coder.com/coder/vault-jwt/coder"
  version           = "1.2.0"
-  agent_id          = coder_agent.example.id
+  agent_id          = coder_agent.main.id
  vault_addr        = "https://vault.example.com"
  vault_jwt_role    = "coder" # The Vault role to use for authentication
  vault_cli_version = "1.17.5"
@@ -133,7 +133,7 @@ module "vault" {
  count           = data.coder_workspace.me.start_count
  source          = "registry.coder.com/coder/vault-jwt/coder"
  version         = "1.2.0"
-  agent_id        = coder_agent.example.id
+  agent_id        = coder_agent.main.id
  vault_addr      = "https://vault.example.com"
  vault_jwt_role  = "coder" # The Vault role to use for authentication
  vault_jwt_token = jwt_signed_token.vault[0].token
@@ -20,7 +20,7 @@ variable "vault_token" {
 module "vault" {
  source          = "registry.coder.com/coder/vault-token/coder"
  version         = "1.3.0"
-  agent_id        = coder_agent.example.id
+  agent_id        = coder_agent.main.id
  vault_token     = var.token # optional
  vault_addr      = "https://vault.example.com"
  vault_namespace = "prod" # optional, vault enterprise only
@@ -74,7 +74,7 @@ variable "vault_token" {
 module "vault" {
  source            = "registry.coder.com/coder/vault-token/coder"
  version           = "1.3.0"
-  agent_id          = coder_agent.example.id
+  agent_id          = coder_agent.main.id
  vault_addr        = "https://vault.example.com"
  vault_token       = var.token
  vault_cli_version = "1.19.0"
@@ -17,7 +17,7 @@ module "vscode" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/vscode-desktop/coder"
  version  = "1.1.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -30,7 +30,7 @@ module "vscode" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/vscode-desktop/coder"
  version  = "1.1.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"
 }
 ```
@@ -15,7 +15,7 @@ module "vscode-web" {
  count          = data.coder_workspace.me.start_count
  source         = "registry.coder.com/coder/vscode-web/coder"
  version        = "1.4.1"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  accept_license = true
 }
 ```
@@ -31,7 +31,7 @@ module "vscode-web" {
  count          = data.coder_workspace.me.start_count
  source         = "registry.coder.com/coder/vscode-web/coder"
  version        = "1.4.1"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  install_prefix = "/home/coder/.vscode-web"
  folder         = "/home/coder"
  accept_license = true
@@ -45,7 +45,7 @@ module "vscode-web" {
  count          = data.coder_workspace.me.start_count
  source         = "registry.coder.com/coder/vscode-web/coder"
  version        = "1.4.1"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  extensions     = ["github.copilot", "ms-python.python", "ms-toolsai.jupyter"]
  accept_license = true
 }
@@ -60,7 +60,7 @@ module "vscode-web" {
  count      = data.coder_workspace.me.start_count
  source     = "registry.coder.com/coder/vscode-web/coder"
  version    = "1.4.1"
-  agent_id   = coder_agent.example.id
+  agent_id   = coder_agent.main.id
  extensions = ["dracula-theme.theme-dracula"]
  settings = {
    "workbench.colorTheme" = "Dracula"
@@ -78,7 +78,7 @@ module "vscode-web" {
  count          = data.coder_workspace.me.start_count
  source         = "registry.coder.com/coder/vscode-web/coder"
  version        = "1.4.1"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  commit_id      = "e54c774e0add60467559eb0d1e229c6452cf8447"
  accept_license = true
 }
@@ -94,7 +94,7 @@ module "vscode-web" {
  count     = data.coder_workspace.me.start_count
  source    = "registry.coder.com/coder/vscode-web/coder"
  version   = "1.4.1"
-  agent_id  = coder_agent.example.id
+  agent_id  = coder_agent.main.id
  workspace = "/home/coder/coder.code-workspace"
 }
 ```
@@ -17,7 +17,7 @@ module "windsurf" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/windsurf/coder"
  version  = "1.2.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -30,7 +30,7 @@ module "windsurf" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/windsurf/coder"
  version  = "1.2.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"
 }
 ```
@@ -46,7 +46,7 @@ module "windsurf" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/windsurf/coder"
  version  = "1.2.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"
  mcp = jsonencode({
    mcpServers = {
@@ -20,7 +20,7 @@ module "zed" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/zed/coder"
  version  = "1.1.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -33,7 +33,7 @@ module "zed" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/zed/coder"
  version  = "1.1.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"
 }
 ```
@@ -45,7 +45,7 @@ module "zed" {
  count        = data.coder_workspace.me.start_count
  source       = "registry.coder.com/coder/zed/coder"
  version      = "1.1.1"
-  agent_id     = coder_agent.example.id
+  agent_id     = coder_agent.main.id
  display_name = "Zed Editor"
  order        = 1
 }
@@ -58,8 +58,8 @@ module "zed" {
  count      = data.coder_workspace.me.start_count
  source     = "registry.coder.com/coder/zed/coder"
  version    = "1.1.1"
-  agent_id   = coder_agent.example.id
-  agent_name = coder_agent.example.name
+  agent_id   = coder_agent.main.id
+  agent_name = coder_agent.main.name
 }
 ```

@@ -74,7 +74,7 @@ module "zed" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/coder/zed/coder"
  version  = "1.1.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id

  settings = jsonencode({
    context_servers = {
@@ -17,7 +17,7 @@ module "positron" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/cytoshahar/positron/coder"
  version  = "1.0.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -30,7 +30,7 @@ module "positron" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/cytoshahar/positron/coder"
  version  = "1.0.0"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  folder   = "/home/coder/project"
 }
 ```
@@ -36,7 +36,7 @@ module "copyparty" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/djarbz/copyparty/coder"
  version  = "1.0.1"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  arguments = [
    "-v", "/home/coder/:/home:r",       # Share home directory (read-only)
    "-v", "${local.repo_dir}:/repo:rw", # Share project directory (read-write)
@@ -52,7 +52,7 @@ module "copyparty" {
  count     = data.coder_workspace.me.start_count
  source    = "registry.coder.com/djarbz/copyparty/coder"
  version   = "1.0.1"
-  agent_id  = coder_agent.example.id
+  agent_id  = coder_agent.main.id
  subdomain = true
  arguments = [
    "-v", "/tmp:/tmp:r",                         # Share tmp directory (read-only)
@@ -14,7 +14,7 @@ Configure package managers (Maven, npm, Go, PyPI, Docker) to use [Sonatype Nexus
 module "nexus_repository" {
  source         = "registry.coder.com/mavrickrishi/nexus-repository/coder"
  version        = "1.0.1"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  nexus_url      = "https://nexus.example.com"
  nexus_password = var.nexus_api_token
  package_managers = {
@@ -44,7 +44,7 @@ module "nexus_repository" {
 module "nexus_repository" {
  source         = "registry.coder.com/mavrickrishi/nexus-repository/coder"
  version        = "1.0.1"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  nexus_url      = "https://nexus.example.com"
  nexus_password = var.nexus_api_token
  package_managers = {
@@ -59,7 +59,7 @@ module "nexus_repository" {
 module "nexus_repository" {
  source         = "registry.coder.com/mavrickrishi/nexus-repository/coder"
  version        = "1.0.1"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  nexus_url      = "https://nexus.example.com"
  nexus_password = var.nexus_api_token
  package_managers = {
@@ -74,7 +74,7 @@ module "nexus_repository" {
 module "nexus_repository" {
  source         = "registry.coder.com/mavrickrishi/nexus-repository/coder"
  version        = "1.0.1"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  nexus_url      = "https://nexus.example.com"
  nexus_password = var.nexus_api_token
  package_managers = {
@@ -89,7 +89,7 @@ module "nexus_repository" {
 module "nexus_repository" {
  source         = "registry.coder.com/mavrickrishi/nexus-repository/coder"
  version        = "1.0.1"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  nexus_url      = "https://nexus.example.com"
  nexus_password = var.nexus_api_token
  package_managers = {
@@ -104,7 +104,7 @@ module "nexus_repository" {
 module "nexus_repository" {
  source         = "registry.coder.com/mavrickrishi/nexus-repository/coder"
  version        = "1.0.1"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  nexus_url      = "https://nexus.example.com"
  nexus_password = var.nexus_api_token
  package_managers = {
@@ -119,7 +119,7 @@ module "nexus_repository" {
 module "nexus_repository" {
  source         = "registry.coder.com/mavrickrishi/nexus-repository/coder"
  version        = "1.0.1"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  nexus_url      = "https://nexus.example.com"
  nexus_username = "custom-user"
  nexus_password = var.nexus_api_token
@@ -135,7 +135,7 @@ module "nexus_repository" {
 module "nexus_repository" {
  source         = "registry.coder.com/mavrickrishi/nexus-repository/coder"
  version        = "1.0.1"
-  agent_id       = coder_agent.example.id
+  agent_id       = coder_agent.main.id
  nexus_url      = "https://nexus.example.com"
  nexus_password = var.nexus_api_token
  package_managers = {
@@ -16,7 +16,7 @@ module "nodejs" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/thezoker/nodejs/coder"
  version  = "1.0.11"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
 }
 ```

@@ -29,7 +29,7 @@ module "nodejs" {
  count    = data.coder_workspace.me.start_count
  source   = "registry.coder.com/thezoker/nodejs/coder"
  version  = "1.0.11"
-  agent_id = coder_agent.example.id
+  agent_id = coder_agent.main.id
  node_versions = [
    "18",
    "20",
@@ -48,7 +48,7 @@ module "nodejs" {
  count              = data.coder_workspace.me.start_count
  source             = "registry.coder.com/thezoker/nodejs/coder"
  version            = "1.0.11"
-  agent_id           = coder_agent.example.id
+  agent_id           = coder_agent.main.id
  nvm_version        = "v0.39.7"
  nvm_install_prefix = "/opt/nvm"
  node_versions = [
@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Script to validate coder_agent naming conventions across the registry
+# This ensures consistency between templates and module documentation
+
+ERRORS=0
+
+echo "🔍 Linting coder_agent naming conventions..."
+echo ""
+
+# Check 1: Module README files should use coder_agent.main
+echo "📝 Checking module README files..."
+if grep -r 'coder_agent\.' registry/*/modules/*/README.md 2> /dev/null | grep -v 'coder_agent\.main' | grep -v 'agent_id' | grep -v 'coder_agent\.id' | grep -v '# ' | grep -E 'coder_agent\.[a-z_]+'; then
+  echo "❌ ERROR: Module READMEs should reference 'coder_agent.main' in examples"
+  echo "   Found references to other agent names above."
+  ERRORS=$((ERRORS + 1))
+else
+  echo "✅ All module READMEs use 'coder_agent.main'"
+fi
+echo ""
+
+# Check 2: Examples should use coder_agent.main
+echo "📝 Checking example files..."
+if [ -f "examples/templates/main.tf" ]; then
+  if grep -q 'coder_agent\.' examples/templates/main.tf | grep -v 'coder_agent\.main' 2> /dev/null; then
+    echo "❌ ERROR: examples/templates/main.tf should use 'coder_agent.main'"
+    ERRORS=$((ERRORS + 1))
+  else
+    echo "✅ Example template uses 'coder_agent.main'"
+  fi
+fi
+echo ""
+
+# Check 3: Root documentation should use coder_agent.main
+echo "📝 Checking root documentation..."
+FILES_TO_CHECK=("README.md" "CONTRIBUTING.md")
+for file in "${FILES_TO_CHECK[@]}"; do
+  if [ -f "$file" ]; then
+    if grep 'coder_agent\.' "$file" 2> /dev/null | grep -v 'coder_agent\.main' | grep -v '# ' | grep -v 'agent_id' | grep -v 'coder_agent\.id' | grep -E 'coder_agent\.[a-z_]+' > /dev/null 2>&1; then
+      echo "❌ ERROR: $file should use 'coder_agent.main' in examples"
+      ERRORS=$((ERRORS + 1))
+    fi
+  fi
+done
+
+if [ $ERRORS -eq 0 ]; then
+  echo "✅ All documentation uses 'coder_agent.main'"
+fi
+echo ""
+
+# Summary
+if [ $ERRORS -eq 0 ]; then
+  echo "✅ All linting checks passed!"
+  exit 0
+else
+  echo "❌ Found $ERRORS linting error(s)"
+  echo ""
+  echo "ℹ️  Module documentation should use 'coder_agent.main' in examples"
+  echo "   to match the most common template convention (78% of templates)."
+  exit 1
+fi