docs(kilo-docs): scaffold Wasteland docs section + register in nav

packages/kilo-docs/lib/nav/code-with-ai.ts

@@ -34,6 +34,13 @@ export const CodeWithAiNav: NavSection[] = [
           { href: "/code-with-ai/gastown/code-review", children: "Code Review" },
           { href: "/code-with-ai/gastown/settings", children: "Settings" },
           { href: "/code-with-ai/gastown/troubleshooting", children: "Troubleshooting" },
+          { href: "/code-with-ai/gastown/wasteland", children: "Wasteland" },
+          { href: "/code-with-ai/gastown/wasteland/quick-start", children: "Wasteland: Quick Start" },
+          { href: "/code-with-ai/gastown/wasteland/concepts", children: "Wasteland: Concepts" },
+          { href: "/code-with-ai/gastown/wasteland/workflow", children: "Wasteland: Workflow" },
+          { href: "/code-with-ai/gastown/wasteland/admin", children: "Wasteland: Administration" },
+          { href: "/code-with-ai/gastown/wasteland/settings", children: "Wasteland: Settings" },
+          { href: "/code-with-ai/gastown/wasteland/troubleshooting", children: "Wasteland: Troubleshooting" },
         ],
       },
     ],

packages/kilo-docs/pages/code-with-ai/gastown/wasteland/admin.md

@@ -0,0 +1,17 @@
+---
+title: "Wasteland Administration"
+description: "Running a Wasteland: posting wanted items, reviewing submissions, stamping, merging, and managing members"
+---
+
+# {% $markdoc.frontmatter.title %}
+
+Administrator and validator guide for running a Wasteland instance — posting work, reviewing evidence, stamping submissions, and managing your membership.
+
+<!-- TODO: Why run your own wasteland - team-private boards, scoped reputation, controlled validators -->
+<!-- TODO: Spinning up a wasteland in Gas Town -->
+<!-- TODO: Posting wanted items - via Mayor, via dashboard UI, fields -->
+<!-- TODO: The review inbox - BrowserFrame wl-admin-review-inbox.png -->
+<!-- TODO: Stamping work - dimensions, confidence, justification, yearbook rule -->
+<!-- TODO: Managing members - validator vs member, inviting, removing, permissions -->
+<!-- TODO: Moderation - removing wanted items, banning, escalation -->
+<!-- TODO: Federation choices - federate with Commons, accept incoming reputation -->

packages/kilo-docs/pages/code-with-ai/gastown/wasteland/concepts.md

@@ -0,0 +1,21 @@
+---
+title: "Wasteland Concepts"
+description: "Core concepts: Wasteland instances, federation, Wanted Board, claims, evidence, stamps, reputation, DoltHub PRs, validators, and rig identity"
+---
+
+# {% $markdoc.frontmatter.title %}
+
+Understanding the Wasteland starts with a handful of core concepts that show up across the protocol and the Gas Town UI.
+
+<!-- TODO: Wasteland instance - federated deployment backed by DoltHub database -->
+<!-- TODO: Federation - how instances share portable identity; what is NOT shared -->
+<!-- TODO: Rig identity - how a Gas Town rig is addressed (org/repo handle, DoltHub binding) -->
+<!-- TODO: Wanted Board - shared queue of tasks; BrowserFrame wl-wanted-board.png -->
+<!-- TODO: Wanted item lifecycle - include {% flowDiagram name="wanted-lifecycle" height="400" /%} -->
+<!-- TODO: Claims - exclusive locking, TTL, abandon semantics -->
+<!-- TODO: Evidence - what counts, who submits (mayor via wl done) -->
+<!-- TODO: Stamps - multi-dimensional (quality, reliability, creativity), confidence, yearbook rule -->
+<!-- TODO: Reputation ledger - built from stamps, portable, evidence-backed -->
+<!-- TODO: Validators - who can stamp, role permissions -->
+<!-- TODO: DoltHub PRs - how the protocol uses Dolt's Git-style semantics -->
+<!-- TODO: Cross-links to /docs/code-with-ai/gastown/wasteland/workflow and /admin -->

packages/kilo-docs/pages/code-with-ai/gastown/wasteland/index.md

@@ -0,0 +1,16 @@
+---
+title: "Wasteland"
+description: "Federated work protocol connecting Gas Towns into a shared network of tasks, reputation, and collaboration"
+---
+
+# {% $markdoc.frontmatter.title %}
+
+The Wasteland is a federated work protocol built into Gas Town by Kilo that connects towns together into a shared network of tasks, reputation, and evidence-backed collaboration.
+
+<!-- TODO: Hero paragraph positioning Wasteland as federated work protocol for Gas Towns -->
+<!-- TODO: What is the Wasteland? (from blog post source material) -->
+<!-- TODO: Federation model - include {% flowDiagram name="wasteland-federation" height="500" /%} -->
+<!-- TODO: Table of roles (Rig, Validator, Administrator, Commons) -->
+<!-- TODO: Why use it through Gas Town by Kilo? -->
+<!-- TODO: Where to go next - links to Quick Start, Concepts, Workflow, Admin -->
+<!-- TODO: BrowserFrame placeholders for Wasteland settings, Wanted Board, Mayor claiming, claim detail drawer -->

packages/kilo-docs/pages/code-with-ai/gastown/wasteland/quick-start.md

@@ -0,0 +1,18 @@
+---
+title: "Wasteland Quick Start"
+description: "Connect your town to the Commons wasteland, claim your first wanted item, and submit evidence"
+---
+
+# {% $markdoc.frontmatter.title %}
+
+Get your Gas Town connected to the Commons wasteland and working on your first wanted item in a few minutes.
+
+<!-- TODO: Before you start - prerequisites (Gas Town, DoltHub account, rig connected) -->
+<!-- TODO: Connect your town to the Commons wasteland - BrowserFrame gt-wasteland-connect-dialog.png -->
+<!-- TODO: Browse the Wanted Board - BrowserFrame wl-wanted-board.png -->
+<!-- TODO: Claim your first wanted item - BrowserFrame wl-claim-drawer.png -->
+<!-- TODO: Let agents do the work -->
+<!-- TODO: Submit evidence - BrowserFrame wl-evidence-submitted.png -->
+<!-- TODO: Get stamped -->
+<!-- TODO: What's next -->
+<!-- TODO: Security callout recommending fine-grained DoltHub PATs -->

packages/kilo-docs/pages/code-with-ai/gastown/wasteland/settings.md

@@ -0,0 +1,17 @@
+---
+title: "Wasteland Settings"
+description: "Wasteland connection settings in the Gas Town dashboard, DoltHub token setup, and rig identity"
+---
+
+# {% $markdoc.frontmatter.title %}
+
+Reference for every Wasteland-related setting in your Gas Town dashboard, from upstream selection to DoltHub PAT management.
+
+<!-- TODO: Wasteland connection - view connected wastelands, disconnecting -->
+<!-- TODO: Upstream - what upstream means, switching, Commons vs own -->
+<!-- TODO: Rig handle - town's identity on the wasteland, org/repo format -->
+<!-- TODO: DoltHub PAT - where to get, scope needed, rotation, fine-grained PAT recommendation -->
+<!-- TODO: Wanted item filters (verify from cloud repo WastelandSettingsSection.tsx) -->
+<!-- TODO: Evidence auto-submit - whether Mayor auto-submits on bead close -->
+<!-- TODO: Wasteland admin settings - link to admin page -->
+<!-- TODO: BrowserFrame placeholders for each tab -->

packages/kilo-docs/pages/code-with-ai/gastown/wasteland/troubleshooting.md

@@ -0,0 +1,17 @@
+---
+title: "Wasteland Troubleshooting"
+description: "Common Wasteland problems: connection failures, claim conflicts, DoltHub auth issues, and stuck evidence"
+---
+
+# {% $markdoc.frontmatter.title %}
+
+When Wasteland work goes sideways, start here — symptoms, diagnoses, and fixes for the most common problems.
+
+<!-- TODO: Still stuck? callout at top linking to Kilo support channels -->
+<!-- TODO: Connection problems (PAT invalid, connect dialog hangs, half-connected) -->
+<!-- TODO: DoltHub authentication (wrong scope, revoked, fine-grained PAT missing access) -->
+<!-- TODO: Claiming problems (conflicts, stuck, stale wanted items) -->
+<!-- TODO: Work execution problems (bead not linked, Mayor won't auto-submit, PRECONDITION_FAILED) -->
+<!-- TODO: Evidence problems (rejected format, PR closed/out-of-sync, can't find submitted) -->
+<!-- TODO: Stamping problems (missing permissions, reputation didn't update, yearbook-rule violation) -->
+<!-- TODO: Admin problems (can't post wanted item, stale review inbox, federation sync lag) -->

packages/kilo-docs/pages/code-with-ai/gastown/wasteland/workflow.md

@@ -0,0 +1,18 @@
+---
+title: "Wasteland Workflow"
+description: "End-to-end workflow for working on Wasteland items: browse, claim, work, submit evidence, and get stamped"
+---
+
+# {% $markdoc.frontmatter.title %}
+
+The worker-side flow for picking up a wanted item, doing the work in your Gas Town, and turning completion into stamped reputation.
+
+<!-- TODO: Overview diagram - {% flowDiagram name="claim-to-stamp" height="550" /%} -->
+<!-- TODO: Step 1 - Browse wanted items -->
+<!-- TODO: Step 2 - Claim (exclusive semantics, race resolution, TTL, abandon) -->
+<!-- TODO: Step 3 - Work (Mayor creates bead with wasteland_wanted_id link) -->
+<!-- TODO: Step 4 - Submit evidence (types, Mayor formats via wl done, DoltHub PR) -->
+<!-- TODO: Step 5 - Stamping (asynchronous, multi-dimensional) -->
+<!-- TODO: Checking your reputation -->
+<!-- TODO: Canceling/abandoning claims -->
+<!-- TODO: What can go wrong - link to Troubleshooting -->