diff --git a/tasks/workstation/linux/software/ai/llm.yml b/tasks/workstation/linux/software/ai/llm.yml
index c3e4dca..c9b76bb 100644
--- a/tasks/workstation/linux/software/ai/llm.yml
+++ b/tasks/workstation/linux/software/ai/llm.yml
@@ -779,6 +779,45 @@
                 alias(libs.plugins.kotlinCompose)
               }
               ```
+
+              # Build Processes
+
+              ## Kotlin Multiplatform (KMP)
+
+              ### Kotlin Toolchain
+
+              This is the preferred build type when setting up new projects.
+
+              Please use `kotlin` rather than any `amper` commands. `amper` has
+              been deprecated and is intentionally not present on the system.
+              Examples:
+
+              ```
+              # 1. Compile + link ALL targets (JVM, iOS, Android, native, etc.)
+              ./kotlin build
+
+              # 2. (Optional) Run tests across all targets
+              ./kotlin test
+
+              # 3. (Optional) Run all quality checks (tests + registered linters)
+              ./kotlin check
+              ```
+
+              ### Gradle KMP
+
+              This is a legacy method, new projects will not be set up with it.
+              Examples:
+
+              ```
+              # Compile all targets
+              ./gradlew assemble
+
+              # Or more explicitly (if you want to be sure nothing is skipped):
+              ./gradlew jvmJar assembleDebug assembleIosSimulatorArm64  # etc. per target
+
+              # Run all tests
+              ./gradlew allTests
+              ```
             backup: false
             owner: "{{ user }}"
             group: "{{ user }}"