fix: add brownfield workflow page rendering and SPA routing

- Add brownfield-workflow.adoc to render-docs.js prebuild step
- Register /brownfield route in main.js and router.js
- Fix AsciiDoc cross-links to use SPA hash routes (#/brownfield,
  #/workflow) instead of .adoc file references

Without this, the brownfield page returns 404 on the deployed site.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: raifdmueller

docs/brownfield-workflow.adoc

@@ -6,7 +6,7 @@ Ralf D. Müller
 
 == Introduction
 
-You have mastered the link:spec-driven-workflow.adoc[greenfield workflow].
+You have mastered the link:#/workflow[greenfield workflow].
 Now you want to apply it to an existing codebase.
 
 The core principles remain the same: small steps, high autonomy, error correction loops.
@@ -152,7 +152,7 @@ Stable code that nobody touches does not need specs.
 |link:#/anchor/tdd-london-school[TDD London] / link:#/anchor/tdd-chicago-school[Chicago]
 
 |Continue
-|Follow link:spec-driven-workflow.adoc[the standard workflow] from Step 3 (PRD) or Step 8 (Implementation), depending on whether you are adding new features or fixing bugs.
+|Follow link:#/workflow[the standard workflow] from Step 3 (PRD) or Step 8 (Implementation), depending on whether you are adding new features or fixing bugs.
 |{empty}--
 |===
 

docs/spec-driven-workflow.adoc

@@ -31,7 +31,7 @@ Click on any anchor to see its full definition on the Semantic Anchors website.
 [IMPORTANT]
 ====
 This workflow is designed for greenfield projects built from scratch with AI assistance.
-For existing codebases, see link:brownfield-workflow.adoc[Adapting the Workflow to Brownfield Projects].
+For existing codebases, see link:#/brownfield[Adapting the Workflow to Brownfield Projects].
 ====
 
 == The Key Principle: Small Steps, High Autonomy
@@ -434,7 +434,7 @@ Consider assigning different AI models to different review roles.
 Run ATAM reviews after each major architectural change, not just once.
 Groom the backlog more frequently as the project grows.
 *Legacy codebases*:: This workflow assumes you start from scratch.
-See link:brownfield-workflow.adoc[Adapting the Workflow to Brownfield Projects] for a dedicated guide covering reverse engineering, baseline test coverage, and incremental migration using bounded contexts.
+See link:#/brownfield[Adapting the Workflow to Brownfield Projects] for a dedicated guide covering reverse engineering, baseline test coverage, and incremental migration using bounded contexts.
 *Frontend / HTML applications*:: This workflow works well for backend code, CLIs, and libraries where the compiler and TDD provide strong error correction.
 Frontend applications can be built with the same approach, but consistent UI is harder to verify automatically.
 The error correction layers that make backend development reliable (compiler errors, test failures) have no direct equivalent for visual consistency.
@@ -532,7 +532,7 @@ Start with the Socratic Method for requirements and see where it leads.
 If you discover anchors that work well in your workflow, https://github.com/LLM-Coding/Semantic-Anchors/blob/main/CONTRIBUTING.md[contribute them to the collection].
 
 Once you are comfortable with this greenfield workflow, you can adapt it to existing codebases.
-See link:brownfield-workflow.adoc[Adapting the Workflow to Brownfield Projects] for a step-by-step guide.
+See link:#/brownfield[Adapting the Workflow to Brownfield Projects] for a step-by-step guide.
 
 === Further Reading
 

scripts/render-docs.js

@@ -84,6 +84,11 @@ renderFile(
   path.join(WEB_DOCS, 'spec-driven-workflow.html')
 )
 
+renderFile(
+  path.join(ROOT, 'docs/brownfield-workflow.adoc'),
+  path.join(WEB_DOCS, 'brownfield-workflow.html')
+)
+
 renderFile(
   path.join(ROOT, 'docs/anchor-evaluations.adoc'),
   path.join(WEB_DOCS, 'anchor-evaluations.html')

website/src/main.js

@@ -110,6 +110,7 @@ function initApp() {
   addRoute('/rejected-proposals', renderRejectedProposalsPage)
   addRoute('/all-anchors', renderAllAnchorsPage)
   addRoute('/workflow', renderWorkflowPage)
+  addRoute('/brownfield', renderBrownfieldPage)
   addRoute('/contracts', renderContractsPageHandler)
   addRoute('/evaluations', renderEvaluationsPage)
 
@@ -233,6 +234,15 @@ function renderWorkflowPage() {
   loadDocContent('docs/spec-driven-workflow.adoc')
 }
 
+function renderBrownfieldPage() {
+  const pageContent = document.getElementById('page-content')
+  if (!pageContent) return
+
+  pageContent.innerHTML = renderDocPage()
+  updateActiveNavLink()
+  loadDocContent('docs/brownfield-workflow.adoc')
+}
+
 function renderContractsPageHandler() {
   const pageContent = document.getElementById('page-content')
   if (!pageContent) return
@@ -458,6 +468,8 @@ function handleLanguageChange() {
     loadDocContent('docs/all-anchors.adoc')
   } else if (currentRoute === '/workflow') {
     loadDocContent('docs/spec-driven-workflow.adoc')
+  } else if (currentRoute === '/brownfield') {
+    loadDocContent('docs/brownfield-workflow.adoc')
   } else if (currentRoute === '/') {
     initCardGridVisualization()
   }

website/src/utils/router.js

@@ -17,6 +17,7 @@ const ROUTE_TITLES = {
   '/about': 'About — Semantic Anchors',
   '/contracts': 'Semantic Contracts — Semantic Anchors',
   '/workflow': 'Development Workflow — Semantic Anchors',
+  '/brownfield': 'Brownfield Workflow — Semantic Anchors',
   '/evaluations': 'Evaluations — Semantic Anchors',
   '/contributing': 'Contributing — Semantic Anchors',
   '/changelog': 'Changelog — Semantic Anchors',