# Internal Linking Map and Policy

## Hub -> Cluster
- `/kb/` -> `/kb/categories/`, `/kb/concepts/`, `/kb/guides/`, `/kb/comparisons/`, `/kb/case-studies/`

## Required Cross-Link Rules
- Concept pages must link to:
  - at least one comparison page
  - at least one case study page
- Comparison pages must link to:
  - at least one prerequisite concept page
  - at least one applied case study page
- Case study pages must link to:
  - at least one enabling concept page
  - at least one supporting comparison page
- Guide pages must link to:
  - at least one concept page
  - at least one comparison or case study page

## Priority Link Paths (Current Core)
- `/kb/concepts/heartbeat/` -> `/kb/comparisons/swarm-vs-single-agent/` -> `/kb/case-studies/engineering-code-review-swarm/`
- `/kb/concepts/mcp/` -> `/kb/comparisons/mcp-vs-direct-api-integration/` -> `/kb/case-studies/ops-incident-response-swarm/`
- `/kb/concepts/ai-platforms-and-tools/` -> `/kb/comparisons/mcp-vs-direct-api-integration/` -> `/kb/case-studies/engineering-code-review-swarm/`
- `/kb/categories/` -> `/kb/concepts/llms-in-agentic-systems/` -> `/kb/comparisons/choosing-llm-tiers-and-families/`
- `/kb/concepts/llms-in-agentic-systems/` -> `/kb/comparisons/choosing-llm-tiers-and-families/` -> `/kb/case-studies/research-multi-source-synthesis-swarm/`
- `/kb/concepts/workflow-automation-and-agent-swarms/` -> `/kb/comparisons/planner-driven-vs-event-driven-orchestration/` -> `/kb/case-studies/ops-incident-response-swarm/`
- `/kb/guides/design-your-first-swarm/` -> `/kb/comparisons/swarm-vs-single-agent/` -> `/kb/case-studies/support-triage-swarm/`
- `/kb/guides/scope-agent-permissions/` -> `/kb/concepts/mcp/` -> `/kb/comparisons/mcp-vs-direct-api-integration/`

## Conversion Links
- High-intent pages should include links to:
  - `/early-access/`
  - `mailto:support@chandlercoven.com`