diff --git a/README.md b/README.md
index 691a6a3..215959e 100644
--- a/README.md
+++ b/README.md
@@ -9,8 +9,8 @@
 
 <p align="center">
   <a href="https://casterlygit.github.io/trident/">Live demo</a> ·
-  <a href="./ARCHITECTURE.md">Architecture</a> ·
-  <a href="./DESIGN.md">Design spec</a>
+  <a href="./ARCHITECTURE.md">Architecture and verified mechanics</a> ·
+  <a href="./DESIGN.md">Design and acceptance gates</a>
 </p>
 
 <p align="center">
diff --git a/docs/index.html b/docs/index.html
index 32c6a17..51fb7fb 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -20,6 +20,9 @@
     background:linear-gradient(180deg,#fff,var(--cyan));-webkit-background-clip:text;
     background-clip:text;-webkit-text-fill-color:transparent}
   .tag{color:var(--dim);margin-top:8px;font-size:15px;letter-spacing:.5px}
+  .nav{display:flex;gap:14px;justify-content:center;flex-wrap:wrap;margin-top:16px}
+  .nav a{color:var(--cyan);font-size:12px;text-decoration:none}
+  .nav a:hover{text-decoration:underline}
   .badges{display:flex;gap:8px;justify-content:center;margin-top:18px;flex-wrap:wrap}
   .badge{font-size:11px;padding:5px 11px;border:1px solid var(--line);border-radius:999px;
     color:var(--dim);background:var(--panel)}
@@ -82,6 +85,11 @@
   <header>
     <h1>🔱 trident</h1>
     <div class="tag">a token-burn governor for AI coding agents · MINT prices it · SHAPER shapes it · LEDGER settles it</div>
+    <nav class="nav" aria-label="Project documentation">
+      <a href="https://github.com/CasterlyGit/trident">README</a>
+      <a href="https://github.com/CasterlyGit/trident/blob/master/ARCHITECTURE.md">Architecture and verified mechanics</a>
+      <a href="https://github.com/CasterlyGit/trident/blob/master/DESIGN.md">Design and acceptance gates</a>
+    </nav>
     <div class="badges">
       <span class="badge">status <b>all 4 waves live</b></span>
       <span class="badge">tests <b>34/34</b></span>