diff --git a/.changeset/2279-map-codebase-refresh-stamps.md b/.changeset/2279-map-codebase-refresh-stamps.md
new file mode 100644
index 000000000..2976d30e4
--- /dev/null
+++ b/.changeset/2279-map-codebase-refresh-stamps.md
@@ -0,0 +1,5 @@
+---
+type: Fixed
+pr: 2550
+---
+**`/gsd-map-codebase` Update mode now refreshes all date stamps** — the `**Analysis Date:**` line, the `*... analysis: ...*` footer, and the `<!-- refreshed: ... -->` header are set to the current date on every run, overwriting any prior date. Previously, Update runs only replaced `[YYYY-MM-DD]` placeholder tokens, which don't exist in already-generated files (they contain concrete dates from the prior run), so stamps silently retained the original mapping date. (#2279)
diff --git a/agents/gsd-codebase-mapper.md b/agents/gsd-codebase-mapper.md
index 5a92d75e7..61b98111c 100644
--- a/agents/gsd-codebase-mapper.md
+++ b/agents/gsd-codebase-mapper.md
@@ -175,7 +175,7 @@ Write document(s) to `.planning/codebase/` using the templates below.
 **Document naming:** UPPERCASE.md (e.g., STACK.md, ARCHITECTURE.md)
 
 **Template filling:**
-1. Replace `[YYYY-MM-DD]` with the date provided in your prompt (the `Today's date:` line). NEVER guess or infer the date — always use the exact date from the prompt.
+1. Set the `**Analysis Date:**` line, the `*... analysis: ...*` footer, and any `<!-- refreshed: ... -->` header to the date provided in your prompt (the `Today's date:` line), overwriting whatever date is already there. NEVER guess or infer the date — always use the exact date from the prompt.
 2. Replace `[Placeholder text]` with findings from exploration
 3. If something is not found, use "Not detected" or "Not applicable"
 4. Always include file paths with backticks
diff --git a/gsd-core/workflows/map-codebase.md b/gsd-core/workflows/map-codebase.md
index 50e548775..0583060d7 100644
--- a/gsd-core/workflows/map-codebase.md
+++ b/gsd-core/workflows/map-codebase.md
@@ -167,7 +167,7 @@ Write these documents to {codebase_dir}/:
 - STACK.md - Languages, runtime, frameworks, dependencies, configuration
 - INTEGRATIONS.md - External APIs, databases, auth providers, webhooks
 
-IMPORTANT: Use {date} for all [YYYY-MM-DD] date placeholders in documents.
+IMPORTANT: Set all date stamps (`**Analysis Date:**`, footer `*... analysis: ...*`, `<!-- refreshed: ... -->`) to {date}, overwriting any existing date.
 
 Scope: ${PATH_SCOPE_HINT:-(full repo)} — when --paths is supplied, restrict exploration to those prefixes only.
 
@@ -193,7 +193,7 @@ Write these documents to {codebase_dir}/:
 - ARCHITECTURE.md - Pattern, layers, data flow, abstractions, entry points
 - STRUCTURE.md - Directory layout, key locations, naming conventions
 
-IMPORTANT: Use {date} for all [YYYY-MM-DD] date placeholders in documents.
+IMPORTANT: Set all date stamps (`**Analysis Date:**`, footer `*... analysis: ...*`, `<!-- refreshed: ... -->`) to {date}, overwriting any existing date.
 
 Scope: ${PATH_SCOPE_HINT:-(full repo)} — when --paths is supplied, restrict exploration to those prefixes only.
 
@@ -219,7 +219,7 @@ Write these documents to {codebase_dir}/:
 - CONVENTIONS.md - Code style, naming, patterns, error handling
 - TESTING.md - Framework, structure, mocking, coverage
 
-IMPORTANT: Use {date} for all [YYYY-MM-DD] date placeholders in documents.
+IMPORTANT: Set all date stamps (`**Analysis Date:**`, footer `*... analysis: ...*`, `<!-- refreshed: ... -->`) to {date}, overwriting any existing date.
 
 Scope: ${PATH_SCOPE_HINT:-(full repo)} — when --paths is supplied, restrict exploration to those prefixes only.
 
@@ -244,7 +244,7 @@ Analyze this codebase for technical debt, known issues, and areas of concern.
 Write this document to {codebase_dir}/:
 - CONCERNS.md - Tech debt, bugs, security, performance, fragile areas
 
-IMPORTANT: Use {date} for all [YYYY-MM-DD] date placeholders in documents.
+IMPORTANT: Set all date stamps (`**Analysis Date:**`, footer `*... analysis: ...*`, `<!-- refreshed: ... -->`) to {date}, overwriting any existing date.
 
 Scope: ${PATH_SCOPE_HINT:-(full repo)} — when --paths is supplied, restrict exploration to those prefixes only.
 
@@ -297,7 +297,7 @@ When the `Agent` tool is unavailable, perform codebase mapping sequentially in t
 
 **IMPORTANT:** Do NOT use `browser_subagent`, `Explore`, or any browser-based tool. Use only file system tools (Read, Bash, Write, Grep, Glob, list_dir, view_file, grep_search, or equivalent tools available in your runtime).
 
-**IMPORTANT:** Use `{date}` from init context for all `[YYYY-MM-DD]` date placeholders in documents. NEVER guess the date.
+**IMPORTANT:** Set all date stamps (`**Analysis Date:**`, footer, `<!-- refreshed -->`) to `{date}` from init context, overwriting any existing date — Update runs seed from files with concrete prior dates, so merely replacing `[YYYY-MM-DD]` placeholders is not sufficient. NEVER guess the date.
 
 **SCOPE:** When `${PATH_SCOPE_HINT}` is non-empty (i.e. `--paths` was supplied), restrict every pass below to the validated path prefixes in `${SCOPED_PATHS}`. Do NOT scan files outside those prefixes. When `${PATH_SCOPE_HINT}` is empty, perform a full-repo scan.
 
diff --git a/tests/agent-size-baseline.json b/tests/agent-size-baseline.json
index 50bacea3c..afb6f5fa5 100644
--- a/tests/agent-size-baseline.json
+++ b/tests/agent-size-baseline.json
@@ -4,7 +4,7 @@
   "gsd-assumptions-analyzer.md": 4646,
   "gsd-code-fixer.md": 36640,
   "gsd-code-reviewer.md": 16870,
-  "gsd-codebase-mapper.md": 21485,
+  "gsd-codebase-mapper.md": 21614,
   "gsd-debug-session-manager.md": 17161,
   "gsd-debugger.md": 57197,
   "gsd-doc-classifier.md": 11717,
diff --git a/tests/fixtures/golden-install-parity/antigravity.json b/tests/fixtures/golden-install-parity/antigravity.json
index 94278bb24..f49f9113e 100644
--- a/tests/fixtures/golden-install-parity/antigravity.json
+++ b/tests/fixtures/golden-install-parity/antigravity.json
@@ -6,7 +6,7 @@
   "agents/gsd-assumptions-analyzer.md": "00a02fdcbaa8d833",
   "agents/gsd-code-fixer.md": "6937a1f20beaa1c6",
   "agents/gsd-code-reviewer.md": "a700d295bbf110a9",
-  "agents/gsd-codebase-mapper.md": "afdae82284cb21b4",
+  "agents/gsd-codebase-mapper.md": "aa06b807bd7a5e3e",
   "agents/gsd-debug-session-manager.md": "8a7ae327a00d47cd",
   "agents/gsd-debugger.md": "9c8f34fc022b2616",
   "agents/gsd-doc-classifier.md": "fca19595590391df",
@@ -273,7 +273,7 @@
   "gsd-core/workflows/list-seeds.md": "3a8b612306ecf9c3",
   "gsd-core/workflows/list-workspaces.md": "f6b1bc9fa13cc155",
   "gsd-core/workflows/manager.md": "7cd083b4f5b721b6",
-  "gsd-core/workflows/map-codebase.md": "b7ddde14c91d226e",
+  "gsd-core/workflows/map-codebase.md": "cf6da4d441c1542f",
   "gsd-core/workflows/milestone-summary.md": "c4620853fe489126",
   "gsd-core/workflows/mvp-phase.md": "3675856fb091e68a",
   "gsd-core/workflows/new-milestone.md": "fbfbcc14973d70df",
diff --git a/tests/fixtures/golden-install-parity/augment.json b/tests/fixtures/golden-install-parity/augment.json
index 64d643659..b2585fe31 100644
--- a/tests/fixtures/golden-install-parity/augment.json
+++ b/tests/fixtures/golden-install-parity/augment.json
@@ -6,7 +6,7 @@
   "agents/gsd-assumptions-analyzer.md": "b3219da6b194fdef",
   "agents/gsd-code-fixer.md": "68b2d2faccfdd8a3",
   "agents/gsd-code-reviewer.md": "bc8a6f2e1f787ff5",
-  "agents/gsd-codebase-mapper.md": "85ea778ad9cf7e66",
+  "agents/gsd-codebase-mapper.md": "d369048683978297",
   "agents/gsd-debug-session-manager.md": "1d966d0bbf22660c",
   "agents/gsd-debugger.md": "584692481a9f5e0f",
   "agents/gsd-doc-classifier.md": "262a94b947a4e2aa",
@@ -344,7 +344,7 @@
   "gsd-core/workflows/list-seeds.md": "b687f2a843032d65",
   "gsd-core/workflows/list-workspaces.md": "7f94e18b5c549453",
   "gsd-core/workflows/manager.md": "c18fab593344253d",
-  "gsd-core/workflows/map-codebase.md": "cc4726da0ce6b138",
+  "gsd-core/workflows/map-codebase.md": "e59b600b28ebeed5",
   "gsd-core/workflows/milestone-summary.md": "e0cdfddbd39a9043",
   "gsd-core/workflows/mvp-phase.md": "58a952b4715db283",
   "gsd-core/workflows/new-milestone.md": "b0a1fd443cd87be9",
diff --git a/tests/fixtures/golden-install-parity/claude-local.json b/tests/fixtures/golden-install-parity/claude-local.json
index 7134aa466..70383b532 100644
--- a/tests/fixtures/golden-install-parity/claude-local.json
+++ b/tests/fixtures/golden-install-parity/claude-local.json
@@ -5,7 +5,7 @@
   "agents/gsd-assumptions-analyzer.md": "d796f8245bbe05d2",
   "agents/gsd-code-fixer.md": "c6148e5511d02459",
   "agents/gsd-code-reviewer.md": "e2c45baa8c0b5f6d",
-  "agents/gsd-codebase-mapper.md": "f96958e5f85b93fb",
+  "agents/gsd-codebase-mapper.md": "39d22382c5897858",
   "agents/gsd-debug-session-manager.md": "d5fbb343fac38729",
   "agents/gsd-debugger.md": "d6785173fbeee901",
   "agents/gsd-doc-classifier.md": "a76778bdde1c7f72",
@@ -343,7 +343,7 @@
   "gsd-core/workflows/list-seeds.md": "7576156b91e9abee",
   "gsd-core/workflows/list-workspaces.md": "90caeeb11cec0128",
   "gsd-core/workflows/manager.md": "9dcb5eaf64f86627",
-  "gsd-core/workflows/map-codebase.md": "f91b876738d1c27c",
+  "gsd-core/workflows/map-codebase.md": "e95cc21d95c2883b",
   "gsd-core/workflows/milestone-summary.md": "99636900c216c8d2",
   "gsd-core/workflows/mvp-phase.md": "88cf363abd25f41e",
   "gsd-core/workflows/new-milestone.md": "2353977cd96cb9c0",
diff --git a/tests/fixtures/golden-install-parity/claude.json b/tests/fixtures/golden-install-parity/claude.json
index 73f12b434..aa51699fc 100644
--- a/tests/fixtures/golden-install-parity/claude.json
+++ b/tests/fixtures/golden-install-parity/claude.json
@@ -5,7 +5,7 @@
   "agents/gsd-assumptions-analyzer.md": "f94fdd67f70b4a5d",
   "agents/gsd-code-fixer.md": "3d5f67cfd24ac452",
   "agents/gsd-code-reviewer.md": "d626a828e8de3648",
-  "agents/gsd-codebase-mapper.md": "8c2e9f2ce3aedf78",
+  "agents/gsd-codebase-mapper.md": "7b9d1f97d593e300",
   "agents/gsd-debug-session-manager.md": "1e23cdf4376bed3c",
   "agents/gsd-debugger.md": "064815a723abac0c",
   "agents/gsd-doc-classifier.md": "a636ae9594b25770",
@@ -272,7 +272,7 @@
   "gsd-core/workflows/list-seeds.md": "5a46337f55ae8453",
   "gsd-core/workflows/list-workspaces.md": "418570fbc8b938da",
   "gsd-core/workflows/manager.md": "441d052077bee516",
-  "gsd-core/workflows/map-codebase.md": "1fd182eface71e93",
+  "gsd-core/workflows/map-codebase.md": "cf0ec9f9f0f96040",
   "gsd-core/workflows/milestone-summary.md": "ad8e69fcb3463ce4",
   "gsd-core/workflows/mvp-phase.md": "58a952b4715db283",
   "gsd-core/workflows/new-milestone.md": "2c282e8f89286132",
diff --git a/tests/fixtures/golden-install-parity/cline.json b/tests/fixtures/golden-install-parity/cline.json
index 4e6eff4e0..5ed80bc08 100644
--- a/tests/fixtures/golden-install-parity/cline.json
+++ b/tests/fixtures/golden-install-parity/cline.json
@@ -9,7 +9,7 @@
   "agents/gsd-assumptions-analyzer.md": "b3219da6b194fdef",
   "agents/gsd-code-fixer.md": "6aa74a2fb2ad244a",
   "agents/gsd-code-reviewer.md": "e5ec12d4d409e800",
-  "agents/gsd-codebase-mapper.md": "e5b7941bdda53c91",
+  "agents/gsd-codebase-mapper.md": "efedbf9228fc9dc6",
   "agents/gsd-debug-session-manager.md": "444fa983fdc85325",
   "agents/gsd-debugger.md": "427daaf994a596ba",
   "agents/gsd-doc-classifier.md": "5011d7358d2b2848",
@@ -276,7 +276,7 @@
   "gsd-core/workflows/list-seeds.md": "25050c5e1b2b7176",
   "gsd-core/workflows/list-workspaces.md": "8f0707ecbc395856",
   "gsd-core/workflows/manager.md": "2988de4db361ceae",
-  "gsd-core/workflows/map-codebase.md": "397f33ff14c496de",
+  "gsd-core/workflows/map-codebase.md": "3a2f7dccc9ef6ba0",
   "gsd-core/workflows/milestone-summary.md": "20e56b9e3902e1d2",
   "gsd-core/workflows/mvp-phase.md": "a95d43689a43163c",
   "gsd-core/workflows/new-milestone.md": "3b3c9609f5c7a806",
diff --git a/tests/fixtures/golden-install-parity/codebuddy.json b/tests/fixtures/golden-install-parity/codebuddy.json
index dfa13918e..dbd3798cc 100644
--- a/tests/fixtures/golden-install-parity/codebuddy.json
+++ b/tests/fixtures/golden-install-parity/codebuddy.json
@@ -6,7 +6,7 @@
   "agents/gsd-assumptions-analyzer.md": "b3219da6b194fdef",
   "agents/gsd-code-fixer.md": "1cf3a9fdade9a470",
   "agents/gsd-code-reviewer.md": "5342fcc0da974696",
-  "agents/gsd-codebase-mapper.md": "b995bf01af0193d2",
+  "agents/gsd-codebase-mapper.md": "0c8f04c738c20a29",
   "agents/gsd-debug-session-manager.md": "8a495718576f24e6",
   "agents/gsd-debugger.md": "e454548710419254",
   "agents/gsd-doc-classifier.md": "c2bf59af9467810b",
@@ -344,7 +344,7 @@
   "gsd-core/workflows/list-seeds.md": "b687f2a843032d65",
   "gsd-core/workflows/list-workspaces.md": "7f94e18b5c549453",
   "gsd-core/workflows/manager.md": "c18fab593344253d",
-  "gsd-core/workflows/map-codebase.md": "cc4726da0ce6b138",
+  "gsd-core/workflows/map-codebase.md": "e59b600b28ebeed5",
   "gsd-core/workflows/milestone-summary.md": "e0cdfddbd39a9043",
   "gsd-core/workflows/mvp-phase.md": "58a952b4715db283",
   "gsd-core/workflows/new-milestone.md": "b0a1fd443cd87be9",
diff --git a/tests/fixtures/golden-install-parity/codex.json b/tests/fixtures/golden-install-parity/codex.json
index 50df5bcfb..4f98a9b94 100644
--- a/tests/fixtures/golden-install-parity/codex.json
+++ b/tests/fixtures/golden-install-parity/codex.json
@@ -82,8 +82,8 @@
   "agents/gsd-code-fixer.toml": "c8286e7d68753288",
   "agents/gsd-code-reviewer.md": "854d93fb1e91fca4",
   "agents/gsd-code-reviewer.toml": "66420d6e6ffd14eb",
-  "agents/gsd-codebase-mapper.md": "cf8f8550b44aec35",
-  "agents/gsd-codebase-mapper.toml": "a4609f3ac66c2081",
+  "agents/gsd-codebase-mapper.md": "7a1560013a0182d0",
+  "agents/gsd-codebase-mapper.toml": "98041d44c9d9f69e",
   "agents/gsd-debug-session-manager.md": "8a336fd497d2e6b2",
   "agents/gsd-debug-session-manager.toml": "277a54c7661ff018",
   "agents/gsd-debugger.md": "b2a4aff97b1b87e3",
@@ -379,7 +379,7 @@
   "gsd-core/workflows/list-seeds.md": "0a2d9fd5b06b8ded",
   "gsd-core/workflows/list-workspaces.md": "bb74607336897b94",
   "gsd-core/workflows/manager.md": "5f9365147f53e3f5",
-  "gsd-core/workflows/map-codebase.md": "afd0ab0c1e3cf95a",
+  "gsd-core/workflows/map-codebase.md": "71ac4c82d2242979",
   "gsd-core/workflows/milestone-summary.md": "a53b30a84f904b50",
   "gsd-core/workflows/mvp-phase.md": "85fea39f30f8c698",
   "gsd-core/workflows/new-milestone.md": "1adcd8cb6e5869d8",
diff --git a/tests/fixtures/golden-install-parity/copilot.json b/tests/fixtures/golden-install-parity/copilot.json
index ce3c3042f..046144672 100644
--- a/tests/fixtures/golden-install-parity/copilot.json
+++ b/tests/fixtures/golden-install-parity/copilot.json
@@ -6,7 +6,7 @@
   "agents/gsd-assumptions-analyzer.agent.md": "cdabed4777a842fe",
   "agents/gsd-code-fixer.agent.md": "8f39aacb760aab57",
   "agents/gsd-code-reviewer.agent.md": "fa1e7c421c78eae1",
-  "agents/gsd-codebase-mapper.agent.md": "949bc73f2a7ea44d",
+  "agents/gsd-codebase-mapper.agent.md": "347d66bb17975c3e",
   "agents/gsd-debug-session-manager.agent.md": "e669e5d76bfd7810",
   "agents/gsd-debugger.agent.md": "f7d0307490617a8a",
   "agents/gsd-doc-classifier.agent.md": "aea81c0ba00e06cf",
@@ -274,7 +274,7 @@
   "gsd-core/workflows/list-seeds.md": "71dc6f748b1d1c0e",
   "gsd-core/workflows/list-workspaces.md": "3c9f76af08ced623",
   "gsd-core/workflows/manager.md": "5acdd15485a04ab0",
-  "gsd-core/workflows/map-codebase.md": "dbb585612571b900",
+  "gsd-core/workflows/map-codebase.md": "321045e645dfa271",
   "gsd-core/workflows/milestone-summary.md": "8a53906253984a62",
   "gsd-core/workflows/mvp-phase.md": "3c00d29043864af2",
   "gsd-core/workflows/new-milestone.md": "2fb2e8a092aaa7af",
diff --git a/tests/fixtures/golden-install-parity/cursor.json b/tests/fixtures/golden-install-parity/cursor.json
index 68d7588d7..3833ba0d9 100644
--- a/tests/fixtures/golden-install-parity/cursor.json
+++ b/tests/fixtures/golden-install-parity/cursor.json
@@ -6,7 +6,7 @@
   "agents/gsd-assumptions-analyzer.md": "b3219da6b194fdef",
   "agents/gsd-code-fixer.md": "76085f4442f268e6",
   "agents/gsd-code-reviewer.md": "f29d6edbac0a01b6",
-  "agents/gsd-codebase-mapper.md": "d49c91fdab4efc70",
+  "agents/gsd-codebase-mapper.md": "71113be5f5cacfe9",
   "agents/gsd-debug-session-manager.md": "c723ce1b8691296f",
   "agents/gsd-debugger.md": "bd40d58a35995f22",
   "agents/gsd-doc-classifier.md": "a6ab02b8f45f9d0b",
@@ -344,7 +344,7 @@
   "gsd-core/workflows/list-seeds.md": "831ddc27b684e30b",
   "gsd-core/workflows/list-workspaces.md": "418570fbc8b938da",
   "gsd-core/workflows/manager.md": "c6c3dc3eaa815c51",
-  "gsd-core/workflows/map-codebase.md": "9d38176ff243da41",
+  "gsd-core/workflows/map-codebase.md": "13029303755f1c3a",
   "gsd-core/workflows/milestone-summary.md": "6c76386b500cc5d3",
   "gsd-core/workflows/mvp-phase.md": "f0f7d7d6c2e5435f",
   "gsd-core/workflows/new-milestone.md": "c81c93dcc6297739",
diff --git a/tests/fixtures/golden-install-parity/hermes.json b/tests/fixtures/golden-install-parity/hermes.json
index 331691643..3f5f9a335 100644
--- a/tests/fixtures/golden-install-parity/hermes.json
+++ b/tests/fixtures/golden-install-parity/hermes.json
@@ -6,7 +6,7 @@
   "agents/gsd-assumptions-analyzer.md": "f11a80795163bb5d",
   "agents/gsd-code-fixer.md": "94628312f25decb5",
   "agents/gsd-code-reviewer.md": "5ef947ca5baed775",
-  "agents/gsd-codebase-mapper.md": "feccaeeacd05e34b",
+  "agents/gsd-codebase-mapper.md": "4749858e8e97f1d2",
   "agents/gsd-debug-session-manager.md": "d46222bd8037b695",
   "agents/gsd-debugger.md": "3b00e344e8200dce",
   "agents/gsd-doc-classifier.md": "29b563a146c9d22c",
@@ -273,7 +273,7 @@
   "gsd-core/workflows/list-seeds.md": "ad1d81683e48c4e1",
   "gsd-core/workflows/list-workspaces.md": "1fe28ba52cee1394",
   "gsd-core/workflows/manager.md": "f0eb25349617495b",
-  "gsd-core/workflows/map-codebase.md": "0c00516d38a8cda6",
+  "gsd-core/workflows/map-codebase.md": "710f2f185f874e85",
   "gsd-core/workflows/milestone-summary.md": "353fffb60749d892",
   "gsd-core/workflows/mvp-phase.md": "593faf3ec49b26d0",
   "gsd-core/workflows/new-milestone.md": "e0a223e3a3281bae",
diff --git a/tests/fixtures/golden-install-parity/kilo.json b/tests/fixtures/golden-install-parity/kilo.json
index f565f317a..48b682c74 100644
--- a/tests/fixtures/golden-install-parity/kilo.json
+++ b/tests/fixtures/golden-install-parity/kilo.json
@@ -6,7 +6,7 @@
   "agents/gsd-assumptions-analyzer.md": "567d823ccd036b39",
   "agents/gsd-code-fixer.md": "9652d5b56a2afbf5",
   "agents/gsd-code-reviewer.md": "922c08885bc78662",
-  "agents/gsd-codebase-mapper.md": "0ccbf6a685804979",
+  "agents/gsd-codebase-mapper.md": "1f45939542994a42",
   "agents/gsd-debug-session-manager.md": "42a775633c9b1b34",
   "agents/gsd-debugger.md": "aab7ddbbdc75f6c8",
   "agents/gsd-doc-classifier.md": "6256bbc0b887f60f",
@@ -344,7 +344,7 @@
   "gsd-core/workflows/list-seeds.md": "5a46337f55ae8453",
   "gsd-core/workflows/list-workspaces.md": "418570fbc8b938da",
   "gsd-core/workflows/manager.md": "2fadda5e3ebd3c4e",
-  "gsd-core/workflows/map-codebase.md": "4f0d553298c7067b",
+  "gsd-core/workflows/map-codebase.md": "b6f5d2b30ab7c4c0",
   "gsd-core/workflows/milestone-summary.md": "25775eeb4e2747be",
   "gsd-core/workflows/mvp-phase.md": "b2f6ba5de4c96180",
   "gsd-core/workflows/new-milestone.md": "156a0b20596f0032",
diff --git a/tests/fixtures/golden-install-parity/kimi-code.json b/tests/fixtures/golden-install-parity/kimi-code.json
index 4dddfe074..4502fb576 100644
--- a/tests/fixtures/golden-install-parity/kimi-code.json
+++ b/tests/fixtures/golden-install-parity/kimi-code.json
@@ -34,7 +34,7 @@
   "agents/gsd-assumptions-analyzer.md": "f11a80795163bb5d",
   "agents/gsd-code-fixer.md": "78549833f0411b0c",
   "agents/gsd-code-reviewer.md": "7d94fe8bfa6661aa",
-  "agents/gsd-codebase-mapper.md": "7cc9d387f29c46e1",
+  "agents/gsd-codebase-mapper.md": "3941bfc98c091018",
   "agents/gsd-debug-session-manager.md": "dc4e8a556dbf1708",
   "agents/gsd-debugger.md": "7840ed78e3f662a8",
   "agents/gsd-doc-classifier.md": "146acf4d176134b5",
@@ -301,7 +301,7 @@
   "gsd-core/workflows/list-seeds.md": "b687f2a843032d65",
   "gsd-core/workflows/list-workspaces.md": "7f94e18b5c549453",
   "gsd-core/workflows/manager.md": "c18fab593344253d",
-  "gsd-core/workflows/map-codebase.md": "cc4726da0ce6b138",
+  "gsd-core/workflows/map-codebase.md": "e59b600b28ebeed5",
   "gsd-core/workflows/milestone-summary.md": "e0cdfddbd39a9043",
   "gsd-core/workflows/mvp-phase.md": "58a952b4715db283",
   "gsd-core/workflows/new-milestone.md": "b0a1fd443cd87be9",
diff --git a/tests/fixtures/golden-install-parity/kimi.json b/tests/fixtures/golden-install-parity/kimi.json
index 1b8a321dd..b5e5ef4a6 100644
--- a/tests/fixtures/golden-install-parity/kimi.json
+++ b/tests/fixtures/golden-install-parity/kimi.json
@@ -41,7 +41,7 @@
   "agents/subagents/gsd-code-fixer.yaml": "41147d668c7e75cb",
   "agents/subagents/gsd-code-reviewer.md": "27cee6e8adae57da",
   "agents/subagents/gsd-code-reviewer.yaml": "5f2398f56018f50d",
-  "agents/subagents/gsd-codebase-mapper.md": "04c7528a13fa3de7",
+  "agents/subagents/gsd-codebase-mapper.md": "91fc76ecb02bbc30",
   "agents/subagents/gsd-codebase-mapper.yaml": "bce1c6d15f55c477",
   "agents/subagents/gsd-debug-session-manager.md": "cec62a7fd99ab1c3",
   "agents/subagents/gsd-debug-session-manager.yaml": "aab147717b5082e7",
@@ -337,7 +337,7 @@
   "gsd-core/workflows/list-seeds.md": "b687f2a843032d65",
   "gsd-core/workflows/list-workspaces.md": "7f94e18b5c549453",
   "gsd-core/workflows/manager.md": "c18fab593344253d",
-  "gsd-core/workflows/map-codebase.md": "cc4726da0ce6b138",
+  "gsd-core/workflows/map-codebase.md": "e59b600b28ebeed5",
   "gsd-core/workflows/milestone-summary.md": "e0cdfddbd39a9043",
   "gsd-core/workflows/mvp-phase.md": "58a952b4715db283",
   "gsd-core/workflows/new-milestone.md": "b0a1fd443cd87be9",
diff --git a/tests/fixtures/golden-install-parity/opencode.json b/tests/fixtures/golden-install-parity/opencode.json
index d7c0ac008..f98cbfa14 100644
--- a/tests/fixtures/golden-install-parity/opencode.json
+++ b/tests/fixtures/golden-install-parity/opencode.json
@@ -6,7 +6,7 @@
   "agents/gsd-assumptions-analyzer.md": "45c01017e84ba193",
   "agents/gsd-code-fixer.md": "3622ae5d90fb15f6",
   "agents/gsd-code-reviewer.md": "2249774416314c57",
-  "agents/gsd-codebase-mapper.md": "948612acd505e87f",
+  "agents/gsd-codebase-mapper.md": "89c6eed5863f1c23",
   "agents/gsd-debug-session-manager.md": "e4b96ea41c74c479",
   "agents/gsd-debugger.md": "f08bcc712bc98469",
   "agents/gsd-doc-classifier.md": "fb776cfbb7e991b0",
@@ -344,7 +344,7 @@
   "gsd-core/workflows/list-seeds.md": "9b05425fa7d24827",
   "gsd-core/workflows/list-workspaces.md": "dc6d30036c6dc426",
   "gsd-core/workflows/manager.md": "eda80c0d3d32dbf6",
-  "gsd-core/workflows/map-codebase.md": "8bf841c248252a97",
+  "gsd-core/workflows/map-codebase.md": "59c2c74fc9de513c",
   "gsd-core/workflows/milestone-summary.md": "321ea8a6a206f38f",
   "gsd-core/workflows/mvp-phase.md": "94360741a1d8d7ce",
   "gsd-core/workflows/new-milestone.md": "372aa3a92916398e",
diff --git a/tests/fixtures/golden-install-parity/pi.json b/tests/fixtures/golden-install-parity/pi.json
index 434d04554..f1440341b 100644
--- a/tests/fixtures/golden-install-parity/pi.json
+++ b/tests/fixtures/golden-install-parity/pi.json
@@ -240,7 +240,7 @@
   "gsd-core/workflows/list-seeds.md": "b687f2a843032d65",
   "gsd-core/workflows/list-workspaces.md": "7f94e18b5c549453",
   "gsd-core/workflows/manager.md": "c18fab593344253d",
-  "gsd-core/workflows/map-codebase.md": "cc4726da0ce6b138",
+  "gsd-core/workflows/map-codebase.md": "e59b600b28ebeed5",
   "gsd-core/workflows/milestone-summary.md": "e0cdfddbd39a9043",
   "gsd-core/workflows/mvp-phase.md": "58a952b4715db283",
   "gsd-core/workflows/new-milestone.md": "b0a1fd443cd87be9",
diff --git a/tests/fixtures/golden-install-parity/qwen.json b/tests/fixtures/golden-install-parity/qwen.json
index bcb3b3349..89f17cfa0 100644
--- a/tests/fixtures/golden-install-parity/qwen.json
+++ b/tests/fixtures/golden-install-parity/qwen.json
@@ -6,7 +6,7 @@
   "agents/gsd-assumptions-analyzer.md": "6a2e38d685ba0fce",
   "agents/gsd-code-fixer.md": "3ed1a27ddc372ef8",
   "agents/gsd-code-reviewer.md": "27eeeee6cb600e9b",
-  "agents/gsd-codebase-mapper.md": "032ff8ac55466a74",
+  "agents/gsd-codebase-mapper.md": "019215e91bf01097",
   "agents/gsd-debug-session-manager.md": "c1c9c5f538acb941",
   "agents/gsd-debugger.md": "41bdbb009989d3a0",
   "agents/gsd-doc-classifier.md": "bdf3d54082424e76",
@@ -273,7 +273,7 @@
   "gsd-core/workflows/list-seeds.md": "8d6e1b5d85f64c6f",
   "gsd-core/workflows/list-workspaces.md": "5e434933a3db695c",
   "gsd-core/workflows/manager.md": "745a2b5080767882",
-  "gsd-core/workflows/map-codebase.md": "d74c891f9e8bfd93",
+  "gsd-core/workflows/map-codebase.md": "dbcc5709066dbce4",
   "gsd-core/workflows/milestone-summary.md": "97ddfc40c6bce906",
   "gsd-core/workflows/mvp-phase.md": "9d226159c2aaae3d",
   "gsd-core/workflows/new-milestone.md": "cdd87db7f6f4f9c2",
diff --git a/tests/fixtures/golden-install-parity/trae.json b/tests/fixtures/golden-install-parity/trae.json
index 78a5cb048..d0dd425aa 100644
--- a/tests/fixtures/golden-install-parity/trae.json
+++ b/tests/fixtures/golden-install-parity/trae.json
@@ -6,7 +6,7 @@
   "agents/gsd-assumptions-analyzer.md": "b3219da6b194fdef",
   "agents/gsd-code-fixer.md": "5fe29063843be67e",
   "agents/gsd-code-reviewer.md": "338c46ab59c4e45f",
-  "agents/gsd-codebase-mapper.md": "8529d8a1ede8bbfb",
+  "agents/gsd-codebase-mapper.md": "85e624b7494ecdeb",
   "agents/gsd-debug-session-manager.md": "913a370b529ec717",
   "agents/gsd-debugger.md": "2d6762c3a0974a31",
   "agents/gsd-doc-classifier.md": "a6ab02b8f45f9d0b",
@@ -273,7 +273,7 @@
   "gsd-core/workflows/list-seeds.md": "74ec072a74f8fdfe",
   "gsd-core/workflows/list-workspaces.md": "886e99378a3d19d9",
   "gsd-core/workflows/manager.md": "fd834a4236bd1b2e",
-  "gsd-core/workflows/map-codebase.md": "9c49154066632021",
+  "gsd-core/workflows/map-codebase.md": "74fc25f83659a5e3",
   "gsd-core/workflows/milestone-summary.md": "a0063cfbe08f2250",
   "gsd-core/workflows/mvp-phase.md": "c4e49ad83e1413ef",
   "gsd-core/workflows/new-milestone.md": "45a240055c9edffc",
diff --git a/tests/fixtures/golden-install-parity/windsurf.json b/tests/fixtures/golden-install-parity/windsurf.json
index 5a4b6fcac..ad59e6183 100644
--- a/tests/fixtures/golden-install-parity/windsurf.json
+++ b/tests/fixtures/golden-install-parity/windsurf.json
@@ -6,7 +6,7 @@
   "agents/gsd-assumptions-analyzer.md": "b3219da6b194fdef",
   "agents/gsd-code-fixer.md": "f00d815ec535a168",
   "agents/gsd-code-reviewer.md": "efc0d2dee321c654",
-  "agents/gsd-codebase-mapper.md": "cfa2bbfaf264e1fd",
+  "agents/gsd-codebase-mapper.md": "afc125fe279e618f",
   "agents/gsd-debug-session-manager.md": "86d75b269a6c40e7",
   "agents/gsd-debugger.md": "7f9bd63ccb6e57c2",
   "agents/gsd-doc-classifier.md": "a6ab02b8f45f9d0b",
@@ -273,7 +273,7 @@
   "gsd-core/workflows/list-seeds.md": "39162bbefe932b3d",
   "gsd-core/workflows/list-workspaces.md": "6950fb740a1e96ab",
   "gsd-core/workflows/manager.md": "10e895f5b83168fc",
-  "gsd-core/workflows/map-codebase.md": "77daa184642dbfe6",
+  "gsd-core/workflows/map-codebase.md": "d4ee3730a4856da6",
   "gsd-core/workflows/milestone-summary.md": "1fdbae19ad06a0a3",
   "gsd-core/workflows/mvp-phase.md": "0b22d99b2f3aee0b",
   "gsd-core/workflows/new-milestone.md": "2c6fbe3ba116fff1",
diff --git a/tests/fixtures/golden-install-parity/zcode.json b/tests/fixtures/golden-install-parity/zcode.json
index dc09c534e..e016017bc 100644
--- a/tests/fixtures/golden-install-parity/zcode.json
+++ b/tests/fixtures/golden-install-parity/zcode.json
@@ -6,7 +6,7 @@
   "agents/gsd-assumptions-analyzer.md": "f11a80795163bb5d",
   "agents/gsd-code-fixer.md": "78549833f0411b0c",
   "agents/gsd-code-reviewer.md": "7d94fe8bfa6661aa",
-  "agents/gsd-codebase-mapper.md": "7cc9d387f29c46e1",
+  "agents/gsd-codebase-mapper.md": "3941bfc98c091018",
   "agents/gsd-debug-session-manager.md": "dc4e8a556dbf1708",
   "agents/gsd-debugger.md": "7840ed78e3f662a8",
   "agents/gsd-doc-classifier.md": "146acf4d176134b5",
@@ -344,7 +344,7 @@
   "gsd-core/workflows/list-seeds.md": "b687f2a843032d65",
   "gsd-core/workflows/list-workspaces.md": "7f94e18b5c549453",
   "gsd-core/workflows/manager.md": "c18fab593344253d",
-  "gsd-core/workflows/map-codebase.md": "cc4726da0ce6b138",
+  "gsd-core/workflows/map-codebase.md": "e59b600b28ebeed5",
   "gsd-core/workflows/milestone-summary.md": "e0cdfddbd39a9043",
   "gsd-core/workflows/mvp-phase.md": "58a952b4715db283",
   "gsd-core/workflows/new-milestone.md": "b0a1fd443cd87be9",
diff --git a/tests/workflow-size-baseline.json b/tests/workflow-size-baseline.json
index d603aafbb..e29e6b300 100644
--- a/tests/workflow-size-baseline.json
+++ b/tests/workflow-size-baseline.json
@@ -41,7 +41,7 @@
   "list-seeds.md": 6987,
   "list-workspaces.md": 5699,
   "manager.md": 27751,
-  "map-codebase.md": 21402,
+  "map-codebase.md": 21888,
   "milestone-summary.md": 11842,
   "mvp-phase.md": 13991,
   "new-milestone.md": 38667,