diff --git a/src/resources/extensions/sf/templates/PREFERENCES.md b/src/resources/extensions/sf/templates/PREFERENCES.md
index 60b0827bf..37e5e2344 100644
--- a/src/resources/extensions/sf/templates/PREFERENCES.md
+++ b/src/resources/extensions/sf/templates/PREFERENCES.md
@@ -32,12 +32,13 @@ phases:
   skip_reassess:
   reassess_after_slice:
   skip_slice_research:
-  # ADR-011: progressive planning. When true, the milestone planner can mark
-  # slices as sketches (is_sketch=1, sketch_scope=<2-3 sentence hint>) and
-  # refine-slice expands each one just-in-time using prior slice summaries
-  # as context. When false (default), all slices get full plans up front.
+  # gsd-2 ADR-011 P1: progressive planning. When true, the milestone planner
+  # can mark slices as sketches (is_sketch=1, sketch_scope=<2-3 sentence
+  # hint>) and refine-slice expands each one just-in-time using prior slice
+  # summaries as context. When false (default), all slices get full plans up
+  # front. (Note: SF's local ADR-011 is "Swarm Chat" — unrelated.)
   progressive_planning:
-  # ADR-011 P2: mid-execution escalation. When true, sf_task_complete honors
+  # gsd-2 ADR-011 P2: mid-execution escalation. When true, sf_task_complete honors
   # an optional escalation: { question, options, recommendation, ... } payload.
   # The agent's choice carries forward as a hard constraint into the next
   # executor. See escalation_auto_accept for whether auto-mode pauses or