diff --git a/nixos/modules/services/continuous-integration/hercules-ci-agent/common.nix b/nixos/modules/services/continuous-integration/hercules-ci-agent/common.nix
index 522d4ddac317..3df057b10279 100644
--- a/nixos/modules/services/continuous-integration/hercules-ci-agent/common.nix
+++ b/nixos/modules/services/continuous-integration/hercules-ci-agent/common.nix
@@ -35,10 +35,14 @@ let
};
concurrentTasks = mkOption {
description = ''
- Number of tasks to perform simultaneously, such as evaluations, derivations.
+ Number of tasks to perform simultaneously.
- You must have a total capacity across agents of at least 2 concurrent tasks on x86_64-linux
- to allow for import from derivation.
+ A task is a single derivation build or an evaluation.
+ At minimum, you need 2 concurrent tasks for x86_64-linux
+ in your cluster, to allow for import from derivation.
+
+ concurrentTasks can be around the CPU core count or lower if memory is
+ the bottleneck.
'';
type = types.int;
default = 4;