Merge d94b9df0e3 into d19cca79d2

docs/explanation/faq/index.md

@@ -1,16 +0,0 @@
----
-title: "Frequently Asked Questions"
-description: Frequently asked questions about the BMad Method
----
-
-Quick answers to common questions about the BMad Method, organized by topic.
-
-## Topics
-
-- [Getting Started](/docs/explanation/faq/getting-started-faq.md) - Questions about starting with BMad
-- [Levels & Tracks](/docs/explanation/faq/levels-and-tracks-faq.md) - Choosing the right level
-- [Workflows](/docs/explanation/faq/workflows-faq.md) - Workflow and phase questions
-- [Planning](/docs/explanation/faq/planning-faq.md) - Planning document questions
-- [Implementation](/docs/explanation/faq/implementation-faq.md) - Implementation questions
-- [Brownfield](/docs/explanation/faq/brownfield-faq.md) - Existing codebase questions
-- [Tools & Advanced](/docs/explanation/faq/tools-faq.md) - Tools, IDEs, and advanced topics

tools/validate-doc-links.js

@@ -102,17 +102,11 @@ function extractAnchors(content) {
 
 /**
  * Resolve a site-relative link to a file path
- * /docs/how-to/installation/install-bmad.md -> docs/how-to/installation/install-bmad.md
  * /how-to/installation/install-bmad/ -> docs/how-to/installation/install-bmad.md or .../index.md
  */
 function resolveLink(siteRelativePath) {
   // Strip anchor and query
-  let checkPath = siteRelativePath.split('#')[0].split('?')[0];
-
-  // Strip /docs/ prefix if present (repo-relative links)
-  if (checkPath.startsWith('/docs/')) {
-    checkPath = checkPath.slice(5); // Remove '/docs' but keep leading '/'
-  }
+  const checkPath = siteRelativePath.split('#')[0].split('?')[0];
 
   if (checkPath.endsWith('/')) {
     // Could be file.md or directory/index.md
@@ -124,11 +118,11 @@ function resolveLink(siteRelativePath) {
     return null;
   }
 
-  // Direct path (e.g., /path/file.md)
+  // Direct path
   const direct = path.join(DOCS_ROOT, checkPath);
   if (fs.existsSync(direct)) return direct;
 
-  // Try with .md extension
+  // Try with .md
   const withMd = direct + '.md';
   if (fs.existsSync(withMd)) return withMd;