docs: restructure as canonical reference layer

Replace tutorial/guide content with reference documentation that ties
together the AIBTC ecosystem. Landing page (aibtc.com) handles getting
started; docs.aibtc.com is now the "phone book" for looking things up.

New structure:
- /directory/ — Services, tools, SDKs, templates, repositories
- /reference/tokens/ — Contract addresses, CAIP identifiers, decimals
- /reference/networks/ — Mainnet/testnet configs, API endpoints
- /glossary/ — Term definitions (unchanged)

Removed:
- /guides/what-is-x402/ — Landing page covers this better
- /guides/services/ — Replaced by /directory/
- /guides/tokens/ — Replaced by /reference/tokens/

Homepage redesigned as navigation hub with quick reference tables.

Closes #2

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

Author: whoabuddy

astro.config.mjs

@@ -26,9 +26,10 @@ export default defineConfig({
 				{ icon: 'x.com', label: 'X', href: 'https://x.com/aibtcdev' },
 			],
 			sidebar: [
+				{ label: 'Directory', slug: 'directory' },
 				{
-					label: 'Guides',
-					autogenerate: { directory: 'guides' },
+					label: 'Reference',
+					autogenerate: { directory: 'reference' },
 				},
 				{ label: 'Glossary', slug: 'glossary' },
 			],

src/content/docs/directory/index.md

@@ -0,0 +1,75 @@
+---
+title: Directory
+description: Find services, tools, SDKs, and repositories in the AIBTC ecosystem.
+sidebar:
+  order: 0
+---
+
+Everything in the AIBTC x402 ecosystem, organized by what you need.
+
+## Services
+
+Live endpoints and platforms you can use today.
+
+| Service | Description | Links |
+|---------|-------------|-------|
+| **x402 API** | Pay-per-use AI inference, blockchain data, hashing, storage | [Mainnet](https://x402.aibtc.com) · [Testnet](https://x402.aibtc.dev) · [Docs](https://x402.aibtc.com/docs) |
+| **Sponsor Relay** | Gasless transactions — sponsor covers network fees | [Mainnet](https://x402-relay.aibtc.com) · [Testnet](https://x402-relay.aibtc.dev) · [Docs](https://x402-relay.aibtc.com/docs) |
+| **STX402** | x402 endpoint registry and ecosystem directory | [Live](https://stx402.com) · [Docs](https://stx402.com/docs) |
+| **x402 Biwas** | AI-powered DeFi analytics for Stacks | [Live](https://x402.biwas.xyz) |
+| **StacksScan** | x402 ecosystem explorer and stats | [Live](https://scan.stacksx402.com) |
+| **Facilitator** | Payment verification and settlement | [Live](https://facilitator.stacksx402.com) |
+
+## Tools & SDKs
+
+Libraries and tools for building with x402.
+
+| Tool | Description | Links |
+|------|-------------|-------|
+| **@aibtc/mcp-server** | MCP server for Claude Code — blockchain tools for AI agents | [npm](https://www.npmjs.com/package/@aibtc/mcp-server) · [GitHub](https://github.com/aibtcdev/aibtc-mcp-server) |
+| **x402-stacks** | TypeScript SDK for x402 payments on Stacks | [npm](https://www.npmjs.com/package/x402-stacks) · [GitHub](https://github.com/tony1908/x402-stacks-sdk) |
+| **Stacks.js** | Official Stacks JavaScript libraries | [Docs](https://stacks.js.org) · [GitHub](https://github.com/hirosystems/stacks.js) |
+
+## Templates & Examples
+
+Starting points for building x402 services.
+
+| Template | Description | Links |
+|----------|-------------|-------|
+| **x402-api** | Cloudflare Workers template for paid API endpoints | [GitHub](https://github.com/aibtcdev/x402-api) |
+| **x402-crosschain-example** | Express/Hono example with EVM + Stacks | [GitHub](https://github.com/aibtcdev/x402-crosschain-example) |
+| **x402-sponsor-relay** | Sponsored transaction relay implementation | [GitHub](https://github.com/aibtcdev/x402-sponsor-relay) |
+
+## Repositories
+
+All AIBTC open source projects.
+
+| Repo | Description |
+|------|-------------|
+| [**aibtcdev/aibtc-mcp-server**](https://github.com/aibtcdev/aibtc-mcp-server) | MCP server for Claude Code |
+| [**aibtcdev/x402-api**](https://github.com/aibtcdev/x402-api) | x402 API service and template |
+| [**aibtcdev/x402-sponsor-relay**](https://github.com/aibtcdev/x402-sponsor-relay) | Gasless transaction relay |
+| [**aibtcdev/x402-crosschain-example**](https://github.com/aibtcdev/x402-crosschain-example) | Crosschain x402 example |
+| [**aibtcdev/docs**](https://github.com/aibtcdev/docs) | This documentation site |
+| [**aibtcdev/branding**](https://github.com/aibtcdev/branding) | Brand assets and guidelines |
+| [**aibtcdev/landing-page**](https://github.com/aibtcdev/landing-page) | aibtc.com website |
+
+**See all:** [github.com/aibtcdev](https://github.com/aibtcdev)
+
+## External Resources
+
+Key resources outside the AIBTC ecosystem.
+
+| Resource | Description | Link |
+|----------|-------------|------|
+| **x402 Protocol** | HTTP 402 payment protocol specification | [x402.org](https://x402.org) |
+| **Stacks Docs** | Official Stacks blockchain documentation | [docs.stacks.co](https://docs.stacks.co) |
+| **Hiro Platform** | Stacks API keys and developer tools | [platform.hiro.so](https://platform.hiro.so) |
+| **Claude Code** | AI coding assistant from Anthropic | [claude.ai/code](https://claude.ai/code) |
+| **sBTC** | Bitcoin on Stacks | [stacks.co/sbtc](https://www.stacks.co/sbtc) |
+
+## See Also
+
+- [Token Reference](/reference/tokens/) — Contract addresses and identifiers
+- [Network Reference](/reference/networks/) — Endpoints and configurations
+- [Glossary](/glossary/) — Term definitions

src/content/docs/guides/services.md

@@ -1,44 +1,72 @@
 ---
-title: AIBTC Documentation
-description: Documentation for the AIBTC ecosystem - pay-per-use APIs for AI agents.
+title: AIBTC Docs
+description: Reference documentation for the AIBTC x402 ecosystem.
 template: splash
 hero:
-  tagline: Pay-per-use APIs for AI agents, powered by Bitcoin.
+  tagline: Reference docs for the x402 ecosystem on Stacks.
   actions:
-    - text: Get Started
-      link: /guides/what-is-x402/
+    - text: Directory
+      link: /directory/
       icon: right-arrow
-    - text: GitHub
-      link: https://github.com/aibtcdev
+    - text: Start Building
+      link: https://aibtc.com
       icon: external
       variant: minimal
 ---
 
 import { Card, CardGrid, LinkCard } from '@astrojs/starlight/components';
 
-AIBTC builds tools that let AI agents pay for the APIs they use, one request at a time. No subscriptions, no API keys, no invoices — just blockchain-verified micropayments.
+## Find What You Need
 
-## What's in the ecosystem
+<CardGrid>
+	<LinkCard title="Directory" href="/directory/" description="Services, tools, SDKs, templates, and repositories." />
+	<LinkCard title="Token Reference" href="/reference/tokens/" description="Contract addresses, CAIP identifiers, where to get tokens." />
+	<LinkCard title="Network Reference" href="/reference/networks/" description="Mainnet/testnet configs, API endpoints, service URLs." />
+	<LinkCard title="Glossary" href="/glossary/" description="Term definitions and concepts." />
+</CardGrid>
+
+## Quick Reference
+
+### Payment Tokens
+
+| Token | Mainnet Contract | Testnet Contract |
+|-------|------------------|------------------|
+| **STX** | Native | Native |
+| **sBTC** | `SM3VDXK3WZZSA84...sbtc-token` | `ST1F7QA2MDF17S8...sbtc-token` |
+| **USDCx** | `SP120SBRBQJ00MC...usdcx` | — |
+
+[Full token reference →](/reference/tokens/)
+
+### Service Endpoints
+
+| Service | Mainnet | Testnet |
+|---------|---------|---------|
+| **x402 API** | [x402.aibtc.com](https://x402.aibtc.com) | [x402.aibtc.dev](https://x402.aibtc.dev) |
+| **Sponsor Relay** | [x402-relay.aibtc.com](https://x402-relay.aibtc.com) | [x402-relay.aibtc.dev](https://x402-relay.aibtc.dev) |
+| **Facilitator** | [facilitator.stacksx402.com](https://facilitator.stacksx402.com) | — |
+
+[Full network reference →](/reference/networks/)
+
+## Getting Started
+
+New to AIBTC? Start at [aibtc.com](https://aibtc.com) for the interactive tutorial.
 
 <CardGrid>
-	<Card title="x402 API" icon="rocket">
-		Pay-per-use endpoints for AI inference, blockchain data, hashing, and storage. Agents pay with STX, sBTC, or USDCx per request.
-	</Card>
-	<Card title="Sponsor Relay" icon="forward-slash">
-		Gasless transactions for AI agents. A sponsor covers network fees so agents can operate without holding STX for gas.
+	<Card title="Install Claude Code" icon="laptop">
+		```bash
+		curl -fsSL https://claude.ai/code/install.sh | sh
+		```
 	</Card>
-	<Card title="StacksScan Explorer" icon="list-format">
-		Ecosystem explorer for x402 activity, service stats, and network health across the AIBTC infrastructure.
-	</Card>
-	<Card title="Supported Tokens" icon="random">
-		Pay with STX, sBTC, or USDCx. Each token fits a different use case — from general purpose to dollar-stable pricing.
+	<Card title="Add Stacks Tools" icon="puzzle">
+		```bash
+		npm install -g @aibtc/mcp-server
+		```
 	</Card>
 </CardGrid>
 
-## Quick Links
+## Community
 
-<CardGrid>
-	<LinkCard title="What is x402?" href="/guides/what-is-x402/" description="Learn how agents pay for APIs with blockchain micropayments." />
-	<LinkCard title="Services & Tools" href="/guides/services/" description="Explore the APIs, relays, and dashboards in the ecosystem." />
-	<LinkCard title="Supported Tokens" href="/guides/tokens/" description="Compare STX, sBTC, and USDCx and find out where to get them." />
-</CardGrid>
+- [Weekly Working Group Calls](https://www.addevent.com/event/UM20108233)
+- [AIBTC Discord](https://discord.gg/5DJaBrf)
+- [GitHub](https://github.com/aibtcdev)
+- [X / Twitter](https://x.com/aibtcdev)

src/content/docs/guides/tokens.md

@@ -0,0 +1,19 @@
+---
+title: Reference
+description: Canonical reference for the AIBTC x402 ecosystem.
+sidebar:
+  order: 0
+---
+
+Technical reference for tokens, networks, and configurations used across the AIBTC ecosystem.
+
+## Quick Links
+
+- [**Token Reference**](/reference/tokens/) — Contract addresses, CAIP identifiers, where to get tokens
+- [**Network Reference**](/reference/networks/) — Mainnet/testnet configs, API endpoints, service URLs
+
+## Looking for Something Else?
+
+- [**Directory**](/directory/) — Find services, tools, SDKs, and repos
+- [**Glossary**](/glossary/) — Term definitions and concepts
+- [**aibtc.com**](https://aibtc.com) — Getting started tutorial