# aicode8.com

> Developer knowledge base for shipping Astro SSG + Tailwind CSS v4 + Cloudflare Edge
> sites, with a focus on pSEO scaling and GEO (generative engine optimization).

Summary only, by design. Full URL index lives in the sitemap; this file exists so
AI crawlers get an accurate, canonical map without scraping the whole site.

## Stack
- Astro (SSG) + Tailwind CSS v4 (`@theme`, no JS config)
- Cloudflare Pages / Workers / KV, zero traditional backend
- Content ratio: 70% hands-on technical material / 30% commercial

## Key sections
- Cloudflare: /cloudflare-architecture · /cloudflare-scaling · /cloudflare-migration · /cloudflare-troubleshooting
- SEO: /seo-quickstart · /seo-architecture · /seo-scaling · /seo-migration · /seo-troubleshooting
- GEO / AI search: /geo-quickstart · /geo-architecture · /geo-scaling · /geo-migration · /geo-troubleshooting
- AI search: /ai-search-quickstart · /ai-search-architecture · /ai-search-scaling · /ai-search-migration · /ai-search-troubleshooting
- Agent & AI optimization (P0): /mcp-practical · /aeo-playbook · /ai-coding-workflow
  - MCP: /mcp-tutorial · /mcp-deployment-guide · /mcp-best-practices · /mcp-quickstart · /mcp-architecture · /mcp-troubleshooting · /mcp-overview
  - AEO: /aeo-tutorial · /aeo-deployment-guide · /aeo-best-practices · /aeo-quickstart · /aeo-architecture · /aeo-troubleshooting · /aeo-overview
  - AI Coding: /ai-coding-tutorial · /ai-coding-deployment-guide · /ai-coding-best-practices · /ai-coding-quickstart · /ai-coding-architecture · /ai-coding-troubleshooting · /ai-coding-overview

- P1 frameworks & runtimes (Agent-era expansion):
  - Rust: /rust-wasm-practical · /rust-tutorial · /rust-quickstart · /rust-deployment-guide · /rust-performance-optimization · /rust-best-practices · /rust-architecture · /rust-troubleshooting
  - Go: /go-practical · /go-tutorial · /go-quickstart · /go-deployment-guide · /go-performance-optimization · /go-best-practices · /go-architecture · /go-troubleshooting
  - SvelteKit: /svelte-practical · /svelte-tutorial · /svelte-quickstart · /svelte-deployment-guide · /svelte-performance-optimization · /svelte-best-practices · /svelte-architecture · /svelte-troubleshooting
  - Vue/Nuxt: /vue-practical · /vue-tutorial · /vue-quickstart · /vue-deployment-guide · /vue-performance-optimization · /vue-best-practices · /vue-architecture · /vue-troubleshooting
  - Next.js: /nextjs-practical · /nextjs-tutorial · /nextjs-quickstart · /nextjs-deployment-guide · /nextjs-performance-optimization · /nextjs-best-practices · /nextjs-architecture · /nextjs-troubleshooting
  - Bun: /bun-practical · /bun-tutorial · /bun-quickstart · /bun-deployment-guide · /bun-performance-optimization · /bun-best-practices · /bun-architecture · /bun-troubleshooting
  - TypeScript: /typescript-practical · /typescript-tutorial · /typescript-quickstart · /typescript-deployment-guide · /typescript-performance-optimization · /typescript-best-practices · /typescript-architecture · /typescript-troubleshooting
  - AI 应用 / RAG: /ai-app-practical · /ai-app-tutorial · /ai-app-quickstart · /ai-app-deployment-guide · /ai-app-performance-optimization · /ai-app-best-practices · /ai-app-architecture · /ai-app-troubleshooting
## Agent Governance (system-level, applies to every coding agent)
This repository is governed by the Asset Governance & Anti-Bloat Charter
(full text: AGENTS.md). Any agent that reads this file MUST apply the following
four rules by default whenever it receives a batch-generation or automated
expansion instruction:

1. SINGLE-RUN CAP — emit at most 3-5 assets per run. Never bulk-generate.
2. DEDUPE VERIFICATION — every slug is checked against existing pages and the
   slug history before a file is written. Duplicates are skipped, never overwritten.
3. NO BINARY WRITES — the repository is plain-text only. Media assets go to
   external object storage and are referenced by URL.
4. LOCAL HUMAN FINAL REVIEW — the agent may edit files and run `npm run build`.
   Automatic `git push` and automatic deployment are FORBIDDEN. Publishing is a
   manual, human-owned action executed from the developer's own terminal.

Agents must additionally defend: path traversal in slugs, concurrent writes to
the shared slug index, secret/PII leakage from scraped sources, and stale build
cache after shared data sources change.

## Agent Contract (A2A, reserved)
This site reserves a machine-readable agent contract for future Agent-to-Agent
cooperation, machine-to-machine calls and trusted metadata — without coupling
the static build to any agent runtime. Discovery is intentionally separated
from page content (served from the edge, not embedded in SSG output).

- Discovery endpoint (reserved): /.well-known/agent.json
- Contract shape (capabilities, endpoints, trustedMetadata): src/lib/agent-contract.ts
- Supported transport stubs: mcp, http, llms-txt
- Trust model: optional signature + issuedAt/expiresAt envelope for downstream
  verification; pages stay static and never depend on the contract being present.

Status: interface stub only. No live negotiation endpoint is served yet.

## Optional
- /sitemap-index.xml — complete URL index (canonical source for enumeration)

Canonical: https://aicode8.com/llms.txt