fix: Resolve Docusaurus broken links and add architecture docs

- Fix MDX compilation error in quickstart (escape < symbols)
- Fix broken links in multi-model-consensus, fleets, fleet-spec, multi-model-rca
- Update docusaurus.config.ts to include architecture/multi-model-consensus.md
- Add multi-model-rca-quickstart to tutorials sidebar
- Remove references to non-existent consensus-algorithms.md and code-review-fleet.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: gouravjshah

docs/architecture/multi-model-consensus.md

@@ -501,4 +501,3 @@ sum(rate(model_response_total[1h])) by (model)
 - [Fleet Concepts](../concepts/fleets.md) - Overview of fleet coordination
 - [Multi-Model RCA Tutorial](../tutorials/multi-model-rca.md) - Step-by-step guide
 - [Fleet YAML Reference](../reference/fleet-spec.md) - Complete specification
-- [Consensus Algorithms](../reference/consensus-algorithms.md) - Algorithm details

docs/concepts/fleets.md

@@ -742,4 +742,4 @@ agents:
 **Next Steps**:
 - [Fleet Examples](../examples/index.md#agentfleet-examples)
 - [AgentFleet YAML Reference](../reference/fleet-spec.md)
-- [Tutorials: Build a Code Review Fleet](../tutorials/code-review-fleet.md)
+- [Multi-Model RCA Quickstart](../tutorials/multi-model-rca-quickstart.md)

docs/reference/fleet-spec.md

@@ -454,4 +454,4 @@ aofctl validate fleet my-fleet.yaml
 
 - [Fleet Concepts](../concepts/fleets.md) - Understanding fleet coordination
 - [Agent Specification](./agent-spec.md) - Agent YAML reference
-- [Tutorials](../tutorials/index.md) - Step-by-step guides
+- [Multi-Model RCA Tutorial](../tutorials/multi-model-rca.md) - Step-by-step guide

docs/tutorials/multi-model-rca-quickstart.md

@@ -229,9 +229,9 @@ aofctl run fleet examples/fleets/real/multi-model-rca-real.yaml \
 
 ### Confidence Scoring
 
-- **HIGH** (>0.8): All models agree strongly
-- **MEDIUM** (0.5-0.8): Majority agrees, some uncertainty
-- **LOW** (<0.5): Models disagree, needs human review
+- **HIGH** (`>0.8`): All models agree strongly
+- **MEDIUM** (`0.5-0.8`): Majority agrees, some uncertainty
+- **LOW** (`<0.5`): Models disagree, needs human review
 
 ### Cost Breakdown
 

docs/tutorials/multi-model-rca.md

@@ -888,7 +888,7 @@ You've built a production-grade multi-model RCA system that:
 
 - **[Fleet Concepts](../concepts/fleets.md)** - Deep dive into fleet coordination modes
 - **[Fleet YAML Reference](../reference/fleet-spec.md)** - Complete specification
-- **[Example Agents](../../examples/agents/README.md)** - Pre-built agent catalog
+- **[Multi-Model RCA Quickstart](./multi-model-rca-quickstart.md)** - 5-minute test guide
 
 ---
 

docusaurus-site/docusaurus.config.ts

@@ -48,7 +48,18 @@ const config: Config = {
             'LLM_*.md',
             'RUVECTOR_*.md',
             'DOCUMENTATION_INDEX.md',
-            'architecture/**',
+            // Keep architecture/multi-model-consensus.md but exclude technical arch docs
+            'architecture/README.md',
+            'architecture/ADR-*.md',
+            'architecture/*-crd.yaml',
+            'architecture/*.yaml',
+            'architecture/architecture-summary.md',
+            'architecture/command-structure-diagram.md',
+            'architecture/implementation-guide.md',
+            'architecture/memory-rag-system.md',
+            'architecture/resource-type-specifications.md',
+            'architecture/rust-implementation.md',
+            'architecture/usage-examples.md',
             'schemas/**',
             'agentflow/**',
             'internal/**',

docusaurus-site/sidebars.ts

@@ -75,6 +75,7 @@ const sidebars: SidebarsConfig = {
         'tutorials/slack-bot',
         'tutorials/incident-response',
         'tutorials/rca-fleet',
+        'tutorials/multi-model-rca-quickstart',
         'tutorials/multi-model-rca',
       ],
     },