diff --git a/docs/explanation/core/index.md b/docs/explanation/core/index.md
index de7687dc..9c604a48 100644
--- a/docs/explanation/core/index.md
+++ b/docs/explanation/core/index.md
@@ -14,5 +14,5 @@ The Core Module is installed with all installations of BMad modules and provides
   - [Advanced Elicitation](/docs/explanation/features/advanced-elicitation.md) — LLM rethinking with 50+ reasoning methods
 - **[Core Tasks](/docs/reference/configuration/core-tasks.md)** — Common tasks available across modules
   - [Index Docs](/docs/reference/configuration/core-tasks.md#index-docs) — Generate directory index files
-  - [Adversarial Review](/docs/reference/configuration/core-tasks.md#adversarial-review-general) — Critical content review
+  - [Adversarial Review](/docs/reference/configuration/core-tasks.md#adversarial-review) — Critical content review
   - [Shard Document](/docs/reference/configuration/core-tasks.md#shard-document) — Split large documents into sections
diff --git a/docs/explanation/faq/getting-started-faq.md b/docs/explanation/faq/getting-started-faq.md
index 424e1013..78b7c88e 100644
--- a/docs/explanation/faq/getting-started-faq.md
+++ b/docs/explanation/faq/getting-started-faq.md
@@ -7,12 +7,17 @@ Quick answers to common questions about getting started with the BMad Method.
 
 ## Questions
 
+- [Why does BMad use so many tokens?](#why-does-bmad-use-so-many-tokens)
 - [Do I always need to run workflow-init?](#do-i-always-need-to-run-workflow-init)
 - [Why do I need fresh chats for each workflow?](#why-do-i-need-fresh-chats-for-each-workflow)
 - [Can I skip workflow-status and just start working?](#can-i-skip-workflow-status-and-just-start-working)
 - [What's the minimum I need to get started?](#whats-the-minimum-i-need-to-get-started)
 - [How do I know if I'm in Phase 1, 2, 3, or 4?](#how-do-i-know-if-im-in-phase-1-2-3-or-4)
 
+### Why does BMad use so many tokens?
+
+BMad is not always the most token efficient approach, and that's by design. The checkpoints, story files, and retrospectives keep you in the loop so you can apply taste, judgment, and accumulated context that no agent has. Fully automated coding loops optimize for code velocity; BMad optimizes for decision quality. If you're building something you'll maintain for years, where user experience matters, where architectural choices compound—that tradeoff pays for itself.
+
 ### Do I always need to run workflow-init?
 
 No, once you learn the flow you can go directly to workflows. However, workflow-init is helpful because it:
diff --git a/docs/how-to/customization/index.md b/docs/how-to/customization/index.md
index 9434524e..a792104c 100644
--- a/docs/how-to/customization/index.md
+++ b/docs/how-to/customization/index.md
@@ -9,7 +9,6 @@ Personalize agents and workflows to match your needs.
 | Guide | Description |
 |-------|-------------|
 | **[Agent Customization](/docs/how-to/customization/customize-agents.md)** | Modify agent behavior without editing core files |
-| **[Workflow Customization](/docs/how-to/customization/customize-workflows.md)** | Customize and optimize workflows |
 
 ## Overview