chore: rename variable to report_tasks_system_prompt

Author: ssncferreira

registry/coder/modules/claude-code/README.md

@@ -29,8 +29,10 @@ module "claude-code" {
 <!-- TODO(major): remove this note and update the prompt configuration example in the next major release -->
 
 > [!NOTE]
-> By default, `include_coder_system_prompt` is false. For proper integration with Coder (tool selection & task reporting),
-> it is recommended to set `include_coder_system_prompt` to true. In the next major release, this will become the default.
+>
+> By default, `report_tasks_system_prompt` is false.
+> When `report_tasks` is true, it is recommended to set `report_tasks_system_prompt` to true to inject the Coder system prompt to ensure proper task-reporting integration.
+> If `report_tasks` is false, this setting has no effect. In the next major release, the default for `report_tasks_system_prompt` will be true.
 
 ## Prerequisites
 
@@ -42,7 +44,7 @@ module "claude-code" {
 
 ### Prompt configuration (recommended)
 
-Include Coder’s prompt sections and optionally add your own system prompt.
+Include Coder’s prompt section for task reporting and optionally add your own system prompt.
 
 ```hcl
 module "claude-code" {
@@ -51,7 +53,9 @@ module "claude-code" {
   agent_id = coder_agent.example.id
   workdir  = "/home/coder/project"
 
-  include_coder_system_prompt = true
+  # Configure Coder's task reporting
+  report_tasks = true
+  report_tasks_system_prompt = true
 
   # Optional: append additional system prompt.
   system_prompt = <<-EOT

registry/coder/modules/claude-code/main.tf

@@ -186,10 +186,11 @@ variable "system_prompt" {
   default     = "Send a task status update to notify the user that you are ready for input, and then wait for user input."
 }
 
-variable "include_coder_system_prompt" {
+variable "report_tasks_system_prompt" {
   type        = bool
-  description = "Include Coder system prompts for proper integration with tool selection and task reporting. Defaults to false for backward compatibility, will default to true in the next major release."
+  description = "Include the Coder system prompt for task reporting when report_tasks is true. Defaults to false for backward compatibility, will default to true in the next major release."
   # TODO(major): default to true in the next major release
+  #   Related to PR: https://github.com/coder/registry/pull/443
   default = false
 }
 
@@ -237,20 +238,10 @@ locals {
   module_dir_name                   = ".claude-module"
   remove_last_session_id_script_b64 = base64encode(file("${path.module}/scripts/remove-last-session-id.sh"))
 
-  # Required prompts for the module to properly integrate with Coder
+  # Required prompts for the module to properly report task status to Coder
   inner_system_prompt = <<-EOT
       -- Tool Selection --
       - coder_report_task: providing status updates or requesting user input.
-      - playwright: previewing your changes after you made them
-        to confirm it worked as expected
-      -	desktop-commander - use only for commands that keep running
-        (servers, dev watchers, GUI apps).
-      -	Built-in tools - use for everything else:
-        (file operations, git commands, builds & installs, one-off shell commands)
-
-      Remember this decision rule:
-      - Stays running? → desktop-commander
-      - Finishes immediately? → built-in tools
 
       -- Task Reporting --
       Report all tasks to Coder, following these EXACT guidelines:
@@ -267,7 +258,8 @@ locals {
 
   custom_system_prompt = trimspace(try(var.system_prompt, ""))
 
-  final_system_prompt = var.include_coder_system_prompt ? format(
+  # Only include coder system prompts if report_tasks and report_tasks_system_prompt are enabled
+  final_system_prompt = var.report_tasks && var.report_tasks_system_prompt ? format(
     "<system>\n%s\n%s\n</system>",
     local.inner_system_prompt,
     local.custom_system_prompt,

registry/coder/modules/claude-code/main.tftest.hcl

@@ -194,8 +194,8 @@ run "test_claude_code_system_prompt_default" {
   variables {
     agent_id = "test-agent-system-prompt"
     workdir  = "/home/coder/test"
+    # report_tasks_system_prompt: default is false
     # system_prompt: default string is used
-    # include_coder_system_prompt: default is false
   }
 
   assert {
@@ -211,18 +211,18 @@ run "test_claude_code_system_prompt_default" {
   # Ensure Coder sections are not injected when include=false
   assert {
     condition     = length(regexall("-- Tool Selection --|-- Task Reporting --", coder_env.claude_code_system_prompt.value)) == 0
-    error_message = "Coder integration sections should not be present when include_coder_system_prompt is false"
+    error_message = "Coder integration sections should not be present when report_tasks_system_prompt is false"
   }
 }
 
 run "test_claude_code_system_prompt_empty" {
   command = plan
 
   variables {
-    agent_id      = "test-agent-system-prompt"
-    workdir       = "/home/coder/test"
+    agent_id = "test-agent-system-prompt"
+    workdir  = "/home/coder/test"
+    # report_tasks_system_prompt: default is false
     system_prompt = ""
-    # include_coder_system_prompt: default is false
   }
 
   assert {
@@ -235,10 +235,10 @@ run "test_claude_code_system_prompt" {
   command = plan
 
   variables {
-    agent_id      = "test-agent-system-prompt"
-    workdir       = "/home/coder/test"
+    agent_id = "test-agent-system-prompt"
+    workdir  = "/home/coder/test"
+    # report_tasks_system_prompt: default is false
     system_prompt = "Custom addition"
-    # include_coder_system_prompt: default is false
   }
 
   assert {
@@ -254,18 +254,19 @@ run "test_claude_code_system_prompt" {
   # Ensure Coder sections are not injected when include=false
   assert {
     condition     = length(regexall("-- Tool Selection --|-- Task Reporting --", coder_env.claude_code_system_prompt.value)) == 0
-    error_message = "Coder integration sections should not be present when include_coder_system_prompt is false"
+    error_message = "Coder integration sections should not be present when report_tasks_system_prompt is false"
   }
 }
 
-run "test_claude_code_include_coder_system_prompt_and_default_system_prompt" {
+run "test_claude_code_report_tasks_system_prompt_and_default_system_prompt" {
   command = plan
 
   variables {
     agent_id = "test-agent-system-prompt"
     workdir  = "/home/coder/test"
+    # report_tasks: default is true
+    report_tasks_system_prompt = true
     # system_prompt: default string is used
-    include_coder_system_prompt = true
   }
 
   assert {
@@ -289,14 +290,15 @@ run "test_claude_code_include_coder_system_prompt_and_default_system_prompt" {
   }
 }
 
-run "test_claude_code_include_coder_system_prompt_and_custom_system_prompt" {
+run "test_claude_code_report_tasks_system_prompt_and_custom_system_prompt" {
   command = plan
 
   variables {
-    agent_id                    = "test-agent-system-prompt"
-    workdir                     = "/home/coder/test"
-    system_prompt               = "Custom addition"
-    include_coder_system_prompt = true
+    agent_id = "test-agent-system-prompt"
+    workdir  = "/home/coder/test"
+    # report_tasks: default is true
+    report_tasks_system_prompt = true
+    system_prompt              = "Custom addition"
   }
 
   assert {
@@ -314,6 +316,33 @@ run "test_claude_code_include_coder_system_prompt_and_custom_system_prompt" {
     error_message = "System prompt should have Task Reporting section"
   }
 
+  assert {
+    condition     = length(regexall("Custom addition", coder_env.claude_code_system_prompt.value)) > 0
+    error_message = "System prompt should have system_prompt variable value"
+  }
+}
+
+run "test_claude_code_report_tasks_disabled" {
+  command = plan
+
+  variables {
+    agent_id                   = "test-agent-system-prompt"
+    workdir                    = "/home/coder/test"
+    report_tasks               = false
+    report_tasks_system_prompt = true
+    system_prompt              = "Custom addition"
+  }
+
+  assert {
+    condition     = trimspace(coder_env.claude_code_system_prompt.value) != ""
+    error_message = "System prompt should not be empty"
+  }
+
+  assert {
+    condition     = length(regexall("-- Tool Selection --|-- Task Reporting --", coder_env.claude_code_system_prompt.value)) == 0
+    error_message = "Coder integration sections should not be present when report_task is false"
+  }
+
   assert {
     condition     = length(regexall("Custom addition", coder_env.claude_code_system_prompt.value)) > 0
     error_message = "System prompt should have system_prompt variable value"