fix: replace path-style links with relative markdown links (EN+VI+ZH) (#52)

Author: thieung

advanced/context-pruning.md

@@ -11,7 +11,7 @@ As agents run long tasks, tool results accumulate in the conversation history. L
 1. **Soft trim** — truncate oversized tool results to head + tail, dropping the middle.
 2. **Hard clear** — if the context is still too full, replace entire tool results with a short placeholder.
 
-Context pruning is distinct from [session compaction](/sessions-and-history). Compaction permanently summarizes and truncates conversation history. Pruning is non-destructive: the original tool results remain in the session store and are never modified — only the message slice sent to the LLM is trimmed.
+Context pruning is distinct from [session compaction](../core-concepts/sessions-and-history.md). Compaction permanently summarizes and truncates conversation history. Pruning is non-destructive: the original tool results remain in the session store and are never modified — only the message slice sent to the LLM is trimmed.
 
 ---
 
@@ -226,7 +226,7 @@ Increase `softTrim.headChars` and `softTrim.tailChars`, or raise `softTrim.maxCh
 
 **Context still overflows despite pruning**
 
-Pruning only acts on tool results. If long user messages or system prompt components dominate the context, pruning will not help. Consider [session compaction](/sessions-and-history) or reduce the system prompt size.
+Pruning only acts on tool results. If long user messages or system prompt components dominate the context, pruning will not help. Consider [session compaction](../core-concepts/sessions-and-history.md) or reduce the system prompt size.
 
 ---
 
@@ -244,8 +244,8 @@ Tool output is now capped at the source before being added to context. Rather th
 
 ## What's Next
 
-- [Sessions & History](/sessions-and-history) — session compaction, history limits
-- [Memory System](/memory-system) — 3-tier memory architecture and consolidation pipeline
+- [Sessions & History](../core-concepts/sessions-and-history.md) — session compaction, history limits
+- [Memory System](../core-concepts/memory-system.md) — 3-tier memory architecture and consolidation pipeline
 - [Configuration Reference](/config-reference) — full agent config reference
 
 <!-- goclaw-source: 050aafc9 | updated: 2026-04-09 -->

advanced/knowledge-graph.md

@@ -395,7 +395,7 @@ When an agent uses `vault_search`, the VaultSearchService fans out to **both** t
 ## What's Next
 
 - [Knowledge Vault](knowledge-vault.md) — Document-level knowledge store with wikilinks and semantic search
-- [Memory System](/memory-system) — Vector-based long-term memory
-- [Sessions & History](/sessions-and-history) — Conversation storage
+- [Memory System](../core-concepts/memory-system.md) — Vector-based long-term memory
+- [Sessions & History](../core-concepts/sessions-and-history.md) — Conversation storage
 
 <!-- goclaw-source: 1296cdbf | updated: 2026-04-11 -->

advanced/knowledge-vault.md

@@ -318,7 +318,7 @@ No feature flag. Vault is active if the migration ran and VaultStore initialized
 ## What's Next
 
 - [Knowledge Graph](knowledge-graph.md) — Entity and relation graph auto-extracted from conversations
-- [Memory System](/memory-system) — Vector-based long-term memory
-- [Context Files](/context-files) — Static documents injected into agent context
+- [Memory System](../core-concepts/memory-system.md) — Vector-based long-term memory
+- [Context Files](../agents/context-files.md) — Static documents injected into agent context
 
 <!-- goclaw-source: 1296cdbf | updated: 2026-04-11 -->

agents/creating-agents.md

@@ -207,7 +207,7 @@ These files are placed in the stable portion of the system prompt (above the cac
 ## What's Next
 
 - [Open vs. Predefined](/open-vs-predefined) — understand context isolation differences
-- [Context Files](/context-files) — learn about SOUL.md, IDENTITY.md, and other system files
+- [Context Files](../agents/context-files.md) — learn about SOUL.md, IDENTITY.md, and other system files
 - [Summoning & Bootstrap](/summoning-bootstrap) — how LLM generates personality files on first use
 
 <!-- goclaw-source: 050aafc9 | updated: 2026-04-09 -->

agents/editing-personality.md

@@ -9,7 +9,7 @@ Your agent's personality emerges from two primary configuration files:
 - **SOUL.md**: Defines tone, values, boundaries, expertise, and operational style. This is the "who you are" file.
 - **IDENTITY.md**: Contains metadata like name, emoji, creature type, and avatar. This is the "what you look like" file.
 
-**AGENTS.md** also contributes to the overall persona — it defines conversational rules, memory usage, and group chat behavior. While less about "personality," it shapes how the agent expresses itself in practice. See [Context Files](/context-files) for details.
+**AGENTS.md** also contributes to the overall persona — it defines conversational rules, memory usage, and group chat behavior. While less about "personality," it shapes how the agent expresses itself in practice. See [Context Files](../agents/context-files.md) for details.
 
 You can edit these files three ways: via the Dashboard UI, the WebSocket API, or directly on disk. Edits made through the UI or API are stored in the database.
 
@@ -260,7 +260,7 @@ This is governed by the `buildSelfEvolveSection()` in `internal/agent/systemprom
 
 ## What's Next
 
-- [Context Files — Extending personality with per-user context](/context-files)
+- [Context Files — Extending personality with per-user context](../agents/context-files.md)
 - [System Prompt Anatomy — How personality gets injected into prompts](/system-prompt-anatomy)
 - [Creating Agents — Set up personality during agent creation](/creating-agents)
 

agents/open-vs-predefined.md

@@ -179,7 +179,7 @@ Or switch to **predefined** later if the agent outgrows single-user use.
 
 ## What's Next
 
-- [Context Files](/context-files) — deep dive into each file (SOUL.md, IDENTITY.md, etc.)
+- [Context Files](../agents/context-files.md) — deep dive into each file (SOUL.md, IDENTITY.md, etc.)
 - [Summoning & Bootstrap](/summoning-bootstrap) — how personality is generated for predefined agents
 - [Creating Agents](/creating-agents) — agent creation walkthrough
 

agents/summoning-bootstrap.md

@@ -367,7 +367,7 @@ If you manually set USER.md at agent level before the first user chats, it's use
 
 ## What's Next
 
-- [Context Files](/context-files) — detailed reference for each file
+- [Context Files](../agents/context-files.md) — detailed reference for each file
 - [Open vs. Predefined](/open-vs-predefined) — understand when to use each type
 - [Creating Agents](/creating-agents) — step-by-step agent creation
 

agents/system-prompt-anatomy.md

@@ -414,7 +414,7 @@ This agent will:
 ## What's Next
 
 - [Editing Personality — Customize SOUL.md and IDENTITY.md](/editing-personality)
-- [Context Files — Add project-specific context](/context-files)
+- [Context Files — Add project-specific context](../agents/context-files.md)
 - [Creating Agents — Set up system prompt configuration](/creating-agents)
 
 <!-- goclaw-source: 050aafc9 | updated: 2026-04-09 -->

channels/INDEX.md

@@ -205,6 +205,6 @@ grep -i discord ~/.goclaw/logs/gateway.log
 
 ## What's Next
 
-- **[Development Rules](../../development-rules.md)** — Code style for channels
-- **[System Architecture](../../00-architecture-overview.md)** — How channels fit in
-- **[Gateway Protocol](../../04-gateway-protocol.md)** — WebSocket protocol details
+- **[Development Rules](../../core-concepts/how-goclaw-works.md)** — Code style for channels
+- **[System Architecture](../../core-concepts/how-goclaw-works.md)** — How channels fit in
+- **[Gateway Protocol](../../reference/websocket-protocol.md)** — WebSocket protocol details

channels/telegram.md

@@ -316,6 +316,6 @@ No configuration needed. Check logs for `telegram: migrating group chat` entries
 - [Overview](/channels-overview) — Channel concepts and policies
 - [Discord](/channel-discord) — Discord bot setup
 - [Browser Pairing](/channel-browser-pairing) — Pairing flow
-- [Sessions & History](/sessions-and-history) — Conversation history
+- [Sessions & History](../core-concepts/sessions-and-history.md) — Conversation history
 
 <!-- goclaw-source: 050aafc9 | updated: 2026-04-09 -->