From f1fc8cc86be29784f90efaa0cb2c58f0e2a0c4d0 Mon Sep 17 00:00:00 2001 From: Mikael Hugo Date: Sat, 2 May 2026 23:07:13 +0200 Subject: [PATCH] docs(sf): disambiguate ADR-011 in PREFERENCES.md template too Same fix as df095b406 but for the user-facing PREFERENCES.md template that ships in /sf init projects. Reading "ADR-011 P2: mid-execution escalation" without the gsd-2 prefix sends operators to SF's local ADR-011 ("Swarm Chat and Debate Mode") which has nothing to do with escalation. Markdown-only. Co-Authored-By: Claude Opus 4.7 (1M context) --- src/resources/extensions/sf/templates/PREFERENCES.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) 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